Skip to main content
GET
Get historical price time-series for a token
Returns historical price data points for a token, ready for line charts. Choose an interval from 5m up to monthly, and set forwardFill=true to fill gaps with the last known price. For native coins, pass native as tokenAliasOrTokenAddress.

Authorizations

X-Api-Key
string
header
required

Path Parameters

chainAlias
enum<string>
required

The alias of the chain.

Available options:
0x1,
ethereum,
0x15b38,
chiliz,
0x171,
pulse,
0x19,
cro,
0x2105,
base,
0x2eb,
flow,
0x38,
binance,
0x46f,
lisk,
0x504,
moon beam,
0x531,
sei,
0x64,
gnosis,
0x89,
polygon,
0x8f,
monad,
0xa,
optimism,
0xa4b1,
arbitrum,
0xa86a,
avalanche,
0xe708,
linea,
bitcoin-mainnet,
bitcoin,
solana-mainnet,
sol
tokenAliasOrTokenAddress
string
required

The token address or alias

Query Parameters

limit
number
default:100

The limit per page

Required range: 1 <= x <= 100
cursor
string

The cursor to the next page

interval
enum<string>
default:5m

The time interval for price data points. Defaults to 5m if not provided.

Available options:
5m,
hourly,
daily,
weekly,
monthly
Example:

"hourly"

fromDate
string

The starting date (format in seconds or datestring accepted by momentjs). Defaults to 24 hours before toDate if not provided.

Example:

"2025-01-01T00:00:00Z"

toDate
string

The ending date (format in seconds or datestring accepted by momentjs). Defaults to now if not provided.

Example:

"2025-01-07T00:00:00Z"

forwardFill
boolean
default:false

When true, fills gaps in the time series with interpolated values

Response

200 - application/json
cursor
string | null
required

The cursor to be used for getting the next page of results

Example:

"eyJhbGciOi...VCaaw"

chain
string
required

The blockchain network chain ID

Example:

"0x1"

fromDate
string
required

The starting date of the time series in ISO 8601 format

Example:

"2025-01-01T00:00:00.000Z"

toDate
string
required

The ending date of the time series in ISO 8601 format

Example:

"2025-01-07T00:00:00.000Z"

interval
enum<string>
required

The time interval used for the price data points

Available options:
5m,
hourly,
daily,
weekly,
monthly
Example:

"5m"

page
number
required

The current page number

Example:

1

result
object[]
required

The list of price data points

meta
object
required