Skip to main content
GET
/
networks
/
{network}
/
tokens
/
{token_address}
/
pools
Top Pools by Token Address
curl --request GET \
  --url https://api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{token_address}/pools \
  --header 'x-cg-demo-api-key: <api-key>'
{
  "data": [
    {
      "id": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
      "type": "pool",
      "attributes": {
        "base_token_price_usd": "3653.12491645176",
        "base_token_price_native_currency": "1.0",
        "quote_token_price_usd": "0.998343707926245",
        "quote_token_price_native_currency": "0.000273040545093221",
        "base_token_price_quote_token": "3662.46",
        "quote_token_price_base_token": "0.00027304",
        "address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
        "name": "WETH / USDC 0.05%",
        "pool_created_at": "2021-12-29T12:35:14Z",
        "token_price_usd": "0.999284499078426",
        "fdv_usd": "11007041041",
        "market_cap_usd": null,
        "price_change_percentage": {
          "m5": "0",
          "m15": "0.21",
          "m30": "0.31",
          "h1": "0.51",
          "h6": "0.86",
          "h24": "7.71"
        },
        "transactions": {
          "m5": {
            "buys": 7,
            "sells": 2,
            "buyers": 7,
            "sellers": 2
          },
          "m15": {
            "buys": 19,
            "sells": 27,
            "buyers": 19,
            "sellers": 27
          },
          "m30": {
            "buys": 49,
            "sells": 61,
            "buyers": 45,
            "sellers": 57
          },
          "h1": {
            "buys": 97,
            "sells": 144,
            "buyers": 83,
            "sellers": 124
          },
          "h24": {
            "buys": 2966,
            "sells": 3847,
            "buyers": 1625,
            "sellers": 2399
          }
        },
        "volume_usd": {
          "m5": "868581.7348314",
          "m15": "2056262.885098",
          "m30": "4081230.098456",
          "h1": "16798158.0138526",
          "h6": "164054610.850188",
          "h24": "536545444.904535"
        },
        "reserve_in_usd": "163988541.3812",
        "last_trade_timestamp": 1712534400
      },
      "relationships": {
        "base_token": {
          "data": {
            "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "type": "token"
          }
        },
        "quote_token": {
          "data": {
            "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "type": "token"
          }
        },
        "dex": {
          "data": {
            "id": "uniswap_v3",
            "type": "dex"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "type": "token",
      "attributes": {
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "name": "Wrapped Ether",
        "symbol": "WETH",
        "decimals": 18,
        "image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",
        "coingecko_coin_id": "weth"
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Tips

  • You may include values such as page to specify which page of responses you would like to show.

​
Note

  • The ranking of the top 20 pools is established by evaluating their liquidity and trading activity to identify the most liquid ones. This ranking is determined through a combination of two key factors: liquidity (reserve_in_usd) and 24-Hour Trading Volume (volume_usd).
  • If the token’s market cap is not verified by the team, the API response will return null for its market cap value, even though it has a displayed value on GeckoTerminal, which might not be accurate as it often matches the Fully Diluted Valuation (FDV).
  • Attributes specified in the include param will be returned under the top-level “included” key.
  • This endpoint returns up to 20 pools per page. Use the page param to navigate more results.
  • page: Pagination beyond 10 pages is available for Paid Plan subscribers (Analyst plan or above).
  • Cache / Update Frequency:
    • Every 60 seconds for Public API.
    • Every 30 seconds for Pro API (Basic, Analyst, Lite, Pro, Enterprise).

Authorizations

​
x-cg-demo-api-key
string
header
required

Path Parameters

​
network
string
default:eth
required

network ID *refers to /networks

Example:

"eth"

​
token_address
string
default:0xdac17f958d2ee523a2206206994597c13d831ec7
required

token contract address

Example:

"0xdac17f958d2ee523a2206206994597c13d831ec7"

Query Parameters

​
include
string
default:base_token

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

​
include_inactive_source
boolean
default:false

include tokens from inactive pools using the most recent swap, default: false

​
page
integer

page through results Default value: 1

​
sort
enum<string>

sort the pools by field Default value: h24_volume_usd_liquidity_desc

Available options:
h24_volume_usd_liquidity_desc,
h24_tx_count_desc,
h24_volume_usd_desc
​
include_gt_community_data
boolean

include GeckoTerminal community data (Sentiment votes, Suspicious reports) Default value: false

Response

200 - application/json

Get top pools for a token

​
data
object[]
​
included
object[]