gate-exchange-alpha

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

このスキルは、Gate Alpha の操作を行うための単一のエントリーポイントです。7 つのモジュールをサポートします：トークンの検出、市場の閲覧、取引（買い）、取引（売り）、アカウントと保有資産、アカウントブック、注文管理。ユーザーの意図に応じて、対応するワークフローに振り分けます。

一般ルール

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

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

スキルの依存関係

使用する gate-cli コマンド

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

• gate-cli cex alpha order get
• gate-cli cex alpha account book
• gate-cli cex alpha account balances
• gate-cli cex alpha market currencies
• gate-cli cex alpha order list
• gate-cli cex alpha market tickers
• gate-cli cex alpha market tokens
• gate-cli cex alpha order quote

実行操作（書き込み）

• gate-cli cex alpha order place

認証

• 対話形式でのファイル設定： ホスト上で 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: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 を読み、厳密に遵守してから、このスキルのモジュール振り分けを実行してください。

• SKILL.md はモジュールの振り分けと業務上の境界を定めます。
• references/gate-cli.md は、見積もり->確認->注文実行のフローと注文後の検証に関する、正式な gate-cli 実行仕様です。

モジュール概要

モジュール	説明	起動キーワード
トークンの検索	取引可能な通貨を確認し、チェーン／プラットフォーム／アドレスでトークンを絞り込み、詳細を確認します	alpha tokens, what coins, which chain, token address, token details
市場の確認	すべての Alpha トークン、または特定の Alpha トークンのティッカー、価格、24 時間の変動を確認します	alpha price, market, ticker, how much is, what price
取引（購入）	USDT で Alpha トークンを購入します。デフォルトまたはカスタムのスリッページに対応し、注文の追跡も任意で行えます	buy, 买, 购买, 入手, 帮我买
取引（売却）	Alpha トークンを全額または一部売却します。注文の追跡も任意で行えます	sell, 卖, 卖出, 清仓, 卖掉
アカウントと保有資産	Alpha アカウントの残高を確認し、ポートフォリオの時価を計算します	my holdings, my balance, portfolio value, how much do I have
アカウント履歴	期間を指定して Alpha アカウントの取引履歴を確認します	transaction history, 流水, 资产变动, account book, 变动记录
注文管理	注文状況を確認し、過去の購入／売却注文を表示し、期間を指定して注文を検索します	order status, 订单, 买单, 卖单, order history

ルーティングルール

意図	発話例	ルーティング先
トークンの検索	「Alpha ではどのコインを取引できますか？」「Solana のトークンを表示して」「このアドレスを調べて」	references/token-discovery.md を読み込みます
市場の確認	「trump の価格はいくらですか？」「Alpha 市場の状況はどうですか？」	references/market-viewing.md を読み込みます
取引（購入）	「ELON を 5u 分買って」「スリッページ 10% で trump を 100u 分買って」	references/trading-buy.md を読み込みます
取引（売却）	「ELON を全部売って」「trump を半分売って」	references/trading-sell.md を読み込みます
アカウントと保有資産	「保有しているコインは？」「Alpha ポートフォリオの価値はいくらですか？」	references/account-holdings.md を読み込みます
アカウント履歴	「最近 1 週間の資産変動履歴」「昨日の資産変動を確認して」	references/account-book.md を読み込みます
注文管理	「さっきの買い注文は成功しましたか？」「ELON を買った注文を確認して」	references/order-management.md を読み込みます
不明確	「Alpha について教えて」「Alpha について手伝って」	確認：必要なモジュールをユーザーに尋ねます

gate-cli コマンド一覧

#	ツール	認証	用途
1	gate-cli cex alpha market currencies	不要	取引可能な Alpha 通貨をすべて、チェーン、アドレス、精度、ステータスとともに一覧表示します
2	gate-cli cex alpha market tokens	不要	チェーン、ローンチプラットフォーム、またはコントラクトアドレスでトークンを絞り込みます
3	gate-cli cex alpha market tickers	不要	Alpha トークンの最新価格、24 時間の変動、取引量、時価総額を取得します
4	gate-cli cex alpha account balances	必要	Alpha アカウントの残高（通貨ごとの利用可能額とロック額）を照会します
5	gate-cli cex alpha order quote	必要	購入／売却注文の価格見積もりを取得します（quote_id を返し、有効期間は 1 分です）
6	gate-cli cex alpha order place	必要	quote_id を使用して購入／売却注文を発注します
7	gate-cli cex alpha order get	必要	order_id を指定して単一の注文の詳細を取得します
8	gate-cli cex alpha order list	必要	条件（通貨、売買区分、ステータス、期間）を指定して注文を一覧表示します
9	gate-cli cex alpha account book	必要	期間を指定してアカウントの取引履歴を照会します

ドメイン知識

Alpha プラットフォームの概要

• Gate Alpha は、複数のブロックチェーン上のトークンに対応する、初期段階のトークン取引プラットフォームです。
• トークンは標準的なティッカーシンボルではなく、currency シンボル（例：memeboxtrump）で識別されます。
• 取引ステータスの値：1 = 取引中、2 = 停止中、3 = 上場廃止。

対応チェーン

solana, eth, bsc, base, world, sui, arbitrum, avalanche, polygon, linea, optimism, zksync, gatelayer

