gate-exchange-crossex

解析 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 CrossEx Trading Suite

此技能是 Gate CrossEx 跨交易所交易的统一入口。它支持许多核心操作： 订单管理、仓位查询和历史查询。用户意图会被路由到相应的工作流。

通用规则

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

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

技能依赖项

使用的 gate-cli 命令

查询操作（只读）

• gate-cli cex cross-ex account get
• gate-cli cex cross-ex market fee
• gate-cli cex cross-ex market interest-rate
• gate-cli cex cross-ex position margin-leverage
• gate-cli cex cross-ex order get
• gate-cli cex cross-ex position leverage
• gate-cli cex cross-ex account book
• gate-cli cex cross-ex position adl-rank
• gate-cli cex cross-ex market discount-rate
• gate-cli cex cross-ex position margin-interests
• gate-cli cex cross-ex position margin-history
• gate-cli cex cross-ex order history
• gate-cli cex cross-ex position history
• gate-cli cex cross-ex order trades
• gate-cli cex cross-ex position margin-list
• gate-cli cex cross-ex order list
• gate-cli cex cross-ex position list
• gate-cli cex cross-ex market risk-limits
• gate-cli cex cross-ex market symbols
• gate-cli cex cross-ex market transfer-coins
• gate-cli cex cross-ex transfer list

执行操作（写入）

• gate-cli cex cross-ex order cancel
• gate-cli cex cross-ex position close
• gate-cli cex cross-ex convert create
• gate-cli cex cross-ex convert quote
• gate-cli cex cross-ex order create
• gate-cli cex cross-ex transfer create
• gate-cli cex cross-ex account update
• gate-cli cex cross-ex position set-margin-leverage
• gate-cli cex cross-ex order update
• gate-cli cex cross-ex position set-leverage

身份验证

• **交互式文件设置：**如果主机上未同时设置 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 — 切勿要求用户在聊天中粘贴密钥。
• **权限：**Crx: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，然后执行此技能的 CrossEx 工作流。

• SKILL.md 负责路由分发和功能边界。
• references/gate-cli.md 是权威的 gate-cli 执行规范，规定了查询与变更的顺序、确认关卡以及风险感知型更新。

模块概览

模块	说明	触发关键词
现货	限价/市价买入或卖出、跨交易所套利	spot buy、spot sell、buy spot、sell spot
保证金	做多/做空交易、保证金管理、自动借款	margin long、margin short、long margin、short margin
期货	USDT 永续合约、双向持仓、杠杆调整	futures long、futures short、open long、open short
转账	跨交易所资金转账	fund transfer、cross-exchange transfer、transfer、move funds
兑换	闪兑和兑换报价工作流	convert trading、flash convert、convert、quote convert
订单	查询、取消和修改订单，订单历史	query orders、cancel order、amend order、order history、list orders
持仓	查询所有持仓类型、历史记录	query positions、check positions、position history、positions
历史记录	查询订单/持仓/交易/利息历史	history query、trade history、interest history、history

路由规则

意图	示例短语	路由至
现货交易	“买入价值 100 USDT 的 BTC”，“卖出 0.5 BTC”，“市价买入 ETH 现货”	阅读 references/spot-trading.md
保证金交易	“使用保证金做多价值 50 USDT 的 XRP”，“使用保证金做空 BTC”，“10 倍杠杆做多”	阅读 references/margin-trading.md
期货交易	“开立 1 BTC 期货多头仓位”，“市价做空 ETH”，“将杠杆调整为 20 倍”	阅读 references/futures-trading.md
跨交易所转账	“将 100 USDT 从 Gate 转到 Binance”，“将 ETH 从 OKX 转到 Gate”	阅读 references/transfer.md
闪兑交易	“将 10 USDT 闪兑为 BTC”，“在 Gate 将 50 USDT 兑换为 ETH”	阅读 references/convert-trading.md
订单管理	“查询所有未结订单”，“取消该买单”，“修改订单价格”，“查询订单历史”	阅读 references/order-management.md
仓位查询	“查询我的所有仓位”，“显示期货仓位”，“仓位历史”	阅读 references/position-query.md
历史记录查询	“查询交易历史”，“仓位历史”，“保证金利息历史”，“账户账本”	阅读 references/history-query.md
意图不明确	“显示账户”，“帮帮我”，“请检查我的账户”	澄清：查询账户，然后引导用户

gate-cli 命令索引

此技能使用 CrossEx MCP 工具集，其唯一的核心工具系列是 cex_crx 前缀。

