Skip to main content
Before implementing yield features in your application, you’ll need to retrieve essential information such as APY rates, minimum deposit requirements, and other terms. This guide explains how to fetch this data using our API endpoints.
In the yield category, we encompass various passive income-generating activities in DeFi. This includes lending (where users earn interest by providing liquidity), investing in yield-generating vaults (which automatically compound returns), and staking (where users lock tokens to earn rewards).

​
Protocol Information

1

Get Available Protocols

First, retrieve the list of all supported protocols:
The JSON body is { "data": [ …strategies ], "pagination": { … } }. Use pagination.hasMore, pagination.total, and pagination.totalPages to page through results. Query parameters include page, limit (default limit is 100), network, protocol, and category to filter results. See the OpenAPI description for the full ListPagination shape.
2

Query Protocol Details

Then, fetch specific protocol information using:
Required Parameters:Example Request:
The response groups metadata under strategy, current rate metrics under spotPosition, and historical rates under rateHistory. Response includes:
  • Composite strategy ID (strategy.id) in the format {protocol}-{assetName}-{network}
  • Protocol branding (strategy.protocolInfo) — { name, logo } stored on each Strategy document in MongoDB
  • Network (strategy.chain) — { name, id, explorer, logo }
  • Tokens (strategy.assetToken, strategy.underlyingToken) — { name, address, symbol, decimals, logo? }
  • Current APY rate (spotPosition.apy), fee-adjusted rates (grossAPY, netAPY), and historical APY (avgApy, inceptionApy)
  • Asset info (strategy.asset contract address, assetName, assetDecimals)
  • Protocol fee in basis points (strategy.fee)
  • Available actions (strategy.availableActions)
  • Pause status (strategy.paused)
Example Response:
The fee and performanceFeeBps fields are in basis points (1 BPS = 0.01%). See Fees for the full fee structure and how markup fees work.

​
UI Integration Example

Protocol Selection UI Example UI implementation showing protocol selection

​
Next Steps

Deposit to Yield

Execute a deposit into a yield protocol

Check Positions

Monitor your yield positions