路由规则

MCP 工具

| 工具 | 用途

---|---|---
1 | cex_fx_get_fx_tickers | 获取所有期货交易对信息（用于涨幅榜/跌幅榜排序）
2 | cex_fx_get_fx_contract | 获取单个合约信息（精度、乘数等）
3 | cex_fx_get_fx_order_book | 获取合约订单簿（最佳买卖价）
4 | cex_fx_get_fx_accounts | 获取期货账户（持仓模式：单向/双向）
5 | cex_fx_list_fx_positions | 列出持仓（双向模式）
6 | cex_fx_get_fx_dual_position | 获取合约的双向模式持仓
7 | cex_fx_get_fx_position | 获取合约的单向模式持仓
8 | cex_fx_update_fx_dual_position_cross_mode | 切换保证金模式（全仓/逐仓）
9 | cex_fx_update_fx_position_cross_mode | 在单向模式中切换保证金模式（切勿在双向模式中使用）
10 | cex_fx_update_fx_dual_position_leverage | 设置杠杆（双向模式）
11 | cex_fx_update_fx_position_leverage | 设置杠杆（单向模式，切勿在双向模式中使用）
12 | cex_fx_create_fx_order | 下单（开仓/平仓/反向）
13 | cex_fx_list_fx_orders | 列出订单
14 | cex_fx_get_fx_order | 获取单个订单详情
15 | cex_fx_cancel_fx_order | 取消单个订单
16 | cex_fx_cancel_all_fx_orders | 取消某个合约的所有订单
17 | cex_fx_amend_fx_order | 修改订单（价格/数量）

执行工作流程

1. 意图和参数

• 确定模块（开仓/平仓/取消/修改/止盈止损/条件单/管理）。
• 提取：contract, side, size, price, leverage（用于开仓/平仓）；trigger_price, trigger_rule, order_size, order_price, order_tif（用于止盈止损/条件单）。
• 涨幅榜/跌幅榜：如果用户请求"top gainer"/"top loser"（或等效词）而不是指定具体合约，则调用 cex_fx_get_fx_tickers(settle="usdt")，按 changePercentage 排序（涨幅榜降序，跌幅榜升序），选择排名第一的合约。然后使用该合约继续开仓流程。
• 参数缺失：如果缺少必需参数（例如数量），询问用户（澄清模式）。

2. 预检

• 合约：调用 cex_fx_get_fx_contract 以确保合约存在且可交易。
• 账户：检查余额和冲突持仓（例如切换保证金模式时）。
• 风险：不要根据 order_price_deviate 预先计算有效的限价价格（实际偏差限制取决于 risk_limit_tier）。在出现 PRICE_TOO_DEVIATED 错误时，从错误消息中显示有效价格范围。
• 结算货币：始终为 usdt，除非用户明确指定了 BTC 结算的合约。
• 保证金模式 vs 持仓模式（仅当用户明确请求了保证金模式且与当前模式不同时）：调用 cex_fx_get_fx_accounts(settle) 以获取持仓模式。从响应 position_mode 中：single = 单向持仓模式，dual = 双向（对冲）持仓模式。从持仓中获取保证金模式：根据上述的双向/单向模式使用持仓查询 → pos_margin_mode（全仓/逐仓）。如果用户未指定保证金模式，则不要切换；在当前模式下下单。
  • 单向持仓 (position_mode === "single")：不要中断。提示用户："您已持有 {currency} 持仓；切换保证金模式也将应用于此持仓。是否继续？"（例如，从合约中获取 currency：BTC_USDT → BTC）。等待用户确认，然后继续。
  • 双向持仓 (position_mode === "dual")：中断流程。告知用户："请先平仓，然后再开新仓。"
• 双向模式 vs 单向模式（API 选择）：首先调用 cex_fx_get_fx_accounts(settle)。如果 position_mode === "dual"（或 in_dual_mode === true）：
  • 持仓 / 杠杆查询：使用 cex_fx_list_fx_positions(settle, holding=true) 或 cex_fx_get_fx_dual_position(settle, contract)。不要在双向模式中使用 cex_fx_get_fx_position（API 返回数组并导致解析错误）。
  • 保证金模式切换：使用 cex_fx_update_fx_dual_position_cross_mode(settle, contract, mode)（不要在双向模式中使用 cex_fx_update_fx_position_cross_mode）。

