From 44b06ecc0a850c6659617a48cd6cba337897cd67 Mon Sep 17 00:00:00 2001
From: Administrator <15274802129@163.com>
Date: Wed, 23 Sep 2026 17:59:37 +0800
Subject: [PATCH] ``` refactor(gateApi): 优化网格交易下单量计算逻辑
---
src/main/java/com/xcong/excoin/modules/gateApi/GateGridTradeService.java | 169 ++++++++++++++++++++++++++++++++++++++++++++++----------
1 files changed, 138 insertions(+), 31 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 b87daf0..3a327f9 100644
--- a/src/main/java/com/xcong/excoin/modules/gateApi/GateGridTradeService.java
+++ b/src/main/java/com/xcong/excoin/modules/gateApi/GateGridTradeService.java
@@ -3,9 +3,13 @@
import cn.hutool.core.collection.CollUtil;
import cn.hutool.core.util.StrUtil;
import com.xcong.excoin.utils.dingtalk.DingTalkUtils;
+import com.google.gson.ExclusionStrategy;
+import com.google.gson.FieldAttributes;
+import com.google.gson.Gson;
import io.gate.gateapi.ApiClient;
import io.gate.gateapi.ApiException;
import io.gate.gateapi.GateApiException;
+import io.gate.gateapi.JSON;
import io.gate.gateapi.api.AccountApi;
import io.gate.gateapi.api.FuturesApi;
import io.gate.gateapi.models.*;
@@ -110,6 +114,11 @@
private final FuturesApi futuresApi;
private static final String SETTLE = "usdt";
+ /** 手动市价平仓遭遇价格保护(MARKET_PRICE_TOO_DEVIATED)后的重试次数 */
+ private static final int CLOSE_POSITION_RETRY_MAX_ATTEMPTS = 3;
+ /** 手动市价平仓遭遇价格保护后的重试间隔（毫秒） */
+ private static final long CLOSE_POSITION_RETRY_DELAY_MS = 800L;
+
private volatile StrategyState state = StrategyState.WAITING_KLINE;
/** 空仓价格队列，降序排列（大→小），容量 gridQueueSize */
@@ -172,8 +181,50 @@
ApiClient apiClient = new ApiClient();
apiClient.setBasePath(config.getRestBasePath());
apiClient.setApiKeySecret(config.getApiKey(), config.getApiSecret());
+ // 修复 gate-api SDK finishAs 枚举不完整导致的反序列化失败（见 buildLenientJson）
+ apiClient.setJSON(buildLenientJson());
this.futuresApi = new FuturesApi(apiClient);
this.executor = new GateTradeExecutor(apiClient, config.getContract());
+ }
+
+ /**
+ * 构建容错的 JSON 序列化器，跳过部分枚举不完整字段的反序列化。
+ *
+ * <p>gate-api SDK 的枚举定义滞后于交易所实际返回值，反序列化未知枚举值时
+ * {@code fromValue} 会抛 {@link IllegalArgumentException}，导致接口被误判为失败。
+ * 已确认业务不使用以下字段，因此通过 Gson 排除策略直接跳过其解析：
+ * <ul>
+ * <li>{@code finishAs}：{@code FuturesOrder.FinishAsEnum} 缺少
+ * {@code price_rate_protected}（价格保护）等值（如日志
+ * {@code Unexpected value 'price_rate_proteced'}）；</li>
+ * <li>{@code posMarginMode}：{@code FuturesPriceTriggeredOrder.PosMarginModeEnum}
+ * 只定义 {@code cross}/{@code dual}，而 {@code cancelPriceTriggeredOrderList}
+ * 会返回组合值 {@code cross|dual}（如日志 {@code Unexpected value 'cross|dual'}）。</li>
+ * </ul>
+ */
+ private static JSON buildLenientJson() {
+ JSON json = new JSON();
+ Gson gson = json.getGson().newBuilder()
+ .setExclusionStrategies(new ExclusionStrategy() {
+ @Override
+ public boolean shouldSkipField(FieldAttributes f) {
+ if ("finishAs".equals(f.getName())) {
+ return true;
+ }
+ // 仅跳过 FuturesPriceTriggeredOrder 的 posMarginMode，避免误伤
+ // FuturesOrder / Position 的同名字段（二者语义为 isolated/cross）
+ return "posMarginMode".equals(f.getName())
+ && FuturesPriceTriggeredOrder.class.equals(f.getDeclaringClass());
+ }
+
+ @Override
+ public boolean shouldSkipClass(Class<?> clazz) {
+ return false;
+ }
+ })
+ .create();
+ json.setGson(gson);
+ return json;
}
// ---- 初始化 ----
@@ -478,7 +529,7 @@
config.isPriceDriveEnabled() &&
longActive == false &&
longPositionSize.compareTo(BigDecimal.ZERO) == 0){
- processShortGrid(closePrice);
+ processLongGrid(closePrice);
}
@@ -486,7 +537,7 @@
config.isPriceDriveEnabled() &&
shortActive == false &&
shortPositionSize.compareTo(BigDecimal.ZERO) == 0){
- processLongGrid(closePrice);
+ processShortGrid(closePrice);
}
}
@@ -897,12 +948,6 @@
generateShortQueue();
generateLongQueue();
updateGridElements();
-
- GridElement baseGridElement = GridElement.findById(0);
- baseGridElement.setLongOrderId(baseLongTraderParam.getEntryOrderId());
- baseGridElement.setHasLongOrder(true);
- baseGridElement.setShortOrderId(baseShortTraderParam.getEntryOrderId());
- baseGridElement.setHasShortOrder(true);
// // 空仓止损对应的多仓止盈：多仓止盈挂在ID=3
// int tpGridIdLong = 3;
@@ -1398,7 +1443,8 @@
}
- private void processShortGrid(BigDecimal currentPrice) {
+ /** 多仓仓位归零后，在当前价上方最近网格重新挂多单（遍历 totalLongPriceQueue 升序）。 */
+ private void processLongGrid(BigDecimal currentPrice) {
BigDecimal matched = BigDecimal.ZERO;
synchronized (totalLongPriceQueue) {
for (BigDecimal p : totalLongPriceQueue) {
@@ -1424,7 +1470,7 @@
// String quantity = String.valueOf(config.getBaseQuantity());
- String quantity = calculateEntryQuantity(true);
+ String quantity = calculateEntryQuantity(true, false);
// 向下检查是否已有多单挂在更低价格网格，有则跳过（防止价格回升后重复挂单）
boolean hasLongOrderBelow = false;
GridElement checkDownCursor = GridElement.findById(newEntryGrid.getDownId());
@@ -1471,7 +1517,8 @@
}
- private void processLongGrid(BigDecimal currentPrice) {
+ /** 空仓仓位归零后，在当前价下方最近网格重新挂空单（遍历 totalShortPriceQueue 降序）。 */
+ private void processShortGrid(BigDecimal currentPrice) {
BigDecimal matched = BigDecimal.ZERO;
synchronized (totalShortPriceQueue) {
for (BigDecimal p : totalShortPriceQueue) {
@@ -1497,7 +1544,7 @@
// String quantity = String.valueOf(Math.max(queryPositionSize(Position.ModeEnum.DUAL_LONG), longPositionSize.intValue()) + Integer.parseInt(config.getQuantity()));
// String quantity = String.valueOf(config.getBaseQuantity());
- String quantity = calculateEntryQuantity(false);
+ String quantity = calculateEntryQuantity(false, false);
// 向上检查是否已有空单挂在更高价格网格，有则跳过（防止价格回落后重复挂单）
boolean hasShortOrderAbove = false;
GridElement checkUpCursor = GridElement.findById(newEntryGrid.getUpId());
@@ -1520,7 +1567,7 @@
GridElement finalCancelCursor = cancelCursor;
executor.cancelConditionalOrder(shortOrderId, oid -> {
shortEntryTraderIdParam(finalCancelCursor, shortOrderId, false);
- log.info("[Gate] 空仓仓位归零, 取消gridId:{}的多单{}", finalCancelCursor.getId(), shortOrderId);
+ log.info("[Gate] 空仓仓位归零, 取消gridId:{}的空单{}", finalCancelCursor.getId(), shortOrderId);
});
}
}
@@ -1531,7 +1578,7 @@
if (!newEntryGrid.isHasShortOrder() && !hasShortOrderAbove){
BigDecimal triggerPrice = newEntryGrid.getGridPrice();
String size = quantity;
- log.info("[Gate] 空仓仓位归零 gridId:{}, 挂{}基础张多单",
+ log.info("[Gate] 空仓仓位归零 gridId:{}, 挂{}基础张空单",
newEntryGrid.getId(), size);
newEntryGrid.getShortTraderParam().setQuantity(size);
placeEntryOrderWithPreFlag(newEntryGrid, false, triggerPrice,
@@ -1565,19 +1612,27 @@
}
/**
- * 根据加仓配置计算止损追单时的实际下单量。
+ * 根据加仓配置计算入场/追单时的实际下单量。
* <p>公式：</p>
* <pre>
* divisor = addPositionInterval + 1
* addMultiplier = floor(effectiveStopLossCount / divisor)
* addQty = addMultiplier × addPositionQuantity
- * finalQty = min(baseQuantity + addQty, maxPositionPerSide > 0 ? maxPositionPerSide : ∞)
+ * finalQty = min(baseQuantity + addQty, upperLimit)
* </pre>
+ * <p>上限 upperLimit：</p>
+ * <ul>
+ * <li>{@code respectCurrentPosition=false}：{@code upperLimit = maxPositionPerSide}
+ * （仓位归零重新入场，仅限制单次下单量）</li>
+ * <li>{@code respectCurrentPosition=true}：{@code upperLimit = maxPositionPerSide - 当前持仓}
+ * （止损追单，保证单边总持仓 ≤ maxPositionPerSide）</li>
+ * </ul>
*
- * @param isLong {@code true}=多仓方向，{@code false}=空仓方向
+ * @param isLong {@code true}=多仓方向，{@code false}=空仓方向
+ * @param respectCurrentPosition {@code true}=按「单边总持仓 ≤ maxPositionPerSide」扣减当前持仓；{@code false}=仅限制单次下单量
* @return 实际下单张数（字符串）
*/
- private String calculateEntryQuantity(boolean isLong) {
+ private String calculateEntryQuantity(boolean isLong, boolean respectCurrentPosition) {
int baseQty = Integer.parseInt(config.getBaseQuantity());
int interval = config.getAddPositionInterval();
int addQtyPerUnit = config.getAddPositionQuantity();
@@ -1594,8 +1649,20 @@
int addQty = addMultiplier * addQtyPerUnit;
int totalQty = baseQty + addQty;
- if (maxPerSide > 0 && totalQty > maxPerSide) {
- totalQty = maxPerSide;
+ if (maxPerSide > 0) {
+ int upperLimit = maxPerSide;
+ if (respectCurrentPosition) {
+ // 止损追单：单边总持仓不得超过 maxPerSide，追单量 = maxPerSide - 当前持仓
+ int currentPos = isLong
+ ? Math.max(queryPositionSize(Position.ModeEnum.DUAL_LONG), longPositionSize.intValue())
+ : Math.max(queryPositionSize(Position.ModeEnum.DUAL_SHORT), shortPositionSize.intValue());
+ upperLimit = maxPerSide - currentPos;
+ }
+ if (upperLimit <= 0) {
+ totalQty = 0;
+ } else if (totalQty > upperLimit) {
+ totalQty = upperLimit;
+ }
}
return String.valueOf(totalQty);
@@ -1634,12 +1701,16 @@
// 止损追单：同一网格可有多笔挂单，不判断 isHasLongOrder，直接挂单
BigDecimal triggerPrice = newEntryGrid.getGridPrice();
- String size = calculateEntryQuantity(true);
+ String size = calculateEntryQuantity(true, true);
log.info("[Gate] 多仓止损追单 有效次数:{}, 基础:{}张 → 实际:{}张, 模式:{}",
getEffectiveStopLossCount(true), config.getBaseQuantity(), size, config.getStopLossCountMode());
- newEntryGrid.getLongTraderParam().setQuantity(size);
- placeEntryOrderWithPreFlag(newEntryGrid, true, triggerPrice,
- FuturesPriceTrigger.RuleEnum.NUMBER_1, size);
+ if (Integer.parseInt(size) <= 0) {
+ log.warn("[Gate] 多仓止损追单 当前持仓已达单边上限({}), 跳过挂单", config.getMaxPositionPerSide());
+ } else {
+ newEntryGrid.getLongTraderParam().setQuantity(size);
+ placeEntryOrderWithPreFlag(newEntryGrid, true, triggerPrice,
+ FuturesPriceTrigger.RuleEnum.NUMBER_1, size);
+ }
// 取消 gridId+2 位置的所有多单
int cancelGridId = gridId + 2;
@@ -1693,12 +1764,16 @@
// 止损追单：同一网格可有多笔挂单，不判断 isHasShortOrder，直接挂单
BigDecimal triggerPrice = newEntryGrid.getGridPrice();
- String size = calculateEntryQuantity(false);
+ String size = calculateEntryQuantity(false, true);
log.info("[Gate] 空仓止损追单 有效次数:{}, 基础:{}张 → 实际:{}张, 模式:{}",
getEffectiveStopLossCount(false), config.getBaseQuantity(), size, config.getStopLossCountMode());
- newEntryGrid.getShortTraderParam().setQuantity(size);
- placeEntryOrderWithPreFlag(newEntryGrid, false, triggerPrice,
- FuturesPriceTrigger.RuleEnum.NUMBER_2, negate(size));
+ if (Integer.parseInt(size) <= 0) {
+ log.warn("[Gate] 空仓止损追单 当前持仓已达单边上限({}), 跳过挂单", config.getMaxPositionPerSide());
+ } else {
+ newEntryGrid.getShortTraderParam().setQuantity(size);
+ placeEntryOrderWithPreFlag(newEntryGrid, false, triggerPrice,
+ FuturesPriceTrigger.RuleEnum.NUMBER_2, negate(size));
+ }
// 取消 gridId-2 位置的所有空单
int cancelGridId = gridId - 2;
@@ -2368,7 +2443,7 @@
*/
private void closePositionByMode(Position.ModeEnum mode, boolean isLong) {
String sideLabel = isLong ? "多" : "空";
- // 1. 市价平掉对应方向仓位
+ // 1. 市价平掉对应方向仓位（价格保护拒绝时重试）
try {
Position pos = queryPosition(mode);
if (pos != null) {
@@ -2389,8 +2464,26 @@
closeOrder.setSize(size > 0 ? String.valueOf(-size) : String.valueOf(Math.abs(size)));
}
closeOrder.setText("t-grid-manual-close");
- futuresApi.createFuturesOrder(SETTLE, closeOrder, null);
- log.info("[Gate] 手动平{}仓, size:{}, mode:{}", sideLabel, sizeStr, posMode);
+ for (int attempt = 1; attempt <= CLOSE_POSITION_RETRY_MAX_ATTEMPTS; attempt++) {
+ try {
+ futuresApi.createFuturesOrder(SETTLE, closeOrder, null);
+ log.info("[Gate] 手动平{}仓, size:{}, mode:{}", sideLabel, sizeStr, posMode);
+ break;
+ } catch (Exception e) {
+ if (attempt < CLOSE_POSITION_RETRY_MAX_ATTEMPTS && isPriceProtectionRejected(e)) {
+ log.warn("[Gate] 手动平{}仓遭遇价格保护, 第{}次失败, {}ms后重试: {}",
+ sideLabel, attempt, CLOSE_POSITION_RETRY_DELAY_MS, e.getMessage());
+ try {
+ Thread.sleep(CLOSE_POSITION_RETRY_DELAY_MS);
+ } catch (InterruptedException ie) {
+ Thread.currentThread().interrupt();
+ break;
+ }
+ } else {
+ throw e;
+ }
+ }
+ }
}
}
} catch (Exception e) {
@@ -2413,6 +2506,20 @@
}
/**
+ * 判断异常是否为市价单价格保护拒绝（{@code MARKET_PRICE_TOO_DEVIATED}）。
+ *
+ * <p>该错误是交易所对市价单的保护：当盘口价相对最新价偏离超过滑点比率时拒绝下单，
+ * 属于瞬时行情错误，等待行情稳定后重试通常可成功。
+ */
+ private boolean isPriceProtectionRejected(Exception e) {
+ if (e instanceof GateApiException) {
+ String label = ((GateApiException) e).getErrorLabel();
+ return label != null && label.contains("PRICE_TOO_DEVIATED");
+ }
+ return false;
+ }
+
+ /**
* 取消所有多仓入场单（条件开仓单），并清空 GridElement 的多仓挂单记录。
*/
private void cancelAllLongEntryOrders() {
--
Gitblit v1.9.1