gate-exchange-spot

Gate 现货交易助手

通用规则

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

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

---

技能依赖项

• **调用任何 gate-cli 命令之前：**确保已安装 gate-cli。设置 GATE_CLI_BIN="${GATE_OPENCLAW_SKILLS_BIN:-$HOME/.openclaw/skills/bin}/gate-cli"。如果 [ ! -x "$GATE_CLI_BIN" ]（并且依赖 PATH 时，command -v gate-cli 也未找到），运行 setup.sh（例如，在此技能目录中运行 sh ./setup.sh），然后重新检查。在 gate-cli 成功运行之前（例如 gate-cli --version），不要继续执行需要身份验证的交易或账户读取操作。
• 此技能不需要 MCP 服务；执行操作仅使用 gate-cli。

使用的 gate-cli 命令

查询操作（只读）

• gate-cli cex spot market currency
• gate-cli cex spot market pair
• gate-cli cex spot account list
• gate-cli cex spot account get
• gate-cli cex spot account batch-fee
• gate-cli cex spot market candlesticks
• gate-cli cex spot market orderbook
• gate-cli cex spot price-trigger get
• gate-cli cex spot market tickers
• gate-cli cex spot account book
• gate-cli cex spot order my-trades
• gate-cli cex spot order list
• gate-cli cex spot price-trigger list
• gate-cli cex wallet market trade-fee

执行操作（写入）

• gate-cli cex spot order batch-amend
• gate-cli cex spot order amend
• gate-cli cex spot order cancel
• gate-cli cex spot order batch-cancel
• gate-cli cex spot price-trigger cancel
• gate-cli cex spot price-trigger cancel-all
• gate-cli cex spot order batch-create
• gate-cli cex spot order buy / gate-cli cex spot order sell
• gate-cli cex spot price-trigger create

身份验证

• **交互式文件配置：**如果主机上没有同时设置 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 — 切勿要求用户在聊天中粘贴密钥。
• 权限：gate-cli 使用的密钥需具有 Spot:Write、Wallet:Read 权限。
• **门户：**在聊天之外创建或轮换密钥：https://www.gate.com/myaccount/profile/api-key/manage

安装检查

• 必需：gate-cli（缺少时，按照技能依赖项中的说明通过 setup.sh 安装）。
• GateClaw / OpenClaw：setup.sh 默认将其安装到 $HOME/.openclaw/skills/bin/gate-cli；如果 Agent 按名称调用 gate-cli，请将该目录添加到 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 cex spot market tickers），不要执行需要身份验证的调用；交易前确认凭据已成功解析。

执行模式

阅读并严格遵循 references/gate-cli.md，然后执行此技能的路由／案例逻辑。

• SKILL.md 仍然是意图路由和场景映射文档。
• references/gate-cli.md 是关于 gate-cli 用法、执行前检查、确认关卡和降级处理的权威执行契约。

领域知识

按领域划分的工具映射

分组	gate-cli 命令
账户和余额	gate-cli cex spot account list（所有现货账户行／查看现货账户余额），gate-cli cex spot account get（单个币种），gate-cli cex spot account book
下单／取消／修改订单	gate-cli cex spot order buy / gate-cli cex spot order sell，gate-cli cex spot order batch-create，gate-cli cex spot order cancel，gate-cli cex spot order batch-cancel，gate-cli cex spot order amend，gate-cli cex spot order batch-amend
触发订单（价格订单）	gate-cli cex spot price-trigger create，gate-cli cex spot price-trigger list，gate-cli cex spot price-trigger get，gate-cli cex spot price-trigger cancel，gate-cli cex spot price-trigger cancel-all
未结订单和成交记录	gate-cli cex spot order list，gate-cli cex spot order my-trades
市场数据	gate-cli cex spot market tickers，gate-cli cex spot market orderbook，gate-cli cex spot market candlesticks
交易规则	gate-cli cex spot market currency，gate-cli cex spot market pair
费用	gate-cli cex wallet market trade-fee，gate-cli cex spot account batch-fee

