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

Request

  • Base URL
    https://api.coingecko.com/api/v3
  • Auth
    • API key in header x-cg-pro-api-key
    • or API key in query parameter x_cg_pro_api_key

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

Changes

No recorded changes to this operation across all 1 revision of this API.