name: htx/futures-account
version: 2.0.0
description: HTX USDT-M perpetual futures account — balance / positions / leverage tiers / adjustment factors / unified account type switching.
auth: true
risk: medium
Futures Account
Query USDT-M perpetual futures account and positions, including leverage tiers, adjustment factors, unified account switching, and other reference data. Read permission is enough for 26 of 30 endpoints. Transfers (4) need write.
Endpoint catalog (30)
All paths in this skill have base /linear-swap-api unless noted. "Mode" column: I = isolated, C = cross, * = either.
Account & position query — read (8)
| # |
Method |
Path |
CLI invocation |
Mode |
| 1 |
POST |
/v1/swap_account_info |
htx-cli futures call /v1/swap_account_info --auth -p contract_code=BTC-USDT |
I |
| 2 |
POST |
/v1/swap_cross_account_info |
htx-cli futures call /v1/swap_cross_account_info --auth -p margin_account=USDT |
C |
| 3 |
POST |
/v1/swap_position_info |
htx-cli futures call /v1/swap_position_info --auth -p contract_code=BTC-USDT |
I |
| 4 |
POST |
/v1/swap_cross_position_info |
htx-cli futures call /v1/swap_cross_position_info --auth -p contract_code=BTC-USDT |
C |
| 5 |
POST |
/v1/swap_account_position_info |
htx-cli futures call /v1/swap_account_position_info --auth |
I |
| 6 |
POST |
/v1/swap_cross_account_position_info |
htx-cli futures call /v1/swap_cross_account_position_info --auth |
C |
| 7 |
POST |
/v1/swap_position_limit |
htx-cli futures call /v1/swap_position_limit --auth |
I |
| 8 |
POST |
/v1/swap_cross_position_limit |
htx-cli futures call /v1/swap_cross_position_limit --auth |
C |
Tier-margin & risk — read (6)
| # |
Method |
Path |
CLI invocation |
Mode |
| 9 |
GET |
/v1/swap_adjustfactor |
htx-cli futures call /v1/swap_adjustfactor --method GET -p contract_code=BTC-USDT |
I |
| 10 |
GET |
/v1/swap_cross_adjustfactor |
htx-cli futures call /v1/swap_cross_adjustfactor --method GET -p contract_code=BTC-USDT |
C |
| 11 |
GET |
/v1/swap_ladder_margin |
htx-cli futures call /v1/swap_ladder_margin --method GET -p contract_code=BTC-USDT |
I |
| 12 |
GET |
/v1/swap_cross_ladder_margin |
htx-cli futures call /v1/swap_cross_ladder_margin --method GET -p margin_account=USDT |
C |
| 13 |
POST |
/v1/swap_available_level_rate |
htx-cli futures call /v1/swap_available_level_rate --auth -p contract_code=BTC-USDT |
* |
| 14 |
POST |
/v1/swap_user_settlement_records |
htx-cli futures call /v1/swap_user_settlement_records --auth |
* |
Financial records — read (8)
| # |
Method |
Path |
CLI invocation |
| 15 |
POST |
/v1/swap_financial_record |
htx-cli futures call /v1/swap_financial_record --auth -p mar_acct=BTC-USDT |
| 16 |
POST |
/v1/swap_financial_record_exact |
htx-cli futures call /v1/swap_financial_record_exact --auth -p contract=BTC-USDT |
| 17 |
POST |
/v3/swap_financial_record_exact |
htx-cli futures call /v3/swap_financial_record_exact --auth -p contract=BTC-USDT |
| 18 |
POST |
/v1/swap_user_fee |
htx-cli futures call /v1/swap_user_fee --auth -p contract_code=BTC-USDT |
| 19 |
POST |
/v1/swap_funding_record |
htx-cli futures call /v1/swap_funding_record --auth |
| 20 |
POST |
/v1/swap_api_trading_status |
htx-cli futures call /v1/swap_api_trading_status --auth |
| 21 |
POST |
/v1/swap_position_mode |
htx-cli futures call /v1/swap_position_mode --auth -p margin_account=USDT |
| 22 |
POST |
/v1/swap_master_sub_transfer_record |
htx-cli futures call /v1/swap_master_sub_transfer_record --auth |
Unified account toggle — read + write (4)
| # |
Method |
Path |
Description |
| 23 |
POST |
/v3/unified_account_info |
Unified account aggregated info (read) |
| 24 |
POST |
/v3/swap_switch_account_type |
Switch account type (single → cross-margin → unified) — write |
| 25 |
POST |
/v3/unified_account_switch_status |
Query switch status |
| 26 |
POST |
/v3/swap_switch_position_mode |
Switch position mode (one-way ↔ hedge) — write |
Master ↔ sub transfer — write (4)
| # |
Method |
Path |
| 27 |
POST |
/v1/swap_master_sub_transfer |
| 28 |
POST |
/v1/swap_sub_auth |
| 29 |
POST |
/v1/swap_sub_account_info_list |
| 30 |
POST |
/v1/swap_sub_account_info |
Workflow patterns
Query cross-margin account + position overview
htx-cli futures call /v1/swap_cross_account_info --auth -p margin_account=USDT --json
htx-cli futures call /v1/swap_cross_account_position_info --auth --json
Query isolated BTC-USDT position
htx-cli futures call /v1/swap_position_info --auth -p contract_code=BTC-USDT --json
Query BTC-USDT leverage tiers
htx-cli futures call /v1/swap_ladder_margin --method GET -p contract_code=BTC-USDT --json
Safety
- Switching account type / switching position mode / master-sub transfers are all write operations. The AI Agent must first show the user the current state and target state, and only execute after explicit manual confirmation.
- Before switching, you need to check that there are no positions or open orders (the system will validate, but informing the user up front is friendlier).
Installation
curl -fsSL https://github.com/htx-exchange/htx-skills-hub/releases/latest/download/install.sh | bash -s -- futures-account
By