K 线数据 (Candles)

获取指定交易对和周期的历史价格走势数据。

---

1. 获取历史 K 线

端点: GET /api/v1/external/markets/:symbol/candles

请求参数:

参数	类型	必填	说明
period	string	是	周期：1m, 5m, 15m, 30m, 1h, 4h, 1d
limit	number	否	返回数量（默认 100，最高 500）
from	number	否	开始时间戳（秒）
to	number	否	结束时间戳（秒）

响应示例:

{
  "symbol": "BTCUSDT",
  "period": "1m",
  "candles": [
    {
      "time": 1702400000000,
      "open": "97450.00",
      "high": "97520.00",
      "low": "97430.00",
      "close": "97500.50",
      "volume": "125.5"
    }
  ]
}

---

2. 获取最新 K 线

获取最近的一个（未闭合或刚闭合）的 K 线柱，常用于图表实时更新。

端点: GET /api/v1/klines/:symbol/candles/latest?period=1m

返回: 最新的一条 K 线数据及 is_final 状态。