# x402 Trending DeFi Pools

> x402 Trending DeFi Pools is a paid API for AI agents from call402.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-19).

Returns trending liquidity pools (by volume and activity) for a given blockchain network via GeckoTerminal data, paid per-call with USDC via the x402 protocol.

## Facts

- Endpoint: POST https://call402.com/api/trending-pools?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-trending-defi-pools-1df38847
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TxqLMYiP5-v2o0urp1-2w

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 x402-trending-defi-pools-1df38847 -d '<json body>'
```

Example prompt: What are the top 10 trending liquidity pools on Base right now — show me their volume, price, and transaction counts?

## When to prefer this

Choose this endpoint when you need real-time trending liquidity pool data sourced from GeckoTerminal for Base, Ethereum, Solana, or BSC and want to pay per-call with USDC without a subscription. Ideal for AI agents running autonomous DeFi research, arbitrage scouts, or market monitoring tasks that require on-demand, micropayment-gated access with no API key management.

## Known failure modes

- HTTP 402 returned if payment header is missing or invalid — must pay with @x402/fetch or compatible x402 client
- Invalid network enum value causes 400 error
- limit out of range (< 1 or > 20) may return default or error
- GeckoTerminal upstream unavailability may cause stale or missing data
- Insufficient USDC balance causes payment failure and no data returned

## How this service works

USDC pay-per-call APIs for AI agents via the x402 protocol (v2, exact, Base mainnet). Send a request, receive HTTP 402 with payment requirements, pay with @x402/fetch or any x402 client, retry with the PAYMENT-SIGNATURE header.

## Output

A JSON object with a meta field (count, source) and a pools array. Each pool entry includes the pool name, address, base token address, current price in USD, total liquidity in USD, 24-hour volume in USD, 24-hour buy and sell transaction counts, fully diluted valuation, and the pool creation timestamp. Network context is also returned.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Pools to return, 1-20 (default 10)"
  },
  "network": {
   "enum": [
    "base",
    "ethereum",
    "solana",
    "bsc"
   ],
   "type": "string",
   "description": "Default base"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "count": 1,
   "source": "geckoterminal"
  },
  "pools": [
   {
    "name": "WETH / USDC",
    "fdv_usd": null,
    "txns_24h": {
     "buys": 800,
     "sells": 650
    },
    "price_usd": 4100.5,
    "pool_address": "0x...",
    "liquidity_usd": 3400000,
    "volume_24h_usd": 1200000,
    "pool_created_at": "2024-01-01T00:00:00Z",
    "base_token_address": "0x4200000000000000000000000000000000000006"
   }
  ],
  "network": "base"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-trending-defi-pools-1df38847/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from call402.com](https://www.zero.xyz/host/call402.com/llms.txt)