gate-exchange-assetswap

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 の資産配分最適化

一般ルール

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

• このスキルに明記されている gate-cli コマンドのみを使用してください。 ここに記載されていないコマンドは、ほかのインターフェースで利用できる場合でも、これらのワークフローでは実行してはいけません。

スキルの依存関係

使用する gate-cli コマンド

照会操作（読み取り専用、プロファイルスコープ）

• gate-cli cex assetswap assets
• gate-cli cex assetswap config
• gate-cli cex assetswap evaluate
• gate-cli cex assetswap order list
• gate-cli cex assetswap order get

実行操作（書き込み、取引スコープ）

• gate-cli cex assetswap order preview
• gate-cli cex assetswap order create

認証

• 対話形式でのファイル設定： ホスト上で 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 は不要です。シークレットをチャットに貼り付けるようユーザーに求めてはいけません。
• API キーが必要です：はい
• 権限： 一覧表示、設定、評価、注文照会にはプロファイル（読み取り）権限が必要です。プレビューと注文作成には取引権限が必要です。
• ポータル： キーの作成またはローテーションは、チャット以外で行ってください：https://www.gate.com/myaccount/profile/api-key/manage

インストールの確認

• 必須： 資産配分最適化ツール（MCP 名 cex_assetswap_*）が有効になった Gate（メイン）MCP。ホストの CLI から実行する場合は、gate-cli cex assetswap … を優先してください。
• インストール（MCP／IDE）： gate-mcp-cursor-installer、gate-mcp-codex-installer、gate-mcp-claude-installer、または gate-mcp-openclaw-installer。
• 認証情報： ホストに GATE_API_KEY と GATE_API_SECRET の両方が（空でない値で）設定されている場合、gate-cli config init を必須にしてはいけません。両方とも未設定または空の場合は、gate-cli config init を実行するか、スキルライブラリ内の対応するスキルで GATE_API_KEY ／ GATE_API_SECRET を設定するよう、オペレーターに伝えてください（シークレットをチャットに貼り付けるようユーザーに求めてはいけません）。
• 動作確認： プレビューまたは注文作成の前に、ランタイムが動作することを確認してください（例：gate-cli --version またはデプロイ環境固有の確認）。

---

トリガー条件

次のいずれかをユーザーが希望している場合に、このスキルを有効にします。

• 複数の現物資産のポートフォリオ最適化、または保守的なステーブルコイン、確信のある単一資産、時価総額加重バスケットなどの戦略へのリバランス
• 資産配分の最適化の対象となる適格な現物残高の確認
• 確定前に、推定約定、スリッページ、リスクに関するヒントをプレビュー
• 確認後、資産配分の最適化注文を送信
• 資産配分の最適化注文の履歴、または特定の注文のステータスと子注文を照会

次の場合は、このスキルを使用しないでください：口座間または商品間の振替、Launchpool または収益商品の申し込み、資産配分商品を使わない単発の手動現物指値／成行注文、商品しきい値を下回る少額残高の処理。この場合は、該当する振替、収益商品、現物、または少額残高用の商品スキルに振り分けてください。

---

データのプライバシーと収集

• AI インタラクション情報：このスキルの実行中に使用するユーザーのプロンプト、追加指示、ツール引数は、Gate Privacy Policy の §4.2.7 に定める AI インタラクションデータに該当します。ユーザー向けの出力で API キー、シークレット、または無関係な個人データを求めたり、繰り返し記載したりしないでください。
• データフロー：このスキルの口座データと取引データは、上記の資産スワップツール（MCP cex_assetswap_* または同等の gate-cli cex assetswap … 呼び出し）を介して、設定済みの Gate（メイン）MCP から Gate Exchange API にのみ送信します。このワークフローの一環として、同じデータを文書化されていないサードパーティーサービス、スクレイパー、またはカスタムバックエンドに中継しないでください。
• 最小化：文書化された各 MCP 呼び出しに必要なパラメーター（シンボル、数量、戦略フィールド、ページネーション）のみを渡してください。チャットの全履歴や無関係なコンテキストフィールドをツールのペイロードに含めないでください。

---

ドメイン知識

商品：資産配分の最適化は、複数の現物保有資産を目標構成に組み替える Exchange の機能を提供します。最適化の 1 件が、注文レイヤーで複数の内部約定レッグに対応する場合があります。

戦略タイプ（概念上のものです。正確な列挙値とパラメーターは gate-cli cex assetswap config から取得します）：

