SuperAPI AI 工具集

htx/futures-trading

通用与其它

查看项目

更新于 10-15 22:14

技能介绍

用途:在 HTX 的 USDT-M 永续合约上执行订单管理,包括下单、撤单、修改杠杆、设置止盈止损与追踪止损、触发单、闪电平仓,以及订单与成交查询。接口路径以 /linear-swap-api 为基础,cross_ 前缀表示全仓,无前缀表示逐仓。

主要能力:下单(单笔/批量,逐仓与全仓)、撤单(单笔/全部)、修改杠杆、TP/SL 与追踪止损、触发单、闪电平仓,以及开仓单、订单详情、历史订单、成交明细、TP/SL 订单等查询接口。核心参数含 contract_code、direction(buy/sell)、offset(open/close)、lever_rate、order_price_type、price、volume、client_order_id 及 tp/sl 触发价与委托价。direction 与 offset 组合决定开多、开空、平空、平多;volume 单位为张,需按 contract_size 换算。

使用方式:需 API Key 具备 futures-trade 权限,部分查询仅需 futures-read。安装命令:curl -fsSL https://github.com/htx-exchange/htx-skills-hub/releases/latest/download/install.sh | bash -s -- futures-trading。示例:htx-cli futures call /v1/swap_cross_order --auth --body '{...}' --json。

限制与风险:属极高风险写操作,杠杆可能导致快速亏损或强平。每次下单前须展示合约、方向、杠杆、张数、标的数量、委托价、预估保证金、标记价偏离与可计算时的强平价,并显示可用保证金,等待用户明确确认后才执行;5 倍以上杠杆须提示高强平风险。平仓与闪电平仓须展示持仓、成本与盈亏并确认全平或部分平;闪电平仓为市价即时成交、无价格保护。修改杠杆须展示前后值并评估影响。常见错误码含 position-empty、volume-precision-error、lever-rate-too-high、available-margin-insufficient。下单/撤单速率约每秒 30 次。API 文档:https://huobiapi.github.io/docs/usdt_swap/v1/cn/。