gate-exchange-assets

解析 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 Exchange 资产助手

通用规则

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

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

技能依赖项

使用的 gate-cli 命令

查询操作（只读）

• gate-cli cex delivery account get
• gate-cli cex earn dual balance
• gate-cli cex earn dual orders
• cex_earn_list_structured_orders
• gate-cli cex futures account get
• gate-cli cex margin account list
• gate-cli cex options account get
• gate-cli cex spot account get
• gate-cli cex spot account book
• gate-cli cex tradfi account assets
• gate-cli cex unified account get
• gate-cli cex wallet balance total

身份验证

• **交互式文件设置：**如果主机上未同时设置 GATE_API_KEY 和 GATE_API_SECRET，运行 gate-cli config init，完成 API key、secret、配置档和默认值的设置向导（参见 gate-cli）。
• **环境变量 / 标志：**如果凭据已提供，则无需运行 gate-cli config init——例如，主机上已设置 GATE_API_KEY 和 GATE_API_SECRET，或在支持的情况下使用 --api-key / --api-secret；绝不要让用户在聊天中粘贴机密信息。
• 是否需要 API Key：是
• **权限：**Delivery:Read、Earn:Read、Fx:Read、Margin:Read、Options:Read、Spot:Read、Tradfi:Read、Unified:Read、Wallet:Read
• **门户：**在聊天之外创建或轮换密钥：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（或 setup.sh 安装该程序的目录）添加到 PATH。
• 凭据：当主机上同时设置了（非空的）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 执行的权威约定，涵盖多账户数据收集、规范化及降级输出处理。

领域知识

命令映射（gate-cli）

MCP 工具	用途	关键字段
gate-cli cex wallet balance total	总余额（所有子账户，缓存约 1 分钟）	total.amount, details（spot/futures/delivery/finance/quant/meme_box/options/payment/margin/cross_margin）
gate-cli cex spot account get	现货余额（按币种筛选）	currency, available, locked
gate-cli cex unified account get	统一账户（单币种/全仓/组合保证金）	balances, unified_account_total, margin_mode
gate-cli cex futures account get	永续合约（settle=usdt 或 btc）	total, unrealised_pnl, available, point, bonus
gate-cli cex delivery account get	交割合约（settle=usdt）	total, unrealised_pnl, available
gate-cli cex options account get	期权	total_value, unrealised_pnl, available
gate-cli cex margin account list	逐仓保证金	currency_pair, mmr, base/quote（available/locked/borrowed/interest）
gate-cli cex tradfi account assets	TradFi 资产	USDx 余额、保证金
gate-cli cex earn dual balance, gate-cli cex earn dual orders, cex_earn_list_structured_orders（在 gate-cli/cmd/cex 中没有对应的 gate-cli 映射；参见 MCP_LEGACY_TOOL_RESOLUTION.md §二）	理财	活期储蓄 / 双币投资 / 结构化产品
gate-cli cex spot account book	现货账户账簿 / 账本	账本条目

账户名称映射（details 键 → 显示名称）

API 键	显示名称
spot	现货账户 / 交易账户
futures	合约账户（USDT 永续）
delivery	交割合约账户
options	期权账户
finance	理财账户
quant	量化 / 机器人账户
meme_box	Alpha 账户
margin	逐仓保证金账户
cross_margin	全仓保证金账户
payment	支付账户（不计入总额）

关键规则

• 只读。不进行交易、转账或下单。
• TradFi / 支付：USDx 和支付资产不计入 CEX 总额；如有，应单独显示。
• 统一账户：当 margin_mode 为 classic/cross_margin/portfolio 时，现货资产可能会合并到“交易账户”。不要使用“高级模式”“S1/S2”等内部术语。
• 交易对格式：合约使用无斜杠格式（BTCUSDT）；现货 / 保证金使用带斜杠格式（BTC/USDT）。
• 精度：法币估值保留 2 位小数；微额资产（<$0.01）显示为 <$0.01；理财昨日盈亏最多保留 8 位小数。

案例路由图

I. 总额与概览（案例 1）

案例	触发语句	MCP 工具	输出
1	“我有多少钱”“显示我的 CEX 总资产”“账户资产分布”“账户概览”“查看我的余额”	gate-cli cex wallet balance total currency=USDT	总额、账户分布、币种分布；如有 TradFi / 支付资产，则单独列出

II. 指定币种（案例 2）

案例	触发语句	MCP 工具	输出
2	“我有多少 BTC”“我有多少 USDT”	并发调用：gate-cli cex spot account get、gate-cli cex unified account get、gate-cli cex futures account get、gate-cli cex delivery account get、gate-cli cex margin account list、gate-cli cex earn dual balance 等	持有的 {COIN} 总量，按账户分布

III. 指定账户与币种（案例 3）

案例	触发语句	MCP 工具	输出
3	“我的现货账户里有多少 USDT”“我的现货账户里有多少 BTC”	gate-cli cex spot account get currency={COIN} 或 gate-cli cex unified account get currency={COIN}	账户名称、总额、可用余额、锁定余额

