# GeckoTerminal DEX Pool Search

> GeckoTerminal DEX Pool Search is a paid API for AI agents from opportunity-api-production.up.railway.app, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Resolves a token name, symbol, or contract address to its DEX liquidity pools with price, liquidity, and volume data via GeckoTerminal.

## Facts

- Endpoint: GET https://opportunity-api-production.up.railway.app/api/search-pools
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/geckoterminal-dex-pool-search-142b462b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dWA5XcPZhUhzhnWKWB0t2

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-dex-pool-search-142b462b
```

Example prompt: Can you look up the DEX pools for PEPE on Ethereum — I need the pool address, price, and liquidity before I do anything else with it.

## When to prefer this

Use this endpoint as the prerequisite lookup step before calling any pool-specific endpoint (OHLCV, recent swaps, etc.). Ideal when you have only a token name or symbol and need to resolve it to a concrete pool address and network. Prefer this over manual lookup when operating across multiple networks and needing liquidity/volume context to select the best pool.

## Known failure modes

- Token not found on any DEX — empty pool list returned
- Invalid or misspelled token name yields no results
- Unsupported network filter value causes bad request or empty result
- GeckoTerminal API unavailable — upstream error propagated
- Rate limit exceeded — HTTP 429 or payment required response

## How this service works

Resolve any token name, symbol or address to its DEX pools (GeckoTerminal): pool address, network, dex, price, liquidity, volume. The lookup agents call before using pool endpoints. Params: query, network (optional).

## Output

A list of DEX pools matching the query, each with pool address, network identifier, DEX name, current token price in USD, liquidity in USD, and 24h trading volume. Structured for downstream use with pool-specific endpoints.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "description": "token name, symbol or address"
      },
      "network": {
       "type": "string",
       "description": "optional filter: base|eth|solana|bsc|arbitrum|polygon|optimism|avalanche"
      }
     }
    }
   },
   "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/geckoterminal-dex-pool-search-142b462b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from opportunity-api-production.up.railway.app](https://www.zero.xyz/host/opportunity-api-production.up.railway.app/llms.txt)