usdt-m-futures

HTX USDT-M Futures スキル

認証済みおよび公開 API エンドポイントを使用した HTX USDT-M Futures の取引です。結果は JSON 形式で返します。

ベース URL

• メインネット：https://api.hbdm.com
• メインネット（AWS）：https://api.hbdm.vn

クイックリファレンス

HTX USDT-M Futures のすべての API エンドポイントです。すべてのエンドポイントで、ベース URL https://api.hbdm.com（AWS の場合は https://api.hbdm.vn）を使用します。

参照データ

エンドポイント	説明	必須	任意	認証
GET /linear-swap-api/v3/swap_unified_account_type	アカウントタイプの照会	なし	なし	はい
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	市場の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	TP/SL 注文を設定（分離マージン）	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	TP/SL 注文を設定（クロスマージン）	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	TP/SL 注文をキャンセル（分離マージン）	contract_code, order_id	client_order_id	はい
POST /linear-swap-api/v1/swap_cross_tpsl_cancel	TP/SL 注文をキャンセル（クロスマージン）	order_id	contract_code, client_order_id	はい
POST /linear-swap-api/v1/swap_tpsl_cancelall	すべての TP/SL 注文をキャンセル（分離マージン）	contract_code	なし	はい
POST /linear-swap-api/v1/swap_cross_tpsl_cancelall	すべての TP/SL 注文をキャンセル（クロスマージン）	なし	contract_code	はい
POST /linear-swap-api/v1/swap_tpsl_openorders	未決済の TP/SL 注文を照会（分離マージン）	contract_code	page_index, page_size	はい
POST /linear-swap-api/v1/swap_cross_tpsl_openorders	未決済の TP/SL 注文を照会（クロスマージン）	なし	contract_code, page_index, page_size	はい
POST /linear-swap-api/v1/swap_tpsl_hisorders	TP/SL 注文の履歴を照会（分離マージン）	contract_code	status, page_index, page_size, sort_by, direct	はい
POST /linear-swap-api/v1/swap_cross_tpsl_hisorders	TP/SL 注文の履歴を照会（クロスマージン）	なし	contract_code, status, page_index, page_size, sort_by, direct	はい

資金振替インターフェース

エンドポイント	説明	必須	任意	認証
POST /linear-swap-api/v1/swap_cross_transfer_state	振替状況を照会（クロスマージン）	なし	なし	はい

---

パラメーター

共通パラメーター

契約とシンボル

• contract_code：契約コード（例：BTC-USDT、ETH-USDT）
• symbol：シンボル名
• pair：取引ペア（例：BTC-USDT）
• contract_type：契約タイプ（swap、this_week、next_week、quarter、next_quarter）
• business_type：取引タイプ（futures、swap、all）

アカウントと証拠金

• margin_account：証拠金アカウント識別子
• margin_mode：証拠金モード（cross、isolated）
• margin_asset：証拠金資産（例：USDT）
• account_type：アカウントタイプ

注文パラメーター

• order_id：注文 ID（複数の注文の場合はカンマ区切りで指定できます）
• client_order_id：クライアントが定義した注文 ID
• order_source：注文ソース
• order_type：注文タイプ
• order_price_type：注文価格タイプ（limit、optimal_5、optimal_10、optimal_20、post_only、fok、ioc など）
• direction：取引方向（buy、sell）
• offset：オフセット方向（open、close、both）
• volume：注文数量（契約数）
• price：注文価格
• lever_rate：レバレッジ率
• reduce_only：決済のみフラグ（0：いいえ、1：はい）

トリガー注文パラメーター

• trigger_type：トリガータイプ（ge：以上、le：以下）
• trigger_price：トリガー価格
• triggered_price：トリガー注文が約定したときの価格

利益確定と損切りのパラメーター

• tp_trigger_price：利益確定注文のトリガー価格
• tp_order_price：利益確定注文の注文価格
• tp_order_price_type：利益確定注文の注文タイプ
• sl_trigger_price：損切り注文のトリガー価格
• sl_order_price：損切り注文の注文価格
• sl_order_price_type：損切り注文の注文タイプ
• price_protect：価格保護（ブール値）

トレーリング注文パラメーター

• callback_rate：トレーリング注文のコールバック率
• active_price：トレーリング注文の有効化価格
• is_active：有効化価格が有効になっているかどうか

クエリパラメーター

• page_index：ページ番号（デフォルト：1）
• page_size：ページサイズ（デフォルト：20、最大：50）
• start_time：開始時刻（ミリ秒単位の Unix タイムスタンプ）
• end_time：終了時刻（ミリ秒単位の Unix タイムスタンプ）
• create_date：日数
• direct：検索方向（NEXT：昇順、PREV：降順）
• from_id：ページネーションの開始 ID
• sort_by：ソートフィールド（降順）

サブアカウントのパラメーター

• sub_uid：サブアカウントの UID
• sub_auth：サブアカウントの認証（0：無効、1：有効）

振替パラメーター

• from：振替元アカウント（例：spot、linear-swap）
• to：振替先アカウント（例：spot、linear-swap）
• currency：振替通貨
• amount：振替額
• from_margin_account：振替元の証拠金アカウント
• to_margin_account：振替先の証拠金アカウント

市場データのパラメーター

• period：K 線の期間（1min、5min、15min、30min、60min、4hour、1day、1mon、1week、1year）
• type：板の深さのタイプ（step0-step19）
• size：返されるレコード数

その他のパラメーター