关键交易规则

• 交易对使用 BASE_QUOTE 格式，例如 BTC_USDT。
• 买入前先检查计价币余额（例如 USDT）。
• 按金额买入必须满足 min_quote_amount（通常为 10U）。
• 按数量买入／卖出必须满足最小数量和精度要求（min_base_amount / amount_precision）。
• 条件请求可根据用户意图（“如果价格达到 X，则下单”）通过立即起草限价订单或触发订单来实现。
• 止盈／止损（TP/SL）类请求通过现货价格触发命令处理，并明确指定触发参数和执行参数。

市价单参数提取规则（必须遵循）

使用 type=market 调用 gate-cli cex spot order buy / gate-cli cex spot order sell 时，按交易方向填写 amount：

side	amount 含义	示例
buy	计价币金额（USDT）	“买入价值 100U 的 BTC” -> amount="100"
sell	基础币数量（BTC/ETH 等）	“卖出 0.01 BTC” -> amount="0.01"

执行前检查：

• buy 市价单：确认计价币余额足以覆盖 amount（USDT）。
• sell 市价单：确认可用基础币余额足以覆盖 amount（币的数量）。

工作流

用户提出任何现货交易操作请求时，遵循以下顺序。

第 1 步：识别任务类型

将请求归入以下六类之一：

1. 买入（市价／限价／全额余额买入）
2. 卖出（全仓卖出／条件卖出）
3. 账户查询（列出现货余额／查看现货账户余额、总资产、按币种检查余额、可交易性检查）
4. 订单管理（列出未结订单、修改、取消）
5. 交易后核验（是否成交、入账金额、当前持仓）
6. 组合操作（先卖出再买入、买入后挂出卖单、基于趋势买入）

第 2 步：提取参数并执行预检查

提取关键字段：

• currency / currency_pair
• side（buy/sell）
• amount（币数量）或 quote_amount（USDT 金额）
• price 或价格条件（例如“低于当前价格 2%”）
• 触发条件（仅在满足条件时执行）

当 type=market 时，将参数规范化为：

• side=buy：amount = quote_amount（USDT 金额）
• side=sell：amount = base_amount（基础币数量）

预检查顺序：

1. 交易对/货币的可交易状态
2. 最小下单金额/数量和精度
3. 可用余额是否充足
4. 是否满足用户条件（例如“仅在低于 60000 时买入”）

第 3 步：下单前必须取得用户最终确认

每次调用 gate-cli cex spot order buy / gate-cli cex spot order sell、gate-cli cex spot order batch-create 或 gate-cli cex spot price-trigger create 之前，都必须先提供订单草案，然后等待用户明确确认。

必须遵循的执行流程：

1. 发送订单草案（此时不调用交易工具）
2. 等待用户明确批准
3. 仅在获得批准后提交真实订单
4. 未获得批准时，仅执行查询/估算，绝不执行交易
5. 确认仅可使用一次：每执行一笔订单后，后续每笔订单都必须重新请求确认

必须包含的确认字段：

• 交易对（currency_pair）
• 方向和订单类型（buy/sell、market/limit）
• amount 的含义和值
• 限价（如适用）或定价依据
• 预估成交价/预估成本或收益
• 主要风险提示（例如滑点）

建议的草案措辞：

• 订单草案：BTC_USDT，买入，市价单，amount=100 USDT，预计按当前卖一价附近成交，风险：快速波动的市场中可能出现滑点。回复“确认订单”即可下单。

允许的确认回复（示例）：

• 确认订单、确认、继续、是，下单

严格阻断规则（不可绕过）：

• 除非用户在紧接着的上一轮中明确确认，否则绝不调用 gate-cli cex spot order buy / gate-cli cex spot order sell、gate-cli cex spot order batch-create 或 gate-cli cex spot price-trigger create。
• 如果对话主题发生变化、参数发生变化或讨论了多个选项，先前的确认即失效，必须重新请求确认。
• 对于多腿执行（例如案例 15/22/33），每条腿都必须在各自的交易调用之前单独取得确认。

