Skip to main content
Candles come oldest first, one per bucket that traded. A bucket with no trades is left out. The series follows the TradingView contract: countBack asks for a bar count and supersedes from, while to and timeframe still bind.

Path parameters

string
required
string
required
The token’s address.

Query parameters

string
default:"1m"
Bucket size. One of 1s, 5s, 15s, 30s, 1m, 3m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 1d, 7d. A width outside this set has no rows behind it and is refused.
string
default:"marketCap"
What the OHLC values measure: price or marketCap.
string
default:"usd"
What they are denominated in: usd or native.
integer
Window start in milliseconds, inclusive. Ignored when countBack is set. A window holding more than 5000 candles keeps the newest.
integer
Window end in milliseconds, exclusive.
integer
The most recent N buckets at or before to, between 1 and 5000. Takes priority over from.
A request that names neither countBack nor from returns the most recent 500 buckets. To read older candles, repeat the request with to set to the earliest time you received; see Paging through candles.

Response

object[]
required
Buckets, oldest first.
Candle values are JSON numbers, not the decimal strings the token and trade objects carry. They feed charting libraries, which take numbers.

Errors

An unknown token answers an empty series, not a 404.