gate-exchange-simpleearn

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Gate Exchange Simple Earn Skill

Gate交易所Simple Earn Skill

Provide Simple Earn (Uni) flexible read operations on Gate: single-currency or all positions query, single-currency interest query, and estimated APY (rate) query. Subscribe (lend), redeem, and change_uni_lend are disabled—do not call

cex_earn_create_uni_lend

cex_earn_change_uni_lend

. When users ask to subscribe, redeem, or change settings, reply that the feature is currently not supported.

提供Gate平台上Simple Earn（Uni）的灵活只读操作：单币种或全持仓查询、单币种收益查询以及预估APY（利率）查询。订阅（出借）、赎回及change_uni_lend功能已禁用——请勿调用

cex_earn_create_uni_lend

或

cex_earn_change_uni_lend

接口。当用户请求订阅、赎回或修改设置时，请回复该功能目前暂不支持。

Trigger Conditions

触发条件

Activate this skill when the user expresses any of the following intents:

Simple Earn, Uni, subscribe, redeem, positions, interest, top APY, one-click subscribe top APY
Any request involving Simple Earn subscribe, redeem, position query, or interest query

当用户表达以下任一意图时，激活本Skill：

提及Simple Earn、Uni、subscribe、redeem、positions、interest、top APY、一键订阅最高APY
任何涉及Simple Earn订阅、赎回、持仓查询或收益查询的请求

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."

MCP依赖：需要安装gate-mcp。
身份验证：持仓查询及写入操作需要API密钥验证；利率及币种查询为公开接口。
免责声明：展示APY或利率时，必须附加以下内容：“本信息仅供参考，不构成投资建议。APY可能发生变动，请在订阅前了解产品条款。”

Service Restrictions (Current)

当前服务限制

Do not call subscribe or redeem APIs in any form: This skill must not call
```
cex_earn_create_uni_lend
```
for subscribe (
```
type: lend
```
) or redeem (
```
type: redeem
```
). Regardless of user confirmation or provided amount/currency, calling this API is forbidden. When the user requests subscribe, redeem, or one-click subscribe top APY, reply only: "Simple Earn subscribe and redeem are currently not supported." Position query, interest query, and rate query (read-only) are unaffected.
Do not call the change-lend API in any form: This skill must not call
```
cex_earn_change_uni_lend
```
(e.g. change min rate). Regardless of user confirmation or provided currency/min_rate, calling this API is forbidden. When the user requests changing Simple Earn settings (e.g. min rate), reply that the operation is not supported and do not call MCP.

禁止以任何形式调用订阅或赎回接口：本Skill严禁调用
```
cex_earn_create_uni_lend
```
进行订阅（
```
type: lend
```
）或赎回（
```
type: redeem
```
）操作。无论用户是否确认或提供金额/币种，调用该接口均属违规。当用户请求订阅、赎回或一键订阅最高APY时，仅回复：“Simple Earn订阅和赎回功能目前暂不支持。” 持仓查询、收益查询及利率查询（只读操作）不受影响。
禁止以任何形式调用修改出借设置接口：本Skill严禁调用
```
cex_earn_change_uni_lend
```
（例如修改最低利率）。无论用户是否确认或提供币种/最低利率，调用该接口均属违规。当用户请求修改Simple Earn设置（如最低利率）时，回复该操作暂不支持，且请勿调用MCP接口。

Available MCP Tools

可用MCP工具

Tool	Auth	Description	Reference
`cex_earn_list_uni_currencies`	No	List Simple Earn currencies (min_rate, min_lend_amount, etc.)	earn-uni-api.md
`cex_earn_get_uni_currency`	No	Single-currency details (min_rate for subscribe)	earn-uni-api.md
`cex_earn_create_uni_lend`	Yes	Do not use for subscribe/redeem; API reference only, do not call	earn-uni-api.md
`cex_earn_change_uni_lend`	Yes	Do not call in any form; API reference only, do not call	earn-uni-api.md
`cex_earn_list_user_uni_lends`	Yes	User positions (optional currency filter)	earn-uni-api.md
`cex_earn_get_uni_interest`	Yes	Single-currency cumulative interest	earn-uni-api.md
`cex_earn_list_uni_rate`	No	Estimated APY per currency (for top APY)	earn-uni-api.md

工具	需要验证	描述	参考文档
`cex_earn_list_uni_currencies`	否	列出Simple Earn支持的币种（包含最低利率、最低出借金额等信息）	earn-uni-api.md
`cex_earn_get_uni_currency`	否	查询单币种详情（包含订阅所需的最低利率）	earn-uni-api.md
`cex_earn_create_uni_lend`	是	请勿用于订阅/赎回；仅作为API参考，禁止调用	earn-uni-api.md
`cex_earn_change_uni_lend`	是	禁止以任何形式调用；仅作为API参考，禁止调用	earn-uni-api.md
`cex_earn_list_user_uni_lends`	是	查询用户持仓（可按币种筛选）	earn-uni-api.md
`cex_earn_get_uni_interest`	是	查询单币种累计收益	earn-uni-api.md
`cex_earn_list_uni_rate`	否	查询各币种预估APY（用于筛选最高APY币种）	earn-uni-api.md