戦略	一般的な目標	意味
保守的	USDT、GUSD、USDC（例）	単一のステーブルコインに集約し、リスク回避または待機資金の状態にします
確信（「faith」）	BTC、ETH、GT（例）	選択した現物資産を、選択した資産の目標ウェイトに向けて再配分します。中間ステップは商品と API に従います
時価総額	Top 2、Top 5（例）	BTC、ETH、SOL、BNB、XRP などのバスケットに、時価総額で加重したインデックス型のエクスポージャーを持たせます（実際のリストは API から取得します）

一覧表示のルール（エージェントによる解釈用です。商品側でサーバーサイドフィルタリングされる場合があります）：

• デフォルトの表示では、ユーザーが売却対象に含めるよう明示的に求めない限り、主要な準備資産（例：BTC、ETH、USDT、USDC）が除外される場合があります。
• 参加できるのは現物の利用可能残高のみです。収益商品、借入、ステーキングなどでロックされている残高は対象外です。
• ごく少額の残高（例：約 10 USD 相当未満）は非表示になったり、少額残高処理に振り分けられたりする場合があります。正確なしきい値は API または商品ルールに従います。

公開スキルのドキュメントの対象外（標準的な Exchange MCP 機能として文書化しないでください）：

• バナーまたは UI のみに関する機能フラグ
• Exchange MCP として公開されていない、標準外の意味的な「パラメーターの検証と補完」ヘルパー

レート制限：文書化されている場合は、ウォレットまたは Exchange API の制限に合わせてください（例：ユーザーまたはキーごとに 10 秒あたり 200 リクエスト）。公開 API ドキュメントで確認してください。

プレビューから作成ペイロードへ（エージェントには必須）：

• gate-cli cex assetswap order preview が成功したら、プレビュー応答の data.order のみを基に gate-cli cex assetswap order create の本文を構築します。data.order.from と data.order.to の各オブジェクトについて、プレビューの asset と amount の文字列フィールドを使い、{ "asset": <value>, "amount": <value> } を出力します（公開されている API ドキュメントで別途指定されていない限り、amount_show ではなく amount を使用してください）。
• data.order で返された to の配列順序（複数のレッグがある場合は from の配列順序も）をそのまま維持し、都合に合わせてシンボルを並べ替えないでください。
• プレビューリクエストでは to に ratio を使用できますが、create 呼び出しでは、プレビュー出力から解決済みの asset + amount のレッグを引き続き使用する必要があります。プレビューの金額を省略して ratio のみの to で作成すると、見積もりエラー（例：code: 4）になることがよくあります。
• API がプレビューに関連する追加フィールド（例：トップレベルの usdt_evaluated_value や data 内の transaction_fee）を返す場合、MCP または Exchange のドキュメントで必須とされている場合は、create にも同じフィールドを含めてください。それ以外の場合、プレビューの from / to レッグが主な契約内容です。

メインチェーン（配置時に必須の順序）：

1. ケース 1 — 対象となるアセットの一覧表示
2. ケース 2 — 戦略とパラメーター設定の取得
3. ケース 3 — 取引前の評価とプレビュー（3a は任意、3b は強く推奨、またはプロダクトルールにより必須）
4. ケース 4 — プレビューをユーザーが明示的に確認した後に注文を作成

プロダクトルールで明示的に許可されていない限り、ケース 3b のプレビューを経ずにケース 2 からケース 4 に進まないでください。

追加クエリ（メインチェーンの順序を変更しないでください）：

• ケース 5 — ページネーション付きの注文一覧
• ケース 6 — 個別注文の詳細

注文状態（例）：設定中、完了、一部完了、失敗 — API のフィールド名と応答で返される値を使用してください。

ツールの対象範囲の概要：

ツール	種類	対象範囲
gate-cli cex assetswap assets	読み取り	profile
gate-cli cex assetswap config	読み取り	profile
gate-cli cex assetswap evaluate	読み取り	profile
gate-cli cex assetswap order list	読み取り	profile
gate-cli cex assetswap order get	読み取り	profile
gate-cli cex assetswap order preview	書き込み	trade
gate-cli cex assetswap order create	書き込み	trade

コンプライアンス：API により、制限対象地域、KYC、および無効化されたアカウントに関する制限が適用されます。コンプライアンスエラーが発生した場合は、メッセージをそのまま伝えて処理を停止してください。プラットフォームが保証していない結果を約束しないでください。

