Skip to main content
GET
Get top X pools for a token.
This endpoint was removed and now returns 410 Gone. Use GET /networks/{network}/pools/search with the token_address query parameter instead. It restricts results to pools that contain the token on the given network.

Migration

Things to watch when migrating:
  • The token_address filter works on the network-scoped /networks/{network}/pools/search only. The cross-network GET /pools/search accepts the parameter but silently ignores it, so always pass a network.
  • One token per query. Repeating token_address does not act as a pair filter; the API uses only one of the values (not guaranteed by order). The old address pair filter and reorder flag have no replacement.
  • An unknown token_address returns HTTP 200 with an empty results array, not an error.
See the pool filtering tutorial for the full search parameter list.

Path Parameters

network
string
required

Network slug or ID (e.g., 'solana'). You can find the list of supported networks with their IDs here: /networks.

token_address
string
required

Token contract address. Such as JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN for Jupiter on Solana.

Response

Monthly credit allowance exhausted. Retrying will not help — the body names the available next step per tier: register (keyless), upgrade (free key), or buy a credit pack / enable overage / raise your spend cap (Pro). resets_at is when the allowance rolls over (calendar month or billing period, UTC). Deliberately carries no Retry-After header.

Structured body carried by every 402 and 429 emitted by the billing gate. The shape is constant across scenarios; only fields describing an available action appear. message is always a top-level string, so clients parsing the legacy {"message": ...} shape keep working.

error
enum<string>
required

Machine-readable discriminator matching the status code.

Available options:
payment_required,
rate_limited
tier
enum<string>
required

The billing tier the request was evaluated against.

Available options:
keyless,
free,
pro
message
string
required

Human-readable message naming the next action.

credits
object

Credit counters for the current period. One credit is one request. plan and packs are split out for Pro keys only. limit is plan + packs; usage served through overage can exceed it.

overage
object

Overage state, present on Pro 402 bodies. Money amounts are decimal strings, never floats.

resets_at
string<date-time>

When the monthly allowance rolls over (UTC). 402 only.

retry_after
integer

Seconds to wait before retrying. 429 only.

offer
object

Early-adopter offer, present on the free-tier 402 only.

Next-step URLs. Keys vary by scenario: register, upgrade, packs, portal, usage, docs. Absent until the customer-facing pages go live.