Chan 数据提供商

返回服务名称、交易所、交易对列表、可用周期及就绪状态。

响应

{
  "service":        "Data Provider",
  "exchange":        "binance",
  "symbols":         ["BTC/USDT:USDT", "ETH/USDT:USDT", ...],
  "base_timeframes":  ["1m", "1h", "1d", "1w"],
  "derived_timeframes": ["5m", "15m", "4h", ...],
  "timeframes":       ["1m", "1h", ..., "5m", "15m", ...],
  "ready":           true
}

返回服务健康状态，与 / 相同结构，适合负载均衡探测器。

响应

{
  "status":  "ok",
  "exchange": "binance",
  "symbols":  ["BTC/USDT:USDT", ...],
  "ready":    true,
  ...
}

返回基础周期（交易所直接拉取）和衍生周期（合成生成）的完整列表。

响应

{
  "base_timeframes":    ["1m", "1h", "1d", "1w"],
  "derived_timeframes": ["5m", "15m", "4h", ...],
  "timeframes":         ["1m", "1h", ..., "5m", "15m", ...]
}

请求示例

# 获取 BTC 最近 100 根 5 分钟 K 线
GET /api/candles?symbol=BTC/USDT:USDT&tf=5m&limit=100

# 指定时间范围
GET /api/candles?symbol=ETH/USDT:USDT&tf=1h&start=1704067200000&end=1704153600000

# 获取 4 小时周期（衍生周期）
GET /api/candles?symbol=SOL/USDT:USDT&tf=4h&limit=50

响应

返回 OHLCV 对象数组：

[
  {
    "timestamp": 1704067200000,
    "datetime":  "2024-01-01T00:00:00Z",
    "open":      42850.12,
    "high":      43100.00,
    "low":       42780.50,
    "close":     43050.80,
    "volume":    125.34
  },
  ...
]

字段说明

连接 WebSocket 后，通过 JSON 消息进行订阅管理。服务端在数据更新时主动推送最新 K 线。

客户端 → 服务端

{
  "action":    "subscribe",
  "symbol":    "BTC/USDT:USDT",
  "timeframe": "1m"
}

{
  "action":    "unsubscribe",
  "symbol":    "BTC/USDT:USDT",
  "timeframe": "1m"
}

{ "action": "ping" }

服务端 → 客户端

{
  "type":      "subscribed",
  "symbol":    "BTC/USDT:USDT",
  "timeframe": "1m"
}

{
  "type":      "snapshot",
  "symbol":    "BTC/USDT:USDT",
  "timeframe": "1m",
  "data":      [ ... ]
}

{
  "type":      "kline",
  "symbol":    "BTC/USDT:USDT",
  "timeframe": "1m",
  "data":      [ ... ]
}

{ "type": "pong" }

{ "type": "error", "message": "..." }

JavaScript 示例

// 连接
const ws = new WebSocket("ws://localhost:9009/ws");

ws.onopen = () => {
  // 订阅 BTC 1m K 线
  ws.send(JSON.stringify({
    action: "subscribe",
    symbol: "BTC/USDT:USDT",
    timeframe: "1m"
  }));
};

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);
  if (msg.type === "kline") {
    console.log(msg.data); // 最新 K 线数组
  }
};