Skip to main content
Instead of relying on simple search or static lists, this feature allows you to query the token universe dynamically, using real market, holder, liquidity, and security signals. It’s designed for:
  • Token discovery platforms
  • Market analytics tools
  • Trading and research dashboards

​
What Filtered Tokens Does

Filtered Tokens lets you:
  • Query tokens across multiple chains in a single request
  • Combine multiple filters using comparison operators
  • Analyze short-term and long-term trends
  • Sort tokens by any supported metric
  • Include or exclude token categories
  • Apply safety and quality thresholds
This makes it possible to express questions like:
“Which high-liquidity tokens gained buyers in the last hour?”
“Which new tokens launched this week already have strong volume?”
“Which tokens meet my safety and maturity criteria?”

​
Supported Blockchains

Filtered Tokens supports major networks, including:
  • Ethereum
  • Solana
  • Base
  • Arbitrum
  • Polygon
  • BNB Chain
  • Avalanche
  • Optimism
  • Ronin
  • Linea
  • Fantom
  • PulseChain
Coverage continues to expand.

​
Available Metrics

​
Market Metrics

  • marketCap – Current market capitalization
  • fullyDilutedValuation – FDV
  • totalLiquidityUsd – Total liquidity (USD)

​
Trading Metrics (time-based)

  • volumeUsd – Trading volume
  • usdPricePercentChange – Price change (%)
  • liquidityChange – Liquidity change
  • liquidityChangeUSD – Liquidity change (USD)

​
Holder & Flow Metrics (time-based)

  • totalHolders – Current holder count
  • holders – Holder growth
  • buyers / sellers – Active traders
  • netBuyers – Net buyer flow
  • experiencedBuyers / experiencedSellers – Experienced trader activity

​
Acquisition Metrics

  • holdersBySwap – % acquired via DEX
  • holdersByTransfer – % acquired via transfers
  • holdersByAirdrop – % acquired via airdrops

​
Security & Age

  • securityScore – Token security rating (0–100)
  • tokenAge – Days since token creation

​
Time Frames

Time-based metrics support the following windows:
  • tenMinutes
  • thirtyMinutes
  • oneHour
  • fourHours
  • twelveHours
  • oneDay
  • oneWeek
  • oneMonth
This allows both real-time momentum tracking and longer-term trend analysis.

​
Common Use Cases

{
  "chains": ["eth", "base"],
  "filters": [
    { "metric": "volumeUsd", "timeFrame": "oneDay", "gt": 1000000 },
    { "metric": "buyers", "timeFrame": "oneHour", "gt": 50 },
    { "metric": "usdPricePercentChange", "timeFrame": "oneDay", "gt": 10 }
  ],
  "sortBy": {
    "metric": "volumeUsd",
    "timeFrame": "oneDay",
    "type": "DESC"
  }
}

​
Identify Newly Launched Tokens

{
  "filters": [
    { "metric": "tokenAge", "gt": 1767325000 }, // Unix Timestamp
    { "metric": "marketCap", "gt": 500000 },
    { "metric": "totalHolders", "gt": 100 }
  ],
  "sortBy": {
    "metric": "volumeUsd",
    "timeFrame": "oneDay",
    "type": "DESC"
  }
}

​
Category Filtering

You can include or exclude token categories to fine-tune discovery: 
{
  "categories": {
    "include": ["meme-token", "gaming"],
    "exclude": ["stablecoins", "wrapped-tokens"]
  }
}
Use Token Categories to identify all supported categories.

​
How Filters Work

  • Filters are combined using AND logic
  • All filter conditions must be met
  • Snapshot metrics must not use a timeFrame
  • Time-based metrics require a timeFrame
Example: 
{
  "filters": [
    { "metric": "marketCap", "gt": 1000000, "lt": 100000000 },
    { "metric": "volumeUsd", "timeFrame": "oneDay", "gt": 500000 },
    { "metric": "holders", "timeFrame": "oneWeek", "gt": 1000 },
    { "metric": "securityScore", "gt": 80 }
  ]
}

​
Best Practices

Recommended baseline filters for most use cases:
  • marketCap > $100K
  • totalLiquidityUsd > $500
  • volumeUsd (1d) > $1,000
  • securityScore > 70
Additional tips:
  • Narrow chains to improve result relevance
  • Choose time frames aligned with your UX
  • Sort by the metric that best reflects intent

​
Limits & Constraints

  • Maximum of 100 tokens per request
  • No pagination support
  • Highly restrictive filters may return fewer results
  • Some tokens may lack specific metrics

​
Data Freshness

  • Most metrics update every ~10 seconds
  • Acquisition metrics may lag by up to 5 minutes for highly active tokens
  • Price and volume data are near real-time