Skip to main content
In this section, we’ll learn how to retrieve the current yield positions for an address.
Prerequisites:

​
Retrieve Current Positions

Use the following endpoint to retrieve all the current yield positions of an address: 
GET /wallets/:wallet
Required Parameters: || Parameter | Description | Example | || --------- | -------------- | -------------------------------------------- | || wallet | Wallet address | 0x1234567890123456789012345678901234567890 | Example Request: 
GET /wallets/0x1234567890123456789012345678901234567890

​
Response Format

The response returns an array of yield positions with spot performance data and the full strategy object for each. Example Response: 
{
  "positions": [
    {
      "spotPosition": {
        "currentPosition": "10000000",
        "underlyingBalanceUSD": 10.05,
        "apy": 0.0417,
        "avgApy": 0.0412,
        "inceptionApy": 0.0385
      },
      "strategy": {
        "_id": "679044af61866a32dd2d39e9",
        "slug": "aave-usdc-polygon",
        "name": "Aave USDC Lending",
        "protocol": "Aave",
        "network": "polygon",
        "asset": {
          "symbol": "USDC",
          "contract": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
          "decimals": 6
        },
        "apy": 4.17,
        "tvl": "48000000",
        "paused": false,
        "fee": "10"
      }
    }
  ],
  "summary": {
    "totalUnderlyingBalanceUSD": 10.05
  }
}

​
Understanding the Response

Raw balance as a BigInt string in the token’s smallest unit (e.g. "10000000" = 10 USDC)
USD value of the position
  • apy: Current APY as a decimal (e.g. 0.0417 = 4.17%)
  • avgApy: Time-weighted average APY since inception
  • inceptionApy: APY since the strategy launched
Full strategy object (same shape as GET /strategies/:id) including protocol, network, asset details, TVL, and fee
Total portfolio value in USD across all positions

​
UI Integration Example

Active yield positions in UI Example UI showing active yield positions

​
Next Steps

Withdraw

Learn how to withdraw from a position

New Deposit

Open a new yield position