v1

latestOpenAPI 3.0.32026-08-041747125.8 KB

Balances

Get bridge balances

Retrieves bridge balances for the specified wallet address.

Rate limiting: 1 request per 3 seconds per client IP. Excess requests receive HTTP 429 with Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers (see RateLimitExceeded response).

get/v1/balances/bridge/{walletAddress}

Path parameters

walletAddressstring required

User's Ethereum wallet address

Response

Bridge balances retrieved successfully

walletAddressstring required

Wallet address

rebalancerAddressstring required

Rebalancer contract address

tokenstring required

Token symbol

Example response

{
  "balances": [
    {
      "sourcePool": {
        "protocolName": "Aave",
        "protocolVersion": "V3",
        "poolAddress": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
        "chain": "linea",
        "chainId": 59144,
        "underlyingToken": {
          "symbol": "USDC",
          "name": "USD Coin",
          "address": "0x1234567890123456789012345678901234567890",
          "decimals": 6
        },
        "collateralExposure": {
          "0x3b3769cfb1649e84374e7f0e0e46cbf9a1a39a62fa6a8b82e9e9edd1b3a3e3f7": "WETH",
          "0xa1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2": "cbBTC"
        },
        "poolApy": {
          "native": "3.45",
          "rewards": {
            "Merkle": "1.23",
            "Brevis": "0.87"
          },
          "total": "5.55",
          "totalNet": "4.55",
          "performanceFee": "1.00"
        }
      },
      "destinationPool": {
        "protocolName": "Aave",
        "protocolVersion": "V3",
        "poolAddress": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
        "chain": "linea",
        "chainId": 59144,
        "underlyingToken": {
          "symbol": "USDC",
          "name": "USD Coin",
          "address": "0x1234567890123456789012345678901234567890",
          "decimals": 6
        },
        "collateralExposure": {
          "0x3b3769cfb1649e84374e7f0e0e46cbf9a1a39a62fa6a8b82e9e9edd1b3a3e3f7": "WETH",
          "0xa1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2": "cbBTC"
        },
        "poolApy": {
          "native": "3.45",
          "rewards": {
            "Merkle": "1.23",
            "Brevis": "0.87"
          },
          "total": "5.55",
          "totalNet": "4.55",
          "performanceFee": "1.00"
        }
      }
    }
  ]
}