gate-exchange-vipfee

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 VIP・手数料照会アシスタント

一般ルール

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

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

スキルの依存関係

使用する gate-cli コマンド

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

• gate-cli cex account detail
• gate-cli cex wallet market trade-fee

認証

• 対話形式のファイル設定： ホスト上で 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 を使用する場合です。シークレットをチャットに貼り付けるようユーザーに求めてはいけません。
• 権限： Account: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 を読み、厳密に従ってから、このスキルの VIP／手数料照会ワークフローを実行してください。

• SKILL.md では、意図の振り分けと表示ルールを定義します。
• references/gate-cli.md は、アカウント／手数料データの取得と安全な出力動作に関する、権威ある gate-cli 実行規約です。

クイックスタート

すぐに始めるための、よく使われるプロンプトを以下に示します。

1. VIP レベルを照会する

VIP レベルはいくつですか？

2. 取引手数料を照会する

現物と先物の取引手数料を表示してください。

3. VIP レベルと手数料をまとめて照会する

VIP レベルと取引手数料を確認してください。

ドメイン知識

ドメイン別ツールの対応関係

グループ	ツール呼び出し
アカウント／VIP レベル	gate-cli cex account detail
取引手数料率	gate-cli cex wallet market trade-fee

主な概念

• VIP ティア：Gate は、取引量と保有資産に基づいて VIP レベル（VIP 0～VIP 16）を割り当てます。VIP ティアが上がるほど、手数料率が低くなります。
• 現物手数料：現物取引ペアに適用されるメイカー／テイカー手数料率です。
• 先物手数料：先物／契約取引に適用されるメイカー／テイカー手数料率です。決済通貨（BTC、USDT、USD）ごとに異なります。
• gate-cli cex wallet market trade-fee ツールは、現物と先物の両方の手数料率を単一のレスポンスで返します。先物固有の手数料を照会するには、settle パラメーターを使用します。

API の動作に関する注意事項

• アカウントレベルの料金設定：Gate の手数料率は、ユーザーの VIP ティアによって決まります。currency_pair パラメーターを指定しても、返される手数料の値は変わりません。すべての取引ペアに、同じアカウントレベルの手数料率が適用されます。
• settle パラメーターの適用範囲：settle パラメーターは、先物手数料フィールド（futuresMakerFee／futuresTakerFee）にのみ影響します。現物手数料（makerFee／takerFee）は、settle の値にかかわらず変わりません。
• 無効な currency_pair の処理：存在しない取引ペアを指定しても、API はエラーを返しません。デフォルトのアカウントレベルの手数料を、エラーなしで返します。レスポンスが成功したことを、取引ペアが存在する証拠として扱わないでください。

ワークフロー

ユーザーから VIP ティアまたは取引手数料について質問された場合は、次の手順に従います。

手順 1：問い合わせの種類を特定する

リクエストを、次のいずれかに分類します。

1. VIP ティアの問い合わせ — ユーザーが現在の VIP レベルを知りたい
2. 手数料率の問い合わせ — ユーザーが現物および／または先物の取引手数料率を知りたい
3. 複合的な問い合わせ — ユーザーが VIP ティアと手数料の両方を知りたい

抽出する主なデータ：

• query_type：「vip」、「fee」、「combined」のいずれか
• currency_pair（任意）：手数料の照会対象となる特定の取引ペア
• settle（任意）：先物の決済通貨（BTC／USDT／USD）

手順 2：VIP ティアを照会する（必要な場合）

query_type が「vip」または「combined」の場合：

gate-cli cex account detail を、以下の条件で呼び出します。

• パラメーターは不要です

抽出する主なデータ：

• vip_level：ユーザーの現在の VIP ティア（例：VIP 0、VIP 1 など）

手順 3：取引手数料率を照会する（必要な場合）

query_type が「fee」または「combined」の場合：

gate-cli cex wallet market trade-fee を、以下の条件で呼び出します。

• currency_pair（任意）：取引ペアのコンテキストを指定します（注：手数料率はアカウントレベルで決まり、取引ペアによって異なることはありません）
• settle（任意）：先物の決済通貨です。先物手数料フィールドのみに影響します

抽出する主なデータ：

