Skip to main content
GET
OHLCV candles at one timeframe, oldest first.

Authorizations

Authorization
string
header
required

Send the API key as Authorization: Bearer <key>.

Path Parameters

chain
enum<string>
required

Chain the resource lives on. Chain slug. One spelling per chain, in paths and bodies alike. Only a chain with spot data is published.

Available options:
solana,
base,
bsc,
robinhood,
arc
address
string
required

Token mint or contract address.

Query Parameters

timeframe
enum<string>
default:1m

Candle bucket size; defaults to 1m.

Available options:
1s,
5s,
15s,
30s,
1m,
3m,
5m,
15m,
30m,
1h,
4h,
6h,
12h,
1d,
7d
metric
string
default:marketCap

OHLC metric, price or marketCap; defaults to marketCap.

denomination
string
default:usd

OHLC denomination; defaults to usd.

from
integer<int64>

Window start, inclusive; ignored when countBack is set. A window holding more candles than the cap keeps the newest. An instant, as milliseconds since the Unix epoch.

to
integer<int64>

Window end, exclusive. An instant, as milliseconds since the Unix epoch.

countBack
integer<int32>

TradingView bar count: the most recent N buckets at or before to. Takes priority over from.

Required range: 1 <= x <= 5000

Response

One candle per bucket that traded, oldest first. The most recent 500 buckets when the request names neither countBack nor from.

GET /v1/tokens/{chain}/{address}/ohlcv response.

candles
object[]
required

Buckets, oldest first.