v1

latestOpenAPI 3.1.02026-07-2681217214.1 KB

WALLET

DEVELOPER

Wallet DeFi Positions

Get DeFi positions (LP and lending) for up to 5 wallet addresses.

post/api/v1/developer/wallet/positions

Query parameters

limitinteger

Max number of positions returned. Default is 25.

cursorstring

Cursor to request the next page of results.

Request body

chainstring required

Lowercase chain name

addressstring required

Wallet address

Example request

[
  {
    "address": "0xab16781a13fe343a275f4bb5c883a64ceda52917",
    "chain": "ethereum"
  }
]

Response

Successful Response

cursorstring nullable

Pagination cursor for the next page of results

totalinteger nullable

Total number of positions across all pages

Example response

{
  "cursor": "eyJwYWdlIjogMn0=",
  "items": [
    {
      "address": "0xab16781a13fe343a275f4bb5c883a64ceda52917",
      "chain": "ethereum",
      "fee_tier": "500",
      "in_range": true,
      "pool_address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
      "position_id": "uniswap_v3-ethereum-637818",
      "position_type": "LP",
      "protocol": "uniswap_v3",
      "token0": {
        "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "chain": "ethereum",
        "decimals": 6,
        "info": {
          "name": "USD Coin",
          "symbol": "USDC"
        },
        "object": "token",
        "type": "evm_erc20"
      },
      "token0_amount": "2100.543210",
      "token0_amount_usd": "2100.54",
      "token1": {
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "chain": "ethereum",
        "decimals": 18,
        "info": {
          "name": "Wrapped Ether",
          "symbol": "WETH"
        },
        "object": "token",
        "type": "evm_erc20"
      },
      "token1_amount": "1.234567890123456789",
      "token1_amount_usd": "2421.33",
      "total_value_usd": "4521.87"
    },
    {
      "address": "0xab16781a13fe343a275f4bb5c883a64ceda52917",
      "borrows": [
        {
          "amount": "3500.000000",
          "amount_usd": "3500.00",
          "token": {
            "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "chain": "ethereum",
            "decimals": 6,
            "info": {
              "name": "USD Coin",
              "symbol": "USDC"
            },
            "object": "token",
            "type": "evm_erc20"
          }
        }
      ],
      "chain": "ethereum",
      "collateral": [],
      "health_factor": "1.85",
      "pool_address": "0x87870bca3f3fd6335c3f4ce8392d69350b4fa4e2",
      "position_id": "aave_v3-ethereum-0xab16781a13fe343a275f4bb5c883a64ceda52917",
      "position_type": "lending",
      "protocol": "aave_v3",
      "supplies": [
        {
          "amount": "5.234567890123456789",
          "amount_usd": "10250.32",
          "token": {
            "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "chain": "ethereum",
            "decimals": 18,
            "info": {
              "name": "Wrapped Ether",
              "symbol": "WETH"
            },
            "object": "token",
            "type": "evm_erc20"
          }
        }
      ],
      "total_value_usd": "15230.45"
    }
  ],
  "total": 5
}