From 4cb8c93cf1784a8e33458000156e6db22271b500 Mon Sep 17 00:00:00 2001
From: Administrator <15274802129@163.com>
Date: Thu, 14 May 2026 15:40:21 +0800
Subject: [PATCH] refactor(gateApi): 重构网格交易策略核心逻辑
---
src/main/java/com/xcong/excoin/modules/gateApi/GateGridTradeService.java | 142 +++++++++++++++++++++++++++--------------------
1 files changed, 81 insertions(+), 61 deletions(-)
diff --git a/src/main/java/com/xcong/excoin/modules/gateApi/GateGridTradeService.java b/src/main/java/com/xcong/excoin/modules/gateApi/GateGridTradeService.java
index 15b2441..409f59c 100644
--- a/src/main/java/com/xcong/excoin/modules/gateApi/GateGridTradeService.java
+++ b/src/main/java/com/xcong/excoin/modules/gateApi/GateGridTradeService.java
@@ -13,7 +13,8 @@
import java.math.RoundingMode;
import java.util.ArrayList;
import java.util.Collections;
-import java.util.HashMap;
+import java.util.Iterator;
+import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
@@ -32,14 +33,14 @@
* <ul>
* <li><b>条件开仓单</b>：使用 Gate API {@code FuturesPriceTriggeredOrder}，服务器监控价格，
* 达到触发价后以市价 IOC 开仓。相比限价单，条件单仅在触发价到达时才执行，避免提前成交。</li>
- * <li><b>止盈队列</b>（longTakeProfitQueue / shortTakeProfitQueue）：每次网格触发时，
- * 将新队列首元素加减 step 作为止盈价加入止盈队列。仓位推送回调中检测到净增张数后，
- * 从止盈队列头部取出止盈价，创建止盈条件单。</li>
- * <li><b>条件单 ID 集合</b>（currentLongOrderIds / currentShortOrderIds）：
- * 用同步列表管理所有活跃的条件单 ID。每次网格触发时，取消对方方向的旧条件单（防止堆积），
- * 再挂新的条件单。反向条件单的 ID 也存入对应方向集合统一管理。</li>
+ * <li><b>条件单 ID 映射</b>（currentLongOrderIds / currentShortOrderIds）：
+ * 用同步 Map 管理所有活跃的条件单（订单ID → 止盈价格）。挂条件单时通过回调存入，
+ * 订单成交后通过 {@code futures.orders} 推送匹配止盈价并挂止盈单。</li>
+ * <li><b>订单订阅（futures.orders）</b>：订单成交（status=finished, finish_as=filled）时，
+ * 通过 {@link #onOrderUpdate(String, String, String)} 从 Map 中取出止盈价，
+ * 调用 {@code executor.placeTakeProfit} 创建止盈条件单。</li>
* <li><b>反向条件单</b>：当新网格首元素价格夹在多/空持仓均价之间，
- * 且反向持仓张数不超过 3 张时，额外挂一张反向条件单并加入对方止盈队列。</li>
+ * 且反向持仓张数不超过 3 张时，额外挂一张反向市价单，通过订单订阅自动挂止盈。</li>
* </ul>
*
* <h3>状态机</h3>
@@ -53,11 +54,10 @@
* ├─ 每根K线 → 更新 unrealizedPnl → 方向判断
* │ ├─ closePrice > longPriceQueue[0] → processLongGrid
* │ └─ closePrice < shortPriceQueue[0] → processShortGrid
- * ├─ processShortGrid: 匹配空仓队列 → 队列转移 → 止盈入队 →
- * │ 取消旧多仓条件单 → 挂新空仓+多仓条件单 → 条件满足挂反向多单
- * ├─ processLongGrid: 匹配多仓队列 → 队列转移 → 止盈入队 →
- * │ 取消旧空仓条件单 → 挂新多仓+空仓条件单 → 条件满足挂反向空单
- * ├─ 仓位推送(净增张数) → 从止盈队列取止盈价 → 创建止盈条件单（plan-close-*-position）
+ * ├─ processShortGrid: 匹配空仓队列 → 本队补充 → 挂空仓+多仓条件单（止盈价存入Map）
+ * ├─ processLongGrid: 匹配多仓队列 → 本队补充 → 挂多仓+空仓条件单（止盈价存入Map）
+ * ├─ 订单推送(futures.orders) → onOrderUpdate → Map 匹配止盈价 → 挂止盈条件单
+ * ├─ 仓位推送 → 更新均价/持仓量、仓位减少时处理反向单
* ├─ 平仓推送 → 累加 cumulativePnl
* ├─ 保证金安全阀 → 超限跳过挂单，队列照常更新
* └─ cumulativePnl ≥ overallTp 或 ≤ -maxLoss → STOPPED
@@ -74,11 +74,11 @@
*
* <h3>止盈机制</h3>
* <ul>
- * <li>网格触发时，新队列首元素 ± step 作为止盈价加入止盈队列。</li>
- * <li>仓位推送检测到净增张数时，从止盈队列头部取止盈价创建止盈条件单。</li>
+ * <li>网格触发时，挂条件单的回调中将订单 ID 和止盈价存入 currentLongOrderIds / currentShortOrderIds Map。</li>
+ * <li>条件单成交后，{@code futures.orders} 推送触发 {@link #onOrderUpdate}，
+ * 通过订单 ID 取出止盈价，创建止盈条件单（plan-close-*-position）。</li>
* <li>止盈条件单：以触发价监控（price_type=最新价，strategy_type=价格触发），
* 到达后以市价 IOC 平仓（reduce_only=true，price="0"）。</li>
- * <li>止盈队列为空时兜底：entryPrice ± step 作为止盈价。</li>
* </ul>
*
* <h3>反向条件单条件</h3>
@@ -86,7 +86,7 @@
* newFirstPrice > shortEntryPrice AND newFirstPrice < longEntryPrice
* AND 反向持仓张数 < 3
* </pre>
- * 满足条件时以 newFirstPrice 为触发价挂反向条件单，同时将 newFirstPrice ± step 加入对方止盈队列。
+ * 满足条件时以 newFirstPrice ± step 为止盈价直接挂市价单，通过订单订阅自动挂止盈。
*
* <h3>未实现盈亏公式（正向合约）</h3>
* <pre>
@@ -131,19 +131,14 @@
/** 多仓价格队列，升序排列（小→大），容量 gridQueueSize */
private final List<BigDecimal> longPriceQueue = Collections.synchronizedList(new ArrayList<>());
- /** 多仓止盈队列，升序排列（小→大），仓位推送时消费 */
- private final List<BigDecimal> longTakeProfitQueue = Collections.synchronizedList(new ArrayList<>());
- /** 空仓止盈队列，降序排列（大→小），仓位推送时消费 */
- private final List<BigDecimal> shortTakeProfitQueue = Collections.synchronizedList(new ArrayList<>());
-
/** 当前多仓条件单映射：订单ID → 止盈价格，订单成交后通过订单订阅推送匹配止盈 */
- private final Map<String, BigDecimal> currentLongOrderIds = Collections.synchronizedMap(new HashMap<>());
+ private final Map<String, BigDecimal> currentLongOrderIds = Collections.synchronizedMap(new LinkedHashMap<>());
/** 当前空仓条件单映射：订单ID → 止盈价格，订单成交后通过订单订阅推送匹配止盈 */
- private final Map<String, BigDecimal> currentShortOrderIds = Collections.synchronizedMap(new HashMap<>());
+ private final Map<String, BigDecimal> currentShortOrderIds = Collections.synchronizedMap(new LinkedHashMap<>());
/** 基底空头入场价 */
private BigDecimal shortBaseEntryPrice;
- /** 基底多头入场价 */
+ /** 基底多头入场价（仅记录，当前未被业务逻辑消费，保留以备后续使用） */
private BigDecimal longBaseEntryPrice;
/** 基底多头是否已开 */
private volatile boolean baseLongOpened = false;
@@ -322,8 +317,6 @@
shortActive = false;
shortPriceQueue.clear();
longPriceQueue.clear();
- longTakeProfitQueue.clear();
- shortTakeProfitQueue.clear();
currentLongOrderIds.clear();
currentShortOrderIds.clear();
log.info("[Gate] 网格策略已启动");
@@ -396,11 +389,14 @@
* <li><b>有仓位 (size ≠ 0)</b>：
* <ul>
* <li>首次开仓（基底）：标记 baseOpened=true，记录基底入场价，双基底都成交后生成网格队列</li>
- * <li>仓位净增加（size > 之前记录值）：说明网格触发了新开仓 → 取对应方向队列首元素为止盈价，设止盈条件单</li>
- * <li>仓位减少或不变（止盈平仓后）：仅更新 positionSize，不重复设止盈</li>
+ * <li>仓位净减少（size.abs() < 之前记录值）：止盈平仓后 → 检查反向条件单条件 →
+ * 满足时以 entryPrice ± step 为止盈价挂反向市价单（订单ID + 止盈价存入 Map）</li>
+ * <li>仓位净增加或不变：仅更新 positionSize，止盈由 {@link #onOrderUpdate} 通过订单订阅匹配处理</li>
* </ul>
* </li>
* <li><b>无仓位 (size = 0)</b>：清空活跃标记和持仓量</li>
+ * <li><b>Map 截断</b>：currentLongOrderIds / currentShortOrderIds 超过 5 个时，
+ * 从 LinkedHashMap 头部删除最旧条目，保留最新 5 个</li>
* </ul>
*
* @param contract 合约名称
@@ -444,6 +440,15 @@
longActive = false;
longPositionSize = BigDecimal.ZERO;
}
+ synchronized (currentLongOrderIds) {
+ if (currentLongOrderIds.size() > 5) {
+ Iterator<String> it = currentLongOrderIds.keySet().iterator();
+ for (int i = 0, remove = currentLongOrderIds.size() - 5; i < remove; i++) {
+ it.next();
+ it.remove();
+ }
+ }
+ }
} else if (Position.ModeEnum.DUAL_SHORT == mode) {
if (hasPosition) {
shortActive = true;
@@ -471,6 +476,15 @@
} else {
shortActive = false;
shortPositionSize = BigDecimal.ZERO;
+ }
+ synchronized (currentShortOrderIds) {
+ if (currentShortOrderIds.size() > 5) {
+ Iterator<String> it = currentShortOrderIds.keySet().iterator();
+ for (int i = 0, remove = currentShortOrderIds.size() - 5; i < remove; i++) {
+ it.next();
+ it.remove();
+ }
+ }
}
}
}
@@ -543,12 +557,13 @@
* 尝试生成网格队列。双基底（多+空）都成交后才触发：
* <ol>
* <li>生成空仓价格队列（降序）和多仓价格队列（升序）</li>
- * <li>初始化止盈队列：多仓首元素 + step、空仓首元素 − step</li>
- * <li>挂初始多仓条件单（触发价 = 多仓队列首元素，rule=NUMBER_1 ≥触发价时开多）</li>
- * <li>挂初始空仓条件单（触发价 = 空仓队列首元素，rule=NUMBER_2 ≤触发价时开空）</li>
- * <li>条件单 ID 存入对应 currentXxxOrderIds 集合</li>
+ * <li>挂初始多仓条件单（触发价 = 多仓队列首元素，rule=NUMBER_1 ≥触发价时开多），
+ * 止盈价 = 触发价 + step，通过 onSuccess 回调将 orderId → 止盈价存入 currentLongOrderIds</li>
+ * <li>挂初始空仓条件单（触发价 = 空仓队列首元素，rule=NUMBER_2 ≤触发价时开空），
+ * 止盈价 = 触发价 − step，通过 onSuccess 回调将 orderId → 止盈价存入 currentShortOrderIds</li>
* <li>状态切换为 ACTIVE</li>
* </ol>
+ * 条件单成交后由 {@link #onOrderUpdate} 匹配止盈价并挂止盈条件单。
*/
private void tryGenerateQueues() {
if (baseLongOpened && baseShortOpened) {
@@ -627,20 +642,17 @@
* <h3>执行流程</h3>
* <ol>
* <li>匹配队列元素 → 为空则直接返回，不触发</li>
- * <li>空仓队列：移除 matched 元素，从尾部最小值递减 step 补充等量新元素，重新降序排序</li>
- * <li>多仓队列：以多仓首元素（最小价）为基准递减 step，生成 matched.size() 个新元素加入，
- * 升序排序，超限截尾</li>
- * <li>空仓止盈队列：始终加入新空仓首元素 − step（降序排序），不受守卫限制</li>
- * <li>保证金检查 → 不安全则跳过挂单（队列和止盈队列照常更新），安全则继续</li>
- * <li>挂新空仓条件单（触发价 = 新空仓首元素，rule=NUMBER_2 ≤触发价时开空，size=负）</li>
- * <li>多仓条件单守卫：newLongFirst < longEntryPrice 时才执行
- * → 取消所有旧多仓条件单（currentLongOrderIds） → 清空集合 →
- * 多仓止盈队列加入 newLongFirst + step →
- * 挂新多仓条件单（触发价 = newLongFirst，rule=NUMBER_1 ≥触发价时开多，size=正）；
- * 不满足时保持旧多仓条件单不变，也不更新多仓止盈队列</li>
- * <li>反向开多判断：newShortFirst > shortEntryPrice 且 < longEntryPrice 且 longPositionSize < 3
- * → 挂反向条件多单（触发价 = newShortFirst），止盈价 = newShortFirst + step 加入多仓止盈队列</li>
+ * <li>空仓队列：移除 matched 元素，从尾部递减 step 补充等量新元素，重新降序排序</li>
+ * <li>多仓队列：<b>不再更新</b>（队列转移逻辑已移除）</li>
+ * <li>保证金检查 → 不安全则跳过挂单（队列照常更新），安全则继续</li>
+ * <li>挂新空仓条件单（触发价 = newShortFirst，rule=NUMBER_2，止盈 = newShortFirst − step，
+ * orderId → 止盈价存入 currentShortOrderIds）</li>
+ * <li>多仓条件单守卫：newLongFirst = newShortFirst + step × 2，
+ * 若 newLongFirst < longEntryPrice → 挂多仓条件单（止盈 = newLongFirst + step，
+ * orderId → 止盈价存入 currentLongOrderIds）</li>
* </ol>
+ * 条件单成交后由 {@link #onOrderUpdate} 匹配止盈价并挂止盈条件单。
+ * 反向条件单不再在此处理，改为在 {@link #onPositionUpdate} 仓位净减少时触发。
*
* @param currentPrice 当前 K 线收盘价（最新成交价）
*/
@@ -670,6 +682,19 @@
}
shortPriceQueue.sort((a, b) -> b.compareTo(a));
}
+
+// synchronized (longPriceQueue) {
+// BigDecimal first = longPriceQueue.isEmpty() ? matched.get(matched.size() - 1) : longPriceQueue.get(0);
+// BigDecimal gridStep = config.getStep();
+// for (int i = 1; i <= matched.size(); i++) {
+// BigDecimal elem = first.subtract(gridStep.multiply(BigDecimal.valueOf(i))).setScale(1, RoundingMode.HALF_UP);
+// longPriceQueue.add(elem);
+// }
+// longPriceQueue.sort(BigDecimal::compareTo);
+// while (longPriceQueue.size() > config.getGridQueueSize()) {
+// longPriceQueue.remove(longPriceQueue.size() - 1);
+// }
+// }
if (!isMarginSafe()) {
log.warn("[Gate] 保证金超限，跳过挂条件单");
@@ -707,20 +732,17 @@
* <h3>执行流程</h3>
* <ol>
* <li>匹配队列元素 → 为空则直接返回，不触发</li>
- * <li>多仓队列：移除 matched 元素，从尾部最大值递增 step 补充等量新元素，重新升序排序</li>
- * <li>空仓队列：以空仓首元素（最高价）为基准递增 step，生成 matched.size() 个新元素加入，
- * 降序排序，超限截尾</li>
- * <li>多仓止盈队列：始终加入新多仓首元素 + step（升序排序），不受守卫限制</li>
- * <li>保证金检查 → 不安全则跳过挂单（队列和止盈队列照常更新），安全则继续</li>
- * <li>挂新多仓条件单（触发价 = 新多仓首元素，rule=NUMBER_1 ≥触发价时开多，size=正）</li>
- * <li>空仓条件单守卫：newShortFirst > shortEntryPrice 时才执行
- * → 取消所有旧空仓条件单（currentShortOrderIds） → 清空集合 →
- * 空仓止盈队列加入 newShortFirst − step →
- * 挂新空仓条件单（触发价 = newShortFirst，rule=NUMBER_2 ≤触发价时开空，size=负）；
- * 不满足时保持旧空仓条件单不变，也不更新空仓止盈队列</li>
- * <li>反向开空判断：newLongFirst > shortEntryPrice 且 < longEntryPrice 且 shortPositionSize < 3
- * → 挂反向条件空单（触发价 = newLongFirst），止盈价 = newLongFirst − step 加入空仓止盈队列</li>
+ * <li>多仓队列：移除 matched 元素，从尾部递增 step 补充等量新元素，重新升序排序</li>
+ * <li>空仓队列：<b>不再更新</b>（队列转移逻辑已移除）</li>
+ * <li>保证金检查 → 不安全则跳过挂单（队列照常更新），安全则继续</li>
+ * <li>挂新多仓条件单（触发价 = newLongFirst，rule=NUMBER_1，止盈 = newLongFirst + step，
+ * orderId → 止盈价存入 currentLongOrderIds）</li>
+ * <li>空仓条件单守卫：newShortFirst = newLongFirst − step × 2，
+ * 若 newShortFirst > shortEntryPrice → 挂空仓条件单（止盈 = newShortFirst − step，
+ * orderId → 止盈价存入 currentShortOrderIds）</li>
* </ol>
+ * 条件单成交后由 {@link #onOrderUpdate} 匹配止盈价并挂止盈条件单。
+ * 反向条件单不再在此处理，改为在 {@link #onPositionUpdate} 仓位净减少时触发。
*
* @param currentPrice 当前 K 线收盘价（最新成交价）
*/
@@ -758,13 +780,11 @@
// for (int i = 1; i <= matched.size(); i++) {
// BigDecimal elem = first.add(gridStep.multiply(BigDecimal.valueOf(i))).setScale(1, RoundingMode.HALF_UP);
// shortPriceQueue.add(elem);
-// log.info("[Gate] 空队列增加:{}", elem);
// }
// shortPriceQueue.sort((a, b) -> b.compareTo(a));
// while (shortPriceQueue.size() > config.getGridQueueSize()) {
// shortPriceQueue.remove(shortPriceQueue.size() - 1);
// }
-// log.info("[Gate] 现空队列:{}", shortPriceQueue);
// }
--
Gitblit v1.9.1