| name | gate-exchange-simpleearn |
| description | Gate Simple Earn management skill. Use when the user asks about flexible or fixed-term savings products. Triggers on 'Simple Earn', 'flexible earn', 'subscribe to earn', 'redeem interest', 'top APY'. |
| user-invocable | true |
| disable-model-invocation | false |
| metadata | {"openclaw":{"emoji":"💱","os":["darwin","linux"],"primaryEnv":"GATE_API_KEY","requires":{"bins":"[Truncated]","env":"[Truncated]"},"install":["[Truncated]","[Truncated]","[Truncated]","[Truncated]"]}} |
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 Exchange Simple Earn Skill
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 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 earn uni changegate-cli cex earn uni currencygate-cli cex earn uni interestgate-cli cex earn fixed historygate-cli cex earn fixed lendsgate-cli cex earn fixed productsgate-cli cex earn fixed products-assetgate-cli cex earn uni rategate-cli cex earn uni lends
Execution Operations (Write)
gate-cli cex earn fixed creategate-cli cex earn fixed pre-redeemgate-cli cex earn uni lend
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.
- Permissions: Earn:Write
- 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 Simple Earn workflow.
SKILL.md keeps routing and business constraints.references/gate-cli.md is the authoritative gate-cli execution contract for query/action separation, confirmation gates, and post-action verification.
Trigger Conditions
Activate this skill when the user expresses any of the following intents:
- Simple Earn, Uni, flexible earn, fixed earn, fixed-term, subscribe, redeem, positions, interest, top APY
- Any request involving Simple Earn subscribe, redeem, position query, interest query, fixed-term product list, or fixed-term history query
Prerequisites
- MCP Dependency: Requires gate-mcp to be installed.
- Authentication: Position and write operations require API key authentication; rate and currency queries are public.
- Disclaimer: Always append when showing APY or rates: "This information is for reference only and does not constitute investment advice. APY may change. Please understand the product terms before subscribing."
Supported Workflows
Flexible (Uni)
- Single-currency or all positions query
- Single-currency interest query
- Estimated APY query
- Subscribe (lend), redeem, and change min rate operations with user confirmation
Fixed-term
- Product list and product list by currency
- Subscribe and early redeem with user confirmation
- Current total positions and single-order detail queries
- History queries for subscribe, redeem, interest, and extra bonus
Available MCP Tools
Flexible (Uni)
| Tool | Auth | Description | Reference |
|---|
gate-cli cex earn uni rate | No | Estimated APY per currency (currency enumeration; use with get_uni_currency for limits) | references/earn-uni-mcp-tools.md |
gate-cli cex earn uni currency | No | Single-currency details (min_rate for subscribe) | references/earn-uni-mcp-tools.md |
gate-cli cex earn uni lend | Yes | Create lend (subscribe) or redeem | references/earn-uni-mcp-tools.md |
gate-cli cex earn uni change | Yes | Change min rate for lend | references/earn-uni-mcp-tools.md |
gate-cli cex earn uni lends | Yes | User positions (optional currency filter) | references/earn-uni-mcp-tools.md |
gate-cli cex earn uni interest | Yes | Single-currency cumulative interest | references/earn-uni-mcp-tools.md |
gate-cli cex earn uni rate | No | Estimated APY per currency (for top APY) | references/earn-uni-mcp-tools.md |
Fixed-term
| Tool | Auth | Description | Reference |
|---|
gate-cli cex earn fixed products | No | List all fixed-term products | references/fixed-earn-mcp-tools.md |
gate-cli cex earn fixed products-asset | No | List fixed-term products by currency | references/fixed-earn-mcp-tools.md |
gate-cli cex earn fixed create | Yes | Create fixed-term lend (subscribe) | references/fixed-earn-mcp-tools.md |
gate-cli cex earn fixed pre-redeem | Yes | Early redeem fixed-term order | references/fixed-earn-mcp-tools.md |
gate-cli cex earn fixed lends | Yes | User fixed-term positions | references/fixed-earn-mcp-tools.md |
gate-cli cex earn fixed history | Yes | Fixed-term history records | references/fixed-earn-mcp-tools.md |
Routing Rules
Flexible requests
| Case | User Intent | Signal Keywords | Action |
|---|
| 1 | Subscribe (lend) | "subscribe", "lend to Simple Earn" | Collect currency/amount/min_rate and confirm, then call gate-cli cex earn uni lend with type: lend. |
| 2 | Redeem | "redeem", "redeem from Simple Earn" | Collect currency/amount and confirm, then call gate-cli cex earn uni lend with type: redeem. |
| 3 | Single-currency position | "my USDT Simple Earn", "position for one currency" | See references/scenarios.md flexible scenario section |
| 4 | All positions | "all Simple Earn positions", "total positions" | See references/scenarios.md flexible scenario section |
| 5 | Single-currency interest | "interest", "USDT interest" | See references/scenarios.md flexible scenario section |
| 6 | Subscribe top APY | "top APY", "one-click subscribe top APY" | Show top APY via gate-cli cex earn uni rate, ask confirmation, then call gate-cli cex earn uni lend. |
| 7 | Change lend settings (e.g. min rate) | "change min_rate", "change Simple Earn settings" | Collect currency/min_rate and confirm, then call gate-cli cex earn uni change. |
| 8 | Auth failure (401/403) | MCP returns 401/403 | Do not expose keys; prompt user to configure Gate CEX API Key (earn). |
Fixed-term requests
| Case | User Intent | Signal Keywords | Action |
|---|
| 1 | All fixed-term products | "fixed-term products" | See references/scenarios.md fixed-term section 1 and references/fixed-earn-mcp-tools.md §1 |
| 2 | Fixed-term products by currency | "USDT fixed-term products" | See references/scenarios.md fixed-term section 2 and references/fixed-earn-mcp-tools.md §2 |
| 3 | Fixed-term subscribe | "subscribe 1 SOL fixed-term" | Collect currency/amount/term and confirm, then call gate-cli cex earn fixed create. |
| 4 | Fixed-term early redeem | "redeem order 5862443199" | Collect order_id and confirm, then call gate-cli cex earn fixed pre-redeem. |
| 5 | Fixed-term total positions | "total fixed-term positions", "current total fixed-term position amount" | Call gate-cli cex earn fixed lends with order_type: "1", page, and limit. |
| 6 | Single fixed-term order detail | "order 5862443199" | Call gate-cli cex earn fixed lends with order_type: "1" and order_id. |
| 7 | Fixed-term history | "subscription records", "redeem records", "interest records" | Call gate-cli cex earn fixed history with type, page, limit, and optional time range. |
| 8 | Compliance / region restriction | region restriction questions | Return the standard compliance error message if the API rejects the request. |
| 9 | Compliance check failure | compliance validation failed | Do not retry or expose internal logic; return the API error message when available. |
Execution
- Identify user intent from the routing rules above.
- For flexible subscribe/redeem/top APY and fixed-term subscribe/early redeem: collect required params, confirm with the user, then call the corresponding MCP tool.
- For flexible or fixed-term read-only queries: read the matching scenario section in
references/scenarios.md and follow the workflow there.
- For auth failures: do not expose API keys or raw errors; prompt the user to configure API key / log in again.
- If the intent is ambiguous, ask a clarifying question before routing.
Domain Knowledge
Flexible (Uni)
- Subscribe (lend) means the user lends a specified amount of a currency to the Simple Earn pool.
- Redeem means the user redeems a specified amount from the pool.
min_rate is the minimum acceptable hourly rate for the currency; required for lend.- Settlement windows: lend and redeem are not allowed in the two minutes before and after each whole hour (use for errors/logic only; do not surface specific clock times or timestamps to the user unless the user explicitly asks when settlement applies).
- User-facing display (flexible only): In any reply based on flexible Uni MCP data, do not show time-related fields—omit timestamps, dates, time-of-day, countdowns, chart time axes, history operation times, and any API field whose purpose is when something occurred. Show only non-time facts (currency, amounts, balances, rates/APY,
interest_status, success/failure). If a tool returns only time-series data (e.g. APY chart), summarize without timestamps (e.g. latest estimated APY only) or skip the series.
Fixed-term
- Subscribe uses only products with
status=2 (subscribing) and show_status=2 (visible).
- Product list queries can be filtered by currency and product type.
- Fixed-term positions and history should be presented using the table formats defined in
references/scenarios.md and references/fixed-earn-mcp-tools.md.
- Early redeem uses the fixed-term order ID and returns the redeemed principal.
Safety Rules
- Always confirm currency, amount, and min_rate (for flexible lend) or currency/amount/term (for fixed-term subscribe) before calling write MCPs.
- Always confirm order_id before calling fixed-term early redeem.
- Do not recommend specific currencies or predict rates.
- Never expose API keys, internal endpoint URLs, or raw error traces to the user.
- Reject negative or zero amounts; validate that the currency is supported.
Error Handling
| Condition | Response |
|---|
| Auth endpoint returns 401/403 | "Please configure your Gate CEX API Key in MCP with earn/account permission." Do not expose keys or internal details. |
| Flexible subscribe/redeem or fixed-term write request fails validation | Validate inputs, confirm details, then call the corresponding write tool. |
| Position or history query fails | "Unable to load positions/history. Please check your API key has earn/account read permission." |
| Empty positions or no rate data | "No positions found." / "No rate data available at the moment." |
Reference Files
- Flexible (Uni) MCP tools:
references/earn-uni-mcp-tools.md
- Fixed-term MCP tools:
references/fixed-earn-mcp-tools.md
- Prompt examples and routing:
references/scenarios.md