IV. 子账户查询（案例 4–15）

案例	账户	触发短语	MCP 工具
4	现货	"我的现货账户里有什么"，"显示我的现货账户资产"	gate-cli cex spot account get 或 gate-cli cex unified account get
5	合约	"合约账户里有多少"，"USDT 永续合约"，"BTC 永续合约"，"交割合约"	gate-cli cex futures account get settle=usdt/btc，gate-cli cex delivery account get
6	交易（统一账户）	"交易账户里有多少"，"统一账户里有多少"	gate-cli cex unified account get
7	期权	"期权账户里有多少"，"显示我的期权资产"	gate-cli cex options account get 或 gate-cli cex unified account get
8	理财	"理财账户里有多少"，"显示我的理财账户资产"	gate-cli cex earn dual balance，gate-cli cex earn dual orders，cex_earn_list_structured_orders（在 gate-cli/cmd/cex 中没有对应的 gate-cli 映射；参见 MCP_LEGACY_TOOL_RESOLUTION.md §二）
9	Alpha	"Alpha 账户里有多少"，"显示我的 Alpha 资产"	gate-cli cex wallet balance total details.meme_box
12	逐仓保证金	"逐仓保证金账户里有多少"，"显示我的逐仓保证金资产"	gate-cli cex margin account list
15	TradFi	"TradFi 账户里有多少"，"显示我的 TradFi 资产"	gate-cli cex tradfi account assets

V. 账户账本（旧版 5–7）

案例	意图	MCP 工具
5	查询币种的账户账本	gate-cli cex spot account book
6	查询账本和当前余额	gate-cli cex spot account book → gate-cli cex spot account get
7	查询近期活动	gate-cli cex spot account book

特殊场景处理

场景	处理方式
总额 < 10 USDT	显示小额资产提示；建议使用 [充值] 或 [尘埃兑换]
统一账户迁移	"您的账户正在升级为统一账户，资产数据可能不完整，请在约 5 分钟后重试"
尘埃（>10 种尘埃币）	"{N} 种货币中有约 ${total_val} 尘埃" → [尘埃兑换]
API 超时/错误	"数据获取错误，请稍后重试" → [刷新]
账户/币种余额 = 0	不要显示“您的 xx 账户余额为 0”；跳过该项目
USDT + TradFi	单独显示 TradFi（USDx）；“TradFi 以 USDx 计价，与 USDT 为 1:1，不计入 CEX 总额”
GTETH / 凭证代币	说明：链上理财凭证，无法提币到链上
ST 代币	提示风险，建议查看官方公告
已下架代币	说明下架情况，建议提币
统一账户，用户询问“现货”	告知用户现货已合并至交易账户；显示交易账户余额

输出模板

案例 1 – 总余额：

Your total CEX asset valuation ≈ ${total.amount} USDT
🕒 Updated: {time} (UTC+8)
💰 Account distribution: details keys (spot/futures/delivery etc.) amount, show only amount > 0

案例 2 – 特定币种：

You hold {total_qty} {COIN} (≈ ${total_val} USDT)
🕒 Updated: {time} (UTC+8)
💰 Asset distribution: {account}: {qty} {COIN}, ≈ ${val} ({pct}%)

案例 15 – TradFi：

Your TradFi account details:
Net value: {net_value} USDx | Balance: {balance} USDx | Unrealised PnL: {unrealised_pnl} USDx
Margin: {margin} USDx | Available margin: {available_margin} USDx | Margin ratio: {ratio}% (max 999+%)
⚠ TradFi account in USDx, 1:1 with USDT, not in CEX total valuation.

验收测试查询（验证）

场景	查询
总余额 – 普通	我有多少钱？
总余额 – 概览	显示我的 CEX 总资产
总余额 – 小额（<10U）	我的账户资产分布
特定币种 – 普通	我有多少 BTC？
特定币种 – 零余额	我有多少 DOGE？
特定账户+币种	我的现货账户里有多少 USDT？
现货账户	我的现货账户里有什么？
合约 – 有资产	合约账户里有多少
合约 – USDT+BTC 永续合约	显示我的永续合约资产
合约 – 无资产	显示我的 USDT 永续合约资产
交易账户	交易账户里有多少
期权	显示我的期权资产
Alpha	Alpha 账户里有多少
逐仓保证金	显示我的逐仓保证金资产
TradFi	TradFi 账户里有多少

跨技能工作流

• 交易前：用户询问“我能买 100U 的 BTC 吗？”→ 本技能：gate-cli cex spot account get，currency=USDT → 如果余额充足，则转至 gate-exchange-spot。
• 转账后：用户询问时，转至本技能查询更新后的余额。
• 转账卡片：当期货/期权余额 = 0 时，建议[转账]并触发转账技能。

安全规则

• 仅限只读操作。绝不调用 create_order、cancel_order、create_transfer 或任何写操作。
• 如果用户意图涉及交易、转账或下单 → 转至相应技能。
• 信息不明确时，始终确认币种和范围（现货还是所有钱包）。

有关详细的场景模板和边缘情况，请参阅 references/scenarios.md。