45 lines
1.3 KiB
Markdown
45 lines
1.3 KiB
Markdown
# Kline JSON Protocol (Go <-> Python)
|
||
|
||
用于 Go 行情采集端与 Python 展示/回测端的数据交换。
|
||
|
||
## 标准消息格式
|
||
|
||
```json
|
||
{
|
||
"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）或消息队列进行传输
|