b8fd8c19faee
Get jetton OHLCV candlestick data
Returns up to limit most recent non-empty OHLC candles of the requested interval grain. Window is automatically widened: provider over-fetches, filters empty candles (zero volume and flat OHLC), retries once if not enough candles collected. Returns fewer than limit only if data is genuinely scarce.
Pass from to pin the window instead: then only candles inside [from, before) come back and the period is predictable.
Path parameters
The jetton master address
Query parameters
Candle grain (size of one candle)
Desired number of non-empty candles (default 70, max 1000)
Upper bound timestamp (exclusive), default now
Lower bound timestamp (inclusive). When set, the window is authoritative: only candles inside [from, before) are returned and the provider does not widen the window to collect limit candles. Use it when the covered period must be predictable — without it a rarely traded token stretches limit candles over an arbitrary span, so the same interval means a different period per token.
Currency for OHLC values
Coarsen the grain automatically when the requested one yields too few candles to draw. A rarely traded token has almost nothing at 5m — the backend window for fine grains is only a couple of weeks — while 15m or 1h is already full. With this on, the service steps up the grain until it collects enough candles and reports the one it settled on in interval.
Response
OHLCV data
Example response
{
"candles": [
{
"time": "2024-01-15T10:00:00Z",
"open": 1.234,
"high": 1.245,
"low": 1.221,
"close": 1.24,
"volume": 12345.67
}
],
"interval": "1h"
}