Skip to main content
GET
Returns one OHLCV candle series for each token in tokens, a comma-separated list of 1 to 10 addresses. chains limits the read to a comma-separated list of chain slugs. Omit it to read every chain. Each series is oldest first, with one candle per bucket that traded. Buckets with no trades are omitted.

Response

The response is a list with one series per chain where each requested token has candles in the window, in the order of the request. Each series carries chain, address and candles. A token with no candles in the window has no series, so the response can be an empty list. It is not a 404.

Time range

countBack sets the number of bars and overrides from, while to and timeframe still apply. A request with neither countBack nor from returns the most recent 500 buckets, and a window with more than 5000 candles returns the newest 5000. This matches the behavior TradingView’s charting library expects.

Pagination

The series has no cursor. from is inclusive and to is exclusive, both in milliseconds. Omit to to read up to the current time. To read further back, repeat the request with to set to the time of the oldest candle received. Because to is exclusive, that candle is not returned again.

Response fields

Candle values are JSON numbers rather than the decimal strings used in token and trade objects, because charting libraries expect numbers.

Errors

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.