注：エンドポイントによってチェーン名の大文字・小文字が異なる場合があります（例：SOLANA と solana）。比較時は小文字に統一してください。

対応ローンチプラットフォーム

meteora_dbc, fourmeme, moonshot, pump, raydium_launchlab, letsbonk, gatefun, virtuals

取引の仕組み

• 購入数量：USDT の数量です（例：amount="5" は 5 USDT を使用することを意味します）。
• 売却数量：トークンの数量です（例：amount="1000" は 1000 トークンを売却することを意味します）。
• 見積もりの有効期限：gate-cli cex alpha order quote の quote_id は 1 分後に期限切れになります。期限切れの場合は、見積もりを取り直してください。
• ガスモード："speed"（デフォルト）または "custom"（スリッページを指定）を入力します。API は gasMode を "1"（速度優先）または "2"（カスタム）として返します。
• 注文ステータス：1 = 処理中、2 = 成功、3 = 失敗、4 = キャンセル済み、5 = 送金中、6 = 送金キャンセル中。終了ステータス：2、3、4。

API フィールドの命名規則

すべての API エンドポイントでは snake_case の命名規則が使われます。エンドポイントごとの主なフィールド：

• /alpha/currencies：currency、name、chain、address、amount_precision、precision、status
• /alpha/tickers：currency、last、change、volume、market_cap
• /alpha/accounts：currency、available、locked、token_address、chain
• /alpha/account_book：id、time、currency、change、balance
• /alpha/orders (GET)：order_id、tx_hash、side、usdt_amount、currency、currency_amount、status、gas_mode、chain、gas_fee、transaction_fee、create_time、failed_reason
• クエリ結果が空の場合、[] ではなく [{}, {}]（空のオブジェクトを含む配列）が返されることがあります。処理する前に、有効なフィールドがあるか確認してください。

主な制約

• すべての市場データエンドポイント（currencies、tickers、tokens）は公開されており、認証は不要です。
• アカウント、取引、注文のエンドポイントでは、API Key 認証が必要です。
• ページネーション：大量の結果を取得する場合は、page と limit パラメーターを使用してください。
• レート制限：見積もり 10r/s、注文発行 5r/s、その他のエンドポイント 200r/10s。

実行

1. 意図の分類

ユーザーのリクエストを次の 7 つのモジュールのいずれかに分類します：トークンの検索、市場の閲覧、取引（購入）、取引（売却）、アカウントと保有資産、アカウント履歴、注文管理。

2. 参照先の選択と読み込み

対応するリファレンスドキュメントを読み込み、そのワークフローに従います。

3. 結果の返却

各サブモジュールで定義されているレポートテンプレートを使って、結果を返します。

エラー処理

エラーの種類	主な原因	対処方法
通貨が見つからない	通貨シンボルが無効、または誤記されている	gate-cli cex alpha market currencies または gate-cli cex alpha market tokens で検索するよう案内します
トークンの取引停止	取引ステータスが 2（取引停止）	トークンは現在取引停止中であることをユーザーに伝えます
トークンの上場廃止	取引ステータスが 3（上場廃止）	トークンが上場廃止になったことをユーザーに伝えます
結果が空	フィルター条件に一致するトークンがない	フィルターパラメーター（チェーン、プラットフォーム、アドレス）を確認し、代替案を提案します
認証が必要	認証情報なしで認証が必要なエンドポイントを呼び出している	API Key 認証が必要であることを伝え、設定方法を案内します
ページネーションの範囲超過	利用可能なデータを超えるページがリクエストされた	最後に取得可能なページを返し、合計件数を伝えます
見積もりの期限切れ	1 分の有効期間を過ぎてから quote_id が使用された	gate-cli cex alpha order quote を再度呼び出し、新しい quote_id を取得します
残高不足	売却数量が利用可能残高を超えている	実際の利用可能残高を伝え、数量の調整を提案します
注文失敗	オンチェーントランザクションが失敗した	注文詳細の failed_reason を報告し、再試行を提案します
注文タイムアウト	終了ステータスにならないままポーリングが 60 秒を超えた	注文はまだ処理中であることを伝え、手動で確認できるよう order_id を提示します
レート制限超過	短時間にリクエストが多すぎる	少し待ってから再試行し、問題が続く場合はユーザーに伝えます

安全上のルール

• 注文の確認：見積もりの詳細を表示し、ユーザーから明示的な確認を受けるまでは、買い注文または売り注文を絶対に出してはいけません。
• トークンの検証：取引を開始する前に、必ず status=1 であることを確認してください。取引停止中または上場廃止の場合は中止してください。
• 残高の確認：売却前に、必ず available >= sell_amount であることを確認してください。残高が不足している場合は、実際の残高を報告してください。
• 見積もりの有効性：quote_id の有効性（1 分間）を必ず確認してください。ユーザーの確認が遅れた場合は、見積もりを取り直してください。
• トークンデータを捏造してはいけません。クエリの結果が空の場合は、正直に報告してください。
• トークンアドレスを表示する場合は、名前の似たトークンとの混同を避けるため、アドレス全体を表示してください。
• トークンが取引可能であると提案する前に、必ず取引状況を確認してください。