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

# TokenTopTradersConnection

> A paginated list of top traders for a token. TokenTopTradersConnection type reference: every field and its type.

## GraphQL

```
type TokenTopTradersConnection {
  tokenAddress: String!
  networkId: Int!
  tradingPeriod: TradingPeriod!
  items: [TokenTopTrader]!
  offset: Int
}

enum TradingPeriod {
  DAY
  WEEK
  MONTH
  YEAR
}

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 TokenTopTrader {
  walletAddress: String!
  tokenAddress: String!
  networkId: Int!
  tokenAmountBought: String!
  tokenAmountSold: String!
  amountBoughtUsd: String!
  amountSoldUsd: String!
  volumeUsd: String!
  realizedProfitUsd: String!
  realizedProfitPercentage: Float!
  singleTokenAcquisitionCostUsd: String!
  buys: Int!
  sells: Int!
  tokenBalance: String!
  firstTransactionAt: Int
  lastTransactionAt: Int!
  labels: [String!]!
  scammerScore: Int
  botScore: Int
  wallet: Wallet
}
```

### Used By

**Returned by**

* [tokenTopTraders](https://docs.codex.io/api-reference/queries/tokentoptraders.md): Returns a list of top traders for a given token.


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