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

<div data-generated>
  ## 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](/api-reference/queries/tokentoptraders.md): Returns a list of top traders for a given token.
</div>


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