Skip to main content

​
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

​
filterTokens
TokenFilterConnection!
See TokenFilterConnection and TokenFilterResult for full type details.

​
Arguments

​
filters
TokenFilters
Filter conditions for token statistics. Each numeric field accepts a NumberFilter with gt, gte, lt, lte operators. See TokenFilters for all available fields.
​
statsType
TokenPairStatisticsType
Statistics type. See TokenPairStatisticsType.
​
phrase
String
Search phrase to match against token name or symbol.
​
tokens
[String]
Array of specific token selectors in "address:networkId" format.
​
excludeTokens
[String]
Array of token addresses to exclude from results.
​
rankings
[TokenRanking]
Sorting criteria. See TokenRanking and TokenRankingAttribute for all sortable fields.
​
limit
Int
Maximum number of results to return (default: 25, max: 200).
​
offset
Int
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
  }
}

​
Playground