gate-exchange-alpha

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Gate Alpha Assistant

Gate Alpha 助手

This skill is the single entry for Gate Alpha operations. It supports seven modules: Token Discovery, Market Viewing, Trading (Buy), Trading (Sell), Account & Holdings, Account Book, and Order Management. User intent is routed to the matching workflow.

本Skill是Gate Alpha操作的统一入口，支持七大模块：代币发现、市场查看、买入交易、卖出交易、账户与持仓、账户流水、订单管理。用户的意图会被路由至匹配的工作流。

General Rules

通用规则

Read and follow the shared runtime rules before proceeding:

→ exchange-runtime-rules.md

在执行操作前，请阅读并遵循共享的运行时规则：

→ exchange-runtime-rules.md

Module Overview

模块概述

Module	Description	Trigger Keywords
Token Discovery	Browse tradable currencies, filter tokens by chain/platform/address, check token details	`alpha tokens` , `what coins` , `which chain` , `token address` , `token details`
Market Viewing	Check all or specific Alpha token tickers, prices, 24h changes	`alpha price` , `market` , `ticker` , `how much is` , `what price`
Trading (Buy)	Buy Alpha tokens with USDT, support default or custom slippage, optional order tracking	`buy` , `买` , `购买` , `入手` , `帮我买`
Trading (Sell)	Sell Alpha tokens (full or partial), optional order tracking	`sell` , `卖` , `卖出` , `清仓` , `卖掉`
Account & Holdings	View Alpha account balances and calculate portfolio market value	`my holdings` , `my balance` , `portfolio value` , `how much do I have`
Account Book	View Alpha account transaction history by time range	`transaction history` , `流水` , `资产变动` , `account book` , `变动记录`
Order Management	Check order status, view historical buy/sell orders, search orders by time	`order status` , `订单` , `买单` , `卖单` , `order history`

模块	描述	触发关键词
代币发现	浏览可交易币种，按链/平台/地址筛选代币，查看代币详情	`alpha tokens` , `what coins` , `which chain` , `token address` , `token details`
市场查看	查看全部或指定Alpha代币的行情、价格、24小时涨跌幅	`alpha price` , `market` , `ticker` , `how much is` , `what price`
买入交易	使用USDT买入Alpha代币，支持默认或自定义滑点，可选订单追踪	`buy` , `买` , `购买` , `入手` , `帮我买`
卖出交易	卖出Alpha代币（全部或部分），可选订单追踪	`sell` , `卖` , `卖出` , `清仓` , `卖掉`
账户与持仓	查看Alpha账户余额，计算投资组合市值	`my holdings` , `my balance` , `portfolio value` , `how much do I have`
账户流水	按时间范围查看Alpha账户交易历史	`transaction history` , `流水` , `资产变动` , `account book` , `变动记录`
订单管理	查看订单状态，查看历史买卖订单，按时间搜索订单	`order status` , `订单` , `买单` , `卖单` , `order history`

Routing Rules

路由规则

Intent	Example Phrases	Route To
Token discovery	"What coins can I trade on Alpha?", "Show me Solana tokens", "Look up this address"	Read `references/token-discovery.md`
Market viewing	"What's the price of trump?", "How's the Alpha market?"	Read `references/market-viewing.md`
Trading (buy)	"帮我买 5u ELON", "Buy 100u trump with 10% slippage"	Read `references/trading-buy.md`
Trading (sell)	"把 ELON 全部卖掉", "卖掉一半的 trump"	Read `references/trading-sell.md`
Account & holdings	"What coins do I hold?", "How much is my Alpha portfolio worth?"	Read `references/account-holdings.md`
Account book	"最近一周的资产变动记录", "看看昨天的资产变动"	Read `references/account-book.md`
Order management	"我刚才那笔买单成功了吗？", "看看我买 ELON 的订单"	Read `references/order-management.md`
Unclear	"Tell me about Alpha", "Help with Alpha"	Clarify: ask which module the user needs

