Finding opportunities

The opportunities endpoint provides key metrics like APR, TVL, and daily rewards that you can display in your frontend.

Multiple filters are available to query opportunities. For a complete list, see the opportunities endpoint documentation.

Recommended filters:

By Protocol ID - Find all opportunities for a specific protocol:

https://api.merkl.xyz/v4/opportunities?mainProtocolId={protocol_id}

Example for Euler: https://api.merkl.xyz/v4/opportunities?mainProtocolId=euler

To find your protocol's ID, check existing opportunities on the API or try filtering by name first (https://api.merkl.xyz/v4/opportunities?name={name})

By Explorer Address - Find opportunities for a specific pool or lending market:

https://api.merkl.xyz/v4/opportunities?explorerAddress={address}

Example for the Aave USDT0 market on Plasma: https://api.merkl.xyz/v4/opportunities?explorerAddress=0x5D72a9d9A9510Cd8cBdBA12aC62593A58930a948

By Chain ID - Find all opportunities on a specific chain:

https://api.merkl.xyz/v4/opportunities?chainId={chain_id}

Example for Ethereum: https://api.merkl.xyz/v4/opportunities?chainId=1

By Tags - Find opportunities across multiple protocols and chains:

https://api.merkl.xyz/v4/opportunities?tags={tag}

Example for zkSync Ignite Program: https://api.merkl.xyz/v4/opportunities?tags=zksync

If you need a custom tag for your opportunities, contact us and we'll assign it to your campaigns.