> For the complete documentation index, see [llms.txt](https://docs.aleno.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aleno.ai/apis/rest-v1/pools/get-state.md).

# 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**

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

### **Headers**

```http
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](https://docs.aleno.ai/apis/rest-v1/pools/pages/lip9iO15MXczc0On422A#id-3.-poolstate) object with pricing information for the specified liquidity pool, including TVL, token composition, 24-hour volume, and token-to-token price conversion.

### **Example Response**

```json
{
  "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`: