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();
*
*
* 默认值
*
* - 合约: BTC_USDT, 杠杆: 10x, 全仓, 双向持仓
* - 网格间距: 0.35%, 队列容量: 50, 保证金比例上限: 20%
* - 止盈: 0.5 USDT, 亏损上限: 7.5 USDT
* - 数量: 1 张, 合约乘数: 0.001, 环境: 测试网
*
*
* @author Administrator
*/
public class GateConfig {
/** 未实现盈亏计价模式 */
public enum PnLPriceMode {
/** 按最新成交价计算 */
LAST_PRICE,
/** 按标记价格计算 */
MARK_PRICE
}
/** 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;
/** 网格绝对步长(shortBaseEntryPrice × gridRate),运行时由队列生成逻辑设置 */
private BigDecimal step;
private GateConfig(Builder builder) {
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/WS 地址 ====================
/**
* 根据环境返回 REST API 基础路径。
*
* - 测试网: {@code https://api-testnet.gateapi.io/api/v4}
* - 生产网: {@code https://api.gateio.ws/api/v4}
*
*/
public String getRestBasePath() {
return isProduction
? "https://api.gateio.ws/api/v4"
: "https://api-testnet.gateapi.io/api/v4";
}
/**
* 根据环境返回 WebSocket 地址。
*
* - 测试网: {@code wss://ws-testnet.gate.com/v4/ws/futures/usdt}
* - 生产网: {@code wss://fx-ws.gateio.ws/v4/ws/usdt}
*
*/
public String getWsUrl() {
return isProduction
? "wss://fx-ws.gateio.ws/v4/ws/usdt"
: "wss://ws-testnet.gate.com/v4/ws/futures/usdt";
}
// ==================== 认证信息 ====================
/** @return Gate API v4 密钥 */
public String getApiKey() { return apiKey; }
/** @return Gate API v4 签名密钥,用于 HMAC-SHA512 签名 */
public String getApiSecret() { return apiSecret; }
// ==================== 交易标的 ====================
/** @return 合约名称(如 ETH_USDT、XAU_USDT) */
public String getContract() { return contract; }
/** @return 杠杆倍数(如 "100" 表示 100x) */
public String getLeverage() { return leverage; }
// ==================== 持仓配置 ====================
/** @return 保证金模式(cross=全仓 / isolated=逐仓) */
public String getMarginMode() { return marginMode; }
/** @return 持仓模式(single=单向 / dual=双向 / dual_plus) */
public String getPositionMode() { return positionMode; }
// ==================== 策略参数 ====================
/** @return 网格间距比例(如 0.0015 表示 0.15%),用于生成价格队列和计算止盈价 */
public BigDecimal getGridRate() { return gridRate; }
/** @return 整体止盈阈值(USDT),累计已实现盈亏 ≥ 此值时策略停止 */
public BigDecimal getOverallTp() { return overallTp; }
/** @return 最大亏损阈值(USDT),累计已实现盈亏 ≤ -此值时策略停止 */
public BigDecimal getMaxLoss() { return maxLoss; }
/** @return 每次下单的张数(如 "1" 表示 1 张合约) */
public String getQuantity() { return quantity; }
/** @return 网格价格队列的容量上限(超出时截断尾部) */
public int getGridQueueSize() { return gridQueueSize; }
// ==================== 风险控制 ====================
/** @return 保证金占初始本金比例上限(默认 0.2 即 20%),超限跳过开仓 */
public BigDecimal getMarginRatioLimit() { return marginRatioLimit; }
/** @return 补仓最大重试次数(当前版本未使用) */
public int getReopenMaxRetries() { return reopenMaxRetries; }
// ==================== 盈亏计算 ====================
/** @return 合约乘数(单张合约代表的基础资产数量,如 ETH_USDT=0.01) */
public BigDecimal getContractMultiplier() { return contractMultiplier; }
/** @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=模拟盘测试网) */
public boolean isProduction() { return isProduction; }
public static Builder builder() {
return new Builder();
}
/**
* GateConfig 的流式构造器,提供合理的默认值。
*
* 必填项
* {@code apiKey} 和 {@code apiSecret} 必须设置,其余参数均有默认值。
*
* 默认值
* BTC_USDT / 10x / cross(全仓) / dual(双向) / gridRate=0.35% /
* overallTp=0.5 / maxLoss=7.5 / quantity=1 / isProduction=false
*/
public static class Builder {
/** Gate API v4 密钥(必填) */
private String apiKey;
/** Gate API v4 签名密钥(必填) */
private String apiSecret;
/** 合约名称,默认 BTC_USDT */
private String contract = "BTC_USDT";
/** 杠杆倍数,默认 "10" */
private String leverage = "10";
/** 保证金模式,默认 "cross"(全仓) */
private String marginMode = "cross";
/** 持仓模式,默认 "dual"(双向) */
private String positionMode = "dual";
/** 网格间距比例,默认 0.0035(0.35%) */
private BigDecimal gridRate = new BigDecimal("0.0035");
/** 整体止盈阈值(USDT),默认 0.5 */
private BigDecimal overallTp = new BigDecimal("0.5");
/** 最大亏损阈值(USDT),默认 7.5 */
private BigDecimal maxLoss = new BigDecimal("7.5");
/** 每次下单张数,默认 "1" */
private String quantity = "1";
/** 是否为生产环境,默认 false(测试网) */
private boolean isProduction = false;
/** 补仓最大重试次数,默认 3 */
private int reopenMaxRetries = 3;
/** 网格队列容量,默认 50 */
private int gridQueueSize = 50;
/** 保证金占初始本金比例上限,默认 0.2(20%) */
private BigDecimal marginRatioLimit = new BigDecimal("0.2");
/** 合约乘数,默认 0.001 */
private BigDecimal contractMultiplier = new BigDecimal("0.001");
/** 未实现盈亏计价模式,默认 LAST_PRICE(最新成交价) */
private PnLPriceMode unrealizedPnlPriceMode = PnLPriceMode.LAST_PRICE;
/** 设置 API Key */
public Builder apiKey(String apiKey) { this.apiKey = apiKey; return this; }
/** 设置 API Secret */
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; }
/** 设置保证金模式(cross=全仓 / isolated=逐仓) */
public Builder marginMode(String marginMode) { this.marginMode = marginMode; return this; }
/** 设置持仓模式(single=单向 / dual=双向) */
public Builder positionMode(String positionMode) { this.positionMode = positionMode; return this; }
/** 设置网格间距比例 */
public Builder gridRate(BigDecimal gridRate) { this.gridRate = gridRate; return this; }
/** 设置整体止盈阈值(USDT) */
public Builder overallTp(BigDecimal overallTp) { this.overallTp = overallTp; return this; }
/** 设置最大亏损阈值(USDT) */
public Builder maxLoss(BigDecimal maxLoss) { this.maxLoss = maxLoss; return this; }
/** 设置每次下单张数 */
public Builder quantity(String quantity) { this.quantity = quantity; return this; }
/** 设置环境(true=实盘生产网 / false=模拟盘测试网) */
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);
}
}
}