HTX's USDT-M Futures Trading System Upgrade and the Migration Deadline

04/09 12:30:12 (UTC+7) Thông báo mới nhấtThông báo quan trọngHướng dẫn Hợp đồng Tương lai USDT-MAPI

Dear HTX Users,

To continuously enhance the futures trading experience, HTX has upgraded the futures trading system through a comprehensive overhaul of the underlying infrastructure supporting core trading services. The upgrade is designed to provide users with higher-performance, more stable, and more robust trading services.

 

This upgrade and migration have been rolled out in phases since April 2026. The migration deadline is 16:00:00 (UTC) on September 19, 2026. After the deadline, certain trading functions will be unavailable for the accounts listed below. Please complete the upgrade and migration as soon as possible.

  • API users
  • Futures traders using an app version below v11.13
  • Futures Grid and Copy Trading traders using an app version below v11.20

In addition, following completion of the upgrade and migration, certain trading rules and calculation formulas will be adjusted. Please review the potential impact and recalibrate your strategy parameters accordingly.

Announcement: Announcement Regarding the Upgrade and Migration of the HTX USDT-M Futures Trading System

Please note that for accounts that have not completed the migration, certain order placement and query functions will be unavailable. Please make the necessary migration arrangements in advance. (Accounts that have already been upgraded to Multi-Assets Collateral mode are not affected.)

 

I. Migration Scope

  • This upgrade requires the re-integration of all futures interfaces (including copy trading), with the exception of market data interfaces. The following categories must be updated, including but not limited to:
    • Account-Related Interfaces (assets, balances, etc.)
    • Order-Related Interfaces (order placement, order cancellation, queries, etc.)
    • Position-Related Interfaces (current positions, position limits, etc.)
    • Trading Bots / Conditional Order Interfaces
    • Basic Information Interfaces
  • New API Documentation: https://www.htx.com/en-us/opend/newApiPages/?id=5521
  • Old API Documentation (for reference): https://www.htx.com/en-us/opend/newApiPages/?id=504
  • Interfaces that will no longer be available once service is discontinued:
