用途:该技能专注于 HTX USDT-M 永续合约的未平仓量(OI)查询,适合回答某合约当前 OI、24 小时 OI 变化、OI 趋势、是否存在 OI 激增、OI 与价格背离、全部 USDT-M 永续合约总 OI 等问题。若需 OI 与资金费率结合的多信号评分,资料建议改用 htx-derivatives-analyst(规划中的 Layer 2)。
主要能力:底层驱动 htx-cli,二进制位于 $PATH 或 $HTX_CLI_BIN,调用时始终传 --json。提供两个公开端点:GET /linear-swap-api/v1/swap_open_interest 返回当前 OI 快照,不带 contract_code 时返回全部合约;GET /linear-swap-ex/market/his_open_interest 返回历史 OI 时间序列,用于趋势或激增分析。合约代码格式为 <BASE>-USDT,如 BTC-USDT。历史接口的 period 支持 60min、4hour、12hour、1day,size 为 1 至 200。
使用方式:通过 htx-cli futures call 调用。例如查询 BTC 当前 OI:htx-cli futures call GET /linear-swap-api/v1/swap_open_interest --query contract_code=BTC-USDT --json;查询全部合约快照:htx-cli futures call GET /linear-swap-api/v1/swap_open_interest --json;查询 ETH 4 小时 OI 最近 200 根:htx-cli futures call GET /linear-swap-ex/market/his_open_interest --query contract_code=ETH-USDT&period=4hour&size=200 --json。24 小时变化百分比需拉取 1day、size=2 后在客户端计算 (最新-前值)/前值*100。
输出建议:返回当前 OI(合约张数与基础币数量)、24 小时变化百分比、趋势标签(4 小时内 >10% 为 surging,上升、稳定、下降,<-10% 为 plunging);全合约查询时给出绝对 OI 前 5 与 24 小时增长前 5。OI 信号解读:OI 升且价格升为多头进场看涨延续;OI 升且价格跌为空头进场看跌延续;OI 降且价格升为空头回补挤压风险;OI 降且价格跌为多头平仓投降。
限制:资料未提供收费、价格、平台覆盖范围或使用配额等信息;历史 OI 的 period 与 size 取值有限制,超出范围的行为暂未提供。