> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
> Use this file to discover all available pages before exploring further.

# filterTokenWallets

> Search, filter, and rank wallets that have traded a specific token (or set of tokens) by per-token activity such as buys, sells, realized profit, and balances.

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

<ResponseField name="filterTokenWallets" type="TokenWalletFilterConnection!">
  See [TokenWalletFilterConnection](/api-reference/graphql/types/TokenWalletFilterConnection) and [TokenWalletFilterResult](/api-reference/graphql/types/TokenWalletFilterResult) for full type details.
</ResponseField>

### Arguments

<ResponseField name="input" type="FilterTokenWalletsInput!">
  See [FilterTokenWalletsInput](/api-reference/graphql/types/FilterTokenWalletsInput) for full details.
</ResponseField>

### Example

```graphql theme={null}
{
  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

<iframe src={`https://graphql.mobula.io/graphql?query=${encodeURIComponent('{ filterTokenWallets(input: { tokenIds: ["0x6982508145454ce325ddbe47a25d4ec3d2311933:1"], filtersV2: { realizedProfitUsd30d: { gte: 10000 } }, rankings: [{ attribute: realizedProfitUsd30d, direction: DESC }], limit: 5 }) { results { address tokenAddress networkId labels realizedProfitUsd30d realizedProfitPercentage30d buys30d sells30d tokenBalance token { name symbol } } count offset } }')}`} title="GraphQL Playground" style={{ width: '100%', minHeight: '600px', border: '1px solid var(--color-border)', borderRadius: '8px' }} />