# DEX Top Pools by TVL

> DEX Top Pools by TVL is a paid API for AI agents from agent402.tools, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns the top decentralized exchange liquidity pools ranked by current TVL, filterable by chain and project, with APY and pool metadata sourced from DeFiLlama.

## Facts

- Endpoint: POST https://agent402.tools/api/dex-top-pools
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/dex-top-pools-by-tvl-a32d5879
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Aml_rFrYceuMlswWyqtNK

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 dex-top-pools-by-tvl-a32d5879 -d '<json body>'
```

Example prompt: Show me the top 15 DEX liquidity pools on Arbitrum right now, ranked by TVL — include APY and which project each pool belongs to.

## When to prefer this

Use this endpoint when you need a ranked, filterable snapshot of DEX pool TVL and APY across major chains and protocols without needing a DeFiLlama API key. Prefer it over manual scraping or authenticated APIs for quick DeFi liquidity research.

## Known failure modes

- Invalid chain name returns empty results or error
- limit out of range (>50 or <1) may return default or error
- project slug substring with no matches returns empty array
- DeFiLlama upstream API unavailability causes failure
- Malformed request body returns 400-level error

## How this service works

Top DEX pools (Uniswap, Sushi, Curve, Aerodrome, etc.) ranked by current TVL - filterable by chain and project. Sourced from DeFiLlama's public Yields API (keyless). Each row carries chain, project slug, symbol pair, TVL in USD, current APY, and pool ID for follow-up queries.

## Output

A ranked list of up to 50 DEX pools including chain name, project slug, token symbol pair, TVL in USD, and current APY percentage — sourced live from DeFiLlama's yields data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chain": {
   "type": "string",
   "description": "Chain name as DeFiLlama uses it (Ethereum, Base, Polygon, Arbitrum, Optimism, etc.). Case-insensitive. Omit for all chains."
  },
  "limit": {
   "type": "number",
   "description": "Max pools to return (1-50, default 10)."
  },
  "project": {
   "type": "string",
   "description": "Project slug substring (uniswap-v3, aerodrome-v1, curve-dex, etc.). Case-insensitive substring match. Omit for all DEXes."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "Base",
  "count": 5,
  "pools": [
   {
    "apy": 12.3,
    "pool": "abc123",
    "chain": "Base",
    "symbol": "WETH-USDC",
    "tvlUsd": 45000000,
    "project": "uniswap-v3"
   }
  ],
  "source": "defillama-yields",
  "project": "uniswap-v3"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/dex-top-pools-by-tvl-a32d5879/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)