实时捕捉个股触板、封板、开板及成交与封单变化，帮助用户判断涨跌停强度和封板稳定性。 接口返回 WebSocket 连接票据；连接后按订阅确认消息中的 `fields` 顺序解析推送数据 `i`。
POST
/api/v2/realtime/ws-ticketapiname:stock/stream_limit_event_v2生产专线（默认）深圳
http://sz.numcat.net:8866/api/v2/realtime/ws-ticket上海http://sh.numcat.net:8866/api/v2/realtime/ws-ticket公网备用https://numcat.net/api/v2/realtime/ws-ticket请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
apikey | string | 必选 | — | 猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。 |
channel | string（tick_stream） | 可选 | tick_stream | 实时推送通道，固定为 tick_stream。 |
stream_version | string（stream_limit_event_v2） | 可选 | stream_limit_event_v2 | 实时推送协议版本，固定为 stream_limit_event_v2。 |
symbols | array<string> | 可选 | [] | 用于限定异动范围的股票完整代码数组；不传 symbols 和 groups 时订阅全市场。 |
groups | array<string> | 可选 | [] | 用于限定异动范围的快捷股票池数组；不传 symbols 和 groups 时订阅全市场。 |
event_types | array<integer（1 / 2 / 3 / 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12）> | 可选 | [1,2,3,4,5,6,7,8,9,10,11,12] | 限定事件编号；不传或传空数组时订阅全部 12 类。<br>1=冲击涨停：最新价由非涨停进入涨停价；若多次符合条件，5 分钟内最多推送一次。<br>2=封死涨停：当天首次连续 60 秒处于涨停价，且封单额不少于 1000 万元。<br>3=涨停回封：当天触及涨停并打开后，再次连续 60 秒处于涨停价，且封单额不少于 1000 万元。<br>4=涨停打开：已确认封住涨停后，最新价离开涨停价。<br>5=涨停被砸：已确认且仍处于涨停价，3 秒累计成交额增加不少于 1000 万元。<br>6=封涨大减：已确认且仍处于涨停价，12 秒封单减少不少于 1000 万元，且减少额不低于当前封单额的 10%。<br>7=冲击跌停：最新价由非跌停进入跌停价；若多次符合条件，5 分钟内最多推送一次。<br>8=封死跌停：当天首次连续 60 秒处于跌停价，且封单额不少于 1000 万元。<br>9=再次跌停：当天触及跌停并打开后，再次连续 60 秒处于跌停价，且封单额不少于 1000 万元。<br>10=跌停打开：已确认封住跌停后，最新价离开跌停价。<br>11=跌停撬板：已确认且仍处于跌停价，3 秒累计成交额增加不少于 1000 万元。<br>12=封跌大减：已确认且仍处于跌停价，12 秒封单减少不少于 1000 万元，且减少额不低于当前封单额的 10%。 |
fields | array<string>|null | 可选 | ["tradedate","servertime","last_price","limit_price","amount","turnover_rate","fd_amount","trade_amount_3s","fd_decrease_12s","fd_decrease_rate_12s","limit_times","open_times"] | 需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。 |
ttl_seconds | integer | 可选 | 120 | 票据有效期（秒），取值范围 30～600。 |
fields 返回字段
字段顺序与接口样例保持一致| 字段 | 类型 | 名称 | 示例值 | 描述 |
|---|---|---|---|---|
tradedate | string|null | 交易日期 | 20260731 | 日期格式：YYYYMMDD。 |
servertime | string|null | 行情时间 | 10:02:45 | 触发事件的行情时间，格式 HH:mm:ss。 |
last_price | number|null | 最新价（元） | 11.13 | 事件行情时点的最新成交价。 |
limit_price | number|null | 涨跌停价（元） | 11.13 | 与该事件方向对应的当日涨停价或跌停价。 |
amount | number|null | 累计成交额（元） | 1685000000 | 事件行情时点的当日累计成交额。 |
turnover_rate | number|null | 换手率（%） | 6.8123 | 事件行情时点按流通股本计算的换手率。 |
fd_amount | number|null | 封单额（元） | 89200000 | 事件行情时点对应涨跌停价一档的封单金额。 |
trade_amount_3s | number|null | 3 秒成交额增量（元） | 12000000 | 当前累计成交额减去同一交易时段 3 秒前累计成交额；仅相关事件有值。 |
fd_decrease_12s | number|null | 12 秒封单减少额（元） | 22000000 | 同一交易时段 12 秒前封单额减去当前封单额；仅相关事件有值。 |
fd_decrease_rate_12s | number|null | 12 秒封单减少比例 | 0.25 | 12 秒封单减少额除以当前封单额；仅相关事件有值。 |
limit_times | integer|null | 连续涨跌停天数 | 2 | 涨停方向为正、跌停方向为负。 |
open_times | integer|null | 当日开板次数 | 1 | 该方向已确认封板后被打开的累计次数。 |
请求与响应样例
固定样例
{
"apikey": "YOUR_API_KEY",
"channel": "tick_stream",
"stream_version": "stream_limit_event_v2",
"symbols": [],
"event_types": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12
],
"fields": [
"tradedate",
"servertime",
"last_price",
"limit_price",
"amount",
"turnover_rate",
"fd_amount",
"trade_amount_3s",
"fd_decrease_12s",
"fd_decrease_rate_12s",
"limit_times",
"open_times"
],
"ttl_seconds": 120
}{
"code": 200,
"message": "success",
"data": {
"channel": "tick_stream",
"url": "wss://pre.numcat.net/api/stream_limit_event_v2?ticket={ticket}",
"expires_at": 1740800000,
"ttl_seconds": 120,
"subscription_plan_code": "professional_year",
"tick_sub_limit": 6000,
"stream_version": "stream_limit_event_v2"
}
}