From b72f338db8e323b412b794eecc7a0460943b3e4b Mon Sep 17 00:00:00 2001
From: Administrator <15274802129@163.com>
Date: Sat, 09 May 2026 17:24:12 +0800
Subject: [PATCH] feat(gateApi): 增强网格交易系统功能
---
src/main/java/com/xcong/excoin/modules/gateApi/GateGridTradeService.java | 823 +++++++++++++++++++++++++++++++++++++++-------------------
1 files changed, 552 insertions(+), 271 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..f40030d 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,622 @@
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 io.gate.gateapi.models.Position;
import lombok.extern.slf4j.Slf4j;
import java.math.BigDecimal;
import java.math.RoundingMode;
+import java.util.ArrayList;
+import java.util.Collections;
import java.util.List;
/**
- * Gate 网格交易服务类，使用 gate-api SDK 进行合约下单。
- * 策略：多空双开 → 设置止盈止损点位 → 网格循环交易
+ * Gate 网格交易服务 — 策略核心。
*
- * 测试参数：
- * 品种: XAU_USDT（黄金）
- * 杠杆: 100x（全仓）
- * 数量: 0.01 XAU
- * 网格: 0.0035（千分之三点五）
- * 整体止盈: 0.5 USDT
- * 循环次数: 3
- * 报警: 本金亏损 15%（初始本金 50 USDT）
+ * <h3>策略</h3>
+ * 多空双开基底 → 生成价格网格队列 → K线触达网格线 → 开仓+设止盈 → 队列动态转移。
+ * 每根 K 线更新 {@code unrealizedPnl}（浮动盈亏），平仓后累加到 {@code cumulativePnl}（已实现盈亏）。
+ *
+ * <h3>未实现盈亏公式（正向合约）</h3>
+ * <pre>
+ * 多仓: 持仓量 × 合约乘数 × (计价价格 − 开仓均价)
+ * 空仓: 持仓量 × 合约乘数 × (开仓均价 − 计价价格)
+ * </pre>
+ * 计价价格支持切换：{@link GateConfig.PnLPriceMode#LAST_PRICE 最新成交价} 或
+ * {@link GateConfig.PnLPriceMode#MARK_PRICE 标记价格}（通过 {@link #setMarkPrice(BigDecimal)} 注入）。
+ * 入场价和持仓量由 {@link #onPositionUpdate(String, Position.ModeEnum, BigDecimal, BigDecimal)} 实时更新。
+ *
+ * <h3>状态机</h3>
+ * <pre>
+ * WAITING_KLINE → (首K线) → 异步双开基底
+ *
+ * 仓位推送(dual_long/dual_short) → 基底成交 → 记录入场价 → 双基底都成交 → 生成队列 → ACTIVE
+ *
+ * ACTIVE:
+ * ├─ 每根K线 → 更新 unrealizedPnl + processShortGrid + processLongGrid
+ * │ ├─ 当前价 < 空仓队列元素 → 匹配 → 开空 + 以多仓队列首元素为种子生成新元素加入多仓队列
+ * │ └─ 当前价 > 多仓队列元素 → 匹配 → 开多 + 以空仓队列首元素为种子生成新元素加入空仓队列
+ * ├─ 仓位推送(非基底) → 设止盈条件单 entry × (1±gridRate)，使用 plan-close-*-position
+ * ├─ 保证金≥初始本金 marginRatioLimit → 跳过开仓，队列照常更新
+ * ├─ 额外反向开仓：触发价夹在多/空持仓均价之间且多持仓均价>空持仓均价时，额外反向开仓一次
+ * └─ cumulativePnl ≥ overallTp 或 ≤ -maxLoss → STOPPED
+ * </pre>
+ *
+ * <h3>队列转移规则</h3>
+ * 触发后不再简单复制 matched 元素到对方队列，而是以对方队列首元素为种子，生成新元素：
+ * <ul>
+ * <li>空仓队列触发 → 多仓队列新增：以多仓队列首元素（最小价）为基准，生成递减元素</li>
+ * <li>多仓队列触发 → 空仓队列新增：以空仓队列首元素（最高价）为基准，生成递增元素</li>
+ * </ul>
+ *
+ * <h3>贴近持仓均价过滤</h3>
+ * 转移生成新元素时，若新元素与对应方向持仓均价的差距小于 gridRate，则跳过该元素，
+ * 避免在持仓成本附近生成无效网格线。
+ *
+ * <h3>额外反向开仓条件</h3>
+ * 当触发价在空仓均价和回撤后的多仓均价之间（即多>空且价格夹在中间），额外反向开仓一次：
+ * <ul>
+ * <li>空仓队列触发 → 额外开多：需满足 shortEntryPrice < currentPrice < longEntryPrice × (1 − gridRate)</li>
+ * <li>多仓队列触发 → 额外开空：需满足 shortEntryPrice × (1 + gridRate) < currentPrice < longEntryPrice</li>
+ * </ul>
+ *
+ * <h3>止盈条件单</h3>
+ * 使用 Gate API 的 plan-close-long-position / plan-close-short-position（仓位计划止盈止损），
+ * 支持指定张数部分平仓。每次网格触发开仓 quantity 张，只为该批张数创建独立条件单，互不覆盖。
*
* @author Administrator
*/
@Slf4j
public class GateGridTradeService {
- private final ApiClient apiClient;
+ public enum StrategyState {
+ WAITING_KLINE, OPENING, ACTIVE, STOPPED
+ }
+
+ /**
+ * 止盈条件单 order_type：仓位计划止盈止损 — 平多仓（支持部分平仓，size<0）。
+ * 注意：不能用 close-long-position（仅支持全平且双仓需 auto_size），
+ * 必须用 plan-close-long-position 以支持指定张数部分平仓。
+ */
+ private static final String ORDER_TYPE_CLOSE_LONG = "plan-close-long-position";
+ /**
+ * 止盈条件单 order_type：仓位计划止盈止损 — 平空仓（支持部分平仓，size>0）。
+ * 注意：不能用 close-short-position（仅支持全平且双仓需 auto_size），
+ * 必须用 plan-close-short-position 以支持指定张数部分平仓。
+ */
+ private static final String ORDER_TYPE_CLOSE_SHORT = "plan-close-short-position";
+
+ 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 BigDecimal longEntryPrice;
- private BigDecimal shortEntryPrice;
- private Long longOrderId;
- private Long shortOrderId;
+ /** 空仓价格队列，降序排列（大→小），容量 gridQueueSize */
+ private final List<BigDecimal> shortPriceQueue = Collections.synchronizedList(new ArrayList<>());
+ /** 多仓价格队列，升序排列（小→大），容量 gridQueueSize */
+ private final List<BigDecimal> longPriceQueue = Collections.synchronizedList(new ArrayList<>());
- private volatile BigDecimal lastClosePrice;
+ /** 基底空头入场价 */
+ private BigDecimal shortBaseEntryPrice;
+ /** 基底多头入场价 */
+ private BigDecimal longBaseEntryPrice;
+ /** 基底多头是否已开 */
+ private volatile boolean baseLongOpened = false;
+ /** 基底空头是否已开 */
+ private volatile boolean baseShortOpened = false;
- 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;
+ /** 空头是否活跃（有仓位） */
+ private volatile boolean shortActive = false;
+ /** 多头是否活跃（有仓位） */
+ private volatile boolean longActive = false;
- this.apiClient = new ApiClient();
- this.apiClient.setBasePath("https://api-testnet.gateapi.io/api/v4");
- this.apiClient.setApiKeySecret(apiKey, apiSecret);
+ private volatile BigDecimal lastKlinePrice;
+ private volatile BigDecimal markPrice = BigDecimal.ZERO;
+ private volatile BigDecimal cumulativePnl = BigDecimal.ZERO;
+ private volatile BigDecimal unrealizedPnl = BigDecimal.ZERO;
+ private volatile BigDecimal longEntryPrice = BigDecimal.ZERO;
+ private volatile BigDecimal shortEntryPrice = BigDecimal.ZERO;
+ private volatile BigDecimal longPositionSize = BigDecimal.ZERO;
+ private volatile BigDecimal shortPositionSize = BigDecimal.ZERO;
+ private Long userId;
+ private volatile BigDecimal initialPrincipal = BigDecimal.ZERO;
+
+ 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] 用户ID: {}", userId);
FuturesAccount account = futuresApi.listFuturesAccounts(SETTLE);
- log.info("[GateGrid] 账户可用余额: {}, 总资产: {}",
- account.getAvailable(), account.getTotal());
+ this.initialPrincipal = new BigDecimal(account.getTotal());
+ log.info("[Gate] 初始本金: {} USDT", initialPrincipal);
+
+ //设置持仓模式为双向持仓
+ Boolean inDualMode = account.getInDualMode();
+ if (!inDualMode) {
+ futuresApi.setDualModeCall(SETTLE,true,null);
+ }
+
+ if (!config.getPositionMode().equals(account.getPositionMode())) {
+ futuresApi.setPositionMode(SETTLE, config.getPositionMode());
+ }
+ log.info("[Gate] 持仓模式: {} 余额: {}", config.getPositionMode(), account.getAvailable());
+
+ futuresApi.cancelPriceTriggeredOrderList(SETTLE, config.getContract());
+ log.info("[Gate] 旧条件单已清除");
+
+ closeExistingPositions();
+
+ futuresApi.updateDualModePositionLeverageCall(
+ SETTLE, config.getContract(), config.getLeverage(),
+ config.getMarginMode(), null);
+ log.info("[Gate] 杠杆: {}x {}", config.getLeverage(), config.getMarginMode());
} catch (GateApiException e) {
- log.error("[GateGrid] 初始化失败, label: {}, msg: {}", e.getErrorLabel(), e.getMessage());
+ log.error("[Gate] 初始化失败, label:{}, msg:{}", e.getErrorLabel(), e.getMessage());
} catch (ApiException e) {
- log.error("[GateGrid] 初始化API调用失败, code: {}", e.getCode());
+ log.error("[Gate] 初始化失败, code:{}", e.getCode());
}
}
- /**
- * 启动网格策略
- */
- public void startGrid() {
- if (strategyActive) {
- log.warn("[GateGrid] 策略已在运行中");
- return;
- }
- strategyActive = true;
- currentCycle = 0;
- totalProfit = BigDecimal.ZERO;
- log.info("[GateGrid] 网格策略启动, cycle: {}", currentCycle + 1);
- dualOpenPositions();
- }
-
- /**
- * 停止网格策略
- */
- public void stopGrid() {
- strategyActive = false;
- closeAllPositions();
- log.info("[GateGrid] 网格策略已停止, 总盈亏: {}, 循环: {}", totalProfit, currentCycle);
- }
-
- /**
- * K线回调：收到新的收盘价
- */
- public void onKline(BigDecimal closePrice, boolean isKlineClosed) {
- lastClosePrice = closePrice;
- if (!strategyActive || !isKlineClosed) {
- return;
- }
- checkPositions(closePrice);
- }
-
- /**
- * 多空双开
- */
- private void dualOpenPositions() {
+ private void closeExistingPositions() {
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);
-
- 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);
-
- printGridInfo();
+ List<Position> positions = futuresApi.listPositions(SETTLE).execute();
+ if (positions == null || positions.isEmpty()) { log.info("[Gate] 无已有仓位"); return; }
+ for (Position pos : positions) {
+ if (!config.getContract().equals(pos.getContract())) {
+ continue;
+ }
+ String sizeStr = pos.getSize();
+ long size = Long.parseLong(sizeStr);
+ if (size == 0) {
+ continue;
+ }
+ String closeSize = size > 0 ? String.valueOf(-size) : String.valueOf(Math.abs(size));
+ Position.ModeEnum mode = pos.getMode();
+ FuturesOrder closeOrder = new FuturesOrder();
+ closeOrder.setContract(config.getContract());
+ closeOrder.setPrice("0");
+ closeOrder.setTif(FuturesOrder.TifEnum.IOC);
+ closeOrder.setReduceOnly(true);
+ if (mode != null && mode.getValue() != null && mode.getValue().contains("dual")) {
+ closeOrder.setSize("0");
+ closeOrder.setClose(false);
+ closeOrder.setAutoSize(size > 0 ? FuturesOrder.AutoSizeEnum.LONG : FuturesOrder.AutoSizeEnum.SHORT);
+ } else {
+ closeOrder.setSize(closeSize);
+ }
+ closeOrder.setText("t-grid-init-close");
+ futuresApi.createFuturesOrder(SETTLE, closeOrder, null);
+ log.info("[Gate] 平已有仓位, 方向:{}, size:{}, mode:{}", size > 0 ? "多" : "空", sizeStr, mode);
+ }
} catch (GateApiException e) {
- log.error("[GateGrid] 双开失败, label: {}, msg: {}", e.getErrorLabel(), e.getMessage());
- strategyActive = false;
+ log.warn("[Gate] 平仓位失败, label:{}, msg:{}", e.getErrorLabel(), e.getMessage());
} catch (Exception e) {
- log.error("[GateGrid] 双开异常", e);
- strategyActive = false;
+ log.warn("[Gate] 平仓位异常", e);
+ }
+ }
+
+ // ---- 启动/停止 ----
+
+ public void startGrid() {
+ if (state != StrategyState.WAITING_KLINE && state != StrategyState.STOPPED) {
+ log.warn("[Gate] 策略已在运行中, state:{}", state);
+ return;
+ }
+ state = StrategyState.WAITING_KLINE;
+ cumulativePnl = BigDecimal.ZERO;
+ unrealizedPnl = BigDecimal.ZERO;
+ markPrice = BigDecimal.ZERO;
+ longEntryPrice = BigDecimal.ZERO;
+ shortEntryPrice = BigDecimal.ZERO;
+ longPositionSize = BigDecimal.ZERO;
+ shortPositionSize = BigDecimal.ZERO;
+ baseLongOpened = false;
+ baseShortOpened = false;
+ longActive = false;
+ shortActive = false;
+ shortPriceQueue.clear();
+ longPriceQueue.clear();
+ log.info("[Gate] 网格策略已启动");
+ }
+
+ public void stopGrid() {
+ state = StrategyState.STOPPED;
+ executor.cancelAllPriceTriggeredOrders();
+ executor.shutdown();
+ log.info("[Gate] 策略已停止, 累计盈亏: {}", cumulativePnl);
+ }
+
+ // ---- K线回调 ----
+
+ public void onKline(BigDecimal closePrice) {
+ lastKlinePrice = closePrice;
+ updateUnrealizedPnl();
+ if (state == StrategyState.STOPPED) {
+ return;
+ }
+
+ if (state == StrategyState.WAITING_KLINE) {
+ state = StrategyState.OPENING;
+ log.info("[Gate] 首根K线到达，开基底仓位...");
+ executor.openLong(config.getQuantity(), () -> {
+ log.info("[Gate] 基底多单已提交");
+ }, null);
+ executor.openShort(negate(config.getQuantity()), () -> {
+ log.info("[Gate] 基底空单已提交");
+ }, null);
+ return;
+ }
+
+ if (state != StrategyState.ACTIVE) {
+ return;
+ }
+ processShortGrid(closePrice);
+ processLongGrid(closePrice);
+ }
+
+ // ---- 仓位推送回调 ----
+
+ public void onPositionUpdate(String contract, Position.ModeEnum mode, BigDecimal size,
+ BigDecimal entryPrice) {
+ if (state == StrategyState.STOPPED || state == StrategyState.WAITING_KLINE) {
+ return;
+ }
+
+ boolean hasPosition = size.abs().compareTo(BigDecimal.ZERO) > 0;
+
+ if (Position.ModeEnum.DUAL_LONG == mode) {
+ if (hasPosition) {
+ longActive = true;
+ longEntryPrice = entryPrice;
+ longPositionSize = size;
+ if (!baseLongOpened) {
+ longBaseEntryPrice = entryPrice;
+ baseLongOpened = true;
+ log.info("[Gate] 基底多成交价: {}", longBaseEntryPrice);
+ tryGenerateQueues();
+ } else {
+ BigDecimal tpPrice = entryPrice.multiply(BigDecimal.ONE.add(config.getGridRate())).setScale(1, RoundingMode.HALF_UP);
+ executor.placeTakeProfit(tpPrice,
+ FuturesPriceTrigger.RuleEnum.NUMBER_1, ORDER_TYPE_CLOSE_LONG, negate(config.getQuantity()));
+ log.info("[Gate] 多单止盈已设, entry:{}, tp:{}, size:{}", entryPrice, tpPrice, negate(config.getQuantity()));
+ }
+ } else {
+ longActive = false;
+ longPositionSize = BigDecimal.ZERO;
+ }
+ } else if (Position.ModeEnum.DUAL_SHORT == mode) {
+ if (hasPosition) {
+ shortActive = true;
+ shortEntryPrice = entryPrice;
+ shortPositionSize = size.abs();
+ if (!baseShortOpened) {
+ shortBaseEntryPrice = entryPrice;
+ baseShortOpened = true;
+ log.info("[Gate] 基底空成交价: {}", shortBaseEntryPrice);
+ tryGenerateQueues();
+ } else {
+ BigDecimal tpPrice = entryPrice.multiply(BigDecimal.ONE.subtract(config.getGridRate())).setScale(1, RoundingMode.HALF_UP);
+ executor.placeTakeProfit(tpPrice,
+ FuturesPriceTrigger.RuleEnum.NUMBER_2, ORDER_TYPE_CLOSE_SHORT, config.getQuantity());
+ log.info("[Gate] 空单止盈已设, entry:{}, tp:{}, size:{}", entryPrice, tpPrice, config.getQuantity());
+ }
+ } else {
+ shortActive = false;
+ shortPositionSize = BigDecimal.ZERO;
+ }
+ }
+ }
+
+ // ---- 平仓推送回调 ----
+
+ public void onPositionClose(String contract, String side, BigDecimal pnl) {
+ if (state == StrategyState.STOPPED) {
+ return;
+ }
+ cumulativePnl = cumulativePnl.add(pnl);
+ log.info("[Gate] 盈亏累加:{}, 方向:{}, 累计:{}", pnl, side, cumulativePnl);
+
+ if (cumulativePnl.compareTo(config.getOverallTp()) >= 0) {
+ log.info("[Gate] 已达止盈目标 {}→已停止", cumulativePnl);
+ state = StrategyState.STOPPED;
+ } else if (cumulativePnl.compareTo(config.getMaxLoss().negate()) <= 0) {
+ log.info("[Gate] 已达亏损上限 {}→已停止", cumulativePnl);
+ state = StrategyState.STOPPED;
+ }
+ }
+
+ // ---- 网格队列处理 ----
+
+ private void tryGenerateQueues() {
+ if (baseLongOpened && baseShortOpened) {
+ generateShortQueue();
+ generateLongQueue();
+ state = StrategyState.ACTIVE;
+ log.info("[Gate] 网格队列已生成, 空队首:{} → 尾:{}, 多队首:{} → 尾:{}, 已激活",
+ shortPriceQueue.get(0), shortPriceQueue.get(shortPriceQueue.size() - 1),
+ longPriceQueue.get(0), longPriceQueue.get(longPriceQueue.size() - 1));
+ }
+ }
+
+ private void generateShortQueue() {
+ shortPriceQueue.clear();
+ BigDecimal step = config.getGridRate();
+ for (int i = 1; i <= config.getGridQueueSize(); i++) {
+ shortPriceQueue.add(shortBaseEntryPrice.multiply(BigDecimal.ONE.subtract(step.multiply(BigDecimal.valueOf(i)))).setScale(1, RoundingMode.HALF_UP));
+ }
+ shortPriceQueue.sort((a, b) -> b.compareTo(a));
+ //输出队列：shortPriceQueue;
+ log.info("[Gate] 空队列:{}", shortPriceQueue);
+ }
+
+ private void generateLongQueue() {
+ longPriceQueue.clear();
+ BigDecimal step = config.getGridRate();
+ for (int i = 1; i <= config.getGridQueueSize(); i++) {
+ longPriceQueue.add(longBaseEntryPrice.multiply(BigDecimal.ONE.add(step.multiply(BigDecimal.valueOf(i)))).setScale(1, RoundingMode.HALF_UP));
+ }
+ longPriceQueue.sort(BigDecimal::compareTo);
+ log.info("[Gate] 多队列:{}", longPriceQueue);
+ }
+
+ /**
+ * 空仓网格处理（价格跌破空仓队列中的高价）。
+ *
+ * <h3>匹配规则</h3>
+ * 遍历空仓队列（降序），收集所有大于当前价的元素为 matched。
+ * 队列为降序排列，一旦遇 price ≤ currentPrice 即停止遍历。
+ *
+ * <h3>执行流程</h3>
+ * <ol>
+ * <li>匹配队列元素 → 为空则直接返回</li>
+ * <li>保证金检查 → 安全则开空一次</li>
+ * <li>额外反向开多：若多仓均价 > 空仓均价 且 当前价夹在中间且远离多仓均价</li>
+ * <li>空仓队列：移除 matched 元素，尾部补充新元素（尾价 × (1 − gridRate) 循环递减）</li>
+ * <li>多仓队列：以多仓队列首元素（最小价）为种子，生成 matched.size() 个递减元素加入</li>
+ * </ol>
+ *
+ * <h3>多仓队列转移过滤</h3>
+ * 新增元素若与多仓持仓均价差距小于 gridRate，则跳过该元素（避免在持仓成本附近生成无效网格线）。
+ */
+ private void processShortGrid(BigDecimal currentPrice) {
+ List<BigDecimal> matched = new ArrayList<>();
+ synchronized (shortPriceQueue) {
+ for (BigDecimal p : shortPriceQueue) {
+ if (p.compareTo(currentPrice) > 0) {
+ matched.add(p);
+ } else {
+ break;
+ }
+ }
+ }
+ log.info("[Gate] 原空队列:{}", shortPriceQueue);
+ if (matched.isEmpty()) {
+ log.info("[Gate] 空仓队列未触发, 当前价:{}", currentPrice);
+ return;
+ }
+ log.info("[Gate] 空仓队列触发, 匹配{}个元素, 当前价:{}", matched.size(), currentPrice);
+ if (!isMarginSafe()) {
+ log.warn("[Gate] 保证金超限，跳过空单开仓");
+ } else {
+ executor.openShort(negate(config.getQuantity()), null, null);
+ if (shortEntryPrice.compareTo(BigDecimal.ZERO) > 0
+ && longEntryPrice.compareTo(BigDecimal.ZERO) > 0
+ && longEntryPrice.compareTo(shortEntryPrice) > 0
+ && currentPrice.compareTo(shortEntryPrice) > 0
+ && currentPrice.compareTo(longEntryPrice.multiply(BigDecimal.ONE.subtract(config.getGridRate()))) < 0) {
+ executor.openLong(config.getQuantity(), null, null);
+ log.info("[Gate] 触发价在多/空持仓价之间且多>空且远离多仓均价, 额外开多一次, 当前价:{}", currentPrice);
+ }
+ }
+
+ synchronized (shortPriceQueue) {
+ shortPriceQueue.removeAll(matched);
+ BigDecimal min = shortPriceQueue.isEmpty() ? matched.get(matched.size() - 1) : shortPriceQueue.get(shortPriceQueue.size() - 1);
+ BigDecimal step = config.getGridRate();
+ for (int i = 0; i < matched.size(); i++) {
+ min = min.multiply(BigDecimal.ONE.subtract(step)).setScale(1, RoundingMode.HALF_UP);
+ shortPriceQueue.add(min);
+ }
+ shortPriceQueue.sort(BigDecimal::compareTo);
+
+ log.info("[Gate] 现空队列:{}", shortPriceQueue);
+ }
+
+ synchronized (longPriceQueue) {
+ BigDecimal first = longPriceQueue.isEmpty() ? matched.get(matched.size() - 1) : longPriceQueue.get(0);
+ BigDecimal step = config.getGridRate();
+ int added = 0;
+ for (int i = 1; i <= matched.size(); i++) {
+ BigDecimal elem = first.multiply(BigDecimal.ONE.subtract(step.multiply(BigDecimal.valueOf(i)))).setScale(1, RoundingMode.HALF_UP);
+ if (longEntryPrice.compareTo(BigDecimal.ZERO) > 0
+ && elem.subtract(longEntryPrice).abs().compareTo(longEntryPrice.multiply(step)) < 0) {
+ continue;
+ }
+ longPriceQueue.add(elem);
+ added++;
+ }
+ longPriceQueue.sort(BigDecimal::compareTo);
+ while (longPriceQueue.size() > config.getGridQueueSize()) {
+ longPriceQueue.remove(longPriceQueue.size() - 1);
+ }
+ log.info("[Gate] 现多队列:{}, 跳过{}个(贴近多仓均价)", longPriceQueue, matched.size() - added);
}
}
/**
- * 检查多空仓位是否触及止盈止损
+ * 多仓网格处理（价格涨破多仓队列中的低价）。
+ *
+ * <h3>匹配规则</h3>
+ * 遍历多仓队列（升序），收集所有小于当前价的元素为 matched。
+ * 队列为升序排列，一旦遇 price ≥ currentPrice 即停止遍历。
+ *
+ * <h3>执行流程</h3>
+ * <ol>
+ * <li>匹配队列元素 → 为空则直接返回</li>
+ * <li>保证金检查 → 安全则开多一次</li>
+ * <li>额外反向开空：若多仓均价 > 空仓均价 且 当前价夹在中间且远离空仓均价</li>
+ * <li>多仓队列：移除 matched 元素，尾部补充新元素（尾价 × (1 + gridRate) 循环递增）</li>
+ * <li>空仓队列：以空仓队列首元素（最高价）为种子，生成 matched.size() 个递增元素加入</li>
+ * </ol>
+ *
+ * <h3>空仓队列转移过滤</h3>
+ * 新增元素若与空仓持仓均价差距小于 gridRate，则跳过该元素（避免在持仓成本附近生成无效网格线）。
*/
- private void checkPositions(BigDecimal currentPrice) {
- if (longEntryPrice == null || shortEntryPrice == null) {
+ private void processLongGrid(BigDecimal currentPrice) {
+ List<BigDecimal> matched = new ArrayList<>();
+ synchronized (longPriceQueue) {
+ for (BigDecimal p : longPriceQueue) {
+ if (p.compareTo(currentPrice) < 0) {
+ matched.add(p);
+ } else {
+ break;
+ }
+ }
+ }
+ log.info("[Gate] 原多队列:{}", longPriceQueue);
+ if (matched.isEmpty()) {
+ log.info("[Gate] 多仓队列未触发, 当前价:{}", currentPrice);
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);
+ log.info("[Gate] 多仓队列触发, 匹配{}个元素, 当前价:{}", matched.size(), currentPrice);
+ if (!isMarginSafe()) {
+ log.warn("[Gate] 保证金超限，跳过多单开仓");
+ } else {
+ executor.openLong(config.getQuantity(), null, null);
+ if (shortEntryPrice.compareTo(BigDecimal.ZERO) > 0
+ && longEntryPrice.compareTo(BigDecimal.ZERO) > 0
+ && longEntryPrice.compareTo(shortEntryPrice) > 0
+ && currentPrice.compareTo(shortEntryPrice.multiply(BigDecimal.ONE.add(config.getGridRate()))) > 0
+ && currentPrice.compareTo(longEntryPrice) < 0) {
+ executor.openShort(negate(config.getQuantity()), null, null);
+ log.info("[Gate] 触发价在多/空持仓价之间且多>空且远离空仓均价, 额外开空一次, 当前价:{}", currentPrice);
+ }
+ }
- 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("===================================");
+ synchronized (longPriceQueue) {
+ longPriceQueue.removeAll(matched);
+ BigDecimal max = longPriceQueue.isEmpty() ? matched.get(matched.size() - 1) : longPriceQueue.get(longPriceQueue.size() - 1);
+ BigDecimal step = config.getGridRate();
+ for (int i = 0; i < matched.size(); i++) {
+ max = max.multiply(BigDecimal.ONE.add(step)).setScale(1, RoundingMode.HALF_UP);
+ longPriceQueue.add(max);
+ }
+ longPriceQueue.sort(BigDecimal::compareTo);
- // 多头止盈
- 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();
- return;
+ log.info("[Gate] 现多队列:{}", longPriceQueue);
}
- // 多头止损
- 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();
- 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();
+
+ synchronized (shortPriceQueue) {
+ BigDecimal first = shortPriceQueue.isEmpty() ? matched.get(0) : shortPriceQueue.get(0);
+ BigDecimal step = config.getGridRate();
+ int added = 0;
+ for (int i = 1; i <= matched.size(); i++) {
+ BigDecimal elem = first.multiply(BigDecimal.ONE.add(step.multiply(BigDecimal.valueOf(i)))).setScale(1, RoundingMode.HALF_UP);
+ if (shortEntryPrice.compareTo(BigDecimal.ZERO) > 0
+ && elem.subtract(shortEntryPrice).abs().compareTo(shortEntryPrice.multiply(step)) < 0) {
+ continue;
+ }
+ shortPriceQueue.add(elem);
+ added++;
+ }
+ shortPriceQueue.sort((a, b) -> b.compareTo(a));
+ while (shortPriceQueue.size() > config.getGridQueueSize()) {
+ shortPriceQueue.remove(shortPriceQueue.size() - 1);
+ }
+ log.info("[Gate] 现空队列:{}, 跳过{}个(贴近空仓均价)", shortPriceQueue, matched.size() - added);
}
}
- 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();
- }
+ // ---- 保证金安全阀 ----
- private void closeLongPosition() {
- if (longEntryPrice == null) return;
+ private boolean isMarginSafe() {
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());
+ FuturesAccount account = futuresApi.listFuturesAccounts(SETTLE);
+ BigDecimal margin = new BigDecimal(account.getPositionInitialMargin());
+ BigDecimal ratio = margin.divide(initialPrincipal, 4, RoundingMode.HALF_UP);
+ log.debug("[Gate] 保证金比例: {}/{}={}", margin, initialPrincipal, ratio);
+ return ratio.compareTo(config.getMarginRatioLimit()) < 0;
} catch (Exception e) {
- log.error("[GateGrid] 平多失败", e);
+ log.warn("[Gate] 查保证金失败，默认放行", e);
+ return true;
}
- longEntryPrice = null;
- longOrderId = null;
}
- 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);
+ // ---- 工具 ----
+
+ private String negate(String qty) {
+ return qty.startsWith("-") ? qty.substring(1) : "-" + qty;
+ }
+
+ /**
+ * 根据持仓和当前价格计算未实现盈亏。
+ *
+ * <h3>正向合约公式</h3>
+ * <pre>
+ * 多仓: 持仓量 × 合约乘数 × (计价价格 − 开仓均价)
+ * 空仓: 持仓量 × 合约乘数 × (开仓均价 − 计价价格)
+ * </pre>
+ * 计价价格由 {@link GateConfig.PnLPriceMode} 决定：LAST_PRICE 用最新成交价，MARK_PRICE 用标记价格。
+ */
+ private void updateUnrealizedPnl() {
+ BigDecimal price = resolvePnlPrice();
+ if (price == null || price.compareTo(BigDecimal.ZERO) == 0) {
+ return;
}
- shortEntryPrice = null;
- shortOrderId = null;
- }
-
- 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);
+ BigDecimal multiplier = config.getContractMultiplier();
+ BigDecimal longPnl = BigDecimal.ZERO;
+ BigDecimal shortPnl = BigDecimal.ZERO;
+ if (longPositionSize.compareTo(BigDecimal.ZERO) > 0 && longEntryPrice.compareTo(BigDecimal.ZERO) > 0) {
+ longPnl = longPositionSize.multiply(multiplier).multiply(price.subtract(longEntryPrice));
}
- return "-" + qty;
- }
-
- private BigDecimal safeDecimal(String val) {
- if (val == null || val.isEmpty()) {
- return BigDecimal.ZERO;
+ if (shortPositionSize.compareTo(BigDecimal.ZERO) > 0 && shortEntryPrice.compareTo(BigDecimal.ZERO) > 0) {
+ shortPnl = shortPositionSize.multiply(multiplier).multiply(shortEntryPrice.subtract(price));
}
- return new BigDecimal(val);
+ unrealizedPnl = longPnl.add(shortPnl);
+
+ log.info("[Gate] 未实现盈亏: {}", unrealizedPnl);
}
- public BigDecimal getLastClosePrice() {
- return lastClosePrice;
+ /**
+ * 根据配置的 PnLPriceMode 返回计价价格。
+ */
+ private BigDecimal resolvePnlPrice() {
+ if (config.getUnrealizedPnlPriceMode() == GateConfig.PnLPriceMode.MARK_PRICE
+ && markPrice.compareTo(BigDecimal.ZERO) > 0) {
+ return markPrice;
+ }
+ return lastKlinePrice;
}
- public boolean isStrategyActive() {
- return strategyActive;
- }
-
- public BigDecimal getTotalProfit() {
- return totalProfit;
- }
-
- public int getCurrentCycle() {
- return currentCycle;
- }
+ public BigDecimal getLastKlinePrice() { return lastKlinePrice; }
+ public void setMarkPrice(BigDecimal markPrice) { this.markPrice = markPrice; }
+ public boolean isStrategyActive() { return state != StrategyState.STOPPED && state != StrategyState.WAITING_KLINE; }
+ public BigDecimal getCumulativePnl() { return cumulativePnl; }
+ public BigDecimal getUnrealizedPnl() { return unrealizedPnl; }
+ public Long getUserId() { return userId; }
+ public StrategyState getState() { return state; }
}
--
Gitblit v1.9.1