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.

​
Returns

​
Arguments

filterTokenWallets vs holders: Use filterTokenWallets when you need trading performance data (profit, buy/sell counts, volume, etc.). These records are only updated on swaps, so they focus on trader activity. If a wallet received tokens through a transfer rather than a swap, it will not appear here.Use holders when you want the most accurate, up-to-date holder list and balances. holders records are updated on every token transfer.

​
Usage Guidelines

  • Query using tokenIds array with token IDs in address:networkId format
  • Use rankings to sort results by any stat attribute (e.g., realizedProfitUsd30d, tokenBalance)
  • Stats are available in multiple time windows: 1d, 1w, 30d, 1y
  • Use filtersV2 to filter wallets by numeric ranges (e.g., minimum profit, minimum buys)
  • tokenBalance is the last known balance; use tokenBalanceLive for real-time balance
  • Use includeLabels and excludeLabels to filter by wallet labels (e.g., smart money, bots)
  • Maximum of 50 token IDs per query; multiple tokens require at least one wallet address

​
Troubleshooting Tips

Use filterTokenWallets when you want to find wallets that have traded a specific token and see their stats for that token only — great for finding top holders or profitable traders of a particular token. Use filterWallets when you want to discover wallets based on their overall trading performance across all tokens.
tokenBalance is updated periodically and may be slightly stale. tokenBalanceLive is updated with every transfer and reflects the current balance. Use tokenBalanceLive when accuracy is critical.
tokenBalance includes all tokens held, including those received via transfers. purchasedTokenBalance only includes tokens acquired through tracked buys/sells on supported DEXs, excluding airdrops and transfers.
Only wallets that have traded the token on tracked DEXs are included. Wallets that received tokens via transfer only (airdrops, direct sends) may not appear.
botScore estimates likelihood the wallet is automated (0-100, higher = more likely bot). scammerScore estimates likelihood of fraudulent activity. Use these to filter out suspicious wallets.
Use rankings: [{ attribute: realizedProfitUsd30d, direction: DESC }] to sort by profit. Combine with filtersV2 to set minimum thresholds like realizedProfitUsd30d: { gte: 1000 }.
  • Wallets: Analyze wallet performance, discover top traders, and build portfolio views