3. 模块逻辑

模块 A：开仓

1. 单位转换：如果用户未以合约数量指定数量，则区分USDT 成本（"spend 100U"）和USDT 名义价值（"100U worth"），从 cex_fx_get_fx_contract 获取 quanto_multiplier，并从 cex_fx_get_fx_order_book(settle, contract, limit=1) 获取最佳买卖价：
   • USDT 成本（基于保证金）：开多：contracts = cost / (0.0015 + 1/leverage) / quanto_multiplier / order_price；开空：contracts = cost / (0.0015 + 1.00075/leverage) / quanto_multiplier / max(order_price, best_bid)。order_price：限价 → 指定价格；市价 → 最佳卖价（开多）或最佳买价（开空）。leverage 必须来自当前持仓查询（步骤 5）；不要假设默认值。
   • USDT 名义价值（基于名义价值）：买入/开多：contracts = usdt_value / price / quanto_multiplier；卖出/开空：contracts = usdt_value / max(best_bid, order_price) / quanto_multiplier。price：限价 → 指定价格；市价 → 最佳卖价（买入）或最佳买价（卖出）。
   • 标的资产数量（例如 BTC, ETH）：合约数量 = 标的资产数量 ÷ quanto_multiplier
   • 向下取整为整数；必须满足 order_size_min。
2. 模式：仅当用户明确请求时才切换保证金模式：仅当用户明确要求逐仓时才切换到逐仓（例如"isolated"）；仅当用户明确要求全仓时才切换到全仓（例如"cross"）。如果用户未指定保证金模式，则不要切换 — 在当前保证金模式下下单（从持仓 pos_margin_mode 获取）。如果用户明确想要逐仓，请检查杠杆。
3. 模式切换：仅当用户明确请求了保证金模式且该模式与当前模式不同时（当前模式从持仓获取：pos_margin_mode），在调用 cex_fx_update_fx_dual_position_cross_mode/cex_fx_update_fx_position_cross_mode 之前：通过 cex_fx_get_fx_accounts(settle) → position_mode 获取持仓模式（单向/双向）；如果 position_mode === "single"，显示提示 "您已持有 {currency} 持仓；切换保证金模式也将应用于此持仓。是否继续？" 并仅在用户确认后继续；如果 position_mode === "dual"，不要切换 — 中断并告知用户 "请先平仓，然后再开新仓。"
4. 模式切换（无冲突）：仅当用户明确请求全仓或逐仓且目标模式与当前模式不同时：如果没有持仓，或者是单向持仓且用户已确认，则调用 cex_fx_update_fx_dual_position_cross_mode（双向）或 cex_fx_update_fx_position_cross_mode（单向），参数 mode 为 "cross" 或 "isolated"。如果用户未明确请求保证金模式，则不要切换。
5. 杠杆：如果用户指定了杠杆且该杠杆与当前不同（根据上述的双向/单向持仓查询获取），则首先调用双向模式下的 cex_fx_update_fx_dual_position_leverage 或单向模式下的 cex_fx_update_fx_position_leverage，然后继续。如果用户未指定杠杆，则不要更改它 — 使用持仓查询中获取的当前杠杆进行所有计算（例如 USDT 成本公式）。不要默认使用任何值（例如 10 倍或 20 倍）。
6. 下单前确认：从持仓查询（双向：cex_fx_list_fx_positions 或 cex_fx_get_fx_dual_position；单向：cex_fx_get_fx_position）获取合约 + 方向的当前杠杆。显示最终订单摘要（合约、方向、数量、价格或市价、模式、杠杆、预估保证金/强平价）。要求用户确认（例如："回复 'confirm' 以下单。"）。仅在用户确认后下单。
7. 下单：调用 cex_fx_create_fx_order（市价：tif=ioc, price=0）。
8. 验证：通过持仓查询（双向：cex_fx_list_fx_positions(holding=true) 或 cex_fx_get_fx_dual_position；单向：cex_fx_get_fx_position）确认持仓。

