Token candles
OHLCV candles, oldest first, in USD price or market cap, in USD or in the chain’s coin. An
interval without trades usually has no candle, so candles are not evenly spaced: limit
counts candles, not time. from and to are milliseconds: the page starts at the candle
that contains from; to page back, pass the oldest time you have minus 1 as to. One
candle per interval start (weeks from Monday 00:00Z), positive prices, high and low
reaching open and close, and every candle opens at the previous one’s close (only a
token’s first candle opens at its first trade). 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. Live: channel candles.
1s to 1w.
unit=marketCapcharts market cap instead of price: every OHLC value × the token’s supply, the one/tokensuses formarketCapUsd, the same on every candle. A token with no known supply answers503withoutRetry-After: ask withunit=usd.currency=nativeprices the chart in the chain’s coin (SOL, ETH, BNB): each candle at the coin’s price at its end,volumein the coin too. Otherwisevolumeis USD.- Every candle opens at the previous one’s close (only a token’s first candle opens at its first trade), and
highandlowreachopenandclose. 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.Path Parameters
Query Parameters
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)
usd, marketCap