热门板块推送¶

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

所属接口集：热门板块推送

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

认证方式¶

Bearer Token（详见认证与签名）

接口概述¶

实时推送热门板块榜单数据。服务端以 2 秒间隔检测板块排序变化，仅在榜单顺序发生变化时推送，避免重复推送相同数据。

连接参数¶

参数	类型	必填	说明
token	string	是	API Token
day	string	否	交易日，格式 `YYYYMMDD`，默认当天

示例连接地址：

wss://stock-data-api.aibot6.cn/ws/hotboards/?token=your_token&day=20260801

消息格式¶

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

{
  "action": "subscribe",
  "day": "20260801"
}

字段	类型	必填	说明
action	string	是	`subscribe` 或 `unsubscribe`
day	string	否	`subscribe` 时指定交易日

取消订阅：

{
  "action": "unsubscribe"
}

取消订阅后，服务端主动关闭连接。

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

{
  "code": 1,
  "message": "success",
  "data": {
    "type": "hotboards_order",
    "key": "stockapi:hotboards:20260801:order",
    "items": [
      "AI算力",
      "卫星互联网",
      "光刻机",
      "半导体设备",
      "机器人"
    ]
  }
}

字段	类型	说明
code	int	状态码，`1` 表示成功
message	string	状态描述
data.type	string	固定为 `hotboards_order`
data.key	string	Redis 键名
data.items	array	板块名称列表，按排名顺序排列（排名 1 在前）

心跳机制¶

无显式心跳/ ping-pong 机制。服务端以 2 秒间隔检测榜单变化，仅在数据变化时推送。若长时间未收到消息，客户端可认为榜单顺序未发生变化。

接口说明¶

检测频率：2 秒一次
变化推送：仅当榜单顺序发生变化时推送，相同数据不重复推送
数据源：Redis LIST {prefix}:hotboards:{day}:order
板块名称按列表顺序排列，顺序即代表排名
unsubscribe 操作会主动关闭连接

返回状态¶

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