欄位
| 欄位 | 說明 |
|---|---|
open, high, low, close | USD 或 quote 代幣計價，可配置 |
volumeUsd, volumeBase, volumeQuote | 分方向成交量 |
trades | 該 bar 的成交筆數 |
buyers, sellers | 獨立地址數（部分場景可用） |
timestamp | bar 開始時間，UTC |
週期
| 週期 | 最早回溯 | 典型用途 |
|---|---|---|
1s | 最近數小時 | 高頻 / 實時圖 |
1m、5m、15m | 天級 | 日內圖表與告警 |
1h、4h | 月級 | 波段交易看板 |
1d、1w | 專案生命週期 | 長期分析 |
接入方式
REST
tokens/{address}/candles、pools/{address}/candles、pairs/{address}/candles。WebSocket
dex-candle:{chain}_{tokenAddress}_{resolution}（USD）與 dex-candle-in-native:...（原生幣計價）。SDK：client.stream.subscribeTokenCandles({ chain, tokenAddress, resolution, callback })。GraphQL
一次查詢同時取 K 線與代幣後設資料。
SDK
client.token.getCandles(chain, tokenAddress, { resolution }) 返回型別化陣列。常見用例
- 渲染 TradingView 風格的價格圖
- 歷史 OHLC 喂回測引擎
- 下游計算 RSI / MACD / VWAP 等指標
- 驅動時序異常告警
計費
REST / GraphQL 按返回 bar 數分頁計費；WebSocket 按 bar 更新條數。下一步
Trades（tick 級）
需要 tick 粒度或自定義聚合時用。
DEX Pools 池子
池子級 K 線來自池子的成交。