gate-exchange-launchpool

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Gate LaunchPool Suite

Gate LaunchPool 工具套件

General Rules

通用规则

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

This skill is the single entry for Gate Exchange LaunchPool operations. It supports five modules: project browsing, staking, redemption, pledge records, and reward records. User intent is routed to the matching reference and MCP tool.
在操作前请阅读并遵循共享运行时规则: → exchange-runtime-rules.md

本功能是Gate交易所LaunchPool操作的唯一入口,支持五大模块:项目浏览、质押、赎回、质押记录、奖励记录。用户的需求会被路由至对应的参考文档与MCP工具。

Module overview

模块概述

ModuleDescriptionTrigger keywords
ProjectsBrowse LaunchPool project list, filter by status/APR/coin/pool type
projects
,
activities
,
events
,
ongoing
,
ended
,
warming up
,
APY
,
APR
,
which LaunchPool
StakeStake tokens to a LaunchPool project
stake
,
participate
,
join
,
pledge
,
contribute
,
put in
RedeemEarly redeem staked assets from a project
redeem
,
withdraw
,
unstake
,
take out
,
exit
,
pull out
Pledge RecordsQuery staking/redemption participation history
pledge records
,
participation history
,
staking records
,
my LaunchPool history
Reward RecordsQuery airdrop reward distribution history
airdrop
,
rewards
,
earnings
,
reward records
,
airdrop history
,
LaunchPool income
模块说明触发关键词
项目浏览LaunchPool项目列表,可按状态/年化收益率(APR)/币种/池子类型筛选
projects
activities
events
ongoing
ended
warming up
APY
APR
which LaunchPool
质押向LaunchPool项目质押代币
stake
participate
join
pledge
contribute
put in
赎回提前从项目中赎回质押资产
redeem
withdraw
unstake
take out
exit
pull out
质押记录查询质押/赎回参与历史
pledge records
participation history
staking records
my LaunchPool history
奖励记录查询空投奖励发放历史
airdrop
rewards
earnings
reward records
airdrop history
LaunchPool income

Domain Knowledge

领域知识

LaunchPool concepts

LaunchPool 相关概念

