Gate 多账户资产与余额查询技能。在用户查询总资产、账户余额或特定币种在所有账户中的持仓时使用。
门交换资产助理是一项面向实际任务的技能,主要用于通则 {{{} 停止 } —— 您必须在程序前读取并严格遵循共享运行时间规则;在全部规则被读取之前不要选择或调用任何工具。
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
⚠️ 停止 — 您必须在继续操作前,完整阅读并严格遵守共享的运行时规则。
在全部规则阅读完毕前,禁止选择或调用任何工具。这些规则具有最高优先级。
→ 请阅读 ./references/gate-runtime-rules.md
| MCP 服务器 | 状态 |
|---|---|
| Gate(主) | ✅ 必需 |
查询类操作(只读)
GATE_API_KEY、GATE_API_SECRET)请完整阅读并严格遵循 references/mcp.md,然后执行本技能的资产查询工作流。
SKILL.md 维护意图路由与渲染规则。references/mcp.md 是多账户数据采集、标准化及降级输出处理的权威 MCP 执行层。| MCP 工具 | 用途 | 关键字段 |
|---|---|---|
cex_wallet_get_total_balance |
总余额(含所有子账户,缓存约 1 分钟) | total.amount、details(spot/futures/delivery/finance/quant/meme_box/options/payment/margin/cross_margin) |
cex_spot_get_spot_accounts |
现货余额(支持按币种筛选) | currency、available、locked |
cex_unified_get_unified_accounts |
统一账户(单向/交叉/组合保证金模式) | balances、unified_account_total、margin_mode |
cex_fx_get_fx_accounts |
永续合约(结算币种为 USDT 或 BTC) | total、unrealised_pnl、available、point、bonus |
cex_dc_list_dc_accounts |
交割合约(结算币种为 USDT) | total、unrealised_pnl、available |
cex_options_list_options_account |
期权账户 | total_value、unrealised_pnl、available |
cex_margin_list_margin_accounts |
逐仓保证金 | currency_pair、mmr、base/quote(available/locked/borrowed/interest) |
cex_tradfi_query_user_assets |
TradFi 资产 | USDx 余额、margin |
cex_earn_list_dual_balance、cex_earn_list_dual_orders、cex_earn_list_structured_orders |
理财类资产(灵活计息 / 双币理财 / 结构化产品) | Flexible savings / Dual currency / Structured |
cex_spot_list_spot_account_book |
现货账户账本 / 明细流水 | ledger entries |
| API 键名 | 展示名称 |
|---|---|
| spot | 现货账户 / 交易账户 |
| futures | 期货账户(USDT 永续合约) |
| delivery | 交割合约账户 |
| options | 期权账户 |
| finance | 理财账户 |
| quant | 量化/机器人账户 |
| meme_box | Alpha 账户 |
| margin | 逐仓保证金账户 |
| cross_margin | 全仓保证金账户 |
| payment | 支付账户(不计入总余额) |
<$0.01;理财类昨日盈亏最多保留 8 位小数。| 场景 | 触发语句 | MCP 工具 | 输出内容 |
|---|---|---|---|
| 1 | “我有多少资产”、“展示我的 CEX 总资产”、“账户资产分布”、“账户概览”、“查看我的余额” | cex_wallet_get_total_balance currency=USDT |
总金额、账户分布、币种分布;若存在 TradFi/支付资产,则单独列出 |
| 场景 | 触发语句 | MCP 工具 | 输出内容 |
|---|---|---|---|
| 2 | “我有多少 BTC”、“我有多少 USDT” | 并发调用:cex_spot_get_spot_accounts、cex_unified_get_unified_accounts、cex_fx_get_fx_accounts、cex_dc_list_dc_accounts、cex_margin_list_margin_accounts、cex_earn_list_dual_balance 等 |
该币种总持有量及其在各账户中的分布 |
| 场景 | 触发语句 | MCP 工具 | 输出内容 |
|---|---|---|---|
| 3 | “我的现货账户里有多少 USDT”、“我的现货账户里有多少 BTC” | cex_spot_get_spot_accounts currency={COIN} 或 cex_unified_get_unified_accounts currency={COIN} |
账户名称、总额、可用余额、冻结余额 |
| 场景 | 账户类型 | 触发语句 | MCP 工具 |
|---|---|---|---|
| 4 | 现货 | “我的现货账户里有什么”、“展示我的现货账户资产” | cex_spot_get_spot_accounts 或 cex_unified_get_unified_accounts |
| 5 | 期货 | “我的期货账户有多少资产”、“USDT 永续合约”、“BTC 永续合约”、“交割合约” | cex_fx_get_fx_accounts settle=usdt/btc、cex_dc_list_dc_accounts |
| 6 | 交易(统一账户) | “我的交易账户有多少资产”、“我的统一账户有多少资产” | cex_unified_get_unified_accounts |
| 7 | 期权 | “我的期权账户有多少资产”、“展示我的期权资产” | cex_options_list_options_account 或 cex_unified_get_unified_accounts |
| 8 | 理财 | “我的理财账户有多少资产”、“展示我的理财账户资产” | cex_earn_list_dual_balance、cex_earn_list_dual_orders、cex_earn_list_structured_orders |
| 9 | Alpha | “我的 Alpha 账户有多少资产”、“展示我的 Alpha 资产” | cex_wallet_get_total_balance details.meme_box |
| 12 | 逐仓保证金 | “我的逐仓保证金账户有多少资产”、“展示我的逐仓保证金资产” | cex_margin_list_margin_accounts |
| 15 | TradFi | “我的 TradFi 账户有多少资产”、“展示我的 TradFi 资产” | cex_tradfi_query_user_assets |
| 场景 | 意图 | MCP 工具 |
|---|---|---|
| 5 | 指定币种的账户账本 | cex_spot_list_spot_account_book |
| 6 | 账本明细 + 当前余额 | cex_spot_list_spot_account_book → cex_spot_get_spot_accounts |
| 7 | 近期活动记录 | cex_spot_list_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 — 总余额:
您的 CEX 总资产估值 ≈ ${total.amount} USDT
🕒 更新时间:{time}(UTC+8)
💰 账户分布:details 中各键(spot/futures/delivery 等)对应金额,仅展示金额 > 0 的项
场景 2 — 特定币种:
您持有 {total_qty} {COIN}(≈ ${total_val} USDT)
🕒 更新时间:{time}(UTC+8)
💰 资产分布:{account}: {qty} {COIN},≈ ${val}({pct}%)
场景 15 — TradFi:
您的 TradFi 账户详情:
净值:{net_value} USDx | 余额:{balance} USDx | 未实现盈亏:{unrealised_pnl} USDx
保证金:{margin} USDx | 可用保证金:{available_margin} USDx | 保证金率:{ratio}%(上限 999+%)
⚠ TradFi 账户以 USDx 计价,与 USDT 1:1 兑换,不计入 CEX 总资产估值。
| 场景 | 查询语句 |
|---|---|
| 总余额 — 正常情况 | 我有多少资产? |
| 总余额 — 概览 | 展示我的 CEX 总资产 |
| 总余额 — 小额(<10U) | 我的账户资产分布 |
| 特定币种 — 正常情况 | 我有多少 BTC? |
| 特定币种 — 余额为零 | 我有多少 DOGE? |
| 特定账户+特定币种 | 我的现货账户里有多少 USDT? |
| 现货账户 | 我的现货账户里有什么? |
| 期货账户 — 含资产 | 我的期货账户有多少资产? |
| 期货账户 — USDT+BTC 永续合约 | 展示我的永续合约资产 |
| 期货账户 — 无资产 | 展示我的 USDT 永续合约资产 |
| 交易账户 | 我的交易账户有多少资产? |
| 期权账户 | 展示我的期权资产 |
| Alpha 账户 | 我的 Alpha 账户有多少资产? |
| 逐仓保证金 | 展示我的逐仓保证金资产 |
| TradFi | 我的 TradFi 账户有多少资产? |
cex_spot_get_spot_accounts currency=USDT → 若余额充足,则路由至 gate-exchange-spot。详细场景模板与边缘情况,请参阅 references/scenarios.md。
相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.3万人学习
共49课时 | 82.7万人学习
最新文章