Routing Rules

路由规则

Case	User Intent	Signal Keywords	Action
1	Subscribe (lend)	"subscribe", "lend to Simple Earn"	Disabled: Tell user "Simple Earn subscribe and redeem are currently not supported." Do not call MCP.
2	Redeem	"redeem", "redeem from Simple Earn"	Disabled: Tell user "Simple Earn subscribe and redeem are currently not supported." Do not call MCP.
3	Single-currency position	"my USDT Simple Earn", "position for one currency"	See scenarios.md Scenario 3
4	All positions	"all Simple Earn positions", "total positions"	See scenarios.md Scenario 4
5	Single-currency interest	"interest", "USDT interest"	See scenarios.md Scenario 5
6	Subscribe top APY	"top APY", "one-click subscribe top APY"	Disabled: Tell user "Simple Earn subscribe and redeem are currently not supported." Do not call MCP.
7	Change lend settings (e.g. min rate)	"change min_rate", "change Simple Earn settings"	Disabled: Do not call `cex_earn_change_uni_lend` ; tell user the operation is not supported.
8	Auth failure (401/403)	MCP returns 401/403	Do not expose keys; prompt user to configure Gate CEX API Key (earn).

场景	用户意图	触发关键词	操作
1	订阅（出借）	"subscribe"、"lend to Simple Earn"	已禁用：回复用户“Simple Earn订阅和赎回功能目前暂不支持。” 请勿调用MCP接口。
2	赎回	"redeem"、"redeem from Simple Earn"	已禁用：回复用户“Simple Earn订阅和赎回功能目前暂不支持。” 请勿调用MCP接口。
3	单币种持仓查询	"我的USDT Simple Earn持仓"、"单币种持仓查询"	参考scenarios.md场景3
4	全持仓查询	"所有Simple Earn持仓"、"总持仓查询"	参考scenarios.md场景4
5	单币种收益查询	"收益查询"、"USDT收益"	参考scenarios.md场景5
6	订阅最高APY币种	"top APY"、"一键订阅最高APY币种"	已禁用：回复用户“Simple Earn订阅和赎回功能目前暂不支持。” 请勿调用MCP接口。
7	修改出借设置（如最低利率）	"change min_rate"、"修改Simple Earn设置"	已禁用：请勿调用 `cex_earn_change_uni_lend` ；回复用户该操作暂不支持，且请勿调用MCP接口。
8	身份验证失败（401/403）	MCP返回401/403错误	请勿暴露密钥；提示用户配置Gate CEX API密钥（需包含earn权限）。

Execution

执行流程

Identify user intent from the Routing Rules table above.
For Cases 1, 2, 6 (subscribe/redeem/one-click subscribe top APY): Do not call
```
cex_earn_create_uni_lend
```
(regardless of user confirmation). Reply only: "Simple Earn subscribe and redeem are currently not supported."
For Case 7 (change lend/min rate): Do not call
```
cex_earn_change_uni_lend
```
(regardless of user confirmation). Reply that the operation is not supported; do not call MCP.
For Cases 3, 4, 5: Read the corresponding scenario in scenarios.md and follow the workflow (position, interest read-only operations).
For Case 8: Do not expose API keys or raw errors; prompt the user to configure API key / log in again.
If the user's intent is ambiguous (e.g. missing currency or amount), ask a clarifying question before routing.

根据上述路由规则识别用户意图。
对于场景1、2、6（订阅/赎回/一键订阅最高APY）：请勿调用
```
cex_earn_create_uni_lend
```
接口（无论用户是否确认）。仅回复：“Simple Earn订阅和赎回功能目前暂不支持。”
对于场景7（修改出借/最低利率）：请勿调用
```
cex_earn_change_uni_lend
```
接口（无论用户是否确认）。回复用户该操作暂不支持，且请勿调用MCP接口。
对于场景3、4、5：查阅scenarios.md中的对应场景并遵循工作流程（持仓、收益只读操作）。
对于场景8：请勿暴露API密钥或原始错误信息；提示用户配置API密钥/重新登录。
如果用户意图不明确（例如缺少币种或金额），在路由前先询问澄清问题。

Domain Knowledge

领域知识

Core Concepts

核心概念

