Skip to main content

​
Returns

​
DetailedTokenStats
See DetailedTokenStats

​
Arguments

​
String!
required
The contract address of the token.
​
Int!
required
The network ID the token is deployed on.
​
Int
The unix timestamp for the stats. Defaults to current.
​
[DetailedTokenStatsDuration]
The list of durations to get detailed token stats for. Supported durations are day1, hour12, hour4, hour1, and min5; other values are ignored and have no corresponding field on DetailedTokenStats. See DetailedTokenStatsDuration
​
Int
The number of aggregated values to receive. Note: Each duration has predetermined bucket sizes. The first n-1 buckets are historical. The last bucket is a snapshot of current data. duration day1: 6 buckets (4 hours each) plus 1 partial bucket duration hour12: 12 buckets (1 hour each) plus 1 partial bucket duration hour4: 8 buckets (30 min each) plus 1 partial bucket duration hour1: 12 buckets (5 min each) plus 1 partial bucket duration min5: 5 buckets (1 min each) plus 1 partial bucket For example, requesting 11 buckets for a min5 duration will return the last 10 minutes worth of data plus a snapshot for the current minute.
​
TokenPairStatisticsType
The type of statistics returned. Can be FILTERED or UNFILTERED. Default is UNFILTERED. See TokenPairStatisticsType

​
Example

Test this query in the Explorer →

​
Usage Guidelines

  • Query using tokenAddress and networkId — this aggregates stats across all pairs for the token
  • Use durations array to request specific time windows: min5, hour1, hour4, hour12, day1. Note that min15, week1, and day30 are not supported for token-level stats — the response has no stats_min15, stats_week1, or stats_day30 fields
  • Stats are returned in separate fields like stats_hour1, stats_day1, etc. based on requested durations
  • statsUsd contains USD-denominated metrics: volume, buyVolume, sellVolume, open, highest, lowest, close, liquidity
  • statsNonCurrency contains count metrics: transactions, buys, sells, traders, buyers, sellers
  • Each metric includes currentValue, previousValue, and change (percent change in decimal format, e.g. -0.52 = -52%)
  • Use buckets array within each metric for granular time-series data within the duration window
  • Use timestamps array to map bucket indices to their corresponding time ranges

​
Troubleshooting Tips

getDetailedTokenStats aggregates stats across all pairs for a given token, giving you a holistic view of the token’s activity. getDetailedPairStats returns stats for a specific pair, which is useful when you care about a token’s activity within a single liquidity pool.
FILTERED stats exclude suspected bot and MEV activity to show organic trading. UNFILTERED (the default) includes all transactions. Use the statsType parameter to choose which type you want.
Each metric includes a buckets array with values for sub-intervals within the duration. For example, stats_hour1 might contain 12 buckets of 5 minutes each. Use the timestamps array at the same level to map each bucket index to its start/end time range, which gives you the x-axis for your chart.
The change field requires both currentValue and previousValue to calculate. For very new tokens or time windows with no previous data, change may be null.
Use the timestamp parameter to query stats as of a specific point in time. By default, stats are returned for the current time.
The bucketCount parameter controls how many sub-intervals the duration is divided into. For example, requesting stats_hour1 with bucketCount: 12 gives you twelve 5-minute buckets. This affects the length of the buckets array within each metric.
Last modified on September 1, 2026