Megafilter for Pools
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/pools/megafilter \
--header 'x-cg-pro-api-key: <api-key>'{
"data": [
{
"id": "base_0x3e97c5ec8c73e7d566aca606472141a9b9a8c1fa",
"type": "pool",
"attributes": {
"base_token_price_usd": "0.05193801053",
"base_token_price_native_currency": "0.000025326242378315592946540670776322410025776",
"quote_token_price_usd": "0.776158829933404",
"quote_token_price_native_currency": "0.000376082386826923",
"base_token_price_quote_token": "0.06734227197",
"quote_token_price_base_token": "14.8495138445",
"address": "0x3e97c5ec8c73e7d566aca606472141a9b9a8c1fa",
"name": "DEUS / VIRTUAL",
"pool_created_at": "2026-05-27T13:04:51Z",
"fdv_usd": "45464410.8007355",
"market_cap_usd": "0.0",
"price_change_percentage": {
"m5": "-3.42",
"m15": "-9.171",
"m30": "4.444",
"h1": "5.06",
"h6": "28.62",
"h24": "28.62"
},
"transactions": {
"m5": {
"buys": 20,
"sells": 10,
"buyers": 16,
"sellers": 9
},
"m15": {
"buys": 71,
"sells": 30,
"buyers": 51,
"sellers": 27
},
"m30": {
"buys": 139,
"sells": 63,
"buyers": 88,
"sellers": 50
},
"h1": {
"buys": 288,
"sells": 163,
"buyers": 167,
"sellers": 120
},
"h6": {
"buys": 2719,
"sells": 1502,
"buyers": 974,
"sellers": 709
},
"h24": {
"buys": 2719,
"sells": 1502,
"buyers": 974,
"sellers": 709
}
},
"volume_usd": {
"m5": "14594.3019415648",
"m15": "67379.9374046351",
"m30": "133544.558315085",
"h1": "375498.056536124",
"h6": "4631158.03685961",
"h24": "4631158.03685961"
},
"reserve_in_usd": "1257212.6821"
},
"relationships": {
"base_token": {
"data": {
"id": "base_0x940a319b75861014a220d9c6c144d108552b089b",
"type": "token"
}
},
"quote_token": {
"data": {
"id": "base_0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
"type": "token"
}
},
"network": {
"data": {
"id": "base",
"type": "network"
}
},
"dex": {
"data": {
"id": "aerodrome-base",
"type": "dex"
}
}
}
}
],
"included": [
{
"id": "base_0x940a319b75861014a220d9c6c144d108552b089b",
"type": "token",
"attributes": {
"address": "0x940a319b75861014a220d9c6c144d108552b089b",
"name": "DEUS Token",
"symbol": "DEUS",
"decimals": 18,
"image_url": "https://coin-images.coingecko.com/coins/images/68133/large/Screenshot_2025-08-07_at_8.52.11%E2%80%AFPM.png?1754901254",
"coingecko_coin_id": "xmaquina"
}
},
{
"id": "base_0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
"type": "token",
"attributes": {
"address": "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
"name": "Virtual Protocol",
"symbol": "VIRTUAL",
"decimals": 18,
"image_url": "https://coin-images.coingecko.com/coins/images/34057/large/LOGOMARK.png?1708356054",
"coingecko_coin_id": "virtual-protocol"
}
},
{
"id": "aerodrome-base",
"type": "dex",
"attributes": {
"name": "Aerodrome (Base)"
}
},
{
"id": "base",
"type": "network",
"attributes": {
"name": "Base",
"coingecko_asset_platform_id": "base"
}
}
]
}Megafilter for Pools
To query pools based on various filters across all networks on GeckoTerminal
GET
/
onchain
/
pools
/
megafilter
Megafilter for Pools
curl --request GET \
--url https://pro-api.coingecko.com/api/v3/onchain/pools/megafilter \
--header 'x-cg-pro-api-key: <api-key>'{
"data": [
{
"id": "base_0x3e97c5ec8c73e7d566aca606472141a9b9a8c1fa",
"type": "pool",
"attributes": {
"base_token_price_usd": "0.05193801053",
"base_token_price_native_currency": "0.000025326242378315592946540670776322410025776",
"quote_token_price_usd": "0.776158829933404",
"quote_token_price_native_currency": "0.000376082386826923",
"base_token_price_quote_token": "0.06734227197",
"quote_token_price_base_token": "14.8495138445",
"address": "0x3e97c5ec8c73e7d566aca606472141a9b9a8c1fa",
"name": "DEUS / VIRTUAL",
"pool_created_at": "2026-05-27T13:04:51Z",
"fdv_usd": "45464410.8007355",
"market_cap_usd": "0.0",
"price_change_percentage": {
"m5": "-3.42",
"m15": "-9.171",
"m30": "4.444",
"h1": "5.06",
"h6": "28.62",
"h24": "28.62"
},
"transactions": {
"m5": {
"buys": 20,
"sells": 10,
"buyers": 16,
"sellers": 9
},
"m15": {
"buys": 71,
"sells": 30,
"buyers": 51,
"sellers": 27
},
"m30": {
"buys": 139,
"sells": 63,
"buyers": 88,
"sellers": 50
},
"h1": {
"buys": 288,
"sells": 163,
"buyers": 167,
"sellers": 120
},
"h6": {
"buys": 2719,
"sells": 1502,
"buyers": 974,
"sellers": 709
},
"h24": {
"buys": 2719,
"sells": 1502,
"buyers": 974,
"sellers": 709
}
},
"volume_usd": {
"m5": "14594.3019415648",
"m15": "67379.9374046351",
"m30": "133544.558315085",
"h1": "375498.056536124",
"h6": "4631158.03685961",
"h24": "4631158.03685961"
},
"reserve_in_usd": "1257212.6821"
},
"relationships": {
"base_token": {
"data": {
"id": "base_0x940a319b75861014a220d9c6c144d108552b089b",
"type": "token"
}
},
"quote_token": {
"data": {
"id": "base_0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
"type": "token"
}
},
"network": {
"data": {
"id": "base",
"type": "network"
}
},
"dex": {
"data": {
"id": "aerodrome-base",
"type": "dex"
}
}
}
}
],
"included": [
{
"id": "base_0x940a319b75861014a220d9c6c144d108552b089b",
"type": "token",
"attributes": {
"address": "0x940a319b75861014a220d9c6c144d108552b089b",
"name": "DEUS Token",
"symbol": "DEUS",
"decimals": 18,
"image_url": "https://coin-images.coingecko.com/coins/images/68133/large/Screenshot_2025-08-07_at_8.52.11%E2%80%AFPM.png?1754901254",
"coingecko_coin_id": "xmaquina"
}
},
{
"id": "base_0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
"type": "token",
"attributes": {
"address": "0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
"name": "Virtual Protocol",
"symbol": "VIRTUAL",
"decimals": 18,
"image_url": "https://coin-images.coingecko.com/coins/images/34057/large/LOGOMARK.png?1708356054",
"coingecko_coin_id": "virtual-protocol"
}
},
{
"id": "aerodrome-base",
"type": "dex",
"attributes": {
"name": "Aerodrome (Base)"
}
},
{
"id": "base",
"type": "network",
"attributes": {
"name": "Base",
"coingecko_asset_platform_id": "base"
}
}
]
}Notes
- Returns up to 20 pools per page.
-
dexescan only be used when a singlenetworksis specified. -
Filter by quote token:
-
quote_token_addresses— pools trading against any of the given token addresses -
quote_token_preset— pools trading against a preset group, e.g.rwa_stockfor pools likeMEME / TSLAxQuote token presets
Preset Quote token rwa_stockTokenized stocks tracked by GeckoTerminal
-
-
Use
checksto filter pools:no_honeypot— exclude honeypot pools (GoPlus & De.Fi Scanner). Addinclude_unknown_honeypot_tokens=trueto also keep tokens with unknown honeypot status. Not supported for Solana.good_gt_score— GT Score of at least 75on_coingecko— tokens listed on CoinGeckohas_social— social links and token info updated
-
Use
includeto return related attributes under the top-levelincludedkey, e.g.include=quote_tokento see which token each pool trades against. -
Unverified token market cap returns
null— the displayed value on GeckoTerminal may match FDV and might not be accurate.
SDK Examples
New to the SDK? Install and authenticate theclient first:TypeScript | Python
const response = await client.onchain.pools.megafilter.get();
console.log(JSON.stringify(response, null, 2));
response = client.onchain.pools.megafilter.get()
print(response.model_dump_json(indent=2))
Authorizations
headerAuthqueryAuth
Learn how to set up your API key
Query Parameters
Filter pools by networks, comma-separated if more than one.
*refers to /onchain/networks.
Filter pools by DEXes, comma-separated if more than one.
*refers to /onchain/networks/{network}/dexes.
Sort the pools by field.
Default: h6_trending
Available options:
m5_trending, h1_trending, h6_trending, h24_trending, h24_tx_count_desc, h24_tx_count_asc, h24_volume_usd_desc, h24_volume_usd_asc, m5_price_change_percentage_asc, h1_price_change_percentage_asc, h6_price_change_percentage_asc, h24_price_change_percentage_asc, m5_price_change_percentage_desc, h1_price_change_percentage_desc, h6_price_change_percentage_desc, h24_price_change_percentage_desc, fdv_usd_asc, fdv_usd_desc, reserve_in_usd_asc, reserve_in_usd_desc, price_asc, price_desc, pool_created_at_desc Response
200 - application/json
Filtered pools across all networks
Hide child attributes
Hide child attributes
Hide child attributes
Hide child attributes
Price change percentage over various timeframes
Hide child attributes
Hide child attributes
Transaction counts over various timeframes
Hide child attributes
Hide child attributes
Related resources
Hide child attributes
Hide child attributes
Included related resources, present when include parameter is specified
Hide child attributes
Hide child attributes
Was this page helpful?

