mcpField
G
gate-exchange-crossex

gate-exchange-crossex

github.com/gateその他48143 回インストール18 週間前に更新
リポジトリ

gate-exchange-crossex について

取引、口座、送金、注文、ポジション、履歴の依頼を対応するワークフローに振り分ける Gate CrossEx スキルです。gate-cli の CrossEx ツールセットで現物、証拠金、先物取引を扱います。

主な機能

  1. 01CrossEx モジュールへの依頼振り分け
  2. 02現物・証拠金・先物取引
  3. 03注文の管理と照会
  4. 04ポジションと取引履歴の照会
  5. 05資金移動と資産交換

活用シーン

  1. 01CrossEx 注文の作成や管理
  2. 02口座のポジションと履歴の確認
  3. 03取引所間の資金移動
  4. 04交換見積もりの取得や資産交換

MCP 対応

gate-cli コマンドを通じて CrossEx MCP ツールセットを使い、口座・市場照会、送金、交換、注文、ポジション、履歴を扱います。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/gate/gate-skills --skill gate-exchange-crossex

インストール後、Claude Code で/gate-exchange-crossexを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CHANGELOG.md
README.md
setup.sh
references/
convert-trading.md
futures-trading.md
gate-cli.md
history-query.md
margin-trading.md
mcp.md
order-management.md
position-query.md
runtime-rules.md
scenarios.md
spot-trading.md
transfer.md

詳細

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 CrossEx Trading Suite

このスキルは、Gate CrossEx のクロス取引所取引における統合エントリーポイントです。注文管理、ポジション照会、履歴照会など、多くの主要な操作に対応しています。ユーザーの意図は、対応するワークフローに振り分けられます。

一般ルール

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

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

スキルの依存関係

使用する gate-cli コマンド

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

  • gate-cli cex cross-ex account get
  • gate-cli cex cross-ex market fee
  • gate-cli cex cross-ex market interest-rate
  • gate-cli cex cross-ex position margin-leverage
  • gate-cli cex cross-ex order get
  • gate-cli cex cross-ex position leverage
  • gate-cli cex cross-ex account book
  • gate-cli cex cross-ex position adl-rank
  • gate-cli cex cross-ex market discount-rate
  • gate-cli cex cross-ex position margin-interests
  • gate-cli cex cross-ex position margin-history
  • gate-cli cex cross-ex order history
  • gate-cli cex cross-ex position history
  • gate-cli cex cross-ex order trades
  • gate-cli cex cross-ex position margin-list
  • gate-cli cex cross-ex order list
  • gate-cli cex cross-ex position list
  • gate-cli cex cross-ex market risk-limits
  • gate-cli cex cross-ex market symbols
  • gate-cli cex cross-ex market transfer-coins
  • gate-cli cex cross-ex transfer list

実行操作（書き込み）

  • gate-cli cex cross-ex order cancel
  • gate-cli cex cross-ex position close
  • gate-cli cex cross-ex convert create
  • gate-cli cex cross-ex convert quote
  • gate-cli cex cross-ex order create
  • gate-cli cex cross-ex transfer create
  • gate-cli cex cross-ex account update
  • gate-cli cex cross-ex position set-margin-leverage
  • gate-cli cex cross-ex order update
  • gate-cli cex cross-ex position set-leverage
認証
  • 対話型のファイル設定： ホスト上で 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 は不要です。ユーザーにチャットでシークレットを貼り付けるよう求めないでください。
  • 権限： Crx: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（または 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 を読み、厳密に従ってから、このスキルの CrossEx ワークフローを実行してください。

  • SKILL.md はルートの振り分けと機能の境界を定めています。
  • references/gate-cli.md は、クエリ／変更の実行順序、確認ゲート、リスクを考慮した更新に関する、gate-cli の正式な実行仕様です。

モジュール概要

モジュール説明トリガーキーワード
Spot指値／成行の買い・売り、取引所間アービトラージspot buy、spot sell、buy spot、sell spot
Marginロング／ショート取引、証拠金管理、自動借入margin long、margin short、long margin、short margin
FuturesUSDT 無期限契約、両方向ポジション、レバレッジ調整futures long、futures short、open long、open short
Transfer取引所間の資金移動fund transfer、cross-exchange transfer、transfer、move funds
Convertフラッシュ交換と交換レート見積もりのワークフローconvert trading、flash convert、convert、quote convert
Orders注文の照会、キャンセル、変更、注文履歴query orders、cancel order、amend order、order history、list orders
Positionsすべてのポジション種別と履歴レコードの照会query positions、check positions、position history、positions
History注文／ポジション／取引／利息履歴の照会history query、trade history、interest history、history

