Overview
Query tokens across all supported networks with powerful filtering, sorting, and pagination. Ideal for building token screeners, trending lists, and discovery feeds.- Filter by volume, price change, liquidity, market cap, holder metrics, and more
- Sort by any filterable attribute plus trending scores
- Paginate with
limit/offset - Optionally resolve full token metadata and pair data
Returns
See TokenFilterConnection and TokenFilterResult for full type details.
Show View fields (TokenFilterConnection)
Show View fields (TokenFilterConnection)
List of matching tokens.
Show TokenFilterResult
Show TokenFilterResult
Token creation timestamp (unix seconds).
Last transaction timestamp (unix seconds).
Buys in 5 minutes.
Buys in 1 hour.
Buys in 4 hours.
Buys in 12 hours.
Buys in 24 hours.
Sells in 5 minutes.
Sells in 1 hour.
Sells in 4 hours.
Sells in 12 hours.
Sells in 24 hours.
Transactions in 5 minutes.
Transactions in 1 hour.
Transactions in 4 hours.
Transactions in 12 hours.
Transactions in 24 hours.
Unique buyers in 5 minutes.
Unique buyers in 1 hour.
Unique buyers in 4 hours.
Unique buyers in 12 hours.
Unique buyers in 24 hours.
Unique sellers in 5 minutes.
Unique sellers in 1 hour.
Unique sellers in 4 hours.
Unique sellers in 12 hours.
Unique sellers in 24 hours.
Unique traders in 5 minutes.
Unique traders in 1 hour.
Unique traders in 4 hours.
Unique traders in 12 hours.
Unique traders in 24 hours.
Price change in 5 minutes.
Price change in 1 hour.
Price change in 4 hours.
Price change in 12 hours.
Price change in 24 hours.
Volume change in 5 minutes.
Volume change in 1 hour.
Volume change in 4 hours.
Volume change in 12 hours.
Volume change in 24 hours.
Highest price in 5 minutes.
Highest price in 1 hour.
Highest price in 4 hours.
Highest price in 12 hours.
Highest price in 24 hours.
Lowest price in 5 minutes.
Lowest price in 1 hour.
Lowest price in 4 hours.
Lowest price in 12 hours.
Lowest price in 24 hours.
Volume in 5 minutes.
Volume in 1 hour.
Volume in 4 hours.
Volume in 12 hours.
Volume in 24 hours.
Buy volume in 5 minutes.
Buy volume in 1 hour.
Buy volume in 4 hours.
Buy volume in 12 hours.
Buy volume in 24 hours.
Sell volume in 5 minutes.
Sell volume in 1 hour.
Sell volume in 4 hours.
Sell volume in 12 hours.
Sell volume in 24 hours.
Current price in USD.
Total liquidity in USD.
Market cap in USD.
Circulating market cap in USD.
Holder count.
Quote token identifier.
Most liquid pair.
Liquid pair liquidity in USD.
Liquid pair price in USD.
Full token details. See EnhancedToken.
Whether the token is flagged as a scam.
Potential scam reason flags.
1-hour trending score.
Number of sniper holders.
Percentage held by snipers.
Number of bundler holders.
Percentage held by bundlers.
Number of insider holders.
Percentage held by insiders.
Percentage held by developers.
Percentage held by top 10 holders.
Average wallet age.
Wallet age standard deviation.
Swap percentage from 1-day old wallets.
Swap percentage from 7-day old wallets.
Pool fees in 5 min.
Pool fees in 1 hour.
Pool fees in 4 hours.
Pool fees in 12 hours.
Pool fees in 24 hours.
Base fees in 5 min.
Base fees in 1 hour.
Base fees in 4 hours.
Base fees in 12 hours.
Base fees in 24 hours.
Priority fees in 5 min.
Priority fees in 1 hour.
Priority fees in 4 hours.
Priority fees in 12 hours.
Priority fees in 24 hours.
Builder tips in 5 min.
Builder tips in 1 hour.
Builder tips in 4 hours.
Builder tips in 12 hours.
Builder tips in 24 hours.
L1 data fees in 5 min.
L1 data fees in 1 hour.
L1 data fees in 4 hours.
L1 data fees in 12 hours.
L1 data fees in 24 hours.
Total fees in 5 min.
Total fees in 1 hour.
Total fees in 4 hours.
Total fees in 12 hours.
Total fees in 24 hours.
Fee-to-volume ratio in 5 min.
Fee-to-volume ratio in 1 hour.
Fee-to-volume ratio in 4 hours.
Fee-to-volume ratio in 12 hours.
Fee-to-volume ratio in 24 hours.
Number of results returned.
Current page number.
Arguments
Filter conditions for token statistics. Each numeric field accepts a NumberFilter with
gt, gte, lt, lte operators. See TokenFilters for all available fields.Statistics type. See TokenPairStatisticsType.
Search phrase to match against token name or symbol.
Array of specific token selectors in
"address:networkId" format.Array of token addresses to exclude from results.
Sorting criteria. See TokenRanking and TokenRankingAttribute for all sortable fields.
Show TokenRanking
Show TokenRanking
The field to sort by.
Show TokenRankingAttribute values
Show TokenRankingAttribute values
Token creation timestamp.
Token contract creation timestamp.
Last transaction timestamp.
Buys in 5 minutes.
Buys in 1 hour.
Buys in 4 hours.
Buys in 12 hours.
Buys in 24 hours.
Sells in 5 minutes.
Sells in 1 hour.
Sells in 4 hours.
Sells in 12 hours.
Sells in 24 hours.
Transactions in 5 minutes.
Transactions in 1 hour.
Transactions in 4 hours.
Transactions in 12 hours.
Transactions in 24 hours.
Unique buyers in 5 minutes.
Unique buyers in 1 hour.
Unique buyers in 4 hours.
Unique buyers in 12 hours.
Unique buyers in 24 hours.
Unique sellers in 5 minutes.
Unique sellers in 1 hour.
Unique sellers in 4 hours.
Unique sellers in 12 hours.
Unique sellers in 24 hours.
Unique traders in 5 minutes.
Unique traders in 1 hour.
Unique traders in 4 hours.
Unique traders in 12 hours.
Unique traders in 24 hours.
Price change in 5 minutes.
Price change in 1 hour.
Price change in 4 hours.
Price change in 12 hours.
Price change in 24 hours.
Volume change in 5 minutes.
Volume change in 1 hour.
Volume change in 4 hours.
Volume change in 12 hours.
Volume change in 24 hours.
Highest price in 5 minutes.
Highest price in 1 hour.
Highest price in 4 hours.
Highest price in 12 hours.
Highest price in 24 hours.
Lowest price in 5 minutes.
Lowest price in 1 hour.
Lowest price in 4 hours.
Lowest price in 12 hours.
Lowest price in 24 hours.
Volume in 5 minutes.
Volume in 1 hour.
Volume in 4 hours.
Volume in 12 hours.
Volume in 24 hours.
Buy volume in 5 minutes.
Buy volume in 1 hour.
Buy volume in 4 hours.
Buy volume in 12 hours.
Buy volume in 24 hours.
Sell volume in 5 minutes.
Sell volume in 1 hour.
Sell volume in 4 hours.
Sell volume in 12 hours.
Sell volume in 24 hours.
Total liquidity.
Market cap.
Circulating market cap.
Current price.
Holder count.
1-hour trending score.
5-minute trending score.
1-hour trending score.
4-hour trending score.
12-hour trending score.
24-hour trending score.
Notable holder count.
Launchpad completion timestamp.
Launchpad migration timestamp.
Graduation percentage.
Average wallet age.
Wallet age standard deviation.
1-day old wallet swap percentage.
7-day old wallet swap percentage.
Top 10 holders percentage.
Sort direction:
ASC or DESC.Maximum number of results to return (default: 25, max: 200).
Pagination offset (default: 0).
Example
{
filterTokens(
filters: {
network: [1]
liquidity: { gte: 10000 }
volume24: { gte: 50000 }
}
rankings: [{ attribute: volume24, direction: DESC }]
limit: 10
) {
results {
priceUSD
liquidity
marketCap
volume24
change24
buyCount24
sellCount24
uniqueBuys24
uniqueSells24
holders
token {
name
symbol
address
networkId
}
}
count
page
}
}