K 线（OHLCV）

GET/api/v1/markets/{marketId}/candles公开

Trading API价 E4 · 量 E2 · 金额 E6（整数）YES | NO

interval 命名预设 1m/5m/1h/1d（默认 1h），未知值 400;from/to 过滤桶起点 ∈ [from, to)，可选。按桶起点升序，无成交的桶不返回。传 minCursor 直接 400。与逐笔成交同源（fills 聚合），可对账。

路径参数

marketIdstringpath必填
引擎市场 id（读取类端点不接受 slug，除非该端点文档另有说明）
示例"mkt-0001"

查询参数

interval1m | 5m | 1h | 1dquery可选
K 线粒度
默认"1h"示例"1m"
fromint64query可选
epoch 毫秒
示例1
toint64query可选
epoch 毫秒
示例1

响应

200K 线数组

响应为数组，以下为每个元素的字段：

bucketStartMsint64
桶起点（epoch 毫秒）
示例1758240000000
openE4integer
开盘价（1e-4）
示例5200
highE4integer
最高价（1e-4）
示例5200
lowE4integer
最低价（1e-4）
示例5200
closeE4integer
收盘价（1e-4）
示例5200
volumeE2int64
成交量（1e-2 份）
示例1000
tradeCountinteger
成交笔数
示例1

在响应示例中切换状态码查看错误响应，完整错误码见错误码页。

请求

curl -X GET "$BASE_URL/api/v1/markets/mkt-0001/candles?interval=1h"

响应

K 线数组

[
  {
    "bucketStartMs": 1758240000000,
    "openE4": 5200,
    "highE4": 5200,
    "lowE4": 5200,
    "closeE4": 5200,
    "volumeE2": 1000,
    "tradeCount": 1
  }
]