filters and rankings as filterTokens. Results are TokenFilterResult objects, so a category page can reuse the exact rendering you already have for token screener rows.
This is a convenience wrapper for scoping token discovery to one category. If you need to combine multiple categories (anyOf, allOf, noneOf) or mix category constraints with other boolean logic, use filterTokens with the categories filter (TokenCategoryFilter) instead.
Returns
See CategoryTokenConnection
Show Properties
Show Properties
The list of tokens in the category matching the filter parameters.
See TokenFilterResult
The number of tokens returned.
Where in the list the server started when returning items.
Arguments
The category slug.
A set of additional filters to apply.
See TokenFilters
Show Properties
Show Properties
Recursive boolean expression for combining token filters.
See TokenBoolFilter
The unix timestamp for the creation of the token’s first pair.
See NumberFilter
The unix timestamp for the creation of the token.
See NumberFilter
The unix timestamp for the token’s last transaction.
See NumberFilter
The number of buys in the past 5 minutes.
See NumberFilter
The number of buys in the past hour.
See NumberFilter
The number of buys in the past 12 hours.
See NumberFilter
The number of buys in the past 24 hours.
See NumberFilter
The number of buys in the past 4 hours.
See NumberFilter
The percent price change in the past 5 minutes. Decimal format.
See NumberFilter
The percent price change in the past hour. Decimal format.
See NumberFilter
The percent price change in the past 12 hours. Decimal format.
See NumberFilter
The percent price change in the past 24 hours. Decimal format.
See NumberFilter
The percent price change in the past 4 hours. Decimal format.
See NumberFilter
The percent volume change in the past 5 minutes. Decimal format.
See NumberFilter
The percent volume change in the past hour. Decimal format.
See NumberFilter
The percent volume change in the past 4 hours. Decimal format.
See NumberFilter
The percent volume change in the past 12 hours. Decimal format.
See NumberFilter
The percent volume change in the past 24 hours. Decimal format.
See NumberFilter
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.The list of exchange contract addresses to filter by.
The highest price in USD in the past 5 minutes.
See NumberFilter
The highest price in USD in the past hour.
See NumberFilter
The highest price in USD in the past 12 hours.
See NumberFilter
The highest price in USD in the past 24 hours.
See NumberFilter
The highest price in USD in the past 4 hours.
See NumberFilter
The amount of liquidity in the token’s top pair.
See NumberFilter
The lowest price in USD in the past hour.
See NumberFilter
The lowest price in USD in the past 5 minutes.
See NumberFilter
The lowest price in USD in the past 12 hours.
See NumberFilter
The lowest price in USD in the past 24 hours.
See NumberFilter
The lowest price in USD in the past 4 hours.
See NumberFilter
The fully diluted market cap.
See NumberFilter
The circulating market cap.
See NumberFilter
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.The number of different wallets holding the token.
See NumberFilter
The token price in USD.
See NumberFilter
The number of sells in the past hour.
See NumberFilter
The number of sells in the past 5 minutes.
See NumberFilter
The number of sells in the past 12 hours.
See NumberFilter
The number of sells in the past 24 hours.
See NumberFilter
The number of sells in the past 4 hours.
See NumberFilter
The number of transactions in the past 5 minutes.
See NumberFilter
The number of transactions in the past hour.
See NumberFilter
The number of transactions in the past 12 hours.
See NumberFilter
The number of transactions in the past 24 hours.
See NumberFilter
The number of transactions in the past 4 hours.
See NumberFilter
The unique number of buys in the past hour.
See NumberFilter
The unique number of buys in the past 5 minutes.
See NumberFilter
The unique number of buys in the past 12 hours.
See NumberFilter
The unique number of buys in the past 24 hours.
See NumberFilter
The unique number of buys in the past 4 hours.
See NumberFilter
The unique number of sells in the past 5 minutes.
See NumberFilter
The unique number of sells in the past hour.
See NumberFilter
The unique number of sells in the past 12 hours.
See NumberFilter
The unique number of sells in the past 24 hours.
See NumberFilter
The unique number of sells in the past 4 hours.
See NumberFilter
The unique number of transactions in the past hour.
See NumberFilter
The unique number of transactions in the past 5 minutes.
See NumberFilter
The unique number of transactions in the past 12 hours.
See NumberFilter
The unique number of transactions in the past 24 hours.
See NumberFilter
The unique number of transactions in the past 4 hours.
See NumberFilter
The trade volume in USD in the past hour.
See NumberFilter
The trade volume in USD in the past 12 hours.
See NumberFilter
The trade volume in USD in the past 24 hours.
See NumberFilter
The trade volume in USD in the past 4 hours.
See NumberFilter
The trade volume in USD in the past 5 minutes.
See NumberFilter
The buy volume in USD in the past hour.
See NumberFilter
The buy volume in USD in the past 12 hours.
See NumberFilter
The buy volume in USD in the past 24 hours.
See NumberFilter
The buy volume in USD in the past 4 hours.
See NumberFilter
The buy volume in USD in the past 5 minutes.
See NumberFilter
The sell volume in USD in the past hour.
See NumberFilter
The sell volume in USD in the past 12 hours.
See NumberFilter
The sell volume in USD in the past 24 hours.
See NumberFilter
The sell volume in USD in the past 4 hours.
See NumberFilter
The sell volume in USD in the past 5 minutes.
See NumberFilter
Whether to include tokens that have been flagged as scams. Default: false
Whether to filter for tokens on testnet networks. Use
true for testnet tokens only, false for mainnet tokens only and undefined (default) for both.Only include verified tokens
Filter potential Scams
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.The addresses of the token creators (supports multiple addresses). Max 25 addresses. You cannot provide both creatorAddress and creatorAddresses.
A list of launchpad protocols.
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, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo, Flap, EasyA Kickstart.
Indicates if the launchpad is completed.
Indicates if the launchpad has migrated.
The graduation percentage.
See NumberFilter
The timestamp when the launchpad was completed.
See NumberFilter
The timestamp when the launchpad was migrated.
See NumberFilter
The token is freezable.
The token is mintable.
Whether the token name or symbol contains profanity.
The average age of the wallets that traded in the last 24h.
See NumberFilter
The standard deviation of age of the wallets that traded in the last 24h.
See NumberFilter
The percentage of wallets that are less than 1d old that have traded in the last 24h.
See NumberFilter
The percentage of wallets that are less than 7d old that have traded in the last 24h.
See NumberFilter
Filter by total fees in the past 5 minutes.
See NumberFilter
Filter by total fees in the past hour.
See NumberFilter
Filter by total fees in the past 4 hours.
See NumberFilter
Filter by total fees in the past 12 hours.
See NumberFilter
Filter by total fees in the past 24 hours.
See NumberFilter
Filter by pool fees in the past 24 hours.
See NumberFilter
Filter by fee to volume ratio in the past 24 hours.
See NumberFilter
Filter by number of wallets that have sniped the token
See NumberFilter
Filter by percentage of tokens held by snipers
See NumberFilter
Filter by number of wallets that have bundled the token
See NumberFilter
Filter by percentage of tokens held by bundlers
See NumberFilter
Filter by number of wallets that have been an insider of the token
See NumberFilter
Filter by percentage of tokens held by insiders
See NumberFilter
Filter by number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders)
See NumberFilter
Filter by percentage of tokens held by suspicious wallets
See NumberFilter
Filter by percentage of tokens held by the dev
See NumberFilter
Filter by top 10 holders percentage.
See NumberFilter
Filter by number of posts in the token’s coin community.
See NumberFilter
Filter by number of members in the token’s coin community.
See NumberFilter
Filter by number of likes in the token’s coin community.
See NumberFilter
Filter by unix timestamp for the most recent post in the token’s coin community.
See NumberFilter
Filter by whether the token has linked Grid asset data.
Filter by Grid bluechip ratings. Returns tokens matching any of the provided ratings.
Filter by all-time high price.
See NumberFilter
Filter by all-time low price.
See NumberFilter
Filter by all-time high FDV.
See NumberFilter
Filter by all-time low FDV.
See NumberFilter
Filter by all-time high circulating market cap.
See NumberFilter
Filter by all-time low circulating market cap.
See NumberFilter
See NumberFilter
This field is deprecated. Age isn’t supported - use createdAt instead
See NumberFilter
This field is deprecated. FDV isn’t supported - use marketCap instead
The address of the creator of the token.
This field is deprecated. Use creatorAddresses string array instead
A list of ranking attributes to apply.
See TokenRanking
Show Properties
Show Properties
The attribute to rank tokens by.
See TokenRankingAttribute
The direction to apply to the ranking attribute.
See RankingDirection
The maximum number of tokens to return.
Where in the list the server should start when returning items. Use
count+page from the previous query to request the next page of results.Example
Test this query in the Explorer →{
categoryTokens(
slug: "artificial-intelligence"
filters: {liquidity: {gt: 100000}}
rankings: [{attribute: volume24, direction: DESC}]
limit: 25
) {
results {
token {
address
networkId
name
symbol
}
priceUSD
liquidity
marketCap
volume24
change24
holders
}
count
page
}
}
Usage Guidelines
- Apply quality filters such as liquidity and volume minimums to avoid low quality tokens, just as you would with
filterTokens. - Use
countandpagefrom the previous response to request the next page of results.