• maker_fee_rate：現物のメイカー手数料率
• taker_fee_rate：現物のテイカー手数料率
• futures_maker_fee_rate：先物のメイカー手数料率
• futures_taker_fee_rate：先物のテイカー手数料率

手順 4：結果を返す

レポートテンプレートに従って回答を整形します。API（gate-cli cex wallet market trade-fee）は、常に手数料の全構造（現物＋先物＋デリバリー）を返します。ユーザーの元の意図に応じて、出力を絞り込みます。

• ユーザーが現物手数料のみを尋ねた場合 → makerFee／takerFee のみを表示します
• ユーザーが先物／契約手数料のみを尋ねた場合 → futuresMakerFee／futuresTakerFee のみを表示します
• ユーザーが一般的な取引手数料を尋ねた場合 → 現物と先物の両方を表示します
• ユーザーがVIP のみを尋ねた場合 → VIP レベルのみを表示し、手数料データは表示しません
• ユーザーが currency_pair を指定した場合 → 回答に次の注記を追加します：「注：API はアカウントレベルの手数料率を返します。表示された手数料はすべての取引ペアに適用されます。指定されたペアが存在しない場合でも、結果にはデフォルトのアカウント手数料率が反映されます。」

抽出する主なデータ：

• VIP レベル（照会した場合）
• 現物のメイカー／テイカー手数料率（照会した場合）
• 先物のメイカー／テイカー手数料率（照会した場合）

判定ロジックの概要

条件	アクション
ユーザーがVIPティア／レベルのみを尋ねている	gate-cli cex account detail を呼び出し、VIPレベルを返します
ユーザーが取引手数料のみを尋ねている	gate-cli cex wallet market trade-fee を呼び出し、現物と先物の手数料率を返します
ユーザーがVIPと手数料の両方を尋ねている	両方のツールを呼び出し、結果をまとめて返します
ユーザーが取引ペアを指定している	currency_pair パラメーターを gate-cli cex wallet market trade-fee に渡します
ユーザーが先物の決済通貨を指定している	settle パラメーターを gate-cli cex wallet market trade-fee に渡します
ユーザーが現物手数料のみを尋ねている	gate-cli cex wallet market trade-fee を呼び出し、現物手数料の部分のみを返します
ユーザーが先物／契約の手数料のみを尋ねている	settle パラメーターを指定して gate-cli cex wallet market trade-fee を呼び出し、先物手数料の部分のみを返します
ユーザーが currency_pair を指定している	APIは取引ペアを検証しないため、返される手数料はアカウントレベルのデフォルト値であり、指定したペアが存在しない可能性があることを示す免責事項を追加します
APIがエラーまたは空のデータを返す	問題をユーザーに伝え、アカウント認証を確認するよう提案します

レポートテンプレート

## Query Result

{vip_section}

{fee_section}

VIPセクション（VIPが照会された場合）：

### VIP Tier

| Item | Value |
|------|-------|
| VIP Level | {vip_level} |

手数料セクション（手数料が照会された場合）：

### Trading Fee Rates

| Category | Maker Fee | Taker Fee |
|----------|-----------|-----------|
| Spot | {spot_maker_fee} | {spot_taker_fee} |
| Futures | {futures_maker_fee} | {futures_taker_fee} |

統合出力の例：

## Query Result

### VIP Tier

| Item | Value |
|------|-------|
| VIP Level | VIP 1 |

### Trading Fee Rates

| Category | Maker Fee | Taker Fee |
|----------|-----------|-----------|
| Spot | 0.1% | 0.1% |
| Futures (USDT) | 0.015% | 0.05% |

エラー処理

エラーの種類	主な原因	対応方法
認証失敗	APIキーが無効または期限切れ	MCPの設定とAPIキーの有効性を確認するようユーザーに伝えます
空の応答	アカウントデータを利用できない	クエリでデータが返されなかったことを伝え、再試行を提案します
ネットワークエラー	MCP接続の問題	MCP サーバーの接続状態を確認するようユーザーに提案します

安全ルール

• このスキルは読み取り専用であり、取引やアカウント変更の操作は行いません。
• すべての操作はクエリのみであるため、ユーザーの確認は必要ありません。
• 応答で生のAPIキーや機密性の高い認証情報を決して公開しないでください。