gate-exchange-dual

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 Exchange デュアル投資スキル

一般ルール

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

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

スキルの依存関係

使用する gate-cli コマンド

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

• gate-cli cex earn dual balance
• gate-cli cex earn dual plans
• gate-cli cex earn dual orders

実行操作（書き込み）

• gate-cli cex earn dual place

認証

• 対話型ファイル設定： ホスト上で GATE_API_KEY と GATE_API_SECRET の両方が設定されていない場合、gate-cli config init を実行し、API キー、シークレット、プロファイル、デフォルト値のウィザードを完了してください（gate-cli を参照）。
• 環境変数／フラグ： 認証情報がすでに指定されている場合は、gate-cli config init は不要です。例：ホスト上で GATE_API_KEY と GATE_API_SECRET の両方が設定されている場合、または対応している場合に --api-key／--api-secret を使用する場合。ユーザーにシークレットをチャットに貼り付けるよう求めてはいけません。
• API キー必須：はい
• 権限： Earn: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 を PATH に追加してください（または setup.sh がインストールするディレクトリを追加してください）。
• 認証情報： ホストに 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 はルーティングと商品の意味を定義します。
• references/gate-cli.md は、プランの照会、確認を必須とする申し込み、注文の検証について、権威ある gate-cli 実行規約を定めています。

前提条件

• MCP 依存関係： gate-mcp のインストールが必要です。
• 認証： すべてのエンドポイントで API キー認証が必要です。
• リスクに関する免責事項： 必ず次の文を付記してください： "この情報は参考目的のみであり、投資助言を構成するものではありません。デュアル投資は元本が保護されません。投資した通貨とは異なる通貨で決済を受け取る場合があります。投資する前に、商品の条件を理解してください。"

利用可能な MCP ツール

ツール	認証	説明
gate-cli cex earn dual plans	はい	利用可能なデュアル投資プランを一覧表示します（オプションのパラメーター：plan_id）
gate-cli cex earn dual orders	はい	デュアル投資注文を一覧表示します。page と limit は必須です：常に page=1, limit=100 を指定してください。オプション：from、to。結論を出す前に、返される行数が limit 未満になるまで、page を増やしながらすべてのページを必ずループ処理してください。
gate-cli cex earn dual balance	はい	デュアル投資の残高と利息の統計を取得します
gate-cli cex earn dual place	はい	デュアル投資注文を発注します。パラメーター：plan_id（必須）、amount（必須）、text（任意。t- で始まる必要があり、プレフィックスの後は最大 28 バイト、英数字／_／-／. のみ）。

ルーティングルール

ケース	ユーザーの意図	シグナルとなるキーワード	アクション
1	デュアル商品の一覧を確認	"dual products", "sell-high / buy-low options"	references/product-query.md を参照
3	商品の詳細	"min investment", "BTC sell-high"	references/product-query.md を参照（通貨でローカルにフィルタリングし、該当するプランを表示して、最小金額は省略）
4	決済シミュレーション	"what happens at delivery", "if price reaches X"	references/product-query.md を参照（シミュレーション）
5	ポジションの概要（継続中）	"how much locked", "active positions"	references/product-query.md を参照（継続中のポジション＋残高）
6	決済記録	"settlement records", "got crypto or USDT", "last month orders"	references/product-query.md を参照（決済済み）
7	高値売り注文（暗号資産を投資）	"sell high for me", "sell high with BTC", "sell high order"	references/subscription.md を参照
8	安値買い注文（ステーブルコインを投資）	"buy low for me", "buy low BTC with USDT", "buy low order"	references/subscription.md を参照
9	注文可能な金額かどうかの確認	"can I buy", "is 5000U enough"	references/subscription.md を参照
10	注文の最低購入額の確認	"minimum to buy", "can I buy dual with 50U"	references/subscription.md を参照
11	決済結果の照会	"what did I receive", "settlement result"	references/settlement-assets.md を参照（決済）
12	デュアル資産の概要	"dual balance", "total locked"	references/settlement-assets.md を参照（残高）
13	通貨換算のリスク	"will I lose principal", "risk", "principal-protected?"	ドメイン知識（API 不要）
14	利益を得られなかった場合の説明	"did I lose money", "missed gains", "price surged"	ドメイン知識（API 不要）
15	制限対象地域	"can I buy dual in [region]", "which regions supported"	references/subscription.md を参照（コンプライアンス）
17	コンプライアンスチェックの失敗	"subscription failed", "compliance check not passed"	references/subscription.md を参照（コンプライアンス）

