| | |
|---|
| | | * <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> |
|---|
| | |
|---|
| | | */ |
|---|
| | | 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 |
|---|
| | | } |
|---|
| | | |
|---|