Second level Category Interface Name Old interface path Old interface doc link Can it be reused ? Is there an alternative? New interface path New interface doc link
Reference Data [Cross] Query information on Tiered Margin /linear-swap-api/v1/swap_cross_ladder_margin https://www.htx.com/en-us/opend/newApiPages/?id=8cb7f7a9-77b5-11ed-9966-0242ac110003 NO YES /v5/market/risk/limit https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-195a1c64aef
Reference Data [Isolated]Query information on Tiered Margin /linear-swap-api/v1/swap_ladder_margin https://www.htx.com/en-us/opend/newApiPages/?id=8cb7f887-77b5-11ed-9966-0242ac110003 NO YES /v5/market/risk/limit https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-195a1c64aef
Orders and Accounts WebSocket Interface [Isolated]Subscribe Order Data(sub) orders.$contract_code https://www.htx.com/en-us/opend/newApiPages/?id=8cb7d8d9-77b5-11ed-9966-0242ac110003 NO YES trade.$contract_code https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-195a35275ff
Orders and Accounts WebSocket Interface [Cross] Subscribe Order Data(sub) orders_cross.$contract_code https://www.htx.com/en-us/opend/newApiPages/?id=8cb7da4b-77b5-11ed-9966-0242ac110003 NO YES trade.$contract_code https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-195a35275ff
Orders and Accounts WebSocket Interface [Isolated]Subscribe Account Equity Updates Data(sub) accounts.$contract_code https://www.htx.com/en-us/opend/newApiPages/?id=8cb7dbbb-77b5-11ed-9966-0242ac110003 NO YES account https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-195a6c94551
Orders and Accounts WebSocket Interface [Cross] Subscribe Account Equity Updates Data(sub) accounts_cross.$margin_account https://www.htx.com/en-us/opend/newApiPages/?id=8cb7dcca-77b5-11ed-9966-0242ac110003 NO YES account https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-195a6c94551
Orders and Accounts WebSocket Interface [Isolated]Subscribe Position Updates(sub) positions.$contract_code https://www.htx.com/en-us/opend/newApiPages/?id=8cb7de1c-77b5-11ed-9966-0242ac110003 NO YES positions.$contract_code https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-195a35d6034
Orders and Accounts WebSocket Interface [Cross] Subscribe Position Updates(sub) positions_cross.$contract_code https://www.htx.com/en-us/opend/newApiPages/?id=8cb7df0f-77b5-11ed-9966-0242ac110003 NO YES positions.$contract_code https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-195a35d6034
Orders and Accounts WebSocket Interface [Isolated]Subscribe Order Data(sub) matchOrders.$contract_code https://www.htx.com/en-us/opend/newApiPages/?id=8cb7d8d9-77b5-11ed-9966-0242ac110003 NO YES match_orders.$contract_code https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19711352bcd
Orders and Accounts WebSocket Interface [Cross] Subscribe Order Data(sub) matchOrders_cross.$contract_code https://www.htx.com/en-us/opend/newApiPages/?id=8cb7da4b-77b5-11ed-9966-0242ac110003 NO YES match_orders.$contract_code https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19711352bcd
Orders and Accounts WebSocket Interface [Isolated]Subscribe trigger orders updates(sub) trigger_order.$contract_code https://www.htx.com/en-us/opend/newApiPages/?id=8cb7e5fc-77b5-11ed-9966-0242ac110003 NO YES orders.$contract_code https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-195a208afe7
Orders and Accounts WebSocket Interface [Cross] Subscribe trigger orders updates(sub) trigger_order_cross.$contract_code https://www.htx.com/en-us/opend/newApiPages/?id=8cb7e753-77b5-11ed-9966-0242ac110003 NO YES orders.$contract_code https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-195a208afe7
Swap Account Interface [Isolated]Query User's Account Information /linear-swap-api/v1/swap_account_info https://www.htx.com/en-us/opend/newApiPages/?id=8cb81843-77b5-11ed-9966-0242ac110003 NO YES /v5/account/balance https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19588469969
Swap Account Interface [Cross] Query User's Account Information /linear-swap-api/v1/swap_cross_account_info https://www.htx.com/en-us/opend/newApiPages/?id=8cb819b6-77b5-11ed-9966-0242ac110003 NO YES /v5/account/balance https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19588469969
Swap Account Interface [Isolated]Query a Batch of Sub-Account's Assets Information) /linear-swap-api/v1/swap_sub_account_info https://www.htx.com/en-us/opend/newApiPages/?id=8cb822f5-77b5-11ed-9966-0242ac110003 NO YES /v5/account/balance https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19588469969
Swap Account Interface [Cross] Query a Batch of Sub-Account's Assets Information /linear-swap-api/v1/swap_cross_sub_account_info https://www.htx.com/en-us/opend/newApiPages/?id=8cb8243c-77b5-11ed-9966-0242ac110003 NO YES /v5/account/balance https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19588469969
Swap Account Interface [Isolated]Query information on position limit /linear-swap-api/v1/swap_position_limit https://www.htx.com/en-us/opend/newApiPages/?id=8cb835b7-77b5-11ed-9966-0242ac110003 NO YES /v5/position/risk/limit https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19594451302
Swap Account Interface [Cross] Query Information On Position Limit /linear-swap-api/v1/swap_cross_position_limit https://www.htx.com/en-us/opend/newApiPages/?id=8cb836ae-77b5-11ed-9966-0242ac110003 NO YES /v5/position/risk/limit https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19594451302
Swap Account Interface [Isolated]Query Users' Position Limit for All Leverages /linear-swap-api/v1/swap_lever_position_limit https://www.htx.com/en-us/opend/newApiPages/?id=8cb838ef-77b5-11ed-9966-0242ac110003 NO YES /v5/position/risk/limit_tier https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19b4551f1fd
Swap Account Interface [Cross] Query Users' Position Limit for All Leverages /linear-swap-api/v1/swap_cross_lever_position_limit https://www.htx.com/en-us/opend/newApiPages/?id=8cb839e5-77b5-11ed-9966-0242ac110003 NO YES /v5/position/risk/limit_tier https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-19b4551f1fd
Swap Trade Interface [Isolated]Switch Position Mode /linear-swap-api/v1/swap_switch_position_mode https://www.htx.com/en-us/opend/newApiPages/?id=8cb842fe-77b5-11ed-9966-0242ac110003 NO YES /v5/position/mode https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-1959443cae3
Swap Trade Interface [Cross] Switch Position Mode /linear-swap-api/v1/swap_cross_switch_position_mode https://www.htx.com/en-us/opend/newApiPages/?id=8cb843e0-77b5-11ed-9966-0242ac110003 NO YES /v5/position/mode https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-1959443cae3
Swap Trade Interface [Isolated] Switch Leverage /linear-swap-api/v1/swap_switch_lever_rate https://www.htx.com/en-us/opend/newApiPages/?id=8cb84ff2-77b5-11ed-9966-0242ac110003 NO YES /v5/position/lever https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-1959439f997
Swap Trade Interface [Cross] Switch Leverage /linear-swap-api/v1/swap_cross_switch_lever_rate https://www.htx.com/en-us/opend/newApiPages/?id=8cb850d7-77b5-11ed-9966-0242ac110003 NO YES /v5/position/lever https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-1959439f997
Swap Trade Interface [isolated]Query position mode /linear-swap-api/v1/swap_position_side https://www.htx.com/en-us/opend/newApiPages/?id=10000088-77b7-11ed-9966-0242ac110003 NO YES /v5/position/mode https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-1959442c16b
Swap Trade Interface [Cross] Query position mode /linear-swap-api/v1/swap_cross_position_side https://www.htx.com/en-us/opend/newApiPages/?id=10000090-77b7-11ed-9966-0242ac110003 NO YES /v5/position/mode https://www.htx.com/en-us/opend/newApiPages/?id=8cb89359-77b5-11ed-9966-1959442c16b
Reference Data [Isolated]Query information on Tiered Adjustment Factor /linear-swap-api/v1/swap_adjustfactor https://www.htx.com/en-us/opend/newApiPages/?id=8cb7fb2c-77b5-11ed-9966-0242ac110003 NO NO No equivalent in V5  
Reference Data [Cross] Query Information On Tiered Adjustment Factor /linear-swap-api/v1/swap_cross_adjustfactor https://www.htx.com/en-us/opend/newApiPages/?id=8cb7fc0d-77b5-11ed-9966-0242ac110003 NO NO No equivalent in V5  
Swap Account Interface [Isolated]Query Assets And Positions /linear-swap-api/v1/swap_account_position_info https://www.htx.com/en-us/opend/newApiPages/?id=8cb81d85-77b5-11ed-9966-0242ac110003 NO NO No equivalent in V5  
Swap Account Interface [Cross] Query Assets And Positions /linear-swap-api/v1/swap_cross_account_position_info https://www.htx.com/en-us/opend/newApiPages/?id=8cb81e77-77b5-11ed-9966-0242ac110003 NO NO No equivalent in V5  
Swap Account Interface [General] Transfer between different margin accounts under the same account /linear-swap-api/v1/swap_transfer_inner https://www.htx.com/en-us/opend/newApiPages/?id=8cb83f97-77b5-11ed-9966-0242ac110003 NO NO No equivalent in V5  
USDT-M Unified Account Query the margin adjustment records of isolated positions /linear-swap-api/v3/fix_position_margin_change_record https://www.htx.com/en-us/opend/newApiPages/?id=10000078-77b7-11ed-9966-0242ac110003 NO NO No equivalent in V5  
USDT-M Unified Account USDT-M contract account type query API /linear-swap-api/v3/swap_unified_account_type https://www.htx.com/en-us/opend/newApiPages/?id=10000080-77b7-11ed-9966-0242ac110003 NO NO No equivalent in V5  
USDT-M Unified Account Account Type Change /linear-swap-api/v3/swap_switch_account_type https://www.htx.com/en-us/opend/newApiPages/?id=10000082-77b7-11ed-9966-0242ac110003 NO NO No equivalent in V5  
USDT-M Unified Account Subscribe to unified account asset push accounts_unify.USDT https://www.htx.com/en-us/opend/newApiPages/?id=10000084-77b7-11ed-9966-0242ac110003 NO NO No equivalent in V5  
USDT-M Unified Account Unsubscribe Unified Account Asset Change Data accounts_unify.USDT https://www.htx.com/en-us/opend/newApiPages/?id=10000086-77b7-11ed-9966-0242ac110003 NO NO No equivalent in V5  

 

