Integrate Rewards for Earn Products
Display and claim Morpho Vault rewards in an earn product, from fetching campaign data to presenting claimable incentives.
Vault users on Morpho can earn rewards beyond base lending yield. Integrating rewards display and claiming is essential for providing competitive APY and maximizing user returns.
What's Unique for Earn Products
When building earn products, understand that vault users earn rewards from two sources:
- Direct Vault Campaigns: Rewards distributed directly to vault users
- Forwarded Market Campaigns: Rewards from underlying markets where the vault allocates liquidity
Critical integration requirement:
Net APY = Native Vault APY + Vault Campaign APR + Forwarded Market Campaign APR - Performance Fee - Management FeeIntegration Steps
Follow the centralized rewards tutorials with vault-specific considerations:
Step 1: Fetch Vault Rewards Data
Follow: Fetch Rewards Data
Vault-specific notes: Reward APRs come from Merkl, not the Morpho API.
Step 2: Display Rewards in Your UI
Follow: Integrate Rewards Display
Vault-specific notes:
- Prominently display Net APY (native + all rewards)
- Show breakdown: base yield vs. rewards
- List reward tokens with their respective APRs
- Optionally show which markets contribute to forwarded rewards
Step 3: Enable Reward Claiming
Follow: Claim Rewards
Important: The claiming process is identical for all Morpho users (vault users, borrowers, market suppliers). Merkl handles all reward claims.
Quick Reference
| Task | Main Tutorial | Vault-Specific Consideration |
|---|---|---|
| Understanding rewards | Reward Campaigns | Understand forwarding mechanism |
| Distribution system | Distribution Systems | Merkl for all users |
| Fetch rewards | Fetch Rewards Data | Retrieve claimable rewards from Merkl |
| Display rewards | Integrate Display | Show total APY breakdown |
| Claim rewards | Claim Rewards | Same process for all users |
Need Help?
- Conceptual questions: Rewards for Lenders Concept
- Main rewards guide: Rewards Integration Guide
- Technical support: help.morpho.org
Exit an illiquid vault in kind
Build in-kind exits for Morpho Vault V1 and V2 when borrowed assets limit normal withdrawals, with SDK actions and transaction recovery guidance.
UX Requirements
Follow Morpho Earn requirements for brand attribution and user disclosures when presenting vault integrations in a product.