Get state

Description

Retrieve real-time state data for a specific on-chain liquidity pool, including token balances, USD valuations, 24-hour volume, and derived price ratios. Supports all pools indexed by Aleno across supported protocols and chains.

URL

GET https://pricing.aleno.ai/v1/pools/state?address={poolAddress}&chainId={chainId}

Headers

x-api-key: your-api-key

Query Parameters

Name	Type	Required	Description
address	string	Yes	Pool contract address
chainId	string	Yes	Chain identifier (e.g. eth, arbitrum, bsc, base, etc.). Must be supported by Aleno.

Response

Returns a real-time pool state object with pricing information for the specified liquidity pool, including TVL, token composition, 24-hour volume, and token-to-token price conversion.

Example Response

{
  "data": {
    "chainId": "eth",
    "address": "0xa43fe16908251ee70ef74718545e4fe6c5ccec9f",
    "protocol": "uniswap_v2",
    "usdTvl": 35379023.133415,
    "h24UsdVolume": 2732604.03634897,
    "tokens": [
      {
        "symbol": "PEPE",
        "address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
        "decimals": 18,
        "tvl": 2114257763951.88,
        "usdTvl": 17688809.9671931,
        "h24Volume": 161025927558.825,
        "h24UsdVolume": 1347213.70352451,
        "priceUsd": 0.000008366439640798
      },
      {
        "symbol": "WETH",
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "decimals": 18,
        "tvl": 8752.80822042656,
        "usdTvl": 17690213.1662219,
        "h24Volume": 685.466917764405,
        "h24UsdVolume": 1385390.33282446,
        "priceUsd": 2021.09
      }
    ],
    "pairs": [
      {
        "base": "PEPE",
        "quote": "WETH",
        "baseToQuotePrice": 4.13989645428388e-9,
        "quoteToBasePrice": 241551935.185534,
        "h24UsdVolume": 2732604.03634897
      }
    ]
  }
}

Errors

This endpoint may return:

• 400 Invalid query parameters (e.g. malformed address, unsupported/invalid chainId format).

• 401 Missing API key. Provide it via x-api-key header.

• 403 Invalid API key.

• 404 Pool not found for the provided address and chainId.

• 429 Rate limit exceeded for this route and API key.

Example 429: