用途:查询 HTX USDT本位永续合约账户与持仓信息,涵盖杠杆档位、调整系数、统一账户切换等参考数据。所有路径基础为 /linear-swap-api(另有标注除外)。
主要能力(共30个端点):账户与持仓查询8个(如 /v1/swap_account_info、/v1/swap_cross_account_info、/v1/swap_position_info、/v1/swap_cross_position_info 等,区分逐仓I与全仓C);档位保证金与风险6个(如 /v1/swap_adjustfactor、/v1/swap_ladder_margin、/v1/swap_available_level_rate、/v1/swap_user_settlement_records);财务记录8个(如 /v1/swap_financial_record、/v1/swap_user_fee、/v1/swap_funding_record、/v1/swap_api_trading_status、/v1/swap_position_mode 等);统一账户切换4个(/v3/unified_account_info 读、/v3/swap_switch_account_type 写、/v3/unified_account_switch_status、/v3/swap_switch_position_mode 写);主子账户划转4个(/v1/swap_master_sub_transfer、/v1/swap_sub_auth、/v1/swap_sub_account_info_list、/v1/swap_sub_account_info)。
使用方式:通过 htx-cli 调用,例如查询全仓账户与持仓概览:htx-cli futures call /v1/swap_cross_account_info --auth -p margin_account=USDT --json;查询逐仓BTC-USDT持仓:htx-cli futures call /v1/swap_position_info --auth -p contract_code=BTC-USDT --json;查询杠杆档位:htx-cli futures call /v1/swap_ladder_margin --method GET -p contract_code=BTC-USDT --json。安装:curl -fsSL https://github.com/htx-exchange/htx-skills-hub/releases/latest/download/install.sh | bash -s -- futures-account
限制与安全:30个端点中26个仅需读权限,4个划转端点需写权限。切换账户类型、切换持仓模式、主子划转均为写操作,AI Agent 须先向用户展示当前状态与目标状态,经明确人工确认后才执行;切换前需检查无持仓或挂单(系统会校验,提前告知用户更友好)。