Skip to main content
GET
/
v1
/
token
/
{chain}
/
{tokenAddress}
/
stats
Token - Stats
curl --request GET \
  --url https://api.chainstream.io/v1/token/{chain}/{tokenAddress}/stats \
  --header 'Authorization: Bearer <token>'
{
  "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "periods": {
    "1h": {
      "buys": "1520",
      "sells": "980",
      "trades": "2500",
      "buyers": "320",
      "sellers": "210",
      "traders": "530",
      "buyVolume": "15000000.12345678",
      "buyVolumeInUsd": "45000.00",
      "buyVolumeInNative": "750.50",
      "sellVolume": "12000000.98765432",
      "sellVolumeInUsd": "36000.00",
      "sellVolumeInNative": "600.40",
      "totalVolumeInUsd": "81000.00",
      "totalVolumeInNative": "1350.90",
      "openInUsd": "0.15000000",
      "closeInUsd": "0.15600000",
      "highInUsd": "0.15900000",
      "lowInUsd": "0.15000000",
      "openInNative": "0.00005000",
      "closeInNative": "0.00005200",
      "highInNative": "0.00005300",
      "lowInNative": "0.00005000",
      "averagePriceInUsd": "0.15300000",
      "averagePriceInNative": "0.00005100",
      "priceChangeRatioInUsd": "0.04000000",
      "prevBuys": "1400",
      "prevSells": "900",
      "prevTrades": "2300",
      "prevBuyers": "300",
      "prevSellers": "200",
      "prevBuyVolume": "14000000.00",
      "prevSellVolume": "11000000.00",
      "prevBuyVolumeInUsd": "42000.00",
      "prevSellVolumeInUsd": "33000.00",
      "prevBuyVolumeInNative": "700.00",
      "prevSellVolumeInNative": "550.00",
      "prevOpenInUsd": "0.14800000",
      "prevCloseInUsd": "0.15100000",
      "prevHighInUsd": "0.15200000",
      "prevLowInUsd": "0.14500000",
      "prevOpenInNative": "0.00004900",
      "prevCloseInNative": "0.00005100",
      "prevHighInNative": "0.00005100",
      "prevLowInNative": "0.00004800",
      "dappProgramCount": "8",
      "prevDappProgramCount": "7",
      "poolCount": "12",
      "prevPoolCount": "10",
      "currentLiquidityInUsd": "250000.00",
      "prevLiquidityInUsd": "240000.00",
      "volumeChangeRatio": "0.08",
      "liquidityChangeRatio": "0.0417",
      "buySellRatio": "1.5510",
      "updatedAt": "2026-02-09T08:05:12.345Z"
    }
  }
}

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

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

An address of a token

Example:

"6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"

Response

200 - application/json
​
address
string
required

Token contract address

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

​
periods
object
required

Trade statistics grouped by time period

Example:
{
  "1h": {
    "buys": "1520",
    "sells": "980",
    "trades": "2500",
    "buyers": "320",
    "sellers": "210",
    "traders": "530",
    "buyVolume": "15000000.12345678",
    "buyVolumeInUsd": "45000.00",
    "buyVolumeInNative": "750.50",
    "sellVolume": "12000000.98765432",
    "sellVolumeInUsd": "36000.00",
    "sellVolumeInNative": "600.40",
    "totalVolumeInUsd": "81000.00",
    "totalVolumeInNative": "1350.90",
    "openInUsd": "0.15000000",
    "closeInUsd": "0.15600000",
    "highInUsd": "0.15900000",
    "lowInUsd": "0.15000000",
    "openInNative": "0.00005000",
    "closeInNative": "0.00005200",
    "highInNative": "0.00005300",
    "lowInNative": "0.00005000",
    "averagePriceInUsd": "0.15300000",
    "averagePriceInNative": "0.00005100",
    "priceChangeRatioInUsd": "0.04000000",
    "prevBuys": "1400",
    "prevSells": "900",
    "prevTrades": "2300",
    "prevBuyers": "300",
    "prevSellers": "200",
    "prevBuyVolume": "14000000.00",
    "prevSellVolume": "11000000.00",
    "prevBuyVolumeInUsd": "42000.00",
    "prevSellVolumeInUsd": "33000.00",
    "prevBuyVolumeInNative": "700.00",
    "prevSellVolumeInNative": "550.00",
    "prevOpenInUsd": "0.14800000",
    "prevCloseInUsd": "0.15100000",
    "prevHighInUsd": "0.15200000",
    "prevLowInUsd": "0.14500000",
    "prevOpenInNative": "0.00004900",
    "prevCloseInNative": "0.00005100",
    "prevHighInNative": "0.00005100",
    "prevLowInNative": "0.00004800",
    "dappProgramCount": "8",
    "prevDappProgramCount": "7",
    "poolCount": "12",
    "prevPoolCount": "10",
    "currentLiquidityInUsd": "250000.00",
    "prevLiquidityInUsd": "240000.00",
    "volumeChangeRatio": "0.08",
    "liquidityChangeRatio": "0.0417",
    "buySellRatio": "1.5510",
    "updatedAt": "2026-02-09T08:05:12.345Z"
  }
}