gate-exchange-assets-manager

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 アカウントおよび資産マネージャー

これは、7つのL1スキルにわたる重複排除済みのMCPツール呼び出し58件（読み取り54件＋書き込み4件）を連携させるL2複合スキルです。アカウントと資産の概要、証拠金および清算リスクの評価、SimpleEarnとステーキングの収益スナップショット、アフィリエイト手数料の照会、統合アカウントの書き込み操作（借入、担保、レバレッジ設定）への統一されたエントリーポイントを提供します。 このスキルは、18歳以上で完全な民事行為能力を有するユーザーを対象としています。

一般ルール

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

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

スキルの依存関係

使用するgate-cliコマンド

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

• gate-cli cex alpha account balances
• gate-cli cex alpha market currencies
• gate-cli cex alpha market tickers
• gate-cli cex alpha market tokens
• gate-cli cex earn staking assets
• gate-cli cex earn staking awards
• gate-cli cex earn staking find
• gate-cli cex earn uni currency
• gate-cli cex earn uni interest
• gate-cli cex earn dual balance
• gate-cli cex earn dual orders
• cex_earn_list_structured_orders
• gate-cli cex earn uni currencies
• gate-cli cex earn uni rate
• gate-cli cex earn uni lends
• gate-cli cex earn staking orders
• gate-cli cex futures account get
• gate-cli cex futures market candlesticks
• gate-cli cex futures market contract
• gate-cli cex futures market funding-rate
• gate-cli cex futures market orderbook
• gate-cli cex futures market premium
• gate-cli cex futures market tickers
• gate-cli cex futures market trades
• gate-cli cex futures market liquidations
• gate-cli cex futures position list
• gate-cli cex margin account list
• gate-cli cex options account get
• gate-cli cex rebate broker commissions
• gate-cli cex rebate broker transactions
• gate-cli cex rebate partner commissions
• gate-cli cex rebate partner sub-list
• gate-cli cex rebate partner transactions
• gate-cli cex rebate user-info
• gate-cli cex rebate sub-relation
• gate-cli cex spot account get
• gate-cli cex spot market candlesticks
• gate-cli cex spot market orderbook
• gate-cli cex spot market tickers
• gate-cli cex spot market trades
• gate-cli cex spot account book
• gate-cli cex tradfi account assets
• gate-cli cex unified account get
• gate-cli cex unified query borrowable
• gate-cli cex unified query estimate-rate
• gate-cli cex unified mode get
• gate-cli cex unified query transferable
• gate-cli cex unified config leverage-get
• gate-cli cex unified config discount-tiers
• gate-cli cex unified account currencies
• gate-cli cex unified loan interest
• gate-cli cex unified loan records
• gate-cli cex wallet balance total

実行操作（書き込み）

• gate-cli cex unified loan create
• gate-cli cex unified config collateral
• gate-cli cex unified mode set
• gate-cli cex unified config leverage-set

認証

• 対話型のファイル設定： ホスト上で 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 は不要です。シークレットをチャットに貼り付けるよう、ユーザーに求めないでください。
• 権限： Alpha:Read、Earn:Read、Fx:Read、Margin:Read、Options:Read、Rebate:Read、Spot:Read、Tradfi:Read、Unified:Write、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 実行の規範となる仕様です。

サブモジュール

モジュール	L1 ソース	ツール数	読み取り／書き込み	目的
S1 資産／概要	gate-exchange-assets, gate-exchange-alpha	10+	読み取り専用	複数アカウントの残高を一覧で把握
S2 リスク／マージン	gate-exchange-unified, gate-exchange-marketanalysis	6+	読み取り専用	マージン比率、清算価格、未実現損益
S3 Earn／利回り	gate-exchange-simpleearn, gate-exchange-staking	4	読み取り専用	SimpleEarn とステーキングの現在のポジション／利息スナップショット
S4 アフィリエイト／リベート	gate-exchange-affiliate	7	読み取り専用	リベートのユーザー情報（空の場合あり）、パートナー報酬の履歴、サブアカウントとの関係
S5 借入／振替（書き込み）	gate-exchange-unified	6	読み取り 2 + 書き込み 4	借入、担保の設定、レバレッジの設定、モードの切り替え

注：gate-exchange-tradfi の TradFi ツール（読み取りツール 10 個）はすべて読み取り専用で、資産一覧の照会に使用されます。重複を除いたツール数 58 個には含まれますが、上記のサブモジュール表では独立した L1 モジュールとして記載していません。

ルーティング規則

設計原則

