← Back to Skills Marketplace
287
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install gate-exchange-simple-earn
Description
Gate Simple Earn management skill. Use when the user asks about flexible or fixed-term savings products. Triggers on 'Simple Earn', 'flexible earn', 'subscri...
README (SKILL.md)
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 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 Server | Status |
|---|---|
| Gate (main) | ✅ Required |
MCP Tools Used
Query Operations (Read-only)
- cex_earn_change_uni_lend
- cex_earn_get_uni_currency
- cex_earn_get_uni_interest
- cex_earn_list_earn_fixed_term_history
- cex_earn_list_earn_fixed_term_lends
- cex_earn_list_earn_fixed_term_products
- cex_earn_list_earn_fixed_term_products_by_asset
- cex_earn_list_uni_rate
- cex_earn_list_user_uni_lends
Execution Operations (Write)
- cex_earn_create_earn_fixed_term_lend
- cex_earn_create_earn_fixed_term_pre_redeem
- cex_earn_create_uni_lend
Authentication
- API Key Required: Yes (see skill doc/runtime MCP deployment)
- Permissions: Earn:Write
- Get API Key: https://www.gate.io/myaccount/profile/api-key/manage
Installation Check
- Required: Gate (main)
- Install: Run installer skill for your IDE
- Cursor:
gate-mcp-cursor-installer - Codex:
gate-mcp-codex-installer - Claude:
gate-mcp-claude-installer - OpenClaw:
gate-mcp-openclaw-installer
- Cursor:
MCP Mode
Read and strictly follow references/mcp.md, then execute this skill's Simple Earn workflow.
SKILL.mdkeeps routing and business constraints.references/mcp.mdis the authoritative MCP execution layer 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 |
|---|---|---|---|
cex_earn_list_uni_rate |
No | Estimated APY per currency (currency enumeration; use with get_uni_currency for limits) | references/earn-uni-mcp-tools.md |
cex_earn_get_uni_currency |
No | Single-currency details (min_rate for subscribe) | references/earn-uni-mcp-tools.md |
cex_earn_create_uni_lend |
Yes | Create lend (subscribe) or redeem | references/earn-uni-mcp-tools.md |
cex_earn_change_uni_lend |
Yes | Change min rate for lend | references/earn-uni-mcp-tools.md |
cex_earn_list_user_uni_lends |
Yes | User positions (optional currency filter) | references/earn-uni-mcp-tools.md |
cex_earn_get_uni_interest |
Yes | Single-currency cumulative interest | references/earn-uni-mcp-tools.md |
cex_earn_list_uni_rate |
No | Estimated APY per currency (for top APY) | references/earn-uni-mcp-tools.md |
Fixed-term
| Tool | Auth | Description | Reference |
|---|---|---|---|
cex_earn_list_earn_fixed_term_products |
No | List all fixed-term products | references/fixed-earn-mcp-tools.md |
cex_earn_list_earn_fixed_term_products_by_asset |
No | List fixed-term products by currency | references/fixed-earn-mcp-tools.md |
cex_earn_create_earn_fixed_term_lend |
Yes | Create fixed-term lend (subscribe) | references/fixed-earn-mcp-tools.md |
cex_earn_create_earn_fixed_term_pre_redeem |
Yes | Early redeem fixed-term order | references/fixed-earn-mcp-tools.md |
cex_earn_list_earn_fixed_term_lends |
Yes | User fixed-term positions | references/fixed-earn-mcp-tools.md |
cex_earn_list_earn_fixed_term_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 cex_earn_create_uni_lend with type: lend. |
| 2 | Redeem | "redeem", "redeem from Simple Earn" | Collect currency/amount and confirm, then call cex_earn_create_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 cex_earn_list_uni_rate, ask confirmation, then call cex_earn_create_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 cex_earn_change_uni_lend. |
| 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 cex_earn_create_earn_fixed_term_lend. |
| 4 | Fixed-term early redeem | "redeem order 5862443199" | Collect order_id and confirm, then call cex_earn_create_earn_fixed_term_pre_redeem. |
| 5 | Fixed-term total positions | "total fixed-term positions", "current total fixed-term position amount" | Call cex_earn_list_earn_fixed_term_lends with order_type: "1", page, and limit. |
| 6 | Single fixed-term order detail | "order 5862443199" | Call cex_earn_list_earn_fixed_term_lends with order_type: "1" and order_id. |
| 7 | Fixed-term history | "subscription records", "redeem records", "interest records" | Call cex_earn_list_earn_fixed_term_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.mdand 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_rateis 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) andshow_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.mdandreferences/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
Usage Guidance
This skill is internally consistent with its stated purpose, but before installing you should: (1) confirm you trust the Gate MCP server instance you will use — that server holds your Gate API key and will perform write actions on your behalf; (2) ensure the API key configured in MCP has only the necessary permissions (Earn:Write only if you want subscribing/redeeming) and is not shared broadly; (3) verify the agent prompts and requires explicit confirmation before any subscribe/redeem/change-rate action (the SKILL.md requires this as an SOP); (4) review the referenced runtime rules (the external GitHub doc) so you understand any additional runtime behaviors or constraints; and (5) if you only want read-only behavior, consider configuring or testing the MCP instance so write tools are unavailable (the skill supports degraded query-only mode). Finally, note the changelog shows an earlier version that disabled write calls — if you have concerns, confirm the current deployed version’s policy on automated writes before granting access.
Capability Analysis
Type: OpenClaw Skill
Name: gate-exchange-simple-earn
Version: 1.0.3
The skill bundle is a legitimate tool for managing Gate.io Simple Earn products (flexible and fixed-term savings). It defines clear workflows for querying rates, positions, and interest, as well as performing financial transactions like subscribing and redeeming funds via MCP tools. The instructions in SKILL.md and references/mcp.md enforce strict safety protocols, including mandatory user confirmation gates for all 'write' operations and explicit prohibitions against exposing API keys or internal system details. No evidence of malicious intent, data exfiltration, or unauthorized execution was found.
Capability Tags
Capability Assessment
Purpose & Capability
The name/description match the MCP toolset and workflows documented in SKILL.md, README, and references. All required operations (list rates/products, query positions/history, create lend/subscribe/redeem, change min_rate) correspond to cex_earn_* tools described in the package. The requirement for an API key is handled by the Gate MCP layer (expected for exchange account actions).
Instruction Scope
The runtime instructions are scoped to MCP tools only and explicitly prohibit calling undocumented tools. They also mandate removing time fields from user-facing output and require explicit user confirmation before write actions. Two points for the user to note: (1) SKILL.md tells the agent to follow external runtime rules (link to a GitHub doc) — that external doc could change behavior and should be reviewed; (2) the package’s changelog contains an earlier entry that temporarily disabled subscribe/redeem, then later re-enabled them — this versioning history could cause confusion about whether write operations are currently allowed. Functionally, the instructions do not request local file reads, unrelated env vars, or data exfiltration.
Install Mechanism
This is an instruction-only skill with no install spec and no code files to execute, so nothing will be written to disk or downloaded when loading the package.
Credentials
The skill declares no environment variables or credentials in the package; account authentication is delegated to the Gate MCP server which stores the Gate API key. That is proportional for a skill that performs account-level financial actions. The skill requires Earn:Write permission (write operations) which is appropriate for subscribe/redeem/change-rate operations — users should ensure the API key provided to MCP has only the permissions they intend to grant.
Persistence & Privilege
always:false and no special privileges or requests to modify other skills or global agent settings. The skill relies on the MCP server to hold credentials; autonomous invocation is allowed by platform default but the skill’s SOP requires explicit confirmation before any write call, reducing risk in practice.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gate-exchange-simple-earn - After installation, invoke the skill by name or use
/gate-exchange-simple-earn - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
- Removed the documentation file: references/earn-uni-api.md.
- No changes were made to skill logic or MCP tool dependencies.
v1.0.2
- Introduced a dedicated references/mcp.md file to define authoritative MCP workflow logic and separation of query/action execution.
- Clarified that SKILL.md now keeps only routing and business constraints; moved MCP execution rules to references/mcp.md.
- Updated description to be more concise and trigger-focused.
- Added instruction to strictly follow references/mcp.md before executing Simple Earn workflows.
- No changes to supported MCP tools, trigger conditions, or routing rules.
v1.0.1
Gate Simple Earn skill now supports both flexible (Uni) and fixed-term workflows:
- Added fixed-term product search, subscribe, redeem, and history workflows.
- Enabled flexible (Uni) subscribe, redeem, and min-rate change operations (was read-only before).
- Added new MCP tool references and documentation for all supported workflows.
- Routing and case tables now support both flexible and fixed-term user intents.
- Updated usage, safety, and error-handling guidance throughout documentation.
v1.0.0
Initial release — provides read-only access to Gate Simple Earn (Uni) flexible products.
- Supports querying Simple Earn positions, interest, and estimated APY per currency.
- Subscribe, redeem, one-click top APY, and change settings (e.g. min_rate) functions are disabled and will return a "not supported" message.
- Only safe, read-only MCP APIs are used; no write operations are performed.
- Comprehensive routing and safety rules ensure no unsupported actions are attempted.
- Shows a disclaimer when displaying APY or interest rate information.
Metadata
Frequently Asked Questions
What is Gate Exchange Simple Earn?
Gate Simple Earn management skill. Use when the user asks about flexible or fixed-term savings products. Triggers on 'Simple Earn', 'flexible earn', 'subscri... It is an AI Agent Skill for Claude Code / OpenClaw, with 287 downloads so far.
How do I install Gate Exchange Simple Earn?
Run "/install gate-exchange-simple-earn" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gate Exchange Simple Earn free?
Yes, Gate Exchange Simple Earn is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gate Exchange Simple Earn support?
Gate Exchange Simple Earn is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gate Exchange Simple Earn?
It is built and maintained by Gate (@gate-exchange); the current version is v1.0.3.
More Skills