# Token Pools

> Token Pools is a paid API for AI agents from 402.com.tr, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Lists all DEX liquidity pools for a Base token, including pair address, DEX name, quote symbol, price, liquidity depth, and 24h volume, sorted by liquidity.

## Facts

- Endpoint: GET https://402.com.tr/api/x402/token-pools
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-pools-eb85dabd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PSe0LvZdyeGeb_3ZcJNVh

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 token-pools-eb85dabd
```

Example prompt: Show me all the DEX pools available for the Base token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, sorted by liquidity, so I can see where and how deeply it can be traded.

## When to prefer this

Choose this endpoint when you need a comprehensive view of where a specific Base token is tradeable across all DEXes, including liquidity depth and volume data. Prefer this over general token price lookups when the goal is to assess tradability, compare DEX liquidity, identify the best execution venue, or perform pre-trade due diligence on slippage risk.

## Known failure modes

- Invalid or non-existent token contract address returns empty pool list or error
- Token exists on Base but has no DEX pools — returns empty array
- Malformed address string causes validation error
- Network or upstream data provider outage returns 5xx error
- Payment not settled results in 402 response blocking data delivery

## How this service works

Lists every DEX pool for a Base token (pair address, DEX, quote symbol, price, liquidity, 24h volume), sorted by liquidity. Tells agents where — and how deep — a token can be traded.

## Output

Returns a list of DEX liquidity pools for the given Base token, each entry containing the pair contract address, DEX name, quote token symbol, current token price, total liquidity (USD), and 24-hour trading volume, sorted from highest to lowest liquidity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "Token contract address"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-pools-eb85dabd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 402.com.tr](https://www.zero.xyz/host/402.com.tr/llms.txt)