ユーザーのクエリは、複数の観点にまたがることがよくあります（例：「Earn の利息を確認して、清算されるか知りたい」は S3 と S2 に該当します）。単一の意図に分類することを強制するのではなく、このスキルではシグナルの重ね合わせを使用します。クエリから 5 つのシグナル次元をそれぞれ独立して検出し、有効になった次元に対応するツールセットを追加します。最終的なツールセットは、有効になったすべてのシグナルの和集合とし、実行前に重複を除きます。

シグナルのディメンション定義

シグナル	ディメンション	トリガー条件	トリガーキーワード	ツールのサブセット
S1	資産／概要	ユーザーが全体の資産、複数アカウントの残高、資産一覧を尋ねる場合。また、読み取り専用の借入可能額／金利の照会（実行の意図なし）や、送金可能額のスナップショットも対象です	資産、残高、アカウント、どれくらい、総資産、資産一覧、借入可能額（照会のみ）、送金可能額	gate-cli cex wallet balance total、gate-cli cex spot account get、gate-cli cex unified account get、gate-cli cex futures account get、gate-cli cex margin account list、gate-cli cex options account get、gate-cli cex earn uni lends、gate-cli cex earn staking assets、gate-cli cex alpha account balances、gate-cli cex tradfi account assets。照会サブセット：+ gate-cli cex unified query borrowable、gate-cli cex unified query estimate-rate、gate-cli cex unified query transferable
S2	リスク／証拠金	ユーザーが清算、証拠金、清算価格、未実現損益、ポジションのリスクを尋ねる場合	清算、証拠金、清算価格、未実現損益、ポジション、リスク、追加証拠金請求	gate-cli cex unified account get、gate-cli cex futures position list、gate-cli cex futures market tickers、gate-cli cex futures market contract、gate-cli cex futures market funding-rate、gate-cli cex futures market premium
S3	Earn／利回り	ユーザーが既存の SimpleEarn またはステーキングのポジション、発生した利息や報酬を尋ねる場合（スナップショットのみ。商品の選択は対象外です）	Earn のポジション、ステーキングのポジション、利息、利回り、報酬	gate-cli cex earn uni lends、gate-cli cex earn uni interest、gate-cli cex earn staking assets、gate-cli cex earn staking awards（注：商品選択ツールである list_uni_currencies／list_uni_rate／find_coin は含みません。これらのリクエストは Smart Earn に振り分けられます）
S4	アフィリエイト／リベート	ユーザーがアフィリエイトのステータス、パートナーデータ、コミッションを尋ねる場合	リベート、アフィリエイト、コミッション、パートナー、ブローカー、紹介	gate-cli cex rebate user-info、gate-cli cex rebate partner commissions、gate-cli cex rebate partner sub-list、gate-cli cex rebate partner transactions、gate-cli cex rebate sub-relation、gate-cli cex rebate broker commissions、gate-cli cex rebate broker transactions
S5	借入／振替（書き込み）	ユーザーに明確な実行意図がある場合：金額を指定した借入、証拠金の追加、担保の設定、モードの切り替え。「まだ借りない」のような否定表現を伴う「いくら借りられるか」といった照会のみのクエリでは有効になりません	借入［金額］、証拠金を追加、先物へ振替、担保を設定、モードを切り替え	gate-cli cex unified query borrowable、gate-cli cex unified query estimate-rate、gate-cli cex unified loan create、gate-cli cex unified config collateral、gate-cli cex unified mode set、gate-cli cex unified config leverage-set

ルーティングフロー

Input: User Query
Output: activated_signals[] + params{action_type, accounts[]}

1. Parameter Extraction
 Extract accounts[] (account types mentioned, 0-N)
 Extract action_type (borrow / transfer / add margin / setting / none)

2. Signal Detection (each dimension independent, non-exclusive, multi-select)
 S1 <- contains asset/balance/account/inventory expressions
 S2 <- contains liquidation/margin/position/risk expressions
 S3 <- contains earn/staking position/interest/rewards expressions
 S4 <- contains rebate/affiliate/commission/partner expressions
 S5 <- contains borrow/transfer/add-margin/setting expressions AND execution intent

3. Fallback Rules (if no signal explicitly activated)
 Vague account intent (e.g. "check my account") -> default S1 (asset overview)
 Account + risk keywords (e.g. "is it safe") -> default S1 + S2

4. Execution Mode
 S5 not activated -> read-only mode (query and summarise)
 S5 activated -> read+write mode (query -> Action Draft -> confirm -> execute)

5. Tool Set Assembly
 Tool Set = Union(all activated signal tool subsets)
 Deduplicate same tool + same parameters
 Independent tools run in parallel; S5 write operations run serially after reads

外部へのルーティング（対象外）

