From 20b12242108398ad04903e620c94262d4b228ed0 Mon Sep 17 00:00:00 2001
From: Administrator <15274802129@163.com>
Date: Sat, 09 May 2026 18:16:15 +0800
Subject: [PATCH] refactor(gateApi): 优化期货交易配置和日志记录
---
src/main/java/com/xcong/excoin/modules/gateApi/GateTradeExecutor.java | 21 ++++++++++++++++++---
1 files changed, 18 insertions(+), 3 deletions(-)
diff --git a/src/main/java/com/xcong/excoin/modules/gateApi/GateTradeExecutor.java b/src/main/java/com/xcong/excoin/modules/gateApi/GateTradeExecutor.java
index cb10f47..4e695c3 100644
--- a/src/main/java/com/xcong/excoin/modules/gateApi/GateTradeExecutor.java
+++ b/src/main/java/com/xcong/excoin/modules/gateApi/GateTradeExecutor.java
@@ -123,9 +123,16 @@
}
/**
- * 异步创建止盈条件单。
- * <p>使用 Gate 的 PriceTriggeredOrder：服务器监控价格，达到触发价后自动平仓。
- * 每次只平指定张数（size），多次触发的止盈单互不影响。
+ * 异步创建止盈条件单（仓位计划止盈止损）。
+ *
+ * <p>使用 Gate 的 {@code PriceTriggeredOrder} API：服务器监控价格，达到触发价后自动平指定张数。
+ * order_type 使用 {@code plan-close-*-position}（仓位计划止盈止损），
+ * 支持指定 size 部分平仓，多次触发的止盈单互不影响。
+ *
+ * <h3>为何不用 close-*-position</h3>
+ * {@code close-long-position} / {@code close-short-position} 仅支持全部平仓（size=0），
+ * 且双仓模式还需额外设置 {@code auto_size}。网格策略需要指定张数部分平仓，
+ * 因此必须使用 {@code plan-close-long-position} / {@code plan-close-short-position}。
*
* @param triggerPrice 触发价格
* @param rule 触发规则（NUMBER_1: ≥ 触发价，NUMBER_2: ≤ 触发价）
@@ -164,8 +171,16 @@
/**
* 构建 FuturesPriceTriggeredOrder 对象。
+ *
* <p>策略=0（价格触发），price_type=0（最新价），expiration=0（永不过期），
* tif=IOC（立即成交或取消），reduce_only=true（只减仓不开新仓）。
+ *
+ * <h3>size 参数说明</h3>
+ * <ul>
+ * <li>plan-close-long-position：size 为负，表示平多仓多少张</li>
+ * <li>plan-close-short-position：size 为正，表示平空仓多少张</li>
+ * </ul>
+ * 每次只平指定张数，不会全平仓位，多个止盈单可并存且互不影响。
*/
private FuturesPriceTriggeredOrder buildTriggeredOrder(BigDecimal triggerPrice,
FuturesPriceTrigger.RuleEnum rule,
--
Gitblit v1.9.1