Skip to main content
GET
Token candles
Oldest first, one candle per interval start (weeks from Monday 00:00Z). Intervals from 1s to 1w.
  • unit=marketCap charts market cap instead of price: every OHLC value × the token’s supply, the one /tokens uses for marketCapUsd, the same on every candle. A token with no known supply answers 503 without Retry-After: ask with unit=usd.
  • currency=native prices the chart in the chain’s coin (SOL, ETH, BNB): each candle at the coin’s price at its end, volume in the coin too. Otherwise volume is USD.
  • Every candle opens at the previous one’s close (only a token’s first candle opens at its first trade), and high and low reach open and close. A wick no candle around supports (a thin side pool, a mispriced swap) is cut to the body; a token’s first 5 candles and wicks with high volume are never touched.
from and to are milliseconds. Without them you get the latest limit candles. The page starts at the candle that contains from. To load older history, pass the oldest time you have minus 1 as to. An interval without trades usually has no candle (a minute without a trade, no 1m candle), so do not assume candles are evenly spaced: limit counts candles, not time. Draw the gap, or carry the previous close across it. A candle with volume 0 can also appear. A request may answer 503 with Retry-After: the candles cannot be served right now. Ask again after it. Live: the candles channel sends the same candles, then the forming one on every trade. Live candles are built from the trades the trades channel shows, so chart and tape agree.

Authorizations

x-api-key
string
header
required

Path Parameters

chain
string
required

sol, eth, bsc, base or robinhood (or an alias or network id)

Example:

"sol"

address
string
required

Token address (mint or contract)

Example:

"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"

Query Parameters

interval
enum<string>
default:1m
Available options:
1s,
5s,
15s,
30s,
1m,
5m,
15m,
30m,
1h,
4h,
12h,
1d,
1w
from
integer

Start, ms

to
integer

End, ms (default now); the candle starting at to is included

limit
integer
default:300
Required range: x <= 1000
unit
enum<string>
default:usd

marketCap: every price × the token's supply, the one /tokens uses for marketCapUsd (its circulating supply, else its total supply), the same on every candle; volume stays in USD (or the coin). REST, snapshot and live market-cap candles use the same supply. A token with no known supply answers upstream_unavailable (try unit=usd)

Available options:
usd,
marketCap
currency
enum<string>
default:usd

native: every candle in the chain's coin (SOL, ETH, BNB) at the coin's price at the candle's end, volume in the coin too; on Solana, solana.dad's own SOL candles. A sparse page is priced at a coarser resolution of the coin's price

Available options:
usd,
native

Response

Candles, oldest first

data
object[]