AITrading/shared/protocol.md

Kline JSON Protocol (Go <-> Python)

用于 Go 行情采集端与 Python 展示/回测端的数据交换。

标准消息格式

{
  "type": "kline",
  "source": "binance_ws",
  "symbol": "btcusdt",
  "interval": "1m",
  "event_time": 1711430400000,
  "open_time": 1711430400000,
  "close_time": 1711430459999,
  "open": "68000.00",
  "high": "68025.00",
  "low": "67990.00",
  "close": "68010.00",
  "volume": "12.40",
  "trade_num": 102,
  "final": true
}

字段说明

• type: 消息类型，固定 kline
• source: 数据来源，默认 binance_ws
• symbol: 交易对（小写，如 btcusdt）
• interval: K 线周期（如 1m、5m、1h）
• event_time: 事件时间（毫秒时间戳）
• open_time: K 线起始时间（毫秒时间戳）
• close_time: K 线结束时间（毫秒时间戳）
• open/high/low/close: 价格字段，使用字符串保证精度
• volume: 成交量，字符串
• trade_num: 成交笔数，整数
• final: 是否为收盘完成 K 线（true 表示该根 K 线已闭合）

约束约定

• 时间戳统一为 UTC 毫秒
• 数值字段在传输层统一为字符串（trade_num 除外），消费端按需转换
• 数据可通过 Redis Pub/Sub、文件流（jsonl）或消息队列进行传输