Skip to main content
GET
/
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": "eth_0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
      "type": "pool",
      "attributes": {
        "base_token_price_usd": "3653.12491645176",
        "base_token_price_native_currency": "1.0",
        "quote_token_price_usd": "0.998343707926245",
        "quote_token_price_native_currency": "0.000273040545093221",
        "base_token_price_quote_token": "3662.46",
        "quote_token_price_base_token": "0.00027304",
        "address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
        "name": "WETH / USDC 0.05%",
        "pool_created_at": "2021-12-29T12:35:14Z",
        "fdv_usd": "11007041041",
        "market_cap_usd": null,
        "price_change_percentage": {
          "m5": "0",
          "m15": "0.21",
          "m30": "0.31",
          "h1": "0.51",
          "h6": "0.86",
          "h24": "7.71"
        },
        "transactions": {
          "m5": {
            "buys": 7,
            "sells": 2,
            "buyers": 7,
            "sellers": 2
          },
          "m15": {
            "buys": 19,
            "sells": 27,
            "buyers": 19,
            "sellers": 27
          },
          "m30": {
            "buys": 49,
            "sells": 61,
            "buyers": 45,
            "sellers": 57
          },
          "h1": {
            "buys": 97,
            "sells": 144,
            "buyers": 83,
            "sellers": 124
          },
          "h24": {
            "buys": 2966,
            "sells": 3847,
            "buyers": 1625,
            "sellers": 2399
          }
        },
        "volume_usd": {
          "m5": "868581.7348314",
          "m15": "2056262.885098",
          "m30": "4081230.098456",
          "h1": "16798158.0138526",
          "h6": "164054610.850188",
          "h24": "536545444.904535"
        },
        "reserve_in_usd": "163988541.3812"
      },
      "relationships": {
        "base_token": {
          "data": {
            "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "type": "token"
          }
        },
        "quote_token": {
          "data": {
            "id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "type": "token"
          }
        },
        "dex": {
          "data": {
            "id": "uniswap_v3",
            "type": "dex"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "eth_0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "type": "token",
      "attributes": {
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "name": "Wrapped Ether",
        "symbol": "WETH",
        "decimals": 18,
        "image_url": "https://assets.coingecko.com/coins/images/2518/small/weth.png?1696503332",
        "coingecko_coin_id": "weth"
      }
    }
  ]
}

​
Tips

  • Using checks param to filter pools based on various checks:
    • checks=no_honeypot — Filter out Honeypot pools, using GoPlus Token Security and De.Fi Scanner.
    • checks=good_gt_score — Show only pools with a GT Score of at least 75.
    • checks=on_coingecko — Show only pools with tokens that are listed on CoinGecko.
    • checks=has_social — Show only pools with their social links and token information updated.
  • You may include values such as page to specify which page of responses you would like to show.

​
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
  • dexes param can only be used when only 1networks is specified.
  • If the token’s market cap is not verified by the team, the API response will return null for its market cap value, even though it has a displayed value on GeckoTerminal, which might not be accurate as it often matches the Fully Diluted Valuation (FDV).
  • Attributes specified in the include param will be returned under the top-level “included” key.
  • This endpoint returns up to 20 pools per page. Use the page param to navigate more results.
  • Setting include_unknown_honeypot_tokens=true will include tokens with an ‘unknown’ honeypot status.
    • Please note that this param only takes effect when checks=no_honeypot is specified.
  • Cache/Update frequency: every 30 seconds.
  • 💼 Exclusive for Paid Plan subscribers (Analyst plan or above).

Authorizations

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

Query Parameters

​
include
string
default:base_token

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

​
page
integer
default:1

page through results Default value: 1

​
networks
string

filter pools by networks, comma-separated if more than one Network ID refers to /networks

​
dexes
string

filter pools by DEXes, comma-separated if more than one DEX ID refers to /networks/{network}/dexes

​
sort
enum<string>
default:h6_trending

sort the pools by field Default value: h6_trending

Available options:
m5_trending,
h1_trending,
h6_trending,
h24_trending,
h24_tx_count_desc,
h24_volume_usd_desc,
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,
pool_created_at_desc
​
fdv_usd_min
number

minimum fully diluted value in USD

​
fdv_usd_max
number

maximum fully diluted value in USD

​
reserve_in_usd_min
number

minimum reserve in USD

​
reserve_in_usd_max
number

maximum reserve in USD

​
h24_volume_usd_min
number

minimum 24hr volume in USD

​
h24_volume_usd_max
number

maximum 24hr volume in USD

​
pool_created_hour_min
number

minimum pool age in hours

​
pool_created_hour_max
number

maximum pool age in hours

​
tx_count_min
integer

minimum transaction count

​
tx_count_max
integer

maximum transaction count

​
tx_count_duration
enum<string>
default:24h

duration for transaction count metric Default value: 24h

Available options:
5m,
1h,
6h,
24h
​
buys_min
integer

minimum number of buy transactions

​
buys_max
integer

maximum number of buy transactions

​
buys_duration
enum<string>
default:24h

duration for buy transactions metric Default value: 24h

Available options:
5m,
1h,
6h,
24h
​
sells_min
integer

minimum number of sell transactions

​
sells_max
integer

maximum number of sell transactions

​
sells_duration
enum<string>
default:24h

duration for sell transactions metric Default value: 24h

Available options:
5m,
1h,
6h,
24h
​
checks
string
default:no_honeypot

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_tokens
boolean

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

​
buy_tax_percentage_min
number

minimum buy tax percentage

​
buy_tax_percentage_max
number

maximum buy tax percentage

​
sell_tax_percentage_min
number

minimum sell tax percentage

​
sell_tax_percentage_max
number

maximum sell tax percentage

Response

200 - application/json

TODO

​
data
object[]
​
included
object[]