意图	示例短语	路由至
代币发现	"What coins can I trade on Alpha?", "Show me Solana tokens", "Look up this address"	阅读 `references/token-discovery.md`
市场查看	"What's the price of trump?", "How's the Alpha market?"	阅读 `references/market-viewing.md`
买入交易	"帮我买 5u ELON", "Buy 100u trump with 10% slippage"	阅读 `references/trading-buy.md`
卖出交易	"把 ELON 全部卖掉", "卖掉一半的 trump"	阅读 `references/trading-sell.md`
账户与持仓	"What coins do I hold?", "How much is my Alpha portfolio worth?"	阅读 `references/account-holdings.md`
账户流水	"最近一周的资产变动记录", "看看昨天的资产变动"	阅读 `references/account-book.md`
订单管理	"我刚才那笔买单成功了吗？", "看看我买 ELON 的订单"	阅读 `references/order-management.md`
不明确	"Tell me about Alpha", "Help with Alpha"	澄清：询问用户需要哪个模块的服务

MCP Tools

MCP工具


cex_alpha_list_alpha_currencies
cex_alpha_list_alpha_tokens
cex_alpha_list_alpha_tickers
cex_alpha_list_alpha_accounts
cex_alpha_quote_alpha_order
cex_alpha_place_alpha_order
cex_alpha_get_alpha_order
cex_alpha_list_alpha_orders
cex_alpha_list_alpha_account_book

#	Tool	Auth	Purpose
1	`cex_alpha_list_alpha_currencies`	No	List all tradable Alpha currencies with chain, address, precision, status
2	`cex_alpha_list_alpha_tokens`	No	Filter tokens by chain, launch platform, or contract address
3	`cex_alpha_list_alpha_tickers`	No	Get latest price, 24h change, volume, market cap for Alpha tokens
4	`cex_alpha_list_alpha_accounts`	Yes	Query Alpha account balances (available + locked per currency)
5	`cex_alpha_quote_alpha_order`	Yes	Get a price quote for a buy/sell order (returns quote_id, valid 1 min)
6	`cex_alpha_place_alpha_order`	Yes	Place a buy/sell order using a quote_id
7	`cex_alpha_get_alpha_order`	Yes	Get details of a single order by order_id
8	`cex_alpha_list_alpha_orders`	Yes	List orders with filters (currency, side, status, time range)
9	`cex_alpha_list_alpha_account_book`	Yes	Query account transaction history by time range


cex_alpha_list_alpha_currencies
cex_alpha_list_alpha_tokens
cex_alpha_list_alpha_tickers
cex_alpha_list_alpha_accounts
cex_alpha_quote_alpha_order
cex_alpha_place_alpha_order
cex_alpha_get_alpha_order
cex_alpha_list_alpha_orders
cex_alpha_list_alpha_account_book

序号	工具	认证要求	用途
1	`cex_alpha_list_alpha_currencies`	无需	列出所有可交易的Alpha币种，包含链、地址、精度、状态
2	`cex_alpha_list_alpha_tokens`	无需	按链、发行平台或合约地址筛选代币
3	`cex_alpha_list_alpha_tickers`	无需	获取Alpha代币的最新价格、24小时涨跌幅、成交量、市值
4	`cex_alpha_list_alpha_accounts`	需要	查询Alpha账户余额（各币种的可用+锁定金额）
5	`cex_alpha_quote_alpha_order`	需要	获取买卖订单的报价（返回quote_id，有效期1分钟）
6	`cex_alpha_place_alpha_order`	需要	使用quote_id提交买卖订单
7	`cex_alpha_get_alpha_order`	需要	通过order_id查询单笔订单详情
8	`cex_alpha_list_alpha_orders`	需要	筛选列出订单（可按币种、方向、状态、时间范围）
9	`cex_alpha_list_alpha_account_book`	需要	按时间范围查询账户交易历史

Domain Knowledge

领域知识

Alpha Platform Overview

Alpha平台概述

Gate Alpha is a platform for early-stage token trading, supporting tokens across multiple blockchains.
Tokens are identified by
```
currency
```
symbol (e.g.,
```
memeboxtrump
```
) rather than standard ticker symbols.
Trading status values:
```
1
```
= actively trading,
```
2
```
= suspended,
```
3
```
= delisted.

Gate Alpha是一个早期阶段代币交易平台，支持多区块链代币。
代币通过
```
currency
```
符号（如
```
memeboxtrump
```
）标识，而非标准行情符号。
交易状态值：
```
1
```
=可交易，
```
2
```
=暂停交易，
```
3
```
=已下架。

Supported Chains

支持的链

solana, eth, bsc, base, world, sui, arbitrum, avalanche, polygon, linea, optimism, zksync, gatelayer