ルーティングルール

インテントフレーズの例参照先
現物取引「BTCを100 USDT分購入」、「BTCを0.5 BTC売却」、「ETHを現物で成行買い」references/spot-trading.mdを参照
マージン取引「XRPをマージンで50 USDT分ロング」、「BTCをマージンでショート」、「レバレッジ10倍でロング」references/margin-trading.mdを参照
先物取引「BTC先物のロングポジションを1 BTC分建てる」、「ETHを成行ショート」、「レバレッジを20倍に調整」references/futures-trading.mdを参照
取引所間送金「GateからBinanceへ100 USDTを送金」、「OKXからGateへETHを移動」references/transfer.mdを参照
コンバート取引「10 USDTをBTCにフラッシュコンバート」、「Gateで50 USDTをETHにコンバート」references/convert-trading.mdを参照
注文管理「すべての未約定注文を照会」、「その買い注文をキャンセル」、「注文価格を変更」、「注文履歴を照会」references/order-management.mdを参照
ポジション照会「自分のすべてのポジションを照会」、「先物ポジションを表示」、「ポジション履歴」references/position-query.mdを参照
履歴照会「取引履歴を照会」、「ポジション履歴」、「マージン金利の履歴」、「口座台帳」references/history-query.mdを参照
不明確「口座を表示」 , 「手伝って」 , 「口座を確認してください」確認：口座を照会してから、ユーザーを案内します

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

このスキルでは、コアツールファミリーとしてcex_crxプレフィックスを持つCrossEx MCP ツールセットのみを使用します。

