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