Level2逐笔成交接口文档

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

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

请求参数

• apiname（string（level2_trade_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。
• trade_id（integer）：源 CSV 的成交编号；不是委托编号，不保证全局唯一。当前接口按整数返回。
• trade_code（string）：保留源 CSV 的记录类型代码，用于区分成交、撤单等；统计实际成交前需按市场规则筛选。
• order_code（string）：源 CSV 的独立字段，原样保留；不与 trade_code 或 bs_flag 合并，具体含义按市场及记录类型解释。
• bs_flag（string）：保留源文件标志，具体含义按市场和记录类型解释；空值不补填。
• bid_order_id（integer）：源 CSV 的叫买序号，允许为 0。与委托关联需结合市场、证券、日期及 exchange_order_id，不保证逐条匹配。兼容名称 buy_order_id 可显式请求并保留请求名。
• ask_order_id（integer）：源 CSV 的叫卖序号，允许为 0。与买方委托序号分别保留。兼容名称 sell_order_id 可显式请求并保留请求名。
• price（number）：原始价格除以 10000；撤单记录不能当作普通成交价格解释。
• volume（integer）：源 CSV 的记录数量，应区分成交数量与撤单数量。
• amount（number）：接口按 price × volume 计算，并非原包独立字段；不代表每条都是实际成交额。