gate-exchange-coupon

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Gate Coupon Assistant

Gate优惠券助手

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.

查询和查看Gate Exchange上的优惠券/代金券账户。支持六种场景：列出可用优惠券、按优惠券类型搜索、查看过期/已使用记录、查看完整优惠券详情、阅读使用规则以及追溯优惠券获取来源。

General Rules

通用规则

Read and follow the shared runtime rules before proceeding: → exchange-runtime-rules.md

开始操作前，请阅读并遵循共享的运行时规则： → exchange-runtime-rules.md

Domain Knowledge

领域知识

MCP Tool Mapping

MCP工具映射

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

工具	说明
`cex_coupon_list_user_coupons`	获取用户优惠券列表（支持分页，可按类型/状态筛选）
`cex_coupon_get_user_coupon_detail`	获取单张优惠券的完整详情

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.

重要提示——类型翻译规则：显示优惠券类型时，需将
coupon_type
严格映射至显示名称。你可以根据响应语言翻译显示名称，但映射必须准确——切勿混淆或替换两种不同类型。关键区别：
position_voucher
（Position Trial Voucher）是基于仓位的体验券——中文翻译为“仓位体验券”，绝不能译为“合约体验金”；
contract_bonus
（Futures Bonus）是合约体验金——中文翻译为“合约体验金”。二者是完全不同的产品。

`coupon_type`	显示名称	说明
`position_voucher`	仓位体验券	用于开立合约仓位的虚拟资金（与合约体验金不同）。盈利可提取；本金到期后将被收回。
`tradfi_position_voucher`	传统金融仓位体验券	与仓位体验券概念相同，但适用于传统金融工具（股票、外汇等）。
`contract_bonus`	合约体验金	可用于合约交易的体验资金。未使用余额到期后将被收回。
`contract_bonus_new`	新版合约体验金	可配置杠杆和交易对限制的新版合约体验资金；有效期为固定小时数。
`commission_rebate`	佣金返还券	返还适用市场上产生的实际交易手续费的一定比例；可重复使用直至余额耗尽。
`hold_bonus`	持仓奖励金	用于Earn产品（如借贷赚币）的体验资金；到期后将被收回。
`point`	积分卡	可兑换奖励或用于平台活动的平台积分。
`financial_rate`	利率提升券	为符合条件的Earn产品在基础利率上增加额外APR，有上限金额限制。
`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交易对的固定小时数内有效。

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

状态	说明
`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`	状态未知

cex_coupon_list_user_coupons

Parameters

cex_coupon_list_user_coupons

参数

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

参数	默认值	说明
`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` = 仅任务优惠券

cex_coupon_get_user_coupon_detail

Parameters

cex_coupon_get_user_coupon_detail

参数

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

参数	是否必填	说明
`coupon_type`	是	优惠券类型字符串
`detail_id`	是	常规优惠券：列表中的 `details_id` ；任务优惠券：列表中的 `id`
`is_task_coupon`	否	`0` = 常规优惠券（默认）； `1` = 任务优惠券

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

对用户意图进行分类，并路由至匹配的参考文档：

意图	示例语句	路由至
列出可用优惠券	"我有哪些优惠券？"、"显示我的可用优惠券"、"我有代金券吗？"、"查看我的优惠券余额"	阅读 `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`
意图不明确	"告诉我关于我的优惠券的信息"、"优惠券帮助"	澄清：询问用户是想列出所有优惠券还是查看某张特定优惠券

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.

场景	操作
未找到优惠券	优惠券记录不存在或不属于当前用户。请用户重新确认他们指的是哪张优惠券；重新获取列表以获取有效ID。
无效优惠券类型	`coupon_type` 不是已识别的枚举值。将用户的自然语言映射至优惠券类型参考表格后重试。
未返回优惠券	告知用户没有匹配查询条件的优惠券。建议用户通过任务、活动或推荐赚取优惠券。
用户无法识别优惠券类型	用户提及模糊或非正式名称。通过列出优惠券类型参考中最匹配的类型名称进行澄清。

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.

此技能中的所有操作均为只读（仅查询，无写入操作）。
切勿在对话中请求或暴露用户的API密钥。
切勿推断或猜测优惠券ID——始终首先从列表API获取。