SuperAPI AI 工具集

htx-futures-account

编程与开发

查看项目

更新于 10-15 22:14

技能介绍

用途:管理 HTX USDT-M(USDT 本位永续)合约账户。可回答“我有哪些 BTC 永续持仓、开仓价与盈亏”“全仓可用保证金多少”“子账户持仓”“ETH-USDT 最大杠杆”“从主账户转 500 USDT 到子账户”等问题。

主要能力(共 30 个接口,基于 /linear-swap-api,分隔离 I 与全仓 C):

  1. 账户与持仓查询(只读,8 个):如 htx-cli futures account info [--contract-code <c>] --json、htx-cli futures account position-info [--contract-code <c>] --json,以及 swap_cross_account_info、swap_cross_position_info、swap_account_position_info、swap_cross_account_position_info、v3/swap_financial_record、v3/swap_financial_record_exact。
  2. 杠杆与限额查询(只读,10 个):swap_available_level_rate、swap_cross_available_level_rate、swap_order_limit、swap_fee、swap_transfer_limit、swap_cross_transfer_limit、swap_position_limit、swap_cross_position_limit、swap_lever_position_limit、swap_cross_lever_position_limit。
  3. 子账户管理(只读,8 个):swap_sub_account_list、swap_account_info_list、swap_cross_account_info_list、swap_account_info_sub、swap_cross_account_info_sub、swap_position_info_sub、swap_cross_position_info_sub 及带 sub_uid 的财务记录查询。
  4. 转账及其它(4 个):swap_master_sub_transfer、swap_transfer_inner(需写权限),swap_master_sub_transfer_record、swap_api_trading_status(只读)。

使用方式:底层调用 htx-cli,需二进制位于 $PATH 或 $HTX_CLI_BIN,命令始终加 --json。配置凭据:htx-cli config set-key <AccessKeyId> 与 htx-cli config set-secret <SecretKey>。30 个接口中 26 个只需读权限,4 个转账接口需写权限。典型流程:先查持仓与账户(如 position-info 与 account info),再汇总方向、数量、开仓价、标记价、未实现盈亏、杠杆、保证金与强平价。转账前须与用户确认来源 UID、目标 UID、币种(usdt)、金额与方向(master_to_sub / sub_to_master),展示完整转账预览并等待明确确认。

限制与安全:只读接口可自由调用;转账接口须预览并二次确认;资金始终在 HTX 内部,属低风险;不要记录密钥,secret 仅通过 config set-secret 设置一次。其余细节资料未提供。