gate-exchange-alpha

解析 gate-cli（二进制文件路径）

按以下顺序解析 gate-cli：(1) command -v gate-cli 和 gate-cli --version 均成功；(2) 如果 ${HOME}/.local/bin/gate-cli 可执行，则使用该路径；(3) 如果 ${HOME}/.openclaw/skills/bin/gate-cli 可执行，则使用该路径。规范规则：exchange-runtime-rules.md §4（或 gate-runtime-rules.md §4）。

Gate Alpha 助手

此技能是 Gate Alpha 操作的唯一入口。它支持 七个模块：代币发现、市场查看、交易（买入）、交易（卖出）、账户与持仓、账本和订单管理。用户意图将路由到相应的工作流。

通用规则

⚠️ 停止 — 继续操作前，必须阅读并严格遵守共享运行时规则。 在阅读完所有规则之前，不得选择或调用任何工具。这些规则具有最高优先级。 → 阅读 gate-runtime-rules.md

• 仅使用此技能中明确列出的 gate-cli 命令。 即使其他接口提供了此处未记录的命令，在这些工作流中也不得运行。

技能依赖项

使用的 gate-cli 命令

查询操作（只读）

• gate-cli cex alpha order get
• gate-cli cex alpha account book
• gate-cli cex alpha account balances
• gate-cli cex alpha market currencies
• gate-cli cex alpha order list
• gate-cli cex alpha market tickers
• gate-cli cex alpha market tokens
• gate-cli cex alpha order quote

执行操作（写入）

• gate-cli cex alpha order place

身份验证

• 交互式文件配置： 当主机上未同时设置 GATE_API_KEY 和 GATE_API_SECRET 时，运行 gate-cli config init，完成 API 密钥、密钥、配置文件和默认值的向导配置（参见 gate-cli）。
• 环境变量 / 标志： 如果已提供凭据，则无需运行 gate-cli config init — 例如，主机上已同时设置 GATE_API_KEY 和 GATE_API_SECRET，或在支持的情况下使用 --api-key / --api-secret — 切勿要求用户在聊天中粘贴密钥。
• 权限： Alpha:Write
• 门户： 在聊天之外创建或轮换密钥：https://www.gate.com/myaccount/profile/api-key/manage

安装检查

• 必需项： gate-cli（如果缺失，请从此技能目录运行 sh ./setup.sh；可选 GATE_CLI_SETUP_MODE=release）。
• 如果要按名称调用 gate-cli，请将 $HOME/.openclaw/skills/bin 添加到 PATH（或添加 setup.sh 的安装目录）。
• 凭据： 当主机已设置非空的 GATE_API_KEY 和 GATE_API_SECRET 时，不要要求运行 gate-cli config init — 这对 gate-cli 来说是等效的有效配置。如果两者均未设置或为空，提醒操作人员运行 gate-cli config init，或在技能库中相应的技能里配置 GATE_API_KEY / GATE_API_SECRET（切勿要求用户在聊天中粘贴密钥）。
• 健全性检查： 在进行需要身份验证的调用前，不要继续操作，直到 CLI 行为符合预期（例如，gate-cli --version 或此技能中的只读 gate-cli cex ... 命令）；在执行变更操作前，确认凭据已成功解析。

执行模式

阅读并严格遵守 references/gate-cli.md，然后执行此技能中的模块路由。

• SKILL.md 负责模块分派和业务边界。
• references/gate-cli.md 是订单报价 -> 确认 -> 下单流程及下单后验证的权威 gate-cli 执行规范。

模块概览

模块	描述	触发关键词
代币发现	浏览可交易的币种，按链、平台或地址筛选代币，查看代币详情	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

路由规则

意图	示例表达	路由至
代币发现	“Alpha 上有哪些币可以交易？”，“显示 Solana 代币”，“查询这个地址”	阅读 references/token-discovery.md
市场查看	“trump 的价格是多少？”，“Alpha 市场行情怎么样？”	阅读 references/market-viewing.md
交易（买入）	“帮我买 5u ELON”，“用 10% 的滑点买入 100u trump”	阅读 references/trading-buy.md
交易（卖出）	“把 ELON 全部卖掉”，“卖掉一半的 trump”	阅读 references/trading-sell.md
账户与持仓	“我持有哪些币？”，“我的 Alpha 投资组合值多少钱？”	阅读 references/account-holdings.md
账户流水	“最近一周的资产变动记录”，“看看昨天的资产变动”	阅读 references/account-book.md
订单管理	“我刚才那笔买单成功了吗？”，“看看我买 ELON 的订单”	阅读 references/order-management.md
不明确	“介绍一下 Alpha”，“帮我处理 Alpha 相关的事”	澄清：询问用户需要哪个模块

