關於 HTX USDT 本位合約交易系統升級及遷移截止日期公告

09/03 19:30:16 (UTC+8)最新消息重要公告USDT 本位合約指南API公告

親愛的用戶:

為持續提升合約交易體驗,我們已對合約系統進行升級,本次升級是對核心交易的基礎服務全面重構,旨在為用戶提供更高性能、更穩定、更規範的交易服務體驗。

 

該項升級遷移工作已於 2026年4月 起陸續推進。截止時間為 2026年9月20日 00:00:00 (UTC+8),屆時以下帳戶的部分交易功能將受到影響,請盡快完成升級遷移:

  • API 用戶
  • 版本號低於 11.13 的普通合約交易用戶
  • 版本號低於 11.20 的合約網格、跟單用戶

此外,升級遷移完成後,部分交易邏輯及計算公式將同步調整,請及時評估並校準相關策略參數。

相關公告地址:《關於 HTX USDT 本位合約交易系統升級遷移的公告》

請注意:未完成遷移的帳戶部分下單及查詢功能將不可用,請您務必提前安排遷移計劃。(已升級為聯合保證金模式的帳戶不受影響)。

 

一、遷移範圍

  • 本次升級涉及除行情類以外的所有介面均需重新對接(包含跟單),包括但不限於:
    • 帳戶類(資產、餘額等)
    • 訂單類(下單、撤單、查詢等)
    • 持倉類(當前持倉、持倉限額等)
    • 策略/條件單
    • 基礎資訊等相關介面
  • 新版介面文件:https://www.htx.com/zh-cn/opend/newApiPages/?id=5521
  • 舊版介面文件(參考):https://www.htx.com/zh-cn/opend/newApiPages/?id=504
  • 停止服務後不可用的介面範圍:
