可转债分笔历史接口文档

查询可转债历史 Tick 快照序列；增强模式支持多标的、日期范围、整分钟、时间段、分页以及指定分钟前后的每只转债边界快照。 仅查询已发布的数据；必须显式传 tradedate，也可同时传 startdate、enddate 查询范围。

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

请求参数

• apiname（string（tick_history），必选）：固定接口名称，用于选择对应的数据能力。
• apikey（string，必选）：猫爪数据 API Key。网页在线调试会为已登录用户自动注入，其他调用请从控制台获取。
• fields（string|null，可选）：需要返回的字段列表，多个字段使用英文逗号分隔；可选字段见下方返回字段表。
• params（any，必选）：查询条件对象；具体参数、格式和互斥关系见下方 params 参数表。
• asset（string（convertible），可选）：资产类型，固定为 convertible。
• symbol（string，单标的模式必选）：单只证券代码；历史查询仍须同时指定日期。
• symbols（string|array<string>，增强明细必选）：证券代码列表；历史查询仍须同时指定日期或日期范围。在线调试建议只填一只。
• tradedate（string，必选（或 startdate+enddate））：历史服务必须显式传交易日期；范围查询可改为同时传 startdate 和 enddate。格式 YYYYMMDD。
• startdate（string，可选）：日期范围起点，格式 YYYYMMDD；必须与 enddate 同时传，且不能与 tradedate 同时传。跨月范围以接口实际返回的日期为准。
• enddate（string，可选）：日期范围终点，格式 YYYYMMDD；必须与 startdate 同时传，且不能与 tradedate 同时传。
• 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）：卖五档委托量。