# Otto AI Pools Search — DeFi Liquidity Pool Lookup

> Otto AI Pools Search — DeFi Liquidity Pool Lookup is a paid API for AI agents from x402.ottoai.services, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Search for DeFi liquidity pools by token symbol, name, or contract address across multiple chains and DEXes

## Facts

- Endpoint: GET https://x402.ottoai.services/pools-search
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/otto-ai-pools-search-defi-liquidity-pool-lookup-15d14849
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5aau4XfBcLWEpzaBGZJfD

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 otto-ai-pools-search-defi-liquidity-pool-lookup-15d14849
```

Example prompt: Find all liquidity pools for PEPE — I want to see which DEXes and chains have pools, with their current liquidity, 24h volume, and price.

## When to prefer this

Use this endpoint when you need to discover active DeFi trading pools for a specific token across multiple chains and DEXes, especially when you need liquidity depth, trading volume, and price data aggregated from GeckoTerminal. Prefer this over generic token search endpoints when pool-level data (liquidity, volume, DEX, pair composition) is needed rather than just token metadata.

## Known failure modes

- Token symbol not found — returns empty pools array
- Invalid contract address format — may return no results
- Network congestion causing stale data — check meta.stalenessSec
- Degraded mode indicated by meta.degraded=true meaning partial data
- Unknown token with no pools on supported chains returns empty result set

## How this service works

Search DEX pools across Base, Ethereum, Solana, Polygon, BSC, Arbitrum, Optimism and Avalanche by token symbol, name, or contract address. Returns pool address, DEX, price USD, 24h volume, liquidity (TVL), FDV, 24h price change and 24h txns as flat JSON numbers — no nested joins. Pool search, pool finder, DEX pools, liquidity pools, onchain pool lookup. $0.001 per call.

## Output

Returns a list of liquidity pools matching the query, each with DEX name, network, pool address, base and quote token details, current price in USD, liquidity in USD, 24h trading volume, 24h transaction count, 24h price change percentage, FDV, and pool creation date. Also includes metadata about query freshness and data source (GeckoTerminal).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "query": "USDC"
  }
 }
}
```

## 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 symbol, token name, or contract address to find pools for (e.g. WETH, PEPE, or a 0x… / Solana mint address)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "status"
     ],
     "properties": {
      "data": {},
      "meta": {
       "type": "object"
      },
      "reason": {
       "type": "string",
       "description": "status=unavailable only; every >=400 is UNCHARGED"
      },
      "status": {
       "enum": [
        "success",
        "unavailable"
       ],
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "pools": [],
   "query": "weth",
   "generatedAt": "2026-06-10T12:00:00.000Z",
   "sourcedFrom": "geckoterminal",
   "sourceMatches": 10
  },
  "meta": {
   "degraded": false,
   "validUntil": "",
   "generatedAt": "",
   "stalenessSec": 0
  },
  "status": "success"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/otto-ai-pools-search-defi-liquidity-pool-lookup-15d14849/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.ottoai.services](https://www.zero.xyz/host/x402.ottoai.services/llms.txt)