package com.xcong.excoin.modules.gateApi; import java.math.BigDecimal; /** * Gate 模块统一配置。 * *

通过 Builder 模式集中管理所有运行参数,避免参数散落在多个文件中。 * 提供 REST API 和 WebSocket 地址的自动环境切换(测试网/生产网)。 * *

使用示例

*
 *   GateConfig config = GateConfig.builder()
 *       .apiKey("...")
 *       .apiSecret("...")
 *       .contract("XAU_USDT")
 *       .leverage("100")
 *       .gridRate(new BigDecimal("0.0035"))
 *       .contractMultiplier("0.001")
 *       .isProduction(false)
 *       .build();
 *
 *   String restUrl = config.getRestBasePath();  // 自动返回测试网或生产网地址
 *   String wsUrl   = config.getWsUrl();
 * 
* *

默认值

* * * @author Administrator */ public class GateConfig { /** 未实现盈亏计价模式 */ public enum PnLPriceMode { /** 按最新成交价计算 */ LAST_PRICE, /** 按标记价格计算 */ MARK_PRICE } /** 账号标签(用于日志区分多账号) */ private final String label; /** Gate API v4 密钥 */ private final String apiKey; /** Gate API v4 签名密钥 */ private final String apiSecret; /** 合约名称(如 XAU_USDT) */ private final String contract; /** 杠杆倍数 */ private final String leverage; /** 保证金模式(cross / isolated) */ private final String marginMode; /** 持仓模式(single / dual / dual_plus) */ private final String positionMode; /** 网格间距比例(如 0.0035 表示 0.35%) */ private final BigDecimal gridRate; /** 整体止盈阈值(USDT) */ private final BigDecimal overallTp; /** 最大亏损阈值(USDT) */ private final BigDecimal maxLoss; /** 下单数量(合约张数) */ private final String quantity; /** 是否为生产环境 */ private final boolean isProduction; /** 补仓最大重试次数 */ private final int reopenMaxRetries; /** 网格队列容量 */ private final int gridQueueSize; /** 保证金占初始本金比例上限 */ private final BigDecimal marginRatioLimit; /** 合约乘数(单张合约代表的基础资产数量,如 BTC_USDT=0.001, ETH_USDT=0.01) */ private final BigDecimal contractMultiplier; /** 未实现盈亏计价模式:最新价 / 标记价格 */ private final PnLPriceMode unrealizedPnlPriceMode; private GateConfig(Builder builder) { this.label = builder.label; this.apiKey = builder.apiKey; this.apiSecret = builder.apiSecret; this.contract = builder.contract; this.leverage = builder.leverage; this.marginMode = builder.marginMode; this.positionMode = builder.positionMode; this.gridRate = builder.gridRate; this.overallTp = builder.overallTp; this.maxLoss = builder.maxLoss; this.quantity = builder.quantity; this.isProduction = builder.isProduction; this.reopenMaxRetries = builder.reopenMaxRetries; this.gridQueueSize = builder.gridQueueSize; this.marginRatioLimit = builder.marginRatioLimit; this.contractMultiplier = builder.contractMultiplier; this.unrealizedPnlPriceMode = builder.unrealizedPnlPriceMode; } /** * 根据环境返回 REST API 基础路径。 * */ public String getRestBasePath() { return isProduction ? "https://api.gateio.ws/api/v4" : "https://api-testnet.gateapi.io/api/v4"; } /** * 根据环境返回 WebSocket 地址。 * */ public String getWsUrl() { return isProduction ? "wss://fx-ws.gateio.ws/v4/ws/usdt" : "wss://ws-testnet.gate.com/v4/ws/futures/usdt"; } public String getLabel() { return label; } public String getApiKey() { return apiKey; } public String getApiSecret() { return apiSecret; } public String getContract() { return contract; } public String getLeverage() { return leverage; } public String getMarginMode() { return marginMode; } public String getPositionMode() { return positionMode; } public BigDecimal getGridRate() { return gridRate; } public BigDecimal getOverallTp() { return overallTp; } public BigDecimal getMaxLoss() { return maxLoss; } public String getQuantity() { return quantity; } public boolean isProduction() { return isProduction; } public int getReopenMaxRetries() { return reopenMaxRetries; } public int getGridQueueSize() { return gridQueueSize; } public BigDecimal getMarginRatioLimit() { return marginRatioLimit; } public BigDecimal getContractMultiplier() { return contractMultiplier; } public PnLPriceMode getUnrealizedPnlPriceMode() { return unrealizedPnlPriceMode; } public static Builder builder() { return new Builder(); } /** * GateConfig 的流式构造器,提供合理的默认值。 */ public static class Builder { private String label = "default"; private String apiKey; private String apiSecret; private String contract = "BTC_USDT"; private String leverage = "10"; private String marginMode = "cross"; private String positionMode = "dual"; private BigDecimal gridRate = new BigDecimal("0.0035"); private BigDecimal overallTp = new BigDecimal("0.5"); private BigDecimal maxLoss = new BigDecimal("7.5"); private String quantity = "1"; private boolean isProduction = false; private int reopenMaxRetries = 3; private int gridQueueSize = 50; private BigDecimal marginRatioLimit = new BigDecimal("0.2"); private BigDecimal contractMultiplier = new BigDecimal("0.001"); private PnLPriceMode unrealizedPnlPriceMode = PnLPriceMode.LAST_PRICE; public Builder label(String label) { this.label = label; return this; } public Builder apiKey(String apiKey) { this.apiKey = apiKey; return this; } public Builder apiSecret(String apiSecret) { this.apiSecret = apiSecret; return this; } public Builder contract(String contract) { this.contract = contract; return this; } public Builder leverage(String leverage) { this.leverage = leverage; return this; } public Builder marginMode(String marginMode) { this.marginMode = marginMode; return this; } public Builder positionMode(String positionMode) { this.positionMode = positionMode; return this; } public Builder gridRate(BigDecimal gridRate) { this.gridRate = gridRate; return this; } public Builder overallTp(BigDecimal overallTp) { this.overallTp = overallTp; return this; } public Builder maxLoss(BigDecimal maxLoss) { this.maxLoss = maxLoss; return this; } public Builder quantity(String quantity) { this.quantity = quantity; return this; } public Builder isProduction(boolean isProduction) { this.isProduction = isProduction; return this; } public Builder reopenMaxRetries(int reopenMaxRetries) { this.reopenMaxRetries = reopenMaxRetries; return this; } public Builder contractMultiplier(BigDecimal contractMultiplier) { this.contractMultiplier = contractMultiplier; return this; } public Builder unrealizedPnlPriceMode(PnLPriceMode mode) { this.unrealizedPnlPriceMode = mode; return this; } public GateConfig build() { return new GateConfig(this); } } }