SuperAPI AI 工具集

htx-spot-account

办公与效率

查看项目

更新于 10-15 22:14

技能介绍

用途:面向 HTX 现货账户与资产管理,可查询账户余额、总资产估值、账户流水记录与 HTX 积分,并在用户自己的 HTX 内部账户之间划转资金。

主要能力:底层驱动 htx-cli,二进制需位于 $PATH 或 $HTX_CLI_BIN,调用时始终使用 --json。共 10 个端点:5 个只读查询(账户列表 /v1/account/accounts、余额明细 /v1/account/accounts/{id}/balance、总估值 /v2/account/valuation、按账户资产估值 /v2/account/asset-valuation、账户流水 /v1/account/history);5 个写操作(现货/杠杆/OTC 账户间划转 /v1/account/transfer、现货与币本位交割合约划转 /v1/futures/transfer、现货与 USDT 本位线性永续/全仓/逐仓划转 /v2/account/transfer、HTX 积分余额 /v1/point/account、积分划转 /v1/point/transfer)。

使用方式:先一次性配置凭证,htx-cli config set-key <AccessKeyId>、htx-cli config set-secret <SecretKey>、htx-cli config show。查询示例:htx-cli spot account list --json、htx-cli spot account balance <account-id> --json、htx-cli spot account valuation --json。划转示例:htx-cli spot call /v2/account/transfer --method POST --auth --body '{"from":"spot","to":"linear-swap","currency":"usdt","amount":"5","margin-account":"USDT"}' --json。

适用场景:查询 USDT 等币种余额、查看美元总估值、查看账户历史与流水、在现货与合约账户间划转、查询 HTX 积分。

限制与安全:需 API key 且具备读权限。USDT 本位永续必须使用 /v2/account/transfer,from/to 为 spot 与 linear-swap,margin-account 为 USDT(全仓)或 USDT-<symbol>(逐仓);/v1/futures/transfer 仅用于币本位交割合约,误用会返回 Transfer service is temporarily suspended for USDT account。调用任何划转端点前须向用户展示来源、目标、币种、金额与方向,并取得明确确认;只读端点可直接调用。切勿记录或通过命令行参数传递 secret key,应使用 htx-cli config set-secret 一次性存储。签名细节见 references/authentication.md。