查询单只证券、单个交易日的逐笔委托记录，包含新增委托、撤单及交易阶段标志，支持时间范围筛选和游标分页。保留原始委托编号、交易所委托号及原始类型代码。两个编号均可为 0，不互相补填。默认返回标准字段；旧名称 order_no、side 仍可通过 fields 显式请求并保留请求名。 套餐权限：免费版和标准版不可用；体验版可查询全部历史，但每个逐笔历史接口分别限 100 次/日；专业版可查询最近 30 个交易日（含第 30 个交易日）；旗舰版可查询全部历史。交易日范围按北京时间和交易日历计算。 每账号每接口只允许一个进行中请求，JSON和Parquet共用名额，跨API Key与Pod生效；重复请求返回503，不排队，不再施加这三个接口的带宽限速。Parquet文件额度按北京时间每日、每接口独立计算：旗舰版300次，专业版与周卡30次；请求获准处理即扣一次，失败重试与重复下载也重新计次，额度耗尽返回429。原有API调用额度及秒级限制仍生效。
POST
/apiapiname:level2_order_history生产专线（默认）深圳
http://sz.numcat.net:8866/api上海http://sh.numcat.net:8866/api公网备用https://numcat.net/api请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
apiname | string（level2_order_history） | 必选 | level2_order_history | 固定接口名称，用于选择对应的数据能力。 |
apikey | string | 必选 | — | 猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。 |
fields | string|null | 可选 | symbol,tradedate,time,order_id,exchange_order_id,order_type,order_code,price,volume,amount | 需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。 |
params | object | 必选 | {"symbol":"000001","tradedate":"20260617","page_size":10000} | 查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。 |
params 参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
symbol | string | 必选 | 000001 | 单只股票代码，支持 6 位代码或带交易所后缀代码。Level-2 明细接口不支持一次查询多只股票。 |
tradedate | string | 可选 | 20260617 | 可选交易日期，格式：YYYYMMDD；不填时与 daily 一致，取交易日历最新交易日。只查询单日；当日未入库则返回无数据，不自动回退。 |
format | string（json / parquet） | 可选 | json | json 保留分页；parquet 直接返回单股单日 Parquet+ZSTD 文件，不支持 cursor、page_size、limit、start_time、end_time，不落盘缓存、不支持断点续传。 |
start_time | string | 可选 | 09:30:00 | 可选开始时间，支持 HH:MM、HH:MM:SS、HHMMSS 或 HHMMSSmmm。需要毫秒精度时再传 9 位 HHMMSSmmm。 |
end_time | string | 可选 | 10:00:00 | 可选结束时间，支持 HH:MM、HH:MM:SS、HHMMSS 或 HHMMSSmmm。需要毫秒精度时再传 9 位 HHMMSSmmm。 |
page_size | integer | 可选 | 10000 | 每页返回行数。默认且最大为 10000；传入更大值时服务端自动按 10000 返回。 |
cursor | string|null | 可选 | eyJ2Ijoib3JkZXItdGltZS1vZmZzZXQtMSIsInRpbWUiOjkxNTAwMDAwLCJvZmZzZXQiOjF9 | 第一页不传；后续原样传 next_cursor，无需解析。新游标固定首次查询日期；省略日期仍沿用首次日期，显式日期须一致。不带日期的时间偏移游标需填写原日期。按时间及同一毫秒内已读条数续取，不依赖委托编号唯一或非零。翻页期间保持证券、日期和时间范围不变；数据重建后须重新开始。旧版游标返回业务 code=422，请清空 cursor 从第一页查询。has_more=false 表示结束。 |
fields 返回字段
字段顺序与接口样例保持一致| 字段 | 类型 | 名称 | 示例值 | 描述 |
|---|---|---|---|---|
symbol | string | 证券代码 | 000001 | 六位证券代码。 |
tradedate | string | 交易日期 | 20260617 | 日期格式：YYYYMMDD。 |
time | string | 记录时间 | 093000123 | 格式 HHMMSSmmm，例如 093000123 表示 09:30:00.123。 |
order_id | integer | 原始委托编号 | 0 | 源 CSV 的委托编号，可为 0；原样保留，不使用交易所委托号补填，不保证唯一。 |
exchange_order_id | integer | 交易所委托号 | 46 | 源 CSV 的交易所委托号，与 order_id 是不同字段；结合市场、证券和日期使用，不保证全局唯一。阶段标志记录可为 0。兼容名称 order_no 可显式请求并保留请求名。 |
order_type | string | 委托类型 | 0 | 沪市 A 为新增委托、D 为撤单、S 为阶段标志；深圳 0 为限价、1 为市价、U 为本方最优。数字代码也按字符串返回；不保证每日出现所有类型。 |
order_code | string | 委托代码 | B | 源 CSV 的委托代码，可能表示买卖或交易阶段，不能统一解释为买卖方向。兼容名称 side 可显式请求并保留请求名。 |
price | number | 委托价格（元） | 12 | 原始价格除以 10000；阶段标志记录可为 0。 |
volume | integer | 委托数量（股／份） | 200 | 源 CSV 的委托数量，阶段标志记录可为 0。 |
amount | number | 委托金额（元） | 2400 | 接口按 price × volume 计算，并非原包独立字段；阶段标志记录可为 0。 |
请求与响应样例
固定样例
{
"apiname": "level2_order_history",
"apikey": "YOUR_API_KEY",
"fields": "symbol,tradedate,time,order_id,exchange_order_id,order_type,order_code,price,volume,amount",
"params": {
"symbol": "000001",
"tradedate": "20260617",
"page_size": 10000
}
}{
"code": 200,
"message": "success",
"data": {
"fields": [
"symbol",
"tradedate",
"time",
"order_id",
"exchange_order_id",
"order_type",
"order_code",
"price",
"volume",
"amount"
],
"items": [
[
"000001",
"20260617",
"093000123",
0,
46,
"0",
"B",
12,
200,
2400
]
],
"tradedate": "20260617",
"page_size": 10000,
"next_cursor": "eyJ2Ijoib3JkZXItdGltZS1vZmZzZXQtMSIsInRpbWUiOjkxNTAwMDAwLCJvZmZzZXQiOjF9",
"has_more": true
}
}