尊敬的火币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 能力。

四、迁移指引（建议参考）

• 创建测试子账号
• 建议通过现有母账户创建子账号用于迁移调试
• 调用 /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 小时支持
• 通过官网的“帮助中心”或者发送邮件至[email protected]联系客服

感谢您对HTX的支持与理解！如有任何疑问，请随时联系我们的客服团队。

火币HTX团队

2026年5月26日