Token candles
get_token_ohlcvRaw OHLCV candles for one token — open, high, low, close and volume per interval — for calculation, technical analysis, or computing a return over a specific window. Prices are always USD (the response says so in denomination). Pick the candle size with interval (1m, 5m, 15m, 1h, 4h, 1d); it wins over timeframe and aggregate. With none of the three the default is 15-minute candles; timeframe alone means 1 unit (hour = 1h). An unsupported size is rejected, never silently swapped, and the response echoes the interval and candle_seconds actually served. t is Unix MILLISECONDS. All three time arguments accept SECONDS or MILLISECONDS, so a t value from a previous response can be fed straight back.
🔴 READ BEFORE COMPUTING A RETURN — the s/t/o/h/l/c/v shape looks like TradingView's, and it differs from it in two ways that will silently corrupt the answer:
THE SERIES IS NEWEST-FIRST (descending
t), not oldest-first.c[0]is the LATEST close andc[-1]is the OLDEST. A return over the window is(c[0] - c[-1]) / c[-1]; doing it the other way round returns the right magnitude with the WRONG SIGN. The response states this inorder.EVERY CANDLE RETURNED IS CLOSED. The current, still-forming interval is removed by default, because its close is a mid-bucket tick rather than a close and including it makes 'the return over the last N candles' wrong. Set
include_in_progress_candleonly if you specifically want the live, unfinished bucket — it will then be at index 0 andincludes_in_progress_candlewill be true.
Choosing between the two price tools: get_token_chart returns a ready-to-read price line for describing a trend; get_token_ohlcv returns raw open/high/low/close/volume candles for calculation and technical analysis. Prefer the chart unless you need per-candle numbers. This is public market data about the whole market — it is NOT about the user's own wallet or holdings. Tools whose names start with get_my_ are the ones that return the user's own data.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many candles to return. | |
| network | No | solana | |
| time_to | No | Window end, Unix timestamp in SECONDS or MILLISECONDS — either is accepted. Requires `time_from` as well. | |
| interval | No | Candle size. Wins over `timeframe`/`aggregate`. Omit all three for 15m. | |
| aggregate | No | How many `timeframe` units per candle. 1 when only `timeframe` is given. | |
| time_from | No | Window start, Unix timestamp in SECONDS or MILLISECONDS — either is accepted. Requires `time_to` as well. | |
| timeframe | No | Candle unit. Candle size is `aggregate` × this (`aggregate` defaults to 1 when only this is given). Only the sizes listed under `interval` are served; anything else is rejected. | |
| token_address | Yes | ||
| before_timestamp | No | Return candles before this Unix timestamp, in seconds or milliseconds. Use to page further back in history — a `t` value from a previous response can be passed straight back. | |
| include_in_progress_candle | No | True keeps the current, still-forming candle at index 0. Leave false for any calculation — its close is not a close. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||