字段
| 字段 | 说明 |
|---|---|
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 线来自池子的成交。