SuperAPI AI 工具集

htx/futures-market

数据与分析

查看项目

更新于 10-15 22:14

技能介绍

用途:读取 HTX USDT本位永续合约的公开行情数据,无需 API 密钥。资金费率、持仓量、爆仓、标记价格/基差等专项数据已拆分为独立技能,本技能只覆盖通用行情。

主要能力(15个接口):行情类含 detail-merged(单合约实时汇总)、detail-batch-merged(批量汇总)、kline(历史K线)、depth(盘口深度)、bbo(最优买卖价)、trade(最新成交)、history-trade(历史成交);指数价格含 index-price;元数据含 contract-info(合约信息)、query-elements(精度与面值)、risk-info(风险准备金)、funding-rate-cap(资金费率上下限);系统状态含 timestamp、heartbeat、transfer-state。

使用方式:通过 htx-cli 调用,例如查询 BTC 永续最新行情:htx-cli futures-market detail-merged -p contract_code=BTC-USDT;查询 ETH 永续 1 小时 K 线:htx-cli futures-market kline -p contract_code=ETH-USDT -p period=60min -p size=200;查询全部永续合约信息:htx-cli futures-market contract-info。安装命令:curl -fsSL https://github.com/htx-exchange/htx-skills-hub/releases/latest/download/install.sh | bash -s -- futures-market。

参数:contract_code 为大写连字符格式(如 BTC-USDT);period 支持 1min 至 1mon;size 为 1-2000;type 为盘口聚合 step0-step19;business_type 为 swap/futures/all。

适用场景:查询永续实时价格与24小时统计、拉取标准K线、查看盘口深度、核对合约面值与精度、检查系统状态,以及由 AI Agent 对比永续与现货价格计算溢价。

限制:仅提供公开只读行情;标记价格/溢价指数/基差K线请用 htx/mark-price,资金费率、持仓量、多空比、爆仓、结算等请用对应专项技能;下单、改杠杆等写操作请用 htx/futures-trading,账户查询请用 htx/futures-account。官方文档:https://huobiapi.github.io/docs/usdt_swap/v1/cn/。