Skip to main content
GET
List Pools

Query Parameters

All filters combine with logical AND and stack with query search and cluster. total and pages reflect the filtered result set. An unrecognized pool_state value simply returns zero matches.
page
integer
default:"1"
1-based page number.
page_size
integer
default:"20"
Number of pools per page. Maximum 100.
query
string
Search by pool name, token symbol, mint address, or pool address (configPda).
authority
string
Filter to pools whose authority exactly matches this pubkey.
quoting_authority
string
Filter to pools whose quoting_authority exactly matches this pubkey.
token
string
Filter to pools that include this mint address on either side (token_x or token_y).
token_x
string
Filter to pools whose base token (token_x) mint matches this address.
token_y
string
Filter to pools whose quote token (token_y) mint matches this address.
pool_state
string
Filter by pool state. Case-insensitive. One of Uninitialized, Initialized, Paused, RejectSwaps, Closed.
sort_by
string
default:"volume_24h:desc"
Sort field and direction. Format: field:direction.Fields: tvl, volume_24h, fees_24hDirections: asc, desc
cluster
string
default:"mainnet-beta"
Solana cluster — mainnet-beta or devnet.

Response

total
integer
Total number of pools matching the query.
pages
integer
Total number of pages.
current_page
integer
Current page number.
page_size
integer
Number of pools per page.
data
array
Array of pool objects.