如果用户未确认、确认含糊或明确拒绝：

• 不要下单
• 返回待处理状态并请求用户明确确认
• 仅继续执行只读操作（余额检查、市场报价、手续费估算）

步骤 4：按场景运行命令

仅使用完成任务所需的最少 gate-cli 命令集：

• 列出现货账户所有余额（例如：查看我的现货账户余额、我的现货余额、列出现货账户有哪些币；默认省略余额为零的币种）：gate-cli cex spot account list — 仅当用户想查看包括余额为零的所有币种时，才添加 --all
• 查询单个币种余额（交易前检查某个币种）：gate-cli cex spot account get --currency=…
• 一般性的“可用资金”查询（尚未选定具体币种时）：优先使用 gate-cli cex spot account list 查看完整表格；如果工作流中已指定一个 currency，则使用 gate-cli cex spot account get
• 规则校验：gate-cli cex spot market pair
• 实时价格和涨跌情况：gate-cli cex spot market tickers
• 下单：gate-cli cex spot order buy / gate-cli cex spot order sell / gate-cli cex spot order batch-create
• 创建／查询／取消触发单：gate-cli cex spot price-trigger create / gate-cli cex spot price-trigger list / gate-cli cex spot price-trigger get / gate-cli cex spot price-trigger cancel / gate-cli cex spot price-trigger cancel-all
• 取消／修改订单：gate-cli cex spot order cancel / gate-cli cex spot order batch-cancel / gate-cli cex spot order amend / gate-cli cex spot order batch-amend
• 查询未完成订单：gate-cli cex spot order list（使用 status=open）
• 成交验证：gate-cli cex spot order my-trades
• 账户变更历史：gate-cli cex spot account book
• 批量查询手续费：gate-cli cex spot account batch-fee

步骤 5：返回可执行的结果和状态

回复必须包含：

• 是否执行成功（如果未执行，说明原因）
• 核心数值（价格、数量、金额、余额变化）
• 如果未满足条件，明确说明为何当前未下单

场景路由表（1-37）

A. 买入与账户查询（1-8）

场景	用户意图	核心决策	工具调用顺序
1	市价买入	USDT 余额充足时执行市价买入	gate-cli cex spot account get → gate-cli cex spot order buy / gate-cli cex spot order sell
2	按目标价格买入	创建 limit buy 订单	gate-cli cex spot account get → gate-cli cex spot order buy / gate-cli cex spot order sell
3	使用全部余额买入	使用全部可用 USDT 余额买入	gate-cli cex spot account get → gate-cli cex spot order buy / gate-cli cex spot order sell
4	买入准备情况检查	币种状态 + 最小数量 + 当前单价	gate-cli cex spot market currency → gate-cli cex spot market pair → gate-cli cex spot market tickers
5	资产汇总	将所有持仓折算为 USDT 价值	gate-cli cex spot account list → gate-cli cex spot market tickers
37	列出现货余额 / 查看现货账户余额	显示所有非零现货余额行（表格）；如果用户也想查看余额为零的币种，则使用 --all	gate-cli cex spot account list
6	全部取消后查询余额	取消该用户交易对的所有未完成订单（对该 --pair 使用带 --all 的 gate-cli cex spot order cancel），并返回余额	gate-cli cex spot order cancel → gate-cli cex spot account get
7	卖出零散余额	仅在达到最小数量要求时卖出	gate-cli cex spot account get → gate-cli cex spot market pair → gate-cli cex spot order buy / gate-cli cex spot order sell
8	余额与最低买入额检查	仅当账户余额和 min_quote_amount 均满足要求时下单	gate-cli cex spot account get → gate-cli cex spot market pair → gate-cli cex spot order buy / gate-cli cex spot order sell

B. 智能监控与交易（9-16）