Note: Chain names may be returned in different cases depending on the endpoint (e.g.,

SOLANA

solana

). Normalize to lowercase when comparing.

solana, eth, bsc, base, world, sui, arbitrum, avalanche, polygon, linea, optimism, zksync, gatelayer

注意：根据接口不同，链名称可能返回不同大小写（如

SOLANA

solana

）。对比时请统一转换为小写。

Supported Launch Platforms

支持的发行平台

meteora_dbc, fourmeme, moonshot, pump, raydium_launchlab, letsbonk, gatefun, virtuals

Trading Mechanics

交易机制

Buy amount: USDT quantity (e.g.,
```
amount="5"
```
means spend 5 USDT).
Sell amount: Token quantity (e.g.,
```
amount="1000"
```
means sell 1000 tokens).
Quote validity:
```
quote_id
```
from
```
cex_alpha_quote_alpha_order
```
expires after 1 minute. Re-quote if expired.
Gas modes: Input
```
"speed"
```
(default) or
```
"custom"
```
(with slippage). API returns
```
gasMode
```
as
```
"1"
```
(speed) or
```
"2"
```
(custom).
Order statuses:
```
1
```
= Processing,
```
2
```
= Success,
```
3
```
= Failed,
```
4
```
= Cancelled,
```
5
```
= Transferring,
```
6
```
= Cancelling transfer. Terminal statuses: 2, 3, 4.

买入金额：USDT数量（如
```
amount="5"
```
表示花费5 USDT）。
卖出金额：代币数量（如
```
amount="1000"
```
表示卖出1000个代币）。
报价有效期：
```
cex_alpha_quote_alpha_order
```
返回的quote_id有效期为1分钟。过期需重新获取报价。
Gas模式：输入
```
"speed"
```
（默认）或
```
"custom"
```
（自定义滑点）。API返回的
```
gasMode
```
值为
```
"1"
```
（speed）或
```
"2"
```
（custom）。
订单状态：
```
1
```
=处理中，
```
2
```
=成功，
```
3
```
=失败，
```
4
```
=已取消，
```
5
```
=转账中，
```
6
```
=取消转账中。终态为2、3、4。

API Field Naming Conventions

API字段命名规范

All API endpoints use snake_case naming. Key fields by endpoint:

/alpha/currencies

currency

name

chain

address

amount_precision

precision

status

/alpha/tickers

currency

last

change

volume

market_cap

/alpha/accounts

currency

available

locked

token_address

chain

/alpha/account_book

id

time

currency

change

balance

/alpha/orders

(GET):

order_id

tx_hash

side

usdt_amount

currency

currency_amount

status

gas_mode

chain

gas_fee

transaction_fee

create_time

failed_reason

Empty query results may return
```
[{}, {}]
```
(array with empty objects) instead of
```
[]
```
. Check for valid fields before processing.

所有API接口均采用snake_case命名。各接口的关键字段：

/alpha/currencies

：

currency

name

chain

address

amount_precision

precision

status

/alpha/tickers

：

currency

last

change

volume

market_cap

/alpha/accounts

：

currency

available

locked

token_address

chain

/alpha/account_book

：

id

time

currency

change

balance

/alpha/orders

（GET）：

order_id

tx_hash

side

usdt_amount

currency

currency_amount

status

gas_mode

chain

gas_fee

transaction_fee

create_time

failed_reason

空查询结果可能返回
```
[{}, {}]
```
（包含空对象的数组）而非
```
[]
```
。处理前请检查字段是否有效。

Key Constraints

关键约束

All market data endpoints (
```
currencies
```
,
```
tickers
```
,
```
tokens
```
) are public and do not require authentication.
Account, trading, and order endpoints require API Key authentication.
Pagination: use
```
page
```
and
```
limit
```
parameters for large result sets.
Rate limits: quote 10r/s, place order 5r/s, other endpoints 200r/10s.

所有市场数据接口（
```
currencies
```
,
```
tickers
```
,
```
tokens
```
）为公开接口，无需认证。
账户、交易、订单接口需要API Key认证。
分页：处理大量结果时使用
```
page
```
和
```
limit
```
参数。
速率限制：报价接口10次/秒，下单接口5次/秒，其他接口200次/10秒。

Execution

执行流程

1. Intent Classification