ユーザーの意図	ルーティング先
取引の実行（現物／先物の新規注文・決済）	Trading copilot スキル
コイン調査、市場分析、ニュース	Market research スキル
余剰資金の配分、商品の選択、APY の比較	Smart earn スキル
フラッシュスワップ／コイン交換	Flash swap スキル
サブアカウント管理	対象外
資産の週次レポート、期間をまたぐ分析	現在の API では未対応。App のレポートを案内
すべての事業ラインを横断した損益総勘定元帳	データソースの調整に信頼性がないため、モジュールごとのスナップショットを表示

ルーティング例の表

ユーザーのクエリ	accounts	有効化されたシグナル	説明
「自分のアカウントを確認して」	[]	S1（フォールバック）	明示的なディメンションのキーワードがないため、アセット概要にフォールバックします
「いくら持っていて、清算されますか？」	[]	S1 + S2	「いくら」がS1を、「清算される」がS2をトリガーします
「統合マージンは十分ですか？」	[unified]	S2	「マージン」がリスクをトリガーします
「清算価格と未実現損益を表示して」	[]	S2	「清算価格／未実現損益」がリスクをトリガーします
「Earnとステーキングでどれくらい増えましたか？」	[]	S3	「Earn／ステーキング／どれくらい」が利回りをトリガーします
「遊休資金をSimpleEarnかステーキングに回すべきですか？」	[]	—	スマートアーンにルーティングします。このスキルでは資金配分を行いません
「リベートはいくらありますか？」	[]	S4	「リベート」がアフィリエイトをトリガーします
「マージンが少ないので、マージンを追加してください」	[]	S2 + S5	「マージンが少ない」がS2を、「マージンを追加」がS5の書き込み操作をトリガーします
「いくら借りられますか？まだ借りないでください」	[]	S1	実行の否定によりS5は有効化されません。問い合わせ用サブセットのborrowable + estimate_rateを使用します
「いくら借りられますか？500 USDTを借りてください」	[]	S5	実行の意図があるため、照会後にアクション案を作成し、確認を経てcreate_loanを実行します
「いくらのUSDTを外部に送金できますか？（送金しないでください）」	[unified]	S1	送金可能額の読み取り専用照会です。transferable + unified_accountsを使用し、送金は実行しません
「総資産と先物マージンを一緒に表示して（分析は不要）」	[]	S1 + S2	事実に基づくスナップショットであり、S3や健全性／損益の説明は含みません
「資産の週間レポート／損益総額の台帳を作って」	[]	—	対応不可です。APIでは信頼できる資産分析や損益総額の算出をサポートできません。制約を説明し、アプリのレポートを案内します
「清算されそうです。現物口座に余剰残高はありますか？マージンを追加できますか？」	[]	S2 + S1 + S5	「清算されそう」がS2を、「現物口座の残高」がS1を、「マージンを追加」がS5をトリガーします

L1／L2の共存戦略

一部のユーザークエリは、単一のL1スキルのツールだけで対応できます（例：「いくら持っていますか」は数個のアセットツールのみで対応できます）。このL2では、複数のL1をまたいでオーケストレーションし、より包括的な集約レポートを提供します。

• 推奨戦略：「アカウント／資産／リスク」に関するリクエストはすべて、統一されたエントリーポイントとしてこのL2に送ります。サブインテントが単一のL1のツールセットだけで対応できる場合は、そのサブセットのみを呼び出して通常どおり出力します（ショートサーキット最適化）。
• 原則：統一されたエントリーポイントによって、すべてのアカウント／資産／リスクに関するクエリで一貫したユーザー体験を実現します。内部では、オーケストレーション全体を強制せず、必要に応じて1～N個のツールを呼び出します。

混合インテントの処理

ユーザークエリにアカウント／リスクのインテントと、その他のL2インテントの両方が含まれる場合（例：「アカウントを確認してからBTCを買って」）：

1. 2つのセグメントに分割します。アカウント／リスク部分はこのスキルが処理し、結論を出力します
2. 取引／リサーチ部分は対応するL2（トレーディングコパイロット／市場調査）にルーティングされ、それぞれ独立して実行されます
3. 例：「アカウントを確認してからBTCを少し買って」→このスキルが資産概要を作成→「取引部分はトレーディングコパイロットにルーティングされました」と案内します

エッジケースの処理

