Fetch token price stats

Get tokens price stats like volume, high and low, price and volume change.

POST /api/v1/developer/prices/stats

Token Stats

cURL

curl --request POST \
  --url https://api.allium.so/api/v1/developer/prices/stats \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
[
  {
    "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "chain": "ethereum"
  },
  {
    "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "chain": "solana"
  }
]
'

200

{
  "items": [
    {
      "mint": "<string>",
      "chain": "<string>",
      "timestamp": "2023-11-07T05:31:56Z",
      "latest_price": 123,
      "low_24h": 123,
      "high_24h": 123,
      "low_1h": 123,
      "high_1h": 123,
      "percent_change_24h": 123,
      "percent_change_1h": 123,
      "decimals": 123
    }
  ],
  "cursor": "<string>",
  "message": "<string>"
}

This endpoint returns token price statistics based on on-chain activity. These stats are calculated from our on-chain DEX-based prices.

Available Stats

Stat	Time Window
High/Low	24h, 1h
% Price Change	24h, 1h

Important Notes

• Price high/low and price changes are calculated from filtered prices to avoid outlying trades producing inaccurate values

Pagination

This endpoint returns prices for up to 200 tokens in a single request.

Supported Chains

Authorizations

X-API-KEY · string · header · required

Body

application/json

Required array length: 1 - 200 elements

token_address · string · required

Token contract address

chain · string · required

Lowercase chain name

Response

200

application/json

Successful Response

items · TokenStatsWithHiddenFields · object[] · required

Response items

Show child attributes

cursor · string | null

Pagination cursor for next page

message · string | null

Informational message (e.g. partial results)