猫爪数据
猫爪数据
逐笔历史

Level2十档盘口接口文档

接口文档数据浏览

查询单只股票单日 Level-2 十档盘口快照，按时间顺序游标分页返回。9:25 前买卖一档价量包含集合竞价拟合信息，不应直接按连续竞价盘口解释。 套餐权限：免费版和标准版不可用；体验版可查询全部历史，但每个逐笔历史接口分别限 100 次/日；专业版可查询最近 30 个交易日（含第 30 个交易日）；旗舰版可查询全部历史。交易日范围按北京时间和交易日历计算。 每账号每接口只允许一个进行中请求，JSON和Parquet共用名额，跨API Key与Pod生效；重复请求返回503，不排队，不再施加这三个接口的带宽限速。Parquet文件额度按北京时间每日、每接口独立计算：旗舰版300次，专业版与周卡30次；请求获准处理即扣一次，失败重试与重复下载也重新计次，额度耗尽返回429。原有API调用额度及秒级限制仍生效。

POST/apiapiname:level2_quote_history
生产专线（默认）深圳http://sz.numcat.net:8866/api上海http://sh.numcat.net:8866/api公网备用https://numcat.net/api

请求参数

参数类型是否必选示例值描述
apinamestring（level2_quote_history）必选level2_quote_history固定接口名称，用于选择对应的数据能力。
apikeystring必选—猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。
fieldsstring|null可选symbol,tradedate,time,close,volume,amount,bid1,bid_vol1,ask1,ask_vol1需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。
paramsobject必选{"symbol":"000001","tradedate":"20260617","page_size":10000}查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。

params 参数

参数类型是否必选示例值描述
symbolstring必选000001单只股票代码，支持 6 位代码或带交易所后缀代码。Level-2 明细接口不支持一次查询多只股票。
tradedatestring可选20260617可选交易日期，格式：YYYYMMDD；不填时与 daily 一致，取交易日历最新交易日。只查询单日；当日未入库则返回无数据，不自动回退。
formatstring（json / parquet）可选jsonjson 保留分页；parquet 直接返回单股单日 Parquet+ZSTD 文件，不支持 cursor、page_size、limit、start_time、end_time，不落盘缓存、不支持断点续传。
start_timestring可选09:30:00可选开始时间，支持 HH:MM、HH:MM:SS、HHMMSS 或 HHMMSSmmm。需要毫秒精度时再传 9 位 HHMMSSmmm。
end_timestring可选10:00:00可选结束时间，支持 HH:MM、HH:MM:SS、HHMMSS 或 HHMMSSmmm。需要毫秒精度时再传 9 位 HHMMSSmmm。
page_sizeinteger可选10000每页返回行数。默认且最大为 10000；传入更大值时服务端自动按 10000 返回。
cursorstring|null可选eyJ0aW1lIjo5MTUwMDAwMH0游标分页参数。第一页不传；后续请求传上一页返回的 next_cursor。新游标固定首次查询日期，跨日翻页不改变日期；显式日期必须与游标一致。旧游标需同时填写原交易日。响应 data.tradedate 为实际查询日期。返回 has_more=false 或 next_cursor=null 表示已经结束。

fields 返回字段

字段顺序与接口样例保持一致
字段类型名称示例值描述
symbolstring——股票代码
tradedatestring——交易日期 YYYYMMDD
timestring——快照时间，格式 HHMMSSmmm
opennumber|null——开盘价，单位：元
highnumber|null——最高价，单位：元
lownumber|null——最低价，单位：元
closenumber|null——最新价，单位：元
pre_closenumber|null——昨收价，单位：元
volumenumber|null——累计成交量，单位：股/份
amountnumber|null——累计成交额，单位：元
bid1number|null——买1档价格，单位：元
ask1number|null——卖1档价格，单位：元
bid2number|null——买2档价格，单位：元
ask2number|null——卖2档价格，单位：元
bid3number|null——买3档价格，单位：元
ask3number|null——卖3档价格，单位：元
bid4number|null——买4档价格，单位：元
ask4number|null——卖4档价格，单位：元
bid5number|null——买5档价格，单位：元
ask5number|null——卖5档价格，单位：元
bid6number|null——买6档价格，单位：元
ask6number|null——卖6档价格，单位：元
bid7number|null——买7档价格，单位：元
ask7number|null——卖7档价格，单位：元
bid8number|null——买8档价格，单位：元
ask8number|null——卖8档价格，单位：元
bid9number|null——买9档价格，单位：元
ask9number|null——卖9档价格，单位：元
bid10number|null——买10档价格，单位：元
ask10number|null——卖10档价格，单位：元
bid_vol1number|null——买1档挂单量，单位：股/份
ask_vol1number|null——卖1档挂单量，单位：股/份
bid_vol2number|null——买2档挂单量，单位：股/份
ask_vol2number|null——卖2档挂单量，单位：股/份
bid_vol3number|null——买3档挂单量，单位：股/份
ask_vol3number|null——卖3档挂单量，单位：股/份
bid_vol4number|null——买4档挂单量，单位：股/份
ask_vol4number|null——卖4档挂单量，单位：股/份
bid_vol5number|null——买5档挂单量，单位：股/份
ask_vol5number|null——卖5档挂单量，单位：股/份
bid_vol6number|null——买6档挂单量，单位：股/份
ask_vol6number|null——卖6档挂单量，单位：股/份
bid_vol7number|null——买7档挂单量，单位：股/份
ask_vol7number|null——卖7档挂单量，单位：股/份
bid_vol8number|null——买8档挂单量，单位：股/份
ask_vol8number|null——卖8档挂单量，单位：股/份
bid_vol9number|null——买9档挂单量，单位：股/份
ask_vol9number|null——卖9档挂单量，单位：股/份
bid_vol10number|null——买10档挂单量，单位：股/份
ask_vol10number|null——卖10档挂单量，单位：股/份

请求与响应样例

{
  "apiname": "level2_quote_history",
  "apikey": "YOUR_API_KEY",
  "fields": "symbol,tradedate,time,close,volume,amount,bid1,bid_vol1,ask1,ask_vol1",
  "params": {
    "symbol": "000001",
    "tradedate": "20260617",
    "page_size": 10000
  }
}

相关接口

文件下载
file_download
逐笔成交
level2_trade_history
逐笔委托
level2_order_history
风险声明：猫爪数据提供的数据与接口仅用于学习、研究和程序开发，不构成任何投资建议。金融市场存在风险，请独立判断并自行承担使用结果。