股票异动订阅接口文档
实时捕捉个股触板、封板、开板及成交与封单变化,帮助用户判断涨跌停强度和封板稳定性。 接口返回 WebSocket 连接票据;连接后按订阅确认消息中的 `fields` 顺序解析推送数据 `i`。
接口参数与返回字段速查
实时捕捉个股触板、封板、开板及成交与封单变化,帮助用户判断涨跌停强度和封板稳定性。 接口返回 WebSocket 连接票据;连接后按订阅确认消息中的 `fields` 顺序解析推送数据 `i`。
请求参数
apikey(string,必选):猫爪数据 API Key。网页在线调试会为已登录用户自动注入,其他调用请从控制台获取。channel(string(tick_stream),可选):实时推送通道,固定为 tick_stream。stream_version(string(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)>,可选):限定事件编号;不传或传空数组时订阅全部 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,可选):需要返回的字段列表,多个字段使用英文逗号分隔;可选字段见下方返回字段表。ttl_seconds(integer,可选):票据有效期(秒),取值范围 30~600。
返回字段
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(number|null):当前累计成交额减去同一交易时段 3 秒前累计成交额;仅相关事件有值。fd_decrease_12s(number|null):同一交易时段 12 秒前封单额减去当前封单额;仅相关事件有值。fd_decrease_rate_12s(number|null):12 秒封单减少额除以当前封单额;仅相关事件有值。limit_times(integer|null):涨停方向为正、跌停方向为负。open_times(integer|null):该方向已确认封板后被打开的累计次数。