FTLib
版本 v1.4 最后更新:2026-11-13

版本更新日志|API 变更与兼容性 - FTLib

本页记录 API 的行为变更、字段新增与弃用计划。向后兼容的字段新增会直接发布;破坏性变更会提升主版本并提前公告。

v1.4 · 2026-11-13

  • L2 历史逐笔新增 next_seq 与 has_more,统一游标分页。
  • 推送协议新增 resume.failed 错误消息,明确续传窗口不足时的处理方式。
  • K 线接口新增 factor 字段,返回本次复权使用的因子。
  • ETF 持仓接口补充 pcf_flag,用于标识现金替代方式。
  • 更新错误码文档,新增 42902 日配额错误。

v1.3 · 2026-09-18

  • 新增可转债条款查询,支持按日期还原历史转股价。
  • 行业板块成分接口支持 date 参数,返回历史有效成分。
  • 财务数据新增 as_of 参数,用于 point-in-time 查询。
  • 优化批量快照接口的代码数量上限与错误提示。

v1.2 · 2026-07-02

  • 推送通道拆分 quote.l2.book、quote.l2.trade 与 quote.l2.order。
  • 新增心跳协商字段 heartbeat_sec。
  • REST 响应统一补充 request_id。
  • 明确成交量单位:股票为股、可转债为张、基金为份。

v1.1 · 2026-05-20

  • 新增历史分时接口,按交易日查询。
  • K 线支持前复权与后复权,并返回 pre_close。
  • 新增交易日历接口。
  • 完善错误码与限流说明。

版本策略

变更类型与兼容性
变更类型示例版本处理
兼容新增新增字段、新增可选参数直接发布,不提升主版本
行为调整默认值变化、排序变化提前公告,必要时提供过渡期
破坏性变更字段重命名、路径调整提升主版本,旧版本保留过渡期
弃用字段或接口停止维护至少提前一个版本周期公告
订阅变更 生产系统升级前,建议在测试环境验证字段新增与默认值变化,并检查客户端是否对未知字段做了严格校验。