feat(gate): 添加自定义止损功能

Administrator

2026-09-20 7bddda3c90afb5cc6dedb3b08a6c7436327891dd

 src/main/java/com/xcong/excoin/modules/gateApi/GateConfig.java

@@ -111,6 +111,31 @@
    private final boolean priceDriveEnabled;
    /** 策略运行轮数：达到盈利后重启算一轮，达到上限后不再重启。0=不限轮数 */
    private final int rounds;
    /** 止损次数统计方式："single"=单向分别统计 / "dual"=双向统一统计，默认 "dual" */
    private final String stopLossCountMode;
    /** 加仓间隔：每隔多少次止损触发一次加仓，默认 3 */
    private final int addPositionInterval;
    /** 加仓数量：每次加仓追加的张数，默认 1 */
    private final int addPositionQuantity;
    /** 单边最大仓位量：单向持仓张数上限，超出则按上限挂单，0=不限制 */
    private final int maxPositionPerSide;
    /** 加仓启动阈值：前N次止损不触发加仓，默认 1（第1次止损不加仓，第2次起按公式计算） */
    private final int addPositionStartThreshold;
    /** 止盈挂单模式：关闭 */
    public static final String EXCESS_TP_OFF = "off";
    /** 止盈挂单模式：集中止盈（挂在对手第一止损位） */
    public static final String EXCESS_TP_CONCENTRATED = "concentrated";
    /** 止盈挂单模式：分散止盈（逐格挂到对手盘止损位） */
    public static final String EXCESS_TP_DISPERSED = "dispersed";

    /** 止盈挂单模式：off=关闭 / concentrated=集中止盈 / dispersed=分散止盈，默认 off */
    private final String placeExcessTakeProfit;
    /** 自定义止损开关：true=启用自定义止损触发价（多空各挂一单），false=使用默认阶梯止损。默认 false */
    private final boolean customStopLossEnabled;
    /** 多仓自定义止损触发价（价格跌至该值触发平多），null/0=未设置 */
    private final BigDecimal longCustomStopLossPrice;
    /** 空仓自定义止损触发价（价格涨至该值触发平空），null/0=未设置 */
    private final BigDecimal shortCustomStopLossPrice;
    /** 网格绝对步长（shortBaseEntryPrice × gridRate），运行时由队列生成逻辑设置 */
    private BigDecimal step;
    /** 网格元素列表，由队列初始化时同步填充，包含完整的多空仓挂单状态 */
@@ -146,6 +171,15 @@
        this.takeProfitGridSpan = builder.takeProfitGridSpan;
        this.priceDriveEnabled = builder.priceDriveEnabled;
        this.rounds = builder.rounds;
        this.stopLossCountMode = builder.stopLossCountMode;
        this.addPositionInterval = builder.addPositionInterval;
        this.addPositionQuantity = builder.addPositionQuantity;
        this.maxPositionPerSide = builder.maxPositionPerSide;
        this.addPositionStartThreshold = builder.addPositionStartThreshold;
        this.placeExcessTakeProfit = builder.placeExcessTakeProfit;
        this.customStopLossEnabled = builder.customStopLossEnabled;
        this.longCustomStopLossPrice = builder.longCustomStopLossPrice;
        this.shortCustomStopLossPrice = builder.shortCustomStopLossPrice;
    }

    // ==================== REST/WS 地址 ====================
@@ -241,6 +275,24 @@
    public boolean isPriceDriveEnabled() { return priceDriveEnabled; }
    /** @return 策略运行轮数上限，0=不限 */
    public int getRounds() { return rounds; }
    /** @return 止损次数统计方式："single"=单向分别统计 / "dual"=双向统一统计 */
    public String getStopLossCountMode() { return stopLossCountMode; }
    /** @return 加仓间隔：每隔多少次止损触发一次加仓 */
    public int getAddPositionInterval() { return addPositionInterval; }
    /** @return 加仓数量：每次加仓追加的张数 */
    public int getAddPositionQuantity() { return addPositionQuantity; }
    /** @return 单边最大仓位量：单向持仓张数上限，0=不限制 */
    public int getMaxPositionPerSide() { return maxPositionPerSide; }
    /** @return 加仓启动阈值：前N次止损不触发加仓 */
    public int getAddPositionStartThreshold() { return addPositionStartThreshold; }
    /** @return 止盈挂单模式：off=关闭 / concentrated=集中止盈 / dispersed=分散止盈 */
    public String getPlaceExcessTakeProfit() { return placeExcessTakeProfit; }
    /** @return 自定义止损开关：true=启用自定义止损触发价，false=使用默认阶梯止损 */
    public boolean isCustomStopLossEnabled() { return customStopLossEnabled; }
    /** @return 多仓自定义止损触发价，null/0=未设置 */
    public BigDecimal getLongCustomStopLossPrice() { return longCustomStopLossPrice; }
    /** @return 空仓自定义止损触发价，null/0=未设置 */
    public BigDecimal getShortCustomStopLossPrice() { return shortCustomStopLossPrice; }

    // ==================== 运行时参数 ====================

