Pools

Browse, filter, and inspect on-chain liquidity pools across all major DEXes.

All token parameters accept both symbols (SOL, BTC) and mint addresses.

Free Endpoints (no auth)

Cached (5s), IP rate-limited (60/min). API key holders get fresh data and higher limits.

GET /v1/pools

Paginated pool list with optional filters.

Query parameters:

Param	Description	Example
token	Pools containing this token	?token=SOL
tokens	Pools containing ANY of these tokens	?tokens=SOL,USDC,BTC
pair	Pools for a specific pair	?pair=SOL,USDC
dex	Filter by DEX	?dex=orca-whirlpool
limit	Results per page (max 200)	?limit=50
offset	Pagination offset	?offset=100

Response:

{
  "pools": [
    {
      "address": "HJPjoWUrhoZzkNfRpHuieeFk9AnbVjTk9Gc5SJRqsQTK",
      "dex": "orca-whirlpool",
      "mintA": "So11111111111111111111111111111111111111112",
      "mintB": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "symbolA": "SOL",
      "symbolB": "USDC",
      "decimalsA": 9,
      "decimalsB": 6,
      "feeBps": 1,
      "price": 80.31,
      "baseSymbol": "SOL",
      "quoteSymbol": "USDC",
      "reserveA": "1234567890",
      "reserveB": "98765432100",
      "sqrtPrice": "1234567890123456789",
      "tickCurrent": -32768,
      "cacheAgeMs": 150
    }
  ],
  "count": 50,
  "total": 284,
  "offset": 0,
  "limit": 50
}

GET /v1/pools/:token

All pools for a token.

GET /v1/pools/SOL
GET /v1/pools/So11111111111111111111111111111111111111112

GET /v1/pools/:tokenA/:tokenB

Pools for a specific pair.

GET /v1/pools/SOL/USDC
GET /v1/pools/JUP/SOL

Paid Endpoints (API key required)

GET /v1/pool/:address

Decoded single pool state with full details.

GET /v1/pool/HJPjoWUrhoZzkNfRpHuieeFk9AnbVjTk9Gc5SJRqsQTK

Returns reserves, sqrtPrice, tick, implied price, fee, DEX type, cache age.

GET /v1/pools/new

Recently discovered pools (streaming). Up to 500 tracked, newest first.

Query parameters:

• limit — Max results (default 50, max 200)

Response:

{
  "pools": [
    {
      "address": "...",
      "dex": "raydium-cpmm",
      "symbolA": "NEWTOKEN",
      "symbolB": "SOL",
      "discoveredAt": 1712000000000,
      ...
    }
  ],
  "count": 50
}

GET /v1/pools/seed

Bulk pool export for seeding your own pool database. Higher page size (500 vs 200).

Same filters as /v1/pools: ?token, ?tokens, ?pair, ?dex, ?limit, ?offset

GET /v1/pools/dead

Coming soon — Dedpool: dead/suspicious pool detection and safety scoring.

Rate Limits

Tier	Free endpoints	Paid endpoints
Anonymous	60 req/min per IP (cached 5s)	401 Unauthorized
External API key	300 req/min per key (fresh)	60 req/min (quote), 10 req/min (swap)
Internal API key	Unlimited (fresh)	Unlimited