Top Pools by Token Address

Changed on

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://pro-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

    • breaking

      for the query request parameter include, default value base_token was removed

    • breaking

      for the query request parameter include_inactive_source, default value false was removed

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • warning

      removed the optional property /// from the response with the status

    • info

      api tag Tokens removed

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      the response property became required for the status

    • info

      the response property // became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • breaking

      the response property /// became nullable for the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property //// to the response with the status