功能描述

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

Name: Gate Exchange Coupon
Author: gaixianggeng

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.md keeps coupon semantics, mapping rules, and rendering policy.
references/mcp.md is 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_type strictly 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 internally consistent and limited to read-only coupon queries. Before installing: (1) ensure you configure a Gate API key with the minimal Coupon:Read permission (avoid giving write/trading scopes), (2) confirm your environment has a local Gate MCP session as the skill expects and do not paste API secrets into chat, and (3) be aware the instructions reference using a programming tool (example: python3) for timestamp conversion — if your environment lacks that tool the agent may fall back to other means or ask you. If you need extra assurance, review the SKILL.md and the referenced files yourself and verify the MCP endpoints it will call match your expectations.

能力标签

cryptocan-make-purchases

能力评估

✓ Purpose & Capability

Name/description (Gate coupon queries) match the declared needs: the skill requires GATE_API_KEY and GATE_API_SECRET and calls read-only coupon endpoints via the Gate MCP. Asking for the exchange API key/secret is appropriate for authenticated read operations.

ℹ Instruction Scope

SKILL.md confines behavior to read-only coupon list/detail queries, enforces using only documented MCP tools, and explicitly disallows asking users to paste secrets. It references using a programming tool (example: python3 -c) to convert timestamps; the metadata does not list python as a required binary — this is a small documentation inconsistency but not evidence of malicious behavior. No instructions ask to read unrelated files or transmit data to external endpoints outside the Gate MCP.

✓ Install Mechanism

Instruction-only skill with no install spec and no code files. This minimizes risk because nothing in the bundle is downloaded or executed on install.

✓ Credentials

Only two environment variables are required (GATE_API_KEY, GATE_API_SECRET) and the primary credential is correctly identified. Those credentials are proportional to the stated read-only coupon query purpose (minimal permission: Coupon:Read). No unrelated secrets or extraneous env vars are requested.

✓ Persistence & Privilege

always:false (no forced presence). The skill does not request persistent system-wide modifications, does not store/rotate secrets, and is explicitly read-only. Autonomous invocation being allowed is the platform default and is not an additional concern here.

版本历史

v1.0.1

- Updated SKILL.md to reflect new version and update date. - Removed CHANGELOG.md and README.md files. - Minor revision to documentation; no functional behavior changes. - SKILL.md remains the primary reference for coupon query rules and type mappings.

v1.0.0

Gate Coupon Assistant v1.0.0 – Initial Release - Introduces a skill to query and inspect Gate Exchange coupons and vouchers. - Supports listing available coupons, searching by type, viewing expired/used history, fetching full coupon details, reading usage rules, and tracing acquisition sources. - Requires Gate MCP API credentials and Coupon:Read permission. - Explicit rules for tool selection and security (credentials never pasted in chat). - Provides detailed mapping for coupon types and translation rules. - Enforces strict adherence to documented MCP operations and coupon handling policies.

元数据

Slug gate-exchange-coupon-staging

版本 1.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题

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 插件，目前累计下载 110 次。

如何安装 Gate Exchange Coupon？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install gate-exchange-coupon-staging」即可一键安装，无需额外配置。

Gate Exchange Coupon 是免费的吗？

是的，Gate Exchange Coupon 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Gate Exchange Coupon 支持哪些平台？

Gate Exchange Coupon 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Gate Exchange Coupon？

由 gaixg（@gaixianggeng）开发并维护，当前版本 v1.0.1。

Gate Exchange Coupon