← 返回 Skills 市场
193
总下载
0
收藏
0
当前安装
5
版本数
在 OpenClaw 中安装
/install gate-exchange-coupon
功能描述
Gate coupon and voucher query skill. Use when the user asks about coupon balance, rules, expiry, or source. Triggers on 'my coupons', 'coupon details', 'vouc...
使用说明 (SKILL.md)
Gate Coupon Assistant
Query and inspect coupon/voucher accounts on Gate Exchange. Supports six scenarios: list available coupons, search by coupon type, view expired/used history, view full coupon details, read usage rules, and trace coupon acquisition source.
General Rules
⚠️ STOP — You MUST read and strictly follow the shared runtime rules before proceeding.
Do NOT select or call any tool until all rules are read. These rules have the highest priority.
→ Read ./references/gate-runtime-rules.md
- Only call MCP tools explicitly listed in this skill. Tools not documented here must NOT be called, even if they exist in the MCP server.
MCP Dependencies
Required MCP Servers
| MCP Server | Status |
|---|---|
| Gate (main) | ✅ Required |
MCP Tools Used
Query Operations (Read-only)
- cex_coupon_get_user_coupon_detail
- cex_coupon_list_user_coupons
Authentication
- Credentials Source: Local Gate MCP deployment (
GATE_API_KEY,GATE_API_SECRET) - API Key Required: Yes
- Permissions: Coupon:Read
- Never ask the user to paste secrets into chat; rely on the configured MCP session only.
- API Key Provisioning Reference: https://www.gate.com/myaccount/profile/api-key/manage (create or rotate keys outside the chat when the local MCP setup requires them).
Installation Check
- Required: Gate (main)
- Install: Use the local Gate MCP installation flow for the current host IDE before continuing.
- Continue only after the Gate MCP session is configured with the credentials listed above; do not switch to browser auth or ask the user to paste secrets into chat.
MCP Mode
Read and strictly follow references/mcp.md, then execute this skill's coupon-query workflow.
SKILL.mdkeeps coupon semantics, mapping rules, and rendering policy.references/mcp.mdis the authoritative MCP execution layer for list/detail query behavior and degradation-safe output.
Domain Knowledge
MCP Tool Mapping
| Tool | Description |
|---|---|
cex_coupon_list_user_coupons |
Fetch user coupon list (paginated, filterable by type/status) |
cex_coupon_get_user_coupon_detail |
Fetch full details of a single coupon |
Coupon Types Reference
IMPORTANT — Type Translation Rule: When displaying the coupon type, map
coupon_typestrictly to the Display Name. You may translate Display Names to match the response language, but the mapping must be exact — never swap or conflate two different types. Critical distinction:position_voucher(Position Trial Voucher) is a position-based trial voucher — translate as "仓位体验券" in Chinese, never as "合约体验金";contract_bonus(Futures Bonus) is futures trial funds — translate as "合约体验金". They are completely different products.
coupon_type |
Display Name | Description |
|---|---|---|
position_voucher |
Position Trial Voucher | Virtual capital for opening futures positions (NOT the same as Futures Bonus). Profits can be withdrawn; the principal is reclaimed after expiry. |
tradfi_position_voucher |
TradFi Position Voucher | Same concept as position voucher but applies to TradFi instruments (stocks, forex, etc.). |
contract_bonus |
Futures Bonus | Trial funds usable in futures trading. Unused balance is reclaimed at expiry. |
contract_bonus_new |
Futures Voucher | Newer futures trial funds with configurable leverage and trading pair restrictions; valid for a set number of hours. |
commission_rebate |
Commission Rebate Voucher | Rebates a percentage of actual trading fees incurred on applicable markets; reusable until the balance runs out. |
hold_bonus |
Earn Bonus | Trial funds for Earn products (e.g. Lend & Earn); reclaimed at expiry. |
point |
Points Card | Platform points redeemable for rewards or used in activities. |
financial_rate |
Rate Boost Voucher | Adds extra APR on top of the base rate for eligible Earn products, up to a capped amount. |
robot_bonus |
Bot Bonus | Trial funds for trading bots (e.g. Grid, Futures Grid); runs for a fixed duration then is reclaimed. |
loss_protection_copier |
Copy Trading Protection | Compensates a portion of copy trading losses, subject to a maximum payout and eligible-trader restrictions. |
vip_card |
VIP Trial Card | Grants temporary VIP-tier fee rates and benefits for a fixed number of days after activation. |
interest_voucher |
Margin Interest Discount Voucher | Reduces the interest rate on isolated-margin borrowing by a set percentage, up to a maximum discount amount. |
p2p |
P2P Discount Voucher | Deducts a percentage of P2P trading fees, subject to a cap and a minimum transaction size. |
cash |
Cash Voucher | Redeemable for account balance cash; credited once qualifying conditions are met. |
crypto_loan_interest |
Crypto Loan Interest Discount Voucher | Reduces interest on crypto-collateral loans (flexible term), subject to a maximum discount and minimum loan amount. |
copy_trading |
Copy Trading Bonus | Trial funds for copy trading; supports specific or all traders, with a stop-loss limit and fixed trial duration. |
alpha_voucher |
Alpha Cash Voucher | Cash credit usable for purchasing tokens on Gate Alpha market. |
etf_voucher |
ETF Bonus | Trial funds for leveraged ETF trading, valid for a set number of hours on specified ETF pairs. |
Status Reference
| Status | Meaning |
|---|---|
NOT_ACTIVE |
Pending activation |
ACTIVATED |
Activated |
TO_BE_USED |
Available, not yet used |
EXPIRED |
Expired (unused) |
USED |
Used/consumed |
RECYCLED |
Recycled by platform |
INVALID |
Invalidated |
TASK_WAIT |
Task in progress |
TASK_DONE |
Task completed, reward processing |
TASK_RECEIVE_SUCCESS |
Task reward received |
TASK_EXPIRED |
Task expired before completion |
TASK_START |
Task not yet started (coupon issued, task pending activation) |
TASK_NOT_STARTED_EXPIRED |
Task expired before it started |
TASK_RECEIVE_FAIL |
Task reward claim failed |
UNKNOWN |
Unknown status |
cex_coupon_list_user_coupons Parameters
| Parameter | Default | Description |
|---|---|---|
expired |
0 |
0 = valid coupons; 1 = expired/used coupons |
limit |
20 |
Page size (1–20) |
last_id |
0 |
Cursor pagination: last id from previous page |
expire_time |
0 |
Cursor pagination: expire_time_order_by of the last item from the previous page; used together with last_id |
order_by |
latest |
latest = by acquisition time; expired = by expiry asc |
coupon_type |
(all) | Filter by coupon type |
is_task_coupon |
(all) | 0 = regular only; 1 = task coupons only |
cex_coupon_get_user_coupon_detail Parameters
| Parameter | Required | Description |
|---|---|---|
coupon_type |
Yes | Coupon type string |
detail_id |
Yes | Regular coupon: details_id from list; Task coupon: id from list |
is_task_coupon |
No | 0 = regular (default); 1 = task coupon |
Routing Rules
Classify the user intent and route to the matching reference document:
| Intent | Example Phrases | Route to |
|---|---|---|
| List available coupons | "What coupons do I have?", "Show my available coupons", "Do I have any vouchers?", "Check my coupon balance" | Read references/list-coupons.md |
| Search by coupon type | "Do I have a commission rebate voucher?", "Check if I have a futures bonus", "Show my VIP trial cards" | Read references/list-coupons.md |
| View coupon details | "Show details of my commission rebate coupon", "What are the details of this voucher?", "How much is left on my coupon?" | Read references/coupon-detail.md |
| View usage rules | "What are the rules for this coupon?", "How do I use this voucher?", "What are the terms of my futures bonus?" | Read references/coupon-detail.md |
| Trace coupon source | "How did I get this coupon?", "Where did this voucher come from?", "What activity gave me this coupon?" | Read references/coupon-detail.md |
| Query expired/used coupons | "Show my used coupons", "List my expired vouchers", "What coupons have I used?" | Read references/list-coupons.md |
| Unclear | "Tell me about my coupons", "coupon help" | Clarify: ask if user wants to list all coupons or check a specific one |
Execution
- Identify user intent from the Routing Rules table above.
- Load the corresponding reference document.
- Follow the workflow in that document step by step.
- All operations are read-only — no confirmation gate required.
Error Handling
| Situation | Action |
|---|---|
| Coupon not found | Coupon record does not exist or does not belong to current user. Ask user to re-check which coupon they meant; re-fetch list to get valid IDs. |
| Invalid coupon type | coupon_type is not a recognized enum value. Map user's natural language to the Coupon Types Reference table and retry. |
| No coupons returned | Inform user no coupons match the query. Suggest earning coupons through tasks, activities, or referrals. |
| Coupon type unrecognized by user | User mentions a vague or informal name. Clarify by listing the closest matching type names from the Coupon Types Reference. |
Safety Rules
- All operations in this skill are read-only (query only, no writes).
- Never request or expose user API secrets in the conversation.
- Do not infer or guess coupon IDs — always obtain them from the list API first.
安全使用建议
This skill appears coherent and limited to read-only coupon queries on Gate. Before installing: (1) only provide API credentials via your local MCP/session configuration (do not paste keys into chat); (2) create an API key with the minimum necessary scope (Coupon:Read) in your Gate account and verify its permissions; (3) confirm you trust the local MCP deployment you will use (skill expects a configured local Gate MCP); (4) review the GitHub homepage/source if you want provenance before enabling. If you cannot confirm MCP origin or cannot restrict the API key scope, proceed cautiously or create a dedicated, limited-scope key you can revoke.
功能分析
Type: OpenClaw Skill
Name: gate-exchange-coupon
Version: 1.0.4
The gate-exchange-coupon skill is a legitimate tool designed to query and display coupon and voucher information from the Gate exchange. It utilizes specific MCP tools (cex_coupon_list_user_coupons and cex_coupon_get_user_coupon_detail) and requires only read-only permissions (Coupon:Read). The documentation in SKILL.md and the references directory provides clear instructions for the AI agent on intent classification, data formatting, and safety protocols, including explicit warnings against requesting user secrets. The use of inline Python commands for timestamp conversion is a standard formatting procedure within the OpenClaw environment and does not indicate malicious behavior.
能力标签
能力评估
Purpose & Capability
Name/description match the behavior: the skill queries coupon lists and details via Gate MCP tools. Required env vars (GATE_API_KEY, GATE_API_SECRET) are appropriate for calling Gate APIs and the declared permission is Coupon:Read. No unrelated services, binaries, or config paths are requested.
Instruction Scope
SKILL.md confines execution to read-only MCP tools (cex_coupon_list_user_coupons, cex_coupon_get_user_coupon_detail), includes detailed formatting/output rules, and explicitly forbids requesting secrets in chat or calling undocumented tools. It does instruct using local MCP session and occasional local tooling (e.g., a small python snippet for timestamp conversion), which is consistent with the stated workflow.
Install Mechanism
Instruction-only skill with no install spec or downloads. Nothing is written to disk by the skill bundle itself; lowest install risk.
Credentials
The skill asks for GATE_API_KEY and GATE_API_SECRET which is expected for API access. Note: API secrets can sometimes enable broader actions depending on account/API key scopes configured at Gate — the skill documents a minimal Coupon:Read permission, but verify the actual API key permissions in your Gate account before provisioning.
Persistence & Privilege
always:false and default model-invocation/autonomy are used. The skill does not request permanent presence or modify other skills or system-wide settings. It also states it will not store or paste API secrets.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install gate-exchange-coupon - 安装完成后，直接呼叫该 Skill 的名称或使用
/gate-exchange-coupon触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.4
- Version updated to 1.0.4 with maintenance changes.
- Removed CHANGELOG.md and README.md files.
- Minor update to SKILL.md version and updated date.
- No changes to features or functionality.
v1.0.3
- Added metadata section for OpenClaw integration and environment requirements.
- Updated runtime rules reference to a local file path.
- Clarified installation steps and host IDE requirements.
- Expanded instructions on credential handling and session configuration.
- Added new documentation file: references/gate-runtime-rules.md.
v1.0.2
- Added explicit credential and environment variable requirements (`gate_api_key`, `gate_api_secret`, `GATE_API_KEY`, `GATE_API_SECRET`).
- Updated authentication documentation to clarify credential sourcing, required permissions, and that users should never paste secrets into chat.
- No changes made to endpoints, scenarios, or domain semantics.
v1.0.1
- Shortened and clarified the skill description and trigger phrases for better usability.
- Added a new MCP execution reference file: references/mcp.md.
- Updated instructions to require reading and following the new references/mcp.md for query workflow and output safety.
- Moved some workflow responsibilities and MCP policies out of SKILL.md to references/mcp.md for improved separation of concerns.
- No changes to API dependencies or coupon type/status mappings.
v1.0.0
- Initial release of the Gate Exchange coupon management skill.
- Supports querying available coupons, checking coupon details, reading usage rules, and tracing coupon sources.
- Handles requests for listing active, expired, or used coupon histories and filtering by coupon type.
- Ensures strict mapping and distinction of coupon types and statuses based on Gate Exchange definitions.
- Requires API key with Coupon:Read permissions for all operations.
元数据
常见问题
Gate Exchange Coupon 是什么？
Gate coupon and voucher query skill. Use when the user asks about coupon balance, rules, expiry, or source. Triggers on 'my coupons', 'coupon details', 'vouc... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 193 次。
如何安装 Gate Exchange Coupon？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install gate-exchange-coupon」即可一键安装，无需额外配置。
Gate Exchange Coupon 是免费的吗？
是的，Gate Exchange Coupon 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Gate Exchange Coupon 支持哪些平台？
Gate Exchange Coupon 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Gate Exchange Coupon？
由 Gate（@gate-exchange）开发并维护，当前版本 v1.0.4。
推荐 Skills