重要前提
安装AI Skills的关键前提是:必须科学上网,且开启TUN模式,这一点至关重要,直接决定安装能否顺利完成,在此郑重提醒三遍:科学上网,科学上网,科学上网。查看完整安装教程 →
usdt-m-futures by htx-exchange/htx-skills-hub
npx skills add https://github.com/htx-exchange/htx-skills-hub --skill usdt-m-futures使用经过身份验证的公共 API 端点进行 HTX 上的 USDT-M 期货交易。以 JSON 格式返回结果。
HTX USDT-M 期货的完整 API 端点。所有端点使用基础 URL https://api.hbdm.com(或 AWS 使用 https://api.hbdm.vn)。
| 端点 | 描述 | 必填参数 | 可选参数 | 身份验证 |
|---|---|---|---|---|
GET /linear-swap-api/v3/swap_unified_account_type | 账户类型查询 | 无 | 无 |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| 是 |
POST /linear-swap-api/v3/swap_switch_account_type | 账户类型切换 | account_type | 无 | 是 |
GET /linear-swap-api/v1/swap_funding_rate | 查询资金费率 | contract_code | 无 | 否 |
GET /linear-swap-api/v1/swap_batch_funding_rate | 查询批量资金费率 | contract_code | 无 | 否 |
GET /linear-swap-api/v1/swap_historical_funding_rate | 查询历史资金费率 | contract_code | page_index, page_size | 否 |
GET /linear-swap-api/v1/swap_liquidation_orders | 查询强平订单 | contract_code | trade_type, create_date, page_index, page_size | 否 |
GET /linear-swap-api/v1/swap_settlement_records | 查询历史结算记录 | contract_code | page_index, page_size | 否 |
GET /linear-swap-api/v1/swap_elite_account_ratio | 查询精英账户多空比 | contract_code | period | 否 |
GET /linear-swap-api/v1/swap_elite_position_ratio | 查询精英持仓多空比 | contract_code | period | 否 |
GET /linear-swap-api/v1/swap_system_status | 查询系统状态信息(逐仓) | contract_code | 无 | 否 |
POST /linear-swap-api/v1/swap_cross_tiered_margin_info | 查询阶梯保证金信息(全仓) | 无 | 无 | 是 |
POST /linear-swap-api/v1/swap_tiered_margin_info | 查询阶梯保证金信息(逐仓) | contract_code | 无 | 是 |
GET /linear-swap-api/v1/swap_estimated_settlement_price | 获取预估结算价 | contract_code | 无 | 否 |
POST /linear-swap-api/v1/swap_adjustment_factor | 查询阶梯调整系数(逐仓) | contract_code | 无 | 是 |
POST /linear-swap-api/v1/swap_cross_adjustment_factor | 查询阶梯调整系数(全仓) | 无 | 无 | 是 |
GET /v1/insurance_fund_info | 查询风险准备金余额信息 | contract_code | 无 | 否 |
GET /v1/insurance_fund_history | 查询历史风险准备金 | contract_code | page_index, page_size | 否 |
GET /linear-swap-api/v1/swap_price_limit | 查询合约价格限制 | contract_code | 无 | 否 |
GET /linear-swap-api/v1/swap_open_interest | 获取合约持仓量信息 | contract_code | 无 | 否 |
GET /linear-swap-api/v1/swap_contract_info | 查询合约信息 | contract_code | 无 | 否 |
GET /linear-swap-api/v1/swap_index | 查询合约指数价格信息 | contract_code | 无 | 否 |
GET /linear-swap-api/market/swap_contract_constituents | 获取指数成分 | index_code | 无 | 否 |
GET /linear-swap-api/v1/swap_query_elements | 合约要素 | contract_code | 无 | 否 |
GET /linear-swap-api/v1/swap_timestamp | 获取当前系统时间戳 | 无 | 无 | 否 |
GET https://api.hbdm.com/heartbeat/ | 查询系统是否可用 | 无 | 无 | 否 |
| 端点 | 描述 | 必填参数 | 可选参数 | 身份验证 |
|---|---|---|---|---|
GET /linear-swap-ex/market/depth | 获取市场深度 | contract_code | type | 否 |
GET /linear-swap-ex/market/bbo | 获取市场最优买卖价 | contract_code | 无 | 否 |
GET /linear-swap-ex/market/kline | 获取K线数据 | contract_code, period | size, from, to | 否 |
GET /linear-swap-ex/market/mark_price_kline | 获取标记价格K线数据 | contract_code, period | size, from, to | 否 |
GET /linear-swap-ex/market/overview | 获取市场数据概览 | contract_code | 无 | 否 |
GET /linear-swap-ex/market/batch_overview | 获取批量市场数据概览 | contract_code | 无 | 否 |
GET /linear-swap-ex/market/trade | 查询合约最新成交 | contract_code | 无 | 否 |
GET /linear-swap-ex/market/trades | 查询批量成交记录 | contract_code | size | 否 |
GET /linear-swap-ex/market/open_interest | 查询持仓量信息 | contract_code | 无 | 否 |
GET /linear-swap-ex/market/premium_index_kline | 查询溢价指数K线数据 | contract_code, period | size, from, to | 否 |
GET /linear-swap-ex/market/estimated_funding_rate_kline | 查询预估资金费率K线 | contract_code, period | size, from, to | 否 |
| 端点 | 描述 | 必填参数 | 可选参数 | 身份验证 |
|---|---|---|---|---|
POST /linear-swap-api/v1/swap_account_info | 查询资产估值 | 无 | valuation_asset | 是 |
POST /linear-swap-api/v1/swap_account_info | 查询账户信息(逐仓) | contract_code | 无 | 是 |
POST /linear-swap-api/v1/swap_cross_account_info | 查询账户信息(全仓) | 无 | valuation_asset | 是 |
POST /linear-swap-api/v1/swap_position_info | 查询持仓信息(逐仓) | contract_code | 无 | 是 |
POST /linear-swap-api/v1/swap_cross_position_info | 查询持仓信息(全仓) | 无 | contract_code | 是 |
POST /linear-swap-api/v1/swap_account_position_info | 查询资产和持仓(逐仓) | contract_code | 无 | 是 |
POST /linear-swap-api/v1/swap_cross_account_position_info | 查询资产和持仓(全仓) | 无 | valuation_asset | 是 |
POST /linear-swap-api/v1/swap_sub_account_list | 设置子账户交易权限 | sub_uid | trades | 是 |
POST /linear-swap-api/v1/swap_account_info_list | 查询所有子账户(逐仓) | 无 | 无 | 是 |
POST /linear-swap-api/v1/swap_cross_account_info_list | 查询所有子账户(全仓) | 无 | valuation_asset | 是 |
POST /linear-swap-api/v1/swap_account_info_sub | 查询单个子账户(逐仓) | contract_code, sub_uid | 无 | 是 |
POST /linear-swap-api/v1/swap_cross_account_info_sub | 查询子账户(全仓) | sub_uid | valuation_asset | 是 |
POST /linear-swap-api/v1/swap_position_info_sub | 查询子账户持仓(逐仓) | contract_code, sub_uid | 无 | 是 |
POST /linear-swap-api/v1/swap_cross_position_info_sub | 查询子账户持仓(全仓) | sub_uid | contract_code | 是 |
POST /linear-swap-api/v3/swap_financial_record | 查询账户财务记录 | 无 | contract_code, type, start_time, end_time, page_index, page_size, direct | 是 |
POST /linear-swap-api/v3/swap_financial_record_exact | 通过字段查询财务记录 | 无 | contract_code, type, start_time, end_time, page_index, page_size, direct | 是 |
POST /linear-swap-api/v1/swap_available_level_rate | 查询可用杠杆(逐仓) | contract_code | 无 | 是 |
POST /linear-swap-api/v1/swap_cross_available_level_rate | 查询可用杠杆(全仓) | 无 | 无 | 是 |
POST /linear-swap-api/v1/swap_order_limit | 查询订单限制 | 无 | contract_code, order_price_type | 是 |
POST /linear-swap-api/v1/swap_fee | 查询合约交易手续费 | 无 | contract_code | 是 |
POST /linear-swap-api/v1/swap_transfer_limit | 查询划转限制(逐仓) | contract_code | 无 | 是 |
POST /linear-swap-api/v1/swap_cross_transfer_limit | 查询划转限制(全仓) | 无 | 无 | 是 |
POST /linear-swap-api/v1/swap_position_limit | 查询持仓限制(逐仓) | contract_code | 无 | 是 |
POST /linear-swap-api/v1/swap_cross_position_limit | 查询持仓限制(全仓) | 无 | 无 | 是 |
POST /linear-swap-api/v1/swap_lever_position_limit | 查询所有杠杆持仓限制(逐仓) | contract_code | 无 | 是 |
POST /linear-swap-api/v1/swap_cross_lever_position_limit | 查询所有杠杆持仓限制(全仓) | 无 | 无 | 是 |
POST /linear-swap-api/v1/swap_master_sub_transfer | 母子账户划转 | sub_uid, asset, amount, type | client_order_id | 是 |
POST /linear-swap-api/v1/swap_master_sub_transfer_record | 查询划转记录 | 无 | sub_uid, transfer_type, page_index, page_size, direct, sort_by | 是 |
POST /linear-swap-api/v1/swap_transfer_inner | 保证金账户间划转 | asset, amount, from_margin_account, to_margin_account | client_order_id | 是 |
GET /linear-swap-api/v1/swap_api_trading_status | 查询API指标禁用信息 | 无 | 无 | 是 |
POST /linear-swap-api/v1/linear-cancel-after | 自动撤单 | timeout | contract_code | 是 |
| 端点 | 描述 | 必填参数 | 可选参数 | 身份验证 |
|---|---|---|---|---|
POST /linear-swap-api/v1/swap_cross_query_trade_state | 查询交易状态(全仓) | 无 | 无 | 是 |
POST /linear-swap-api/v1/swap_switch_position_mode | 切换持仓模式(逐仓) | contract_code, mode | 无 | 是 |
POST /linear-swap-api/v1/swap_cross_switch_position_mode | 切换持仓模式(全仓) | mode | contract_code | 是 |
POST /linear-swap-api/v1/swap_order | 下单(逐仓) | contract_code, client_order_id, price, volume, direction, offset, lever_rate, order_price_type | tp_trigger_price, tp_order_price, tp_order_price_type, sl_trigger_price, sl_order_price, sl_order_price_type, reduce_only, hf_order_type | 是 |
POST /linear-swap-api/v1/swap_cross_order | 下单(全仓) | contract_code, client_order_id, price, volume, direction, offset, lever_rate, order_price_type | tp_trigger_price, tp_order_price, tp_order_price_type, sl_trigger_price, sl_order_price, sl_order_price_type, reduce_only, hf_order_type | 是 |
POST /linear-swap-api/v1/swap_cross_batch_orders | 批量下单(全仓) | orders_data | 无 | 是 |
POST /linear-swap-api/v1/swap_cancel | 撤单(逐仓) | contract_code, order_id | client_order_id | 是 |
POST /linear-swap-api/v1/swap_cross_cancel | 撤单(全仓) | order_id | contract_code, client_order_id | 是 |
POST /linear-swap-api/v1/swap_cancelall | 全部撤单(逐仓) | contract_code | direction, offset | 是 |
POST /linear-swap-api/v1/swap_cross_cancelall | 全部撤单(全仓) | 无 | contract_code, direction, offset | 是 |
POST /linear-swap-api/v1/swap_switch_lever_rate | 切换杠杆(逐仓) | contract_code, lever_rate | 无 | 是 |
POST /linear-swap-api/v1/swap_cross_switch_lever_rate | 切换杠杆(全仓) | lever_rate | contract_code | 是 |
POST /linear-swap-api/v1/swap_order_info | 获取订单信息(逐仓) | contract_code, order_id | client_order_id | 是 |
POST /linear-swap-api/v1/swap_cross_order_info | 获取订单信息(全仓) | order_id | contract_code, client_order_id | 是 |
POST /linear-swap-api/v1/swap_order_detail | 获取订单详情(逐仓) | contract_code, order_id | created_at, page_index, page_size, client_order_id | 是 |
POST /linear-swap-api/v1/swap_cross_order_detail | 获取详细信息(全仓) | order_id | contract_code, created_at, page_index, page_size, client_order_id | 是 |
POST /linear-swap-api/v1/swap_openorders | 当前未成交订单(逐仓) | contract_code | page_index, page_size | 是 |
POST /linear-swap-api/v1/swap_cross_openorders | 当前未成交订单(全仓) | 无 | contract_code, page_index, page_size | 是 |
POST /linear-swap-api/v3/swap_hisorders | 获取历史订单(逐仓) | contract_code, trade_type | type, start_time, end_time, direct, page_index, page_size, sort_by | 是 |
POST /linear-swap-api/v3/swap_cross_hisorders | 获取历史订单(全仓) | trade_type | contract_code, type, start_time, end_time, direct, page_index, page_size, sort_by | 是 |
POST /linear-swap-api/v3/swap_hisorders_exact | 通过字段查询历史订单(逐仓) | contract_code, trade_type | type, start_time, end_time, direct, page_index, page_size, sort_by | 是 |
POST /linear-swap-api/v3/swap_cross_hisorders_exact | 通过字段查询历史订单(全仓) | trade_type | contract_code, type, start_time, end_time, direct, page_index, page_size, sort_by | 是 |
POST /linear-swap-api/v3/swap_matchresults | 历史成交结果(逐仓) | contract_code, trade_type | start_time, end_time, page_index, page_size, direct | 是 |
POST /linear-swap-api/v3/swap_cross_matchresults | 历史成交结果(全仓) | trade_type | contract_code, start_time, end_time, page_index, page_size, direct | 是 |
POST /linear-swap-api/v3/swap_matchresults_exact | 通过字段查询成交结果(逐仓) | contract_code, trade_type | start_time, end_time, page_index, page_size, direct | 是 |
POST /linear-swap-api/v3/swap_cross_matchresults_exact | 通过字段查询成交结果(全仓) | trade_type | contract_code, start_time, end_time, page_index, page_size, direct | 是 |
POST /linear-swap-api/v1/swap_lightning_close_position | 闪电平仓订单(逐仓) | contract_code, volume, direction | client_order_id, order_price_type | 是 |
POST /linear-swap-api/v1/swap_cross_lightning_close_position | 闪电平仓(全仓) | contract_code, volume, direction | client_order_id, order_price_type | 是 |
GET /linear-swap-api/v1/swap_position_side | 查询持仓模式(逐仓) | contract_code | 无 | 是 |
GET /linear-swap-api/v1/swap_cross_position_side | 查询持仓模式(全仓) | 无 | contract_code | 是 |
| 端点 | 描述 | 必填参数 | 可选参数 | 身份验证 |
|---|---|---|---|---|
POST /linear-swap-api/v1/swap_trigger_order | 下触发订单(逐仓) | contract_code, trigger_type, trigger_price, order_price, volume, direction, offset, lever_rate, order_price_type | client_order_id | 是 |
POST /linear-swap-api/v1/swap_cross_trigger_order | 下触发订单(全仓) | contract_code, trigger_type, trigger_price, order_price, volume, direction, offset, lever_rate, order_price_type | client_order_id | 是 |
POST /linear-swap-api/v1/swap_trigger_cancel | 取消触发订单(逐仓) | contract_code, order_id | client_order_id | 是 |
POST /linear-swap-api/v1/swap_cross_trigger_cancel | 取消触发订单(全仓) | order_id | contract_code, client_order_id | 是 |
POST /linear-swap-api/v1/swap_trigger_cancelall | 取消所有触发订单(逐仓) | contract_code | direction, offset | 是 |
POST /linear-swap-api/v1/swap_cross_trigger_cancelall | 取消所有触发订单(全仓) | 无 | contract_code, direction, offset | 是 |
POST /linear-swap-api/v1/swap_trigger_openorders | 查询触发订单未成交订单(逐仓) | contract_code | page_index, page_size | 是 |
POST /linear-swap-api/v1/swap_cross_trigger_openorders | 查询触发订单未成交订单(全仓) | 无 | contract_code, page_index, page_size | 是 |
POST /linear-swap-api/v1/swap_trigger_hisorders | 查询触发订单历史(逐仓) | contract_code | trigger_type, status, page_index, page_size, sort_by, direct | 是 |
POST /linear-swap-api/v1/swap_cross_trigger_hisorders | 查询触发订单历史(全仓) | 无 | contract_code, trigger_type, status, page_index, page_size, sort_by, direct | 是 |
POST /linear-swap-api/v1/swap_tpsl_order | 设置止盈止损订单(逐仓) | contract_code, volume, tp_trigger_price, tp_order_price, sl_trigger_price, sl_order_price, direction | tp_order_price_type, sl_order_price_type, client_order_id | 是 |
POST /linear-swap-api/v1/swap_cross_tpsl_order | 设置止盈止损订单(全仓) | contract_code, volume, tp_trigger_price, tp_order_price, sl_trigger_price, sl_order_price, direction | tp_order_price_type, sl_order_price_type, client_order_id | 是 |
POST /linear-swap-api/v1/swap_tpsl_cancel | 取消止盈止损订单(逐仓) | contract_code, order_id | client_order_id | 是 |
POST /linear-swap-api/v1/swap_cross_tpsl_cancel | 取消止盈止损订单(全仓) | order_id | contract_code, client_order_id | 是 |
POST /linear-swap-api/v1/swap_tpsl_cancelall | 取消所有止盈止损订单(逐仓) | contract_code | 无 | 是 |
POST /linear-swap-api/v1/swap_cross_tpsl_cancelall | 取消所有止盈止损订单(全仓) | 无 | contract_code | 是 |
POST /linear-swap-api/v1/swap_tpsl_openorders | 查询未成交止盈止损订单(逐仓) | contract_code | page_index, page_size | 是 |
POST /linear-swap-api/v1/swap_cross_tpsl_openorders | 查询未成交止盈止损订单(全仓) | 无 | contract_code, page_index, page_size | 是 |
POST /linear-swap-api/v1/swap_tpsl_hisorders | 查询止盈止损历史订单(逐仓) | contract_code | status, page_index, page_size, sort_by, direct | 是 |
POST /linear-swap-api/v1/swap_cross_tpsl_hisorders | 查询止盈止损历史订单(全仓) | 无 | contract_code, status, page_index, page_size, sort_by, direct | 是 |
| 端点 | 描述 | 必填参数 | 可选参数 | 身份验证 |
|---|---|---|---|---|
POST /linear-swap-api/v1/swap_cross_transfer_state | 查询划转状态(全仓) | 无 | 无 | 是 |
对于需要身份验证的端点,您需要提供 HTX API 凭证。
所需凭证:
所有需要身份验证的端点都需要 HMAC SHA256 签名:
按以下顺序创建待签名字符串:
在所有需要身份验证的请求中附加以下必需参数:
使用 secretKey 通过 HMAC SHA256 对待签名字符串进行签名
将签名作为 Signature 参数附加到查询字符串
对于 POST 请求,还需要在 URL 查询字符串中包含签名
示例待签名字符串:
POST\\n
api.hbdm.com\\n
/linear-swap-api/v1/swap_order\\n
AccessKeyId=xxx&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2017-05-11T15:19:30
用户可以通过发送文件来提供 HTX API 凭证,文件内容格式如下:
fe45419a...xyz
secretabc...key
向用户显示凭证时:
fe45419a...xyz***...key1当被问及凭证时的示例响应:
账户: main
API 密钥: fe45419a...xyz
密钥: ***...key1
环境: 主网
列出账户时,仅显示名称和环境 — 切勿显示密钥:
HTX 账户:
* main (主网)
* trading (主网 - AWS)
在主网执行交易时,务必在继续之前通过要求用户输入 "CONFIRM" 来与用户确认。
## HTX 账户
### main
- API 密钥: fe45419a...xyz
- 密钥: secretabc...key
- 环境: https://api.hbdm.com
- 描述: 主要的 USDT-M 期货交易账户
### trading
- API 密钥: test456...abc
- 密钥: testsecret...xyz
- 环境: https://api.hbdm.vn
- 描述: AWS 优化的 USDT-M 期货交易
当用户提供新凭证时:
TOOLS.md 中,并显示掩码后的确认信息包含 User-Agent 头部,使用以下字符串:htx-usdt-m-futures/1.0.0 (Skill)
volume 参数代表合约张数每周安装数
68
代码仓库
GitHub 星标数
9
首次出现
12 天前
安全审计
安装于
opencode68
codex68
kimi-cli67
gemini-cli67
amp67
cline67
USDT-M Futures trading on HTX using authenticated and public API endpoints. Return the result in JSON format.
Complete API endpoints for HTX USDT-M Futures. All endpoints use base URL https://api.hbdm.com (or https://api.hbdm.vn for AWS).
| Endpoint | Description | Required | Optional | Authentication |
|---|---|---|---|---|
GET /linear-swap-api/v3/swap_unified_account_type | Account type query | None | None | Yes |
POST /linear-swap-api/v3/swap_switch_account_type | Account Type Change | account_type | None | Yes |
GET /linear-swap-api/v1/swap_funding_rate | Query funding rate | contract_code | None | No |
GET /linear-swap-api/v1/swap_batch_funding_rate | Query a Batch of Funding Rate | contract_code | None | No |
GET /linear-swap-api/v1/swap_historical_funding_rate | Query historical funding rate | contract_code | page_index, page_size | No |
GET /linear-swap-api/v1/swap_liquidation_orders | Query Liquidation Orders | contract_code | trade_type, create_date, page_index, page_size | No |
GET /linear-swap-api/v1/swap_settlement_records | Query historical settlement records | contract_code | page_index, page_size | No |
GET /linear-swap-api/v1/swap_elite_account_ratio | Query Top Trader Sentiment Index (Account) | contract_code | period | No |
GET /linear-swap-api/v1/swap_elite_position_ratio | Query Top Trader Sentiment Index (Position) | contract_code | period | No |
GET /linear-swap-api/v1/swap_system_status | Query information on system status (Isolated) | contract_code | None | No |
POST /linear-swap-api/v1/swap_cross_tiered_margin_info | Query information on Tiered Margin (Cross) | None | None | Yes |
POST /linear-swap-api/v1/swap_tiered_margin_info | Query information on Tiered Margin (Isolated) | contract_code | None | Yes |
GET /linear-swap-api/v1/swap_estimated_settlement_price | Get the estimated settlement price | contract_code | None | No |
POST /linear-swap-api/v1/swap_adjustment_factor | Query Tiered Adjustment Factor (Isolated) | contract_code | None | Yes |
POST /linear-swap-api/v1/swap_cross_adjustment_factor | Query Tiered Adjustment Factor (Cross) | None | None | Yes |
GET /v1/insurance_fund_info | Query risk reserve balance information | contract_code | None | No |
GET /v1/insurance_fund_history | Query historical risk reserves | contract_code | page_index, page_size | No |
GET /linear-swap-api/v1/swap_price_limit | Query Swap Price Limitation | contract_code | None | No |
GET /linear-swap-api/v1/swap_open_interest | Get Swap Open Interest Information | contract_code | None | No |
GET /linear-swap-api/v1/swap_contract_info | Query Contract Info | contract_code | None | No |
GET /linear-swap-api/v1/swap_index | Query Swap Index Price Information | contract_code | None | No |
GET /linear-swap-api/market/swap_contract_constituents | Get index components | index_code | None | No |
GET /linear-swap-api/v1/swap_query_elements | Contract Elements | contract_code | None | No |
GET /linear-swap-api/v1/swap_timestamp | Get current system timestamp | None | None | No |
GET https://api.hbdm.com/heartbeat/ | Query whether the system is available | None | None | No |
| Endpoint | Description | Required | Optional | Authentication |
|---|---|---|---|---|
GET /linear-swap-ex/market/depth | Get Market Depth | contract_code | type | No |
GET /linear-swap-ex/market/bbo | Get Market BBO Data | contract_code | None | No |
GET /linear-swap-ex/market/kline | Get KLine Data | contract_code, period | size, from, to | No |
GET /linear-swap-ex/market/mark_price_kline |
| Endpoint | Description | Required | Optional | Authentication |
|---|---|---|---|---|
POST /linear-swap-api/v1/swap_account_info | Query Asset Valuation | None | valuation_asset | Yes |
POST /linear-swap-api/v1/swap_account_info | Query Account Information (Isolated) | contract_code | None | Yes |
POST /linear-swap-api/v1/swap_cross_account_info | Query Account Information (Cross) | None | valuation_asset | Yes |
| POST |
| Endpoint | Description | Required | Optional | Authentication |
|---|---|---|---|---|
POST /linear-swap-api/v1/swap_cross_query_trade_state | Query Trade State (Cross) | None | None | Yes |
POST /linear-swap-api/v1/swap_switch_position_mode | Switch Position Mode (Isolated) | contract_code, mode | None | Yes |
POST /linear-swap-api/v1/swap_cross_switch_position_mode | Switch Position Mode (Cross) | mode | contract_code | Yes |
| POST |
| Endpoint | Description | Required | Optional | Authentication |
|---|---|---|---|---|
POST /linear-swap-api/v1/swap_trigger_order | Place Trigger Order (Isolated) | contract_code, trigger_type, trigger_price, order_price, volume, direction, offset, lever_rate, order_price_type | client_order_id | Yes |
POST /linear-swap-api/v1/swap_cross_trigger_order | Place Trigger Order (Cross) | contract_code, trigger_type, trigger_price, order_price, volume, direction, offset, lever_rate, order_price_type | client_order_id | Yes |
POST /linear-swap-api/v1/swap_trigger_cancel | Cancel Trigger Order (Isolated) | contract_code, order_id | client_order_id |
| Endpoint | Description | Required | Optional | Authentication |
|---|---|---|---|---|
POST /linear-swap-api/v1/swap_cross_transfer_state | Query Transfer State (Cross) | None | None | Yes |
For endpoints that require authentication, you will need to provide HTX API credentials.
Required credentials:
All authenticated endpoints require HMAC SHA256 signature:
Create the pre-sign string in the following order:
Append required parameters to all authenticated requests:
Sign the pre-sign string with secretKey using HMAC SHA256
Append signature to query string as Signature parameter
For POST requests, also include signature in the URL query string
Example pre-sign string:
POST\\n
api.hbdm.com\\n
/linear-swap-api/v1/swap_order\\n
AccessKeyId=xxx&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2017-05-11T15:19:30
Users can provide HTX API credentials by sending a file where the content is in the following format:
fe45419a...xyz
secretabc...key
When showing credentials to users:
fe45419a...xyz***...key1Example response when asked for credentials:
Account: main
API Key: fe45419a...xyz
Secret: ***...key1
Environment: Mainnet
When listing accounts, show names and environment only — never keys:
HTX Accounts:
* main (Mainnet)
* trading (Mainnet - AWS)
When performing transactions in mainnet, always confirm with the user before proceeding by asking them to write "CONFIRM" to proceed.
## HTX Accounts
### main
- API Key: fe45419a...xyz
- Secret: secretabc...key
- Environment: https://api.hbdm.com
- Description: Primary USDT-M Futures trading account
### trading
- API Key: test456...abc
- Secret: testsecret...xyz
- Environment: https://api.hbdm.vn
- Description: AWS optimized USDT-M Futures trading
When user provides new credentials:
TOOLS.md with masked display confirmationInclude User-Agent header with the following string: htx-usdt-m-futures/1.0.0 (Skill)
volume parameter represents the number of contractsWeekly Installs
68
Repository
GitHub Stars
9
First Seen
12 days ago
Security Audits
Gen Agent Trust HubPassSocketPassSnykFail
Installed on
opencode68
codex68
kimi-cli67
gemini-cli67
amp67
cline67
Lark CLI IM 即时消息管理工具:机器人/用户身份操作聊天、消息、文件下载
41,800 周安装
| Get Kline Data of Mark Price |
| contract_code, period |
| size, from, to |
| No |
GET /linear-swap-ex/market/overview | Get Market Data Overview | contract_code | None | No |
GET /linear-swap-ex/market/batch_overview | Get a Batch of Market Data Overview | contract_code | None | No |
GET /linear-swap-ex/market/trade | Query The Last Trade of a Contract | contract_code | None | No |
GET /linear-swap-ex/market/trades | Query a Batch of Trade Records | contract_code | size | No |
GET /linear-swap-ex/market/open_interest | Query information on open interest | contract_code | None | No |
GET /linear-swap-ex/market/premium_index_kline | Query Premium Index Kline Data | contract_code, period | size, from, to | No |
GET /linear-swap-ex/market/estimated_funding_rate_kline | Query Estimated Funding Rate Kline | contract_code, period | size, from, to | No |
/linear-swap-api/v1/swap_position_info| Query Position Information (Isolated) |
| contract_code |
| None |
| Yes |
POST /linear-swap-api/v1/swap_cross_position_info | Query Position Information (Cross) | None | contract_code | Yes |
POST /linear-swap-api/v1/swap_account_position_info | Query Assets And Positions (Isolated) | contract_code | None | Yes |
POST /linear-swap-api/v1/swap_cross_account_position_info | Query Assets And Positions (Cross) | None | valuation_asset | Yes |
POST /linear-swap-api/v1/swap_sub_account_list | Set Sub-Account Trading Permissions | sub_uid | trades | Yes |
POST /linear-swap-api/v1/swap_account_info_list | Query all sub-accounts (Isolated) | None | None | Yes |
POST /linear-swap-api/v1/swap_cross_account_info_list | Query all sub-accounts (Cross) | None | valuation_asset | Yes |
POST /linear-swap-api/v1/swap_account_info_sub | Query single sub-account (Isolated) | contract_code, sub_uid | None | Yes |
POST /linear-swap-api/v1/swap_cross_account_info_sub | Query sub-account (Cross) | sub_uid | valuation_asset | Yes |
POST /linear-swap-api/v1/swap_position_info_sub | Query sub-account position (Isolated) | contract_code, sub_uid | None | Yes |
POST /linear-swap-api/v1/swap_cross_position_info_sub | Query sub-account position (Cross) | sub_uid | contract_code | Yes |
POST /linear-swap-api/v3/swap_financial_record | Query account financial records | None | contract_code, type, start_time, end_time, page_index, page_size, direct | Yes |
POST /linear-swap-api/v3/swap_financial_record_exact | Query financial records via fields | None | contract_code, type, start_time, end_time, page_index, page_size, direct | Yes |
POST /linear-swap-api/v1/swap_available_level_rate | Query available leverage (Isolated) | contract_code | None | Yes |
POST /linear-swap-api/v1/swap_cross_available_level_rate | Query available leverage (Cross) | None | None | Yes |
POST /linear-swap-api/v1/swap_order_limit | Query order limit | None | contract_code, order_price_type | Yes |
POST /linear-swap-api/v1/swap_fee | Query swap trading fee | None | contract_code | Yes |
POST /linear-swap-api/v1/swap_transfer_limit | Query transfer limit (Isolated) | contract_code | None | Yes |
POST /linear-swap-api/v1/swap_cross_transfer_limit | Query transfer limit (Cross) | None | None | Yes |
POST /linear-swap-api/v1/swap_position_limit | Query position limit (Isolated) | contract_code | None | Yes |
POST /linear-swap-api/v1/swap_cross_position_limit | Query position limit (Cross) | None | None | Yes |
POST /linear-swap-api/v1/swap_lever_position_limit | Query position limit all leverages (Isolated) | contract_code | None | Yes |
POST /linear-swap-api/v1/swap_cross_lever_position_limit | Query position limit all leverages (Cross) | None | None | Yes |
POST /linear-swap-api/v1/swap_master_sub_transfer | Transfer between master and sub | sub_uid, asset, amount, type | client_order_id | Yes |
POST /linear-swap-api/v1/swap_master_sub_transfer_record | Query transfer records | None | sub_uid, transfer_type, page_index, page_size, direct, sort_by | Yes |
POST /linear-swap-api/v1/swap_transfer_inner | Transfer between margin accounts | asset, amount, from_margin_account, to_margin_account | client_order_id | Yes |
GET /linear-swap-api/v1/swap_api_trading_status | Query API indicator disable info | None | None | Yes |
POST /linear-swap-api/v1/linear-cancel-after | Automatic Order Cancellation | timeout | contract_code | Yes |
/linear-swap-api/v1/swap_order| Place an Order (Isolated) |
| contract_code, client_order_id, price, volume, direction, offset, lever_rate, order_price_type |
| tp_trigger_price, tp_order_price, tp_order_price_type, sl_trigger_price, sl_order_price, sl_order_price_type, reduce_only, hf_order_type |
| Yes |
POST /linear-swap-api/v1/swap_cross_order | Place An Order (Cross) | contract_code, client_order_id, price, volume, direction, offset, lever_rate, order_price_type | tp_trigger_price, tp_order_price, tp_order_price_type, sl_trigger_price, sl_order_price, sl_order_price_type, reduce_only, hf_order_type | Yes |
POST /linear-swap-api/v1/swap_cross_batch_orders | Place A Batch Of Orders (Cross) | orders_data | None | Yes |
POST /linear-swap-api/v1/swap_cancel | Cancel an Order (Isolated) | contract_code, order_id | client_order_id | Yes |
POST /linear-swap-api/v1/swap_cross_cancel | Cancel An Order (Cross) | order_id | contract_code, client_order_id | Yes |
POST /linear-swap-api/v1/swap_cancelall | Cancel All Orders (Isolated) | contract_code | direction, offset | Yes |
POST /linear-swap-api/v1/swap_cross_cancelall | Cancel All Orders (Cross) | None | contract_code, direction, offset | Yes |
POST /linear-swap-api/v1/swap_switch_lever_rate | Switch Leverage (Isolated) | contract_code, lever_rate | None | Yes |
POST /linear-swap-api/v1/swap_cross_switch_lever_rate | Switch Leverage (Cross) | lever_rate | contract_code | Yes |
POST /linear-swap-api/v1/swap_order_info | Get Information of an Order (Isolated) | contract_code, order_id | client_order_id | Yes |
POST /linear-swap-api/v1/swap_cross_order_info | Get Information of order (Cross) | order_id | contract_code, client_order_id | Yes |
POST /linear-swap-api/v1/swap_order_detail | Order details acquisition (Isolated) | contract_code, order_id | created_at, page_index, page_size, client_order_id | Yes |
POST /linear-swap-api/v1/swap_cross_order_detail | Get Detail Information (Cross) | order_id | contract_code, created_at, page_index, page_size, client_order_id | Yes |
POST /linear-swap-api/v1/swap_openorders | Current unfilled orders (Isolated) | contract_code | page_index, page_size | Yes |
POST /linear-swap-api/v1/swap_cross_openorders | Current unfilled orders (Cross) | None | contract_code, page_index, page_size | Yes |
POST /linear-swap-api/v3/swap_hisorders | Get History Orders (Isolated) | contract_code, trade_type | type, start_time, end_time, direct, page_index, page_size, sort_by | Yes |
POST /linear-swap-api/v3/swap_cross_hisorders | Get History Orders (Cross) | trade_type | contract_code, type, start_time, end_time, direct, page_index, page_size, sort_by | Yes |
POST /linear-swap-api/v3/swap_hisorders_exact | History Orders via Fields (Isolated) | contract_code, trade_type | type, start_time, end_time, direct, page_index, page_size, sort_by | Yes |
POST /linear-swap-api/v3/swap_cross_hisorders_exact | History Orders via Fields (Cross) | trade_type | contract_code, type, start_time, end_time, direct, page_index, page_size, sort_by | Yes |
POST /linear-swap-api/v3/swap_matchresults | History Match Results (Isolated) | contract_code, trade_type | start_time, end_time, page_index, page_size, direct | Yes |
POST /linear-swap-api/v3/swap_cross_matchresults | History Match Results (Cross) | trade_type | contract_code, start_time, end_time, page_index, page_size, direct | Yes |
POST /linear-swap-api/v3/swap_matchresults_exact | Match Results via Fields (Isolated) | contract_code, trade_type | start_time, end_time, page_index, page_size, direct | Yes |
POST /linear-swap-api/v3/swap_cross_matchresults_exact | Match Results via Fields (Cross) | trade_type | contract_code, start_time, end_time, page_index, page_size, direct | Yes |
POST /linear-swap-api/v1/swap_lightning_close_position | Lightning Close Order (Isolated) | contract_code, volume, direction | client_order_id, order_price_type | Yes |
POST /linear-swap-api/v1/swap_cross_lightning_close_position | Lightning Close Position (Cross) | contract_code, volume, direction | client_order_id, order_price_type | Yes |
GET /linear-swap-api/v1/swap_position_side | Query position mode (Isolated) | contract_code | None | Yes |
GET /linear-swap-api/v1/swap_cross_position_side | Query position mode (Cross) | None | contract_code | Yes |
| Yes |
POST /linear-swap-api/v1/swap_cross_trigger_cancel | Cancel Trigger Order (Cross) | order_id | contract_code, client_order_id | Yes |
POST /linear-swap-api/v1/swap_trigger_cancelall | Cancel All Trigger Orders (Isolated) | contract_code | direction, offset | Yes |
POST /linear-swap-api/v1/swap_cross_trigger_cancelall | Cancel All Trigger Orders (Cross) | None | contract_code, direction, offset | Yes |
POST /linear-swap-api/v1/swap_trigger_openorders | Query Trigger Order Open Orders (Isolated) | contract_code | page_index, page_size | Yes |
POST /linear-swap-api/v1/swap_cross_trigger_openorders | Query Trigger Order Open Orders (Cross) | None | contract_code, page_index, page_size | Yes |
POST /linear-swap-api/v1/swap_trigger_hisorders | Query Trigger Order History (Isolated) | contract_code | trigger_type, status, page_index, page_size, sort_by, direct | Yes |
POST /linear-swap-api/v1/swap_cross_trigger_hisorders | Query Trigger Order History (Cross) | None | contract_code, trigger_type, status, page_index, page_size, sort_by, direct | Yes |
POST /linear-swap-api/v1/swap_tpsl_order | Set TP/SL Order (Isolated) | contract_code, volume, tp_trigger_price, tp_order_price, sl_trigger_price, sl_order_price, direction | tp_order_price_type, sl_order_price_type, client_order_id | Yes |
POST /linear-swap-api/v1/swap_cross_tpsl_order | Set TP/SL Order (Cross) | contract_code, volume, tp_trigger_price, tp_order_price, sl_trigger_price, sl_order_price, direction | tp_order_price_type, sl_order_price_type, client_order_id | Yes |
POST /linear-swap-api/v1/swap_tpsl_cancel | Cancel TP/SL Order (Isolated) | contract_code, order_id | client_order_id | Yes |
POST /linear-swap-api/v1/swap_cross_tpsl_cancel | Cancel TP/SL Order (Cross) | order_id | contract_code, client_order_id | Yes |
POST /linear-swap-api/v1/swap_tpsl_cancelall | Cancel all TP/SL Orders (Isolated) | contract_code | None | Yes |
POST /linear-swap-api/v1/swap_cross_tpsl_cancelall | Cancel all TP/SL Orders (Cross) | None | contract_code | Yes |
POST /linear-swap-api/v1/swap_tpsl_openorders | Query Open TP/SL Orders (Isolated) | contract_code | page_index, page_size | Yes |
POST /linear-swap-api/v1/swap_cross_tpsl_openorders | Query Open TP/SL Orders (Cross) | None | contract_code, page_index, page_size | Yes |
POST /linear-swap-api/v1/swap_tpsl_hisorders | Query TP/SL History Orders (Isolated) | contract_code | status, page_index, page_size, sort_by, direct | Yes |
POST /linear-swap-api/v1/swap_cross_tpsl_hisorders | Query TP/SL History Orders (Cross) | None | contract_code, status, page_index, page_size, sort_by, direct | Yes |