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 real-time state and pricing information for the specified liquidity pool, including TVL, token composition, 24-hour volume, and token-to-token price conversion.

---

Response Fields

• data — object

  • chainId — string Aleno chain identifier (e.g., eth, arb, etc.).

  • address — string Pool contract address.

  • protocol — string Protocol identifier (e.g. uniswap_v2, sushiswap, etc.).

  • usdTvl — number Total USD value locked in the pool.

  • h24UsdVolume — number 24-hour trading volume in USD across all token pairs in the pool.

  • tokens — array of object Per-token liquidity and volume details:

    • symbol — string Token symbol.

    • address — string Token contract address.

    • decimals — number Token decimals.

    • tvl — number Token balance in the pool (raw units, adjusted for decimals).

    • usdTvl — number USD-equivalent value of the token’s liquidity in the pool.

    • h24Volume — number Token trading volume over the last 24 hours (raw units).

    • h24UsdVolume — number 24-hour trading volume in USD for the token.

    • priceUsd — number USD price of the token implied from the pool state.

  • pairs — array of object Token-to-token price ratios within the pool:

    • base — string Symbol of the base token.

    • quote — string Symbol of the quote token.

    • baseToQuotePrice — number Price of 1 unit of base token in quote token units.

    • quoteToBasePrice — number Price of 1 unit of quote token in base token units.

    • h24UsdVolume — number 24-hour USD trading volume for this token pair.

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