Skip to main content
GET
Get token price history
Batch Support Available: This endpoint supports batch queries via POST method for fetching price history for up to 50 tokens in a single request. Jump to Batch Query section
Timestamps are in MS (JavaScript timestamps).

Overview

This endpoint retrieves 24 evenly-spaced TWAP (Time-Weighted Average Price) data points for a token, designed for lightweight sparkline and linechart rendering. Use GET for a single token or POST for batch requests (up to 50 tokens). For full OHLCV candlestick data with configurable periods, use Token OHLCV History instead.

GET Request (Single Token)

Query Parameters

Example

POST Request (Batch)

Request Body

Send an array of token queries directly, or an object with an items key (minimum 1, maximum 50 per request). Each item uses the same parameters as the GET request.

Example

Response Format

GET Response Example

POST Response Example

Timeframe Options

Notes

  • Always returns exactly 24 data points (fewer if the token is newer than the timeframe)
  • Prices are TWAP (time-weighted average) per bucket, not close prices
  • Maximum 50 tokens per POST request
  • Rate limit: 2 credits (GET), 10 credits (POST)

Query Parameters

address
string
required

Token contract address

chainId
string

Blockchain chain ID (e.g., "evm:56", "solana:solana")

timeframe
enum<string>
required

Time range for price history

Available options:
5m,
15m,
1h,
24h,
7d,
30d,
1y

Response

200 - application/json

Token price history response

data
object
required