シナリオ	処理
ユーザーが詳細を指定せずに「自分の口座を確認して」と言う	フォールバック S1（資産概要）を実行し、資産の全体像を出力します
ユーザーが「安全ですか」／「問題ありませんか」と尋ねる	フォールバック S1 + S2 を実行し、資産の全体像と証拠金／清算の評価を出力します
ユーザーがサブアカウントについて尋ねる	「このスキルではサブアカウント管理に対応していません」と明示します
書き込み操作のパラメーターが不足している（例：「借りる」とだけ指定され、金額がない）	「借り入れる通貨と金額を確認してください」と追加情報を求めます。推測はしません
多言語／中国語と英語が混在するプロンプト	通常どおり意図とパラメーターを解析し、口座／資産／リスクに関する内容と特定できた場合は、このスキルを実行します
ユーザーが「どの運用商品が最適か」と尋ねる	商品の推奨範囲に該当するため、smart earn に振り分けます。このスキルでは既存のポジション／利回りのみを照会します
gate-cli cex rebate user-info が空のオブジェクトを返す	それでも gate-cli cex rebate partner commissions やその他の S4 ツールから S4 セクションを作成します。空の user_info を「アフィリエイトデータなし」と見なしてはいけません。「ドメイン知識：アフィリエイト／リベートデータ（S4）」を参照してください。

実行

読み取り専用のシナリオ（S1～S4、S5 なし）

1. ユーザーのクエリから該当するシグナルの次元を特定します
2. 該当するすべての次元から、重複を除いたツールセットを構成します
3. すべてのツールを並列で実行します（逐次的な依存関係はありません）
4. LLM が複数のソースからの結果を集約し、データのタイムスタンプとソースを注記します
5. 該当する各次元に応じた構造化レポートを出力します

書き込みシナリオ（S5 が有効）

1. フェーズ 1（並列読み取り）：S1／S2 のツールを実行し、現在の口座状態を取得します
2. LLM が実行可能性を評価し、アクション案を生成します（G. 書き込み操作のリスク区分に従います。中リスク＝モード切り替えのリスクに関する注記＋不可逆性、高リスクの借り入れ／返済＝金額＋通貨＋金利）
3. 主要パラメーターとリスクに関する注記を含むアクション案をユーザーに提示します
4. ユーザーの明示的な確認（Y/N）を待ちます
5. フェーズ 2（実行）：確認後にのみ書き込みツールの呼び出しを送信します
6. 実行結果を出力します

ツールの重複排除ルール

• 1 つのリクエスト内で、同じツールを同じパラメーターで呼び出す場合は 1 回だけ実行し、複数の集約処理で結果を再利用します
• 例：S1 と S2 の両方で必要な gate-cli cex unified account get は 1 回だけ実行します

gate-cli コマンドインデックス

重複排除済みツール一覧（58 ツール：読み取り 54、書き込み 4）

資産ドメイン（11 ツール、すべて読み取り）

#	ツール名	読み取り／書き込み	目的
1	gate-cli cex wallet balance total	読み取り	USDT 換算の総残高
2	gate-cli cex spot account get	読み取り	現物口座の通貨別残高
3	gate-cli cex unified account get	読み取り	統合口座の純資産／証拠金／借入
4	gate-cli cex futures account get	読み取り	先物口座の利用可能残高
5	gate-cli cex options account get	読み取り	オプション口座の残高
6	gate-cli cex margin account list	読み取り	分離マージン口座
7	gate-cli cex tradfi account assets	読み取り	TradFi 口座の純資産
8	gate-cli cex earn dual balance	読み取り	デュアル投資の残高
9	gate-cli cex earn dual orders	読み取り	デュアル投資の注文
10	cex_earn_list_structured_orders（gate-cli/cmd/cex に gate-cli のマッピングなし。MCP_LEGACY_TOOL_RESOLUTION.md §二を参照）	読み取り	ストラクチャード商品注文
11	gate-cli cex spot account book	読み取り	現物口座の台帳

統合アカウントドメイン（14 ツール、読み取り 10 ＋書き込み 4）

#	ツール名	R/W	目的
12	gate-cli cex unified account get	R	統合アカウントのエクイティ／証拠金率／借入残高
13	gate-cli cex unified mode get	R	現在の統合アカウントモード
14	gate-cli cex unified query borrowable	R	通貨ごとの借入可能額
15	gate-cli cex unified query transferable	R	送金可能額
16	gate-cli cex unified query estimate-rate	R	通貨ごとの統合アカウント借入推定レート（1 時間あたり。API の文字列形式の小数値であり、年率 APR／APY ではありません）。「ドメイン知識：統合アカウントの借入推定レート」を参照してください。
17	gate-cli cex unified account currencies	R	対応する統合通貨
18	gate-cli cex unified loan records	R	借入記録
19	gate-cli cex unified loan interest	R	借入利息の記録
20	gate-cli cex unified config leverage-get	R	通貨ごとのレバレッジ設定
21	gate-cli cex unified config discount-tiers	R	担保割引段階
22	gate-cli cex unified mode set	W	統合アカウントモードを切り替える
23	gate-cli cex unified loan create	W	借入／返済を実行する
24	gate-cli cex unified config leverage-set	W	通貨ごとのレバレッジを設定する
25	gate-cli cex unified config collateral	W	担保通貨を設定する

