親愛的用戶:
為持續提升合約交易體驗,我們已對合約系統進行升級,本次升級是對核心交易的基礎服務全面重構,旨在為用戶提供更高性能、更穩定、更規範的交易服務體驗。
該項升級遷移工作已於 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日