模块 B：平仓

1. 持仓：通过持仓查询（双向：cex_fx_list_fx_positions(settle, holding=true) 或 cex_fx_get_fx_dual_position(settle, contract)；单向：cex_fx_get_fx_position(settle, contract)）获取当前 size 和方向。
2. 分支：全部平仓（查询后使用 reduce_only 平仓）；部分平仓（计算数量，cex_fx_create_fx_order reduce_only）；反向持仓（分两步：平仓然后开立相反方向）。
3. 验证：通过步骤 1 中相同的持仓查询确认剩余持仓。

模块 C：取消订单

1. 定位：通过 order_id，或调用 cex_fx_list_fx_orders 让用户选择。
2. 取消：仅使用单个 cex_fx_cancel_fx_order（无批量取消）。
3. 验证：finish_as == cancelled。

模块 D：修改订单

1. 检查：订单状态必须为 open。
2. 精度：根据合约验证新的价格/数量。
3. 修改：调用 cex_fx_amend_fx_order 更新价格或数量。

模块 E：止盈 / 止损

阅读 references/tp-sl.md 获取完整逻辑。要点：

1. 持仓检查：获取当前持仓以确认方向和数量（预检中的双向/单向模式规则适用）。
2. 触发规则自动选择：
   • 多头止盈：trigger_rule = ">="（价格上涨至止盈水平）
   • 多头止损：trigger_rule = "<="（价格下跌至止损水平）
   • 空头止盈：trigger_rule = "<="（价格下跌至止盈水平）
   • 空头止损：trigger_rule = ">="（价格上涨至止损水平）
3. 平仓标志（close, auto_size, 和 order_type 取决于持仓模式和方向）：
   • 单向模式，全部平仓多头：order_type = "close-long-position", close = true, 无 auto_size, order_reduce_only = true。
   • 单向模式，全部平仓空头：order_type = "close-short-position", close = true, 无 auto_size, order_reduce_only = true。
   • 单向模式，部分平仓多头：order_type = "plan-close-long-position", close = false, 无 auto_size, order_reduce_only = true。
   • 单向模式，部分平仓空头：order_type = "plan-close-short-position", close = false, 无 auto_size, order_reduce_only = true。
   • 双向模式，全部平仓多头：order_type = "close-long-position", close = false, auto_size = "close_long", order_reduce_only = true。
   • 双向模式，全部平仓空头：order_type = "close-short-position", close = false, auto_size = "close_short", order_reduce_only = true。
   • 双向模式，部分平仓多头：order_type = "plan-close-long-position", close = false, 无 auto_size, order_reduce_only = true。
   • 双向模式，部分平仓空头：order_type = "plan-close-short-position", close = false, 无 auto_size, order_reduce_only = true。
4. 数量：如果用户说"close all"或未指定数量，则使用全部平仓（size = 0）并设置上述与模式对应的标志；如果是部分平仓，则计算数量并设置 order_reduce_only = true。
5. 市价 vs 限价：如果用户未指定执行价格，则使用市价（order_price = "0", order_tif = "ioc"）；否则使用限价（order_tif = "gtc"）。
6. 确认：显示摘要（合约、方向、触发价格、触发规则、执行类型、数量或"close all"），并在调用 cex_fx_create_fx_price_triggered_order 之前要求用户确认。

模块 F：条件开仓

阅读 references/conditional.md 获取完整逻辑。要点：

1. 无需持仓：此操作在触发时开立新持仓。
2. 触发规则：用户指定方向 — "buy when drops to X" → trigger_rule = "<=", "buy when breaks above X" → trigger_rule = ">="。
3. 数量转换：与模块 A 相同的单位转换规则（合约数量、USDT 成本、USDT 名义价值、标的资产数量）。使用 cex_fx_get_fx_contract 获取 quanto_multiplier，使用 cex_fx_get_fx_order_book 获取最佳买卖价。对于基于成本的转换，当用户未指定执行限价时，使用 trigger_price 作为参考 order_price。
4. 订单数量符号：正数 = 做多，负数 = 做空。
5. 确认：下单前显示完整摘要。

