gate-exchange-tradfi

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 TradFi Suite

一般ルール

⚠️ 停止 — 続行する前に、共有ランタイムルールを必ず読み、厳密に従ってください。 すべてのルールを読み終えるまで、ツールを選択したり呼び出したりしないでください。これらのルールが最優先です。 → gate-runtime-rules.md を読んでください。

• このスキルに明示的に記載された gate-cli コマンドのみを使用してください。 ここに記載されていないコマンドは、たとえ他のインターフェースで利用できても、これらのワークフローでは実行してはなりません。

スキルの依存関係

使用する gate-cli コマンド

照会操作（読み取り専用）

• gate-cli cex tradfi market categories
• gate-cli cex tradfi account info
• gate-cli cex tradfi order history
• gate-cli cex tradfi order list
• gate-cli cex tradfi position history
• gate-cli cex tradfi position list
• gate-cli cex tradfi market symbol
• gate-cli cex tradfi market kline
• gate-cli cex tradfi market ticker
• gate-cli cex tradfi market symbols
• gate-cli cex tradfi account assets

実行操作（書き込み）

• gate-cli cex tradfi position close
• gate-cli cex tradfi order create
• gate-cli cex tradfi order cancel
• gate-cli cex tradfi order update
• gate-cli cex tradfi position 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 は不要です。ユーザーにチャットでシークレットを貼り付けるよう求めてはなりません。
• 権限： Tradfi: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 を読み、厳密に従ってから、このスキルの TradFi ワークフローを実行してください。

• SKILL.md はルーティングとドメイン上の制約を定めます。
• references/gate-cli.md は、照会と変更の分離、確認ゲート、操作後の検証に関する、gate-cli 実行の規範となる契約です。

サブモジュール

モジュール	説明	トリガーキーワード
注文の照会	注文一覧、注文履歴	orders, open orders, order history
ポジションの照会	現在のポジション一覧、ポジション履歴	positions, my positions, position history, holdings, current position
市場の照会	カテゴリー一覧、銘柄一覧、ティッカー、銘柄のローソク足	category, categories, symbol list, symbols, ticker, kline, candlestick, market
資産の照会	ユーザーの残高／資産情報、MT5 アカウント情報	assets, balance, account, my funds, MT5, mt5 account
注文の発注	新しい注文を作成します（作成時のテイクプロフィット／ストップロス設定に対応）	place order, create order, open order, buy, sell, long, short, take-profit, stop-loss
注文の変更	注文価格、テイクプロフィット、またはストップロスを変更します（数量の変更には対応していません）	amend order, modify order, change price, take-profit, stop-loss
注文のキャンセル	1 件以上の注文をキャンセルします	cancel order, revoke order, cancel
ポジションの変更	ポジションのテイクプロフィット／ストップロスのみを変更します（レバレッジ、証拠金の変更には対応していません）	modify position, take-profit, stop-loss, change take-profit, change stop-loss
ポジションの決済	全部または一部を決済します	close position, close, close all, flat

ルーティングルール

インテント	例となるフレーズ	ルーティング先
注文の照会	「TradFi の注文」「注文履歴」「未決済注文を表示」「注文状況」	references/query-orders.md を読む
ポジションの照会	「自分のポジション」「ポジション履歴」「現在の保有状況」「何を保有していますか」	references/query-positions.md を読む
市場の照会	「TradFi のカテゴリー」「カテゴリー一覧」「銘柄一覧」「ティッカー」「X のローソク足」「市場データ」	references/query-market.md を読む
資産の照会	「自分の資産」「残高」「口座残高」「MT5 アカウント」「自分の MT5 情報」	references/query-assets.md を読む
注文の発注	「注文を発注」「EURUSD を買う」「XAUUSD を 0.1 売る」「ロングを建てる」「テイクプロフィット／ストップロス付きの注文」	references/place-order.md を読む
注文の変更	「注文を変更」「価格を X に変更」「テイクプロフィット」「ストップロス」	references/amend-order.md を読む
注文のキャンセル	「注文をキャンセル」「すべての注文をキャンセル」「注文を取り消す」	references/cancel-order.md を読む
ポジションの変更	「ポジションを変更」「テイクプロフィット」「ストップロス」「テイクプロフィット／ストップロスを変更」	references/modify-position.md を読む
ポジションの決済	「ポジションを決済」「すべて決済」「半分を決済」「ポジションを解消」	references/close-position.md を読む
不明確	「TradFi」「TradFi を見せて」	確認する：照会モジュールと取引モジュールを一覧表示するか、ユーザーがどちらを希望しているか尋ねます。

