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
      }
    ]
  }
}