Megafilter for Pools | CoinGecko API

{
  "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"
      }
    }
  ]
}

To query pools based on various filters across all networks on GeckoTerminal

Authentication

x-cg-pro-api-keystring

CoinGecko Pro API Key

Query parameters

networksstringOptional

Filter pools by networks, comma-separated if more than one. *refers to /onchain/networks.

dexesstringOptional

Filter pools by DEXes, comma-separated if more than one. *refers to /onchain/networks/{network}/dexes.

includestringOptional

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

pageintegerOptional

Page through results. Default value: 1

sortenumOptional

Sort the pools by field. Default: h6_trending

fdv_usd_mindoubleOptional

Minimum fully diluted value in USD.

fdv_usd_maxdoubleOptional

Maximum fully diluted value in USD.

reserve_in_usd_mindoubleOptional

Minimum reserve in USD.

reserve_in_usd_maxdoubleOptional

Maximum reserve in USD.

h24_volume_usd_mindoubleOptional

Minimum 24hr volume in USD.

h24_volume_usd_maxdoubleOptional

Maximum 24hr volume in USD.

pool_created_hour_mindoubleOptional

Minimum pool age in hours.

pool_created_hour_maxdoubleOptional

Maximum pool age in hours.

tx_count_minintegerOptional

Minimum transaction count.

tx_count_maxintegerOptional

Maximum transaction count.

tx_count_durationenumOptional

Duration for transaction count metric. Default: 24h

Allowed values:

buys_minintegerOptional

Minimum number of buy transactions.

buys_maxintegerOptional

Maximum number of buy transactions.

buys_durationenumOptional

Duration for buy transactions metric. Default: 24h

Allowed values:

sells_minintegerOptional

Minimum number of sell transactions.

sells_maxintegerOptional

Maximum number of sell transactions.

sells_durationenumOptional

Duration for sell transactions metric. Default: 24h

Allowed values:

price_change_percentage_mindoubleOptional

Minimum price change percentage.

price_change_percentage_maxdoubleOptional

Maximum price change percentage.

price_change_percentage_durationenumOptional

Duration for price change percentage metric. Default: 24h

Allowed values:

buy_tax_percentage_mindoubleOptional

Minimum buy tax percentage.

buy_tax_percentage_maxdoubleOptional

Maximum buy tax percentage.

sell_tax_percentage_mindoubleOptional

Minimum sell tax percentage.

sell_tax_percentage_maxdoubleOptional

Maximum sell tax percentage.

checksstringOptional

Filter options for various checks, comma-separated if more than one. Available values: no_honeypot, good_gt_score, on_coingecko, has_social

include_unknown_honeypot_tokensbooleanOptional

When checks includes no_honeypot, set to true to also include unknown honeypot tokens. Default: false

Response

Filtered pools across all networks

datalist of objects

includedlist of objectsOptional

Included related resources, present when include parameter is specified