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

# filterNetworkWallets

> Returns a list of wallets with stats narrowed down to a specific network. filterNetworkWallets query reference: arguments and response fields.

## GraphQL

```
type Query {
  # Requires a Growth or Enterprise plan.
  filterNetworkWallets(
    input: FilterNetworkWalletsInput!
  ): NetworkWalletFilterConnection!
}

enum WalletAggregateBackfillState {
  BackfillComplete
  BackfillInProgress
  BackfillCanceled
  BackfillBlocked
  BackfillRequestReceived
  BackfillNotFound
}

enum WalletCategory {
  NORMIE
  TOKEN_CREATOR
  EXCHANGE
  DEFI_EXCHANGE
  PAIR
  PAIR_TOKEN_HOLDER
  POOL_AUTHORITY
  STAKING_VAULT
  NOTORIOUS
  BURN
  LOCKER
}

type WalletFunding {
  fundedByAddress: String!
  fundedByLabel: String
  fundedAt: Int!
  tokenAddress: String!
  networkId: Int!
  amount: String!
  transactionHash: String!
}

type WalletPolymarketProfile {
  proxyWallet: String!
  xUsername: String
  displayName: String
  pseudonym: String
  profileImageUrl: String
  verifiedBadge: Boolean
  displayUsernamePublic: Boolean
  fetchedAt: Int!
}

type Wallet {
  address: String!
  category: WalletCategory
  firstSeenTimestamp: Int
  firstFunding: WalletFunding
  identityLabels: [String!]
  avatarUrl: String
  displayName: String
  twitterId: String
  twitterUsername: String
  telegramId: String
  telegramUsername: String
  website: String
  discordId: String
  discordUsername: String
  githubId: String
  githubUsername: String
  farcasterId: String
  farcasterUsername: String
  description: String
  ethosScore: Int
  ethosLevel: String
  ethosVerified: Boolean
  tradeSourceIds: [String!]
  identitySource: String
  identityUpdatedAt: Int
  polymarket: WalletPolymarketProfile
  tokensCreatedCount: Int
  tokensMigratedCount: Int
}

type NetworkWalletFilterResult {
  address: String!
  networkId: Int!
  firstTransactionAt: Int
  lastTransactionAt: Int!
  nativeTokenBalance: String!
  labels: [String!]!
  identityLabels: [String!]
  tradeSourceIds: [String!]
  volumeUsd1d: String!
  volumeUsdAll1d: String!
  realizedProfitUsd1d: String!
  realizedProfitUsdExNative1d: String
  averageProfitUsdPerTrade1d: String!
  averageSwapAmountUsd1d: String!
  realizedProfitPercentage1d: Float!
  realizedProfitPercentageExNative1d: Float
  avgHoldPeriodSec1d: Float
  swaps1d: Int!
  swapsAll1d: Int!
  uniqueTokens1d: Int!
  winRate1d: Float!
  volumeUsd1w: String!
  volumeUsdAll1w: String!
  realizedProfitUsd1w: String!
  realizedProfitUsdExNative1w: String
  averageProfitUsdPerTrade1w: String!
  averageSwapAmountUsd1w: String!
  realizedProfitPercentage1w: Float!
  realizedProfitPercentageExNative1w: Float
  avgHoldPeriodSec1w: Float
  swaps1w: Int!
  swapsAll1w: Int!
  uniqueTokens1w: Int!
  winRate1w: Float!
  volumeUsd30d: String!
  volumeUsdAll30d: String!
  realizedProfitUsd30d: String!
  realizedProfitUsdExNative30d: String
  averageProfitUsdPerTrade30d: String!
  averageSwapAmountUsd30d: String!
  realizedProfitPercentage30d: Float!
  realizedProfitPercentageExNative30d: Float
  avgHoldPeriodSec30d: Float
  swaps30d: Int!
  swapsAll30d: Int!
  uniqueTokens30d: Int!
  winRate30d: Float!
  volumeUsd1y: String!
  volumeUsdAll1y: String!
  realizedProfitUsd1y: String!
  averageProfitUsdPerTrade1y: String!
  averageSwapAmountUsd1y: String!
  realizedProfitPercentage1y: Float!
  avgHoldPeriodSec1y: Float
  swaps1y: Int!
  swapsAll1y: Int!
  winRate1y: Float!
  scammerScore: Int
  botScore: Int
  backfillState: WalletAggregateBackfillState
  wallet: Wallet
}

type NetworkWalletFilterConnection {
  results: [NetworkWalletFilterResult!]!
  count: Int!
  offset: Int!
}

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

input WalletNetworkFilters {
  lastTransactionAt: NumberFilter
  firstTransactionAt: NumberFilter
  volumeUsd1d: NumberFilter
  volumeUsdAll1d: NumberFilter
  realizedProfitUsd1d: NumberFilter
  realizedProfitUsdExNative1d: NumberFilter
  averageProfitUsdPerTrade1d: NumberFilter
  averageSwapAmountUsd1d: NumberFilter
  realizedProfitPercentage1d: NumberFilter
  realizedProfitPercentageExNative1d: NumberFilter
  avgHoldPeriodSec1d: NumberFilter
  swaps1d: NumberFilter
  swapsAll1d: NumberFilter
  uniqueTokens1d: NumberFilter
  winRate1d: NumberFilter
  volumeUsd1w: NumberFilter
  volumeUsdAll1w: NumberFilter
  realizedProfitUsd1w: NumberFilter
  realizedProfitUsdExNative1w: NumberFilter
  averageProfitUsdPerTrade1w: NumberFilter
  averageSwapAmountUsd1w: NumberFilter
  realizedProfitPercentage1w: NumberFilter
  realizedProfitPercentageExNative1w: NumberFilter
  avgHoldPeriodSec1w: NumberFilter
  swaps1w: NumberFilter
  swapsAll1w: NumberFilter
  uniqueTokens1w: NumberFilter
  winRate1w: NumberFilter
  volumeUsd30d: NumberFilter
  volumeUsdAll30d: NumberFilter
  realizedProfitUsd30d: NumberFilter
  realizedProfitUsdExNative30d: NumberFilter
  averageProfitUsdPerTrade30d: NumberFilter
  averageSwapAmountUsd30d: NumberFilter
  realizedProfitPercentage30d: NumberFilter
  realizedProfitPercentageExNative30d: NumberFilter
  avgHoldPeriodSec30d: NumberFilter
  swaps30d: NumberFilter
  swapsAll30d: NumberFilter
  uniqueTokens30d: NumberFilter
  winRate30d: NumberFilter
  volumeUsd1y: NumberFilter
  volumeUsdAll1y: NumberFilter
  realizedProfitUsd1y: NumberFilter
  averageProfitUsdPerTrade1y: NumberFilter
  averageSwapAmountUsd1y: NumberFilter
  realizedProfitPercentage1y: NumberFilter
  avgHoldPeriodSec1y: NumberFilter
  swaps1y: NumberFilter
  swapsAll1y: NumberFilter
  winRate1y: NumberFilter
  nativeTokenBalance: NumberFilter
  scammerScore: NumberFilter
  botScore: NumberFilter
  ethosScore: NumberFilter
  hasTwitter: Boolean
  hasDiscord: Boolean
  hasTelegram: Boolean
  hasFarcaster: Boolean
  hasGithub: Boolean
  hasDisplayName: Boolean
  hasSocials: Boolean
}

enum WalletNetworkRankingAttribute {
  firstTransactionAt
  lastTransactionAt
  volumeUsd1d
  volumeUsdAll1d
  realizedProfitUsd1d
  realizedProfitUsdExNative1d
  averageProfitUsdPerTrade1d
  averageSwapAmountUsd1d
  realizedProfitPercentage1d
  realizedProfitPercentageExNative1d
  avgHoldPeriodSec1d
  swaps1d
  swapsAll1d
  uniqueTokens1d
  winRate1d
  volumeUsd1w
  volumeUsdAll1w
  realizedProfitUsd1w
  realizedProfitUsdExNative1w
  averageProfitUsdPerTrade1w
  averageSwapAmountUsd1w
  realizedProfitPercentage1w
  realizedProfitPercentageExNative1w
  avgHoldPeriodSec1w
  swaps1w
  swapsAll1w
  uniqueTokens1w
  winRate1w
  volumeUsd30d
  volumeUsdAll30d
  realizedProfitUsd30d
  realizedProfitUsdExNative30d
  averageProfitUsdPerTrade30d
  averageSwapAmountUsd30d
  realizedProfitPercentage30d
  realizedProfitPercentageExNative30d
  avgHoldPeriodSec30d
  swaps30d
  swapsAll30d
  uniqueTokens30d
  winRate30d
  volumeUsd1y
  volumeUsdAll1y
  realizedProfitUsd1y
  averageProfitUsdPerTrade1y
  averageSwapAmountUsd1y
  realizedProfitPercentage1y
  avgHoldPeriodSec1y
  swaps1y
  swapsAll1y
  winRate1y
  nativeTokenBalance
  scammerScore
  botScore
  ethosScore
}

enum RankingDirection {
  ASC
  DESC
}

input WalletNetworkRanking {
  attribute: WalletNetworkRankingAttribute
  direction: RankingDirection
}

input FilterNetworkWalletsInput {
  networkId: Int!
  filters: WalletNetworkFilters
  wallets: [String]
  excludeLabels: [String]
  includeLabels: [String]
  rankings: [WalletNetworkRanking]
  limit: Int
  offset: Int
}
```

### Example

[Test this query in the Explorer →](https://docs.codex.io/explore.md)

```graphql theme={null}
{
  filterNetworkWallets(
    input: {
      networkId: 1399811149
      filters: {volumeUsd1d: {gt: 10000}}
      rankings: [{attribute: realizedProfitUsd1d, direction: DESC}]
      limit: 10
    }
  ) {
    results {
      address
      networkId
      nativeTokenBalance
      volumeUsd1d
      realizedProfitUsd1d
      swaps1d
      winRate1d
      lastTransactionAt
    }
    count
  }
}
```


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