II. Optimization Details

This upgrade delivers significant improvements across multiple dimensions:

  • Streamlined Interface Architecture: The interface system has been systematically reviewed and consolidated. The number of core interfaces has been significantly reduced, lowering integration complexity and improving maintainability and usability.
  • Improved Trading Performance: Core processes—including order placement, cancellation, execution, and settlement—have been thoroughly optimized to deliver lower latency and higher throughput, ensuring more stable and efficient trading responses under high-concurrency market conditions.
  • Enhanced Data Consistency: Account, position, and execution data structures have been unified, reducing data discrepancies across different interfaces and making it easier for developers to process and integrate data across multiple dimensions.
  • Unified Risk Control Model: Margin calculations, risk indicators, and mark price logic have been standardized to improve the consistency and predictability of risk control rules, enabling users to conduct more accurate risk assessments and strategy modeling.
  • Upgraded Interface Standards: Interface naming and parameter structures are now more unified and clearer, authentication methods are more standardized, and the documentation structure has been optimized accordingly to improve integration efficiency and compatibility.
  • Stronger Scalability: The upgraded architecture provides stronger support for future expansion of trading features and quantitative capabilities. We will continue to iterate and deliver more powerful API capabilities.

 

III. Migration Guide (Recommended)

  • Create a Test Sub-Account
    • It is recommended to create a sub-account under your existing main account for migration testing and debugging.
    • Call the /v5/account/asset_mode interface to upgrade the sub-account to the new Single-Asset Collateral mode (asset_mode=2) or Multi-Assets Collateral mode (asset_mode=1).
  • Interface Adaptation
    • Adjust request paths, parameters, and signature methods according to the latest API documentation.
  • Core Interface Verification: Order placement / cancellation, position queries, account asset queries, execution reports, etc.

Notes:

1. For accounts that have completed the mode upgrade (asset_mode=1 / asset_mode=2), private interfaces (trading, account, position, etc.) can only be accessed through V5 APIs. Old-version private interfaces will no longer be available.

2. Please prioritize the migration and regression testing of core interfaces such as order placement, cancellation, positions, and assets. It is recommended to begin as early as possible to avoid disruptions caused by concentrated migration activities near the deadline.

IV. Support Channels

If you encounter any issues during the migration process, you can get support through any of the following channels:

  • Telegram Technical Support Group: https://t.me/htx_api
  • Online Customer Service: 24/7 support
  • Contact our Customer Support team through Support on our official website or by sending an email to htxsupport@htx-inc.com.

Thank you for your continued support and trust in HTX. If you have any questions, please reach out to our online customer service.

HTX Team

September 3, 2026