Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.codex.io/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint requires a Growth or Enterprise plan. Learn more.

​
Returns

​
WalletFilterConnection
WalletFilterConnection!
See WalletFilterConnection

​
Arguments

​
input
FilterWalletsInput!
required
See FilterWalletsInput

​
Example

Test this query in the Explorer → 
{
  filterWallets(
    input: {
      filters: {
        networkId: 1399811149
        realizedProfitUsd1w: { gte: 10000 }
        winRate1w: { gte: 30 }
        swaps1w: { gte: 100 }
      }
      rankings: [{ attribute: realizedProfitUsd1w, direction: DESC }]
      limit: 10
    }
  ) {
    results {
      address
      labels
      lastTransactionAt
      firstTransactionAt
      volumeUsd1w
      realizedProfitUsd1w
      realizedProfitPercentage1w
      winRate1w
      swaps1w
      uniqueTokens1w
    }
    count
    offset
  }
}

​
Usage Guidelines

  • Use filters to narrow results by metrics like realizedProfitUsd, winRate, volumeUsd, swaps, etc. — available for multiple time periods: 1d, 1w, 30d, 1y
  • Filters use NumberFilter with gte, gt, lte, lt operators for range queries
  • Use rankings to sort results by any metric — specify attribute and direction (ASC or DESC)
  • Filter by networkId to scope results to a specific chain (e.g., 1399811149 for Solana)
  • Use includeLabels or excludeLabels to filter by wallet classifications like SMART_TRADER_TOKENS_OVER_TWO_DAYS_OLD, WEALTHY, SNIPER
  • Use limit and offset for pagination — the response includes count to help with page navigation
  • Pass a list of wallets to filter results to specific wallet addresses

​
Troubleshooting Tips

Use filterWallets when you want to discover wallets based on their overall trading performance across all tokens — great for finding top traders on a network. Use filterTokenWallets when you want to find wallets that have traded a specific token and see their stats for that token only.
All metrics are available across four time periods: 1d (24 hours), 1w (7 days), 30d (30 days), and 1y (1 year). Append the period to the metric name, e.g., realizedProfitUsd1w, winRate30d, volumeUsd1y.
Labels classify wallet behavior: SMART_TRADER_TOKENS_OVER_TWO_DAYS_OLD indicates 7.5K+profitonestablishedtokens,‘SNIPER‘indicates7.5K+ profit on established tokens, `SNIPER` indicates 3K+ profit on tokens launched within 1 hour, WEALTHY/MEGA_WEALTHY indicate high asset holdings (1M+/1M+/10M+). Use excludeLabels to filter out bots or known patterns.
winRate is a percentage (0–100) representing the portion of profitable trades. A winRate1w of 52 means 52% of trades in the last week were profitable. Use filters like winRate1w: { gte: 50 } to find wallets with above-average win rates.
volumeUsd only counts volume from tokens where we have a reliable USD price. volumeUsdAll includes volume from all tokens, even those without reliable pricing. Use volumeUsd for more conservative figures.
  • Wallets: Analyze wallet performance, discover top traders, and build portfolio views