明细数据股票逐笔历史

Level2十档盘口接口文档

查询单只股票单日 Level-2 十档盘口快照,按时间顺序游标分页返回。9:25 前买卖一档价量包含集合竞价拟合信息,不应直接按连续竞价盘口解释。 套餐权限:免费版和标准版不可用;体验版可查询全部历史,但每个逐笔历史接口分别限 100 次/日;专业版可查询最近 30 个自然日(含今天);旗舰版可查询全部历史。日期范围按

接口参数与返回字段速查

查询单只股票单日 Level-2 十档盘口快照,按时间顺序游标分页返回。9:25 前买卖一档价量包含集合竞价拟合信息,不应直接按连续竞价盘口解释。 套餐权限:免费版和标准版不可用;体验版可查询全部历史,但每个逐笔历史接口分别限 100 次/日;专业版可查询最近 30 个自然日(含今天);旗舰版可查询全部历史。日期范围按北京时间计算,周末和节假日计入30天,不向前补足交易日。 仅查询已发布的数据;必须显式传 tradedate。

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

请求参数

  • apiname(string(level2_quote_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
  • open(number|null):开盘价,单位:元
  • high(number|null):最高价,单位:元
  • low(number|null):最低价,单位:元
  • close(number|null):最新价,单位:元
  • pre_close(number|null):昨收价,单位:元
  • volume(number|null):累计成交量,单位:股/份
  • amount(number|null):累计成交额,单位:元
  • bid1(number|null):买1档价格,单位:元
  • ask1(number|null):卖1档价格,单位:元
  • bid2(number|null):买2档价格,单位:元
  • ask2(number|null):卖2档价格,单位:元
  • bid3(number|null):买3档价格,单位:元
  • ask3(number|null):卖3档价格,单位:元
  • bid4(number|null):买4档价格,单位:元
  • ask4(number|null):卖4档价格,单位:元
  • bid5(number|null):买5档价格,单位:元
  • ask5(number|null):卖5档价格,单位:元
  • bid6(number|null):买6档价格,单位:元
  • ask6(number|null):卖6档价格,单位:元
  • bid7(number|null):买7档价格,单位:元
  • ask7(number|null):卖7档价格,单位:元
  • bid8(number|null):买8档价格,单位:元
  • ask8(number|null):卖8档价格,单位:元
  • bid9(number|null):买9档价格,单位:元
  • ask9(number|null):卖9档价格,单位:元
  • bid10(number|null):买10档价格,单位:元
  • ask10(number|null):卖10档价格,单位:元
  • bid_vol1(number|null):买1档挂单量,单位:股/份
  • ask_vol1(number|null):卖1档挂单量,单位:股/份
  • bid_vol2(number|null):买2档挂单量,单位:股/份
  • ask_vol2(number|null):卖2档挂单量,单位:股/份
  • bid_vol3(number|null):买3档挂单量,单位:股/份
  • ask_vol3(number|null):卖3档挂单量,单位:股/份
  • bid_vol4(number|null):买4档挂单量,单位:股/份
  • ask_vol4(number|null):卖4档挂单量,单位:股/份
  • bid_vol5(number|null):买5档挂单量,单位:股/份
  • ask_vol5(number|null):卖5档挂单量,单位:股/份
  • bid_vol6(number|null):买6档挂单量,单位:股/份
  • ask_vol6(number|null):卖6档挂单量,单位:股/份
  • bid_vol7(number|null):买7档挂单量,单位:股/份
  • ask_vol7(number|null):卖7档挂单量,单位:股/份
  • bid_vol8(number|null):买8档挂单量,单位:股/份
  • ask_vol8(number|null):卖8档挂单量,单位:股/份
  • bid_vol9(number|null):买9档挂单量,单位:股/份
  • ask_vol9(number|null):卖9档挂单量,单位:股/份
  • bid_vol10(number|null):买10档挂单量,单位:股/份
  • ask_vol10(number|null):卖10档挂单量,单位:股/份