What’s inside
| Field | Description |
|---|---|
open, high, low, close | USD or quote-token denominated, configurable |
volumeUsd, volumeBase, volumeQuote | Volumes per side |
trades | Trade count in the bar |
buyers, sellers | Unique address counts (where available) |
timestamp | Bar open-time, UTC |
Intervals
| Interval | Earliest lookback | Typical use |
|---|---|---|
1s | recent hours | Scalping, live charts |
1m, 5m, 15m | days | Intraday charts and alerts |
1h, 4h | months | Swing-trading dashboards |
1d, 1w | project lifetime | Long-term analytics |
Access
REST
/v2/token/{chain}/{tokenAddress}/candles, /v2/token/{chain}/pool/{poolAddress}/candles, /v2/token/{chain}/pair/{pair}/candles.WebSocket
dex-candle:{chain}_{tokenAddress}_{resolution} (USD) and dex-candle-in-native:... (native). SDK: client.stream.subscribeTokenCandles({ chain, tokenAddress, resolution, callback }).GraphQL
Fetch bars alongside token metadata in one query.
SDK
client.token.getCandles(chain, tokenAddress, { resolution }) returns typed arrays.Common use cases
- Render TradingView-style price charts
- Feed backtesting engines with historical OHLC
- Compute technical indicators (RSI, MACD, VWAP) downstream
- Drive time-series anomaly alerts
Billing
REST / GraphQL: pagination-priced per bar returned. WebSocket: per-bar-update.Next
Trades (tick-level)
Use if you need tick-level granularity or custom aggregation.
DEX Pools
Pool-specific OHLC is derived from pool trades.