用途:该技能聚焦 HTX USDT-M 永续合约的标记价格、溢价指数与基差 K 线序列。标记价格用于强平触发与未实现盈亏计算,溢价指数驱动资金费率,基差为标记价与指数价之差(相对现货参考价的价差)。全部为公开数据。
主要能力:提供两个端点。标记价格 K 线:GET /linear-swap-ex/market/history/mark_price_kline,CLI 调用 htx-cli futures call GET /linear-swap-ex/market/history/mark_price_kline --query contract_code=<code>&period=<period>&size=<N> --json。溢价指数 K 线:GET /linear-swap-ex/market/history/premium_index_kline,CLI 调用 htx-cli futures call GET /linear-swap-ex/market/history/premium_index_kline --query contract_code=<code>&period=<period>&size=<N> --json。周期取值:1min、5min、15min、30min、60min、4hour、1day;size 范围 1–2000,常用 200。合约代码格式为 <BASE>-USDT,如 BTC-USDT。
使用方式:底层驱动 htx-cli,二进制位于 $PATH 或 $HTX_CLI_BIN,调用时始终传 --json。示例:查询 BTC 标记价 1 小时 K 线最近 200 根,htx-cli futures call GET /linear-swap-ex/market/history/mark_price_kline --query contract_code=BTC-USDT&period=60min&size=200 --json;查询 ETH 溢价指数 15 分钟 K 线,htx-cli futures call GET /linear-swap-ex/market/history/premium_index_kline --query contract_code=ETH-USDT&period=15min&size=200 --json。基差查询示例:htx-cli futures call GET /index/market/history/linear_swap_basis -p contract_code=BTC-USDT -p period=60min -p basis_price_type=close -p size=100 --json。
概念参考:标记价格=指数价格×(1+移动窗口内的溢价指数),用于强平与未实现盈亏,不用于撮合成交;指数价格为基于主要现货交易所的加权参考价;溢价指数=(标记-指数)/指数,正值表示永续溢价(多头偏重),负值表示折价;资金费率由平滑后的溢价指数加利率成分计算,每 8 小时重置。
输出建议:返回最新标记价/溢价数值,以及 1h/4h/24h 变化;对溢价指数可标注为折价(>−0.05%)、中性(±0.05%)、轻度溢价(0.05%-0.2%)、重度溢价(>0.2%)。
适用场景:查询标记价 K 线、溢价指数历史、标记价与指数价价差、判断永续处于溢价或折价、基差历史等。
限制:资料未提供收费、价格、平台覆盖范围及具体错误处理说明;基差端点参数与上述两个端点不同,需按示例传参。