Get pools information

Retrieves comprehensive information about supported DeFi protocols, pools, Total Value Locked (TVL), and Annual Percentage Yield (APY) data on supported networks.<br><br>

The response is a flat list of pools across supported protocols (Aave, Morpho, Euler) and tokens (USDC, MUSD, USDT, RLUSD, USDG, USDE, PYUSD). Each pool includes protocol metadata, pool address/name, underlying token details, TVL, liquidity, collateral exposure, APY breakdowns, signing metadata, and blacklist status.<br><br>

APY Information: The APY data includes native lending rates, reward provider APYs (e.g., MERKLE, BREVIS), and total combined APY. All APY values are formatted to 2 decimal places and represent 7-day average market rates adjusted by fees.<br><br>

Aave pool address collision example: On Ethereum, the following pools all share poolAddress: "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2":

• Aave V3 USDC (underlyingToken.symbol: "USDC")
• Aave V3 USDT (underlyingToken.symbol: "USDT")
• Aave V3 RLUSD (underlyingToken.symbol: "RLUSD")
• Aave V3 MUSD (underlyingToken.symbol: "MUSD")
• Aave V3 USDG (underlyingToken.symbol: "USDG")
• Aave V3 USDE (underlyingToken.symbol: "USDE")
• Aave V3 PYUSD (underlyingToken.symbol: "PYUSD")

When rendering a token-specific pool list, filter by underlyingToken.symbol, not by poolAddress.

This endpoint requires an API key and can be used to discover available investment opportunities before configuring a rebalancer or making deposits.

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

{
  "pools": [
    {
      "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"
      }
    }
  ]
}