エージェントは次のことをしてはいけません：PnL、VIP ティアレベルの変更を保証したり、適格性ルールを回避したりすること。

---

ワークフロー

ステップ 1：ユーザーの目標を特定し、アセット配分の最適化以外のリクエストを振り分ける

リクエストを次のように分類します：（A）情報の確認のみ、（B）プレビューまでの完全な最適化と、任意での注文、（C）履歴または個別注文のステータス確認。

ユーザーメッセージとセッションコンテキストのみから意図と振り分け先を推定してください。このステップでは、cex_* MCP ツールを呼び出さないでください。ユーザーが一般的な現物注文を1件だけ行いたい場合、または振替、グリッドボット、Earnの操作を行いたい場合は、このスキルの使用を停止し、適切な Gate Exchange スキルに振り分けてください。

抽出する主なデータ：

• goal：list_only | evaluate_only | preview | place_order | order_list | order_detail
• strategy_hint：conservative | conviction | market_cap | unknown（config で確認）
• symbols_or_scope：ユーザーが対象に含める、または除外するアセット

ステップ 2：ケース 1 — 最適化対象となるアセットの一覧表示

MCP および API ドキュメントに従ったパラメーター（ドキュメントにないフィールドは使用しない）で gate-cli cex assetswap assets を呼び出します。

抽出する主なデータ：

• eligible_assets：API が返すシンボル、利用可能な金額、評価額の目安
• 次のステップに進むために、ユーザーが対象を絞り込む必要があるかどうか

ステップ 3：ケース 2 — 設定の読み込み

gate-cli cex assetswap config を次の条件で呼び出します：API で任意のフィルターが指定されていない限り、必須の本文はありません。利用可能な戦略、ターゲット、上限、精度のルールを取得します。

抽出する主なデータ：

• allowed_strategies と、TopN、ターゲット資産、上限に関するパラメーターの形式
• 次のリクエストペイロードを作成する際にエージェントが適用すべき制約

ステップ 4：ケース 3a — 評価（任意）

最終的なパラメーターを決める前に簡易見積もりが必要な場合や、戦略の選択を調整している場合：

gate-cli cex assetswap evaluate を次の条件で呼び出します：選択した資産と戦略について API が要求するペイロードを指定します。

抽出する主なデータ：

• evaluation_summary：推定想定元本や、返されるその他の指標
• 警告または検証エラー

ステップ 5：ケース 3b — 注文のプレビュー（通常のフローでは作成前に必須）

ユーザーが資産のセットと戦略パラメーターを確認した後：

gate-cli cex assetswap order preview を次の条件で呼び出します：API ドキュメントに従って、候補の選択と戦略フィールドを指定します。

プレビューの結果（約定見込み、スリッページやリスクに関するヒント、サーバー側からの通知など）を明確に提示します。ステップ 6 の前に、プレビュー後の明示的なユーザー確認を得てください。

市場が変動した場合、またはプレビューが期限切れになった場合は、注文を作成する前にステップ 5（必要に応じてステップ 4 も）を繰り返します。

抽出する主なデータ：

• preview_reference_fields：ステップ 6 で必要となる見積もり、トークン、有効期限のフィールド（レスポンススキーマに厳密に従う）
• create_from_legs：data.order.from を各要素 { asset, amount } に縮小したコピー（プレビューの amount を使用し、amount_show は使用しない）
• create_to_legs：data.order.to を各要素 { asset, amount } に縮小したコピー（プレビューと同じ順序）
• user_confirmed：ブール値 — 処理を進めるには true である必要があります

ステップ 6：ケース 4 — 最適化注文の作成

プレビューが正常に完了し、明示的な確認を得た後に限り：

gate-cli cex assetswap order create を次の条件で呼び出します：from がステップ 5 の create_from_legs、to が同ステップの create_to_legs である JSON 本文を指定します（各レッグの asset と amount は data.order から取得します）。API が要求していることがドキュメントまたは失敗の繰り返しから確認できた場合に限り、プレビューに関連するその他のフィールド（たとえば usdt_evaluated_value や transaction_fee などの data 内の値）を追加します。プレビューですでにターゲット資産ごとの具体的な amount が返されている場合、このステップでは比率のみの to に置き換えないでください。

抽出する主なデータ：

• order_id または同等の識別子
• 初期ステータスとタイムスタンプ
• 次のステップに関する案内（詳細のポーリングまたは履歴の表示）

ステップ 7：ケース 5 — 注文一覧（補助）

