COcoingecko

Megafilter for Pools

Changed on

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

get/onchain/pools/megafilter

Request

  • Base URL
    https://pro-api.coingecko.com/api/v3
  • Auth
    • API key in header x-cg-pro-api-key
    • or API key in query parameter x_cg_pro_api_key

Query parameters

networksstring

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

dexesstring

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

quote_token_addressesstring

Filter pools whose quote token is one of these token addresses, comma-separated if more than one. Maximum: 50 addresses

quote_token_preset'rwa_stock'

Filter pools whose quote token belongs to a preset group.

includestring

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

pageinteger

Page through results. Default value: 1

sort'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'

Sort the pools by field. Default: h6_trending

fdv_usd_minnumber

Minimum fully diluted value in USD.

fdv_usd_maxnumber

Maximum fully diluted value in USD.

reserve_in_usd_minnumber

Minimum reserve in USD.

reserve_in_usd_maxnumber

Maximum reserve in USD.

h24_volume_usd_minnumber

Minimum 24hr volume in USD.

h24_volume_usd_maxnumber

Maximum 24hr volume in USD.

pool_created_hour_minnumber

Minimum pool age in hours.

pool_created_hour_maxnumber

Maximum pool age in hours.

tx_count_mininteger

Minimum transaction count.

tx_count_maxinteger

Maximum transaction count.

tx_count_duration'5m' | '1h' | '6h' | '24h'

Duration for transaction count metric. Default: 24h

buys_mininteger

Minimum number of buy transactions.

buys_maxinteger

Maximum number of buy transactions.

buys_duration'5m' | '1h' | '6h' | '24h'

Duration for buy transactions metric. Default: 24h

sells_mininteger

Minimum number of sell transactions.

sells_maxinteger

Maximum number of sell transactions.

sells_duration'5m' | '1h' | '6h' | '24h'

Duration for sell transactions metric. Default: 24h

price_change_percentage_minnumber

Minimum price change percentage.

price_change_percentage_maxnumber

Maximum price change percentage.

price_change_percentage_duration'5m' | '1h' | '6h' | '24h'

Duration for price change percentage metric. Default: 24h

buy_tax_percentage_minnumber

Minimum buy tax percentage.

buy_tax_percentage_maxnumber

Maximum buy tax percentage.

sell_tax_percentage_minnumber

Minimum sell tax percentage.

sell_tax_percentage_maxnumber

Maximum sell tax percentage.

holder_count_mininteger

Minimum holder count.

holder_count_maxinteger

Maximum holder count.

top_10_holders_percentage_minnumber

Minimum top 10 holders percentage.

top_10_holders_percentage_maxnumber

Maximum top 10 holders percentage.

checksstring

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_tokensboolean

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

Response

Filtered pools across all networks

Changes

  • 0b8b4c00948cRevision changes
    • info

      added the new optional query request parameter quote_token_addresses

    • info

      added the new optional query request parameter quote_token_preset

  • 11cc9e00fd86Revision changes
    • breaking

      for the query request parameter buys_duration, default value 24h was removed

    • breaking

      for the query request parameter checks, default value no_honeypot was removed

    • breaking

      for the query request parameter include, default value base_token was removed

    • breaking

      for the query request parameter page, default value 1 was removed

    • breaking

      for the query request parameter sells_duration, default value 24h was removed

    • breaking

      for the query request parameter sort, default value h6_trending was removed

    • breaking

      for the query request parameter tx_count_duration, default value 24h was removed

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • breaking

      the response property /// became nullable for the status

    • info

      api tag Pools removed

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      the response property became required for the status

    • info

      the response property // became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property /// became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status