v19

latestOpenAPI 3.0.0raw.githubusercontent.com2026-05-288570715.5 KB

Top Pools by Token Address

To query top pools based on the provided token contract address on a network

get/onchain/networks/{network}/tokens/{token_address}/pools

Path parameters

networkstring required

Network ID. *refers to /onchain/networks.

token_addressstring required

Token contract address.

Query parameters

includestring

Attributes to include, comma-separated if more than one. Available values: base_token, quote_token, dex

include_inactive_sourceboolean

Include tokens from inactive pools using the most recent swap. Default: false

pageinteger

Page through results. Default value: 1

sort'h24_volume_usd_liquidity_desc' | 'h24_tx_count_desc' | 'h24_volume_usd_desc'

Sort the pools by field. Default: h24_volume_usd_liquidity_desc

include_gt_community_databoolean

Include GeckoTerminal community data (sentiment votes, suspicious reports). Default: false

Response

Top pools for a token