From e9a397babbbfa9cff8a5ed026447d585e739c37f Mon Sep 17 00:00:00 2001
From: Administrator <15274802129@163.com>
Date: Tue, 12 May 2026 21:47:21 +0800
Subject: [PATCH] refactor(gateApi): 将网格交易策略从限价单改为条件单
---
src/main/java/com/xcong/excoin/modules/gateApi/GateConfig.java | 39 +++++++++++++++++++++++++++++++--------
1 files changed, 31 insertions(+), 8 deletions(-)
diff --git a/src/main/java/com/xcong/excoin/modules/gateApi/GateConfig.java b/src/main/java/com/xcong/excoin/modules/gateApi/GateConfig.java
index b65d0aa..094eaab 100644
--- a/src/main/java/com/xcong/excoin/modules/gateApi/GateConfig.java
+++ b/src/main/java/com/xcong/excoin/modules/gateApi/GateConfig.java
@@ -8,20 +8,27 @@
* <p>通过 Builder 模式集中管理所有运行参数，避免参数散落在多个文件中。
* 提供 REST API 和 WebSocket 地址的自动环境切换（测试网/生产网）。
*
+ * <h3>关键参数</h3>
+ * <ul>
+ * <li><b>网格参数</b>：gridRate（比例间距）、step（绝对步长 = shortBaseEntryPrice × gridRate，运行时计算）、
+ * gridQueueSize（队列容量）</li>
+ * <li><b>止盈止损</b>：overallTp（整体止盈 USDT）、maxLoss（最大亏损 USDT）</li>
+ * <li><b>风险控制</b>：marginRatioLimit（保证金占比上限，超限跳过开仓）、leverage（杠杆）、
+ * marginMode（全仓/逐仓）、positionMode（单向/双向）</li>
+ * <li><b>盈亏计算</b>：contractMultiplier（合约乘数）、unrealizedPnlPriceMode（计价模式：最新价/标记价）</li>
+ * </ul>
+ *
* <h3>使用示例</h3>
* <pre>
* GateConfig config = GateConfig.builder()
* .apiKey("...")
* .apiSecret("...")
- * .contract("XAU_USDT")
+ * .contract("ETH_USDT")
* .leverage("100")
* .gridRate(new BigDecimal("0.0035"))
- * .contractMultiplier("0.001")
+ * .contractMultiplier("0.01")
* .isProduction(false)
* .build();
- *
- * String restUrl = config.getRestBasePath(); // 自动返回测试网或生产网地址
- * String wsUrl = config.getWsUrl();
* </pre>
*
* <h3>默认值</h3>
@@ -36,11 +43,18 @@
*/
public class GateConfig {
- /** 未实现盈亏计价模式 */
+ /**
+ * 未实现盈亏（unrealizedPnl）计价模式。
+ *
+ * <ul>
+ * <li>{@link #LAST_PRICE} — 按最新成交价计算，变动快、更贴近实际平仓价</li>
+ * <li>{@link #MARK_PRICE} — 按标记价格计算，变动平稳、过滤市场噪音</li>
+ * </ul>
+ */
public enum PnLPriceMode {
- /** 按最新成交价计算 */
+ /** 按最新成交价计算未实现盈亏 */
LAST_PRICE,
- /** 按标记价格计算 */
+ /** 按标记价格计算未实现盈亏，需通过 {@link GateGridTradeService#setMarkPrice(BigDecimal)} 注入 */
MARK_PRICE
}
@@ -76,6 +90,8 @@
private final BigDecimal contractMultiplier;
/** 未实现盈亏计价模式：最新价 / 标记价格 */
private final PnLPriceMode unrealizedPnlPriceMode;
+ /** 网格绝对步长（shortBaseEntryPrice × gridRate），运行时由队列生成逻辑设置 */
+ private BigDecimal step;
private GateConfig(Builder builder) {
this.apiKey = builder.apiKey;
@@ -172,6 +188,13 @@
/** @return 未实现盈亏计价模式：LAST_PRICE（最新成交价）/ MARK_PRICE（标记价格） */
public PnLPriceMode getUnrealizedPnlPriceMode() { return unrealizedPnlPriceMode; }
+ // ==================== 运行时参数 ====================
+
+ /** @return 网格绝对步长（shortBaseEntryPrice × gridRate），运行时设置 */
+ public BigDecimal getStep() { return step; }
+ /** 设置网格绝对步长（由 generateShortQueue 在运行时计算并注入） */
+ public void setStep(BigDecimal step) { this.step = step; }
+
// ==================== 环境 ====================
/** @return 是否为生产环境（true=实盘生产网 / false=模拟盘测试网） */
--
Gitblit v1.9.1