模块 G：管理触发订单

阅读 references/manage.md 获取完整逻辑。支持：

• 列出：cex_fx_list_fx_price_triggered_orders
• 获取详情：cex_fx_get_fx_price_triggered_order
• 取消单个：cex_fx_cancel_fx_price_triggered_order
• 取消全部：cex_fx_cancel_fx_price_triggered_order_list
• 修改：cex_fx_update_fx_price_triggered_order

修改限制：只有止盈/止损订单（order_type 包含 plan-close-* 或具有 reduce_only/close 标志）支持通过 cex_fx_update_fx_price_triggered_order 直接修改。通过 API 创建的条件开仓订单会返回 APIOrderNotSupportUpdateTouchOrder 并且无法修改 — 必须取消并重新创建。

报告模板

每次操作后，输出一个简短的标准化结果。

对于价格触发订单：

✓ [操作] [合约]
  触发: [规则] [触发价格]
  执行: [市价/限价] × [数量或"全部平仓"] [reduce_only/close]
  订单 ID: [id]

领域知识

• USDT 永续期货：以 USDT 结算的线性合约。持仓数量以合约计量；每个合约代表 quanto_multiplier 单位的标的资产（例如 0.001 BTC）。
• 全仓 vs 逐仓保证金：全仓模式共享整个账户余额作为保证金；逐仓模式将保证金限制为此持仓分配的金额。
• 单向 vs 双向持仓模式：单向模式每个合约持有一个净持仓；双向模式（对冲）允许在同一合约上同时持有多头和空头持仓。两种模式的 API 端点不同。
• 价格触发订单：当市场价格穿过触发水平时触发的条件订单。用于止盈/止损（平掉现有持仓）和条件开仓（开立新持仓）。触发由服务器端执行；客户端无需在线。
• 只减仓：确保订单仅减少现有持仓，而不会意外开立新持仓。始终为止盈/止损订单设置此标志。
• 订单数量符号：对于价格触发的平仓订单，负数数量 = 卖出（平多），正数数量 = 买入（平空）。对于开仓订单，正数 = 做多，负数 = 做空。

安全规则

确认

• 开仓：显示最终订单摘要（合约、方向、数量、价格/市价、模式、杠杆、预估强平/保证金价），然后在调用 cex_fx_create_fx_order 之前要求确认。不要添加关于标记价格与限价价格、order_price_deviate 或建议调整价格的文本。示例："回复 'confirm' 以下单。"
• 全部平仓、反向持仓、批量取消：显示范围并要求确认。示例："平掉所有持仓？回复确认。" / "取消此合约的所有订单。是否继续？"
• 创建止盈/止损 / 条件单：显示完整摘要（合约、触发规则 + 价格、执行价格/类型、数量），然后询问 "回复 'confirm' 以设置此订单。"
• 取消所有触发订单：显示范围（合约或全部）并询问 "取消 [合约] 的所有触发订单？回复确认。"
• 修改触发订单：显示旧值 vs 新值并要求确认。

订单 ID 精度

Gate 订单 ID 是 64 位整数，可能超过 Number.MAX_SAFE_INTEGER（2^53-1）。标准的 JSON 解析器会静默地损坏它们。

• 始终将 order_id 作为字符串传递（例如 "728451920374819843"，而不是 728451920374819843）。
• 从 API 响应中读取订单 ID 时，将其复制为原始字符串标记，切勿作为解析后的数字。
• 向用户显示订单 ID 时，始终以无格式化的字符串形式呈现（无逗号或科学计数法）。

错误处理

每周安装数

64

代码库

gate/gate-skills

GitHub 星标数

12

首次出现

2026年3月7日

安全审计

Gen Agent Trust HubPassSocketWarnSnykWarn

安装于

kimi-cli63

gemini-cli63

amp63

cline63

github-copilot63

codex63