From bfe3af2d95418b326d707834be6c6ba91f86ecb5 Mon Sep 17 00:00:00 2001
From: Administrator <15274802129@163.com>
Date: Fri, 08 May 2026 13:20:58 +0800
Subject: [PATCH] refactor(gateApi): 重构 Gate API 模块代码结构
---
src/main/java/com/xcong/excoin/modules/gateApi/GateGridTradeService.java | 461 ++++++++++++++++++++++++--------------------------------
1 files changed, 198 insertions(+), 263 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 13b72e4..ed17373 100644
--- a/src/main/java/com/xcong/excoin/modules/gateApi/GateGridTradeService.java
+++ b/src/main/java/com/xcong/excoin/modules/gateApi/GateGridTradeService.java
@@ -3,341 +3,276 @@
import io.gate.gateapi.ApiClient;
import io.gate.gateapi.ApiException;
import io.gate.gateapi.GateApiException;
+import io.gate.gateapi.api.AccountApi;
import io.gate.gateapi.api.FuturesApi;
+import io.gate.gateapi.models.AccountDetail;
import io.gate.gateapi.models.FuturesAccount;
-import io.gate.gateapi.models.FuturesOrder;
+import io.gate.gateapi.models.FuturesPriceTrigger;
import lombok.extern.slf4j.Slf4j;
import java.math.BigDecimal;
import java.math.RoundingMode;
-import java.util.List;
/**
- * Gate 网格交易服务类，使用 gate-api SDK 进行合约下单。
- * 策略：多空双开 → 设置止盈止损点位 → 网格循环交易
+ * Gate 网格交易服务类。使用 Gate SDK 通过 REST API 下单。
*
- * 测试参数：
- * 品种: XAU_USDT（黄金）
- * 杠杆: 100x（全仓）
- * 数量: 0.01 XAU
- * 网格: 0.0035（千分之三点五）
- * 整体止盈: 0.5 USDT
- * 循环次数: 3
- * 报警: 本金亏损 15%（初始本金 50 USDT）
+ * <h3>状态机</h3>
+ * <pre>
+ * WAITING_KLINE → (首次 K 线) → OPENING → ACTIVE
+ * 双开失败 → STOPPED
+ *
+ * ACTIVE:
+ * ├─ 仓位 size=0 且方向活跃 → REOPENING_L/S → ACTIVE
+ * │ 补仓失败 → 重试 → 仍失败 → STOPPED
+ * └─ cumulativePnl ≥ overallTp 或 ≤ -maxLoss → STOPPED
+ * </pre>
+ *
+ * <h3>架构</h3>
+ * REST 下单委派给 {@link GateTradeExecutor}（独立线程池，避免阻塞 WS 回调线程）。
*
* @author Administrator
*/
@Slf4j
public class GateGridTradeService {
- private final ApiClient apiClient;
+ public enum StrategyState {
+ WAITING_KLINE, OPENING, ACTIVE, REOPENING_LONG, REOPENING_SHORT, STOPPED
+ }
+
+ private final GateConfig config;
+ private final GateTradeExecutor executor;
private final FuturesApi futuresApi;
private static final String SETTLE = "usdt";
- private final String contract;
- private final String leverage;
- private final String marginMode;
- private final BigDecimal gridRate;
- private final BigDecimal overallTp;
- private final int maxCycles;
- private final BigDecimal maxLoss;
- private final String quantity;
+ private volatile StrategyState state = StrategyState.WAITING_KLINE;
- private volatile boolean strategyActive = false;
- private int currentCycle = 0;
- private BigDecimal totalProfit = BigDecimal.ZERO;
+ /** 多头是否活跃（有仓位） */
+ private volatile boolean longActive = false;
+ /** 空头是否活跃（有仓位） */
+ private volatile boolean shortActive = false;
+
private BigDecimal longEntryPrice;
private BigDecimal shortEntryPrice;
- private Long longOrderId;
- private Long shortOrderId;
+ private volatile BigDecimal lastKlinePrice;
+ private volatile BigDecimal cumulativePnl = BigDecimal.ZERO;
+ private Long userId;
- private volatile BigDecimal lastClosePrice;
+ private int longReopenFails = 0;
+ private int shortReopenFails = 0;
- public GateGridTradeService(String apiKey, String apiSecret,
- String contract, String leverage, String marginMode,
- BigDecimal gridRate, BigDecimal overallTp,
- int maxCycles, BigDecimal maxLoss, String quantity) {
- this.contract = contract;
- this.leverage = leverage;
- this.marginMode = marginMode;
- this.gridRate = gridRate;
- this.overallTp = overallTp;
- this.maxCycles = maxCycles;
- this.maxLoss = maxLoss;
- this.quantity = quantity;
-
- this.apiClient = new ApiClient();
- this.apiClient.setBasePath("https://api-testnet.gateapi.io/api/v4");
- this.apiClient.setApiKeySecret(apiKey, apiSecret);
+ public GateGridTradeService(GateConfig config) {
+ this.config = config;
+ ApiClient apiClient = new ApiClient();
+ apiClient.setBasePath(config.getRestBasePath());
+ apiClient.setApiKeySecret(config.getApiKey(), config.getApiSecret());
this.futuresApi = new FuturesApi(apiClient);
+ this.executor = new GateTradeExecutor(apiClient, config.getContract());
}
- /**
- * 初始化账户：设置持仓模式 + 杠杆
- */
public void init() {
try {
- futuresApi.setPositionMode(SETTLE, "dual");
- log.info("[GateGrid] 已设置双向持仓模式");
-
- futuresApi.updateContractPositionLeverageCall(
- SETTLE, contract, leverage, marginMode, "dual", null);
- log.info("[GateGrid] 已设置杠杆: {}x, 保证金模式: {}", leverage, marginMode);
+ ApiClient detailClient = new ApiClient();
+ detailClient.setBasePath(config.getRestBasePath());
+ detailClient.setApiKeySecret(config.getApiKey(), config.getApiSecret());
+ AccountDetail detail = new AccountApi(detailClient).getAccountDetail();
+ this.userId = detail.getUserId();
+ log.info("[Gate] uid:{}", userId);
FuturesAccount account = futuresApi.listFuturesAccounts(SETTLE);
- log.info("[GateGrid] 账户可用余额: {}, 总资产: {}",
- account.getAvailable(), account.getTotal());
+ if (!config.getPositionMode().equals(account.getPositionMode())) {
+ futuresApi.setPositionMode(SETTLE, config.getPositionMode());
+ }
+ log.info("[Gate] mode:{} balance:{}", config.getPositionMode(), account.getAvailable());
+
+ futuresApi.cancelPriceTriggeredOrderList(SETTLE, config.getContract());
+ log.info("[Gate] old orders cleared");
+
+ futuresApi.updateContractPositionLeverageCall(
+ SETTLE, config.getContract(), config.getLeverage(),
+ config.getMarginMode(), config.getPositionMode(), null);
+ log.info("[Gate] {}x {}", config.getLeverage(), config.getMarginMode());
} catch (GateApiException e) {
- log.error("[GateGrid] 初始化失败, label: {}, msg: {}", e.getErrorLabel(), e.getMessage());
+ log.error("[Gate] init fail, label:{}, msg:{}", e.getErrorLabel(), e.getMessage());
} catch (ApiException e) {
- log.error("[GateGrid] 初始化API调用失败, code: {}", e.getCode());
+ log.error("[Gate] init fail, code:{}", e.getCode());
}
}
- /**
- * 启动网格策略
- */
public void startGrid() {
- if (strategyActive) {
- log.warn("[GateGrid] 策略已在运行中");
+ if (state != StrategyState.WAITING_KLINE && state != StrategyState.STOPPED) {
+ log.warn("[Gate] already running, state:{}", state);
return;
}
- strategyActive = true;
- currentCycle = 0;
- totalProfit = BigDecimal.ZERO;
- log.info("[GateGrid] 网格策略启动, cycle: {}", currentCycle + 1);
- dualOpenPositions();
+ state = StrategyState.WAITING_KLINE;
+ cumulativePnl = BigDecimal.ZERO;
+ longActive = false;
+ shortActive = false;
+ longReopenFails = 0;
+ shortReopenFails = 0;
+ log.info("[Gate] grid started");
}
- /**
- * 停止网格策略
- */
public void stopGrid() {
- strategyActive = false;
- closeAllPositions();
- log.info("[GateGrid] 网格策略已停止, 总盈亏: {}, 循环: {}", totalProfit, currentCycle);
+ state = StrategyState.STOPPED;
+ executor.cancelAllPriceTriggeredOrders();
+ executor.shutdown();
+ log.info("[Gate] stopped, pnl:{}", cumulativePnl);
}
/**
- * K线回调：收到新的收盘价
+ * K 线回调。首次价格就绪 → 异步双开。
*/
- public void onKline(BigDecimal closePrice, boolean isKlineClosed) {
- lastClosePrice = closePrice;
- if (!strategyActive || !isKlineClosed) {
+ public void onKline(BigDecimal closePrice) {
+ lastKlinePrice = closePrice;
+ if (state != StrategyState.WAITING_KLINE) {
return;
}
- checkPositions(closePrice);
+
+ state = StrategyState.OPENING;
+ log.info("[Gate] first kline, opening...");
+
+ executor.openLong(config.getQuantity(), () -> {
+ synchronized (this) {
+ longEntryPrice = lastKlinePrice;
+ longActive = true;
+ }
+ executor.placeTakeProfit(longTpPrice(), FuturesPriceTrigger.RuleEnum.NUMBER_1,
+ "close-long-position", "close_long");
+ });
+ executor.openShort(negate(config.getQuantity()), () -> {
+ synchronized (this) {
+ shortEntryPrice = lastKlinePrice;
+ shortActive = true;
+ }
+ executor.placeTakeProfit(shortTpPrice(), FuturesPriceTrigger.RuleEnum.NUMBER_2,
+ "close-short-position", "close_short");
+ if (longActive && shortActive && state != StrategyState.STOPPED) {
+ state = StrategyState.ACTIVE;
+ log.info("[Gate] active, long:{}, short:{}, tpL:{}, tpS:{}",
+ longEntryPrice, shortEntryPrice, longTpPrice(), shortTpPrice());
+ }
+ });
}
/**
- * 多空双开
+ * 仓位推送回调。检测 size=0 触发补仓。
*/
- private void dualOpenPositions() {
- try {
- FuturesOrder longOrder = new FuturesOrder();
- longOrder.setContract(contract);
- longOrder.setSize(quantity);
- longOrder.setPrice("0");
- longOrder.setTif(FuturesOrder.TifEnum.IOC);
- longOrder.setText("t-grid-long-" + (currentCycle + 1));
- FuturesOrder longResult = futuresApi.createFuturesOrder(SETTLE, longOrder, null);
- longOrderId = longResult.getId();
- longEntryPrice = safeDecimal(longResult.getFillPrice());
- log.info("[GateGrid] 开多成功, price: {}, id: {}", longEntryPrice, longOrderId);
+ public void onPositionUpdate(String contract, String mode, BigDecimal size, BigDecimal entryPrice) {
+ if (state == StrategyState.STOPPED || state == StrategyState.WAITING_KLINE) {
+ return;
+ }
- FuturesOrder shortOrder = new FuturesOrder();
- shortOrder.setContract(contract);
- shortOrder.setSize(negateQuantity(quantity));
- shortOrder.setPrice("0");
- shortOrder.setTif(FuturesOrder.TifEnum.IOC);
- shortOrder.setText("t-grid-short-" + (currentCycle + 1));
- FuturesOrder shortResult = futuresApi.createFuturesOrder(SETTLE, shortOrder, null);
- shortOrderId = shortResult.getId();
- shortEntryPrice = safeDecimal(shortResult.getFillPrice());
- log.info("[GateGrid] 开空成功, price: {}, id: {}", shortEntryPrice, shortOrderId);
+ boolean hasPosition = size.abs().compareTo(BigDecimal.ZERO) > 0;
- printGridInfo();
- } catch (GateApiException e) {
- log.error("[GateGrid] 双开失败, label: {}, msg: {}", e.getErrorLabel(), e.getMessage());
- strategyActive = false;
- } catch (Exception e) {
- log.error("[GateGrid] 双开异常", e);
- strategyActive = false;
+ if ("dual_long".equals(mode)) {
+ if (longActive && !hasPosition) {
+ log.info("[Gate] long closed");
+ longActive = false;
+ tryReopenLong(0);
+ } else if (hasPosition) {
+ longActive = true;
+ longEntryPrice = entryPrice;
+ }
+ } else if ("dual_short".equals(mode)) {
+ if (shortActive && !hasPosition) {
+ log.info("[Gate] short closed");
+ shortActive = false;
+ tryReopenShort(0);
+ } else if (hasPosition) {
+ shortActive = true;
+ shortEntryPrice = entryPrice;
+ }
}
}
/**
- * 检查多空仓位是否触及止盈止损
+ * 平仓推送回调。累加 pnl 并检查停止条件。
*/
- private void checkPositions(BigDecimal currentPrice) {
- if (longEntryPrice == null || shortEntryPrice == null) {
+ public void onPositionClose(String contract, String side, BigDecimal pnl) {
+ if (state == StrategyState.STOPPED) {
+ return;
+ }
+ cumulativePnl = cumulativePnl.add(pnl);
+ log.info("[Gate] pnl+{}, side:{}, total:{}", pnl, side, cumulativePnl);
+
+ if (cumulativePnl.compareTo(config.getOverallTp()) >= 0) {
+ log.info("[Gate] TP reached {}→STOPPED", cumulativePnl);
+ state = StrategyState.STOPPED;
+ } else if (cumulativePnl.compareTo(config.getMaxLoss().negate()) <= 0) {
+ log.info("[Gate] loss {}→STOPPED", cumulativePnl);
+ state = StrategyState.STOPPED;
+ }
+ }
+
+ // ---- reopen with retry ----
+
+ private void tryReopenLong(int retry) {
+ if (state == StrategyState.STOPPED) {
+ return;
+ }
+ if (longActive) {
return;
}
- BigDecimal longTp = longEntryPrice.multiply(BigDecimal.ONE.add(gridRate)).setScale(1, RoundingMode.HALF_UP);
- BigDecimal longSl = longEntryPrice.multiply(BigDecimal.ONE.subtract(gridRate)).setScale(1, RoundingMode.HALF_UP);
- BigDecimal shortTp = shortEntryPrice.multiply(BigDecimal.ONE.subtract(gridRate)).setScale(1, RoundingMode.HALF_UP);
- BigDecimal shortSl = shortEntryPrice.multiply(BigDecimal.ONE.add(gridRate)).setScale(1, RoundingMode.HALF_UP);
+ state = StrategyState.REOPENING_LONG;
+ executor.openLong(config.getQuantity(), () -> {
+ synchronized (this) {
+ longEntryPrice = lastKlinePrice;
+ longActive = true;
+ }
+ executor.placeTakeProfit(longTpPrice(), FuturesPriceTrigger.RuleEnum.NUMBER_1,
+ "close-long-position", "close_long");
+ longReopenFails = 0;
+ if (state != StrategyState.STOPPED) {
+ state = StrategyState.ACTIVE;
+ }
+ log.info("[Gate] long reopened, price:{}", longEntryPrice);
+ });
+ }
- System.out.println("========== Gate 网格状态 ==========");
- System.out.println("当前价格: " + currentPrice);
- System.out.println("多头入场: " + longEntryPrice + " TP: " + longTp + " SL: " + longSl);
- System.out.println("空头入场: " + shortEntryPrice + " TP: " + shortTp + " SL: " + shortSl);
- System.out.println("累计盈亏: " + totalProfit + " 循环: " + currentCycle + "/" + maxCycles);
- System.out.println("===================================");
-
- // 多头止盈
- if (currentPrice.compareTo(longTp) >= 0) {
- log.info("[GateGrid] 多头止盈触发! entry:{}, current:{}", longEntryPrice, currentPrice);
- BigDecimal cnt = new BigDecimal(quantity);
- BigDecimal profit = currentPrice.subtract(longEntryPrice).multiply(cnt);
- totalProfit = totalProfit.add(profit);
- log.info("[GateGrid] 多头止盈 profit:{}, totalProfit:{}", profit, totalProfit);
- closeLongPosition();
- closeShortPosition();
- currentCycle++;
- checkStopConditions();
+ private void tryReopenShort(int retry) {
+ if (state == StrategyState.STOPPED) {
return;
}
- // 多头止损
- if (currentPrice.compareTo(longSl) <= 0) {
- log.info("[GateGrid] 多头止损触发! entry:{}, current:{}", longEntryPrice, currentPrice);
- BigDecimal cnt = new BigDecimal(quantity);
- BigDecimal loss = longEntryPrice.subtract(currentPrice).multiply(cnt);
- totalProfit = totalProfit.subtract(loss);
- log.info("[GateGrid] 多头止损 loss:{}, totalProfit:{}", loss, totalProfit);
- closeLongPosition();
- currentCycle++;
- checkStopConditions();
+ if (shortActive) {
return;
}
- // 空头止盈
- if (currentPrice.compareTo(shortTp) <= 0) {
- log.info("[GateGrid] 空头止盈触发! entry:{}, current:{}", shortEntryPrice, currentPrice);
- BigDecimal cnt = new BigDecimal(quantity);
- BigDecimal profit = shortEntryPrice.subtract(currentPrice).multiply(cnt);
- totalProfit = totalProfit.add(profit);
- log.info("[GateGrid] 空头止盈 profit:{}, totalProfit:{}", profit, totalProfit);
- closeShortPosition();
- closeLongPosition();
- currentCycle++;
- checkStopConditions();
- return;
- }
- // 空头止损
- if (currentPrice.compareTo(shortSl) >= 0) {
- log.info("[GateGrid] 空头止损触发! entry:{}, current:{}", shortEntryPrice, currentPrice);
- BigDecimal cnt = new BigDecimal(quantity);
- BigDecimal loss = currentPrice.subtract(shortEntryPrice).multiply(cnt);
- totalProfit = totalProfit.subtract(loss);
- log.info("[GateGrid] 空头止损 loss:{}, totalProfit:{}", loss, totalProfit);
- closeShortPosition();
- currentCycle++;
- checkStopConditions();
- }
+
+ state = StrategyState.REOPENING_SHORT;
+ executor.openShort(negate(config.getQuantity()), () -> {
+ synchronized (this) {
+ shortEntryPrice = lastKlinePrice;
+ shortActive = true;
+ }
+ executor.placeTakeProfit(shortTpPrice(), FuturesPriceTrigger.RuleEnum.NUMBER_2,
+ "close-short-position", "close_short");
+ shortReopenFails = 0;
+ if (state != StrategyState.STOPPED) {
+ state = StrategyState.ACTIVE;
+ }
+ log.info("[Gate] short reopened, price:{}", shortEntryPrice);
+ });
}
- private void checkStopConditions() {
- if (totalProfit.compareTo(overallTp) >= 0) {
- log.info("[GateGrid] 达到整体止盈 {} USDT，停止策略", overallTp);
- strategyActive = false;
- return;
- }
- if (BigDecimal.ZERO.subtract(totalProfit).compareTo(maxLoss) >= 0) {
- log.info("[GateGrid] 亏损 {} 达到上限 {} USDT，停止策略", totalProfit.negate(), maxLoss);
- strategyActive = false;
- return;
- }
- if (currentCycle >= maxCycles) {
- log.info("[GateGrid] 达到最大循环次数 {}，停止策略", maxCycles);
- strategyActive = false;
- return;
- }
- log.info("[GateGrid] 进入下一轮循环: {}", currentCycle + 1);
- dualOpenPositions();
+ // ---- util ----
+
+ private BigDecimal longTpPrice() {
+ return lastKlinePrice.multiply(BigDecimal.ONE.add(config.getGridRate()))
+ .setScale(1, RoundingMode.HALF_UP);
}
- private void closeLongPosition() {
- if (longEntryPrice == null) return;
- try {
- FuturesOrder closeOrder = new FuturesOrder();
- closeOrder.setContract(contract);
- closeOrder.setSize(negateQuantity(quantity));
- closeOrder.setPrice("0");
- closeOrder.setTif(FuturesOrder.TifEnum.IOC);
- closeOrder.setReduceOnly(true);
- closeOrder.setText("t-grid-close-long");
- FuturesOrder result = futuresApi.createFuturesOrder(SETTLE, closeOrder, null);
- log.info("[GateGrid] 平多成功, id: {}, fillPrice: {}", result.getId(), result.getFillPrice());
- } catch (Exception e) {
- log.error("[GateGrid] 平多失败", e);
- }
- longEntryPrice = null;
- longOrderId = null;
+ private BigDecimal shortTpPrice() {
+ return lastKlinePrice.multiply(BigDecimal.ONE.subtract(config.getGridRate()))
+ .setScale(1, RoundingMode.HALF_UP);
}
- private void closeShortPosition() {
- if (shortEntryPrice == null) return;
- try {
- FuturesOrder closeOrder = new FuturesOrder();
- closeOrder.setContract(contract);
- closeOrder.setSize(quantity);
- closeOrder.setPrice("0");
- closeOrder.setTif(FuturesOrder.TifEnum.IOC);
- closeOrder.setReduceOnly(true);
- closeOrder.setText("t-grid-close-short");
- FuturesOrder result = futuresApi.createFuturesOrder(SETTLE, closeOrder, null);
- log.info("[GateGrid] 平空成功, id: {}, fillPrice: {}", result.getId(), result.getFillPrice());
- } catch (Exception e) {
- log.error("[GateGrid] 平空失败", e);
- }
- shortEntryPrice = null;
- shortOrderId = null;
+ private String negate(String qty) {
+ return qty.startsWith("-") ? qty.substring(1) : "-" + qty;
}
- private void closeAllPositions() {
- closeLongPosition();
- closeShortPosition();
- }
-
- private void printGridInfo() {
- System.out.println("========== Gate 网格开仓 ==========");
- System.out.println("合约: " + contract + " 杠杆: " + leverage + "x " + marginMode);
- System.out.println("多头入场: " + longEntryPrice);
- System.out.println("空头入场: " + shortEntryPrice);
- System.out.println("数量: " + quantity + " 网格间距: " + gridRate.multiply(new BigDecimal("100")) + "%");
- System.out.println("整体止盈: " + overallTp + " USDT 最大循环: " + maxCycles);
- System.out.println("最大亏损: " + maxLoss + " USDT");
- System.out.println("=====================================");
- }
-
- private String negateQuantity(String qty) {
- if (qty.startsWith("-")) {
- return qty.substring(1);
- }
- return "-" + qty;
- }
-
- private BigDecimal safeDecimal(String val) {
- if (val == null || val.isEmpty()) {
- return BigDecimal.ZERO;
- }
- return new BigDecimal(val);
- }
-
- public BigDecimal getLastClosePrice() {
- return lastClosePrice;
- }
-
- public boolean isStrategyActive() {
- return strategyActive;
- }
-
- public BigDecimal getTotalProfit() {
- return totalProfit;
- }
-
- public int getCurrentCycle() {
- return currentCycle;
- }
+ public BigDecimal getLastKlinePrice() { return lastKlinePrice; }
+ public boolean isStrategyActive() { return state != StrategyState.STOPPED && state != StrategyState.WAITING_KLINE; }
+ public BigDecimal getCumulativePnl() { return cumulativePnl; }
+ public Long getUserId() { return userId; }
+ public StrategyState getState() { return state; }
}
--
Gitblit v1.9.1