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