gate-exchange-coupon

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 クーポンアシスタント

Gate Exchange のクーポン／バウチャーアカウントを照会し、確認します。利用可能なクーポンの一覧表示、クーポンの種類による検索、期限切れ／使用済みの履歴の表示、クーポン詳細の確認、使用ルールの確認、クーポンの取得元の追跡という6つのシナリオに対応しています。

一般ルール

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

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

スキルの依存関係

使用する gate-cli コマンド

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

• gate-cli cex coupon detail
• gate-cli cex coupon list

認証

• 対話形式でのファイル設定： ホスト上で 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 キーが必要です：はい
• 権限： Coupon: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 cex coupon list	ユーザーのクーポン一覧を取得します（ページネーション対応、種類／ステータスで絞り込み可能）
gate-cli cex coupon detail	1件のクーポンの詳細をすべて取得します

クーポンタイプのリファレンス

重要 — タイプの翻訳ルール：クーポンタイプを表示する際は、coupon_type を必ず表示名に対応させてください。表示名は回答言語に合わせて翻訳できますが、対応関係は厳密に守ってください。異なるタイプを入れ替えたり、混同したりしてはいけません。重要な違い：position_voucher（ポジショントライアルバウチャー）はポジションベースのトライアルバウチャーです。「仓位体验券」と訳し、「合约体验金」と訳してはいけません。一方、contract_bonus（先物ボーナス）は先物取引のトライアル資金で、「合约体验金」と訳します。これらはまったく異なる商品です。

coupon_type	表示名	説明
position_voucher	ポジショントライアルバウチャー	先物ポジションを建てるための仮想資金です（先物ボーナスとは異なります）。利益は出金できます。有効期限後に元本が回収されます。
tradfi_position_voucher	TradFiポジションバウチャー	ポジションバウチャーと同じ仕組みですが、TradFi商品（株式、外国為替など）が対象です。
contract_bonus	先物ボーナス	先物取引に使用できるトライアル資金です。未使用残高は有効期限後に回収されます。
contract_bonus_new	先物バウチャー	レバレッジと取引ペアの制限を設定でき、有効時間が定められた新しいタイプの先物トライアル資金です。
commission_rebate	取引手数料リベートバウチャー	対象市場で実際に発生した取引手数料の一定割合が還元されます。残高がなくなるまで繰り返し利用できます。
hold_bonus	Earnボーナス	Earn商品（例：Lend & Earn）に使用できるトライアル資金です。有効期限後に回収されます。
point	ポイントカード	特典との交換やキャンペーンで使用できるプラットフォームポイントです。
financial_rate	利率アップバウチャー	対象のEarn商品の基本金利に上乗せされます。上限額があります。
robot_bonus	ボットボーナス	取引ボット（例：グリッド、先物グリッド）に使用できるトライアル資金です。一定期間の経過後に回収されます。
loss_protection_copier	コピートレード損失保護	最大補償額と対象トレーダーの制限に従い、コピートレードの損失の一部を補償します。
vip_card	VIPトライアルカード	有効化後、定められた日数の間、一時的にVIPレベルの手数料率と特典が適用されます。
interest_voucher	証拠金利息割引バウチャー	分離マージン借入の金利を定められた割合で引き下げます。割引額には上限があります。
p2p	P2P割引バウチャー	P2P取引手数料を一定割合で差し引きます。上限額と最低取引額が適用されます。
cash	現金バウチャー	アカウント残高の現金として引き換えできます。条件を満たすと入金されます。
crypto_loan_interest	暗号資産ローン利息割引バウチャー	暗号資産を担保とするローン（期間柔軟型）の利息を割り引きます。割引額の上限と最低借入額が適用されます。
copy_trading	コピートレードボーナス	コピートレードに使用できるトライアル資金です。特定のトレーダーまたはすべてのトレーダーに対応し、損切り上限とトライアル期間が定められています。
alpha_voucher	Alpha現金バウチャー	Gate Alpha市場でトークンを購入する際に使用できる現金クレジットです。
etf_voucher	ETFボーナス	指定されたETFペアで、定められた時間使用できるレバレッジETF取引向けのトライアル資金です。

ステータスの説明