@@ -341,6 +393,24 @@
        private boolean priceDriveEnabled = true;
        /** 策略运行轮数上限，0=不限轮数。默认 0 */
        private int rounds = 0;
        /** 止损次数统计方式："single"=单向分别统计 / "dual"=双向统一统计，默认 "dual" */
        private String stopLossCountMode = "dual";
        /** 加仓间隔：每隔多少次止损触发一次加仓，默认 3 */
        private int addPositionInterval = 3;
        /** 加仓数量：每次加仓追加的张数，默认 1 */
        private int addPositionQuantity = 1;
        /** 单边最大仓位量：单向持仓张数上限，超出则按上限挂单，0=不限制 */
        private int maxPositionPerSide = 0;
        /** 加仓启动阈值：前N次止损不触发加仓，调整后的 effectiveCount = max(0, count - threshold)。默认 1 */
        private int addPositionStartThreshold = 1;
        /** 止盈挂单模式：off=关闭 / concentrated=集中止盈 / dispersed=分散止盈，默认 off */
        private String placeExcessTakeProfit = EXCESS_TP_OFF;
        /** 自定义止损开关：true=启用自定义止损触发价，false=使用默认阶梯止损。默认 false */
        private boolean customStopLossEnabled = false;
        /** 多仓自定义止损触发价，null=未设置 */
        private BigDecimal longCustomStopLossPrice;
        /** 空仓自定义止损触发价，null=未设置 */
        private BigDecimal shortCustomStopLossPrice;

        /** 设置 API Key */
        public Builder apiKey(String apiKey) { this.apiKey = apiKey; return this; }
@@ -392,6 +462,24 @@
        public Builder priceDriveEnabled(boolean priceDriveEnabled) { this.priceDriveEnabled = priceDriveEnabled; return this; }
        /** 设置策略运行轮数上限：达到盈利后重启计数，达到此值后不再重启。0=不限 */
        public Builder rounds(int rounds) { this.rounds = rounds; return this; }
        /** 设置止损次数统计方式："single"=单向分别统计 / "dual"=双向统一统计 */
        public Builder stopLossCountMode(String stopLossCountMode) { this.stopLossCountMode = stopLossCountMode; return this; }
        /** 设置加仓间隔：每隔多少次止损触发一次加仓 */
        public Builder addPositionInterval(int addPositionInterval) { this.addPositionInterval = addPositionInterval; return this; }
        /** 设置加仓数量：每次加仓追加的张数 */
        public Builder addPositionQuantity(int addPositionQuantity) { this.addPositionQuantity = addPositionQuantity; return this; }
        /** 设置单边最大仓位量：单向持仓张数上限，0=不限制 */
        public Builder maxPositionPerSide(int maxPositionPerSide) { this.maxPositionPerSide = maxPositionPerSide; return this; }
        /** 设置加仓启动阈值：前N次止损不触发加仓，0=立即启动 */
        public Builder addPositionStartThreshold(int addPositionStartThreshold) { this.addPositionStartThreshold = addPositionStartThreshold; return this; }
        /** 设置止盈挂单模式：off / concentrated / dispersed */
        public Builder placeExcessTakeProfit(String placeExcessTakeProfit) { this.placeExcessTakeProfit = placeExcessTakeProfit; return this; }
        /** 设置自定义止损开关：true=启用自定义止损触发价 */
        public Builder customStopLossEnabled(boolean customStopLossEnabled) { this.customStopLossEnabled = customStopLossEnabled; return this; }
        /** 设置多仓自定义止损触发价 */
        public Builder longCustomStopLossPrice(BigDecimal longCustomStopLossPrice) { this.longCustomStopLossPrice = longCustomStopLossPrice; return this; }
        /** 设置空仓自定义止损触发价 */
        public Builder shortCustomStopLossPrice(BigDecimal shortCustomStopLossPrice) { this.shortCustomStopLossPrice = shortCustomStopLossPrice; return this; }

        public GateConfig build() {
            return new GateConfig(this);