gate-cli コマンド一覧

クエリ（読み取り専用） — MCP に記載されているパラメーターのみを使用します。

#	ツール	目的
1	gate-cli cex tradfi order list	未決済注文を一覧表示します。
2	gate-cli cex tradfi order history	注文履歴の一覧（約定済み／キャンセル済み）を照会します。
3	gate-cli cex tradfi position list	現在のポジションを一覧表示します。
4	gate-cli cex tradfi position history	過去のポジション／決済を一覧表示します。
5	gate-cli cex tradfi market categories	TradFi のカテゴリー一覧を照会します。
6	gate-cli cex tradfi market symbols	シンボルを一覧表示します（対応している場合はカテゴリー別）。
7	gate-cli cex tradfi market ticker	指定したシンボルのティッカーを取得します。
8	gate-cli cex tradfi market symbol	シンボル設定を取得します（注文前に必須：レバレッジ、min_order_volume、step_order_volume）。結果がない場合、そのシンボルは存在しない可能性があります。注文を出さないでください。
9	gate-cli cex tradfi market kline	シンボルの K 線／ローソク足を取得します。
10	gate-cli cex tradfi account assets	ユーザーの口座／残高（資産）を取得します。
11	gate-cli cex tradfi account info	MT5 口座情報を取得します。

取引（書き込み） — ツール名とパラメーターは、Gate TradFi MCP ツールの定義と正確に一致させる必要があります。条件と値の制限（必須／任意、範囲、使用可能なシンボル）はスキルと各リファレンスに記載してください。文書化されていないパラメーターを渡さないでください。

#	ツール（MCP での名称）	目的
12	gate-cli cex tradfi order create	新しい注文を出します。テイクプロフィット／ストップロスに対応しています。呼び出す前に gate-cli cex tradfi market symbol を使用してシンボルを検証し、min_order_volume、step_order_volume、leverages を取得してください。
13	gate-cli cex tradfi order update	注文の価格、テイクプロフィット、ストップロスのみを変更します（サイズには対応していません）。
14	gate-cli cex tradfi order cancel	1 件の注文をキャンセル／削除します。一括処理には対応していません。1 回の呼び出しにつき 1 件です。
15	gate-cli cex tradfi position update	ポジションのテイクプロフィット／ストップロス価格のみを変更します（レバレッジ、証拠金には対応していません）。
16	gate-cli cex tradfi position close（または MCP の同等ツール）	ポジションを決済します（全決済または一部決済）。全決済の場合はポジション識別子のみを指定し、size／close_volume は渡さないでください。

パラメーターの条件と制限

• 各 MCP ツールの入力条件と制限（必須／任意のパラメーター、値の範囲、使用可能なシンボル、精度）は MCP で定義されています。エージェントとユーザーが送信可能な値を把握できるよう、このスキルと各リファレンス文書にその条件と制限を明記してください。
• 各取引リファレンス（place-order.md、amend-order.md、cancel-order.md、modify-position.md、close-position.md）に、必須／任意のパラメーター、値の制約、MCP 固有のルールを記載する Parameters セクションを含めてください。MCP に記載されていないパラメーターを追加しないでください。
• ユーザーが許容範囲外の値を指定した場合、または必須パラメーターが不足している場合は、確認用ペイロードを作成する前に修正を求めてください。

ユーザーによる確認（取引のみ）

• 取引 MCP ツール（注文、注文変更、注文キャンセル、ポジション変更、ポジション決済）を呼び出す前に、MCP に送信するパラメーターをすべて出力し、ユーザーが確認できるようにしてください。ユーザーに確認を求めます（例：「確認：symbol=X、side=Y、size=Z、price=W で注文します。実行するには yes と返信してください。」）。ユーザーが明示的に確認するまで、ツールを呼び出さないでください。
• これはすべての書き込み操作に適用されます。クエリのみのフローでは確認は不要です。

レスポンスパラメーターの説明（取引のみ）

• 取引 MCP ツールの呼び出し後、ユーザーへのレスポンスで、使用したパラメーター（例：symbol、side、size、price、order_id、ポジション識別子）と結果（例：注文の作成、注文の変更、注文のキャンセル、ポジションの変更、ポジションの決済）を説明してください。送信したパラメーターと結果（成功またはエラーコード／メッセージ）を示す簡潔な表またはリストを含めてください。エージェントが送信内容とその結果を必ず報告するよう、このスキルで定めています。