スコープルール：このスキルに明示的に記載されている操作のみを実行してください。以下の表またはreferences/*.mdに記載されているツールのみを呼び出してください。 ここに記載されていないツールや操作は呼び出してはいけません。

ツールの命名規則
  • cex_crxファミリーのList操作は、シンボル、注文、ポジション、送金、または履歴を照会します
  • cex_crxファミリーのGet操作は、単一の口座設定、手数料、レート、または注文の詳細を照会します
  • cex_crxファミリーのCreate操作は、注文、送金、コンバート見積もり、またはコンバート注文を作成します
  • cex_crxファミリーのUpdate操作は、口座設定、レバレッジ、または既存の注文を更新します
  • cex_crxファミリーのCancel操作は、既存の注文をキャンセルします
  • cex_crxファミリーのClose操作は、既存のポジションを決済します
シンボルとルールのツール
ツール用途
gate-cli cex cross-ex market symbols対応しているCrossEx取引シンボルを一覧表示
gate-cli cex cross-ex market risk-limitsシンボルのリスク制限ルールを照会
gate-cli cex cross-ex market transfer-coinsCrossEx送金に対応している資産を一覧表示
gate-cli cex cross-ex market feeCrossEx取引手数料情報を照会
gate-cli cex cross-ex market interest-rateCrossEx金利を照会
gate-cli cex cross-ex market discount-rate担保割引率を照会
口座ツール
ツール用途
gate-cli cex cross-ex account getCrossEx口座の概要と残高を照会
gate-cli cex cross-ex account updateCrossEx口座設定を更新
gate-cli cex cross-ex account bookCrossEx口座台帳の記録を照会
送金とコンバートのツール
ツール用途
gate-cli cex cross-ex transfer list送金履歴を照会
gate-cli cex cross-ex transfer create取引所間送金を作成
gate-cli cex cross-ex convert quoteフラッシュコンバートの見積もりを取得
gate-cli cex cross-ex convert createフラッシュコンバート注文を実行
注文ツール
ツール用途
gate-cli cex cross-ex order list現在の未約定注文を照会
gate-cli cex cross-ex order createCrossEx 注文を作成
gate-cli cex cross-ex order get注文の詳細を照会
gate-cli cex cross-ex order update既存の注文を変更
gate-cli cex cross-ex order cancel単一の注文をキャンセル
gate-cli cex cross-ex order history注文履歴を照会
gate-cli cex cross-ex order trades取引履歴を照会
ポジションとレバレッジのツール
ツール用途
gate-cli cex cross-ex position list現在の先物ポジションを照会
gate-cli cex cross-ex position margin-list現在の証拠金ポジションを照会
gate-cli cex cross-ex position close既存の CrossEx ポジションを決済
gate-cli cex cross-ex position leverage先物のレバレッジ設定を照会
gate-cli cex cross-ex position set-leverage先物のレバレッジを更新
gate-cli cex cross-ex position margin-leverage証拠金のレバレッジ設定を照会
gate-cli cex cross-ex position set-margin-leverage証拠金のレバレッジを更新
gate-cli cex cross-ex position history先物のポジション履歴を照会
gate-cli cex cross-ex position margin-history証拠金ポジションの履歴を照会
gate-cli cex cross-ex position margin-interests証拠金の金利履歴を照会
gate-cli cex cross-ex position adl-rankADL ランク情報を照会
使用方法
  • このスキルでは、デフォルトかつ唯一の中核 MCP ファミリーとして cex_crx MCP ファミリーを使用します。
  • 銘柄ルール、手数料、残高、レバレッジ、対応資産の照会には、list/get ツールを使用します。
  • ユーザーが記録、監査証跡、ステータス確認を求めている場合は、履歴および口座台帳ツールを優先します。

実行

1. 意図とパラメーターの特定
  • モジュール（注文／ポジション／履歴）を特定します
  • 主なパラメーターを抽出します：
  • 取引ペア：GATE_SPOT_BTC_USDT、GATE_MARGIN_XRP_USDT、GATE_FUTURE_ETH_USDT
  • 取引所：GATE、BINANCE、OKX、BYBIT
  • 方向：BUY（買い／ロング）、SELL（売り／ショート）
  • 数量：USDT 額、コイン数量、コントラクトサイズ
  • 価格：指値、成行
  • レバレッジ：レバレッジ倍率（証拠金／先物のみ）
  • ポジションサイド：LONG（ロング）、SHORT（ショート、証拠金／先物のみ）
  • 不足しているパラメーター：必須パラメーターが不足している場合は、ユーザーに確認します
2. 事前確認
  • 取引ペア：gate-cli cex cross-ex market symbols を呼び出して確認します
  • 口座残高：gate-cli cex cross-ex account get を呼び出して、利用可能な証拠金が十分か確認します
  • ポジションの確認：
  • 証拠金取引：方向の競合を避けるため、既存のポジションを確認します
  • 先物取引：両方向ポジションモードを確認します
  • 最小注文額：min_quote_amount（通常は 3 USDT）を照会します
  • 取引所のステータス：対象の取引所が正常に稼働していることを確認します
3. モジュールのロジック
モジュール A：現物取引
  1. パラメーターの確認：
  • 取引ペアの形式：GATE_SPOT_{BASE}_{QUOTE}
  • 買いのパラメーター：quote_qty（USDT 額）
  • 売りのパラメーター：qty（コイン数量）
  1. 最小注文額の確認：gate-cli cex cross-ex market symbols を呼び出して最小注文額を照会します
  2. 注文前の確認：注文の概要（ペア、方向、数量、価格）を表示し、ユーザーの確認を求めます
  3. 注文の発注：gate-cli cex cross-ex order create を呼び出します
  4. 確認：gate-cli cex cross-ex order get を呼び出して注文ステータスを確認します
モジュール B：証拠金取引
  1. パラメーターの確認：
  • 取引ペアの形式：GATE_MARGIN_{BASE}_{QUOTE}
  • 必須パラメーター：qty（コイン数量）、position_side（LONG または SHORT）
  • オプションのパラメーター：quote_qty（USDT 金額）
  1. レバレッジの確認：現在のレバレッジを照会し、ユーザーが指定している場合は調整します
  2. ポジションの方向：
  • ロング（LONG）：コインを購入し、USDT を借ります
  • ショート（SHORT）：コインを売却し、コインを借ります
  1. 最小数量の確認：gate-cli cex cross-ex market symbols を呼び出して最小数量を照会します
  2. 注文前の確認：注文の概要（ペア、方向、数量、レバレッジ）を表示し、確認を求めます
  3. 注文の発注：position_side パラメーターを指定して gate-cli cex cross-ex order create を呼び出します
  4. 検証：symbol フィルターを指定して gate-cli cex cross-ex position margin-list を呼び出し、ポジションを確認します
モジュール C：先物取引
  1. パラメーターの確認：
  • 取引ペアの形式：GATE_FUTURE_{BASE}_{QUOTE}
  • 必須パラメーター：qty（契約サイズ）、position_side（LONG または SHORT）
  1. レバレッジの調整：ユーザーがレバレッジを指定している場合は、gate-cli cex cross-ex position leverage と gate-cli cex cross-ex position set-leverage を呼び出します
  2. 契約サイズの計算（金額指定で注文する場合）：
  • quanto_multiplier と現在の価格を取得します
  • 支出超過を防ぐため、切り捨てます
  1. 最小サイズの確認：gate-cli cex cross-ex market symbols を呼び出して最小サイズを照会します
  2. 注文前の確認：注文の概要（ペア、方向、サイズ、レバレッジ）を表示し、確認を求めます
  3. 注文の発注：position_side パラメーターを指定して gate-cli cex cross-ex order create を呼び出します
  4. 検証：symbol フィルターを指定して gate-cli cex cross-ex position list を呼び出し、ポジションを確認します
モジュール D：取引所間送金
  1. 送金タイプ：
  • 取引所間送金：gate-cli cex cross-ex transfer create（取引所 A → 取引所 B）
  1. パラメーターの確認：
  • 取引所間送金：from、to、coin、amount
  • 送金元／送金先アカウントのルール： | コイン | モード | 使用可能な from／to | デフォルト | |------|------|--------------------|---------| | USDT | 取引所間 | SPOT ↔ CROSSEX | CROSSEX_{exchange_type} → CROSSEX | | USDT | サブ取引所 | SPOT ↔ CROSSEX_{exchange_type} または CROSSEX_{exchange_type} ↔ CROSSEX_{exchange_type} | CROSSEX → CROSSEX_GATE | | USDT 以外 | 任意 | CROSSEX_{exchange_type} を使用する必要があります（CROSSEX 単独での使用は禁止）。取引所間送金も可能です（例：CROSSEX_BINANCE ↔ CROSSEX_GATE）。 | — |
  1. 対応コインの確認：gate-cli cex cross-ex market transfer-coins を呼び出して確認します
  2. 残高の確認：送金元アカウントに十分な残高があることを確認します
  3. 送金前の確認：送金の概要（送金元、送金先、コイン、数量）を表示し、確認を求めます
  4. 送金の実行：gate-cli cex cross-ex transfer create を呼び出します
  5. 検証：gate-cli cex cross-ex transfer list を呼び出して送金履歴を照会し、確認します
モジュール E：コンバート取引
  1. コンバートの種類：
  • フラッシュコンバートの見積もり：gate-cli cex cross-ex convert quote
  • フラッシュコンバートの実行：gate-cli cex cross-ex convert create
  1. パラメーターの確認：
  • フラッシュコンバート：from_coin、to_coin、from_amount、exchange_type
  1. 残高の確認：コンバートするペアについて、送金元アカウントに十分な残高があることを確認します
  2. コンバート前の確認：送金元資産、送金先資産、レート、受取予定額を表示してから、確認を求めます
  3. 見積もり：gate-cli cex cross-ex convert quote を呼び出します
  4. コンバートの実行：返された quote_id を指定して gate-cli cex cross-ex convert create を呼び出します
  5. 検証：gate-cli cex cross-ex account get を呼び出し、処理後の残高を確認します
モジュール F：注文管理
  1. 注文の照会：
  • 現在の未約定注文：gate-cli cex cross-ex order list を呼び出します
  • 注文の詳細：gate-cli cex cross-ex order get を呼び出します
  • 注文履歴：gate-cli cex cross-ex order history を呼び出します（パラメーター：limit、page、from、to）
  1. 注文のキャンセル：
  • 単一注文のキャンセル：gate-cli cex cross-ex order cancel を呼び出します
  1. 注文の変更：
  • 注文ステータスが open であることを確認します
  • gate-cli cex cross-ex order update を呼び出して、価格または数量を変更します
  1. 結果の表示：注文情報を表形式で表示します
モジュール G：ポジション照会
  1. 照会の種類：
  • 先物ポジション：gate-cli cex cross-ex position list を呼び出します
  • 証拠金ポジション：gate-cli cex cross-ex position margin-list を呼び出します
  • 先物レバレッジ：gate-cli cex cross-ex position leverage を呼び出します
  • 証拠金レバレッジ：gate-cli cex cross-ex position margin-leverage を呼び出します
  1. 履歴の照会：
  • ポジション履歴：gate-cli cex cross-ex position history を呼び出します（パラメーター：limit、page、from、to）
  • 証拠金ポジション履歴：gate-cli cex cross-ex position margin-history を呼び出します
  • 取引履歴：gate-cli cex cross-ex order trades を呼び出します（パラメーター：limit、page、from、to）
  1. 表示形式：
  • 現在のポジション：表形式（ペア、方向、数量、エントリー価格、未実現損益）
  • 履歴レコード：新しい順に並べ、直近の N 件を表示します
モジュール H：履歴の照会
  1. 注文履歴：
  • gate-cli cex cross-ex order history を呼び出します
  • パラメーター：limit（最大 100）、page、from（開始タイムスタンプ）、to（終了タイムスタンプ）
  1. 取引履歴：
  • gate-cli cex cross-ex order trades を呼び出します
  • 上記と同じパラメーターです
  1. ポジション履歴：
  • gate-cli cex cross-ex position history を呼び出します
  • 上記と同じパラメーターです
  1. 証拠金ポジション履歴：
  • gate-cli cex cross-ex position margin-history を呼び出します
  • 上記と同じパラメーターです
  1. 証拠金利息履歴：
  • gate-cli cex cross-ex position margin-interests を呼び出します
  • 上記と同じパラメーターです

レポートテンプレート

各操作の後に、簡潔で標準化された結果を出力します。

安全ルール

  • 認証情報：API Secret Key をチャットに貼り付けるようユーザーに求めたり促したりしないでください。安全なローカルの MCP 設定を優先してください。
  • ユーザー間送金：このスキルは P2P またはユーザー間送金には対応していません。ユーザー自身のアカウント間（例：SPOT ↔ CROSSEX）の送金のみ許可されます。
  • 取引注文：注文を出す前に、注文の概要（ペア、方向、数量、価格、レバレッジ）をすべて表示し、ユーザーの確認を求めてください
  • 取引所間送金：送金の詳細（送金元、送金先、数量、到着時刻）を表示し、確認を求めてください
  • 範囲のルール：このスキルに記載されたツールのみを呼び出してください。ユーザーがここに記載されていない操作を求めた場合は、このスキルでは対応していないと伝えてください。
  • 一括操作：操作の範囲と影響を表示し、明示的な確認を求めてください

例：「上記の操作を実行するには、「confirm」と返信してください。」

エラー処理

エラーコード処理方法
USER_NOT_EXISTGATE CrossEx アカウントが開設されているか確認してください。手順については、GATE ヘルプセンター -> CrossEx 取引 -> CrossEx アカウント操作ガイドを参照してください。
TRADE_INVALID_QUOTE_ORDER_QTY⚠️ パラメーター名が正しくありません。成行買いでは quote_qty を使用する必要があります
TRADE_INVALID_ORDER_QTY⚠️ 指値注文エラー：指値注文では qty（コイン数量）と price を使用する必要があります
TRADE_ORDER_AMOUNT_MIN_ERROR注文金額が最小注文金額（通常は 3 USDT）を下回っています。数量または金額を増やしてください
CONVERT_TRADE_QUOTE_EXCHANGE_INVALID_ERROR⚠️ フラッシュコンバート：exchange_type パラメーターには大文字の取引所コード（例：GATE）を指定する必要があります
TRADE_MARGIN_INVALID_PZ_SIDE_ERRORマージン取引／先物取引では position_side（LONG/SHORT）の指定が必要であることを通知します
BALANCE_NOT_ENOUGH利用可能な証拠金が不足しています。取引金額を減らすか、入金するよう提案してください
SYMBOL_NOT_FOUND取引ペアの形式が正しいか確認してください（例：GATE_SPOT_BTC_USDT）
INVALID_PARAM_VALUEパラメーターの形式を確認してください（qty は数値文字列、position_side は LONG/SHORT）
POSITION_NOT_EMPTY反対方向に切り替える前にポジションを決済するよう通知します
TRADE_ORDER_LOT_SIZE_ERROR取引ペアの最小単位に合わせて数量を調整するよう提案してください
RATE_LIMIT_EXCEEDEDレート制限についてユーザーに通知します。後でもう一度試すか、リクエスト頻度を下げるよう提案してください
TRADE_INVALID_EXCHANGE_TYPE取引所タイプが無効です。exchange_type パラメーターを確認してください（例：GATE、BINANCE、OKX、BYBIT）

コメント

Markdown 対応