分笔行情

可转债分笔历史接口文档

查询可转债历史 Tick 快照序列；增强模式支持多标的、日期范围、整分钟、时间段、分页以及指定分钟前后的每只转债边界快照。

POST/apiapiname:tick_history

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

请求参数

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

`params` 参数

参数	类型	是否必选	示例值	描述
`asset`	string（convertible）	可选	`convertible`	资产类型，固定为 convertible。
`symbol`	string	单标的模式必选	`123196`	单个可转债代码。默认请求使用该参数并走兼容查询；不传 tradedate 时查询最新交易日。与 symbols 同时传时，以 symbols 为准。
`symbols`	string\|array<string>	增强明细必选	`123196,110073`	增强查询的一个或多个可转债代码，支持英文逗号分隔字符串或数组，最多 200 个；边界快照模式不传时查询该资产全市场。与 symbol 同时传时，以 symbols 为准。
`tradedate`	string	可选	`20260724`	查询单个交易日，格式：YYYYMMDD；不能与 startdate/enddate 同时传。不传任何日期参数时默认最新交易日。
`startdate`	string	可选	`20260701`	查询区间开始日期，格式：YYYYMMDD；仅传该参数时查询至最新交易日。
`enddate`	string	可选	`20260724`	查询区间结束日期，格式：YYYYMMDD；仅传该参数时按该交易日查询。
`recentdays`	integer	可选	`5`	最近 N 个交易日覆盖的日期区间。不能与 tradedate/startdate/enddate 同时传。
`tradedate_offset`	integer	可选	`-1`	相对最新交易日的单日偏移，0 表示最新交易日，-1 表示上一交易日。
`order_dir`	string（asc / desc）	可选	`asc`	普通明细按交易日期和快照时间排序，asc=升序、desc=降序。
`limit`	integer	可选	`6000`	增强查询返回行数，默认 6000，最大 6000；旧版单标的单日查询不设置默认 limit。
`offset`	integer	可选	`0`	增强查询偏移量，用于分页。
`trademin`	string	边界快照必选	`0930`	交易分钟，格式 HHMM。单独传入时返回该整分钟 [HH:MM:00, 下一分钟) 的明细；与 side 同传时作为边界时点。
`side`	string（before / after）	边界快照必选	`after`	边界快照方向，仅支持单个交易日。before 取严格早于分钟边界的最后一条；after 取等于或晚于边界的第一条。
`start_time`	string	可选	`09:30:00`	普通明细的起始时间，格式 HH:MM:SS 或 HH:MM:SS.mmm，包含该边界；不能与 trademin 同时传。
`end_time`	string	可选	`10:00:00`	普通明细的结束时间，格式 HH:MM:SS 或 HH:MM:SS.mmm，不包含该边界；不能与 trademin 同时传。

`fields` 返回字段

字段顺序与接口样例保持一致

字段	类型	名称	示例值	描述
`tradedate`	string	交易日期	`20260724`	日期格式：YYYYMMDD。
`symbol`	string	标的代码	`123196`	6 位可转债代码，不含交易所后缀。
`time`	string	快照时间	`2026-07-24 14:30:15.123`	格式：YYYY-MM-DD HH:mm:ss.SSS。
`open`	number\|null	开盘价/点位	`129.1`	当日开盘价或点位。
`high`	number\|null	最高价/点位	`131.25`	当日截至该快照的最高价或点位。
`low`	number\|null	最低价/点位	`128.72`	当日截至该快照的最低价或点位。
`close`	number\|null	最新价/点位	`130.84`	该快照的最新成交价或点位。
`pre_close`	number\|null	昨收价/点位	`—`	兼容字段，固定为 null。
`pct_chg`	number\|null	涨跌幅（%）	`—`	兼容字段，固定为 null。
`vol`	number\|null	累计成交量	`356789`	当日截至该快照的累计成交量。
`amount`	number\|null	累计成交额（元）	`463219876.5`	当日截至该快照的累计成交额。
`transaction_num`	integer\|null	累计成交笔数	`57131`	行情源截至该快照的累计成交笔数；非本快照成交笔数，缺失时为 null。
`bid1`	number\|null	买一价/点位	`130.83`	买一档价格或点位。
`bid2`	number\|null	买二价/点位	`130.82`	买二档价格或点位。
`bid3`	number\|null	买三价/点位	`130.81`	买三档价格或点位。
`bid4`	number\|null	买四价/点位	`130.8`	买四档价格或点位。
`bid5`	number\|null	买五价/点位	`130.79`	买五档价格或点位。
`ask1`	number\|null	卖一价/点位	`130.85`	卖一档价格或点位。
`ask2`	number\|null	卖二价/点位	`130.86`	卖二档价格或点位。
`ask3`	number\|null	卖三价/点位	`130.87`	卖三档价格或点位。
`ask4`	number\|null	卖四价/点位	`130.88`	卖四档价格或点位。
`ask5`	number\|null	卖五价/点位	`130.89`	卖五档价格或点位。
`bid_vol1`	number\|null	买一量	`10000`	买一档委托量。
`bid_vol2`	number\|null	买二量	`11000`	买二档委托量。
`bid_vol3`	number\|null	买三量	`12000`	买三档委托量。
`bid_vol4`	number\|null	买四量	`13000`	买四档委托量。
`bid_vol5`	number\|null	买五量	`14000`	买五档委托量。
`ask_vol1`	number\|null	卖一量	`10000`	卖一档委托量。
`ask_vol2`	number\|null	卖二量	`11000`	卖二档委托量。
`ask_vol3`	number\|null	卖三量	`12000`	卖三档委托量。
`ask_vol4`	number\|null	卖四量	`13000`	卖四档委托量。
`ask_vol5`	number\|null	卖五量	`14000`	卖五档委托量。

请求与响应样例

固定样例

{
  "apiname": "tick_history",
  "apikey": "YOUR_API_KEY",
  "fields": "tradedate,symbol,time,close,vol,amount,transaction_num,bid1,ask1,bid_vol1,ask_vol1",
  "params": {
    "asset": "convertible",
    "symbol": "123196",
    "tradedate": "20260724"
  }
}

{
  "code": 200,
  "message": "success",
  "data": {
    "fields": [
      "tradedate",
      "symbol",
      "time",
      "close",
      "vol",
      "amount",
      "transaction_num",
      "bid1",
      "ask1",
      "bid_vol1",
      "ask_vol1"
    ],
    "items": [
      [
        "20260724",
        "123196",
        "2026-07-24 14:30:15.123",
        130.84,
        356789,
        463219876.5,
        57131,
        130.83,
        130.85,
        10000,
        10000
      ]
    ]
  }
}

请求参数

params 参数

fields 返回字段

请求与响应样例

相关接口

`params` 参数

`fields` 返回字段