查询由原始 Tick 重放生成的涨跌停异动 V2 历史事件，事件编号和字段口径与实时异动订阅一致。 09:25 集合竞价结果可产生 1=冲击涨停或 7=冲击跌停；连续封板 60 秒从 09:30 开始计算，最早于 09:31 产生 2 或 8。 结果按事件时间升序返回，单次最多 6000 条。
POST
/apiapiname:limit_event_v2_history生产专线（默认）深圳
http://sz.numcat.net:8866/api上海http://sh.numcat.net:8866/api公网备用https://numcat.net/api请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
apiname | string（limit_event_v2_history） | 必选 | limit_event_v2_history | 固定接口名称，用于选择对应的数据能力。 |
apikey | string | 必选 | — | 猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。 |
fields | string|null | 可选 | tradedate,symbol,name,time,event,servertime,last_price,limit_price,amount,turnover_rate,fd_amount,trade_amount_3s,fd_decrease_12s,fd_decrease_rate_12s,limit_times,open_times | 需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。 |
params | object | 可选 | {"symbols":"","event_types":[1,2,3,4],"tradedate":"20260803"} | 查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。 |
params 参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
symbols | string|array<string> | 可选 | — | 股票代码，支持单个、多个逗号分隔或数组；不传则默认全市场标的。 |
event_types | array<integer（1 / 2 / 3 / 4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12）> | 可选 | [1,2,3,4] | 限定异动事件编号；不传或传空数组时返回全部 12 类事件。 |
tradedate | string | 可选 | 20260724 | 查询单个交易日，格式：YYYYMMDD；不能与 startdate/enddate 同时传。不传 tradedate 时默认最新交易日。 |
startdate | string | 可选 | 20260701 | 查询区间开始日期，格式：YYYYMMDD；仅传该参数时查询至最新交易日。 |
enddate | string | 可选 | 20260724 | 查询区间结束日期，格式：YYYYMMDD；仅传该参数时按该交易日查询。 |
recentdays | integer | 可选 | 5 | 最近 N 个交易日覆盖的日期区间。不能与 tradedate/startdate/enddate 同时传。 |
fields 返回字段
字段顺序与接口样例保持一致| 字段 | 类型 | 名称 | 示例值 | 描述 |
|---|---|---|---|---|
tradedate | string|null | 交易日期 | 20260731 | 日期格式：YYYYMMDD。 |
symbol | string | 股票代码 | 000001.SZ | 带市场后缀的完整股票代码。 |
name | string | 股票名称 | 平安银行 | 股票简称。 |
time | integer | 事件时间 | 1785463365000 | 事件行情时点的 Unix 毫秒时间戳。 |
event | integer | 异动类型 | 5 | 事件编号 1～12，口径与实时异动订阅一致。 |
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 | 该方向已确认封板后被打开的累计次数。 |
请求与响应样例
固定样例
{
"apiname": "limit_event_v2_history",
"apikey": "YOUR_API_KEY",
"fields": "tradedate,symbol,name,time,event,servertime,last_price,limit_price,amount,turnover_rate,fd_amount,trade_amount_3s,fd_decrease_12s,fd_decrease_rate_12s,limit_times,open_times",
"params": {
"symbols": "",
"event_types": [
1,
2,
3,
4
],
"tradedate": "20260803"
}
}{
"code": 200,
"message": "success",
"data": {
"fields": [
"tradedate",
"symbol",
"name",
"time",
"event",
"servertime",
"last_price",
"limit_price",
"amount",
"turnover_rate",
"fd_amount",
"trade_amount_3s",
"fd_decrease_12s",
"fd_decrease_rate_12s",
"limit_times",
"open_times"
],
"items": [
[
"20260731",
"000001.SZ",
"平安银行",
1785463365000,
5,
"10:02:45",
11.13,
11.13,
1685000000,
6.8123,
89200000,
12000000,
22000000,
0.25,
2,
1
]
]
}
}