gate-exchange-futures について
Gate の先物取引操作向けスキルです。gate-cli を使った口座、銘柄、ポジション、注文の照会に加え、新規・決済・変更やトリガー注文の管理を案内します。定められた手順で取引依頼を扱う担当者向けに、認証情報やモードの確認、発注前チェックも含みます。
主な機能
- 01先物口座・市場・ポジションの照会
- 02ポジションの新規・決済・反転
- 03注文の取消・変更
- 04TP/SL と条件注文の作成・管理
- 05取引モードと実行前提の確認
活用シーン
- 01銘柄市場、板情報、ポジションの確認
- 02指定条件でのポジション新規・決済
- 03既存注文の変更や取消
- 04トリガー注文の設定と管理
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ gate/ gate-skills --skill gate-exchange-futuresインストール後、Claude Code で/gate-exchange-futuresを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
CHANGELOG.mdREADME.mdsetup.shreferences/amend-order.mdcancel-order.mdclose-position.mdconditional.mdgate-cli.mdmanage.mdmcp.mdopen-position.mdtp-sl.md詳細
gate-cli の解決(バイナリパス)
gate-cli は次の順序で解決します:(1) command -v gate-cli と gate-cli --version が成功すること、(2) 実行可能な場合は ${HOME}/.local/bin/gate-cli、(3) 実行可能な場合は ${HOME}/.openclaw/skills/bin/gate-cli。正規のルールについては、exchange-runtime-rules.md §4(または gate-runtime-rules.md §4)を参照してください。
Gate Futures Trading Suite
一般ルール
⚠️ 停止 — 先に共有ランタイムルールを読み、厳密に従う必要があります。 すべてのルールを読むまで、どのツールも選択または呼び出してはいけません。これらのルールが最優先です。 → gate-runtime-rules.md を読んでください
- このスキルに明記されている
gate-cliコマンドのみを使用してください。 ここに記載されていないコマンドは、他のインターフェースで使用可能な場合でも、これらのワークフローでは実行してはいけません。
スキルの依存関係
使用する gate-cli コマンド
照会操作(読み取り専用)
gate-cli cex futures account getgate-cli cex futures market contractgate-cli cex futures position get-dualgate-cli cex futures order getgate-cli cex futures market orderbookgate-cli cex futures position getgate-cli cex futures price-trigger getgate-cli cex futures market tickersgate-cli cex futures order listgate-cli cex futures position listgate-cli cex futures price-trigger list
実行操作(書き込み)
gate-cli cex futures order amendgate-cli cex futures order cancelgate-cli cex futures order cancelgate-cli cex futures price-trigger cancelgate-cli cex futures price-trigger cancel-allgate-cli cex futures order add; gate-cli cex futures order close; gate-cli cex futures order long; gate-cli cex futures order remove; gate-cli cex futures order shortgate-cli cex futures price-trigger creategate-cli cex futures position update-dual-cross-modegate-cli cex futures position update-dual-leveragegate-cli cex futures position update-cross-modegate-cli cex futures position update-leveragegate-cli cex futures price-trigger update
認証
- 対話形式でのファイル設定: ホスト上で
GATE_API_KEYとGATE_API_SECRETの両方が設定されていない場合は、gate-cli config initを実行して、API キー、シークレット、プロファイル、デフォルト値のウィザードを完了してください(gate-cli を参照)。 - 環境変数/フラグ: 認証情報がすでに指定されている場合(たとえばホスト上で
GATE_API_KEYとGATE_API_SECRETの両方が設定されている場合、または対応している場合に--api-key/--api-secretが指定されている場合)は、gate-cli config initは不要です。ユーザーにチャットへシークレットを貼り付けるよう求めてはいけません。 - 権限: Fx:Write
- ポータル: キーの作成またはローテーションはチャットの外で行ってください:https://www.gate.com/myaccount/profile/api-key/manage
インストールの確認
- 必須:
gate-cli(見つからない場合は、このスキルのディレクトリからsh ./setup.shを実行してください。GATE_CLI_SETUP_MODE=releaseは任意です)。 - 名前で
gate-cliを呼び出す場合は、$HOME/.openclaw/skills/bin(またはsetup.shがインストールするディレクトリ)をPATHに追加してください。 - 認証情報: ホストで
GATE_API_KEYとGATE_API_SECRETの両方が設定されており、空でない場合、gate-cli config initを必須にしてはいけません。これはgate-cliで有効な設定と同等です。両方とも未設定または空の場合は、オペレーターにgate-cli config initを実行するか、スキルライブラリの該当するスキルでGATE_API_KEY/GATE_API_SECRETを設定するよう伝えてください(ユーザーにチャットへシークレットを貼り付けるよう求めてはいけません)。 - 動作確認: CLI が想定どおりに動作するまで、認証が必要な呼び出しに進まないでください(例:
gate-cli --version、またはこのスキルの読み取り専用gate-cli cex ...コマンド)。変更操作の前に、認証情報が正しく解決されることを確認してください。
実行モード
references/gate-cli.md を読み、厳密に従ってから、この SKILL.md に記載されたモジュール固有のルートを実行します。
SKILL.mdではルーティングのロジック(Open/Close/Cancel/Amend/TP-SL/Conditional/Manage)を扱います。references/gate-cli.mdは、ツールの契約、モード切り替え時の安全対策、確認ゲート、縮退処理に関するgate-cliの正式な実行契約です。
モジュールの概要
| モジュール | 説明 | トリガーキーワード |
|---|---|---|
| Open | 指値または成行でロングまたはショートを新規建てします。クロスまたは分離モードにも対応し、値上がり率上位/値下がり率上位の銘柄を注文できます | long、short、buy、sell、open、top gainer、top loser |
| Close | 全決済、一部決済、ポジションの反転 | close、close all、reverse |
| Cancel | 1件または複数の注文をキャンセルします | cancel、revoke |
| Amend | 注文価格または数量を変更します | amend、modify |
| TP/SL | 既存のポジションに利確または損切りを設定します。指定価格に達すると、決済/縮小注文が発動します | take profit、stop loss、TP、SL、止盈、止损 |
| Conditional Open | 価格が指定レベルに達したときに発動する、未約定の新規注文を出します | conditional order、when price reaches、breakout buy、dip buy、条件单、触价开仓 |
| Manage Triggers | 価格到達で発動する未決済注文を一覧表示、キャンセル、または変更します | list triggers、cancel TP、cancel SL、amend trigger、查询条件单、取消止盈止损 |
ルーティングルール
| 意図 | 例 | ルート先 |
|---|---|---|
| ポジションを新規建て | 「BTCを1コントラクト、ロング」「ETHを成行でショート」「レバレッジ10倍でロング」「値上がり率上位の銘柄を10U分ロング」 | references/open-position.md を読みます |
| ポジションを決済 | 「BTCを全決済」「半分決済」「ショートに反転」「すべて決済」 | references/close-position.md を読みます |
| 注文をキャンセル | 「その買い注文をキャンセル」「すべての注文をキャンセル」「自分の注文一覧を表示」 | references/cancel-order.md を読みます |
| 注文を変更 | 「価格を60000に変更」「注文数量を変更」 | references/amend-order.md を読みます |
| TP/SLを設定 | 「BTCのTPを70000に設定」「ロングのSLを58000に設定」「損切り60000」 | references/tp-sl.md を読みます |
| 条件付きで新規建て | 「BTCが60000まで下がったら買う」「価格が68000を上回ったらショートを新規建て」「条件注文でロング」 | references/conditional.md を読みます |
| 発動注文を管理 | 「自分のTP/SL注文を一覧表示」「その損切り注文をキャンセル」「トリガー価格を変更」「条件注文を照会」 | references/manage.md を読みます |
| 不明確 | 「先物について教えて」「自分のポジションを表示」 | 確認する:ポジション/注文を照会してから、ユーザーを案内します |
gate-cli コマンド一覧
| # | ツール | 目的 |
|---|---|---|
| 1 | gate-cli cex futures market tickers | すべての先物ティッカーを取得します(上昇率・下落率の上位順の並べ替え用) |
| 2 | gate-cli cex futures market contract | 単一のコントラクト情報を取得します(精度、倍率など) |
| 3 | gate-cli cex futures market orderbook | コントラクトのオーダーブックを取得します(最良買値/最良売値) |
| 4 | gate-cli cex futures account get | 先物口座を取得します(ポジションモード:シングル/デュアル) |
| 5 | gate-cli cex futures position list | ポジションを一覧表示します(デュアルモード) |
| 6 | gate-cli cex futures position get-dual | コントラクトのデュアルモードポジションを取得します |
| 7 | gate-cli cex futures position get | コントラクトのシングルモードポジションを取得します |
| 8 | gate-cli cex futures position update-dual-cross-mode | 証拠金モードを切り替えます(クロス/分離、デュアルモード) |
| 9 | gate-cli cex futures position update-cross-mode | シングルモードで証拠金モードを切り替えます(デュアルモードでは使用しないでください) |
| 10 | gate-cli cex futures position update-dual-leverage | レバレッジを設定します(デュアルモード) |
| 11 | gate-cli cex futures position update-leverage | レバレッジを設定します(シングルモード、デュアルモードでは使用しないでください) |
| 12 | gate-cli cex futures order add; gate-cli cex futures order close; gate-cli cex futures order long; gate-cli cex futures order remove; gate-cli cex futures order short | 注文を発注します(新規/決済/反転) |
| 13 | gate-cli cex futures order list | 注文を一覧表示します |
| 14 | gate-cli cex futures order get | 単一注文の詳細を取得します |
| 15 | gate-cli cex futures order cancel | 単一注文をキャンセルします |
| 16 | gate-cli cex futures order cancel | コントラクトのすべての注文をキャンセルします |
| 17 | gate-cli cex futures order amend | 注文を変更します(価格/サイズ) |
実行ワークフロー
1. 意図とパラメーター
- モジュール(新規/決済/キャンセル/変更/TP-SL/条件付き/管理)を判定します。
- 次の情報を抽出します。新規/決済の場合は
contract、side、size、price、leverage、TP/SL/条件付きの場合はtrigger_price、trigger_rule、order_size、order_price、order_tif。 - 上昇率/下落率の上位:特定のコントラクトではなく、ユーザーが「上昇率上位」/「下落率上位」(または同等の表現)を要求した場合は、
gate-cli cex futures market tickersを呼び出し、changePercentageで並べ替え(上昇率上位は降順、下落率上位は昇順)して、最上位のコントラクトを選択します。その後、そのコントラクトを使って新規注文のフローを続行します。 - 不足している情報:必須パラメーター(例:サイズ)が不足している場合は、ユーザーに確認します(確認モード)。
2. 事前確認
-
契約:契約が存在し、取引可能であることを確認するため、
gate-cli cex futures market contractを呼び出します。 -
アカウント:残高と競合するポジションを確認します(例:証拠金モードの切り替え時)。
-
リスク:
order_price_deviateから有効な指値価格を事前計算しないでください(実際の乖離上限は risk_limit_tier によって異なります)。PRICE_TOO_DEVIATEDが発生した場合は、エラーメッセージに記載された有効範囲を表示します。 -
決済通貨:ユーザーが BTC 決済契約を明示的に指定しない限り、常に
usdtを使用します。 -
証拠金モードとポジションモード(ユーザーが証拠金モードを明示的に指定し、現在のモードと異なる場合のみ):
gate-cli cex futures account getを呼び出してポジションモードを取得します。レスポンスのposition_modeから、singleは単一ポジションモード、dualはデュアル(ヘッジ)ポジションモードです。ポジションから証拠金モードを確認するには、上記のデュアル/シングルそれぞれのポジション照会を使用し、pos_margin_mode(cross/isolated)を確認します。ユーザーが証拠金モードを指定していない場合は、切り替えず、現在のモードで注文します。 -
単一ポジション(
position_mode === "single"):処理を中断しないでください。ユーザーに次のように確認します。「{currency} のポジションを保有しています。証拠金モードを切り替えると、このポジションにも適用されます。続行しますか?」(例:契約が BTC_USDT の場合、通貨は BTC)。ユーザーの確認を待ってから続行します。 -
デュアルポジション(
position_mode === "dual"):処理を中断します。ユーザーに次のように伝えます。「先にポジションを決済してから、新しいポジションを開いてください。」 -
デュアルモードとシングルモード(API の選択):まず
gate-cli cex futures account getを呼び出します。position_mode === "dual"(またはin_dual_mode === true)の場合: -
ポジション/レバレッジの照会:
gate-cli cex futures position listまたはgate-cli cex futures position get-dualを使用します。デュアルモードではgate-cli cex futures position getを使用しないでください(シングルモード用 API であり、誤ったスキーマを返します)。 -
証拠金モードの切り替え:
gate-cli cex futures position update-dual-cross-modeを使用します。デュアルモードではgate-cli cex futures position update-cross-modeを使用しないでください(シングルモード用 API です)。 -
レバレッジ:
gate-cli cex futures position update-dual-leverageを使用します。デュアルモードではgate-cli cex futures position update-leverageを使用しないでください(シングルモード用 API であり、誤ったスキーマを返します)。 シングルモードの場合:ポジションにはgate-cli cex futures position get、モード切り替えにはgate-cli cex futures position update-cross-mode、レバレッジにはgate-cli cex futures position update-leverageを使用します。
3. モジュールのロジック
モジュール A:ポジションを開く
- 単位換算:ユーザーがサイズをコントラクトで指定しない場合、USDT コスト(「100U を使う」)とUSDT 評価額(「100U 相当」)を区別し、
gate-cli cex futures market contractからquanto_multiplierを、gate-cli cex futures market orderbookから最良買値/売値を取得します。
- USDT コスト(証拠金ベース):ロングを開く場合:
contracts = cost / (0.0015 + 1/leverage) / quanto_multiplier / order_price。ショートを開く場合:contracts = cost / (0.0015 + 1.00075/leverage) / quanto_multiplier / max(order_price, best_bid)。order_price:指値 → 指定価格、成行 → 最良売値(ロング)または最良買値(ショート)。leverageは現在のポジション照会(手順 5)から取得する必要があります。デフォルト値を想定しないでください。 - USDT 評価額(名目額ベース):買い/ロングを開く場合:
contracts = usdt_value / price / quanto_multiplier。売り/ショートを開く場合:contracts = usdt_value / max(best_bid, order_price) / quanto_multiplier。price:指値 → 指定価格、成行 → 最良売値(買い)または最良買値(売り)。 - 基軸通貨(例:BTC、ETH):contracts = 基軸通貨の数量 ÷ quanto_multiplier
- 整数に切り捨てます。
order_size_minを満たす必要があります。
- モード:ユーザーが明示的に要求した場合に限り、証拠金モードを切り替えます。ユーザーが分離マージンを明示的に要求した場合(例:「分離」)に限り分離マージンに切り替え、クロスマージンを明示的に要求した場合(例:「クロス」)に限りクロスマージンに切り替えます。ユーザーが証拠金モードを指定しない場合は、切り替えず、現在の証拠金モード(ポジションの
pos_margin_mode)で注文を出します。ユーザーが分離マージンを明示的に希望する場合は、レバレッジを確認します。 - モード切り替え:ユーザーが証拠金モードを明示的に要求し、かつ現在のモード(ポジションから取得する
pos_margin_mode)と異なる場合に限り、gate-cli cex futures position update-dual-cross-mode/gate-cli cex futures position update-cross-modeを呼び出す前に、gate-cli cex futures account getからポジションモードのposition_mode(single/dual)を取得します。position_mode === "single"の場合は、"すでに {currency} のポジションがあります。証拠金モードを切り替えると、このポジションにも適用されます。続行しますか?" という確認を表示し、ユーザーの確認後にのみ続行します。position_mode === "dual"の場合は、切り替えず、処理を中断してユーザーに "先にポジションを決済してから、新しいポジションを開いてください。" と伝えます。 - モード切り替え(競合なし):ユーザーがクロスマージンまたは分離マージンを明示的に要求し、かつ現在のモードと異なる場合に限り、ポジションがない場合、またはシングルポジションでユーザーが確認済みの場合は、デュアルモードでは
gate-cli cex futures position update-dual-cross-mode、シングルモードではgate-cli cex futures position update-cross-modeをmode"cross"または"isolated"とともに呼び出します。ユーザーが証拠金モードを明示的に要求していない場合は、切り替えないでください。 - レバレッジ:ユーザーがレバレッジを指定し、現在のレバレッジ(上記のデュアル/シングルに応じたポジション照会から取得)と異なる場合は、処理を続ける前に、デュアルモードでは
gate-cli cex futures position update-dual-leverage、シングルモードではgate-cli cex futures position update-leverageを呼び出します。ユーザーがレバレッジを指定していない場合は変更せず、計算(例:USDT コストの計算式)にはポジション照会から取得した現在のレバレッジを使用します。デフォルト値(例:10x や 20x)を設定しないでください。 - 注文前の確認:コントラクトとサイドに対応する現在のレバレッジをポジション照会から取得します(デュアル:
gate-cli cex futures position listまたはgate-cli cex futures position get-dual、シングル:gate-cli cex futures position get)。最終注文の概要(コントラクト、サイド、サイズ、価格または成行、モード、レバレッジ、推定証拠金/清算価格)を表示し、ユーザーに確認を求めます(例:「注文を出すには 'confirm' と返信してください。」)。ユーザーの確認後にのみ、注文を出します。 - 注文の発注:
gate-cli cex futures order add; gate-cli cex futures order close; gate-cli cex futures order long; gate-cli cex futures order remove; gate-cli cex futures order shortを呼び出します(成行:tif=ioc、price=0)。 - 確認:ポジション照会でポジションを確認します(デュアル:
gate-cli cex futures position listまたはgate-cli cex futures position get-dual、シングル:gate-cli cex futures position get)。
モジュール B:ポジションを決済する
- ポジション:ポジション照会で現在の
sizeとサイドを取得します(両建てモード:gate-cli cex futures position listまたはgate-cli cex futures position get-dual、単一モード:gate-cli cex futures position get)。 - 分岐:全決済(照会後、reduce_only を指定して決済);一部決済(数量を計算し、
gate-cli cex futures order add; gate-cli cex futures order close; gate-cli cex futures order long; gate-cli cex futures order remove; gate-cli cex futures order shortに reduce_only を指定);ドテン(2 段階で決済してから反対方向に新規注文)。 - 確認:手順 1 と同じポジション照会で、残りのポジションを確認します。
モジュール C:注文をキャンセルする
- 特定:order_id で特定するか、
gate-cli cex futures order listで一覧を取得し、ユーザーに選択してもらいます。 - キャンセル:
gate-cli cex futures order cancelのみを実行します(一括キャンセルは行いません)。 - 確認:
finish_asがcancelledであることを確認します。
モジュール D:注文を変更する
- 確認:注文のステータスが
openである必要があります。 - 精度:新しい価格と数量がコントラクトの精度要件を満たしていることを確認します。
- 変更:
gate-cli cex futures order amendを呼び出して、価格または数量を更新します。
モジュール E:利確/損切り
完全なロジックについては references/tp-sl.md を参照してください。主なポイントは次のとおりです。
- ポジション確認:現在のポジションを取得し、サイドと数量を確認します(事前チェックの両建て/単一モードのルールが適用されます)。
- トリガールールの自動選択:
- ロングの利確:
trigger_rule = ">="(価格が利確水準まで上昇) - ロングの損切り:
trigger_rule = "<="(価格が損切り水準まで下落) - ショートの利確:
trigger_rule = "<="(価格が利確水準まで下落) - ショートの損切り:
trigger_rule = ">="(価格が損切り水準まで上昇)
- 決済フラグ(
close、auto_size、order_typeはポジションモードとサイドによって異なります):
- 単一モード、ロングを全決済:
order_type = "close-long-position"、close = true、auto_sizeなし、order_reduce_only = true。 - 単一モード、ショートを全決済:
order_type = "close-short-position"、close = true、auto_sizeなし、order_reduce_only = true。 - 単一モード、ロングを一部決済:
order_type = "plan-close-long-position"、close = false、auto_sizeなし、order_reduce_only = true。 - 単一モード、ショートを一部決済:
order_type = "plan-close-short-position"、close = false、auto_sizeなし、order_reduce_only = true。 - 両建てモード、ロングを全決済:
order_type = "close-long-position"、close = false、auto_size = "close_long"、order_reduce_only = true。 - 両建てモード、ショートを全決済:
order_type = "close-short-position"、close = false、auto_size = "close_short"、order_reduce_only = true。 - 両建てモード、ロングを一部決済:
order_type = "plan-close-long-position"、close = false、auto_sizeなし、order_reduce_only = true。 - 両建てモード、ショートを一部決済:
order_type = "plan-close-short-position"、close = false、auto_sizeなし、order_reduce_only = true。
- 数量:ユーザーが「すべて決済」と指定した場合、または数量を指定しなかった場合は、上記のモードに応じたフラグを使って全決済(size = 0)します。一部決済の場合は数量を計算し、
order_reduce_only = trueを設定します。 - 成行と指値:ユーザーが執行価格を指定しなかった場合は、成行(
order_price = "0"、order_tif = "ioc")を使用します。指定した場合は、指値(order_tif = "gtc")を使用します。 - 確認:サマリー(コントラクト、サイド、トリガー価格、トリガールール、執行タイプ、数量または「すべて決済」)を表示し、
gate-cli cex futures price-trigger createを呼び出す前にユーザーに確認を求めます。
モジュール F:条件付き新規注文
ロジックの詳細は references/conditional.md を参照してください。主なポイントは次のとおりです。
- ポジション不要:トリガーされると、新しいポジションを開きます。
- トリガー条件:ユーザーが方向を指定します。「Xまで下がったら買う」→
trigger_rule = "<="、「Xを上抜けたら買う」→trigger_rule = ">="。 - サイズの換算:モジュール A と同じ単位換算ルールを使用します(コントラクト数、USDT 建てコスト、USDT 建て価値、ベース通貨量)。
quanto_multiplierの取得にはgate-cli cex futures market contractを、最良買値/売値の取得にはgate-cli cex futures market orderbookを使用してください。コストベースの換算では、ユーザーが約定指値を指定していない場合、trigger_priceを基準のorder_priceとして使用します。 - 注文サイズの符号:正の値 = ロング、負の値 = ショート。
- 確認:注文を発注する前に、詳細な概要を表示してください。
モジュール G:トリガー済み注文の管理
ロジックの詳細は references/manage.md を参照してください。以下をサポートします。
- 一覧表示:
gate-cli cex futures price-trigger list - 詳細取得:
gate-cli cex futures price-trigger get - 単一注文のキャンセル:
gate-cli cex futures price-trigger cancel - すべてキャンセル:
gate-cli cex futures price-trigger cancel-all - 変更:
gate-cli cex futures price-trigger update
変更の制限:gate-cli cex futures price-trigger update で直接変更できるのは、TP/SL 注文(order_type に plan-close-* が含まれる、または reduce_only/close フラグがある注文)のみです。API で作成された条件付き新規注文は APIOrderNotSupportUpdateTouchOrder を返すため、変更できません。代わりにキャンセルして再作成する必要があります。
レポートテンプレート
各操作の後、標準化された短い結果を出力します。
価格トリガー注文の場合:
✓ [Operation] [Contract]
Trigger: [rule] [trigger_price]
Execute: [market/limit price] × [size or "close all"] [reduce_only/close]
Order ID: [id]
ドメイン知識
- USDT 無期限先物:USDT で決済される線形コントラクトです。ポジションサイズはコントラクト数で表され、各コントラクトはベース資産の
quanto_multiplier単位(例:0.001 BTC)に相当します。 - クロスマージンと分離マージン:クロスモードでは口座残高全体を証拠金として共有し、分離モードではこのポジションに割り当てられた金額に証拠金を限定します。
- シングルポジションモードとデュアルポジションモード:シングルモードではコントラクトごとにネットポジションを 1 つ保有します。デュアルモード(ヘッジ)では、同じコントラクトでロングとショートを同時に保有できます。API エンドポイントはモードによって異なります。
- 価格トリガー注文:市場価格がトリガー価格を通過すると発動する条件付き注文です。TP/SL(既存ポジションの決済)と条件付き新規注文(新しいポジションの開始)に使用します。トリガーはサーバー側で実行されるため、クライアントがオンラインである必要はありません。
- Reduce-only:注文が既存ポジションの縮小のみを行い、誤って新しいポジションを開かないようにします。TP/SL 注文では必ず設定してください。
- 注文サイズの符号:価格トリガー決済注文では、負のサイズ = 売り(ロングを決済)、正のサイズ = 買い(ショートを決済)です。新規注文では、正の値 = ロング、負の値 = ショートです。
安全ルール
確認
- 新規注文:最終注文の概要(コントラクト、売買方向、サイズ、価格/成行、モード、レバレッジ、推定清算価格/証拠金)を表示し、
gate-cli cex futures order add; gate-cli cex futures order close; gate-cli cex futures order long; gate-cli cex futures order remove; gate-cli cex futures order shortの前に確認を求めます。マーク価格と指値の違い、order_price_deviate、または価格調整の提案についての文言は追加しないでください。例:「注文を発注するには「confirm」と返信してください。」 - 全ポジションの決済、反転、一括キャンセル:対象範囲を表示し、確認を求めます。例:「すべてのポジションを決済しますか? 続行するには返信してください。」/「このコントラクトのすべての注文をキャンセルします。続行しますか?」
- TP/SL/条件付き注文の作成:詳細な概要(コントラクト、トリガー条件と価格、約定価格/注文タイプ、サイズ)を表示し、「注文を発注するには「confirm」と返信してください。」と尋ねます。
- すべてのトリガー注文のキャンセル:対象範囲(コントラクトまたはすべて)を表示し、「[contract] のすべてのトリガー注文をキャンセルしますか? 続行するには「confirm」と返信してください。」と尋ねます。
- トリガー注文の変更:変更前と変更後の値を表示し、確認を求めます。
注文 ID の精度
Gate の注文 ID は 64 ビット整数で、Number.MAX_SAFE_INTEGER(2^53-1)を超えます。標準的な JSON パーサーでは、値が気づかないうちに破損します。
order_idは必ず文字列として渡してください(例:"728451920374819843"。728451920374819843ではありません)。- API レスポンスから注文 ID を読み取る場合は、パースされた数値ではなく、未加工の文字列トークンをそのままコピーしてください。
- 注文 ID をユーザーに表示する場合は、書式を変更せず(カンマや指数表記を使わず)、必ず文字列として表示してください。
エラー
| コード | 対応 |
|---|---|
BALANCE_NOT_ENOUGH | 入金するか、レバレッジまたはサイズを下げるよう提案してください。 |
PRICE_TOO_DEVIATED | エラーメッセージから実際に有効な価格範囲を抽出し、ユーザーに表示してください(コントラクトの order_price_deviate に頼らないでください。実際の上限は risk_limit_tier によって異なります)。 |
POSITION_HOLDING(モード切り替え) | API は POSITION_NOT_EMPTY ではなく、このエラーを返します。先にポジションを決済するよう依頼してください。 |
CONTRACT_NOT_FOUND | コントラクトが無効、または取引できません。コントラクト名(例:BTC_USDT)と決済通貨を確認し、コントラクト一覧の表示を提案してください。 |
ORDER_NOT_FOUND | 注文はすでに約定、トリガー、キャンセルされているか、order_id が誤っています。注文履歴の確認、またはトリガー済み注文の一覧表示を提案してください。 |
APIOrderNotSupportUpdateTouchOrder | API で作成された条件付き新規注文は変更できません。代わりにキャンセルして作り直してください。TP/SL 注文には影響せず、通常どおり変更できます。 |
SIZE_TOO_LARGE | 注文サイズが上限を超えています。サイズを下げるか、コントラクトの order_size_max を確認するよう提案してください。 |
ORDER_FOK | FOK 注文を全量約定できませんでした。価格またはサイズの変更、あるいは GTC/IOC の使用を提案してください。 |
ORDER_POC | POC 注文が流動性を消費するため、取引所に拒否されました。メイカー専用にするには価格を変更するよう提案してください。 |
INVALID_PARAM_VALUE | デュアルモードで誤った API またはパラメーターを使用した場合によく発生します(例:デュアルモードでの gate-cli cex futures position update-cross-mode または gate-cli cex futures position update-leverage。これらはシングルモード用の API です)。デュアルモード用 API を使用してください:gate-cli cex futures position update-dual-cross-mode、gate-cli cex futures position update-dual-leverage。ポジションには gate-cli cex futures position list または gate-cli cex futures position get-dual を使用してください。価格トリガー注文の場合は、trigger_rule、order_size の符号、order_price の形式を確認してください。 |