filterTokens

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

TokenFilterConnection!

See TokenFilterConnection and TokenFilterResult for full type details.

Arguments

TokenFilters

Filter conditions for token statistics. Each numeric field accepts a NumberFilter with gt, gte, lt, lte operators. See TokenFilters for all available fields.

TokenPairStatisticsType

Statistics type. See TokenPairStatisticsType.

String

Search phrase to match against token name or symbol.

[String]

Array of specific token selectors in "address:networkId" format.

[String]

Array of token addresses to exclude from results.

[TokenRanking]

Sorting criteria. See TokenRanking and TokenRankingAttribute for all sortable fields.

Int

Maximum number of results to return (default: 25, max: 200).

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
  }
}

GraphQL API Reference

Queries (Alpha Preview)

Mutations (Alpha Preview)

Subscriptions (Alpha Preview)

Types

Overview

Returns

Arguments

Example

Playground

​Overview

​Returns

​Arguments

​Example

​Playground

Overview

Returns

Arguments

Example

Playground