介面分類 介面名稱 老介面路徑 老介面文件地址 是否能複用 是否有替代 新介面路徑 新介面地址
合約資產介面 【逐倉】獲取用戶帳戶資訊 /linear-swap-api/v1/swap_account_info https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb74610-77b5-11ed-9966-0242ac110003 否 是 /v5/account/balance https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-195703a12d5
合約資產介面 【全倉】獲取用戶帳戶資訊 /linear-swap-api/v1/swap_cross_account_info https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb74747-77b5-11ed-9966-0242ac110003 否 是 /v5/account/balance https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-195703a12d5
合約資產介面 【逐倉】查詢單個子帳戶資產資訊 /linear-swap-api/v1/swap_sub_account_info https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb75361-77b5-11ed-9966-0242ac110003 否 是 /v5/account/balance https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-195703a12d5
合約資產介面 【全倉】查詢單個子帳戶資產資訊 /linear-swap-api/v1/swap_cross_sub_account_info https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb75444-77b5-11ed-9966-0242ac110003 否 是 /v5/account/balance https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-195703a12d5
基礎資訊 【全倉】獲取平台階梯保證金 /linear-swap-api/v1/swap_cross_ladder_margin https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb72290-77b5-11ed-9966-0242ac110003 否 是 /v5/market/risk/limit https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-195809dc1e8
基礎資訊 【逐倉】獲取平台階梯保證金 /linear-swap-api/v1/swap_ladder_margin https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb72373-77b5-11ed-9966-0242ac110003 否 是 /v5/market/risk/limit https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-195809dc1e8
合約交易介面 【逐倉】切換槓桿 /linear-swap-api/v1/swap_switch_lever_rate https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb77b44-77b5-11ed-9966-0242ac110003 否 是 /v5/position/lever https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-1957f4a3b67
合約交易介面 【全倉】切換槓桿 /linear-swap-api/v1/swap_cross_switch_lever_rate https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb77cf0-77b5-11ed-9966-0242ac110003 否 是 /v5/position/lever https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-1957f4a3b67
合約交易介面 【逐倉】切換持倉模式 /linear-swap-api/v1/swap_switch_position_mode https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb76e69-77b5-11ed-9966-0242ac110003 否 是 /v5/position/mode https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-1957f4ec40b
合約交易介面 【全倉】切換持倉模式 /linear-swap-api/v1/swap_cross_switch_position_mode https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb76f41-77b5-11ed-9966-0242ac110003 否 是 /v5/position/mode https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-1957f4ec40b
合約交易介面 【逐倉】查詢持倉模式 /linear-swap-api/v1/swap_position_side https://www.htx.com/zh-cn/opend/newApiPages/?id=10000087-77b7-11ed-9966-0242ac110003 否 是 /v5/position/mode https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-1957f4d93fd
合約交易介面 【全倉】查詢持倉模式 /linear-swap-api/v1/swap_cross_position_side https://www.htx.com/zh-cn/opend/newApiPages/?id=10000089-77b7-11ed-9966-0242ac110003 否 是 /v5/position/mode https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-1957f4d93fd
合約資產介面 【逐倉】用戶持倉量限制的查詢 /linear-swap-api/v1/swap_position_limit https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb7649f-77b5-11ed-9966-0242ac110003 否 是 /v5/position/risk/limit https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-1957f50bd39
合約資產介面 【全倉】用戶持倉量限制的查詢 /linear-swap-api/v1/swap_cross_position_limit https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb765d7-77b5-11ed-9966-0242ac110003 否 是 /v5/position/risk/limit https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-1957f50bd39
合約資產介面 【逐倉】查詢用戶所有槓桿持倉量限制 /linear-swap-api/v1/swap_lever_position_limit https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb766c8-77b5-11ed-9966-0242ac110003 否 是 /v5/position/risk/limit_tier https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19b4528fc88
合約資產介面 【全倉】查詢用戶所有槓桿持倉量限制 /linear-swap-api/v1/swap_cross_lever_position_limit https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb7680c-77b5-11ed-9966-0242ac110003 否 是 /v5/position/risk/limit_tier https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19b4528fc88
WebSocket 訂單和用戶資料介面 【逐倉】資產變動資料(sub) accounts.$contract_code https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb70961-77b5-11ed-9966-0242ac110003 否 是 account https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19583056529
WebSocket 訂單和用戶資料介面 【全倉】資產變動資料(sub) accounts_cross.$margin_account https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb70acd-77b5-11ed-9966-0242ac110003 否 是 account https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19583056529
WebSocket 訂單和用戶資料介面 【逐倉】訂閱合約訂單撮合資料(sub) matchOrders.$contract_code https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb70e87-77b5-11ed-9966-0242ac110003 否 是 match_orders.$contract_code https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19710f62bf5
WebSocket 訂單和用戶資料介面 【全倉】訂閱合約訂單撮合資料(sub) matchOrders_cross.$contract_code https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb70fc8-77b5-11ed-9966-0242ac110003 否 是 match_orders.$contract_code https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19710f62bf5
WebSocket 訂單和用戶資料介面 【逐倉】訂閱計畫委託訂單更新(sub) trigger_order.$contract_code https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb714ad-77b5-11ed-9966-0242ac110003 否 是 orders.$contract_code https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19580a58ac9
WebSocket 訂單和用戶資料介面 【全倉】訂閱計畫委託訂單更新(sub) trigger_order_cross.$contract_code https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb715f3-77b5-11ed-9966-0242ac110003 否 是 orders.$contract_code https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19580a58ac9
WebSocket 訂單和用戶資料介面 【逐倉】持倉變動更新資料(sub) positions.$contract_code https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb70c13-77b5-11ed-9966-0242ac110003 否 是 positions.$contract_code https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19582def41f
WebSocket 訂單和用戶資料介面 【全倉】持倉變動更新資料(sub) positions_cross.$contract_code https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb70d4a-77b5-11ed-9966-0242ac110003 否 是 positions.$contract_code https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19582def41f
WebSocket 訂單和用戶資料介面 【逐倉】訂閱訂單成交資料(sub) orders.$contract_code https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb706b4-77b5-11ed-9966-0242ac110003 否 是 trade.$contract_code https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19582b9e8db
WebSocket 訂單和用戶資料介面 【全倉】訂閱訂單成交資料(sub) orders_cross.$contract_code https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb7080b-77b5-11ed-9966-0242ac110003 否 是 trade.$contract_code https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19582b9e8db
基礎資訊 【逐倉】查詢平台階梯調整係數 /linear-swap-api/v1/swap_adjustfactor https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb7262e-77b5-11ed-9966-0242ac110003 否 否 V5中無替代  
基礎資訊 【全倉】查詢平台階梯調整係數 /linear-swap-api/v1/swap_cross_adjustfactor https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb72766-77b5-11ed-9966-0242ac110003 否 否 V5中無替代  
合約資產介面 【逐倉】查詢用戶帳戶和持倉資訊 /linear-swap-api/v1/swap_account_position_info https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb74aad-77b5-11ed-9966-0242ac110003 否 否 V5中無替代  
合約資產介面 【全倉】查詢用戶帳戶和持倉資訊 /linear-swap-api/v1/swap_cross_account_position_info https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb74c00-77b5-11ed-9966-0242ac110003 否 否 V5中無替代  
合約資產介面 【通用】同帳號不同保證金帳戶的劃轉 /linear-swap-api/v1/swap_transfer_inner https://www.htx.com/zh-cn/opend/newApiPages/?id=8cb76afe-77b5-11ed-9966-0242ac110003 否 否 V5中無替代  
USDT 本位合約統一帳戶 查詢調整逐倉持倉保證金記錄 /linear-swap-api/v3/fix_position_margin_change_record https://www.htx.com/zh-cn/opend/newApiPages/?id=10000077-77b7-11ed-9966-0242ac110003 否 否 V5中無替代  
USDT 本位合約統一帳戶 USDT 本位合約帳戶類型查詢介面 /linear-swap-api/v3/swap_unified_account_type https://www.htx.com/zh-cn/opend/newApiPages/?id=10000079-77b7-11ed-9966-0242ac110003 否 否 V5中無替代  
USDT 本位合約統一帳戶 帳戶類型更改 /linear-swap-api/v3/swap_switch_account_type https://www.htx.com/zh-cn/opend/newApiPages/?id=10000081-77b7-11ed-9966-0242ac110003 否 否 V5中無替代  
USDT 本位合約統一帳戶 訂閱統一帳戶資產推送 accounts_unify.USDT https://www.htx.com/zh-cn/opend/newApiPages/?id=10000083-77b7-11ed-9966-0242ac110003 否 否 V5中無替代  
USDT 本位合約統一帳戶 取消訂閱統一帳戶資產變動資料 accounts_unify.USDT https://www.htx.com/zh-cn/opend/newApiPages/?id=10000085-77b7-11ed-9966-0242ac110003 否 否 V5中無替代  

