盘口深度推送¶

来源同步：/Users/mac/Projects/chatgpt-codex/doc/wss_OrderBook.md

所属接口集：盘口深度推送

wss://stock-data-api.aibot6.cn/ws/orderbook/

认证方式¶

Bearer Token（详见认证与签名）

接口概述¶

实时推送股票盘口（Level 1 五档/十档买卖盘）数据。客户端连接后可指定股票代码和档位深度，服务端以 0.5 秒间隔持续推送最新盘口快照。支持在连接后通过消息动态切换订阅标的或取消订阅。

连接参数¶

参数	类型	必填	说明
token	string	是	API Token（查询参数方式传递，或通过 Authorization Header 传递）
code	string	是	股票代码，6 位数字，如 `600000`
depth	int	否	盘口档位深度，1～10，默认 `10`，最大不超过 `10`

示例连接地址：

wss://stock-data-api.aibot6.cn/ws/orderbook/?token=your_token&code=600000&depth=5

消息格式¶

发送消息（客户端→服务端）¶

{
  "action": "subscribe",
  "code": "600000",
  "depth": 10
}

字段	类型	必填	说明
action	string	是	动作类型，`subscribe` 或 `unsubscribe`
code	string	否	`subscribe` 时指定股票代码，不传则保持当前代码
depth	int	否	`subscribe` 时指定盘口深度，1～10，不传则保持当前深度

取消订阅：

{
  "action": "unsubscribe"
}

取消订阅后，code 置空，服务端暂停推送直到再次订阅。

接收消息（服务端→客户端）¶

{
  "code": 1,
  "message": "success",
  "data": {
    "ts": "2026-08-01 10:30:00",
    "buy": [
      {"price": 10.00, "volume": 100},
      {"price": 9.99, "volume": 200},
      {"price": 9.98, "volume": 300},
      {"price": 9.97, "volume": 400},
      {"price": 9.96, "volume": 500}
    ],
    "sell": [
      {"price": 10.01, "volume": 100},
      {"price": 10.02, "volume": 200},
      {"price": 10.03, "volume": 300},
      {"price": 10.04, "volume": 400},
      {"price": 10.05, "volume": 500}
    ]
  }
}

字段	类型	说明
code	int	状态码，`1` 表示成功
message	string	状态描述
data.ts	string	盘口时间戳
data.buy	array	买盘列表，按价格降序排列（买一在前）
data.buy[].price	float	买盘价格
data.buy[].volume	int	买盘挂单量（股）
data.sell	array	卖盘列表，按价格升序排列（卖一在前）
data.sell[].price	float	卖盘价格
data.sell[].volume	int	卖盘挂单量（股）

心跳机制¶

该接口无显式心跳/ ping-pong 机制。服务端以约 0.5 秒间隔持续推送盘口数据，若连接异常断开则需客户端重新建立连接。

接口说明¶

推送频率：约 0.5 秒一次
盘口深度最大为 10 档，超出部分自动截断
数据源：通达信 Level 1 盘口接口（可通过环境变量 USE_DUMMY_ORDERBOOK=true 启用模拟数据用于测试）
建连时需通过查询参数指定初始 code 和 depth，建连后可通过 subscribe 消息动态切换
当 code 为空（未订阅或已取消订阅）时，服务端暂停推送但保持连接

返回状态¶

状态码	说明
200	连接成功
401	未认证
403	无权限
4001	认证失败（服务端主动关闭连接）