ステータス	意味
NOT_ACTIVE	有効化待ち
ACTIVATED	有効化済み
TO_BE_USED	利用可能、未使用
EXPIRED	期限切れ（未使用）
USED	使用済み／消費済み
RECYCLED	プラットフォームによって回収済み
INVALID	無効化済み
TASK_WAIT	タスク進行中
TASK_DONE	タスク完了、報酬処理中
TASK_RECEIVE_SUCCESS	タスク報酬の受け取り完了
TASK_EXPIRED	完了前にタスクの期限切れ
TASK_START	タスク未開始（クーポン発行済み、タスクの有効化待ち）
TASK_NOT_STARTED_EXPIRED	タスク開始前に期限切れ
TASK_RECEIVE_FAIL	タスク報酬の受け取り失敗
UNKNOWN	不明なステータス

gate-cli cex coupon list のパラメーター

パラメーター	デフォルト	説明
expired	0	0 = 有効なクーポン、1 = 期限切れ／使用済みのクーポン
limit	20	ページサイズ（1～20）
last_id	0	カーソルページネーション：前のページの最後の ID
expire_time	0	カーソルページネーション：前のページの最後の項目の expire_time_order_by。last_id と併用します
order_by	latest	latest = 取得時刻順、expired = 有効期限の昇順
coupon_type	(すべて)	クーポンの種類で絞り込み
is_task_coupon	(すべて)	0 = 通常のクーポンのみ、1 = タスククーポンのみ

gate-cli cex coupon detail のパラメーター

パラメーター	必須	説明
coupon_type	はい	クーポンの種類を表す文字列
detail_id	はい	通常のクーポン：一覧の details_id。タスククーポン：一覧の id
is_task_coupon	いいえ	0 = 通常のクーポン（デフォルト）、1 = タスククーポン

ルーティングルール

ユーザーの意図を分類し、対応するリファレンスドキュメントにルーティングします：

意図	例	ルーティング先
利用可能なクーポンを一覧表示する	「どんなクーポンを持っていますか？」「利用可能なクーポンを表示して」「バウチャーを持っていますか？」「クーポンの残高を確認して」	references/list-coupons.md を読む
クーポンの種類で検索する	「コミッション還元バウチャーを持っていますか？」「先物取引ボーナスがあるか確認して」「VIP お試しカードを表示して」	references/list-coupons.md を読む
クーポンの詳細を表示する	「コミッション還元クーポンの詳細を表示して」「このバウチャーの詳細は？」「クーポンの残りはいくらですか？」	references/coupon-detail.md を読む
利用ルールを確認する	「このクーポンのルールは？」「このバウチャーの使い方は？」「先物取引ボーナスの利用条件は？」	references/coupon-detail.md を読む
クーポンの入手元を確認する	「このクーポンはどうやって入手しましたか？」「このバウチャーはどこから来ましたか？」「どのキャンペーンでこのクーポンを獲得しましたか？」	references/coupon-detail.md を読む
期限切れ／使用済みのクーポンを照会する	「使用済みのクーポンを表示して」「期限切れのバウチャーを一覧表示して」「使用したクーポンは何ですか？」	references/list-coupons.md を読む
不明確	「クーポンについて教えて」「クーポンのヘルプ」	確認する：すべてのクーポンを一覧表示したいのか、特定のクーポンを確認したいのかを尋ねます

実行

1. 上記のルーティングルール表からユーザーの意図を特定します。
2. 対応するリファレンスドキュメントを読み込みます。
3. そのドキュメントのワークフローに従って、手順を進めます。
4. すべての操作は読み取り専用のため、確認は不要です。

エラー処理

状況	対応
クーポンが見つからない	クーポンのレコードが存在しないか、現在のユーザーに属していません。どのクーポンを指しているのかユーザーに再確認し、有効な ID を取得するために一覧を再取得してください。
クーポンの種類が無効	coupon_type が認識可能な列挙値ではありません。ユーザーの自然言語を「クーポンの種類」のリファレンステーブルに照らして変換し、再試行してください。
クーポンが返されない	クエリに一致するクーポンがないことをユーザーに伝えてください。タスク、アクティビティ、または紹介を通じてクーポンを獲得することを提案してください。
ユーザーがクーポンの種類を認識していない	ユーザーが曖昧な名前や非公式な名前を挙げています。「クーポンの種類」のリファレンスから最も近い種類名を列挙して、確認してください。

安全規則

• このスキルの操作はすべて読み取り専用です（クエリのみで、書き込みは行いません）。
• 会話の中でユーザーの API シークレットを要求したり、公開したりしないでください。
• クーポン ID を推測しないでください。必ず最初に一覧 API から取得してください。