Skip to main content

​
Overview

Query wallets that have interacted with one or more tokens, with powerful filtering, ranking, and pagination on per-token activity. Ideal for building top-trader lists, holder PnL leaderboards, and smart-money detection for a token.
  • Filter by per-token buys, sells, volume, realized profit, and balances
  • Filter by windowed stats: 1d, 1w, 30d, 1y
  • Scope by tokenIds, specific wallets, or a networkId
  • Include / exclude wallets by label (e.g. insider, sniper, bot)
  • Sort by any supported attribute; paginate with limit / offset
  • Free-text search on wallet addresses / identity via phrase

​
Returns

​
filterTokenWallets
TokenWalletFilterConnection!
See TokenWalletFilterConnection and TokenWalletFilterResult for full type details.

​
Arguments

​
input
FilterTokenWalletsInput!
See FilterTokenWalletsInput for full details.

​
Example

{
  filterTokenWallets(input: {
    tokenIds: ["0x6982508145454ce325ddbe47a25d4ec3d2311933:1"]
    filtersV2: {
      realizedProfitUsd30d: { gte: 10000 }
      buys30d: { gte: 3 }
    }
    rankings: [{ attribute: realizedProfitUsd30d, direction: DESC }]
    excludeLabels: ["bot"]
    limit: 10
  }) {
    results {
      address
      tokenAddress
      networkId
      labels
      realizedProfitUsd30d
      realizedProfitPercentage30d
      buys30d
      sells30d
      tokenBalance
      tokenBalanceLiveUsd
      token { name symbol address networkId }
    }
    count
    offset
  }
}

​
Playground