API Reference
Log In
API Reference

🔥 Megafilter for Pools

This endpoint allows you to query pools based on various filters across all networks on GeckoTerminal

👍

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.
📘

Notes

  • 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).
Query Params
string

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

integer
Defaults to 1

page through results
Default value: 1

string

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

string

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

string
enum
Defaults to h6_trending

sort the pools by field
Default value: h6_trending

number

minimum fully diluted value in USD

number

maximum fully diluted value in USD

number

minimum reserve in USD

number

maximum reserve in USD

number

minimum 24hr volume in USD

number

maximum 24hr volume in USD

number

minimum pool age in hours

number

maximum pool age in hours

integer

minimum transaction count

integer

maximum transaction count

string
enum
Defaults to 24h

duration for transaction count metric
Default value: 24h

Allowed:
integer

minimum number of buy transactions

integer

maximum number of buy transactions

string
enum
Defaults to 24h

duration for buy transactions metric
Default value: 24h

Allowed:
integer

minimum number of sell transactions

integer

maximum number of sell transactions

string
enum
Defaults to 24h

duration for sell transactions metric
Default value: 24h

Allowed:
string

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

boolean

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

number

minimum buy tax percentage

number

maximum buy tax percentage

number

minimum sell tax percentage

number

maximum sell tax percentage

Response

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json