SimpleEarn ドメイン（5 ツール、すべて読み取り）

#	ツール名	R/W	目的
26	gate-cli cex earn uni currencies	R	SimpleEarn 対応通貨
27	gate-cli cex earn uni currency	R	単一通貨の SimpleEarn 詳細
28	gate-cli cex earn uni lends	R	ユーザーの SimpleEarn ポジション
29	gate-cli cex earn uni interest	R	SimpleEarn の利息収益
30	gate-cli cex earn uni rate	R	SimpleEarn の APY レート

ステーキングドメイン（4 ツール、すべて読み取り）

#	ツール名	R/W	目的
31	gate-cli cex earn staking assets	R	ステーキングポジション
32	gate-cli cex earn staking awards	R	ステーキング報酬の記録
33	gate-cli cex earn staking find	R	ステーキング可能なコインの検索
34	gate-cli cex earn staking orders	R	ステーキング注文履歴

市場分析ドメイン（12 ツール、すべて読み取り）

#	ツール名	R/W	目的
35	gate-cli cex spot market orderbook	R	現物注文板
36	gate-cli cex spot market candlesticks	R	現物 K ラインデータ
37	gate-cli cex spot market tickers	R	現物ティッカーのスナップショット
38	gate-cli cex spot market trades	R	現物取引記録
39	gate-cli cex futures market contract	R	先物契約の仕様
40	gate-cli cex futures market orderbook	R	先物注文板
41	gate-cli cex futures market candlesticks	R	先物 K ラインデータ
42	gate-cli cex futures market tickers	R	先物ティッカー（マーク価格）
43	gate-cli cex futures market trades	R	先物取引記録
44	gate-cli cex futures market funding-rate	R	資金調達率
45	gate-cli cex futures market liquidations	R	清算注文
46	gate-cli cex futures market premium	R	ベーシス／プレミアム指数

先物ポジション（1 ツール、読み取り）

#	ツール名	R/W	目的
47	gate-cli cex futures position list	R	すべての先物ポジション（未実現損益、清算価格）

アフィリエイト領域（7 ツール、すべて読み取り）

#	ツール名	R/W	目的
48	gate-cli cex rebate user-info	R	ユーザーのリベート概要（空のオブジェクトが返される場合があります。空の場合はコミッション履歴を参照してください）
49	gate-cli cex rebate sub-relation	R	ユーザーのアフィリエイト関係
50	gate-cli cex rebate partner sub-list	R	パートナーのクライアント一覧
51	gate-cli cex rebate partner commissions	R	パートナーのコミッション履歴
52	gate-cli cex rebate partner transactions	R	クライアントの取引履歴
53	gate-cli cex rebate broker commissions	R	ブローカーのコミッション履歴
54	gate-cli cex rebate broker transactions	R	ブローカーの取引履歴

Alpha 領域（4 ツール、すべて読み取り）

#	ツール名	R/W	目的
55	gate-cli cex alpha market currencies	R	Alpha 対応通貨
56	gate-cli cex alpha market tokens	R	Alpha トークン一覧
57	gate-cli cex alpha market tickers	R	Alpha ティッカーのスナップショット
58	gate-cli cex alpha account balances	R	ユーザーの Alpha ポジション

ドメイン知識

主な価値提案

• 複数のページを移動することなく、「資産の状況、Earn／アフィリエイトの概要、清算される可能性があるか」を一度のクエリで確認できます（資産の週間レポート、総合 PnL 台帳、遊休資金の配分計画は作成しません）。
• シナリオに応じて 58 のツール呼び出しを調整し、並列処理と逐次処理を使い分けます。結論とデータソースを追跡できます。
• 書き込み操作（借入／設定変更）には必ず確認が必要です。誤操作のリスクはゼロです。読み取り操作は高速に応答するため、すべて並列化されます。
• すべてのツールで API Key 認証が必要です。データは認証済みユーザー自身の表示範囲に限定されます。

対象ユーザー

• オープンポジションがあり、資産の概要をすばやく把握したいアクティブトレーダー
• 資産の安全性とリスク管理（マージン、清算）を重視するユーザー
• Earn／ステーキングの利回りやアフィリエイトのコミッション概要を定期的に確認するユーザー
• 統合アカウントの借入、レバレッジ、担保機能を利用する上級ユーザー

主な制約