• trade_type：取引タイプ（0：すべて、1：ロングの新規建て、2：ショートの新規建て、3：ショートの決済、4：ロングの決済）
• status：注文ステータス（複数のステータスはカンマ区切りで指定できます）
• self_match_prevent：自己約定防止フラグ
• self_match_prevent_new：自己取引の防止

列挙値

注文タイプ

• order_price_type：limit、optimal_5、optimal_10、optimal_20、post_only、fok、ioc、opponent、lightning、optimal_5_fok、optimal_5_ioc、optimal_10_fok、optimal_10_ioc、optimal_20_fok、optimal_20_ioc、opponent_ioc、opponent_fok

注文ステータス

• status：submitted（3）、partial-filled（4）、partial-canceled（5）、filled（6）、canceled（7）、送信準備完了（1）、受理済み（2）

方向とオフセット

• direction：buy、sell
• offset：open、close、both

証拠金モード

• margin_mode：isolated、cross

契約タイプ

• contract_type：swap（無期限）、this_week、next_week、quarter（当四半期）、next_quarter

ポジションモード

• position_mode：dual_side（ヘッジモード）、single_side（ワンウェイモード）

---

認証

認証が必要なエンドポイントでは、HTX API の認証情報を指定する必要があります。

必要な認証情報：

• apiKey：HTX API キー
• secretKey：HTX API シークレット（署名用）

認証が必要なすべてのエンドポイントでは、HMAC SHA256 署名が必要です。

1. 次の順序で署名対象文字列を作成します。

   • HTTP メソッド（GET/POST） + "\n"
   • API ホスト（例：api.hbdm.com） + "\n"
   • API パス（例：/linear-swap-api/v1/swap_order） + "\n"
   • ソート済みのクエリ文字列パラメーター

2. 認証が必要なすべてのリクエストに、次の必須パラメーターを追加します。

   • AccessKeyId：API キー
   • SignatureMethod：HmacSHA256
   • SignatureVersion：2
   • Timestamp：UTC タイムスタンプ（形式：yyyy-MM-ddTHH:mm:ss）

3. secretKey を使い、HMAC SHA256 で署名対象文字列に署名します。

4. Signature パラメーターとして、クエリ文字列に署名を追加します。

5. 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

シークレット全体を表示しない

ユーザーに認証情報を表示する際：

• API キー： 先頭 5 文字と末尾 4 文字を表示します：fe45419a...xyz
• シークレットキー： 常にマスクし、末尾 5 文字のみ表示します：***...key1

認証情報を尋ねられた際の回答例：

Account: main
API Key: fe45419a...xyz
Secret: ***...key1
Environment: Mainnet

アカウントの一覧表示

アカウントを一覧表示する際は、名前と環境のみを表示し、キーは絶対に表示しないでください：

HTX Accounts:
* main (Mainnet)
* trading (Mainnet - AWS)

メインネットでの取引

メインネットで取引を実行する前に、必ずユーザーに「CONFIRM」と入力して続行するよう求め、確認を取ってください。

---

HTX アカウント

main

• API キー：your_mainnet_api_key
• シークレット：your_mainnet_secret
• 環境：https://api.hbdm.com
• 説明：USDT-M Futures の主要な取引アカウント

trading

• API キー：your_aws_api_key
• シークレット：your_aws_secret
• 環境：https://api.hbdm.vn
• 説明：AWS 最適化 USDT-M Futures 取引

TOOLS.md の構成

## 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

エージェントの動作

1. 認証情報を尋ねられた場合：シークレットをマスクし、末尾 5 文字のみ表示します。
2. アカウントの一覧表示：名前と環境を表示し、キーは絶対に表示しません。
3. アカウントの選択：曖昧な場合は尋ね、デフォルトでは main を選択します。
4. メインネットで取引を行う場合：「CONFIRM」と入力して続行するようユーザーに求め、事前に確認を取ります。
5. 新しい認証情報：名前と環境を尋ねます。

アカウントの追加

ユーザーから新しい認証情報が提供された場合：

• アカウント名を尋ねます。
• 環境（Mainnet または Mainnet-AWS）を尋ねます。
• マスクした表示を確認したうえで、TOOLS.md に保存します。

User Agent ヘッダー

次の文字列を含む User-Agent ヘッダーを設定します：htx-usdt-m-futures/1.0.0 (Skill)

重要な注意事項

• 特に指定がない限り、すべてのタイムスタンプは Unix ミリ秒単位です。
• コントラクトコードは大文字を使用します（例：btc-usdt ではなく BTC-USDT）。
• 成行買い注文の場合、volume パラメーターはコントラクト数を表します。
• 取引の前に、適切なエンドポイントからアカウント ID を取得する必要があります。
• レート制限が適用されます。詳細は HTX API のドキュメントを参照してください。
• 認証が必要なリクエストごとに署名を計算する必要があります。
• 署名のタイムスタンプは、サーバー時刻との誤差が 1 分以内でなければなりません。
• 分離マージンモードとクロスマージンモードの両方がサポートされています。
• ポジションモード：single_side（ワンウェイ）および dual_side（ヘッジ）
• 操作には、必ず正しいマージンモードとマージンアカウントを使用してください。
• クロスマージン操作では、パスに「cross」を含むエンドポイントを使用します。
• 分離マージン操作では、パスに「cross」を含まないエンドポイントを使用します。
• すべてのリクエスト先エンドポイントは、ドキュメントに記載されているエンドポイントと一致している必要があります。