Gate Exchange Assets

Polar Sponsor
爱发电 赞助
.NET 9.0

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_accounts currency=USDT → 若余额充足,则路由至 gate-exchange-spot。
  • 转账后更新:当用户发起查询时,自动路由至本技能获取最新余额。
  • 转账卡片推荐:当期货/期权账户余额为 0 时,推荐 [转账] 并触发转账技能。

安全规则

  • 仅限只读操作:禁止调用 create_order、cancel_order、create_transfer 或任何写入类操作。
  • 若用户意图涉及交易、转账或下单 → 应路由至对应技能处理。
  • 当币种或范围(现货 vs 全部钱包)存在歧义时,必须主动澄清。

详细场景模板与边缘情况,请参阅 references/scenarios.md。

相关专题

更多
GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

0

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

0

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

0

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习