---
title: "Top Pools by Token Address"
method: GET
path: "/onchain/networks/{network}/tokens/{token_address}/pools"
---

# Top Pools by Token Address

`GET /onchain/networks/{network}/tokens/{token_address}/pools`

## Request

- Base URL: `https://api.coingecko.com/api/v3`
- URL: `https://api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{token_address}/pools`
- Auth: one of:
  - API key in header `x-cg-pro-api-key`
  - API key in query parameter `x_cg_pro_api_key`

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

## Path parameters

- `network` string, required
- `token_address` string, required

## Query parameters

- `include` string
- `include_inactive_source` boolean
- `page` integer
- `sort` 'h24_volume_usd_liquidity_desc' | 'h24_tx_count_desc' | 'h24_volume_usd_desc'
- `include_gt_community_data` boolean

## Response `200`

Top pools for a token

- Pool
  - `data` object[], required
    - `id` string, required: Pool identifier
    - `type` string, required: Resource type
    - `attributes` object, required
      - `base_token_price_usd` string, required: Base token price in USD
      - `base_token_price_native_currency` string, nullable, required: Base token price in native currency
      - `quote_token_price_usd` string, required: Quote token price in USD
      - `quote_token_price_native_currency` string, nullable, required: Quote token price in native currency
      - `base_token_price_quote_token` string, nullable, required: Base token price in quote token
      - `quote_token_price_base_token` string, nullable, required: Quote token price in base token
      - `address` string, required: Pool contract address
      - `name` string, required: Pool name
      - `pool_created_at` string, required: Pool creation timestamp
      - `fdv_usd` string, nullable, required: Fully diluted valuation in USD
      - `market_cap_usd` string, nullable, required: Market cap in USD
      - `price_change_percentage` object, required: Price change percentage over various timeframes
        - `m5` string
        - `m15` string
        - `m30` string
        - `h1` string
        - `h6` string
        - `h24` string
      - `transactions` object, required: Transaction counts over various timeframes
        - `m5` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `m15` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `m30` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `h1` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `h6` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `h24` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
      - `volume_usd` object, required: Volume in USD over various timeframes
        - `m5` string
        - `m15` string
        - `m30` string
        - `h1` string
        - `h6` string
        - `h24` string
      - `reserve_in_usd` string, nullable, required: Total reserve in USD
      - `token_price_usd` string: Price of the queried token in USD, present when querying pools by token address
      - `sentiment_vote_positive_percentage` number: GeckoTerminal community positive sentiment vote percentage
      - `sentiment_vote_negative_percentage` number: GeckoTerminal community negative sentiment vote percentage
      - `community_sus_report` integer: GeckoTerminal community suspicious reports count
    - `relationships` object, required: Related resources
      - `base_token` object
        - `data` object
          - `id` string
          - `type` string
      - `quote_token` object
        - `data` object
          - `id` string
          - `type` string
      - `network` object
        - `data` object
          - `id` string
          - `type` string
      - `dex` object
        - `data` object
          - `id` string
          - `type` string
  - `included` object[]: Included related resources, present when include parameter is specified
    - `id` string
    - `type` string
    - `attributes` object
      - `address` string
      - `name` string
      - `symbol` string
      - `decimals` integer
      - `image_url` string, nullable
      - `coingecko_coin_id` string, nullable
      - `coingecko_asset_platform_id` string

---

[API](https://skmtc.dev/coingecko/apis/coingecko-demo-api.md) - [All operations](https://skmtc.dev/coingecko/apis/coingecko-demo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coingecko/apis/coingecko-demo-api/revisions/d62c9c579f3a?raw)