Gate Staking Query Suite

General Rules

Read and follow the shared runtime rules before proceeding: → exchange-runtime-rules.md

This skill is the single entry for Gate Exchange staking (on-chain earn) query-only operations. It supports four query modules: positions, rewards, products, order history. User intent is routed to the matching reference and MCP tool.

Module overview

Stake / Redeem (not supported): When the user intends to perform a stake or redeem operation, do not call any tool. Reply that the operation is temporarily not supported and offer query alternatives (e.g. show positions or products).

Mint (not supported): When the user intends to perform a mint operation, do not call any tool. Reply that the operation is temporarily not supported and offer query alternatives.

Domain Knowledge

Product types

Redeemable amount calculation

The redeemable amount for a position is not mortgage_amount − freeze_amount. The correct formula is:

redeemable = mortgage_amount × exchangeRate

Where exchangeRate comes from cex_earn_find_coin for the same pid and matching currency. Some products have exchangeRate = 1 (e.g. USDT flexible), while others vary (e.g. liquid staking tokens).

Reward distribution

• reward_delay_days = -1 means the reward is paid on redeem, not periodically.
• interest_delay_days indicates the delay after staking before rewards start accruing (typically 1 day / T+1).
• Multi-coin rewards: a single position can generate rewards in multiple coins (e.g. stake USDT in Compound V3, receive USDT + COMP).

Number formatting

Routing rules

Execution

1. Intent and parameters

• Determine module (Positions / Rewards / Products / Order history) or whether the user intends to perform stake/redeem or mint.
• Stake / Redeem intent: If the user clearly wants to execute a stake or redeem—e.g. "stake 1 BTC", "stake 100 USDT", "redeem", "I want to stake", "help me redeem"—do not call any MCP tool. Reply with the not supported message (see Safety rules) and offer to query positions or products instead. Then stop.
• Mint intent: If the user clearly wants to execute a mint—e.g. "mint", "I want to mint", "mint GT", "help me mint"—do not call any MCP tool. Reply with the not supported message (see Safety rules) and offer to query positions or products instead. Then stop.
• Extract: coin, pid, page; for order list also type (0=stake, 1=redeem).
• Missing: if user says "my staking" without specifying positions/rewards/products/history, ask which one or show positions by default.

2. Tool selection

• Positions: When showing redeemable amount, call cex_earn_find_coin (optionally with cointype), find the product with same pid and matching currency as each position; use that item’s exchangeRate (or exchangeRateReserve per API). Redeemable = mortgage_amount × that rate. Do not use mortgage_amount − freeze_amount.
• Response structures: Positions → array of items (pid, mortgage_coin, mortgage_amount, freeze_amount, income_total, yesterday_income / yesterday_income_multi, etc.). Redeemable is not mortgage_amount − freeze_amount; redeemable = mortgage_amount × exchange rate, where exchange rate comes from cex_earn_find_coin for the same pid and matching currency (coin). Order list → object with page, pageSize, pageCount, totalCount, list[]. Reward list → object with page, pageSize, pageCount, totalCount, list[] (pid, mortgage_coin, reward_coin, interest, bonus_date, etc.). Products → array (pid, currency, estimateApr, minStakeAmount, protocolName, redeemPeriod, productType, isDefi, currencyRewards, exchangeRate, etc.).

3. Format response

• Use the Response Template and field names from the reference file for the chosen module.
• Positions: show mortgage_amount, freeze_amount, redeemable (mortgage_amount × exchange rate; get exchange rate from cex_earn_find_coin for the same pid and matching currency), income_total, yesterday_income; group by coin or show per pid. Do not use mortgage_amount − freeze_amount for redeemable.
• Rewards: show list entries with reward_coin, interest, bonus_date, pid, mortgage_coin; sum by reward_coin; use totalCount/page/pageCount when relevant.
• Products: show protocolName, currency, estimateApr, minStakeAmount, maxStakeAmount, redeemPeriod, productType, isDefi; sort by estimateApr or filter by cointype.
• Order history: show list with coin, amount, type (0=Stake, 1=Redeem), createStamp, status, pid, fee; use totalCount, page, pageCount for pagination.

Report template

After each query, output a short standardized result consistent with the reference (e.g. positions summary, reward summary, product table, or order list). Use the exact response fields from the API (see references) so the user sees correct field names and values.

Safety rules

Read-only

• This skill does not perform stake, redeem, or mint. Only query tools are used.
• Stake / Redeem intent: When the user asks to perform a stake or redeem, reply in English: "Staking and redemption are not supported here; please use the Gate website or app. I can help you query positions or products." Do not call any tool. Optionally offer to show current positions (cex_earn_asset_list) or available products (cex_earn_find_coin).
• Mint intent: When the user asks to perform a mint, reply in English: "Mint is not supported here; please use the Gate website or app. I can help you query positions or products." Do not call any tool. Optionally offer to show positions or products.

Errors