尊敬的火币HTX用户：
为持续提升合约交易服务质量，我们计划对合约系统 API 进行升级与迁移。本次升级是对核心交易基础架构的全面重构，旨在为用户提供更高性能、更稳定、更规范的 API 服务体验。现将相关事项公告如下:
一、迁移时间
迁移开始时间：2026年05月26日 16:00:00 (UTC+8)
迁移截止时间：2026年07月13日 23:59:59 (UTC+8)
请注意：迁移截止后，旧版 API将停止服务，未完成迁移的账户将无法进行下单、撤单等交易操作，请您务必提前安排迁移计划。（已升级为联合保证金模式的账户不受影响）。
二、迁移范围
本次升级涉及除行情类以外的所有接口均需重新对接(包含跟单)，包括但不限于：
账户类（资产、余额等）
订单类（下单、撤单、查询等）
持仓类（当前持仓、持仓限额等）
策略/条件单
基础信息等相关接口
新的接口文档地址：https://www.htx.com/zh-cn/opend/newApiPages/?id=5521
旧版接口文档地址：https://www.htx.com/zh-cn/opend/newApiPages/?id=504
三、优化说明
本次 API 升级将为开发者与交易用户带来以下优化：
接口架构精简：对接口体系进行了系统性梳理与整合，核心接口数量大幅减少，降低接入复杂度，提升可维护性与易用性。
交易性能提升：对下单、撤单、成交及清算等核心链路进行了深度优化，在高并发行情下具备更低延迟与更高吞吐能力，交易响应更加稳定高效。
数据一致性增强：统一账户、持仓及成交数据结构，减少不同接口间的数据差异，便于开发者进行多维度数据处理与整合。
风控模型统一：统一保证金计算、风险指标及标记价格逻辑，提升风控规则的一致性与可预期性，帮助用户更准确地进行风险评估与策略建模。
接口规范升级：接口命名与参数结构更加统一清晰，认证方式更加规范，文档结构同步优化，提升接入效率与兼容性。
扩展能力增强：升级后的架构为后续交易功能与量化能力扩展提供了更强支撑，未来将持续迭代，提供更丰富的 API 能力。
温馨提示：升级完成后，部分交易逻辑及计算公式将同步调整，请您关注《关于火币HTX U本位合约交易系统升级迁移的公告》，及时评估相关策略参数校准。
四、迁移指引（建议参考）
创建测试子账号
建议通过现有母账户创建子账号用于迁移调试
调用 /v5/account/asset_mode 接口升级子账号为新单币种保证金模式（asset_mode=2）或联合保证金模式（asset_mode=1）
接口适配
按照最新 API 文档调整请求路径、参数及签名方式
核心接口验证:(下单 / 撤单、持仓查询、账户资产查询、成交回报等)
说明事项：
1.完成模式升级（asset_mode=1 / asset_mode=2）的账户，其私有接口（交易、账户、持仓等） 仅可通过 V5 版本调用，旧版本私有接口将无法使用2.请优先完成下单/撤单/持仓/资产等核心接口的迁移与回归。建议尽早启动，避免截止前集中切换造成业务影响。
五、支持渠道
如在迁移过程中遇到问题，可通过以下任一方式获取支持：
Telegram 技术支持群：https://t.me/htx_api
在线客服：7×24 小时支持
通过官网的“帮助中心”或者发送邮件至htxsupport@htx-inc.com联系客服
感谢您对HTX的支持与理解！如有任何疑问，请随时联系我们的客服团队。
火币HTX团队
2026年5月26日