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": {
    "6h": {
      "buyVolumeInUsd": "12000.00",
      "buyers": "120",
      "buys": "420",
      "closeInUsd": "0.15600000",
      "currentLiquidityInUsd": "250000.00",
      "highInUsd": "0.15900000",
      "lowInUsd": "0.15100000",
      "openInUsd": "0.15200000",
      "priceChangeRatioInUsd": "0.02631579",
      "sellVolumeInUsd": "9800.00",
      "sellers": "95",
      "sells": "360",
      "totalVolumeInUsd": "21800.00",
      "traders": "215",
      "trades": "780"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt

Use this file to discover all available pages before exploring further.

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, 6h, 24h). Each period contains full OHLCV data, trade counts, and previous-period comparisons. See TokenTradeStatPeriod schema for all fields.

Example:
{
  "6h": {
    "buyVolumeInUsd": "12000.00",
    "buyers": "120",
    "buys": "420",
    "closeInUsd": "0.15600000",
    "currentLiquidityInUsd": "250000.00",
    "highInUsd": "0.15900000",
    "lowInUsd": "0.15100000",
    "openInUsd": "0.15200000",
    "priceChangeRatioInUsd": "0.02631579",
    "sellVolumeInUsd": "9800.00",
    "sellers": "95",
    "sells": "360",
    "totalVolumeInUsd": "21800.00",
    "traders": "215",
    "trades": "780"
  }
}