用途:查询 HTX 现货账户与子账户的余额、资产估值、交易历史、充提记录,并在账户间划转资金。
主要能力:账户查询为只读,包括列出全部账户(现货/杠杆/OTC/积分)、查询单账户各币种余额、总资产估值(USD/BTC)、近 7 天账户历史、充提记录;划转为写操作,包括自有现货/杠杆/OTC 账户间划转、现货与 COIN-M 交割合约划转、现货与 USDT-M 线性永续/全仓/超仓划转、积分余额查询与积分划转。共 10 个端点。
使用方式:安装命令为 curl -fsSL https://github.com/htx-exchange/htx-skills-hub/releases/latest/download/install.sh | bash -s -- spot-account。常用命令:htx-cli spot account list、htx-cli spot account balance <id>、htx-cli spot account valuation、htx-cli spot account history、htx-cli spot account deposit-withdraw。划转通过 htx-cli spot call 调用对应端点,例如现货转 USDT-M 永续使用 /v2/account/transfer,body 中 from/to 为 spot 与 linear-swap,margin-account 为 USDT(全仓)或 USDT-<symbol>(逐仓);现货转 COIN-M 使用 /v1/futures/transfer,type 为 pro-to-futures 或 futures-to-pro。
适用场景:查看账户资产与估值、核对充提与历史、在现货与合约账户间调拨保证金、管理子账户资金。
限制:所有端点需 API Key,读取需读权限,划转需交易权限;读取无副作用,划转为写操作,调用前须向用户展示来源、目标、币种、金额与方向并获明确确认,方向错误可能导致保证金不足或强制平仓;/v1/futures/transfer 仅用于 COIN-M 交割合约,误用于 USDT 会返回 Transfer service is temporarily suspended for USDT account;API Key 不离开本机。其他费率、限额与平台支持范围暂未提供。