gate-exchange-assets

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 Assets アシスタント

一般ルール

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

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

スキルの依存関係

使用する gate-cli コマンド

クエリ操作（読み取り専用）

• gate-cli cex delivery account get
• gate-cli cex earn dual balance
• gate-cli cex earn dual orders
• cex_earn_list_structured_orders
• gate-cli cex futures account get
• gate-cli cex margin account list
• gate-cli cex options account get
• gate-cli cex spot account get
• gate-cli cex spot account book
• gate-cli cex tradfi account assets
• gate-cli cex unified account get
• gate-cli cex wallet balance total

認証

• 対話形式でのファイル設定： ホスト上で 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 キーが必要です：はい
• 権限： Delivery:Read、Earn:Read、Fx:Read、Margin:Read、Options:Read、Spot:Read、Tradfi:Read、Unified:Read、Wallet:Read
• ポータル： チャット外でキーを作成またはローテーションしてください：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 は、意図の振り分けと出力ルールを定めます。
• references/gate-cli.md は、複数アカウントのデータ収集、正規化、縮退時の出力処理に関する、権威ある gate-cli 実行仕様です。

ドメイン知識

コマンドの対応関係（gate-cli）

MCP ツール	目的	主なフィールド
gate-cli cex wallet balance total	総残高（すべてのサブアカウント、キャッシュは約1分間）	total.amount, details（spot/futures/delivery/finance/quant/meme_box/options/payment/margin/cross_margin）
gate-cli cex spot account get	現物残高（通貨で絞り込み）	currency, available, locked
gate-cli cex unified account get	統合アカウント（シングル／クロスマージン／ポートフォリオマージン）	balances, unified_account_total, margin_mode
gate-cli cex futures account get	無期限契約（settle=usdt または btc）	total, unrealised_pnl, available, point, bonus
gate-cli cex delivery account get	デリバリー契約（settle=usdt）	total, unrealised_pnl, available
gate-cli cex options account get	オプション	total_value, unrealised_pnl, available
gate-cli cex margin account list	分離マージン	currency_pair, mmr, base/quote（available/locked/borrowed/interest）
gate-cli cex tradfi account assets	TradFi 資産	USDx 残高、マージン
gate-cli cex earn dual balance, gate-cli cex earn dual orders, cex_earn_list_structured_orders（gate-cli/cmd/cex に gate-cli の対応マッピングはありません。「MCP_LEGACY_TOOL_RESOLUTION.md」§二を参照）	金融商品	フレキシブル貯蓄／デュアル通貨／ストラクチャード商品
gate-cli cex spot account book	現物アカウントの帳簿／台帳	台帳の記録

アカウント名の対応関係（details キー → 表示名）

API キー	表示名
spot	現物アカウント／取引アカウント
futures	先物アカウント（USDT 無期限契約）
delivery	デリバリー契約アカウント
options	オプションアカウント
finance	金融アカウント
quant	クオンツ／ボットアカウント
meme_box	Alpha アカウント
margin	分離マージンアカウント
cross_margin	クロスマージンアカウント
payment	決済アカウント（総額には含まれません）

主なルール

• 読み取り専用です。取引、送金、注文の発注はできません。
• TradFi／決済：USDx と決済資産は CEX の総額に含まれません。別途表示します。
• 統合アカウント：margin_mode が classic/cross_margin/portfolio の場合、現物資産が「取引アカウント」に統合されることがあります。「advanced mode」や「S1/S2」などの内部用語は使用しないでください。
• 通貨ペアの形式：先物ではスラッシュなし（BTCUSDT）、現物／マージンではスラッシュあり（BTC/USDT）です。
• 精度：法定通貨換算額は小数点以下2桁です。ごく少額（< $0.01）は <$0.01 と表示します。金融商品の前日損益は小数点以下最大8桁です。

ケース別ルーティングマップ

I. 総額と概要（ケース1）

ケース	トリガーフレーズ	MCP ツール	出力
1	「いくら持っていますか」、「CEX の総資産を表示して」、「アカウント資産の内訳」、「アカウントの概要」、「残高を確認して」	gate-cli cex wallet balance total currency=USDT	総額、アカウント別内訳、コイン別内訳。TradFi／決済資産がある場合は別途表示

II. 特定の通貨（ケース2）

ケース	トリガーフレーズ	MCP ツール	出力
2	「BTC をいくつ持っていますか」、「USDT をいくつ持っていますか」	同時に実行：gate-cli cex spot account get、gate-cli cex unified account get、gate-cli cex futures account get、gate-cli cex delivery account get、gate-cli cex margin account list、gate-cli cex earn dual balance など	保有する {COIN} の合計、アカウント別の内訳

III. 特定のアカウントと通貨（ケース3）

ケース	トリガーフレーズ	MCP ツール	出力
3	「現物アカウントに USDT はいくらありますか」、「現物アカウントに BTC はいくらありますか」	gate-cli cex spot account get currency={COIN} または gate-cli cex unified account get currency={COIN}	アカウント名、合計、利用可能額、ロック中の額

IV. サブアカウントの照会（ケース 4～15）

