[TokenFilters!]
All nested filters must match.
See TokenFilters
Show Properties
Show Properties
TokenBoolFilter
Recursive boolean expression for combining token filters.
See TokenBoolFilter
Show Properties
Show Properties
[TokenFilters!]
All nested filters must match.
See TokenFilters
[TokenFilters!]
At least one nested filter must match.
See TokenFilters
TokenFilters
The nested filter must not match.
See TokenFilters
TokenCategoryFilter
TokenSocialFilter
Filter by the token’s social links (contributed or provider-sourced). Grid organization links are not counted.
See TokenSocialFilter
Show Properties
Show Properties
[TokenSocialLink!]
Match tokens with any of these social links (OR).
See TokenSocialLink
[TokenSocialLink!]
Match tokens with all of these social links (AND).
See TokenSocialLink
[TokenSocialLink!]
Exclude tokens with any of these social links.
See TokenSocialLink
Boolean
Match tokens that have at least one social link (true) or none (false).
TokenMediaFilter
Filter by the token’s logo, banner and video. Grid images are not counted.
See TokenMediaFilter
Show Properties
Show Properties
[TokenMediaType!]
Match tokens with any of these media types (OR).
See TokenMediaType
[TokenMediaType!]
Match tokens with all of these media types (AND).
See TokenMediaType
[TokenMediaType!]
Exclude tokens with any of these media types.
See TokenMediaType
Boolean
Match tokens that have at least one media type (true) or none (false).
NumberFilter
The unix timestamp for the creation of the token’s first pair.
See NumberFilter
NumberFilter
The unix timestamp for the creation of the token.
See NumberFilter
NumberFilter
The unix timestamp for the token’s last transaction.
See NumberFilter
NumberFilter
The number of buys in the past 5 minutes.
See NumberFilter
NumberFilter
The number of buys in the past hour.
See NumberFilter
NumberFilter
The number of buys in the past 12 hours.
See NumberFilter
NumberFilter
The number of buys in the past 24 hours.
See NumberFilter
NumberFilter
The number of buys in the past 4 hours.
See NumberFilter
NumberFilter
The percent price change in the past 5 minutes. Decimal format.
See NumberFilter
NumberFilter
The percent price change in the past hour. Decimal format.
See NumberFilter
NumberFilter
The percent price change in the past 12 hours. Decimal format.
See NumberFilter
NumberFilter
The percent price change in the past 24 hours. Decimal format.
See NumberFilter
NumberFilter
The percent price change in the past 4 hours. Decimal format.
See NumberFilter
NumberFilter
The percent volume change in the past 5 minutes. Decimal format.
See NumberFilter
NumberFilter
The percent volume change in the past hour. Decimal format.
See NumberFilter
NumberFilter
The percent volume change in the past 4 hours. Decimal format.
See NumberFilter
NumberFilter
The percent volume change in the past 12 hours. Decimal format.
See NumberFilter
NumberFilter
The percent volume change in the past 24 hours. Decimal format.
See NumberFilter
[String]
The list of exchange contract IDs to filter by. Applied in conjunction with
network filter using an OR condition. When used together, the query returns results that match either the specified exchanges or the specified network.[String]
The list of exchange contract addresses to filter by.
NumberFilter
The highest price in USD in the past 5 minutes.
See NumberFilter
NumberFilter
The highest price in USD in the past hour.
See NumberFilter
NumberFilter
The highest price in USD in the past 12 hours.
See NumberFilter
NumberFilter
The highest price in USD in the past 24 hours.
See NumberFilter
NumberFilter
The highest price in USD in the past 4 hours.
See NumberFilter
NumberFilter
The amount of liquidity in the token’s top pair. With
useAggregatedStats, on networks where the real-money total is enabled, this filters on the same value as totalLiquidityUsd once the token has one; on other networks it filters on the token’s aggregated liquidity.
See NumberFilterNumberFilter
The token’s total liquidity in USD: the combined liquidity of its 15 deepest pools, leaving out pools with no trade in the last 7 days. On networks where the real-money total is enabled, each pool counts only the real money behind it: what the token can reach in one or two trades into the network’s pricing reference tokens (such as its main stablecoins), with each route counted once. Distinct from
liquidity, which covers the top pair only, except with useAggregatedStats on networks where the real-money total is enabled, where the two are the same value.
See NumberFilterNumberFilter
The lowest price in USD in the past hour.
See NumberFilter
NumberFilter
The lowest price in USD in the past 5 minutes.
See NumberFilter
NumberFilter
The lowest price in USD in the past 12 hours.
See NumberFilter
NumberFilter
The lowest price in USD in the past 24 hours.
See NumberFilter
NumberFilter
The lowest price in USD in the past 4 hours.
See NumberFilter
NumberFilter
The fully diluted market cap.
See NumberFilter
NumberFilter
The circulating market cap.
See NumberFilter
[Int]
The list of network IDs to filter by. Applied in conjunction with
exchangeId filter using an OR condition. When used together, the query returns results that match either the specified exchanges or the specified network.NumberFilter
The number of different wallets holding the token.
See NumberFilter
NumberFilter
The token price in USD.
See NumberFilter
NumberFilter
The number of sells in the past hour.
See NumberFilter
NumberFilter
The number of sells in the past 5 minutes.
See NumberFilter
NumberFilter
The number of sells in the past 12 hours.
See NumberFilter
NumberFilter
The number of sells in the past 24 hours.
See NumberFilter
NumberFilter
The number of sells in the past 4 hours.
See NumberFilter
NumberFilter
The number of transactions in the past 5 minutes.
See NumberFilter
NumberFilter
The number of transactions in the past hour.
See NumberFilter
NumberFilter
The number of transactions in the past 12 hours.
See NumberFilter
NumberFilter
The number of transactions in the past 24 hours.
See NumberFilter
NumberFilter
The number of transactions in the past 4 hours.
See NumberFilter
NumberFilter
The unique number of buys in the past hour.
See NumberFilter
NumberFilter
The unique number of buys in the past 5 minutes.
See NumberFilter
NumberFilter
The unique number of buys in the past 12 hours.
See NumberFilter
NumberFilter
The unique number of buys in the past 24 hours.
See NumberFilter
NumberFilter
The unique number of buys in the past 4 hours.
See NumberFilter
NumberFilter
The unique number of sells in the past 5 minutes.
See NumberFilter
NumberFilter
The unique number of sells in the past hour.
See NumberFilter
NumberFilter
The unique number of sells in the past 12 hours.
See NumberFilter
NumberFilter
The unique number of sells in the past 24 hours.
See NumberFilter
NumberFilter
The unique number of sells in the past 4 hours.
See NumberFilter
NumberFilter
The unique number of transactions in the past hour.
See NumberFilter
NumberFilter
The unique number of transactions in the past 5 minutes.
See NumberFilter
NumberFilter
The unique number of transactions in the past 12 hours.
See NumberFilter
NumberFilter
The unique number of transactions in the past 24 hours.
See NumberFilter
NumberFilter
The unique number of transactions in the past 4 hours.
See NumberFilter
NumberFilter
The trade volume in USD in the past hour.
See NumberFilter
NumberFilter
The trade volume in USD in the past 12 hours.
See NumberFilter
NumberFilter
The trade volume in USD in the past 24 hours.
See NumberFilter
NumberFilter
The trade volume in USD in the past 4 hours.
See NumberFilter
NumberFilter
The trade volume in USD in the past 5 minutes.
See NumberFilter
NumberFilter
The buy volume in USD in the past hour.
See NumberFilter
NumberFilter
The buy volume in USD in the past 12 hours.
See NumberFilter
NumberFilter
The buy volume in USD in the past 24 hours.
See NumberFilter
NumberFilter
The buy volume in USD in the past 4 hours.
See NumberFilter
NumberFilter
The buy volume in USD in the past 5 minutes.
See NumberFilter
NumberFilter
The sell volume in USD in the past hour.
See NumberFilter
NumberFilter
The sell volume in USD in the past 12 hours.
See NumberFilter
NumberFilter
The sell volume in USD in the past 24 hours.
See NumberFilter
NumberFilter
The sell volume in USD in the past 4 hours.
See NumberFilter
NumberFilter
The sell volume in USD in the past 5 minutes.
See NumberFilter
Boolean
Whether to include tokens that have been flagged as scams. Default: false
Boolean
Whether to filter for tokens on testnet networks. Use
true for testnet tokens only, false for mainnet tokens only and undefined (default) for both.Boolean
Only include verified tokens
Boolean
Filter potential Scams
Boolean
Whether to ignore pairs/tokens not relevant to trending. This is done checking against a few factors and ignoring uninteresting tokens like stables / network tokens. If you want all tokens regardless of these checks, then don’t include this field. (default) If you want only tokens that fail the trending ignore checks, then set it to
true. (i.e. stablecoins, rugs, network base tokens) If you want only tokens that pass the trending ignore checks, then set it to false.[String!]
The addresses of the token creators (supports multiple addresses). Max 25 addresses. You cannot provide both creatorAddress and creatorAddresses.
[String!]
A list of launchpad protocols.
[String!]
A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, bow.fun, Sushi Launch, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Trench, Flap, NOXA Fun, hood.fun, moto.fun, pons, Genius, Peach, LONG, Feel.cash, EasyA Kickstart, Doppler, o1.exchange, minara.fun, UniswapCCA, tren.ch, StonkFun, Tolly, Launchfair, send.fun, hostile.xyz, Argus, Faze, Lift.
Boolean
Indicates if the launchpad is completed.
Boolean
Indicates if the launchpad has migrated.
NumberFilter
The graduation percentage.
See NumberFilter
NumberFilter
The timestamp when the launchpad was completed.
See NumberFilter
NumberFilter
The timestamp when the launchpad was migrated.
See NumberFilter
Boolean
The token is freezable.
Boolean
The token is mintable.
Boolean
Whether the token name or symbol contains profanity.
NumberFilter
The average age of the wallets that traded in the last 24h.
See NumberFilter
NumberFilter
The standard deviation of age of the wallets that traded in the last 24h.
See NumberFilter
NumberFilter
The percentage of wallets that are less than 1d old that have traded in the last 24h.
See NumberFilter
NumberFilter
The percentage of wallets that are less than 7d old that have traded in the last 24h.
See NumberFilter
NumberFilter
Filter by total fees in the past 5 minutes.
See NumberFilter
NumberFilter
Filter by total fees in the past hour.
See NumberFilter
NumberFilter
Filter by total fees in the past 4 hours.
See NumberFilter
NumberFilter
Filter by total fees in the past 12 hours.
See NumberFilter
NumberFilter
Filter by total fees in the past 24 hours.
See NumberFilter
NumberFilter
Filter by pool fees in the past 24 hours.
See NumberFilter
NumberFilter
Filter by fee to volume ratio in the past 24 hours.
See NumberFilter
NumberFilter
Filter by number of wallets that have sniped the token
See NumberFilter
NumberFilter
Filter by percentage of tokens held by snipers
See NumberFilter
NumberFilter
Filter by number of wallets that have bundled the token
See NumberFilter
NumberFilter
Filter by percentage of tokens held by bundlers
See NumberFilter
NumberFilter
Filter by number of wallets that have been an insider of the token
See NumberFilter
NumberFilter
Filter by percentage of tokens held by insiders
See NumberFilter
NumberFilter
Filter by number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders)
See NumberFilter
NumberFilter
Filter by percentage of tokens held by suspicious wallets
See NumberFilter
NumberFilter
Filter by percentage of tokens held by the dev
See NumberFilter
NumberFilter
Filter by top 10 holders percentage.
See NumberFilter
NumberFilter
Filter by number of posts in the token’s coin community.
See NumberFilter
NumberFilter
Filter by number of members in the token’s coin community.
See NumberFilter
NumberFilter
Filter by number of likes in the token’s coin community.
See NumberFilter
NumberFilter
Filter by unix timestamp for the most recent post in the token’s coin community.
See NumberFilter
Boolean
Filter by whether the token has linked Grid asset data.
[String!]
Filter by Grid bluechip ratings. Returns tokens matching any of the provided ratings.
[RiskVerdict!]
Filter by risk verdict. Returns tokens matching any of the provided verdicts.
See RiskVerdict
Show Properties
Show Properties
enum
Proven a scam by mechanical evidence, or labelled one by a human.
enum
The weighted score reached the high-risk threshold.
enum
The weighted score reached the caution threshold but remains below high risk.
enum
The weighted score is below the caution threshold. Reasons may still be present. Not a statement that the token is safe.
enum
A human marked this token not-a-scam. A moderator judgement, not an allowlist.
enum
Marked not-a-scam by a human, but mechanical signals disagree.
[RiskAnalysisCoverage!]
Filter by how much contract analysis stood behind the verdict.
See RiskAnalysisCoverage
Show Properties
Show Properties
enum
No contract analysis stands behind this assessment.
enum
Analysis ran but reached no decisive verdict.
enum
Analysis ran and reached a decisive verdict, or proved a pool of the token is a trap.
enum
The verdict rests on a tradeable analysis more than seven days old. A contract can change after it was probed. A honeypot proof never becomes stale.
[RiskReasonCode!]
Filter by risk reason codes. Returns tokens where any of the provided reasons fired.
See RiskReasonCode
Show Properties
Show Properties
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
The creator of a launchpad token sold or handed off a large share of supply in the token’s first hour.
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
NumberFilter
Filter by weighted risk score.
See NumberFilter
NumberFilter
Filter by when the engine last recorded a change to the risk assessment, in Unix seconds.
See NumberFilter
NumberFilter
Filter by all-time high price.
See NumberFilter
NumberFilter
Filter by all-time low price.
See NumberFilter
NumberFilter
Filter by all-time high FDV.
See NumberFilter
NumberFilter
Filter by all-time low FDV.
See NumberFilter
NumberFilter
Filter by all-time high circulating market cap.
See NumberFilter
NumberFilter
Filter by all-time low circulating market cap.
See NumberFilter
NumberFilter
deprecated
See NumberFilter
This field is deprecated. Age isn’t supported - use createdAt instead
NumberFilter
deprecated
See NumberFilter
This field is deprecated. FDV isn’t supported - use marketCap instead
String
deprecated
The address of the creator of the token.
This field is deprecated. Use creatorAddresses string array instead
[TokenFilters!]
At least one nested filter must match.
See TokenFilters
TokenFilters
The nested filter must not match.
See TokenFilters
Used By
Used as input by- categoryTokens: Returns the tokens assigned to a category (including its subcategories), with optional
filterTokens-style filters and rankings applied. - filterTokens: Discover, screen, and rank tokens across every supported network using 100+ on-chain signals: trading activity, liquidity, holder behavior, fee economics, and launchpad lifecycle.
- onFilterTokensUpdated: Live-streamed filter token updates for the current
filterTokensresult set.