Pools by Category ID

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/categories/{category_id}/pools \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "data": [
    {
      "id": "solana_DaZJ1A8ZqiSbSr7M5uFudafDUXLSNQX1zVpcyDhJZEzF",
      "type": "pool",
      "attributes": {
        "base_token_price_usd": "0.0000013253687934057798494580598374625617972585734733709883585887625",
        "base_token_price_native_currency": "0.0000000176094592913516",
        "quote_token_price_usd": "80.816693597538487283130171047763638910597932545",
        "quote_token_price_native_currency": "1.0",
        "base_token_price_quote_token": "0.00000001760945929",
        "quote_token_price_base_token": "56787660.7370405",
        "address": "DaZJ1A8ZqiSbSr7M5uFudafDUXLSNQX1zVpcyDhJZEzF",
        "name": "69 / SOL",
        "pool_created_at": "2026-05-28T04:58:01Z",
        "fdv_usd": "5325.9944",
        "market_cap_usd": null,
        "price_change_percentage": {
          "m5": "2.451",
          "m15": "2.451",
          "m30": "2.451",
          "h1": "2.451",
          "h6": "2.451",
          "h24": "2.451"
        },
        "reserve_in_usd": "1123.21403520731",
        "h24_volume_usd": "4.1209741111",
        "h24_tx_count": 2
      },
      "relationships": {
        "base_token": {
          "data": {
            "id": "solana_27pLeUemQJmxYGxsxzUTEkvi2e9eMs2xkBNB85u4pump",
            "type": "token"
          }
        },
        "quote_token": {
          "data": {
            "id": "solana_So11111111111111111111111111111111111111112",
            "type": "token"
          }
        },
        "network": {
          "data": {
            "id": "solana",
            "type": "network"
          }
        },
        "dex": {
          "data": {
            "id": "pump-fun",
            "type": "dex"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "solana_27pLeUemQJmxYGxsxzUTEkvi2e9eMs2xkBNB85u4pump",
      "type": "token",
      "attributes": {
        "address": "27pLeUemQJmxYGxsxzUTEkvi2e9eMs2xkBNB85u4pump",
        "name": "pupu69$",
        "symbol": "69",
        "decimals": 6,
        "image_url": "https://assets.geckoterminal.com/zhxpv93rywekjkckn59b3a3ghl1v",
        "coingecko_coin_id": null
      }
    },
    {
      "id": "solana_So11111111111111111111111111111111111111112",
      "type": "token",
      "attributes": {
        "address": "So11111111111111111111111111111111111111112",
        "name": "Wrapped SOL",
        "symbol": "SOL",
        "decimals": 9,
        "image_url": "https://coin-images.coingecko.com/coins/images/21629/large/solana.jpg?1696520989",
        "coingecko_coin_id": "wrapped-solana"
      }
    },
    {
      "id": "pump-fun",
      "type": "dex",
      "attributes": {
        "name": "Pump.fun"
      }
    },
    {
      "id": "solana",
      "type": "network",
      "attributes": {
        "name": "Solana",
        "coingecko_asset_platform_id": "solana"
      }
    }
  ]
}

GET

onchain

categories

{category_id}

pools

Pools by Category ID

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/categories/{category_id}/pools \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "data": [
    {
      "id": "solana_DaZJ1A8ZqiSbSr7M5uFudafDUXLSNQX1zVpcyDhJZEzF",
      "type": "pool",
      "attributes": {
        "base_token_price_usd": "0.0000013253687934057798494580598374625617972585734733709883585887625",
        "base_token_price_native_currency": "0.0000000176094592913516",
        "quote_token_price_usd": "80.816693597538487283130171047763638910597932545",
        "quote_token_price_native_currency": "1.0",
        "base_token_price_quote_token": "0.00000001760945929",
        "quote_token_price_base_token": "56787660.7370405",
        "address": "DaZJ1A8ZqiSbSr7M5uFudafDUXLSNQX1zVpcyDhJZEzF",
        "name": "69 / SOL",
        "pool_created_at": "2026-05-28T04:58:01Z",
        "fdv_usd": "5325.9944",
        "market_cap_usd": null,
        "price_change_percentage": {
          "m5": "2.451",
          "m15": "2.451",
          "m30": "2.451",
          "h1": "2.451",
          "h6": "2.451",
          "h24": "2.451"
        },
        "reserve_in_usd": "1123.21403520731",
        "h24_volume_usd": "4.1209741111",
        "h24_tx_count": 2
      },
      "relationships": {
        "base_token": {
          "data": {
            "id": "solana_27pLeUemQJmxYGxsxzUTEkvi2e9eMs2xkBNB85u4pump",
            "type": "token"
          }
        },
        "quote_token": {
          "data": {
            "id": "solana_So11111111111111111111111111111111111111112",
            "type": "token"
          }
        },
        "network": {
          "data": {
            "id": "solana",
            "type": "network"
          }
        },
        "dex": {
          "data": {
            "id": "pump-fun",
            "type": "dex"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "solana_27pLeUemQJmxYGxsxzUTEkvi2e9eMs2xkBNB85u4pump",
      "type": "token",
      "attributes": {
        "address": "27pLeUemQJmxYGxsxzUTEkvi2e9eMs2xkBNB85u4pump",
        "name": "pupu69$",
        "symbol": "69",
        "decimals": 6,
        "image_url": "https://assets.geckoterminal.com/zhxpv93rywekjkckn59b3a3ghl1v",
        "coingecko_coin_id": null
      }
    },
    {
      "id": "solana_So11111111111111111111111111111111111111112",
      "type": "token",
      "attributes": {
        "address": "So11111111111111111111111111111111111111112",
        "name": "Wrapped SOL",
        "symbol": "SOL",
        "decimals": 9,
        "image_url": "https://coin-images.coingecko.com/coins/images/21629/large/solana.jpg?1696520989",
        "coingecko_coin_id": "wrapped-solana"
      }
    },
    {
      "id": "pump-fun",
      "type": "dex",
      "attributes": {
        "name": "Pump.fun"
      }
    },
    {
      "id": "solana",
      "type": "network",
      "attributes": {
        "name": "Solana",
        "coingecko_asset_platform_id": "solana"
      }
    }
  ]
}

Notes

Get category IDs from Categories List. Use include=base_token to retrieve tokens for a specific category.
Trending rankings are determined by:
- User engagement on GeckoTerminal
- Market activity (volume, transactions)
- Pool security (liquidity, honeypot checks)
Returns up to 20 pools per page. Use the page param to navigate more results.
GeckoTerminal categories are different from CoinGecko categories.

SDK Examples

const response = await client.onchain.categories.getPools('pump-fun');

console.log(JSON.stringify(response, null, 2));

response = client.onchain.categories.get_pools("pump-fun")

print(response.model_dump_json(indent=2))

Authorizations

x-cg-pro-api-key

string

header

required

Learn how to set up your API key

Path Parameters

category_id

string

default:pump-fun

required

Category ID.

Query Parameters

include

string

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

page

integer

Page through results. Default value: 1

sort

enum<string>

Sort the pools by field. Default: pool_created_at_desc

Available options:

m5_trending,

h1_trending,

h6_trending,

h24_trending,

h24_tx_count_desc,

h24_volume_usd_desc,

pool_created_at_desc,

h24_price_change_percentage_desc

Response

200 - application/json

Pools by category

data

object[]

required

Hide child attributes

data.id

string

required

Pool identifier

data.type

string

required

Resource type

data.attributes

object

required

Hide child attributes

data.attributes.base_token_price_usd

string

required

Base token price in USD

data.attributes.base_token_price_native_currency

string | null

required

Base token price in native currency

data.attributes.quote_token_price_usd

string

required

Quote token price in USD

data.attributes.quote_token_price_native_currency

string | null

required

Quote token price in native currency

data.attributes.base_token_price_quote_token

string | null

required

Base token price in quote token

data.attributes.quote_token_price_base_token

string | null

required

Quote token price in base token

data.attributes.address

string

required

Pool contract address

data.attributes.name

string

required

Pool name

data.attributes.pool_created_at

string

required

Pool creation timestamp

data.attributes.fdv_usd

string | null

required

Fully diluted valuation in USD

data.attributes.market_cap_usd

string | null

required

Market cap in USD

data.attributes.price_change_percentage

object

required

Price change percentage over various timeframes

Hide child attributes

data.attributes.price_change_percentage.m5

string

data.attributes.price_change_percentage.m15

string

data.attributes.price_change_percentage.m30

string

data.attributes.price_change_percentage.h1

string

data.attributes.price_change_percentage.h6

string

data.attributes.price_change_percentage.h24

string

data.attributes.reserve_in_usd

string | null

required

Total reserve in USD

data.attributes.h24_volume_usd

string

required

24hr volume in USD

data.attributes.h24_tx_count

integer

required

24hr transaction count

data.relationships

object

required

Related resources

Hide child attributes

data.relationships.base_token

object

Hide child attributes

data.relationships.base_token.data

object

Hide child attributes

data.relationships.base_token.data.id

string

data.relationships.base_token.data.type

string

data.relationships.quote_token

object

Hide child attributes

data.relationships.quote_token.data

object

Hide child attributes

data.relationships.quote_token.data.id

string

data.relationships.quote_token.data.type

string

data.relationships.network

object

Hide child attributes

data.relationships.network.data

object

Hide child attributes

data.relationships.network.data.id

string

data.relationships.network.data.type

string

data.relationships.dex

object

Hide child attributes

data.relationships.dex.data

object

Hide child attributes

data.relationships.dex.data.id

string

data.relationships.dex.data.type

string

included

object[]

Included related resources, present when include parameter is specified

Hide child attributes

included.id

string

included.type

string

included.attributes

object

Hide child attributes

included.attributes.address

string

included.attributes.name

string

included.attributes.symbol

string

included.attributes.decimals

integer

included.attributes.image_url

string | null

included.attributes.coingecko_coin_id

string | null

included.attributes.coingecko_asset_platform_id

string

CoinGecko API

Onchain API

Pools by Category ID

Notes

SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

​Notes

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

Notes

SDK Examples