Subscribe (lend): User lends a specified amount of a currency to the Simple Earn pool. Interest is paid at each settlement time; min_rate from currency details should be passed to avoid rejections.
Redeem: User redeems a specified amount from the pool. Redeemed funds arrive at the next settlement time; interest for the current period is still credited.
min_rate: Minimum acceptable hourly rate for the currency (concept only; this skill does not perform subscribe, so do not call create_uni_lend).
est_rate: Estimated APY from
```
cex_earn_list_uni_rate
```
; used to pick the top APY currency. Not guaranteed; for reference only.
Interest: Cumulative interest for a currency from
```
cex_earn_get_uni_interest
```
.
Settlement windows: Lend and redeem are not allowed in the two minutes before and after each whole hour (platform settlement); failed subscribe funds return immediately.

Subscribe（出借）：用户将指定金额的某一币种出借至Simple Earn资金池。收益在每个结算时间点发放；需传入币种详情中的min_rate以避免请求被拒绝。
Redeem（赎回）：用户从资金池中赎回指定金额的币种。赎回资金将在下一个结算时间点到账；当期收益仍会正常发放。
min_rate：币种的最低可接受小时利率（仅为概念说明；本Skill不支持订阅操作，因此请勿调用create_uni_lend接口）。
est_rate：从
```
cex_earn_list_uni_rate
```
接口获取的预估APY；用于筛选最高APY币种。该数据不保证准确，仅供参考。
Interest（收益）：从
```
cex_earn_get_uni_interest
```
接口获取的单币种累计收益。
结算窗口期：每个整点前后两分钟为平台结算时间，期间不允许进行出借和赎回操作；订阅失败的资金将立即退回。

Subscribe / Redeem (Case 1, 2, 6)

订阅/赎回（场景1、2、6）

Do not call subscribe/redeem API. Do not show subscribe/redeem draft; do not call

cex_earn_create_uni_lend

(whether type is lend or redeem). Reply only: "Simple Earn subscribe and redeem are currently not supported."

请勿调用订阅/赎回接口。请勿展示订阅/赎回草稿；请勿调用

cex_earn_create_uni_lend

接口（无论type参数为lend还是redeem）。仅回复：“Simple Earn订阅和赎回功能目前暂不支持。”

Safety Rules

安全规则

Subscribe/redeem: Do not call
```
cex_earn_create_uni_lend
```
for subscribe or redeem; reply not supported. This skill does not provide any subscribe/redeem API calls.
Change lend: Do not call
```
cex_earn_change_uni_lend
```
in any form (e.g. change min rate); reply not supported; do not call MCP.
No investment advice: Do not recommend specific currencies or predict rates. Present data (e.g. top APY from list_uni_rate) and let the user decide.
Sensitive data: Never expose API keys, internal endpoint URLs, or raw error traces to the user.
Amount and currency: Reject negative or zero amounts; validate currency is supported (e.g. from list_uni_currencies or get_uni_currency).

订阅/赎回：严禁调用
```
cex_earn_create_uni_lend
```
进行订阅或赎回操作；回复用户该功能暂不支持。本Skill不提供任何订阅/赎回接口调用服务。
修改出借设置：严禁以任何形式调用
```
cex_earn_change_uni_lend
```
接口（例如修改最低利率）；回复用户该操作暂不支持，且请勿调用MCP接口。
不提供投资建议：请勿推荐特定币种或预测利率。仅展示数据（例如从list_uni_rate接口获取的最高APY币种），由用户自行决策。
敏感数据保护：切勿向用户暴露API密钥、内部端点URL或原始错误追踪信息。
金额与币种验证：拒绝负数或零金额；验证币种是否受支持（例如通过list_uni_currencies或get_uni_currency接口确认）。

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.
User requests subscribe/redeem	Do not call API; reply "Simple Earn subscribe and redeem are currently not supported."
User requests change lend (e.g. min rate)	Do not call `cex_earn_change_uni_lend` ; reply that the operation is not supported.
`cex_earn_list_user_uni_lends` or `cex_earn_get_uni_interest` fails	"Unable to load positions/interest. 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."

条件	响应内容
身份验证接口返回401/403错误	“请在MCP中配置具备earn/account权限的Gate CEX API密钥。” 请勿暴露密钥或内部细节。
用户请求订阅/赎回	请勿调用接口；回复“Simple Earn订阅和赎回功能目前暂不支持。”
用户请求修改出借设置（如最低利率）	请勿调用 `cex_earn_change_uni_lend` 接口；回复该操作暂不支持。
`cex_earn_list_user_uni_lends` 或 `cex_earn_get_uni_interest` 接口调用失败	“无法加载持仓/收益信息，请检查您的API密钥是否具备earn/account只读权限。”
无持仓数据或无利率数据	“未找到持仓信息。” / “目前暂无利率数据可用。”

Prompt Examples & Scenarios

提示示例与场景

See scenarios.md for full prompt examples and expected behaviors covering all six scenarios (subscribe, redeem, single-currency position, all positions, single-currency interest, subscribe top APY).

请查阅scenarios.md获取完整的提示示例及预期行为，涵盖所有六个场景（订阅、赎回、单币种持仓、全持仓、单币种收益、订阅最高APY）。