# GeckoTerminal Pools Lookup

> GeckoTerminal Pools Lookup is a paid API for AI agents from x402-toolbox.shablony-pro.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-02).

Fetches liquidity pool data from GeckoTerminal for DeFi trading analysis, paid per-call via x402 USDC microtransaction on Base.

## Facts

- Endpoint: GET https://x402-toolbox.shablony-pro.workers.dev/crypto/geckoterminal-pools?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/geckoterminal-pools-lookup-900c5778
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-RqCxRkMlnxlBSLGv8VMd

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 geckoterminal-pools-lookup-900c5778
```

Example prompt: Can you pull the top GeckoTerminal liquidity pools for USDC/ETH pairs on Base so I can see where the deepest liquidity is right now?

## When to prefer this

Choose this endpoint when you need on-chain DeFi liquidity pool data from GeckoTerminal without managing API keys or subscriptions — the x402 micropayment handles authentication. Ideal for AI agents that need pay-per-query access to DEX pool analytics, especially when building workflows that query pools occasionally and don't justify a full GeckoTerminal API subscription.

## Known failure modes

- Invalid or missing schema parameter returns empty or error response
- GeckoTerminal upstream unavailable causes timeout or failure
- Payment not confirmed via x402 results in 402 response blocking data
- Querying unsupported network or token returns empty pool list
- Rate or upstream limits from GeckoTerminal may cause transient failures

## How this service works

309 deterministic pay-per-call tools for AI agents over x402 (USDC, Base). No signup, no API key: the payment is the identity.

## Output

Returns a JSON object with pool data sourced from GeckoTerminal, including pool addresses, token pairs, trading volumes, liquidity figures, and price information for the queried pools. Response includes ok and paid confirmation fields alongside the pool payload.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "schema": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "paid": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/geckoterminal-pools-lookup-900c5778/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-toolbox.shablony-pro.workers.dev](https://www.zero.xyz/host/x402-toolbox.shablony-pro.workers.dev/llms.txt)