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

# tokenTopTraders

> Fetch top traders for a token by trading period (DAY, WEEK, MONTH, YEAR): volume, buys/sells, PnL, balance.

### Returns

<ResponseField name="tokenTopTraders" type="TokenTopTradersConnection!">
  Connection with token context and paginated list of top traders. See [TokenTopTradersConnection](/api-reference/graphql/types/TokenTopTradersConnection).
</ResponseField>

### Arguments

<ResponseField name="input" type="TokenTopTradersInput!" required>
  Token, network, period, and optional pagination. See [TokenTopTradersInput](/api-reference/graphql/types/TokenTopTradersInput).
</ResponseField>

### Example

```graphql theme={null}
query TokenTopTraders {
  tokenTopTraders(input: {
    tokenAddress: "9SeCSdbPzz95KomGUGEV9Shn2zGXNmMJhE9J72Hipump",
    networkId: 1399811149,
    tradingPeriod: DAY,
    limit: 20,
    offset: 0
  }) {
    tokenAddress
    networkId
    tradingPeriod
    offset
    items {
      walletAddress
      volumeUsd
      tokenAmountBought
      tokenAmountSold
      realizedProfitUsd
      tokenBalance
      buys
      sells
    }
  }
}
```

### Playground

<iframe src={`https://graphql.mobula.io/graphql?query=${encodeURIComponent('query TokenTopTraders($input: TokenTopTradersInput!) { tokenTopTraders(input: $input) { tokenAddress networkId tradingPeriod offset items { walletAddress volumeUsd tokenAmountBought tokenAmountSold realizedProfitUsd tokenBalance buys sells } } }')}&variables=${encodeURIComponent('{"input": {"tokenAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7", "networkId": 1, "tradingPeriod": "DAY", "limit": 20, "offset": 0}}')}`} title="GraphQL Playground" style={{ width: '100%', minHeight: '600px', border: '1px solid var(--color-border)', borderRadius: '8px' }} />