案例	用户意图	核心决策	工具序列
9	低 2% 买入	以当前价格 -2% 挂限价买单	gate-cli cex spot market tickers → gate-cli cex spot order buy / gate-cli cex spot order sell
10	涨 500 卖出	以当前价格 +500 挂限价卖单	gate-cli cex spot market tickers → gate-cli cex spot order buy / gate-cli cex spot order sell
11	接近今日低点时买入	仅当当前价格接近 24h 低点时买入	gate-cli cex spot market tickers → gate-cli cex spot order buy / gate-cli cex spot order sell
12	按要求下跌 5% 后卖出	计算目标跌幅价格并挂限价卖单	gate-cli cex spot market tickers → gate-cli cex spot order buy / gate-cli cex spot order sell
13	买入涨幅最高的币种	自动选出 24h 涨幅最高的币种并买入	gate-cli cex spot market tickers → gate-cli cex spot order buy / gate-cli cex spot order sell
14	买入跌幅较大的币种	比较 BTC/ETH 的日跌幅并买入跌幅较大的币种	gate-cli cex spot market tickers → gate-cli cex spot order buy / gate-cli cex spot order sell
15	买入后挂卖单	市价买入，然后以参考价格 +2% 挂卖单	gate-cli cex spot order buy / gate-cli cex spot order sell → gate-cli cex spot order buy / gate-cli cex spot order sell
16	手续费估算	根据费率和实时价格估算总成本	gate-cli cex wallet market trade-fee → gate-cli cex spot market tickers

C. 订单管理与修改（17-25）

案例	用户意图	核心决策	工具序列
17	提高未成交订单的价格	确认要提高多少（或目标价格），查找未成交的买单；如有多个订单，确认要修改哪一个，然后修改限价	gate-cli cex spot order list(status=open) → gate-cli cex spot order amend
18	确认成交情况和持仓	最近一次买入的成交数量 + 当前总持仓	gate-cli cex spot order my-trades → gate-cli cex spot account get
19	未成交则取消	如果订单仍未成交，则取消订单，然后重新检查余额	gate-cli cex spot order list(status=open) → gate-cli cex spot order cancel → gate-cli cex spot account get
20	按最近成交价重新买入	使用最近的成交价，检查余额，然后挂限价买单	gate-cli cex spot order my-trades → gate-cli cex spot account get → gate-cli cex spot order buy / gate-cli cex spot order sell
21	保本或更高价格卖出	仅当当前价格高于成本价时卖出	gate-cli cex spot order my-trades → gate-cli cex spot market tickers → gate-cli cex spot order buy / gate-cli cex spot order sell
22	资产兑换	估算资产价值，若 >=10U 则先卖出再买入	gate-cli cex spot account get → gate-cli cex spot market tickers → gate-cli cex spot order buy / gate-cli cex spot order sell(sell) → gate-cli cex spot order buy / gate-cli cex spot order sell(buy)
23	达到价格条件时买入	仅当 current < 60000 时买入，然后报告余额	gate-cli cex spot market tickers → gate-cli cex spot order buy / gate-cli cex spot order sell → gate-cli cex spot account get
24	满足趋势条件时买入	最近 4 根小时 K 线中有 3 根看涨时才买入	gate-cli cex spot market candlesticks → gate-cli cex spot order buy / gate-cli cex spot order sell
25	快速成交的限价买单	使用对手盘的最优价格以快速成交	gate-cli cex spot market orderbook → gate-cli cex spot order buy / gate-cli cex spot order sell

D. 高级现货实用工具（26-31）

案例	用户意图	核心决策	工具序列
26	筛选并批量取消选定的未结订单	确认目标订单 ID 存在于未结订单中，显示候选列表，仅在用户确认后取消	gate-cli cex spot order list(status=open) → gate-cli cex spot order batch-cancel
27	市场滑点模拟	根据订单簿卖单模拟名义买入的平均成交价，并与最新价格比较	gate-cli cex spot market orderbook → gate-cli cex spot market tickers
28	批量下买单	检查所需报价资产总额与可用余额，然后下达多笔订单组合	gate-cli cex spot account get → gate-cli cex spot order batch-create
29	跨交易对费率比较	比较费率等级，并将手续费影响换算为预估成本	gate-cli cex spot account batch-fee → gate-cli cex spot market tickers
30	账户账簿审计 + 当前余额	显示某种币的近期账簿变动和当前剩余余额	gate-cli cex spot account book → gate-cli cex spot account get
31	将未结买单批量调高 1%	按交易对筛选未结订单，最多选取 5 笔目标买单，重新定价并在用户确认后批量修改	gate-cli cex spot order list(status=open) → gate-cli cex spot order batch-amend

