Skip to main content
GET
Token OHLCV Chart by Token Address

Notes

  • Returns OHLCV data from the most liquid pool of the token. Use Top Pools by Token Address to check which pool is used.
  • Timestamps use epoch/unix format (e.g. 1708850449).
  • Analyst plan and above can access data from September 2021 to present (depending on pool tracking start). Each call retrieves a max 6-month range — use before_timestamp for older data.
  • Each ohlcv_list element:
  • Intervals with no swaps are skipped by default. Set include_empty_intervals=true to fill gaps (OHLC = previous close, volume = 0).

SDK Examples

Authorizations

x-cg-pro-api-key
string
header
required

Learn how to set up your API key

Path Parameters

network
string
default:solana
required

Network ID. *refers to /onchain/networks.

token_address
string
default:So11111111111111111111111111111111111111112
required

Token contract address.

timeframe
enum<string>
default:day
required

Timeframe of the OHLCV chart.

Available options:
day,
hour,
minute,
second

Query Parameters

aggregate
string

Time period to aggregate each OHLCV. Available values (day): 1 Available values (hour): 1, 4, 12 Available values (minute): 1, 5, 15 Available values (second): 1, 15, 30 Default value: 1

before_timestamp
integer

Return OHLCV data before this timestamp (integer seconds since epoch).

limit
integer

Number of OHLCV results to return, maximum 1000. Default value: 100

currency
enum<string>

Return OHLCV in USD or quote token. Default: usd

Available options:
usd,
token
include_empty_intervals
boolean

Include empty intervals with no trade data. Default: false

include_inactive_source
boolean

Include token data from inactive pools using the most recent swap. Default: false

Response

200 - application/json

Token OHLCV chart data

data
object
required
meta
object
required