异动订阅
先向文档指定的服务申请订阅票据,再按 WebSocket 协议处理订阅范围、心跳和重连。
CLI 只申请票据。Agent 使用响应中的连接 URL 建立 WebSocket 并接收事件。
实时捕捉个股触板、封板、开板及成交与封单变化,帮助用户判断涨跌停强度和封板稳定性。
接口返回 WebSocket 连接票据;连接后按订阅确认消息中的 fields 顺序解析推送数据 i。
请求方法 POST /api/v2/realtime/ws-ticket
- https://sz.meoz.cn:6688
- https://sh.meoz.cn:6688
返回字段
| 字段 | 名称 | 类型 | 描述 | 单位 |
|---|---|---|---|---|
| tradedate | 交易日期 | string|null | 日期格式:YYYYMMDD。 | |
| servertime | 行情时间 | string|null | 触发事件的行情时间,格式 HH:mm:ss。 | |
| last_price | 最新价(元) | number|null | 事件行情时点的最新成交价。 | |
| limit_price | 涨跌停价(元) | number|null | 与该事件方向对应的当日涨停价或跌停价。 | |
| amount | 累计成交额(元) | number|null | 事件行情时点的当日累计成交额。 | |
| turnover_rate | 换手率(%) | number|null | 事件行情时点按流通股本计算的换手率。 | |
| fd_amount | 封单额(元) | number|null | 事件行情时点对应涨跌停价一档的封单金额。 | |
| trade_amount_3s | 3 秒成交额增量(元) | number|null | 当前累计成交额减去同一交易时段 3 秒前累计成交额;仅相关事件有值。 | |
| fd_decrease_12s | 12 秒封单减少额(元) | number|null | 同一交易时段 12 秒前封单额减去当前封单额;仅相关事件有值。 | |
| fd_decrease_rate_12s | 12 秒封单减少比例 | number|null | 12 秒封单减少额除以当前封单额;仅相关事件有值。 | |
| limit_times | 连续涨跌停天数 | integer|null | 涨停方向为正、跌停方向为负。 | |
| open_times | 当日开板次数 | integer|null | 该方向已确认封板后被打开的累计次数。 |
请求
{"content":{"application/json":{"example":{"apikey":"","channel":"tick_stream","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"],"stream_version":"stream_limit_event_v2","symbols":[],"ttl_seconds":120},"schema":{"properties":{"apikey":{"default":"","description":"浏览器中的 Test Request 会在发送时自动注入;其他调用请[前往个人中心获取](/console)。","type":"string"},"channel":{"default":"tick_stream","description":"实时推送通道,固定为 tick_stream。","enum":["tick_stream"],"type":"string"},"event_types":{"default":[1,2,3,4,5,6,7,8,9,10,11,12],"description":"限定事件编号;不传或传空数组时订阅全部 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%。","items":{"enum":[1,2,3,4,5,6,7,8,9,10,11,12],"type":"integer"},"maxItems":12,"nullable":true,"type":"array","uniqueItems":true},"fields":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":["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"],"description":"| 字段 | 类型 | 名称 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `tradedate` | `string\\|null` | 交易日期 | `20260731` | 日期格式:YYYYMMDD。 |\n| `servertime` | `string\\|null` | 行情时间 | `10:02:45` | 触发事件的行情时间,格式 HH:mm:ss。 |\n| `last_price` | `number\\|null` | 最新价(元) | `11.13` | 事件行情时点的最新成交价。 |\n| `limit_price` | `number\\|null` | 涨跌停价(元) | `11.13` | 与该事件方向对应的当日涨停价或跌停价。 |\n| `amount` | `number\\|null` | 累计成交额(元) | `1685000000` | 事件行情时点的当日累计成交额。 |\n| `turnover_rate` | `number\\|null` | 换手率(%) | `6.8123` | 事件行情时点按流通股本计算的换手率。 |\n| `fd_amount` | `number\\|null` | 封单额(元) | `89200000` | 事件行情时点对应涨跌停价一档的封单金额。 |\n| `trade_amount_3s` | `number\\|null` | 3 秒成交额增量(元) | `12000000` | 当前累计成交额减去同一交易时段 3 秒前累计成交额;仅相关事件有值。 |\n| `fd_decrease_12s` | `number\\|null` | 12 秒封单减少额(元) | `22000000` | 同一交易时段 12 秒前封单额减去当前封单额;仅相关事件有值。 |\n| `fd_decrease_rate_12s` | `number\\|null` | 12 秒封单减少比例 | `0.25` | 12 秒封单减少额除以当前封单额;仅相关事件有值。 |\n| `limit_times` | `integer\\|null` | 连续涨跌停天数 | `2` | 涨停方向为正、跌停方向为负。 |\n| `open_times` | `integer\\|null` | 当日开板次数 | `1` | 该方向已确认封板后被打开的累计次数。 |","items":{"enum":["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"],"type":"string"},"maxItems":20,"nullable":true,"type":"array","uniqueItems":true},"groups":{"default":[],"description":"用于限定异动范围的快捷股票池数组;不传 symbols 和 groups 时订阅全市场。","items":{"type":"string"},"type":"array"},"stream_version":{"default":"stream_limit_event_v2","description":"实时推送协议版本,固定为 stream_limit_event_v2。","enum":["stream_limit_event_v2"],"type":"string"},"symbols":{"default":[],"description":"用于限定异动范围的股票完整代码数组;不传 symbols 和 groups 时订阅全市场。","items":{"type":"string"},"type":"array"},"ttl_seconds":{"default":120,"description":"票据有效期(秒),取值范围 30~600。","maximum":600,"minimum":30,"type":"integer"}},"required":["apikey"],"type":"object"}}},"description":"| 参数 | 类型 | 是否必选 | 固定值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `apikey` | `string` | 必选 | — | [访问个人中心获取](/console)。 |\n| `channel` | `string` | 可选 | `tick_stream` | 实时推送通道。 |\n| `stream_version` | `string` | 必选 | `stream_limit_event_v2` | 推送协议版本。 |\n\n#### fields\n\n| 字段 | 类型 | 名称 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `symbol` | `string` | 股票代码 | `000001.SZ` | 固定返回;带市场后缀的完整股票代码。 |\n| `name` | `string` | 股票名称 | `平安银行` | 固定返回;股票简称。 |\n| `time` | `integer\\|null` | 事件时间 | `1785463365000` | 固定返回;事件行情时点的 Unix 毫秒时间戳。 |\n| `event` | `integer` | 异动类型 | `5` | 固定返回;事件编号 1~12。 |\n| `tradedate` | `string\\|null` | 交易日期 | `20260731` | 日期格式:YYYYMMDD。 |\n| `servertime` | `string\\|null` | 行情时间 | `10:02:45` | 触发事件的行情时间,格式 HH:mm:ss。 |\n| `last_price` | `number\\|null` | 最新价(元) | `11.13` | 事件行情时点的最新成交价。 |\n| `limit_price` | `number\\|null` | 涨跌停价(元) | `11.13` | 与该事件方向对应的当日涨停价或跌停价。 |\n| `amount` | `number\\|null` | 累计成交额(元) | `1685000000` | 事件行情时点的当日累计成交额。 |\n| `turnover_rate` | `number\\|null` | 换手率(%) | `6.8123` | 事件行情时点按流通股本计算的换手率。 |\n| `fd_amount` | `number\\|null` | 封单额(元) | `89200000` | 事件行情时点对应涨跌停价一档的封单金额。 |\n| `trade_amount_3s` | `number\\|null` | 3 秒成交额增量(元) | `12000000` | 当前累计成交额减去同一交易时段 3 秒前累计成交额;仅相关事件有值。 |\n| `fd_decrease_12s` | `number\\|null` | 12 秒封单减少额(元) | `22000000` | 同一交易时段 12 秒前封单额减去当前封单额;仅相关事件有值。 |\n| `fd_decrease_rate_12s` | `number\\|null` | 12 秒封单减少比例 | `0.25` | 12 秒封单减少额除以当前封单额;仅相关事件有值。 |\n| `limit_times` | `integer\\|null` | 连续涨跌停天数 | `2` | 涨停方向为正、跌停方向为负。 |\n| `open_times` | `integer\\|null` | 当日开板次数 | `1` | 该方向已确认封板后被打开的累计次数。 |\n\n#### params\n\n| 参数 | 类型 | 是否必选 | 示例值 | 描述 |\n| --- | --- | --- | --- | --- |\n| `symbols` | `string[]` | 可选 | `[]` | 限定股票范围;置空且不传 `groups` 时订阅全市场。 |\n| `groups` | `string[]` | 可选 | `[\"@HS300\"]` | 限定快捷股票池;可与 `symbols` 同时使用。 |\n| `event_types` | `integer[]` | 可选 | `[1,3,5]` | 限定事件编号;不传或传空数组时订阅全部 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%。 |\n| `ttl_seconds` | `integer` | 可选 | `120` | 票据有效期,默认 120 秒,取值范围 30~600 秒。 |","required":true}
响应
{"200":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"业务状态码,200 表示成功","example":200,"type":"integer"},"data":{"description":"涨跌停异动订阅票据返回数据","nullable":true,"properties":{"channel":{"description":"频道名","example":"tick_stream","type":"string"},"expires_at":{"description":"票据过期时间(Unix 时间戳,秒)","example":1740800000,"type":"integer"},"stream_version":{"description":"实时推送协议版本,固定为 stream_limit_event_v2","example":"stream_limit_event_v2","type":"string"},"subscription_plan_code":{"description":"本次连接使用的 tick 订阅套餐代码","example":"professional_year","type":"string"},"tick_sub_limit":{"description":"本次连接对应套餐的 tick 订阅槽位上限","example":6000,"type":"integer"},"ttl_seconds":{"description":"票据有效期(秒)","example":120,"type":"integer"},"url":{"description":"可直接连接的涨跌停异动 WebSocket 地址,已包含 ticket 参数","example":"wss://meoz.cn/api/stream_limit_event_v2?ticket={ticket}","type":"string"}},"required":["channel","url","expires_at","ttl_seconds","subscription_plan_code","tick_sub_limit","stream_version"],"type":"object"},"message":{"description":"响应消息","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Successful Response"},"429":{"content":{"application/json":{"schema":{"properties":{"code":{"example":429,"type":"integer"},"data":{"example":null,"nullable":true},"message":{"example":"请求频率超限:daily_auc_detail 接口的调用上限为 3 次/秒,请降低该接口的调用频率,建议 1 秒后重试。","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"账户总调用频率或单个重接口调用频率超过当前套餐限额。","headers":{"Retry-After":{"description":"建议等待后重试的秒数。","schema":{"minimum":1,"type":"integer"}}}}}