← 返回 Skills 市场
gate-exchange

Gate Exchange Simple Earn

作者 Gate · GitHub ↗ · v1.0.3 · MIT-0
cross-platform ✓ 安全检测通过
287
总下载
0
收藏
0
当前安装
4
版本数
在 OpenClaw 中安装
/install 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...
使用说明 (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

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

MCP Mode

Read and strictly follow references/mcp.md, then execute this skill's Simple Earn workflow.

  • SKILL.md keeps routing and business constraints.
  • references/mcp.md is 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

  1. Identify user intent from the routing rules above.
  2. 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.
  3. For flexible or fixed-term read-only queries: read the matching scenario section in references/scenarios.md and follow the workflow there.
  4. For auth failures: do not expose API keys or raw errors; prompt the user to configure API key / log in again.
  5. 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
安全使用建议
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.
功能分析
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.
能力标签
crypto
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install gate-exchange-simple-earn
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /gate-exchange-simple-earn 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
Slug gate-exchange-simple-earn
版本 1.0.3
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 4
常见问题

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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 287 次。

如何安装 Gate Exchange Simple Earn?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install gate-exchange-simple-earn」即可一键安装,无需额外配置。

Gate Exchange Simple Earn 是免费的吗?

是的,Gate Exchange Simple Earn 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Gate Exchange Simple Earn 支持哪些平台?

Gate Exchange Simple Earn 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Gate Exchange Simple Earn?

由 Gate(@gate-exchange)开发并维护,当前版本 v1.0.3。

💬 留言讨论