可转债分笔历史接口文档

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

请求参数

• apiname（string（tick_history），必选）：固定接口名称，用于选择对应的数据能力。
• apikey（string，必选）：猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。
• fields（string|null，可选）：需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。
• params（any，必选）：查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。
• asset（string（convertible），可选）：资产类型，固定为 convertible。
• symbol（string，单标的模式必选）：单个可转债代码。默认请求使用该参数并走兼容查询；不传 tradedate 时查询最新交易日。与 symbols 同时传时，以 symbols 为准。
• symbols（string|array<string>，增强明细必选）：增强查询的一个或多个可转债代码，支持英文逗号分隔字符串或数组，最多 200 个；边界快照模式不传时查询该资产全市场。与 symbol 同时传时，以 symbols 为准。
• tradedate（string，可选）：查询单个交易日，格式：YYYYMMDD；不能与 startdate/enddate 同时传。不传任何日期参数时默认最新交易日。
• startdate（string，可选）：查询区间开始日期，格式：YYYYMMDD；仅传该参数时查询至最新交易日。 普通历史明细的日期范围跨月时，只查询结束日期所在月份：开始日期调整为该月第一天，结束日期不变；同月和单日范围不变。例如 20241225–20250403 实际查询 20250401–20250403；成功或无数据响应的 message 会说明请求和实际范围。需要完整跨月数据时，请按月分别请求并合并，分页也在各月内进行；结束月份无数据时不回退到其他月份。
• enddate（string，可选）：查询区间结束日期，格式：YYYYMMDD；仅传该参数时按该交易日查询。 跨月时保留该结束日期，仅调整开始日期至结束月份第一天。
• recentdays（integer，可选）：最近 N 个交易日覆盖的日期区间。不能与 tradedate/startdate/enddate 同时传。 解析出的范围跨月时，仅查询结束月份第一天至结束日期，实际返回可能不足 N 个交易日。
• tradedate_offset（integer，可选）：相对最新交易日的单日偏移，0 表示最新交易日，-1 表示上一交易日。
• order_dir（string（asc / desc），可选）：普通明细按交易日期和快照时间排序，asc=升序、desc=降序。
• limit（integer，可选）：增强查询返回行数，默认 6000，最大 6000；旧版单标的单日查询不设置默认 limit。
• offset（integer，可选）：增强查询偏移量，用于分页。
• trademin（string，边界快照必选）：交易分钟，格式 HHMM。单独传入时返回该整分钟 [HH:MM:00, 下一分钟) 的明细；与 side 同传时作为边界时点。
• side（string（before / after），边界快照必选）：边界快照方向，仅支持单个交易日。before 取严格早于分钟边界的最后一条；after 取等于或晚于边界的第一条。
• start_time（string，可选）：普通明细的起始时间，格式 HH:MM:SS 或 HH:MM:SS.mmm，包含该边界；不能与 trademin 同时传。
• end_time（string，可选）：普通明细的结束时间，格式 HH:MM:SS 或 HH:MM:SS.mmm，不包含该边界；不能与 trademin 同时传。

返回字段

• tradedate（string）：日期格式：YYYYMMDD。
• symbol（string）：6 位可转债代码，不含交易所后缀。
• time（string）：格式：YYYY-MM-DD HH:mm:ss.SSS。
• open（number|null）：当日开盘价或点位。
• high（number|null）：当日截至该快照的最高价或点位。
• low（number|null）：当日截至该快照的最低价或点位。
• close（number|null）：该快照的最新成交价或点位。
• pre_close（number|null）：兼容字段，固定为 null。
• pct_chg（number|null）：兼容字段，固定为 null。
• vol（number|null）：当日截至该快照的累计成交量。
• amount（number|null）：当日截至该快照的累计成交额。
• transaction_num（integer|null）：行情源截至该快照的累计成交笔数；非本快照成交笔数，缺失时为 null。
• bid1（number|null）：买一档价格或点位。
• bid2（number|null）：买二档价格或点位。
• bid3（number|null）：买三档价格或点位。
• bid4（number|null）：买四档价格或点位。
• bid5（number|null）：买五档价格或点位。
• ask1（number|null）：卖一档价格或点位。
• ask2（number|null）：卖二档价格或点位。
• ask3（number|null）：卖三档价格或点位。
• ask4（number|null）：卖四档价格或点位。
• ask5（number|null）：卖五档价格或点位。
• bid_vol1（number|null）：买一档委托量。
• bid_vol2（number|null）：买二档委托量。
• bid_vol3（number|null）：买三档委托量。
• bid_vol4（number|null）：买四档委托量。
• bid_vol5（number|null）：买五档委托量。
• ask_vol1（number|null）：卖一档委托量。
• ask_vol2（number|null）：卖二档委托量。
• ask_vol3（number|null）：卖三档委托量。
• ask_vol4（number|null）：卖四档委托量。
• ask_vol5（number|null）：卖五档委托量。