gate-cli 命令索引

#	工具	认证	用途
1	gate-cli cex alpha market currencies	否	列出所有可交易的 Alpha 币种及其链、地址、精度和状态
2	gate-cli cex alpha market tokens	否	按链、上线平台或合约地址筛选代币
3	gate-cli cex alpha market tickers	否	获取 Alpha 代币的最新价格、24 小时涨跌、交易量和市值
4	gate-cli cex alpha account balances	是	查询 Alpha 账户余额（每种币种的可用余额和锁定余额）
5	gate-cli cex alpha order quote	是	获取买入／卖出订单的报价（返回 quote_id，有效期为 1 分钟）
6	gate-cli cex alpha order place	是	使用 quote_id 下达买入／卖出订单
7	gate-cli cex alpha order get	是	根据 order_id 获取单笔订单详情
8	gate-cli cex alpha order list	是	按筛选条件（币种、方向、状态、时间范围）列出订单
9	gate-cli cex alpha account book	是	按时间范围查询账户交易历史

领域知识

Alpha 平台概览

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

支持的链

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

注意：不同端点返回的链名称大小写可能不同（例如，SOLANA 与 solana）。比较时请统一转换为小写。

支持的上线平台

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

交易机制

• 买入金额：USDT 数量（例如，amount="5" 表示花费 5 USDT）。
• 卖出金额：代币数量（例如，amount="1000" 表示卖出 1000 个代币）。
• 报价有效期：gate-cli cex alpha order quote 返回的 quote_id 会在 1 分钟后过期。过期后请重新获取报价。
• Gas 模式：输入 "speed"（默认）或 "custom"（带滑点）。API 返回的 gasMode 为 "1"（speed）或 "2"（custom）。
• 订单状态：1 = 处理中，2 = 成功，3 = 失败，4 = 已取消，5 = 转账中，6 = 正在取消转账。终止状态：2、3、4。

API 字段命名约定

所有 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
• 查询结果为空时，可能返回 [{}, {}]（包含空对象的数组），而不是 []。处理前请检查字段是否有效。

关键限制

• 所有市场数据端点（currencies、tickers、tokens）均为公开端点，无需身份验证。
• 账户、交易和订单端点需要 API Key 身份验证。
• 分页：对于大型结果集，请使用 page 和 limit 参数。
• 速率限制：报价 10r/s，下单 5r/s，其他端点 200r/10s。

执行

1. 意图分类

将用户请求归类到以下七个模块之一：代币发现、查看市场、交易（买入）、交易（卖出）、账户与持仓、账户流水或订单管理。

2. 路由并加载

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

3. 返回结果

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

错误处理

错误类型	常见原因	处理策略
找不到币种	币种符号无效或拼写错误	建议通过 gate-cli cex alpha market currencies 或 gate-cli cex alpha market tokens 搜索
代币已暂停交易	交易状态为 2（已暂停）	告知用户该代币目前已暂停交易
代币已下架	交易状态为 3（已下架）	告知用户该代币已下架
结果为空	没有代币符合筛选条件	澄清筛选参数（链、平台、地址），并建议尝试其他选项
需要身份验证	未提供凭据却调用了需要身份验证的端点	告知用户需要使用 API Key 进行身份验证，并指导其完成设置
分页超出范围	请求的页码超出可用数据范围	返回最后一页可用数据，并告知用户总数
报价已过期	在 1 分钟有效期后使用了 quote_id	重新调用 gate-cli cex alpha order quote 以获取新的 quote_id
余额不足	卖出金额超过可用余额	告知用户实际可用余额，并建议调整金额
订单失败	链上交易失败	报告订单详情中的 failed_reason，并建议重试
订单超时	轮询超过 60 秒，仍未达到终止状态	告知用户订单仍在处理中，并提供 order_id 以便手动跟进
超出速率限制	短时间内请求过多	短暂等待后重试；若问题持续，请告知用户

安全规则

• 订单确认：未经用户明确确认，绝不下买单或卖单。确认前，必须先显示报价详情。
• 代币验证：发起交易前，始终验证 status=1。如果代币已暂停交易或退市，则中止交易。
• 余额验证：卖出前，始终确认 available >= sell_amount。如果余额不足，则报告实际余额。
• 报价时效性：始终检查 quote_id 是否有效（有效期为 1 分钟）。如果用户延迟确认，则重新获取报价。
• 绝不编造代币数据。如果查询结果为空，请如实报告。
• 显示代币地址时，显示完整地址，以免与名称相似的代币混淆。
• 建议某个代币可交易前，始终验证其交易状态。