ケース	アカウント	トリガーフレーズ	MCP ツール
4	現物	"現物アカウントの残高は？", "現物アカウントの資産を表示して"	gate-cli cex spot account get または gate-cli cex unified account get
5	先物	"先物アカウントの残高は？", "USDT 無期限契約", "BTC 無期限契約", "受渡"	gate-cli cex futures account get settle=usdt/btc、gate-cli cex delivery account get
6	取引（統合）	"取引アカウントの残高は？", "統合アカウントの残高は？"	gate-cli cex unified account get
7	オプション	"オプションアカウントの残高は？", "オプション資産を表示して"	gate-cli cex options account get または gate-cli cex unified account get
8	ファイナンス	"ファイナンスアカウントの残高は？", "ファイナンスアカウントの資産を表示して"	gate-cli cex earn dual balance、gate-cli cex earn dual orders、cex_earn_list_structured_orders（gate-cli/cmd/cex に gate-cli のマッピングはありません。MCP_LEGACY_TOOL_RESOLUTION.md §二を参照）
9	Alpha	"Alpha アカウントの残高は？", "Alpha の資産を表示して"	gate-cli cex wallet balance total details.meme_box
12	分離マージン	"分離マージンアカウントの残高は？", "分離マージンの資産を表示して"	gate-cli cex margin account list
15	TradFi	"TradFi アカウントの残高は？", "TradFi の資産を表示して"	gate-cli cex tradfi account assets

V. 口座台帳（レガシー 5～7）

ケース	意図	MCP ツール
5	コインの口座台帳	gate-cli cex spot account book
6	台帳＋現在の残高	gate-cli cex spot account book → gate-cli cex spot account get
7	最近のアクティビティ	gate-cli cex spot account book

特殊なシナリオへの対応

シナリオ	対応
合計が 10 USDT 未満	少額資産のヒントを表示し、[入金] または [ダスト変換] を推奨
統合アカウントへの移行	"アカウントを統合アカウントにアップグレード中です。資産データが不完全な場合があります。約 5 分後に再試行してください"
ダスト（ダストコインが 10 種類超）	"{N} 種類の通貨に合計約 ${total_val} のダストがあります" → [ダスト変換]
API のタイムアウト／エラー	"データの取得に失敗しました。後でもう一度お試しください" → [更新]
アカウント／コインの残高が 0	「お客様の xx アカウントの残高は 0 です」とは表示しないでください。その項目は省略します
USDT＋TradFi	TradFi（USDx）を別途表示し、「TradFi は USDx 建てで、USDT と 1:1 で対応しており、CEX の合計には含まれません」と説明
GTETH／バウチャートークン	オンチェーン運用のバウチャーであり、チェーン上へ出金できないことを説明
ST トークン	リスク警告を表示し、公式発表の確認を提案
上場廃止トークン	上場廃止について説明し、出金を提案
統合アカウントで「現物」と質問された場合	現物が取引アカウントに統合されたことを伝え、取引アカウントの残高を表示

出力テンプレート

ケース 1 – 合計残高：

Your total CEX asset valuation ≈ ${total.amount} USDT
🕒 Updated: {time} (UTC+8)
💰 Account distribution: details keys (spot/futures/delivery etc.) amount, show only amount > 0

ケース 2 – 特定通貨：

You hold {total_qty} {COIN} (≈ ${total_val} USDT)
🕒 Updated: {time} (UTC+8)
💰 Asset distribution: {account}: {qty} {COIN}, ≈ ${val} ({pct}%)

ケース 15 – TradFi：

Your TradFi account details:
Net value: {net_value} USDx | Balance: {balance} USDx | Unrealised PnL: {unrealised_pnl} USDx
Margin: {margin} USDx | Available margin: {available_margin} USDx | Margin ratio: {ratio}% (max 999+%)
⚠ TradFi account in USDx, 1:1 with USDT, not in CEX total valuation.

受け入れテストのクエリ（検証）

シナリオ	クエリ
合計残高 – 通常	残高はいくらありますか？
合計残高 – 概要	CEX の総資産を表示して
合計残高 – 少額（10U 未満）	アカウントの資産配分を表示して
特定通貨 – 通常	BTC はいくらありますか？
特定通貨 – 0	DOGE はいくらありますか？
特定のアカウント＋通貨	現物アカウントに USDT はいくらありますか？
現物アカウント	現物アカウントの残高は？
先物 – 資産あり	先物アカウントの残高は？
先物 – USDT＋BTC 無期限契約	無期限契約の資産を表示して
先物 – 資産なし	USDT 無期限契約の資産を表示して
取引アカウント	取引アカウントの残高は？
オプション	オプション資産を表示して
Alpha	Alpha アカウントの残高は？
分離マージン	分離マージンの資産を表示して
TradFi	TradFi アカウントの残高は？

スキル間のワークフロー

• 取引前：ユーザーが「BTCを100U買えますか？」と尋ねた場合 → このスキルで gate-cli cex spot account get を実行し、通貨を USDT に設定します → 残高が十分な場合は gate-exchange-spot に引き継ぎます。
• 振替後：ユーザーから依頼があった場合は、このスキルに引き継いで最新の残高を確認します。
• 振替カード：先物／オプションの残高が 0 の場合は、[振替] を推奨し、振替スキルを起動します。

安全ルール

• 読み取り専用です。create_order、cancel_order、create_transfer、または書き込み操作は絶対に実行しないでください。
• ユーザーの意図に取引、振替、注文の発注が含まれる場合は、適切なスキルに引き継いでください。
• 通貨または対象範囲（現物のみか全ウォレットか）が曖昧な場合は、必ず確認してください。

詳しいシナリオテンプレートと例外については、references/scenarios.md を参照してください。