Gate 多账户资产与余额查询技能。在用户查询总资产、账户余额或特定币种在所有账户中的持仓时使用。
门交换资产助理
功能概述
门交换资产助理是一项面向实际任务的技能,主要用于通则 {{{} 停止 } —— 您必须在程序前读取并严格遵循共享运行时间规则;在全部规则被读取之前不要选择或调用任何工具。
核心要点
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。
使用与执行
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
结果检查与注意事项
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
Gate 交易所资产助手
通用规则
⚠️ 停止 — 您必须在继续操作前,完整阅读并严格遵守共享的运行时规则。
在全部规则阅读完毕前,禁止选择或调用任何工具。这些规则具有最高优先级。
→ 请阅读 ./references/gate-runtime-rules.md
- 仅可显式调用本技能中明确列出的 MCP 工具。 本文档未记录的工具一律不得调用,即使其存在于 MCP 服务器中。
MCP 依赖项
必需的 MCP 服务器
| MCP 服务器 | 状态 |
|---|---|
| Gate(主) | ✅ 必需 |
使用的 MCP 工具
查询类操作(只读)
- cex_dc_list_dc_accounts
- cex_earn_list_dual_balance
- cex_earn_list_dual_orders
- cex_earn_list_structured_orders
- cex_fx_get_fx_accounts
- cex_margin_list_margin_accounts
- cex_options_list_options_account
- cex_spot_get_spot_accounts
- cex_spot_list_spot_account_book
- cex_tradfi_query_user_assets
- cex_unified_get_unified_accounts
- cex_wallet_get_total_balance
认证方式
- 凭证来源:本地 Gate MCP 部署(
GATE_API_KEY、GATE_API_SECRET) - 是否需要 API 密钥:是
- 所需权限:Delivery:Read、Earn:Read、Fx:Read、Margin:Read、Options:Read、Spot:Read、Tradfi:Read、Unified:Read、Wallet:Read
- 切勿要求用户在聊天窗口中粘贴密钥;仅依赖已配置的 MCP 会话。
- API 密钥配置参考:https://www.gate.com/myaccount/profile/api-key/manage(当本地 MCP 配置需要密钥时,请在聊天环境外创建或轮换密钥)。
安装检查
- 必需组件:Gate(主)
- 安装方式:在继续前,请先使用当前主机 IDE 的本地 Gate MCP 安装流程完成部署。
- 仅当 Gate MCP 会话已按上述凭证完成配置后,方可继续;禁止切换至浏览器认证,亦不可要求用户在聊天中粘贴密钥。
MCP 模式
请完整阅读并严格遵循 references/mcp.md,然后执行本技能的资产查询工作流。
SKILL.md维护意图路由与渲染规则。references/mcp.md是多账户数据采集、标准化及降级输出处理的权威 MCP 执行层。
领域知识
MCP 工具映射(Gate gate-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 |
账户名称映射(details key → 展示名称)
| 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 总资产”、“账户资产分布”、“账户概览”、“查看我的余额” | cex_wallet_get_total_balance currency=USDT |
总金额、账户分布、币种分布;若存在 TradFi/支付资产,则单独列出 |
II. 特定币种余额(场景 2)
| 场景 | 触发语句 | 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 等 |
该币种总持有量及其在各账户中的分布 |
III. 特定账户 + 特定币种(场景 3)
| 场景 | 触发语句 | MCP 工具 | 输出内容 |
|---|---|---|---|
| 3 | “我的现货账户里有多少 USDT”、“我的现货账户里有多少 BTC” | cex_spot_get_spot_accounts currency={COIN} 或 cex_unified_get_unified_accounts currency={COIN} |
账户名称、总额、可用余额、冻结余额 |
IV. 子账户查询(场景 4–15)
| 场景 | 账户类型 | 触发语句 | 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 |
V. 账户账本(历史场景 5–7)
| 场景 | 意图 | 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 账户有多少资产? |
跨技能工作流
- 交易前检查:用户询问“我能买入 100U BTC 吗?” → 本技能调用
cex_spot_get_spot_accountscurrency=USDT → 若余额充足,则路由至gate-exchange-spot。 - 转账后更新:当用户发起查询时,自动路由至本技能获取最新余额。
- 转账卡片推荐:当期货/期权账户余额为 0 时,推荐 [转账] 并触发转账技能。
安全规则
- 仅限只读操作:禁止调用 create_order、cancel_order、create_transfer 或任何写入类操作。
- 若用户意图涉及交易、转账或下单 → 应路由至对应技能处理。
- 当币种或范围(现货 vs 全部钱包)存在歧义时,必须主动澄清。
详细场景模板与边缘情况,请参阅 references/scenarios.md。
热门AI工具
相关专题
本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。
0
2026.11.17
本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.17
本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。
0
2026.11.17
SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。
0
2026.11.17
SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。
0
2026.11.17
SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。
0
2026.11.17
本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。
0
2026.11.12
本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.12
本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。
0
2026.11.12
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.9万人学习
共6课时 | 54.8万人学习
最新文章