• このスキルの対象はメインアカウントのみです。サブアカウントの管理は対象外です。
• マージン比率と清算価格は参考値です。必ず「取引所の実際の清算ルールに従います」と注記してください。
• 資産データにはスナップショットの遅延があります。出力には必ずデータのタイムスタンプを記載してください。
• 借入には利息が発生します。ユーザー自身で返済能力を判断する必要があります。
• 資産データはユーザー自身の表示範囲に限定されており、他のコンテキストに漏えいしてはなりません。
• クエリで有意な業務データが返されない場合（空のリスト、レコードなし）、ユーザー向けの出力で cex_* ツール名を列挙したり強調したりせず、「該当するレコードはありません」などの自然な表現を使用してください。

機能の境界（このスキルでできないこと）

• 取引（現物／先物の新規注文・決済）は実行しません。取引コパイロットに引き継いでください。
• コインの調査、市場分析、ニュースの確認は行いません。市場調査に引き継いでください。
• Earn 商品の推奨や申し込みの処理は行いません。スマート Earn に引き継いでください。
• サブアカウントは管理しません。
• 資産の週間レポートや期間をまたいだ資産分析は作成しません（API の制約）。
• すべての業務領域を横断した総合 PnL 台帳は作成しません（データソースに一貫性がないため）。
• 遊休資金の配分に関する助言や商品比較は行いません。スマート Earn に引き継いでください。

統合アカウントの推定借入金利（gate-cli cex unified query estimate-rate）

• 意味（Gate API）： このツールは、通貨ごとの現在の1時間あたりの推定借入金利を、文字列形式の小数（例："0.000002"）で返します。これは公開 API の仕様と一致しており、固定の年率ではなく、1時間あたりの推定値です。
• ユーザー向けの出力： 値が1時間あたりの推定金利（または同等の表現）であることを必ず明示してください。明示的な換算を行い、参考値にすぎないことを明確に示す場合（例：単純換算：1時間あたりの値 × 24 × 365。実際の利息計算はプラットフォームのルールに従います）を除き、生の数値を年率 APR/APYとして提示しないでください。
• 区別： gate-cli cex earn uni rate などの SimpleEarn ツールは、商品 APY 形式の数値を公開します。これは統合アカウントの借入推定とは別の商品ラインです。各数値の出典を明示せずに、1つの文の中で単位を混在させないでください。

よくある誤解

誤解	実際の内容
gate-cli cex unified query estimate-rate の数値は年率（APR）である	通貨ごとの1時間あたりの推定借入金利です。1時間あたりの値として明示してください。ユーザーから求められた場合に限り、明示的な換算と「参考値にすぎない」という表現を添えて年率換算してください。
「アカウントを確認して BTC を購入して」は、このスキルが取引を実行する	このスキルが扱うのは、アカウント／資産／リスクに関する照会と、限定的な書き込み操作（借入／設定）のみです。取引の実行はトレーディングコパイロットが担当します。
清算警告は実際の清算価格を示している	このスキルはスナップショットデータに基づいてリスクを評価します。必ず「実際の清算ルールは取引所の規定に従います」と明記してください。
このスキルでサブアカウントを照会または管理できる	このスキルの対象はメインアカウントのみです。サブアカウントの管理は対象外です。
「遊休資金を SimpleEarn とステーキングのどちらに回すべきか」は、このスキルが回答する	商品選択と資金配分はスマートアーンスキルが担当します。このスキルが提供するのは、既存保有資産のポジションと利回りのスナップショットのみです。
gate-cli cex rebate user-info が空なら、コミッションは発生していない	gate-cli cex rebate partner commissions にパートナーのコミッション行が存在する場合があります。user_info が空でも、S4 レポートの作成を妨げることはありません。

アフィリエイト／リベートデータ（S4）

• gate-cli cex rebate user-info は空のオブジェクトを返す場合があります。 それでも、gate-cli cex rebate partner commissions（およびパートナーサブアカウント一覧や取引履歴など、その他の S4 読み取りツール）から有用な S4 レポートを作成できます。user_info が空でも、コミッションデータがないことを意味するわけではありません。
• コミッションの流れの信頼できる情報源： gate-cli cex rebate partner commissions は、過去のコミッション行を返します。commissionAsset は通常 USDT または POINT です。行には、FUTURES、SPOT、TradFi、ALPHA など（API が返す名称）の source 次元が含まれる場合もあります。
• 生涯リベート総額を捏造しないでください： user_info に累計リベートの既成の数値が含まれていない場合、単一の「リベート総額」を捏造しないでください。履歴のみからUSDT と POINT の合計を示すには、履歴全体をページングして取得する必要があります（API の offset／limit パラメーターを使用します。例：1リクエストあたり limit 100）。それ以上行がなくなるまで繰り返し、その後、commissionAsset ごとに commissionAmount を合計します。セッション内ですべてのページの取得が完了していない場合は、そのことを明示し、合計を推測しないでください。
• 公式の合計値： セッション内で全ページを取得せずに単一の公式数値が必要な場合は、累計額の正式な確認先として、Gate のアプリまたは Web のパートナー／リベートセンターを案内してください。
• 任意のフォローアップ： ユーザーから依頼があれば、リベート分のみページングを続行し、コミッション履歴から USDT の合計と POINT の合計を報告できます。これらのリベート合計を SimpleEarn、ステーキング、その他の利回りのセクションに加算しないでください（セクションをまたいだ「総収入」の混在は禁止です）。

