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
| Resource | Link |
|---|---|
| Morpho REST API | Morpho API |
| Merkl API | api.merkl.xyz/docs |
| Legacy Rewards | rewards-legacy.morpho.org |
| Merkl Docs | docs.merkl.xyz |
APIs
Morpho REST API (Vault and Market Data)
Reward APRs come from Merkl, not the Morpho API.
- Documentation: 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 merkleproofsneeded to claim):GET /v4/users/{address}/rewards?chainId={chainId}
- User Rewards (includes the cumulative
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
- Official Docs: docs.merkl.xyz
- Integration Guide: docs.merkl.xyz/integrate-merkl/app
Morpho
- Developer Hub: /developers/
- Rewards data tutorial: Fetch reward data
Onchain Data Sources
- Merkl Subgraphs: See Merkl docs
Tutorials & Guides
Getting Started
Step-by-Step Tutorials
Support Channels
For Integrators
- Technical Questions: help.morpho.org
For Reward Issuers
- Program Creation Help: Merkl Docs
Monitoring & Analytics
Dashboards
- Merkl Dashboard: merkl.xyz - View active campaigns
- Morpho App: app.morpho.org - See rewards on vaults/markets
Analytics Tools
- Dune Analytics: Morpho Dashboards
- DefiLlama: Track TVL and yields across Morpho
Governance & Updates
Morpho Governance
- Snapshot: snapshot.box/#/s.eth
Migration Information
- MIP 111: Snapshot Proposal - Migration to Merkl
Need Help?
If you can't find what you're looking for, reach out via:
- Chat: help.morpho.org