1. 意图分类

Classify the user request into one of seven modules: Token Discovery, Market Viewing, Trading (Buy), Trading (Sell), Account & Holdings, Account Book, or Order Management.

将用户请求分类至七大模块之一：代币发现、市场查看、买入交易、卖出交易、账户与持仓、账户流水、订单管理。

2. Route and Load

2. 路由与加载

Load the corresponding reference document and follow its workflow.

加载对应的参考文档并遵循其工作流。

3. Return Result

3. 返回结果

Return the result using the report template defined in each sub-module.

使用各子模块定义的报告模板返回结果。

Error Handling

错误处理

Error Type	Typical Cause	Handling Strategy
Currency not found	Invalid or misspelled currency symbol	Suggest searching via `cex_alpha_list_alpha_currencies` or `cex_alpha_list_alpha_tokens`
Token suspended	Trading status is 2 (suspended)	Inform user that the token is currently suspended from trading
Token delisted	Trading status is 3 (delisted)	Inform user that the token has been delisted
Empty result	No tokens match the filter criteria	Clarify filter parameters (chain, platform, address) and suggest alternatives
Authentication required	Calling authenticated endpoint without credentials	Inform user that API Key authentication is needed; guide to setup
Pagination overflow	Requested page beyond available data	Return last available page and inform user of total count
Quote expired	quote_id used after 1-minute validity window	Re-call `cex_alpha_quote_alpha_order` to obtain a fresh quote_id
Insufficient balance	Sell amount exceeds available balance	Inform user of actual available balance and suggest adjusting the amount
Order failed	On-chain transaction failed	Report the `failed_reason` from the order detail and suggest retrying
Order timeout	Polling exceeded 60 seconds without terminal status	Inform user the order is still processing; provide order_id for manual follow-up
Rate limit exceeded	Too many requests in short period	Wait briefly and retry; inform user if persistent

错误类型	典型原因	处理策略
币种未找到	币种符号无效或拼写错误	建议通过 `cex_alpha_list_alpha_currencies` 或 `cex_alpha_list_alpha_tokens` 搜索
代币暂停交易	交易状态为2（暂停）	告知用户该代币当前暂停交易
代币已下架	交易状态为3（已下架）	告知用户该代币已下架
结果为空	无符合筛选条件的代币	澄清筛选参数（链、平台、地址）并提供替代方案
需要认证	调用需认证接口但未提供凭证	告知用户需要API Key认证；引导用户完成设置
分页溢出	请求的页码超出可用数据范围	返回最后一页数据并告知用户总数量
报价过期	使用了超过1分钟有效期的quote_id	重新调用 `cex_alpha_quote_alpha_order` 获取新的quote_id
余额不足	卖出金额超过可用余额	告知用户实际可用余额并建议调整卖出金额
订单失败	链上交易失败	报告订单详情中的 `failed_reason` 并建议重试
订单超时	轮询超过60秒仍未达到终态	告知用户订单仍在处理中；提供order_id供用户手动跟进
触发速率限制	短时间内请求过多	短暂等待后重试；若持续触发则告知用户

Safety Rules

安全规则

Order confirmation: NEVER place a buy or sell order without showing the quote details and receiving explicit user confirmation.
Token validation: Always verify
```
status=1
```
before initiating a trade. Abort if suspended or delisted.
Balance verification: Before selling, always confirm
```
available >= sell_amount
```
. Report actual balance if insufficient.
Quote freshness: Always check quote_id validity (1-minute window). Re-quote if the user delays confirmation.
Never fabricate token data. If a query returns empty results, report it honestly.
When displaying token addresses, show the full address to avoid confusion between similarly named tokens.
Always verify trading status before suggesting a token is tradable.

订单确认：在未展示报价详情并获得用户明确确认前，绝对不能提交买卖订单。
代币验证：发起交易前必须验证
```
status=1
```
。若代币处于暂停或下架状态则终止操作。
余额验证：卖出前必须确认
```
available >= sell_amount
```
。若余额不足则报告实际余额。
报价新鲜度：始终检查quote_id的有效期（1分钟）。若用户延迟确认则重新获取报价。
不得伪造代币数据。若查询返回空结果，需如实告知用户。
展示代币地址时，需显示完整地址以避免同名代币混淆。
在告知用户某代币可交易前，始终验证其交易状态。