K 线数据

类型：NONE

权重：5

GET /fapi/v1/klines

由 ledger.trades 用 date_trunc 实时构造的 OHLCV 桶。

请求

GET /fapi/v1/klines?symbol=BTCUSDT&interval=1m&limit=500

Query 参数

字段	类型	必填	默认值	说明
symbol	string	是	—	标准 pair（如 BTCUSDT）。
interval	string	是	—	1m、1h、1d 之一。其他值 → -1100。
limit	integer	否	500	钳制到 1..=1500。它是回看窗口而非行数上限：查询覆盖最近 limit 个 interval（ts > now() − limit × interval），且只返回至少有一笔成交的桶，因此返回行数可能少于 limit，空桶会被省略而不是补零。
startTime、endTime	int64	否	—	接受但忽略；只有 limit 控制窗口。

响应 — 200（标准嵌套数组形态）

[
  [
    1748275140000,                       // openTime
    "76510.000000000000000000",          // open
    "76525.000000000000000000",          // high
    "76500.000000000000000000",          // low
    "76521.340000000000000000",          // close
    "1.245600000000000000",              // volume (base)
    1748275199999,                       // closeTime
    "95300.123456789012345678",          // quoteVolume
    142,                                 // count
    "0.623400000000000000",              // takerBuyVolume (base)
    "47700.500000000000000000",          // takerBuyQuoteVolume
    "0"                                  // ignore
  ]
]

按 openTime 升序返回。最末一个桶在边界关闭前是 partial。

错误

HTTP	code	msg
400	-1100	未知 symbol，或不支持的 interval（仅接受 1m / 1h / 1d）。
400	—	symbol 或 interval 缺失或格式错误：axum 的纯文本拒绝（Failed to deserialize query string: …），不是 {code,msg} JSON 形态。
500	-1000	数据库错误。

1m / 1h / 1d 以外的 interval（3m、5m、15m、30m、2h、4h、6h、8h、12h、1w、1M）暂未支持。 Rocky 也在 Web v1 原生 surface 提供：GET /v1/markets/{symbol}/candles?period=1m&limit=500（interval 是 period 的别名；period 支持 1m|3m|5m|15m|30m|1h|2h|4h|6h|12h|1d|3d|1w；limit 钳制到 1..=2000，在该接口表示最近的桶数）— 返回 {bucket_ms, open, high, low, close, volume} 对象数组而非嵌套数组形态。