# DexL Agents Token Liquidity Lookup

> DexL Agents Token Liquidity Lookup is a paid API for AI agents from agents.dexl.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns liquidity data for a given ERC-20 token contract address on a specified EVM chain

## Facts

- Endpoint: POST https://agents.dexl.io/v1/tools/token-liquidity
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dexl-agents-token-liquidity-lookup-9a155cad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_z2TAFYtLi25uNU0w2jxya

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability dexl-agents-token-liquidity-lookup-9a155cad -d '<json body>'
```

Example prompt: What's the liquidity for the token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Base?

## When to prefer this

Use this endpoint when you need fast, pay-per-call liquidity data for a specific ERC-20 token on Base, Arbitrum, BSC, or Robinhood chain without setting up API keys or accounts. It is ideal for AI agents that need to assess token tradability, screen new tokens, or enrich DeFi decision-making with on-chain liquidity signals on a per-request basis.

## Known failure modes

- Invalid or non-existent contract address returns empty or error output
- Chain not supported beyond the four enum values (base, arbitrum, bsc, robinhood) causes rejection
- Token exists but has zero or negligible liquidity, returning empty output object
- Payment failure via x402 prevents request from being processed
- Network or RPC issues on the target chain may cause timeouts

## How this service works

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.

## Output

Returns a JSON object containing liquidity metrics for the specified ERC-20 token on the chosen chain, along with cache status and unit count. The output field contains the actual liquidity data (depth, pool info, or related metrics).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "enum": [
    "base",
    "arbitrum",
    "bsc",
    "robinhood"
   ],
   "type": "string",
   "default": "base",
   "description": "Which chain the token lives on."
  },
  "token": {
   "type": "string",
   "description": "ERC-20 contract address (0x...)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "units": 1,
  "cached": false,
  "output": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dexl-agents-token-liquidity-lookup-9a155cad/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.dexl.io](https://www.zero.xyz/host/agents.dexl.io/llms.txt)