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-cli commands 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_KEY and GATE_API_SECRET are not both set on the host, run gate-cli config init to complete the wizard for API key, secret, profiles, and defaults (see gate-cli).
- Env / flags:
gate-cli config init is not required when credentials are already supplied — e.g. both GATE_API_KEY and GATE_API_SECRET set on the host, or --api-key / --api-secret where 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 (run sh ./setup.sh from this skill directory if missing; optional GATE_CLI_SETUP_MODE=release).
- Add
$HOME/.openclaw/skills/bin to PATH if you invoke gate-cli by name (or the directory where setup.sh installs it).
- Credentials: When
GATE_API_KEY and GATE_API_SECRET are both set (non-empty) for the host, do not require gate-cli config init — that is equivalent valid config for gate-cli. When both are unset or empty, remind the operator to run gate-cli config init or to configure GATE_API_KEY / GATE_API_SECRET in 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 --version or a read-only gate-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.md keeps coupon semantics, mapping rules, and rendering policy.references/gate-cli.md is the authoritative gate-cli execution 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_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 |
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.
1---2name: gate-exchange-coupon3description: Gate coupon and voucher query skill. Use when the user asks about coupon balance, rules, expiry, or source. Triggers on 'my coupons', 'coupon details', 'voucher rules', 'coupon expires'.4---56### Resolving `gate-cli` (binary path)78Resolve **`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`](https://github.com/gate/gate-skills/blob/master/skills/exchange-runtime-rules.md) §4 (or [`gate-runtime-rules.md`](https://github.com/gate/gate-skills/blob/master/skills/gate-runtime-rules.md) §4).91011# Gate Coupon Assistant1213Query 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.1415## General Rules1617⚠️ STOP — You MUST read and strictly follow the shared runtime rules before proceeding.18Do NOT select or call any tool until all rules are read. These rules have the highest priority.19→ Read `./references/gate-runtime-rules.md`20- **Only use the `gate-cli` commands explicitly listed in this skill.** Commands not documented here must NOT be run for these workflows, even if other interfaces expose them.2122## Skill Dependencies232425### gate-cli commands used2627**Query Operations (Read-only)**2829- `gate-cli cex coupon detail`30- `gate-cli cex coupon list`3132### Authentication33- **Interactive file setup:** when **`GATE_API_KEY`** and **`GATE_API_SECRET`** are **not** both set on the host, run **`gate-cli config init`** to complete the wizard for API key, secret, profiles, and defaults (see [gate-cli](https://github.com/gate/gate-cli)).34- **Env / flags:** **`gate-cli config init`** is **not** required when credentials are already supplied — e.g. **both** **`GATE_API_KEY`** and **`GATE_API_SECRET`** set on the host, or **`--api-key`** / **`--api-secret`** where supported — never ask the user to paste secrets into chat.35- API Key Required: Yes36- **Permissions:** Coupon:Read37- **Portal:** create or rotate keys outside the chat: https://www.gate.com/myaccount/profile/api-key/manage3839### Installation Check40- **Required:** `gate-cli` (run `sh ./setup.sh` from this skill directory if missing; optional `GATE_CLI_SETUP_MODE=release`).41- Add `$HOME/.openclaw/skills/bin` to **`PATH`** if you invoke `gate-cli` by name (or the directory where [`setup.sh`](./setup.sh) installs it).42- **Credentials:** When **`GATE_API_KEY`** and **`GATE_API_SECRET`** are both set (non-empty) for the host, **do not** require **`gate-cli config init`** — that is equivalent valid config for `gate-cli`. When **both** are unset or empty, **remind** the operator to run **`gate-cli config init`** **or** to configure **`GATE_API_KEY`** / **`GATE_API_SECRET`** in the **matching skill** from the skill library (never ask the user to paste secrets into chat).43- **Sanity check:** Do not proceed with authenticated calls until the CLI behaves as expected (e.g. **`gate-cli --version`** or a read-only **`gate-cli cex ...`** command from this skill); confirm credentials resolve before mutating operations.444546## Execution mode4748**Read and strictly follow** [`references/gate-cli.md`](./references/gate-cli.md), then execute this skill's coupon-query workflow.4950- `SKILL.md` keeps coupon semantics, mapping rules, and rendering policy.51- `references/gate-cli.md` is the authoritative `gate-cli` execution contract for list/detail query behavior and degradation-safe output.5253## Domain Knowledge5455### Command mapping565758| Tool | Description |59| ----------------------------------- | ------------------------------------------------------------- |60| `gate-cli cex coupon list` | Fetch user coupon list (paginated, filterable by type/status) |61| `gate-cli cex coupon detail` | Fetch full details of a single coupon |626364### Coupon Types Reference6566> **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.6768| `coupon_type` | Display Name | Description |69| ------------------------- | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |70| `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. |71| `tradfi_position_voucher` | TradFi Position Voucher | Same concept as position voucher but applies to TradFi instruments (stocks, forex, etc.). |72| `contract_bonus` | Futures Bonus | Trial funds usable in futures trading. Unused balance is reclaimed at expiry. |73| `contract_bonus_new` | Futures Voucher | Newer futures trial funds with configurable leverage and trading pair restrictions; valid for a set number of hours. |74| `commission_rebate` | Commission Rebate Voucher | Rebates a percentage of actual trading fees incurred on applicable markets; reusable until the balance runs out. |75| `hold_bonus` | Earn Bonus | Trial funds for Earn products (e.g. Lend & Earn); reclaimed at expiry. |76| `point` | Points Card | Platform points redeemable for rewards or used in activities. |77| `financial_rate` | Rate Boost Voucher | Adds extra APR on top of the base rate for eligible Earn products, up to a capped amount. |78| `robot_bonus` | Bot Bonus | Trial funds for trading bots (e.g. Grid, Futures Grid); runs for a fixed duration then is reclaimed. |79| `loss_protection_copier` | Copy Trading Protection | Compensates a portion of copy trading losses, subject to a maximum payout and eligible-trader restrictions. |80| `vip_card` | VIP Trial Card | Grants temporary VIP-tier fee rates and benefits for a fixed number of days after activation. |81| `interest_voucher` | Margin Interest Discount Voucher | Reduces the interest rate on isolated-margin borrowing by a set percentage, up to a maximum discount amount. |82| `p2p` | P2P Discount Voucher | Deducts a percentage of P2P trading fees, subject to a cap and a minimum transaction size. |83| `cash` | Cash Voucher | Redeemable for account balance cash; credited once qualifying conditions are met. |84| `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. |85| `copy_trading` | Copy Trading Bonus | Trial funds for copy trading; supports specific or all traders, with a stop-loss limit and fixed trial duration. |86| `alpha_voucher` | Alpha Cash Voucher | Cash credit usable for purchasing tokens on Gate Alpha market. |87| `etf_voucher` | ETF Bonus | Trial funds for leveraged ETF trading, valid for a set number of hours on specified ETF pairs. |888990### Status Reference919293| Status | Meaning |94| -------------------------- | ------------------------------------------------------------- |95| `NOT_ACTIVE` | Pending activation |96| `ACTIVATED` | Activated |97| `TO_BE_USED` | Available, not yet used |98| `EXPIRED` | Expired (unused) |99| `USED` | Used/consumed |100| `RECYCLED` | Recycled by platform |101| `INVALID` | Invalidated |102| `TASK_WAIT` | Task in progress |103| `TASK_DONE` | Task completed, reward processing |104| `TASK_RECEIVE_SUCCESS` | Task reward received |105| `TASK_EXPIRED` | Task expired before completion |106| `TASK_START` | Task not yet started (coupon issued, task pending activation) |107| `TASK_NOT_STARTED_EXPIRED` | Task expired before it started |108| `TASK_RECEIVE_FAIL` | Task reward claim failed |109| `UNKNOWN` | Unknown status |110111112### `gate-cli cex coupon list` Parameters113114115| Parameter | Default | Description |116| ---------------- | -------- | --------------------------------------------------------------------------------------------------------------- |117| `expired` | `0` | `0` = valid coupons; `1` = expired/used coupons |118| `limit` | `20` | Page size (1–20) |119| `last_id` | `0` | Cursor pagination: last id from previous page |120| `expire_time` | `0` | Cursor pagination: `expire_time_order_by` of the last item from the previous page; used together with `last_id` |121| `order_by` | `latest` | `latest` = by acquisition time; `expired` = by expiry asc |122| `coupon_type` | (all) | Filter by coupon type |123| `is_task_coupon` | (all) | `0` = regular only; `1` = task coupons only |124125126### `gate-cli cex coupon detail` Parameters127128129| Parameter | Required | Description |130| ---------------- | -------- | ------------------------------------------------------------------- |131| `coupon_type` | Yes | Coupon type string |132| `detail_id` | Yes | Regular coupon: `details_id` from list; Task coupon: `id` from list |133| `is_task_coupon` | No | `0` = regular (default); `1` = task coupon |134135136## Routing Rules137138Classify the user intent and route to the matching reference document:139140141| Intent | Example Phrases | Route to |142| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------- |143| **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` |144| **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` |145| **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` |146| **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` |147| **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` |148| **Query expired/used coupons** | "Show my used coupons", "List my expired vouchers", "What coupons have I used?" | Read `references/list-coupons.md` |149| **Unclear** | "Tell me about my coupons", "coupon help" | Clarify: ask if user wants to list all coupons or check a specific one |150151152## Execution1531541. Identify user intent from the Routing Rules table above.1552. Load the corresponding reference document.1563. Follow the workflow in that document step by step.1574. All operations are read-only — no confirmation gate required.158159## Error Handling160161162| Situation | Action |163| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |164| 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. |165| Invalid coupon type | `coupon_type` is not a recognized enum value. Map user's natural language to the Coupon Types Reference table and retry. |166| No coupons returned | Inform user no coupons match the query. Suggest earning coupons through tasks, activities, or referrals. |167| 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. |168169170## Safety Rules171172- All operations in this skill are **read-only** (query only, no writes).173- Never request or expose user API secrets in the conversation.174- Do not infer or guess coupon IDs — always obtain them from the list API first.
gate