---
title: "Read a token's DEX pair straight from the chain: pair address, both reserves, the implied price, LP total supply and how much of that LP sits in burn addresses. Base, Arbitrum and BNB Chain, Uniswap V2-style factories against the wrapped native token. Read-only eth_call, no API key. The answer states its own limits: no pair here does not mean no liquidity, because V3, other DEXes and non-native quote pairs are not covered."
method: POST
path: "/v1/tools/token-liquidity"
---

# Read a token's DEX pair straight from the chain: pair address, both reserves, the implied price, LP total supply and how much of that LP sits in burn addresses. Base, Arbitrum and BNB Chain, Uniswap V2-style factories against the wrapped native token. Read-only eth_call, no API key. The answer states its own limits: no pair here does not mean no liquidity, because V3, other DEXes and non-native quote pairs are not covered.

`POST /v1/tools/token-liquidity`

## Request

- Base URL: `https://agents.dexl.io`
- URL: `https://agents.dexl.io/v1/tools/token-liquidity`
- Auth: API key in header `X-Payment`

Paid per call via x402. Send without payment to get the exact price in the 402.

## Request body

- object
  - `chain` 'base' | 'arbitrum' | 'bsc' | 'robinhood': Which chain the token lives on.
  - `token` string, required: ERC-20 contract address (0x...).

## Response `200`

The tool output

## Other responses

- `400`: The input did not match the schema
- `402`: Payment required

---

[API](https://skmtc.dev/dexl/apis/dexl-agents.md) · [All operations](https://skmtc.dev/dexl/apis/dexl-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/dexl/apis/dexl-agents/revisions/e3692765c3f7?raw)