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

# getDetailedTokenStats

> Get windowed stats (volume, OHLC, trades, traders) aggregated across all pairs for a single token.

### Returns

<ResponseField name="getDetailedTokenStats" type="DetailedTokenStats">
  Per-window stats for the token. See [DetailedTokenStats](/api-reference/graphql/types/DetailedTokenStats).
</ResponseField>

### Arguments

<ResponseField name="tokenAddress" type="String!" required>
  Token contract address.
</ResponseField>

<ResponseField name="networkId" type="Int!" required>
  Network ID (e.g. `1`, `56`).
</ResponseField>

<ResponseField name="timestamp" type="Int">
  Optional timestamp for historical stats.
</ResponseField>

<ResponseField name="durations" type="[DetailedTokenStatsDuration]">
  Which time windows to return. See [DetailedTokenStatsDuration](/api-reference/graphql/types/DetailedTokenStatsDuration).
</ResponseField>

<ResponseField name="bucketCount" type="Int">
  Number of buckets per window.
</ResponseField>

<ResponseField name="statsType" type="TokenPairStatisticsType">
  FILTERED or UNFILTERED. See [TokenPairStatisticsType](/api-reference/graphql/types/TokenPairStatisticsType).
</ResponseField>

### Example

```graphql theme={null}
{
  getDetailedTokenStats(
    tokenAddress: "0xdac17f958d2ee523a2206206994597c13d831ec7"
    networkId: 1
    durations: [hour1, day1]
  ) {
    tokenId
    tokenAddress
    networkId
    lastTransactionAt
    statsType
    stats_hour1 {
      statsUsd {
        volume { currentValue previousValue change }
        buyVolume { currentValue previousValue change }
        sellVolume { currentValue previousValue change }
      }
      statsNonCurrency {
        transactions { currentValue previousValue change }
        buyers { currentValue previousValue change }
        sellers { currentValue previousValue change }
      }
    }
  }
}
```

### Playground

<iframe src={`https://graphql.mobula.io/graphql?query=${encodeURIComponent('{ getDetailedTokenStats(tokenAddress: "0xdac17f958d2ee523a2206206994597c13d831ec7", networkId: 1, durations: [hour1, day1]) { tokenId tokenAddress networkId lastTransactionAt statsType stats_hour1 { statsUsd { volume { currentValue previousValue change } buyVolume { currentValue previousValue change } sellVolume { currentValue previousValue change } } statsNonCurrency { transactions { currentValue previousValue change } buyers { currentValue previousValue change } sellers { currentValue previousValue change } } } } }')}`} title="GraphQL Playground" style={{ width: '100%', minHeight: '600px', border: '1px solid var(--color-border)', borderRadius: '8px' }} />