Gate Exchange Simpleearn

Gate Exchange 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 or cex_earn_change_uni_lend. When users ask to subscribe, redeem, or change settings, reply that the feature is currently not supported.

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

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

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.

Available MCP Tools

Routing Rules

Execution

1. Identify user intent from the Routing Rules table above.
2. 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."
3. 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.
4. For Cases 3, 4, 5: Read the corresponding scenario in scenarios.md and follow the workflow (position, interest read-only operations).
5. For Case 8: Do not expose API keys or raw errors; prompt the user to configure API key / log in again.
6. If the user's intent is ambiguous (e.g. missing currency or amount), ask a clarifying question before routing.

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 / Redeem (Case 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."

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

Error Handling

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