Imported from gate/gate-skills (
skills/gate-exchange-coupon/SKILL.md). Install upstream withnpx skills add gate/gate-skills --skill gate-exchange-coupon. Copyright stays with the author.
Resolving gate-cli (binary path)
Resolve gate-cli in order: (1) command -v gate-cli and gate-cli --version succeeds; (2) ${HOME}/.local/bin/gate-cli if executable; (3) ${HOME}/.openclaw/skills/bin/gate-cli if executable. Canonical rules: exchange-runtime-rules.md §4 (or gate-runtime-rules.md §4).
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 use the
gate-clicommands explicitly listed in this skill. Commands not documented here must NOT be run for these workflows, even if other interfaces expose them.
Skill Dependencies
gate-cli commands used
Query Operations (Read-only)
gate-cli cex coupon detailgate-cli cex coupon list
Authentication
- Interactive file setup: when
GATE_API_KEYandGATE_API_SECRETare not both set on the host, rungate-cli config initto complete the wizard for API key, secret, profiles, and defaults (see gate-cli). - Env / flags:
gate-cli config initis not required when credentials are already supplied — e.g. bothGATE_API_KEYandGATE_API_SECRETset on the host, or--api-key/--api-secretwhere supported — never ask the user to paste secrets into chat. - API Key Required: Yes
- Permissions: Coupon:Read
- Portal: create or rotate keys outside the chat: https://www.gate.com/myaccount/profile/api-key/manage
Installation Check
- Required:
gate-cli(runsh ./setup.shfrom this skill directory if missing; optionalGATE_CLI_SETUP_MODE=release). - Add
$HOME/.openclaw/skills/bintoPATHif you invokegate-cliby name (or the directory wheresetup.shinstalls it). - Credentials: When
GATE_API_KEYandGATE_API_SECRETare both set (non-empty) for the host, do not requiregate-cli config init— that is equivalent valid config forgate-cli. When both are unset or empty, remind the operator to rungate-cli config initor to configureGATE_API_KEY/GATE_API_SECRETin the matching skill from the skill library (never ask the user to paste secrets into chat). - Sanity check: Do not proceed with authenticated calls until the CLI behaves as expected (e.g.
gate-cli --versionor a read-onlygate-cli cex ...command from this skill); confirm credentials resolve before mutating operations.
Execution mode
Read and strictly follow references/gate-cli.md, then execute this skill's coupon-query workflow.
SKILL.mdkeeps coupon semantics, mapping rules, and rendering policy.references/gate-cli.mdis the authoritativegate-cliexecution contract for list/detail query behavior and degradation-safe output.
Domain Knowledge
Command mapping
| Tool | Description |
|---|---|
gate-cli cex coupon list |
Fetch user coupon list (paginated, filterable by type/status) |
gate-cli cex 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 |
gate-cli cex coupon list 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 |
gate-cli cex 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.