二、優化說明

本次升級將為開發者與交易用戶帶來以下優化:

  • 介面架構精簡:對介面體系進行了系統性梳理與整合,核心介面數量大幅減少,降低接入複雜度,提升可維護性與易用性。
  • 交易性能提升:對下單、撤單、成交及清算等核心鏈路進行了深度優化,在高並發行情下具備更低延遲與更高吞吐能力,交易響應更加穩定高效。
  • 資料一致性增強:統一帳戶、持倉及成交資料結構,減少不同介面間的資料差異,便於開發者進行多維度資料處理與整合。
  • 風控模型統一:統一保證金計算、風險指標及標記價格邏輯,提升風控規則的一致性與可預期性,幫助用戶更準確地進行風險評估與策略建模。
  • 介面規範升級:介面命名與參數結構更加統一清晰,認證方式更加規範,文件結構同步優化,提升接入效率與相容性。
  • 擴展能力增強:升級後的架構為後續交易功能與量化能力擴展提供了更強支撐,未來將持續迭代,提供更豐富的 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 小時支援
  • 透過官網的「幫助中心」或者發送郵件至htxsupport@htx-inc.com聯繫客服

感謝您對 HTX 的支持與理解!如有任何疑問,請隨時聯繫我們的客服團隊。

HTX 團隊

2026年9月3日