From 1cbbbb86a6ed0036540ff40f9d0051d400d692b4 Mon Sep 17 00:00:00 2001
From: Administrator <15274802129@163.com>
Date: Mon, 11 May 2026 17:01:35 +0800
Subject: [PATCH] refactor(gateApi): 优化网格交易逻辑和止盈策略
---
src/main/java/com/xcong/excoin/modules/gateApi/GateTradeExecutor.java | 70 +++++++++++++++++++++++++++++++----
1 files changed, 62 insertions(+), 8 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 9dbe520..6de0e63 100644
--- a/src/main/java/com/xcong/excoin/modules/gateApi/GateTradeExecutor.java
+++ b/src/main/java/com/xcong/excoin/modules/gateApi/GateTradeExecutor.java
@@ -73,7 +73,8 @@
}
/**
- * 优雅关闭：等待 10 秒，超时则强制中断。
+ * 优雅关闭：等待 10 秒让队列中的任务执行完毕，超时则强制中断。
+ * 关闭后的 REST 调用将通过 CallerRunsPolicy 直接在提交线程执行。
*/
public void shutdown() {
executor.shutdown();
@@ -86,19 +87,36 @@
}
/**
- * 异步市价开多。quantity 为正数（如 "10"）。
+ * 异步 IOC 市价开多。quantity 为正数（如 "1"）。
+ *
+ * @param quantity 开仓张数（正数）
+ * @param onSuccess 成交成功回调（可为 null）
+ * @param onFailure 成交失败回调（可为 null）
*/
public void openLong(String quantity, Runnable onSuccess, Runnable onFailure) {
openPosition(quantity, "t-grid-long", "开多", onSuccess, onFailure);
}
/**
- * 异步市价开空。quantity 为负数（如 "-10"）。
+ * 异步 IOC 市价开空。quantity 为负数（如 "-1"）。
+ *
+ * @param quantity 开仓张数（负数）
+ * @param onSuccess 成交成功回调（可为 null）
+ * @param onFailure 成交失败回调（可为 null）
*/
public void openShort(String quantity, Runnable onSuccess, Runnable onFailure) {
openPosition(quantity, "t-grid-short", "开空", onSuccess, onFailure);
}
+ /**
+ * 通用异步 IOC 市价下单。
+ *
+ * @param size 下单张数（正=开多 / 负=开空）
+ * @param text 订单标记文本（如 "t-grid-long"），用于区分订单来源
+ * @param label 日志标签（如 "开多"/"开空"）
+ * @param onSuccess 成功回调
+ * @param onFailure 失败回调
+ */
private void openPosition(String size, String text, String label, Runnable onSuccess, Runnable onFailure) {
executor.execute(() -> {
try {
@@ -123,13 +141,20 @@
}
/**
- * 异步创建止盈条件单。
- * <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: ≤ 触发价）
- * @param orderType stop 类型（close-long-position / close-short-position）
+ * @param orderType stop 类型（plan-close-long-position / plan-close-short-position）
* @param size 平仓张数（正=平空，负=平多）
*/
public void placeTakeProfit(BigDecimal triggerPrice,
@@ -143,9 +168,30 @@
log.info("[TradeExec] 止盈单已创建, 触发价:{}, 类型:{}, size:{}, id:{}",
triggerPrice, orderType, size, response.getId());
} catch (Exception e) {
- log.error("[TradeExec] 止盈单创建失败, 触发价:{}, size:{}", triggerPrice, size, e);
+ log.error("[TradeExec] 止盈单创建失败, 触发价:{}, size:{}, 立即市价止盈", triggerPrice, size, e);
+ marketClose(size);
}
});
+ }
+
+ /**
+ * 市价止盈：在止盈条件单创建失败时立即市价平仓。
+ * size 与止盈单保持一致（负=平多，正=平空）。
+ */
+ private void marketClose(String size) {
+ try {
+ FuturesOrder order = new FuturesOrder();
+ order.setContract(contract);
+ order.setSize(size);
+ order.setPrice("0");
+ order.setTif(FuturesOrder.TifEnum.IOC);
+ order.setReduceOnly(true);
+ order.setText("t-grid-mkt-close");
+ FuturesOrder result = futuresApi.createFuturesOrder(SETTLE, order, null);
+ log.info("[TradeExec] 市价止盈成功, 价格:{}, size:{}, id:{}", result.getFillPrice(), size, result.getId());
+ } catch (Exception e) {
+ log.error("[TradeExec] 市价止盈也失败, size:{}", size, e);
+ }
}
/**
@@ -164,8 +210,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