Skip to main content
GET
/
v2
/
token
/
{chain}
/
{tokenAddress}
/
stats
Token - Stats
curl --request GET \
  --url https://api.chainstream.io/v2/token/{chain}/{tokenAddress}/stats \
  --header 'Authorization: Bearer <token>'
{
  "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "periods": {
    "24h": {
      "buyVolumeInUsd": "45000.00",
      "buyers": "320",
      "buys": "1520",
      "closeInUsd": "0.15600000",
      "currentLiquidityInUsd": "250000.00",
      "highInUsd": "0.15900000",
      "lowInUsd": "0.15000000",
      "openInUsd": "0.15000000",
      "priceChangeRatioInUsd": "0.04000000",
      "sellVolumeInUsd": "36000.00",
      "sellers": "210",
      "sells": "980",
      "totalVolumeInUsd": "81000.00",
      "traders": "530",
      "trades": "2500"
    }
  }
}
Get aggregated trading statistics for a token including volume, trade count, unique traders, and price changes over various time windows.
Related: GraphQL OHLC & Stats | MCP: token_get_stats

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
chain
enum<string>
required

A chain name listed in supported networks Supported blockchain chains

Available options:
sol,
eth,
bsc
​
tokenAddress
string
required

An address of a token

Response

200 - application/json

Get Stats

Token statistics with nested time period data

​
address
string
required

Token contract address

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

​
periods
object
required

Trade statistics grouped by time period (1m, 5m, 15m, 30m, 1h, 4h, 24h). Each period contains full OHLCV data, trade counts, and previous-period comparisons. See TokenTradeStatPeriod schema for all fields.

Example:
{
  "24h": {
    "buyVolumeInUsd": "45000.00",
    "buyers": "320",
    "buys": "1520",
    "closeInUsd": "0.15600000",
    "currentLiquidityInUsd": "250000.00",
    "highInUsd": "0.15900000",
    "lowInUsd": "0.15000000",
    "openInUsd": "0.15000000",
    "priceChangeRatioInUsd": "0.04000000",
    "sellVolumeInUsd": "36000.00",
    "sellers": "210",
    "sells": "980",
    "totalVolumeInUsd": "81000.00",
    "traders": "530",
    "trades": "2500"
  }
}