Rewards: Developer Resources

Find APIs, contracts, SDKs, tutorials, dashboards, and governance resources for Morpho reward integrators and program issuers.

This page is your central hub for all the tools, links, and data sources you need to integrate Morpho rewards into your application.

Quick Reference

ResourceLink
Morpho REST APIMorpho API
Merkl APIapi.merkl.xyz/docs
Legacy Rewardsrewards-legacy.morpho.org
Merkl Docsdocs.merkl.xyz

APIs

Morpho REST API (Vault and Market Data)

Reward APRs come from Merkl, not the Morpho API.

Use Cases:

  • Fetch vault APY excluding rewards
  • Get market supply and borrow APYs excluding rewards
  • Read supported historical data using fixed lookback windows

Merkl API (Primary for User Rewards)

Merkl's REST API for current reward programs and user claimable amounts.

  • Base URL: https://api.merkl.xyz/
  • Documentation: api.merkl.xyz/docs
  • Key Endpoint:
    • User Rewards (includes the cumulative amount, claimed, and merkle proofs needed to claim): GET /v4/users/{address}/rewards?chainId={chainId}

Use Cases:

  • Fetch user claimable rewards (current programs)
  • Get Merkle proofs for claiming
  • Real-time reward accrual (updates every 8 hours)

Legacy Rewards (Deprecated)

Smart Contracts

Merkl Distributor Contracts

All Merkl smart contract addresses, categorized by chain are listed here.

Key Functions:

  • claim(address[] users, address[] tokens, uint256[] amounts, bytes32[][] proofs) - Claim cumulative Merkl reward amounts

Contract ABIs

Merkl Distributor ABI:

[
  {
    "inputs": [
      { "name": "users", "type": "address[]" },
      { "name": "tokens", "type": "address[]" },
      { "name": "amounts", "type": "uint256[]" },
      { "name": "proofs", "type": "bytes32[][]" }
    ],
    "name": "claim",
    "outputs": [],
    "stateMutability": "nonpayable",
    "type": "function"
  }
]

SDKs & Tools

Morpho SDKs

While there's no dedicated rewards SDK, you can use Morpho's core SDKs for related functionality:

  • @morpho-org/morpho-sdk: The default SDK for vaults and markets - entity classes (/entities) and Viem-based fetchers (/fetch) via subpath exports
  • @morpho-org/simulation-sdk: Simulate transactions

Learn More: Morpho SDKs Documentation

REST Clients

Use standard HTTP clients such as fetch or curl to query the Merkl API.

Web3 Libraries

For claiming rewards onchain:

  • viem: Modern TypeScript web3 library (recommended)
  • ethers.js: Popular web3 library
  • web3.js: Classic web3 library

External Documentation

Merkl

Morpho

Onchain Data Sources

Tutorials & Guides

Getting Started

Step-by-Step Tutorials

Support Channels

For Integrators

For Reward Issuers

Monitoring & Analytics

Dashboards

Analytics Tools

Governance & Updates

Morpho Governance

Migration Information

Need Help?

If you can't find what you're looking for, reach out via: