> ## 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.
# 💼 Pools by Category ID
> This endpoint allows you to **query all the pools based on the provided category ID**
### Tips
* You can retrieve the full list of category IDs via this endpoint: [Categories List](/reference/categories-list).
* You can retrieve tokens of a specific category, by flagging `include=base_token`.
* GeckoTerminal categories are different from [CoinGecko categories](/reference/coins-categories-list).
### 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](https://www.coingecko.com/en/api/pricing) subscribers (Analyst plan or above).
* GeckoTerminal equivalent page example: [https://www.geckoterminal.com/category/pump-fun](https://www.geckoterminal.com/category/pump-fun)
* Cache / Update Frequency: every 30 seconds.
* Exclusive for all Paid Plan Subscribers (Analyst, Lite, Pro and Enterprise).
## OpenAPI
````yaml api-reference/onchain-pro.json get /categories/{category_id}/pools
openapi: 3.0.0
info:
title: Onchain DEX API (Pro)
version: 3.0.0
servers:
- url: https://pro-api.coingecko.com/api/v3/onchain
security:
- apiKeyAuth: []
- apiKeyQueryParam: []
paths:
/categories/{category_id}/pools:
get:
tags:
- Categories
summary: 💼 Pools by Category ID
description: >-
This endpoint allows you to **query all the pools based on the provided
category ID**
operationId: pools-category
parameters:
- name: category_id
in: path
required: true
description: category ID
schema:
type: string
example: pump-fun
default: pump-fun
- name: include
in: query
required: false
description: |-
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`
schema:
type: string
- name: page
in: query
required: false
description: |-
page through results
Default value: `1`
schema:
type: integer
- name: sort
in: query
required: false
description: |-
sort the pools by field
Default value: `pool_created_at_desc`
schema:
type: string
enum:
- 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
responses:
'200':
description: Get pools by category ID
content:
application/json:
schema:
$ref: '#/components/schemas/CategoriesPools'
components:
schemas:
CategoriesPools:
type: object
properties:
data:
type: array
items:
type: object
properties:
id:
type: string
type:
type: string
attributes:
type: object
properties:
base_token_price_usd:
type: string
base_token_price_native_currency:
type: string
quote_token_price_usd:
type: string
quote_token_price_native_currency:
type: string
base_token_price_quote_token:
type: string
nullable: true
quote_token_price_base_token:
type: string
nullable: true
address:
type: string
name:
type: string
pool_created_at:
type: string
format: date-time
fdv_usd:
type: string
nullable: true
market_cap_usd:
type: string
nullable: true
price_change_percentage:
type: object
properties:
m5:
type: string
m15:
type: string
m30:
type: string
h1:
type: string
h6:
type: string
h24:
type: string
reserve_in_usd:
type: string
h24_volume_usd:
type: string
h24_tx_count:
type: integer
relationships:
type: object
properties:
base_token:
type: object
properties:
data:
type: object
properties:
id:
type: string
type:
type: string
quote_token:
type: object
properties:
data:
type: object
properties:
id:
type: string
type:
type: string
network:
type: object
properties:
data:
type: object
properties:
id:
type: string
type:
type: string
dex:
type: object
properties:
data:
type: object
properties:
id:
type: string
type:
type: string
included:
type: array
items:
type: object
properties:
id:
type: string
type:
type: string
attributes:
type: object
properties:
address:
type: string
name:
type: string
symbol:
type: string
decimals:
type: integer
image_url:
type: string
coingecko_coin_id:
type: string
nullable: true
example:
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
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: x-cg-pro-api-key
apiKeyQueryParam:
type: apiKey
in: query
name: x_cg_pro_api_key
````