実行

1. 上記のルーティングルールの表から、ユーザーの意図を特定します。
2. ケース 1～6、11～12 では、references/ 内の該当するサブモジュールドキュメントを読み、ワークフローに従います。
3. ケース 7～10 では、references/subscription.md を読み、注文の発注ワークフローに従います。
4. ケース 15、17 では、references/subscription.md を読み、コンプライアンス対応ワークフローに従います。これらのケースは、gate-cli cex earn dual place のエラーレスポンス、またはユーザーから地域制限について質問された場合に該当します。
5. ケース 13～14 では、以下のドメイン知識を使って直接回答します（API 呼び出しは不要です）。
6. ユーザーの意図が曖昧な場合は、ルーティングする前に確認の質問をします。

ドメイン知識

基本概念

• 高値売り（コール）：ユーザーは暗号資産を投資し、目標価格は現在価格を上回ります。決済価格が目標価格以上の場合、USDT を受け取ります（元本 × 目標価格 ×（1 + 利息））。決済価格が目標価格を下回る場合、暗号資産と利息を受け取ります。
• 安値買い（プット）：ユーザーはステーブルコインを投資し、目標価格は現在価格を下回ります。決済価格が目標価格以下の場合、暗号資産を受け取ります。決済価格が目標価格を上回る場合、USDT と利息を受け取ります。
• 目標価格：受渡時の決済結果を決定する価格です。Gate の公式用語です。
• 決済価格：受渡時の原資産の市場価格で、目標価格と比較されます。
• 利息保証、元本保証なし：元本と利息は必ず受け取れますが、価格変動により決済通貨が変わる場合があります。
• 目標価格が現在価格に近いほど APY は高くなりますが、通貨が転換される可能性も高くなります。
• 注文後、デュアル投資注文はキャンセルできません。受渡時に自動で決済されます。
• 注文タイプの判定：gate-cli cex earn dual orders には type フィールドがありません。invest_currency から判定します。暗号資産（BTC、ETH など）なら高値売り（コール）、ステーブルコイン（USDT）なら安値買い（プット）です。コインで絞り込むには invest_currency または exercise_currency を使用してください。instrument_name はありません。
• 注文ステータスの値：INIT（保留中）、PROCESSING（運用中）、SETTLEMENT_SUCCESS（決済済み）、SETTLEMENT_PROCESSING（決済中）、CANCELED（キャンセル済み）、FAILED（失敗）、REFUND_SUCCESS／REFUND_PROCESSING／REFUND_FAILED → 「早期償還」と表示し、「返金」とは表示しないでください。早期償還された注文の利回りはゼロです。

決済ルール（Gate の例）

高値売り：1 BTC を投資、目標価格 20,000 USDT、31 日間、APY 100%

• 決済価格 < 20,000 → 受取額 = 1 ×（1 + 100%/365×31）= 1.0849 BTC
• 決済価格 ≥ 20,000 → 受取額 = 1 × 20,000 ×（1 + 100%/365×31）= 21,698.63 USDT

安値買い：20,000 USDT を投資、目標価格 20,000 USDT、31 日間、APY 100%

• 決済価格 ≤ 20,000 → 受取額 = 20,000/20,000 ×（1 + 100%/365×31）= 1.0849 BTC
• 決済価格 > 20,000 → 受取額 = 20,000 ×（1 + 100%/365×31）= 21,698.63 USDT

リスクに関する FAQ（ケース 13～14）

Q: 元本を失うことはありますか？（ケース 13） A: 利息は保証されますが、元本は保証されません。元本と利息は必ず受け取れますが、決済通貨が変わる場合があります。高値売りでは USDT ではなく暗号資産が返却される場合があり、安値買いでは暗号資産ではなく USDT が返却される場合があります。目標価格が現在価格に近いほど利回りは高くなりますが、通貨転換のリスクも高くなります。