参考ドキュメント

• gate-runtime-rules.md — 取引ランタイムルール（精度、価格制限）。借入操作を実行する前に参照します。

注：統合アカウントの仕様（証拠金率の計算、借入ルール、モード切り替えの制約）は、この SKILL.md のドメイン知識と安全ルールのセクションに記載されています。統合アカウントの詳細なルールについては、gate-exchange-unified L1 スキルを参照してください。

安全ルール

G. 書き込み操作の確認メカニズムと安全ルール

カテゴリ：強い確認・アクションドラフト — 以下の統合アカウントへの変更操作はすべて、アクションドラフトを提示し、直前のターンでユーザーから明示的な確認を得てから実行します。確認なしで実行することはありません。

書き込み操作のリスクレベル別分類

リスクレベル	操作の種類	関連するツール	確認要件
中	統合アカウントモードの切り替え／通貨ごとのレバレッジ設定／担保の設定	gate-cli cex unified mode set、gate-cli cex unified config leverage-set、gate-cli cex unified config collateral	アクションドラフトでリスクを開示したうえで、1 回の確認が必要です。操作にモード切り替え（gate-cli cex unified mode set）が含まれる場合、ドラフトでモード変更は取り消せないこと（または同等の明確な表現）を必ず伝えてください。
高	貸付 — 借入または返済	gate-cli cex unified loan create	アクションドラフトに金額、通貨、推定または適用される金利（gate-cli cex unified query estimate-rate — 時間ごとの推定値 — または API レスポンスによる）を記載し、その後、実行前にユーザーの確認を得る必要があります。

実装上の注意

• gate-cli cex unified query estimate-rate：ユーザーに提示するとき、またはアクションドラフトに記入するときは、返される金利を時間ごとの推定値として扱ってください（ドメイン知識：統合アカウントの推定借入金利を参照）。
• **中リスクと高リスクの違い：**中リスクのツールでもアクションドラフトを使用します。異なるのは強調点です。中リスクの設定では簡潔なリスクに関する注意（モード切り替え時は取り消せないことも）を伝えます。高リスクの貸付では、確認前に金額、通貨、金利をドラフトに明記する必要があります。
• パラメーターが異なる場合は、確認ごとにツールを 1 つだけ使用してください。無関係な書き込み操作を、汎用的な「OK」1 つでまとめてはいけません。

ユーザー確認の要件

すべての書き込み操作では、実行前にユーザーの明示的な確認が必要です。確認の流れは次のとおりです。

1. **アクションドラフト：**操作の種類、対象、パラメーター、推定される影響、リスクに関する注意を提示します（中リスクと高リスクで記載する内容は上記の分類表を参照）。
2. **確認を待つ：**ユーザーが明示的な承認（Y / Confirm）を返信する必要があります。
3. **実行：**承認を得てから書き込みツールの呼び出しを送信します。
4. **1 回限り：**確認は 1 回の使用後に消費されます。パラメーターを変更する場合は、再度確認を得る必要があります。
5. **各ステップごと：**複数ステップの書き込み操作では、各ステップについて個別に確認を得る必要があります。

書き込み操作の分類（要約）

リスクレベル	操作	ツール	確認
中	統合アカウントモードの切り替え、レバレッジの設定、担保の設定	gate-cli cex unified mode set、gate-cli cex unified config leverage-set、gate-cli cex unified config collateral	アクションドラフト＋1 回の確認＋リスクに関する注意。モード切り替え：取り消せないことを明記する必要があります
高	借入／返済	gate-cli cex unified loan create	金額、通貨、金利を含むアクションドラフト → ユーザーの確認

確認なしでの実行禁止

ユーザーから明示的な確認を得ていない場合、書き込み操作は実行しません。読み取りおよび照会操作のみ許可されます。

期限切れの確認の処理

