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 ServerStatusGate (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#

ToolDescriptioncex_coupon_list_user_couponsFetch user coupon list (paginated, filterable by type/status)cex_coupon_get_user_coupon_detailFetch 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_typeDisplay NameDescriptionposition_voucherPosition Trial VoucherVirtual capital for opening futures positions (NOT the same as Futures Bonus). Profits can be withdrawn; the principal is reclaimed after expiry.tradfi_position_voucherTradFi Position VoucherSame concept as position voucher but applies to TradFi instruments (stocks, forex, etc.).contract_bonusFutures BonusTrial funds usable in futures trading. Unused balance is reclaimed at expiry.contract_bonus_newFutures VoucherNewer futures trial funds with configurable leverage and trading pair restrictions; valid for a set number of hours.commission_rebateCommission Rebate VoucherRebates a percentage of actual trading fees incurred on applicable markets; reusable until the balance runs out.hold_bonusEarn BonusTrial funds for Earn products (e.g. Lend & Earn); reclaimed at expiry.pointPoints CardPlatform points redeemable for rewards or used in activities.financial_rateRate Boost VoucherAdds extra APR on top of the base rate for eligible Earn products, up to a capped amount.robot_bonusBot BonusTrial funds for trading bots (e.g. Grid, Futures Grid); runs for a fixed duration then is reclaimed.loss_protection_copierCopy Trading ProtectionCompensates a portion of copy trading losses, subject to a maximum payout and eligible-trader restrictions.vip_cardVIP Trial CardGrants temporary VIP-tier fee rates and benefits for a fixed number of days after activation.interest_voucherMargin Interest Discount VoucherReduces the interest rate on isolated-margin borrowing by a set percentage, up to a maximum discount amount.p2pP2P Discount VoucherDeducts a percentage of P2P trading fees, subject to a cap and a minimum transaction size.cashCash VoucherRedeemable for account balance cash; credited once qualifying conditions are met.crypto_loan_interestCrypto Loan Interest Discount VoucherReduces interest on crypto-collateral loans (flexible term), subject to a maximum discount and minimum loan amount.copy_tradingCopy Trading BonusTrial funds for copy trading; supports specific or all traders, with a stop-loss limit and fixed trial duration.alpha_voucherAlpha Cash VoucherCash credit usable for purchasing tokens on Gate Alpha market.etf_voucherETF BonusTrial funds for leveraged ETF trading, valid for a set number of hours on specified ETF pairs.

Status Reference#

StatusMeaningNOT_ACTIVEPending activationACTIVATEDActivatedTO_BE_USEDAvailable, not yet usedEXPIREDExpired (unused)USEDUsed/consumedRECYCLEDRecycled by platformINVALIDInvalidatedTASK_WAITTask in progressTASK_DONETask completed, reward processingTASK_RECEIVE_SUCCESSTask reward receivedTASK_EXPIREDTask expired before completionTASK_STARTTask not yet started (coupon issued, task pending activation)TASK_NOT_STARTED_EXPIREDTask expired before it startedTASK_RECEIVE_FAILTask reward claim failedUNKNOWNUnknown status

cex_coupon_list_user_coupons Parameters#

ParameterDefaultDescriptionexpired``0``0 = valid coupons; 1 = expired/used couponslimit``20Page size (1–20)last_id``0Cursor pagination: last id from previous pageexpire_time``0Cursor 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 asccoupon_type(all)Filter by coupon typeis_task_coupon(all)0 = regular only; 1 = task coupons only

cex_coupon_get_user_coupon_detail Parameters#

ParameterRequiredDescriptioncoupon_typeYesCoupon type stringdetail_idYesRegular coupon: details_id from list; Task coupon: id from listis_task_couponNo0 = regular (default); 1 = task coupon

Routing Rules#

Classify the user intent and route to the matching reference document:

IntentExample PhrasesRoute toList available coupons"What coupons do I have?", "Show my available coupons", "Do I have any vouchers?", "Check my coupon balance"Read references/list-coupons.mdSearch 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.mdView 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.mdView 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.mdTrace coupon source"How did I get this coupon?", "Where did this voucher come from?", "What activity gave me this coupon?"Read references/coupon-detail.mdQuery expired/used coupons"Show my used coupons", "List my expired vouchers", "What coupons have I used?"Read references/list-coupons.mdUnclear"Tell me about my coupons", "coupon help"Clarify: ask if user wants to list all coupons or check a specific one

Execution#

1. Identify user intent from the Routing Rules table above.
2. Load the corresponding reference document.
3. Follow the workflow in that document step by step.
4. All operations are read-only — no confirmation gate required.

Error Handling#

SituationActionCoupon not foundCoupon 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 typecoupon_type is not a recognized enum value. Map user's natural language to the Coupon Types Reference table and retry.No coupons returnedInform user no coupons match the query. Suggest earning coupons through tasks, activities, or referrals.Coupon type unrecognized by userUser 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.