Q: BTC を高値売りした後に価格が急騰しました。損をしたのでしょうか？（ケース 14） A: 決済価格が目標価格以上の場合、目標価格で売却でき、USDT を受け取れますが、目標価格を超える値上がり益は得られません。決済価格が目標価格を下回る場合、暗号資産と利息を受け取ります。この商品は横ばい相場または緩やかな上昇相場に適しています。強い上昇相場では、さらなる利益を「逃す」可能性があります。

安全ルール

• タイムスタンプフィールド（重大）：すべての時間フィールド（delivery_time、create_time、complete_time、delivery_timest）は、Unix タイムスタンプ（秒）です。日付に変換したり、どのような形でもユーザーに表示したりしないでください。以下も含まれます：（1）タイムスタンプを表の列として表示しないでください。（2）タイムスタンプを日付に変換して、セクション見出しやグループ化ラベル（例：「受渡時刻：2026-03-17」）として使用しないでください。（3）注文確認で受渡日について言及しないでください。ユーザー向けの出力から時間に関する情報をすべて省略してください。
• APY の表示（重大 — すべての dual ツールに適用）：dual investment ツールから返される APY／レートフィールド（apy、apy_display、apy_settlement、apyDisplay、その他のレートフィールド）は、すべて生の値であり、パーセンテージではありません。表示する際は、必ず 100 を掛けて % を付けてください。**生の値をそのままパーセンテージとして表示してはいけません。**よくある間違いとして、1.1343 や 16.133 はパーセンテージのように見えますが、そうではありません。1.1343 → 113.43%、16.133 → 1613.3% です。別の例：0.0619 → 6.19%、2.7814 → 278.14%。生の値は決済計算式でのみ使用してください。このルールはすべての dual ツール（gate-cli cex earn dual plans、gate-cli cex earn dual orders、gate-cli cex earn dual balance など）に適用されます。
• APY の妥当性チェック（回答前に必須）：すべての APY 値を整形した後、出力内の値をすべて確認してください。100 倍した後の一般的な範囲は、暗号資産の高値売却プランが 10%～2000%、ステーブルコインの安値購入プランが 5%～1800% です。**0.05%～20%（1 桁または 2 桁前半）で表示された APY があれば、100 を掛け忘れている可能性が極めて高いです。いったん作業を止め、戻ってすべての APY 値を計算し直してから回答してください。**たとえば、生の値が 19.9378 の場合、正しい表示は 1993.78% であり、19.94% ではありません。
• 投資助言の禁止：特定のプランを推奨したり、価格を予測したりしないでください。データを提示し、ユーザー自身に判断してもらってください。
• 元本保証なし：dual investment に元本保証はなく、ユーザーが別の通貨を受け取る可能性があることを必ず明確に伝えてください。
• 注文の確認：gate-cli cex earn dual place を呼び出す前に、注文の詳細（プラン、金額、目標価格、APY、決済シナリオ）をすべてユーザーに提示し、明示的な確認を得る必要があります。確認なしに注文を発注してはいけません。
• 機密データ：API キー、内部エンドポイント URL、生のエラートレースをユーザーに開示しないでください。

エラー処理

条件	対応
認証エンドポイントが「not login」を返す	「まず Gate アカウントにログインしてください。」
gate-cli cex earn dual plans が空の結果を返す	「現在、利用可能な dual investment プランはありません。」
gate-cli cex earn dual orders が空の結果を返す	「指定した条件に一致する dual investment 注文は見つかりませんでした。」
gate-cli cex earn dual place が地域制限エラーを返す	references/subscription.md のケース 15 を参照してください
gate-cli cex earn dual place がその他のコンプライアンスエラーを返す	references/subscription.md のケース 17 を参照してください
gate-cli cex earn dual place が残高不足を返す	「残高が不足しています。アカウントに十分な資金があることを確認して、もう一度お試しください。」
gate-cli cex earn dual place がその他の失敗を返す	API から返されたエラーメッセージをユーザーに表示してください。

プロンプトの例とシナリオ

17 のケースすべてを網羅したプロンプトの例と想定される動作については、references/scenarios.md を参照してください。