確認後にパラメーター（通貨、金額、操作の種類）が変更された場合、以前の確認は無効となり、新しいアクションドラフトを提示する必要があります。

ハードブロッキングルール

• 直前のユーザーターンで明示的な確認がない限り、ミューテーションツールを絶対に呼び出さないでください
• パラメーターを推測しないでください。金額、通貨、または方向が不明な場合は、ユーザーに尋ねてください
• データを捏造しないでください。ツール呼び出しに失敗した場合は、適切に対処し、「データは一時的に利用できません」と伝えてください
• 清算警告は参考値にすぎません。必ず「取引所の実際のルールに従います」と明記してください

エラー処理

エラーの種類	対処方法
単一の読み取りツールがタイムアウト／エラー	その項目をスキップし、「このセクションは一時的に利用できません」と伝えて、他の項目を続けます
書き込みツールの失敗	再試行せず、失敗理由を説明し、手動操作のためにアプリ／ウェブ版を案内します
必須パラメーターの不足（書き込み）	ユーザーに指定を求めます（例：「借り入れる通貨と金額をご確認ください」）
意図を認識できない	S1（資産概要）にフォールバックします
ツール呼び出しが空のデータを返す	自然な表現で「記録が見つかりません」と伝え、ツール名は表示しません

リスクに関する免責事項

• デジタル資産取引には重大なリスクが伴い、投資の一部または全部を失う可能性があります。
• レバレッジ取引（先物、証拠金取引、オプション、受渡契約）では、初期証拠金を超える損失が発生する可能性があります。わずかな市場変動でも、証拠金をすべて失うおそれがあります。
• 上記の内容は情報提供のみを目的としており、投資、金融、税務、または法律に関する助言を構成するものではありません。
• AI 支援による出力は一般的な情報提供のみを目的としており、Gate による表明、保証、または確約を構成するものではありません。
• ユーザーは自身の管轄区域の法律および規制を遵守する必要があります。Gate のサービスは、利用制限地域ではご利用いただけない場合があります。

レポートテンプレート

読み取り専用レポート

## Account and Asset Risk Report

| Dimension | Status |
|-----------|--------|
| Data Timestamp | {timestamp} |
| Activated Signals | {S1/S2/S3/S4} |

### S1 Asset Overview (if activated)
{asset_panorama_table}

### S2 Risk and Margin (if activated)
{margin_and_position_risk_table}
Note: Liquidation prices and margin ratios are reference values. Subject to the exchange's actual liquidation rules.

### S3 Earn Snapshot (if activated)
{simpleearn_and_staking_summary}

### S4 Affiliate Report (if activated)
{rebate_and_commission_summary}
Note: If `gate-cli cex rebate user-info` is empty, rely on `gate-cli cex rebate partner commissions` (and other S4 tools). Do not fabricate lifetime USDT/POINT totals unless all history pages were fetched and summed by `commissionAsset`. Point to App/Web partner center for official cumulative figures when appropriate.

書き込み操作レポート

中リスク設定（set_unified_mode、set_user_leverage_currency_setting、set_unified_collateral）：

## Action Draft (medium-risk · strong confirmation)

| Item | Value |
|------|-------|
| Operation | {set collateral / set leverage / switch unified mode} |
| Target | {currency / mode / leverage value} |
| Amount or config | {as applicable} |
| Risk warning | {e.g. impact on margin; if mode switch: **this change is irreversible**} |

Reply **Y** to confirm or **N** to cancel.

高リスクの貸借（create_unified_loan — 借り入れまたは返済）：

## Action Draft (high-risk · strong confirmation)

| Item | Value |
|------|-------|
| Operation | {borrow / repay} |
| Currency | {e.g. USDT} |
| Amount | {numeric amount} |
| Interest rate | {hourly estimated rate from `gate-cli cex unified query estimate-rate` / API; state **hourly** — not APR unless explicitly converted and labeled reference-only} |
| Risk warning | {e.g. interest accrual, repayment obligation} |

Reply **Y** to confirm or **N** to cancel.

スキル横断ワークフロー

ワークフロー A：リスクを確認してから証拠金を追加する

1. このスキルでポジションのリスク（S2）と利用可能な現物残高（S1）を評価します
2. 証拠金が不足している場合は、証拠金追加のアクションドラフト（S5）を生成します
3. 確認後、担保設定を実行します

ワークフロー B：借入可能額を確認してから借り入れる

1. このスキルで借入可能額と推定金利を照会します（S1 の照会サブセット）
2. ユーザーが借り入れの意図を確認した場合は、S5 を有効にして借入アクションドラフトを生成します
3. 確認後、借り入れを実行します。ユーザーが取引を希望する場合は、トレーディングコパイロットに引き継ぎます