范围规则：仅执行此技能中明确记录的操作。只能调用下表或 references/*.md 中列出的工具。 不得调用此处未提及的工具或执行未提及的操作。

工具命名约定

• cex_crx 系列中的 List 操作用于查询交易对、订单、仓位、转账或历史记录
• cex_crx 系列中的 Get 操作用于查询单个账户设置、手续费、利率或订单详情
• cex_crx 系列中的 Create 操作用于创建订单、转账、兑换报价或兑换订单
• cex_crx 系列中的 Update 操作用于更新账户设置、杠杆或现有订单
• cex_crx 系列中的 Cancel 操作用于取消现有订单
• cex_crx 系列中的 Close 操作用于平仓

交易对与规则工具

工具	用途
gate-cli cex cross-ex market symbols	列出支持的 CrossEx 交易对
gate-cli cex cross-ex market risk-limits	查询交易对风险限额规则
gate-cli cex cross-ex market transfer-coins	列出支持 CrossEx 转账的资产
gate-cli cex cross-ex market fee	查询 CrossEx 交易手续费信息
gate-cli cex cross-ex market interest-rate	查询 CrossEx 利率
gate-cli cex cross-ex market discount-rate	查询抵押品折扣率

账户工具

工具	用途
gate-cli cex cross-ex account get	查询 CrossEx 账户概览和余额
gate-cli cex cross-ex account update	更新 CrossEx 账户设置
gate-cli cex cross-ex account book	查询 CrossEx 账户账目记录

转账与闪兑工具

工具	用途
gate-cli cex cross-ex transfer list	查询转账历史
gate-cli cex cross-ex transfer create	创建跨交易所转账
gate-cli cex cross-ex convert quote	获取闪兑报价
gate-cli cex cross-ex convert create	执行闪兑订单

订单工具

工具	用途
gate-cli cex cross-ex order list	查询当前未结订单
gate-cli cex cross-ex order create	创建 CrossEx 订单
gate-cli cex cross-ex order get	查询订单详情
gate-cli cex cross-ex order update	修改现有订单
gate-cli cex cross-ex order cancel	取消单个订单
gate-cli cex cross-ex order history	查询订单历史
gate-cli cex cross-ex order trades	查询交易历史

仓位与杠杆工具

工具	用途
gate-cli cex cross-ex position list	查询当前期货仓位
gate-cli cex cross-ex position margin-list	查询当前保证金仓位
gate-cli cex cross-ex position close	平掉现有的 CrossEx 仓位
gate-cli cex cross-ex position leverage	查询期货杠杆设置
gate-cli cex cross-ex position set-leverage	更新期货杠杆
gate-cli cex cross-ex position margin-leverage	查询保证金杠杆设置
gate-cli cex cross-ex position set-margin-leverage	更新保证金杠杆
gate-cli cex cross-ex position history	查询期货仓位历史
gate-cli cex cross-ex position margin-history	查询保证金仓位历史
gate-cli cex cross-ex position margin-interests	查询保证金利息历史
gate-cli cex cross-ex position adl-rank	查询 ADL 排名信息

使用指南

• 将 cex_crx MCP 系列用作此技能的默认且唯一的核心 MCP 系列。
• 使用 list/get 工具查询交易对规则、费用、余额、杠杆或支持的资产。
• 用户要求查看记录、审计跟踪或状态验证时，优先使用历史记录和账户账簿工具。

执行

1. 意图与参数识别

• 确定模块（订单/仓位/历史记录）
• 提取关键参数：
• 交易对：GATE_SPOT_BTC_USDT、GATE_MARGIN_XRP_USDT、GATE_FUTURE_ETH_USDT
• 交易所：GATE、BINANCE、OKX、BYBIT
• 方向：BUY（买入/做多）、SELL（卖出/做空）
• 数量：USDT 金额、币数量、合约大小
• 价格：限价、市价
• 杠杆：杠杆倍数（仅适用于保证金/期货）
• 仓位方向：LONG（做多）、SHORT（做空，仅适用于保证金/期货）
• 缺失参数：如果缺少必需参数，请询问用户

2. 预检查

• 交易对：调用 gate-cli cex cross-ex market symbols 进行验证
• 账户余额：调用 gate-cli cex cross-ex account get 检查可用保证金是否充足
• 仓位检查：
• 保证金交易：检查现有仓位，以避免方向冲突
• 期货交易：检查双向持仓模式
• 最低金额：查询 min_quote_amount（通常为 3 USDT）
• 交易所状态：确认目标交易所运行正常

3. 模块逻辑

模块 A：现货交易

1. 参数确认：

• 交易对格式：GATE_SPOT_{BASE}_{QUOTE}
• 买入参数：quote_qty（USDT 金额）
• 卖出参数：qty（币数量）

2. 最低金额检查：调用 gate-cli cex cross-ex market symbols 查询最低金额
3. 下单前确认：显示订单摘要（交易对、方向、数量、价格），并要求用户确认
4. 下单：调用 gate-cli cex cross-ex order create
5. 验证：调用 gate-cli cex cross-ex order get 确认订单状态

模块 B：杠杆交易

1. 参数确认：

• 交易对格式：GATE_MARGIN_{BASE}_{QUOTE}
• 必需参数：qty（币种数量）、position_side（LONG 或 SHORT）
• 可选参数：quote_qty（USDT 金额）

2. 杠杆检查：查询当前杠杆；如果用户指定了杠杆，则进行调整
3. 持仓方向：

• 做多（LONG）：买入币种，借入 USDT
• 做空（SHORT）：卖出币种，借入币种

4. 最小数量检查：调用 gate-cli cex cross-ex market symbols 查询最小数量
5. 下单前确认：显示订单摘要（交易对、方向、数量、杠杆），并要求确认
6. 下单：调用 gate-cli cex cross-ex order create，并传入参数 position_side
7. 验证：调用 gate-cli cex cross-ex position margin-list，并使用 symbol 筛选条件确认持仓

模块 C：期货交易

1. 参数确认：

• 交易对格式：GATE_FUTURE_{BASE}_{QUOTE}
• 必需参数：qty（合约数量）、position_side（LONG 或 SHORT）

2. 杠杆调整：如果用户指定了杠杆，则调用 gate-cli cex cross-ex position leverage 和 gate-cli cex cross-ex position set-leverage
3. 合约数量计算（按价值下单时）：

• 获取 quanto_multiplier 和当前价格
• 向下取整以避免超额支出

4. 最小数量检查：调用 gate-cli cex cross-ex market symbols 查询最小数量
5. 下单前确认：显示订单摘要（交易对、方向、数量、杠杆），并要求确认
6. 下单：调用 gate-cli cex cross-ex order create，并传入参数 position_side
7. 验证：调用 gate-cli cex cross-ex position list，并使用 symbol 筛选条件确认持仓

模块 D：跨交易所转账

1. 转账类型：

• 跨交易所转账：gate-cli cex cross-ex transfer create（交易所 A → 交易所 B）

2. 参数确认：

• 跨交易所转账：from、to、coin、amount
• 转出／转入账户规则： | 币种 | 模式 | 有效的 from／to | 默认值 | |------|------|--------------------|---------| | USDT | 跨交易所 | SPOT ↔ CROSSEX | CROSSEX_{exchange_type} → CROSSEX | | USDT | 子交易所 | SPOT ↔ CROSSEX_{exchange_type} 或 CROSSEX_{exchange_type} ↔ CROSSEX_{exchange_type} | CROSSEX → CROSSEX_GATE | | 非 USDT | 任意 | 必须使用 CROSSEX_{exchange_type}（不能单独使用 CROSSEX）。允许跨交易所转账（例如，CROSSEX_BINANCE ↔ CROSSEX_GATE）。 | — |

3. 支持币种检查：调用 gate-cli cex cross-ex market transfer-coins 进行验证
4. 余额检查：确认转出账户余额充足
5. 转账前确认：显示转账摘要（来源、目标、币种、数量），并要求确认
6. 执行转账：调用 gate-cli cex cross-ex transfer create
7. 验证：调用 gate-cli cex cross-ex transfer list 查询转账历史并确认

模块 E：闪兑交易

1. 闪兑类型：

• 闪兑报价：gate-cli cex cross-ex convert quote
• 执行闪兑：gate-cli cex cross-ex convert create

2. 参数确认：

• 闪兑：from_coin、to_coin、from_amount、exchange_type

3. 余额检查：确认转出账户有足够余额进行该币种对的闪兑
4. 闪兑前确认：显示来源资产、目标资产、汇率和预计到账金额，然后要求 确认
5. 获取报价：调用 gate-cli cex cross-ex convert quote
6. 执行闪兑：调用 gate-cli cex cross-ex convert create，并传入返回的 quote_id
7. 验证：调用 gate-cli cex cross-ex account get 确认最终余额

模块 F：订单管理

1. 查询订单：

• 当前未完成订单：调用 gate-cli cex cross-ex order list
• 订单详情：调用 gate-cli cex cross-ex order get
• 订单历史记录：调用 gate-cli cex cross-ex order history（参数：limit、page、from、to）

2. 取消订单：

• 取消单笔订单：调用 gate-cli cex cross-ex order cancel

3. 修改订单：

• 检查订单状态是否为 open
• 调用 gate-cli cex cross-ex order update 修改价格或数量

4. 显示结果：以表格形式显示订单信息

模块 G：持仓查询

1. 查询类型：

• 期货持仓：调用 gate-cli cex cross-ex position list
• 保证金持仓：调用 gate-cli cex cross-ex position margin-list
• 期货杠杆：调用 gate-cli cex cross-ex position leverage
• 保证金杠杆：调用 gate-cli cex cross-ex position margin-leverage

2. 历史记录查询：

• 持仓历史记录：调用 gate-cli cex cross-ex position history（参数：limit、page、from、to）
• 保证金持仓历史记录：调用 gate-cli cex cross-ex position margin-history
• 交易历史记录：调用 gate-cli cex cross-ex order trades（参数：limit、page、from、to）

3. 显示格式：

• 当前持仓：以表格形式显示（交易对、方向、数量、入场价格、未实现盈亏）
• 历史记录：按时间倒序排列，显示最近的 N 条记录

模块 H：历史记录查询

1. 订单历史记录：

• 调用 gate-cli cex cross-ex order history
• 参数：limit（最多 100）、page、from（起始时间戳）、to（结束时间戳）

2. 交易历史记录：

• 调用 gate-cli cex cross-ex order trades
• 参数同上

3. 持仓历史记录：

• 调用 gate-cli cex cross-ex position history
• 参数同上

4. 保证金持仓历史记录：

• 调用 gate-cli cex cross-ex position margin-history
• 参数同上

5. 保证金利息历史记录：

• 调用 gate-cli cex cross-ex position margin-interests
• 参数同上

报告模板

每次操作后，输出简洁、格式统一的结果。

安全规则

• 凭据：绝不要提示或诱导用户在聊天中粘贴 API Secret Key；优先使用安全的本地 MCP 配置。
• 用户间转账：此技能不支持 P2P 或用户间转账；仅允许在用户自己的账户之间转账（例如，SPOT ↔ CROSSEX）。
• 交易订单：显示完整的订单摘要（交易对、方向、数量、价格、杠杆），下单前必须获得用户确认
• 跨交易所转账：显示转账详情（来源、目标、数量、到账时间），必须获得确认
• 范围规则：仅调用此技能中记录的工具。如果用户请求此处未记录的操作，回复说明此技能不支持该操作。
• 批量操作：显示操作范围及影响，并要求明确确认

示例：*"回复“确认”以执行上述操作。"

错误处理

错误代码	处理方式
USER_NOT_EXIST	请确认是否已开通 GATE CrossEx 账户。有关说明，请参阅 GATE 帮助中心 -> CrossEx 交易 -> CrossEx 账户操作指南。
TRADE_INVALID_QUOTE_ORDER_QTY	⚠️ 参数名称错误：市价买入必须使用 quote_qty
TRADE_INVALID_ORDER_QTY	⚠️ 限价单错误：限价单必须使用 qty（币种数量）+ price
TRADE_ORDER_AMOUNT_MIN_ERROR	订单金额低于最低名义价值（通常为 3 USDT），请增加数量或金额
CONVERT_TRADE_QUOTE_EXCHANGE_INVALID_ERROR	⚠️ 闪兑：exchange_type 参数值必须是大写的交易所代码（例如，GATE）
TRADE_MARGIN_INVALID_PZ_SIDE_ERROR	提示：保证金/期货交易必须指定 position_side（LONG/SHORT）
BALANCE_NOT_ENOUGH	可用保证金不足，建议减少交易金额或充值
SYMBOL_NOT_FOUND	请确认交易对格式是否正确（例如，GATE_SPOT_BTC_USDT）
INVALID_PARAM_VALUE	请检查参数格式（qty 为数字字符串，position_side 为 LONG/SHORT）
POSITION_NOT_EMPTY	提示：反向操作前请先平仓
TRADE_ORDER_LOT_SIZE_ERROR	建议将数量调整为该交易对的最小单位
RATE_LIMIT_EXCEEDED	提示用户已触发速率限制；建议稍后重试或降低请求频率
TRADE_INVALID_EXCHANGE_TYPE	交易所类型无效；请检查 exchange_type 参数（例如，GATE、BINANCE、OKX、BYBIT）