ConceptDescription
LaunchPoolA platform feature where users stake existing tokens to earn new token airdrops. Projects have a fixed staking period.
Project (pid)A LaunchPool campaign for a specific new token. Has start/end time, total reward pool, and staking rules.
Reward Pool (rid)Within a project, different reward pools exist for different staking coins (e.g. USDT pool, BTC pool). Each has its own estimated APR.
Staking PeriodThe duration during which users can stake and earn rewards. After the period ends, rewards are distributed.
Estimated APR
rate_year
— the estimated Annual Percentage Rate (simple, no compounding) for a reward pool. Users may say "APY" colloquially; always display as "Estimated APR" in output.
Newbie PoolSpecial pool with lower entry requirements or bonus rewards for new users (
limit_rule=1
).
Normal PoolStandard staking pool open to all users (
limit_rule=0
).
Status (
project_state
)
Project lifecycle: Warming up (2) → In progress (1) → Ended (3). The request param
status
also supports 0 (All) and 4 (In progress + Warming up).
Personal LimitMaximum/minimum staking amount per user per reward pool (
personal_max_amount
/
personal_min_amount
).
Transaction ConfigTiered participation conditions based on the user's 60-day total trading volume (in USD). Each tier defines a
transaction_amount
threshold and a corresponding
mortgage_limit
(personal staking cap, unit follows the reward pool's staking
coin
). If the user's trading volume is below the lowest tier, the staking limit is 0 (not eligible to participate). The
transaction_config
array is optional — only some reward pools have it.
概念说明
LaunchPool平台功能,用户质押现有代币以赚取新代币空投。项目设有固定质押周期。
项目(pid)针对特定新代币的LaunchPool活动,包含开始/结束时间、总奖励池及质押规则。
奖励池(rid)单个项目内,不同质押币种对应不同奖励池(如USDT池、BTC池),每个池子有独立的预估年化收益率(APR)。
质押周期用户可质押并赚取奖励的时间段。周期结束后,奖励将发放。
预估年化收益率(Estimated APR)
rate_year
— 奖励池的预估年化收益率(单利,不复利)。用户可能口语化使用“APY”,但输出时需统一显示为“Estimated APR”。
新手池(Newbie Pool)面向新用户的特殊池子,准入要求更低或有奖励加成(
limit_rule=1
)。
普通池(Normal Pool)面向所有用户的标准质押池(
limit_rule=0
)。
状态(
project_state
项目生命周期:预热中(2) → 进行中(1) → 已结束(3)。请求参数
status
还支持0(全部)和4(进行中+预热中)。
个人限额每个用户在单个奖励池中的最大/最小质押额度(
personal_max_amount
/
personal_min_amount
)。
交易配置根据用户60天累计交易量(美元计价)设置的分层参与条件。每个层级定义了
transaction_amount
阈值及对应的
mortgage_limit
(个人质押上限,单位与奖励池质押币种一致)。若用户交易量低于最低层级,质押限额为
0
(无参与资格)。
transaction_config
数组为可选字段 — 仅部分奖励池包含该配置。

Timestamp formatting

时间戳格式

The
create_timest
and
reward_timest
fields in pledge/reward records are pre-formatted strings from the API (e.g. "2026-03-16 09:32:22"). Display them as-is in the data row and put
(UTC)
in the table header instead of appending to each value.
Project time fields (
start_timest
,
end_timest
) are internal data — do NOT display them to the user.
Reward records time params: The reward records API requires
start_time
/
end_time
as integer unix timestamps, which are error-prone to calculate. Follow the Timestamp strategy in
references/records.md
(Strategy 1: skip time params for recent queries; Strategy 2: use anchor table for historical ranges). Do NOT attempt to mentally compute unix timestamps without the anchor table.
质押/奖励记录中的
create_timest
reward_timest
字段为API返回的预格式化字符串(如"2026-03-16 09:32:22")。在数据行中直接显示该值,并在表格表头标注
(UTC)
,无需为每个值添加后缀。
项目时间字段(
start_timest
end_timest
)为内部数据 — 请勿向用户展示
奖励记录时间参数:奖励记录API要求
start_time
/
end_time
整数型Unix时间戳,手动计算易出错。请遵循
references/records.md
中的时间戳策略(策略1:近期查询跳过时间参数;策略2:使用锚点表查询历史区间)。若无锚点表,请勿尝试手动计算Unix时间戳。

Number formatting

数字格式

CategoryPrecisionExamples
Amounts (staking, redeem, rewards)8 decimals, trailing zeros removed
1.23
not
1.23000000
Rate fields (Estimated APR)2 decimals, trailing zeros retained
5.20%
not
5.2%
类别精度要求示例
金额(质押、赎回、奖励)保留8位小数,移除末尾零
1.23
而非
1.23000000
利率字段(Estimated APR)保留2位小数,末尾零需保留
5.20%
而非
5.2%

Routing rules

路由规则

IntentExample phrasesRoute to
Browse projects"Show LaunchPool projects", "What LaunchPool events are ongoing?", "Highest APR LaunchPool", "Any USDT LaunchPool?", "Newbie pool projects"Read
references/launch-projects.md
Stake"Stake 500 USDT to LaunchPool BTC project", "I want to participate in LaunchPool", "Put 1000 USDT into LaunchPool"Read
references/stake-redeem.md
(Stake section)
Redeem"Redeem my LaunchPool BTC stake", "Withdraw from LaunchPool", "Unstake my USDT from LaunchPool"Read
references/stake-redeem.md
(Redeem section)
Pledge records"My LaunchPool participation last month", "Show my LaunchPool staking records", "Check my BTC LaunchPool pledge history"Read
references/records.md
(Part 1: Pledge Records)
Reward records"My LaunchPool airdrop rewards", "Check LaunchPool earnings this month", "Show my BTC LaunchPool airdrop"Read
references/records.md
(Part 2: Reward Records)
Unclear"LaunchPool", "launch pool"Clarify: projects / stake / redeem / pledge records / reward records, then route
意图示例语句路由至
浏览项目"显示LaunchPool项目"、"当前有哪些LaunchPool活动?"、"年化收益率最高的LaunchPool"、"有没有USDT的LaunchPool?"、"新手池项目"阅读
references/launch-projects.md
质押"向LaunchPool BTC项目质押500 USDT"、"我想参与LaunchPool"、"将1000 USDT存入LaunchPool"阅读
references/stake-redeem.md
(质押章节)
赎回"赎回我在LaunchPool BTC项目的质押"、"从LaunchPool中提取资产"、"赎回我在LaunchPool中的USDT质押"阅读
references/stake-redeem.md
(赎回章节)
质押记录"我上个月的LaunchPool参与记录"、"显示我的LaunchPool质押记录"、"查询我的BTC LaunchPool质押历史"阅读
references/records.md
(第一部分:质押记录)
奖励记录"我的LaunchPool空投奖励"、"查询本月LaunchPool收益"、"显示我的BTC LaunchPool空投"阅读
references/records.md
(第二部分:奖励记录)
不明确"LaunchPool"、"launch pool"澄清:项目/质押/赎回/质押记录/奖励记录,再进行路由

Execution

执行流程

1. Intent and parameters

1. 意图与参数

  • Determine module (Projects / Stake / Redeem / Pledge Records / Reward Records).
  • Stake intent: If the user wants to stake tokens, route to
    references/stake-redeem.md
    Stake section. Requires project identification + amount + user confirmation.
  • Redeem intent: If the user wants to redeem, route to
    references/stake-redeem.md
    Redeem section. Requires project identification + amount + user confirmation.
  • Extract parameters:
    coin
    ,
    pid
    ,
    rid
    ,
    amount
    ,
    status
    ,
    sort_type
    ,
    limit_rule
    ,
    page
    ,
    start_time
    ,
    end_time
    .
  • Missing: if user says "LaunchPool" without specifying intent, ask which operation or show projects by default.
  • 确定模块(项目/质押/赎回/质押记录/奖励记录)。
  • 质押意图:若用户需质押代币,路由至
    references/stake-redeem.md
    的质押章节。需确认项目信息、金额及用户确认。
  • 赎回意图:若用户需赎回资产,路由至
    references/stake-redeem.md
    的赎回章节。需确认项目信息、金额及用户确认。
  • 提取参数:
    coin
    pid
    rid
    amount
    status
    sort_type
    limit_rule
    page
    start_time
    end_time
  • 参数缺失:若用户仅提及"LaunchPool"未明确意图,需询问具体操作类型,或默认展示项目列表。

2. Tool selection

2. 工具选择

ModuleMCP toolRequired paramsOptional params
Projects
cex_launch_list_launch_pool_projects
page
,
page_size
status
,
sort_type
,
mortgage_coin
,
search_coin
,
limit_rule
Stake
cex_launch_create_launch_pool_order
body
(JSON: pid, rid, amount)
Redeem
cex_launch_redeem_launch_pool
body
(JSON: pid, rid, amount)
Pledge Records
cex_launch_list_launch_pool_pledge_records
coin
,
type
,
start_time
,
end_time
,
page
,
page_size
Reward Records
cex_launch_list_launch_pool_reward_records
page
,
page_size
coin
,
status
,
start_time
,
end_time
  • Stake: First call
    cex_launch_list_launch_pool_projects
    to identify the target project pid and reward pool rid, then show preview, wait for confirmation, then call
    cex_launch_create_launch_pool_order
    .
  • Redeem: Show preview of the redemption, wait for confirmation, then call
    cex_launch_redeem_launch_pool
    .
模块MCP工具必填参数可选参数
项目
cex_launch_list_launch_pool_projects
page
page_size
status
sort_type
mortgage_coin
search_coin
limit_rule
质押
cex_launch_create_launch_pool_order
body
(JSON格式:pid、rid、amount)
赎回
cex_launch_redeem_launch_pool
body
(JSON格式:pid、rid、amount)
质押记录
cex_launch_list_launch_pool_pledge_records
coin
type
start_time
end_time
page
page_size
奖励记录
cex_launch_list_launch_pool_reward_records
page
page_size
coin
status
start_time
end_time
  • 质押:先调用
    cex_launch_list_launch_pool_projects
    确定目标项目的pid和奖励池的rid,展示预览,等待用户确认后,再调用
    cex_launch_create_launch_pool_order
  • 赎回:先展示赎回预览,等待用户确认后,再调用
    cex_launch_redeem_launch_pool

3. Format response

3. 响应格式

  • Use the Response Template and field names from the reference file for the chosen module.
  • Projects: show
    name
    ,
    project_state
    ,
    total_amount
    ,
    days
    , and per reward pool:
    coin
    ,
    rate_year
    ,
    already_buy_total_amount
    ,
    personal_max_amount
    /
    personal_min_amount
    ,
    transaction_config
    . Do NOT display
    start_timest
    /
    end_timest
    ,
    pid
    , or
    rid
    .
  • Stake/Redeem: show order preview first, then confirmation result. Stake returns
    flow_id
    ; Redeem returns
    success
    boolean.
  • Pledge Records: show
    create_timest
    ,
    reward_coin
    ,
    coin
    ,
    amount
    ,
    type
    (1=Stake, 2=Redeem). Note: API does not return project name.
  • Reward Records: show
    reward_timest
    ,
    coin
    (reward coin),
    valid_mortgage_amount
    ,
    amount_base
    ,
    amount_ext
    . Note: API does not return project name.
  • 使用对应模块参考文件中的响应模板与字段名称。
  • 项目:展示
    name
    project_state
    total_amount
    days
    ,以及每个奖励池的
    coin
    rate_year
    already_buy_total_amount
    personal_max_amount
    /
    personal_min_amount
    transaction_config
    请勿展示
    start_timest
    /
    end_timest
    pid
    rid
  • 质押/赎回:先展示订单预览,再展示确认结果。质押返回
    flow_id
    ;赎回返回
    success
    布尔值。
  • 质押记录:展示
    create_timest
    reward_coin
    coin
    amount
    type
    (1=质押,2=赎回)。注意:API不返回项目名称。
  • 奖励记录:展示
    reward_timest
    coin
    (奖励币种)、
    valid_mortgage_amount
    amount_base
    amount_ext
    。注意:API不返回项目名称。

Report template

报告模板

After each operation, output a short standardized result consistent with the reference (e.g. project list table, stake confirmation, redeem confirmation, pledge record list, reward record list). Use the exact response fields from the API (see references) so the user sees correct field names and values.
Language adaptation: Always respond in the same language as the user's input. The Response Templates in reference files define the structure and fields to display, not the literal output language. Translate all display labels to match the user's language.
Do NOT translate (keep as-is regardless of language):
  • Product name:
    LaunchPool
  • Currency symbols from API: USDT, GT, BTC, DOGE, etc.
  • Project names from API
    name
    field (e.g. "DOGE", "USDT-rudy")
  • Technical IDs and their values: pid, rid, flow_id (internal use only, do NOT display to user)
  • Timestamp format including the
    (UTC)
    suffix
  • API error labels: INVALID_PARAM_VALUE, INSUFFICIENT_BALANCE, INVALID_CREDENTIALS, PROJECT_NOT_FOUND
  • Numeric values, percentages, and the unit
    USD
    in trading volume thresholds
All other display labels should be translated to match the user's language.
每次操作后,输出符合参考文件的简短标准化结果(如项目列表表格、质押确认、赎回确认、质押记录列表、奖励记录列表)。使用API返回的准确响应字段(见参考文件),确保用户看到正确的字段名称与值。
语言适配:始终使用与用户输入相同的语言进行响应。参考文件中的响应模板定义了展示结构与字段,而非字面输出语言。所有展示标签需翻译为用户使用的语言。
以下内容请勿翻译(无论使用何种语言均保持原样):
  • 产品名称:
    LaunchPool
  • API返回的币种符号:USDT、GT、BTC、DOGE等
  • API
    name
    字段中的项目名称(如"DOGE"、"USDT-rudy")
  • 技术ID及其值:pid、rid、flow_id(仅内部使用,请勿向用户展示
  • 时间戳格式及
    (UTC)
    后缀
  • API错误标签:INVALID_PARAM_VALUE、INSUFFICIENT_BALANCE、INVALID_CREDENTIALS、PROJECT_NOT_FOUND
  • 数值、百分比及交易量阈值中的单位
    USD
所有其他展示标签需翻译为用户使用的语言。

Error Handling

错误处理

API error labels

API错误标签

The API returns structured errors with a
label
field. Map them as follows:
API labelUser-facing message
INVALID_PARAM_VALUE
"Invalid request parameters. Please check your input and try again."
INVALID_CREDENTIALS
"Please log in to access LaunchPool features."
INSUFFICIENT_BALANCE
"Insufficient balance. Please top up first."
PROJECT_NOT_FOUND
"The specified LaunchPool project was not found."
API返回带
label
字段的结构化错误,映射如下:
API标签用户可见提示
INVALID_PARAM_VALUE
"请求参数无效,请检查输入后重试。"
INVALID_CREDENTIALS
"请登录以访问LaunchPool功能。"
INSUFFICIENT_BALANCE
"余额不足,请先充值。"
PROJECT_NOT_FOUND
"未找到指定的LaunchPool项目。"

Empty result handling

空结果处理

ScenarioAction
Empty project list"No LaunchPool projects match your criteria. Try different filters or check back later."
Empty pledge records"You have no LaunchPool participation records. Browse active projects to get started."
Empty reward records"No airdrop rewards found. Rewards are typically distributed after the staking period ends."
Compliance restriction"Due to compliance restrictions, LaunchPool is not available in your region."
Stake limit exceeded"This project has a personal staking limit. Please reduce your amount."
API error / 401"Unable to fetch LaunchPool data. Please try again later." or "Please log in to access LaunchPool features."
场景处理方式
项目列表为空"没有符合条件的LaunchPool项目。请尝试不同筛选条件或稍后再试。"
质押记录为空"你暂无LaunchPool参与记录。可浏览活跃项目开始参与。"
奖励记录为空"未找到空投奖励。奖励通常在质押周期结束后发放。"
合规限制"受合规限制,你的所在地区无法使用LaunchPool功能。"
超出质押限额"该项目设有个人质押限额,请减少质押金额。"
API错误/401"无法获取LaunchPool数据,请稍后再试。" 或 "请登录以访问LaunchPool功能。"

Safety rules

安全规则

Confirmation required

需确认操作

  • Stake and Redeem are write operations. Before calling
    cex_launch_create_launch_pool_order
    or
    cex_launch_redeem_launch_pool
    , MUST show an order preview and wait for explicit user confirmation.
  • Preview format: project name, staking coin, amount, estimated APR (for stake), staking period.
  • Ask user to reply "confirm" to proceed or "cancel" to abort.
  • Only call the API after receiving explicit confirmation.
  • 质押与赎回为写入操作。在调用
    cex_launch_create_launch_pool_order
    cex_launch_redeem_launch_pool
    前,必须展示订单预览并等待用户明确确认。
  • 预览格式:项目名称、质押币种、金额、预估年化收益率(Estimated APR)(仅质押)、质押周期。
  • 请用户回复“确认”以继续,或“取消”以终止操作。
  • 仅在收到明确确认后调用API。

Compliance

合规要求

  • When the API returns a compliance or region restriction error, display a friendly message: "Due to compliance restrictions, LaunchPool is not available in your region." Do NOT retry.
  • 当API返回合规或地区限制错误时,显示友好提示:"受合规限制,你的所在地区无法使用LaunchPool功能。" 请勿重试。