親愛的用戶：

為持續提升合約交易服務品質，我們計劃對合約系統 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日