E. 触发订单和 TP/SL 自动化（32-36）

案例	用户意图	核心决策	工具序列
32	条件买入触发订单	读取当前 BTC 价格，计算下跌 5% 后的触发价格，确认后下达买入触发订单	gate-cli cex spot market tickers → gate-cli cex spot price-trigger create
33	设置双重 TP/SL 触发单	检查 ETH 可用余额，创建 TP 和 SL 触发单，确认后同时下达	gate-cli cex spot account get → gate-cli cex spot price-trigger create → gate-cli cex spot price-trigger create
34	查询单个触发订单进度	读取触发订单详情，并与实时市场价格比较，计算距触发价格的距离	gate-cli cex spot price-trigger get → gate-cli cex spot market tickers
35	批量取消 BTC 买入触发订单	列出未结触发订单，筛选 BTC 买入方向，确认范围后批量取消	gate-cli cex spot price-trigger list(status=open) → gate-cli cex spot price-trigger cancel-all
36	取消单个触发单/TP-SL 订单	确认一个目标触发订单处于活动状态，然后在确认后取消	gate-cli cex spot price-trigger get → gate-cli cex spot price-trigger cancel

判断逻辑摘要

条件	操作
用户要求查看/列出现货账户余额，或询问“我的现货余额”，但未指定单个币种	使用 gate-cli cex spot account list（如果用户需要查看余额为零的币种，则添加 --all）
用户要求在买入前检查余额（交易对/币种已知）	必须按需调用 gate-cli cex spot account get（指定 currency）或 gate-cli cex spot account list；仅在余额充足时下单
用户指定以目标价格买入/卖出	使用 type=limit，价格设为用户提供的价格
用户要求以当前市场价尽快成交	优先使用 market；如果用户要求“快速限价”，则使用最优盘口价格
市价买入（buy）	amount 填写 USDT 报价金额，而非基础币数量
市价卖出（sell）	amount 填写基础币数量，而非 USDT 金额
用户要求止盈/止损	使用触发单工作流：验证持仓规模，拟定止盈和止损单，然后仅在获得明确确认后下单
任何下单请求	调用 gate-cli cex spot order buy / gate-cli cex spot order sell 前，必须获得用户明确的最终确认
用户尚未明确确认	保留订单草稿；不得执行交易
确认已过期，或并非来自紧接着的上一轮对话	确认失效，必须重新获得确认
多腿交易流程	每次调用 gate-cli cex spot order buy / gate-cli cex spot order sell 前，都必须逐腿获得确认
用户要求修改未成交的买单	调用 gate-cli cex spot order amend 前，确认涨价幅度或确切目标价格
有多个未结买单符合修改请求	执行前询问用户要修改哪张订单
用户要求批量取消指定订单	核实每个订单 ID 存在且处于未结状态，展示清单，并仅在用户核对后运行 gate-cli cex spot order batch-cancel
用户要求批量修改未结订单	筛选目标交易对中未结的买单（最多 5 张），计算调整后的价格档位，并仅在用户核对后运行 gate-cli cex spot order batch-amend
用户要求查询触发单进度	读取一张触发单，并将当前 ticker 价格与触发条件比较；返回数值距离
用户要求批量取消触发单	按交易对和买卖方向筛选触发单，展示取消范围，然后在获得确认后调用 gate-cli cex spot price-trigger cancel-all
用户要求取消单张触发单	确认订单仍有效且符合用户意图，然后在获得确认后调用 gate-cli cex spot price-trigger cancel
用户要求模拟市价滑点	使用订单簿深度模拟，并比较加权成交价与 ticker 最新价
用户要求一键买入多种币	验证报价金额总需求，然后使用 gate-cli cex spot order batch-create
用户要求比较多个交易对的手续费	使用 gate-cli cex spot account batch-fee，并结合最新价格换算为成本影响
用户要求查询某个币种的账户流水	使用 gate-cli cex spot account book，然后与 gate-cli cex spot account get 的结果核对
用户输入的金额过小	检查 min_quote_amount；如果未达到要求，请用户增加金额
用户要求全仓买入/卖出	使用可用余额，然后按最低交易规则调整金额
未满足触发条件	不要下单；返回当前价格与目标价格之间的差距