実行

1. 意図とパラメーター

• モジュールを特定します：Query（注文、ポジション、市場、資産）または Trading（注文の発注、変更、キャンセル、ポジションの変更、決済）。
• MCP ツールを呼び出す際は、Gate TradFi MCP ツールの定義に記載されたパラメーターのみを使用してください。MCP に記載されていないパラメーターは渡さないでください。
• ユーザーメッセージから抽出するのは、MCP が実際にサポートするキーのみです。スキルおよびリファレンスに記載された条件と制限を守ってください。

2. サブモジュールを読み込み、ツールを呼び出す

• references/ にある該当リファレンスを読み込み、そのワークフローに従ってください。
• Query：抽出または確認したパラメーターを使ってクエリツールを呼び出します。確認は不要です。
• Trading：リファレンスと MCP に従ってパラメーターを組み立て、ユーザー確認用にパラメーターを提示してください。ユーザーの確認後にのみ取引 MCP ツールを呼び出し、その後、レスポンスで使用したパラメーターと結果を説明してください。

3. 報告

• Query：サブモジュールのレポートテンプレートを使用します（注文／ポジション／ティッカー、資産の表）。
• Trading：リファレンスのレポートテンプレートを使用し、パラメーターの要約（送信した内容）と結果（成功またはエラー）を含めてください。

ドメイン知識

• TradFi：Gate の伝統的金融商品群（例：FX、MT5）です。シンボルとカテゴリーは商品ごとに異なります。
• Query：注文、ポジション、市場、資産には、MCP に記載されたパラメーターのみを使用してください。
• Trading：注文の発注／変更／キャンセル、ポジションの変更／決済には、MCP に記載されたツールとパラメーターのみを使用してください。条件や制限を明示し、実行前にユーザーの確認を求め、レスポンスでパラメーターと結果を説明してください。
• キャンセル／変更時の注文 ID：gate-cli cex tradfi order cancel と gate-cli cex tradfi order update で使用する注文 ID は、必ず gate-cli cex tradfi order list から取得してください。キャンセルまたは変更には、gate-cli cex tradfi order create が返す id または log_id を使用しないでください。

エラー処理

状況	対応
ツールが見つからない／4xx／5xx	TradFi サービスまたはツールを利用できない可能性があることをユーザーに伝え、再試行するか Gate MCP の設定を確認するよう提案します。
リストが空	「未決済注文なし」／「ポジションなし」／「シンボルなし」などと報告し、エラーだと決めつけないでください。
無効なシンボル／注文が見つからない	「注文が見つかりません」または「シンボルが見つかりません」と報告し、シンボルリストを確認するよう提案します。
認証／権限エラー	認証情報を開示せず、TradFi の API キーまたは MCP 認証を確認するようユーザーに依頼します。
取引エラー（例：証拠金不足、価格が無効）	エラーメッセージを表示し、レスポンスで送信したパラメーターを再度示して、修正方法を提案します。

安全ルール

• Query：確認は不要です。ツールが成功したらデータを表示してください。
• Trading：発注／変更／キャンセル／変更／決済を呼び出す前に、必ずユーザー確認用にパラメーターを提示してください。明示的なユーザー確認なしに、書き込み操作を決して実行しないでください。実行後は、レスポンスで使用したパラメーターと結果を必ず説明してください。
• 機密データ：認証情報や残高をログに記録または保存しないでください。現在のレスポンス内でのみ表示してください。

レポートテンプレート

クエリ — 各クエリの後：

• 注文：シンボル、売買方向、数量、価格、ステータス、時刻などの列を含むテーブル（リスト応答から取得）。
• ポジション：シンボル、売買方向、数量、エントリー価格、証拠金などのポジション項目を含むテーブル、または「オープンポジションはありません。」
• マーケット：カテゴリ一覧、シンボル一覧、ティッカーテーブル（シンボル、直近価格、24時間変動率、取引量）、またはシンボルのローソク足サマリー（時間間隔、範囲、OHLC）。
• 資産：資産と残高の一覧、またはMT5のアカウント／サーバー／残高／有効証拠金のテーブル、エラー時は「読み込めませんでした。」

取引 — 注文の発注／変更／キャンセル／修正／クローズの各操作の後：

• 使用したパラメーター：MCPに送信したパラメーター（シンボル、売買方向、数量、価格、order_idなど）の一覧またはテーブル。
• 結果：成功（注文ID、ステータスなど）またはエラー（コード／メッセージ）。エラーの場合は次のステップを提案します。