Skip to main content
GET
OHLCV candles at one timeframe for each named token, oldest first.

Authorizations

Authorization
string
header
required

Send an API key, or a session token a key minted, as Authorization: Bearer <credential>. A browser opening /v1/stream offers its session token in Sec-WebSocket-Protocol instead.

Query Parameters

tokens
string
required

Token addresses, CSV; one to 10. Each reads on every chain in scope of its address family.

chains
string

Chains to scope to, CSV of the chain slugs. Absent means every spot chain.

pool
string

Pool address. When present, the read takes this pool's candles, and tokens names its token alone. When absent, each token reads across all of its pools.

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 per series: the most recent N buckets at or before to. Takes priority over from.

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

A series' nextCursor, to read its next, older page. The request names that series' token in tokens, and its chain in chains when the token's address family spans several.

Response

One series per chain where each named token, or its pool, has candles in the window, in the order the request named them. Each holds one page of candles, one per bucket that traded, oldest first.

address
string
required

Token address.

candles
object[]
required

Buckets on this page, oldest first.

chain
enum<string>
required

Chain the token trades on.

Available options:
solana,
bsc,
robinhood,
elysium,
ethereum
hasMore
boolean
required

Whether this series has older candles in the window.

nextCursor
string | null

The cursor of this series' next, older page when hasMore is true; null on its last page.