最近の履歴をユーザーが求めた場合：

gate-cli cex assetswap order list を次の条件で呼び出します：API に従ってページネーションのパラメーターを指定します（たとえば、製品で定義されている直近数か月分）。

抽出する主なデータ：

• orders[]：識別子、ステータス、作成日時
• 存在する場合はページネーションカーソルまたはフラグ

ステップ 8：ケース 6 — 注文詳細（補助）

ユーザーが注文 ID を指定するか、一覧から注文を選んだ場合：

gate-cli cex assetswap order get を次の条件で呼び出します：MCP および API のドキュメントに従って、order_id 文字列を指定します。

抽出する主なデータ：

• 返される場合は、集約ステータスと子注文ごとの状態
• API が返す、消費された数量と受け取った数量

---

エラー処理

状況	対応
プレビューの有効期限切れ、または価格が無効	gate-cli cex assetswap order preview を再実行し（必要に応じて評価も再実行し）、簡潔に説明します
プレビュー成功後の作成で見積もりエラーが返された	作成リクエスト本文で、プレビューの注文内容を保持した data.order.from / data.order.to の asset + amount を使用していることを確認します。プレビューを再実行してから再試行します。プレビューで金額が返された場合、比率のみの to は避けます
利用可能残高が不足	作成を中止し、ユーザーに残高を空けるか選択内容を調整するよう依頼します
レート制限	時間をおいて再試行し、API メッセージを表示します
コンプライアンスまたは地域によるブロック	中止し、コンプライアンスに関するメッセージを伝えます。回避策を使って再試行しないでください
一部のみ完了	gate-cli cex assetswap order get から実際のステータスを報告します。完了時刻は保証されません

---

安全に関するルール

• 取引リスク：デジタル資産の取引には大きなリスクが伴い、投資額の一部または全額を失う可能性があります。Gate リスク開示およびユーザー規約をご確認ください。
• この製品のランタイムルールで、ユーザー自身による明示的な一回限りの許可が定義されている場合を除き、プレビュー内容についてユーザーから明確な確認を得て、プレビューが成功するまでは、gate-cli cex assetswap order create を決して呼び出さないでください（デフォルトでは確認が必要です）。
• プレビューの応答に amount を含む data.order.to の項目がある場合、比率のみの対象レッグで作成ペイロードを構成しないでください。作成には、それらの asset + amount の組み合わせと、対応する from レッグを使用してください。
• API がエラーを返した場合、注文 ID、プレビュートークン、成功を捏造しないでください。
• 約定までは、レートと金額を見積もりとして表示してください。最終的な決済結果が正確な値です。
• ユーザーに表示される出力に API キーやシークレットを含めないでください。

---

判断ロジックの概要

条件	対応
ポートフォリオ最適化の対象となる現物資産をユーザーが求めている	ケース 1 のみ（gate-cli cex assetswap assets）
戦略の選択肢や上限をユーザーが必要としている	ケース 2（gate-cli cex assetswap config）
ユーザーが簡易見積もりを希望している	ケース 3a（gate-cli cex assetswap evaluate）
ユーザーが実行可能なプレビューを確認したい	ケース 3b（gate-cli cex assetswap order preview）
ユーザーがプレビューを確認した	ケース 4（gate-cli cex assetswap order create）
ユーザーが過去の最適化について尋ねている	ケース 5（gate-cli cex assetswap order list）
ユーザーが特定の注文の進捗を尋ねている	ケース 6（gate-cli cex assetswap order get）
ユーザーが単一の現物注文またはグリッドボットを希望している	このスキルの対象外として案内します
プレビューが失敗した、または有効期限が切れた	プレビューを再実行します。作成はしません

---

報告テンプレート

## Asset allocation optimization

**Goal**: {list | evaluate | preview | order placed | history | detail}

**Eligible assets (summary)**: {N} items, {optional total valuation if API provides}

**Strategy**: {conservative | conviction | market_cap | from API}

**Preview** (if run):
- Key figures: {from API}
- Create legs (if placing order): {`from`/`to` as `asset`+`amount` from `data.order`}
- Risk or slippage notes: {from API}

**Order** (if created):
- Order ID: {id}
- Status: {status}

**History / detail** (if queried):
- {table or bullet list from API}

**Disclaimer**: Digital asset trading involves significant risk and may result in partial or total loss of your investment. Figures are from Gate Exchange APIs; final balances and fees follow account records. No PnL or VIP impact is guaranteed.