实时推送

业务行情推送帧统一采用 data 作为核心载荷字段。

K 线实时推送（event = 1）

报文结构

外层公共元数据：event (int32) 固定 1、timestamp (int64) 秒级时间戳、data (array[object]) 产品行情数据包
产品对象：sym (string)、autype (int32)、klines (array[object]) 周期 K 线列表
klines 内部对象：ktype (string)、data (array[array]) K 线数值矩阵

K 线行 `data[i]` 索引定义

索引	字段	类型	说明
`[0]`	`time`	int64	秒级时间戳。与本地最新相同表示对未完结 K 线实时覆盖更新；递增表示生成新 K 线
`[1]`	`open`	float64	开盘价
`[2]`	`close`	float64	最新价 / 实时收盘价
`[3]`	`high`	float64	最高价
`[4]`	`low`	float64	最低价
`[5]`	`volume`	float64	累计成交量
`[6]`	`turnover`	float64	累计成交额
`[7]`	`pre_close`	float64	上一根 K 线收盘价
`[8]`	`chg`	float64	涨跌额
`[9]`	`rate`	float64	涨跌幅（`0.67` 代表 `+0.67%`）
`[10]`	`session`	int32	美股时段：`1`=盘前, `2`=盘中, `3`=盘后；非美股固定 `-1`

推送示例

{
  "event": 1,
  "timestamp": 1781962260,
  "data": [
    {
      "sym": "AAPL.US",
      "autype": 1,
      "klines": [
        {
          "ktype": "1m",
          "data": [
            [1781962200, 180.50, 181.20, 182.00, 179.80, 480220.0, 86677688.40, 180.00, 1.20, 0.67, 2],
            [1781962260, 181.20, 181.25, 181.30, 181.15, 1200.0, 217440.00, 181.20, 0.05, 0.03, 2]
          ]
        }
      ]
    }
  ]
}

Tick 逐笔推送（event = 2）

Tick 行 `data[i]` 索引定义

索引	字段	类型	说明
`[0]`	`time`	int64	成交秒级时间戳
`[1]`	`price`	string	成交价格（高精度字符串）
`[2]`	`volume`	int64	成交数量
`[3]`	`turnover`	float64	成交金额
`[4]`	`ticker_direction`	int32	交易方向：`1`=外盘(Buy), `-1`=内盘(Sell), `0`=中性盘
`[5]`	`trade_type`	string	交易所代码（如 `"SL"`, `"P"`, 普通为 `""`）
`[6]`	`session`	int32	美股时段：`1`=盘前, `2`=盘中, `3`=盘后；非美股固定 `-1`

推送示例

{
  "event": 2,
  "timestamp": 1781962260,
  "data": [
    {
      "sym": "AAPL.US",
      "data": [
        [1781962260, "180.50", 100, 18050.00, 1, "P", 2],
        [1781962260, "180.52", 200, 36104.00, 1, "P", 2]
      ]
    }
  ]
}

盘口深度推送（event = 3）

盘口档位 `[i]` 索引定义

ask：卖盘矩阵，升序排列（卖一 < 卖二 < 卖三）。无挂单返回 []。
bid：买盘矩阵，降序排列（买一 > 买二 > 买三）。无挂单返回 []。
档位索引：[0] 挂单价 (string), [1] 挂单量 (float64), [2] 挂单笔数 (int32，非股票固定返回 -1)。

推送示例

{
  "event": 3,
  "timestamp": 1781962260,
  "data": [
    {
      "sym": "AAPL.US",
      "ask": [
        ["180.51", 500.0, 2],
        ["180.52", 800.0, 3]
      ],
      "bid": [
        ["180.50", 1000.0, 5],
        ["180.49", 2500.0, 12]
      ]
    }
  ]
}

分时走势推送（event = 4）

分时行 `data[i]` 索引定义

索引	字段	类型	说明
`[0]`	`time`	int64	分时秒级时间戳（分钟整点对齐）。相同为覆盖当前分钟，递增为新分钟点
`[1]`	`price`	float64	当前分钟截止最新价
`[2]`	`avg_price`	float64	当日成交量加权均价（VWAP）
`[3]`	`volume`	float64	当分钟成交量
`[4]`	`turnover`	float64	当分钟成交额

推送示例

{
  "event": 4,
  "timestamp": 1781962260,
  "data": [
    {
      "sym": "AAPL.US",
      "data": [
        [1781962200, 180.50, 180.45, 12500.0, 2255625.00],
        [1781962260, 181.20, 180.48, 8900.0, 1612680.00]
      ]
    }
  ]
}