报告模板

## Execution Result

| Item | Value |
|------|-----|
| Scenario | {case_name} |
| Pair | {currency_pair} |
| Action | {action} |
| Status | {status} |
| Key Metrics | {key_metrics} |

{decision_text}

decision_text 示例：

• ✅ Condition met. Your order has been placed.
• 📝 Order draft ready. Reply "Confirm order" to execute.
• ⏸️ No order placed yet: current price is 60200, above your target 60000.
• ❌ Not executed: minimum order amount is 10U, your input is 5U.

错误处理

错误类型	常见原因	处理策略
余额不足	可用 USDT/币种余额不足	返回差额，并建议减少订单规模
最小交易量限制	未达到最小金额/数量	返回阈值，并建议增加订单规模
触发订单参数不匹配	触发规则/价格/方向与用户意图不一致	返回规范化的触发订单草案，并要求用户重新确认
缺少最终确认	用户尚未明确批准最终订单摘要	保持订单待处理状态，并请求明确确认
确认已过期	确认与当前草案不符，或不是在上一轮对话中作出的	拒绝执行，并要求重新确认
仅草案模式	用户尚未确认	仅运行查询/估算工具；不要调用 gate-cli cex spot order buy / gate-cli cex spot order sell、gate-cli cex spot order batch-create 或 gate-cli cex spot price-trigger create
修改目标不明确	有多个候选未成交买单	保持待处理状态，并请用户确认订单 ID/行
批量撤单目标不明确	部分指定的订单 ID 不存在/未处于未成交状态	返回匹配与未匹配的 ID，并请求重新确认
批量修改目标不明确	候选订单集合不明确或超过最大选择数量	执行前请用户确认确切的订单 ID（最多 5 个）
订单不存在/已成交	修改/撤单目标无效	请用户刷新未成交订单后重试
未满足市场条件	未满足触发条件	返回当前价格、目标价格及差值
交易对不可用	该币种已暂停交易或状态异常	明确说明该交易对当前无法交易

跨技能工作流

工作流 A：买入后修改

1. 使用 gate-exchange-spot 下单（案例 2/9/23）
2. 如果订单仍未成交，则修改价格（案例 17）

工作流 B：撤单后重新买入

1. 撤销所有未成交订单以释放资金（案例 6）
2. 根据更新后的策略重新下单（案例 1/2/9）

安全规则

• 对于全仓/全部余额/一键操作请求，执行前重述关键金额和币种。
• 对于基于条件的请求，明确说明触发阈值的计算方式。
• 对于现货的 TP/SL 类请求，使用此技能中的价格触发工作流；不要暗示 CEX 支持未提供的功能——先起草触发条件单并确认，然后再调用 gate-cli cex spot price-trigger create。
• 提交任何订单前，始终请求用户明确进行最终确认。
• 未获得明确确认时，保持在草案/查询/估算模式，绝不执行交易下单。
• 不要重复使用旧确认；如有任何变更，重新起草并再次确认。
• 对于快速成交请求，提醒用户注意可能的滑点或订单簿深度限制。
• 对于链式操作（先卖后买），清晰汇报每一步的结果。
• 如果任何条件未满足，不要强行执行；请说明原因并提供替代方案。