Skip to main content
GET
/
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_7dRpAUh3tYbtsVCZrtPXdwuk7ehbawrFo8xKCmDdj28V",
      "type": "pool",
      "attributes": {
        "base_token_price_usd": "0.0109071807291731",
        "base_token_price_native_currency": "0.0000559458299678367",
        "quote_token_price_usd": "0.927412163670488",
        "quote_token_price_native_currency": "0.00475595981369481",
        "base_token_price_quote_token": "0.01176331",
        "quote_token_price_base_token": "85.01",
        "address": "7dRpAUh3tYbtsVCZrtPXdwuk7ehbawrFo8xKCmDdj28V",
        "name": "SNAI / USDC",
        "pool_created_at": "2024-12-21T08:24:25Z",
        "fdv_usd": null,
        "market_cap_usd": null,
        "price_change_percentage": {
          "m5": "0",
          "m15": "0.02",
          "m30": "0.13",
          "h1": "-0.13",
          "h6": "-1.18",
          "h24": "-1.18"
        },
        "reserve_in_usd": "1087091.0112",
        "h24_volume_usd": "104.5232069054",
        "h24_tx_count": 9
      },
      "relationships": {
        "network": {
          "data": {
            "id": "solana",
            "type": "network"
          }
        },
        "dex": {
          "data": {
            "id": "raydium-clmm",
            "type": "dex"
          }
        },
        "base_token": {
          "data": {
            "id": "solana_JBMwoVtjMYFQJY4vYuM4JUkdEhDz7cgF45w8TeVGXgAB",
            "type": "token"
          }
        },
        "quote_token": {
          "data": {
            "id": "solana_EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
            "type": "token"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "solana_JBMwoVtjMYFQJY4vYuM4JUkdEhDz7cgF45w8TeVGXgAB",
      "type": "token",
      "attributes": {
        "address": "JBMwoVtjMYFQJY4vYuM4JUkdEhDz7cgF45w8TeVGXgAB",
        "name": "SwarmNode.ai",
        "symbol": "SNAI",
        "decimals": 6,
        "image_url": "missing.png",
        "coingecko_coin_id": null
      }
    },
    {
      "id": "solana_EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "type": "token",
      "attributes": {
        "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "name": "USD Coin",
        "symbol": "USDC",
        "decimals": 6,
        "image_url": "https://coin-images.coingecko.com/coins/images/6319/large/usdc.png?1696506694",
        "coingecko_coin_id": "usd-coin"
      }
    },
    {
      "id": "raydium-clmm",
      "type": "dex",
      "attributes": {
        "name": "Raydium (CLMM)"
      }
    },
    {
      "id": "solana",
      "type": "network",
      "attributes": {
        "name": "Solana",
        "coingecko_asset_platform_id": "solana"
      }
    }
  ]
}

​
Tips

  • You can retrieve full list of categories id via this endpoint: Categories List.
  • You can retrieve tokens of a specific category, by flagging include=base_token.
  • GeckoTerminal categories are different from CoinGecko categories.

​
Note

  • Trending rankings are determined by a combination of factors:
    • User engagement on geckoterminal.com
    • Market activity, such as trading volume and transactions
    • Pool security and credibility, including liquidity and honeypot checks
  • 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).
  • GeckoTerminal equivalent page example: https://www.geckoterminal.com/category/pump-fun
  • Cache/Update frequency: every 30 seconds.
  • Exclusive for all Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise).

Authorizations

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

Path Parameters

​
category_id
string
default:pump-fun
required

category ID

Example:

"pump-fun"

Query Parameters

​
include
string

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

​
page
integer

page through results Default value: 1

​
sort
enum<string>

sort the pools by field Default value: 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

Get pools by category ID

​
data
object[]
​
included
object[]