Level2逐笔委托接口文档

查询单只证券、单个交易日的逐笔委托记录，包含新增委托、撤单及交易阶段标志，支持时间范围筛选和游标分页。保留原始委托编号、交易所委托号及原始类型代码。两个编号均可为 0，不互相补填。默认返回标准字段；旧名称 order_no、side 仍可通过 fields 显式请求并保留请求名。 套餐权限：免费版和标准版不可用；体验版可查询全部历史，但每个逐笔历史接口分别限 100 次/日；专业版可查询最近 30 个自然日（含今天）；旗舰版可查询全部历史。日期范围按北京时间计算，周末和节假日计入30天，不向前补足交易日。 仅查询已发布的数据；必须显式传 tradedate。

按数据验收结果发布；盘中已验收批次也可查询。

请求参数

• apiname（string（level2_order_history），必选）：固定接口名称，用于选择对应的数据能力。
• apikey（string，必选）：猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。
• fields（string|null，可选）：需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。
• params（object，必选）：查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。
• symbol（string，必选）：单只股票代码，支持 6 位代码或带交易所后缀代码。Level-2 明细接口不支持一次查询多只股票。
• tradedate（string，必选）：历史服务必填交易日期，支持 YYYYMMDD。
• format（string（json / parquet），可选）：json 保留分页；parquet 直接返回单股单日 Parquet+ZSTD 文件，不支持 cursor、page_size、limit、start_time、end_time，不落盘缓存、不支持断点续传。
• start_time（string，可选）：可选开始时间，支持 HH:MM、HH:MM:SS、HHMMSS 或 HHMMSSmmm。需要毫秒精度时再传 9 位 HHMMSSmmm。
• end_time（string，可选）：可选结束时间，支持 HH:MM、HH:MM:SS、HHMMSS 或 HHMMSSmmm。需要毫秒精度时再传 9 位 HHMMSSmmm。
• page_size（integer，可选）：每页返回行数。默认且最大为 10000；传入更大值时服务端自动按 10000 返回。
• cursor（string|null，可选）：后续请求原样传上一页的 next_cursor，并继续显式填写与第一页相同的 tradedate、证券代码和时间范围。

返回字段

• symbol（string）：六位证券代码。
• tradedate（string）：日期格式：YYYYMMDD。
• time（string）：格式 HHMMSSmmm，例如 093000123 表示 09:30:00.123。
• order_id（integer）：源 CSV 的委托编号，可为 0；原样保留，不使用交易所委托号补填，不保证唯一。
• exchange_order_id（integer）：源 CSV 的交易所委托号，与 order_id 是不同字段；结合市场、证券和日期使用，不保证全局唯一。阶段标志记录可为 0。兼容名称 order_no 可显式请求并保留请求名。
• order_type（string）：沪市 A 为新增委托、D 为撤单、S 为阶段标志；深圳 0 为限价、1 为市价、U 为本方最优。数字代码也按字符串返回；不保证每日出现所有类型。
• order_code（string）：源 CSV 的委托代码，可能表示买卖或交易阶段，不能统一解释为买卖方向。兼容名称 side 可显式请求并保留请求名。
• price（number）：原始价格除以 10000；阶段标志记录可为 0。
• volume（integer）：源 CSV 的委托数量，阶段标志记录可为 0。
• amount（number）：接口按 price × volume 计算，并非原包独立字段；阶段标志记录可为 0。