用途:该技能用于查询 HTX(火币)USDT 本位永续合约的市场数据,底层驱动 htx-cli,二进制位于 $PATH 或 $HTX_CLI_BIN,输出统一使用 --json。适合查询 BTC 永续资金费率、ETH 合约持仓量、大户多空比、BTC-USDT 4 小时 K 线、当日爆仓量、BTC-USDT 阶梯保证金要求等。
主要能力:共 36 个端点。公开的合约与系统信息 14 个,包括合约元数据、指数价格、价格限制、持仓量、合约要素、预估结算价、系统状态、保险基金余额与历史、服务器时间戳、心跳、指数成分、爆仓订单、结算历史。公开的资金费率与情绪 5 个,包括当前资金费率、批量资金费率、历史资金费率、大户账户多空比、大户持仓多空比。公开行情 11 个,包括深度、最优买卖价、K 线、标记价格 K 线、单合约概览、全合约概览、最新成交、近期成交、历史持仓量、溢价指数 K 线、预估资金费率 K 线。另有 6 个参考数据端点需只读权限,包括统一账户类型、全仓与逐仓阶梯保证金、逐仓与全仓调整系数,以及切换账户类型(写操作,调用前应向用户展示目标账户类型)。
使用方式:先配置凭证(只读权限即可):htx-cli config set-key <AccessKeyId> 与 htx-cli config set-secret <SecretKey>。常用调用如 htx-cli futures market funding-rate BTC-USDT --json、htx-cli futures market liquidation-orders --contract-code BTC-USDT --json、htx-cli futures market tickers --json,也可用 htx-cli futures call GET <endpoint> --query ... --json 直接调用端点。合约代码格式为 <BASE>-USDT,如 BTC-USDT、ETH-USDT、SOL-USDT。
限制:并非所有端点都接受 contract_code 过滤,部分返回全市场数据;6 个参考数据端点需 API Key;切换账户类型为写操作。参考资料见 references/contract-info.md 与 references/funding-rate.md。具体收费、价格与平台支持情况暂未提供。