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

# FilterTokenWalletsInput

> The input for filtering wallets for a token. FilterTokenWalletsInput input object reference: every field and its type.

## GraphQL

```
input FilterTokenWalletsInput {
  tokenIds: [String]
  wallets: [String]
  networkId: Int
  filtersV2: WalletTokenFiltersV2
  phrase: String
  rankings: [WalletTokenRanking]
  excludeLabels: [String]
  includeLabels: [String]
  includeTradeSourceIds: [String]
  excludeTradeSourceIds: [String]
  limit: Int
  offset: Int
}

input WalletTokenFilterRange {
  min: String
  max: String
}

input WalletTokenFilters {
  lastTransactionAt: WalletTokenFilterRange
  firstTransactionAt: WalletTokenFilterRange
  tokenAmountBought1d: WalletTokenFilterRange
  tokenAmountSold1d: WalletTokenFilterRange
  amountBoughtUsd1d: WalletTokenFilterRange
  amountSoldUsd1d: WalletTokenFilterRange
  realizedProfitUsd1d: WalletTokenFilterRange
  realizedProfitPercentage1d: WalletTokenFilterRange
  avgHoldPeriodSec1d: WalletTokenFilterRange
  buys1d: WalletTokenFilterRange
  sells1d: WalletTokenFilterRange
  tokenAmountBought1w: WalletTokenFilterRange
  tokenAmountSold1w: WalletTokenFilterRange
  amountBoughtUsd1w: WalletTokenFilterRange
  amountSoldUsd1w: WalletTokenFilterRange
  realizedProfitUsd1w: WalletTokenFilterRange
  realizedProfitPercentage1w: WalletTokenFilterRange
  avgHoldPeriodSec1w: WalletTokenFilterRange
  buys1w: WalletTokenFilterRange
  sells1w: WalletTokenFilterRange
  tokenAmountBought30d: WalletTokenFilterRange
  tokenAmountSold30d: WalletTokenFilterRange
  amountBoughtUsd30d: WalletTokenFilterRange
  amountSoldUsd30d: WalletTokenFilterRange
  realizedProfitUsd30d: WalletTokenFilterRange
  realizedProfitPercentage30d: WalletTokenFilterRange
  avgHoldPeriodSec30d: WalletTokenFilterRange
  buys30d: WalletTokenFilterRange
  sells30d: WalletTokenFilterRange
  tokenAmountBought1y: WalletTokenFilterRange
  tokenAmountSold1y: WalletTokenFilterRange
  amountBoughtUsd1y: WalletTokenFilterRange
  amountSoldUsd1y: WalletTokenFilterRange
  realizedProfitUsd1y: WalletTokenFilterRange
  realizedProfitPercentage1y: WalletTokenFilterRange
  avgHoldPeriodSec1y: WalletTokenFilterRange
  buys1y: WalletTokenFilterRange
  sells1y: WalletTokenFilterRange
  tokenBalance: WalletTokenFilterRange
  purchasedTokenBalance: WalletTokenFilterRange
  tokenAcquisitionCostUsd: WalletTokenFilterRange
  scammerScore: WalletTokenFilterRange
  botScore: WalletTokenFilterRange
}

input NumberFilter {
  gte: Float
  gt: Float
  lte: Float
  lt: Float
}

input WalletTokenFiltersV2 {
  lastTransactionAt: NumberFilter
  firstTransactionAt: NumberFilter
  tokenAmountBought1d: NumberFilter
  tokenAmountSold1d: NumberFilter
  amountBoughtUsd1d: NumberFilter
  amountSoldUsd1d: NumberFilter
  realizedProfitUsd1d: NumberFilter
  realizedProfitPercentage1d: NumberFilter
  avgHoldPeriodSec1d: NumberFilter
  buys1d: NumberFilter
  sells1d: NumberFilter
  trades1d: NumberFilter
  tokenAmountBought1w: NumberFilter
  tokenAmountSold1w: NumberFilter
  amountBoughtUsd1w: NumberFilter
  amountSoldUsd1w: NumberFilter
  realizedProfitUsd1w: NumberFilter
  realizedProfitPercentage1w: NumberFilter
  avgHoldPeriodSec1w: NumberFilter
  buys1w: NumberFilter
  sells1w: NumberFilter
  trades1w: NumberFilter
  tokenAmountBought30d: NumberFilter
  tokenAmountSold30d: NumberFilter
  amountBoughtUsd30d: NumberFilter
  amountSoldUsd30d: NumberFilter
  realizedProfitUsd30d: NumberFilter
  realizedProfitPercentage30d: NumberFilter
  avgHoldPeriodSec30d: NumberFilter
  buys30d: NumberFilter
  sells30d: NumberFilter
  trades30d: NumberFilter
  tokenAmountBought1y: NumberFilter
  tokenAmountSold1y: NumberFilter
  amountBoughtUsd1y: NumberFilter
  amountSoldUsd1y: NumberFilter
  realizedProfitUsd1y: NumberFilter
  realizedProfitPercentage1y: NumberFilter
  avgHoldPeriodSec1y: NumberFilter
  buys1y: NumberFilter
  sells1y: NumberFilter
  trades1y: NumberFilter
  tokenBalance: NumberFilter
  purchasedTokenBalance: NumberFilter
  tokenAcquisitionCostUsd: NumberFilter
  scammerScore: NumberFilter
  botScore: NumberFilter
}

enum WalletTokenRankingAttribute {
  firstTransactionAt
  lastTransactionAt
  tokenAmountBought1d
  tokenAmountSold1d
  amountBoughtUsd1d
  amountSoldUsd1d
  realizedProfitUsd1d
  realizedProfitPercentage1d
  avgHoldPeriodSec1d
  buys1d
  sells1d
  tokenAmountBought1w
  tokenAmountSold1w
  amountBoughtUsd1w
  amountSoldUsd1w
  realizedProfitUsd1w
  realizedProfitPercentage1w
  avgHoldPeriodSec1w
  buys1w
  sells1w
  tokenAmountBought30d
  tokenAmountSold30d
  amountBoughtUsd30d
  amountSoldUsd30d
  realizedProfitUsd30d
  realizedProfitPercentage30d
  avgHoldPeriodSec30d
  buys30d
  sells30d
  tokenAmountBought1y
  tokenAmountSold1y
  amountBoughtUsd1y
  amountSoldUsd1y
  realizedProfitUsd1y
  realizedProfitPercentage1y
  avgHoldPeriodSec1y
  buys1y
  sells1y
  tokenBalance
  purchasedTokenBalance
  tokenAcquisitionCostUsd
  scammerScore
  botScore
}

enum RankingDirection {
  ASC
  DESC
}

input WalletTokenRanking {
  attribute: WalletTokenRankingAttribute!
  direction: RankingDirection!
}
```

### Used By

**Used as input by**

* [filterTokenWallets](https://docs.codex.io/api-reference/queries/filtertokenwallets.md): Returns a list of wallets with stats narrowed down to a specific token.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.