Detail 大单明细流

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

所属接口集：大单监控推送

请求 URL

wss://stock-data-api.aibot6.cn/ws/monitor/detail/

认证方式

Bearer Token（详见 认证与签名）

接口概述

实时推送股票大单成交明细增量数据。服务端跟踪已推送位置，仅推送新增的大单记录，避免重复推送。

连接参数

参数	类型	必填	说明
token	string	是	API Token
code	string	否	股票代码，6 位数字，如 600000
ts_code	string	否	带市场后缀代码，如 600000.SH
day	string	否	交易日，格式 YYYYMMDD，默认当天
side	string	否	大单方向，buy 或 sell，默认 buy

示例连接地址：

wss://stock-data-api.aibot6.cn/ws/monitor/detail/?token=your_token&code=600000&day=20260801&side=buy

消息格式

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

订阅：

{
  "action": "subscribe",
  "code": "600000",
  "day": "20260801",
  "side": "sell"
}

字段	类型	必填	说明
action	string	是	subscribe 或 unsubscribe
code	string	否	股票代码
ts_code	string	否	带市场后缀代码
day	string	否	交易日
side	string	否	大单方向，buy 或 sell

取消订阅：

{
  "action": "unsubscribe"
}

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

{
  "code": 1,
  "message": "success",
  "data": {
    "type": "detail",
    "key": "stockapi:monitor:detail:buy:20260801:600000",
    "items": [
      {
        "ts": "2026-08-01 10:30:12",
        "price": 11.26,
        "vol": 5000,
        "turnover_ratio": 0.0005,
        "phase": "regular"
      }
    ]
  }
}

字段	类型	说明
code	int	状态码，1 表示成功
message	string	状态描述
data.type	string	固定为 detail
data.key	string	Redis 键名，含方向信息
data.items	array	新增大单明细列表
data.items[].ts	string	成交时间
data.items[].price	float	成交价格
data.items[].vol	int	成交量（股）
data.items[].turnover_ratio	float	换手率
data.items[].phase	string	交易阶段（如 regular）

心跳机制

无显式心跳/ ping-pong 机制。服务端以 0.5 秒间隔检测新增大单记录并推送增量。若连接异常断开则需客户端重新建立连接。

接口说明

• 检测频率：0.5 秒一次
• 增量推送：仅推送自上次推送后新增的大单记录，不重复推送
• 切换订阅时（subscribe），已推送位置计数器重置（_last_len = 0），将重新从头推送
• 数据源：Redis LIST {prefix}:monitor:detail:{side}:{day}:{code6}

---