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).

​
Two Integration Approaches

​
A) Protocol-Specific Approach (Explicit)

Use this when you want to work with a specific yield protocol.
1

Get Available Protocols

First, retrieve the list of all supported protocols:
GET /strategies
2

Query Protocol Details

Then, fetch specific protocol information using:
GET /strategies/:id
Required Parameters:
ParameterDescriptionExample
:idStrategy IDAave-USDC-polygon
Example Request:
GET /strategies/Aave-USDC-polygon
Response includes:
  • Composite strategy ID (id) in the format {protocol}-{assetName}-{network}
  • Current APY rate (apy) and historical APY (avgApy, inceptionApy)
  • Asset info (asset contract address, assetName, assetDecimals)
  • Protocol fee in basis points (fee)
  • Available actions (availableActions)
  • Pause status (paused)
Example Response: 
{
  "id": "Aave-USDC-polygon",
  "protocol": "Aave",
  "network": "polygon",
  "networkId": "137",
  "asset": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
  "assetName": "USDC",
  "assetDecimals": 6,
  "underlyingAsset": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
  "underlyingDecimals": 6,
  "apy": 0.0417,
  "avgApy": 0.0412,
  "inceptionApy": 0.0385,
  "paused": false,
  "fee": "0",
  "performanceFeeBps": "0",
  "availableActions": ["lend", "withdraw"]
}
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.

​
B) Protocol-Agnostic Approach (Less Explicit)

Let our system automatically select the optimal protocol for your needs. Use the Generic Endpoint: 
GET /yield/:identifier
Our system will analyze your requirements and return the best protocol option based on:
  • Highest APY rates
  • Additional reward incentives
  • Current market conditions
  • Protocol reliability

​
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