| | |
|---|
| | | |
|---|
| | | | 文件 | 类型 | 说明 | |
|---|
| | | |------|------|------| |
|---|
| | | | [GateWebSocketClientManager](#gatewebsocketclientmanager) | `@Component` | Spring 启动入口，生命周期管理 | |
|---|
| | | | [GateKlineWebSocketClient](#gateklinewebsocketclient) | WebSocket 连接管理 | 连接/心跳/重连/消息路由 | |
|---|
| | | | [GateGridTradeService](#gategridtradeservice) | 交易服务 | 网格策略 + REST 下单 | |
|---|
| | | | [GateWebSocketClientManager](#gatewebsocketclientmanager) | `@Component` | Spring 启动入口，组装组件 + 生命周期 | |
|---|
| | | | [GateConfig](#gateconfig) | 配置 | Builder 模式：API 密钥、合约、策略参数、环境切换 | |
|---|
| | | | [GateKlineWebSocketClient](#gateklinewebsocketclient) | WS 连接管理 | 连接/心跳/重连/消息路由 | |
|---|
| | | | [GateGridTradeService](#gategridtradeservice) | 交易服务 | 网格策略状态机 + 盈亏管理 | |
|---|
| | | | [GateTradeExecutor](#gatetradeexecutor) | 异步执行器 | 独立线程池执行 REST 下单，不阻塞 WS 回调线程 | |
|---|
| | | | [GateWebSocketClientMain](#gatewebsocketclientmain) | main 入口 | 独立测试启动 | |
|---|
| | | | [Example.java](#examplejava) | 示例 | Gate SDK 用法参考 | |
|---|
| | | |
|---|
| | |
|---|
| | | |
|---|
| | | | 文件 | 类型 | 说明 | |
|---|
| | | |------|------|------| |
|---|
| | | | `wsHandler/GateChannelHandler.java` | **接口** | `subscribe/unsubscribe/handleMessage/getChannelName` | |
|---|
| | | | `wsHandler/GateChannelHandler.java` | **接口** | subscribe / unsubscribe / handleMessage / getChannelName | |
|---|
| | | | `wsHandler/AbstractPrivateChannelHandler.java` | **抽象类** | 私有频道基类：HMAC-SHA512 签名 + 认证请求 | |
|---|
| | | | `wsHandler/handler/CandlestickChannelHandler.java` | 公开频道处理器 | K 线订阅/解析 → `onKline()` | |
|---|
| | | | `wsHandler/handler/PositionsChannelHandler.java` | 私有频道处理器 | 仓位推送解析 → `onPositionUpdate()` | |
|---|
| | | | `wsHandler/handler/PositionClosesChannelHandler.java` | 私有频道处理器 | 平仓推送解析 → `onPositionClose()` | |
|---|
| | | | `wsHandler/handler/CandlestickChannelHandler.java` | 公开频道 | K 线解析 → `onKline()` | |
|---|
| | | | `wsHandler/handler/PositionsChannelHandler.java` | 私有频道 | 仓位推送 → `onPositionUpdate()` | |
|---|
| | | | `wsHandler/handler/PositionClosesChannelHandler.java` | 私有频道 | 平仓推送 → `onPositionClose()` | |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | |
|---|
| | | │ GateWebSocketClientManager │ |
|---|
| | | │ (Spring @Component) │ |
|---|
| | | │ │ |
|---|
| | | │ @PostConstruct init(): │ |
|---|
| | | │ ┌──────────────────────┐ ┌───────────────────────────────┐ │ |
|---|
| | | │ │ GateGridTradeService │ │ GateKlineWebSocketClient │ │ |
|---|
| | | │ │ ▶ init() │ │ ▶ addChannelHandler(x3) │ │ |
|---|
| | | │ │ ▶ startGrid() │ │ ▶ init() │ │ |
|---|
| | | │ └──────┬───────────────┘ └──────────┬────────────────────┘ │ |
|---|
| | | │ │ REST API │ WebSocket (委托路由) │ |
|---|
| | | │ ▼ ▼ │ |
|---|
| | | │ Gate Testnet API Gate Testnet WS │ |
|---|
| | | │ (https://api-testnet...) (wss://ws-testnet.gate.com) │ |
|---|
| | | │ ┌──────────────────────┐ │ |
|---|
| | | │ │ CandlestickHandler │ → onKline │ |
|---|
| | | │ │ PositionsHandler │ → onPos │ |
|---|
| | | │ │ PositionClosesHandler │ → onClose │ |
|---|
| | | │ └──────────────────────┘ │ |
|---|
| | | │ GateConfig.builder() → GateGridTradeService + WS Client │ |
|---|
| | | │ │ │ │ │ |
|---|
| | | │ │ REST BasePath │ GateTradeExecutor │ WS URL │ |
|---|
| | | │ ▼ ▼ ▼ │ |
|---|
| | | │ Gate API (REST) 独立线程池 (async) Gate WebSocket │ |
|---|
| | | │ ┌──────────────┐ │ |
|---|
| | | │ │Candlestick H │ │ |
|---|
| | | │ │Positions H │ │ |
|---|
| | | │ │PosCloses H │ │ |
|---|
| | | │ └──────────────┘ │ |
|---|
| | | └──────────────────────────────────────────────────────────────────┘ |
|---|
| | | ``` |
|---|
| | | |
|---|
| | |
|---|
| | | ## 数据流 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | WebSocket 推送 |
|---|
| | | WebSocket → GateKlineWebSocketClient.handleMessage → 路由 dispatch |
|---|
| | | │ |
|---|
| | | ├─ futures.candlesticks (update) [公开] |
|---|
| | | │ └─ CandlestickChannelHandler.handleMessage() |
|---|
| | | │ ├─ 解析: o/h/l/c/v/a/t/w |
|---|
| | | │ ├─ 打印 K 线日志 |
|---|
| | | │ └─ GateGridTradeService.onKline(closePx) |
|---|
| | | │ ├─ 首次 → dualOpenPositions() → 开多 + 开空 + TP 单 |
|---|
| | | ├─ futures.pong → cancelPongTimeout |
|---|
| | | ├─ subscribe / unsubscribe / error → log |
|---|
| | | │ |
|---|
| | | ├─ futures.candlesticks (公开) |
|---|
| | | │ └─ CandlestickChannelHandler |
|---|
| | | │ └─ gridTradeService.onKline(closePx) |
|---|
| | | │ ├─ state=WAITING_KLINE → 异步双开 + 止盈单 |
|---|
| | | │ └─ 后续 → 仅缓存 lastKlinePrice |
|---|
| | | │ |
|---|
| | | ├─ futures.positions (update) [私有，HMAC-SHA512] |
|---|
| | | │ └─ PositionsChannelHandler.handleMessage() |
|---|
| | | │ ├─ 解析: contract/mode/size/entry_price |
|---|
| | | │ └─ GateGridTradeService.onPositionUpdate(...) |
|---|
| | | │ ├─ size=0 && longActive → reopenLongPosition() |
|---|
| | | │ ├─ size=0 && shortActive → reopenShortPosition() |
|---|
| | | │ └─ size>0 → 确认仓位活跃 |
|---|
| | | ├─ futures.positions (私有, HMAC-SHA512) |
|---|
| | | │ └─ PositionsChannelHandler |
|---|
| | | │ └─ gridTradeService.onPositionUpdate(mode, size, entryPrice) |
|---|
| | | │ ├─ size=0 && longActive → tryReopenLong() |
|---|
| | | │ └─ size=0 && shortActive → tryReopenShort() |
|---|
| | | │ |
|---|
| | | ├─ futures.position_closes (update) [私有，HMAC-SHA512] |
|---|
| | | │ └─ PositionClosesChannelHandler.handleMessage() |
|---|
| | | │ ├─ 解析: contract/side/pnl |
|---|
| | | │ └─ GateGridTradeService.onPositionClose(pnl) |
|---|
| | | ├─ futures.position_closes (私有, HMAC-SHA512) |
|---|
| | | │ └─ PositionClosesChannelHandler |
|---|
| | | │ └─ gridTradeService.onPositionClose(side, pnl) |
|---|
| | | │ └─ cumulativePnl += pnl → checkStopConditions() |
|---|
| | | │ |
|---|
| | | ├─ futures.pong |
|---|
| | | │ └─ cancelPongTimeout() |
|---|
| | | │ |
|---|
| | | └─ subscribe/unsubscribe/error |
|---|
| | | └─ 日志输出 |
|---|
| | | └─ 所有下单操作 |
|---|
| | | └─ GateTradeExecutor (单线程 + 64队列 + CallerRunsPolicy) |
|---|
| | | ├─ openLong/openShort → 市价单 (REST) |
|---|
| | | └─ placeTakeProfit → 条件单 (REST) |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | | ## 策略时序 |
|---|
| | | |
|---|
| | | ### 阶段 1：启动与初始化 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | Spring 启动 |
|---|
| | | → GateWebSocketClientManager.init() |
|---|
| | | → GateGridTradeService.init() |
|---|
| | | → REST: 查用户ID |
|---|
| | | → REST: 查账户 → 如需要切换持仓模式 (dual) |
|---|
| | | → REST: 清除旧止盈止损条件单 |
|---|
| | | → REST: 设杠杆 30x cross |
|---|
| | | → REST: 打印账户余额 |
|---|
| | | → GateKlineWebSocketClient |
|---|
| | | → addChannelHandler: Candlestick + Positions + PositionCloses |
|---|
| | | → init() → connect() |
|---|
| | | → onOpen: 遍历 handlers.subscribe() + sendPing() |
|---|
| | | → GateGridTradeService.startGrid() |
|---|
| | | → strategyActive = true |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | ### 阶段 2：首次开仓 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | K 线推送 closePrice=4711 |
|---|
| | | → onKline(4711) |
|---|
| | | → dualOpened = true |
|---|
| | | → dualOpenPositions() |
|---|
| | | → REST: 市价开多 10 张 → longEntryPrice=4711 |
|---|
| | | → REST: 创建多头止盈单 TP=4711×1.0035=4727 (close-long-position) |
|---|
| | | → REST: 市价开空 10 张 → shortEntryPrice=4711 |
|---|
| | | → REST: 创建空头止盈单 TP=4711×0.9965=4694 (close-short-position) |
|---|
| | | → longActive=true, shortActive=true |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | ### 阶段 3：止盈触发 → 补仓 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | 仓位推送: mode=dual_long, size=0 (多头被服务器止盈平掉了) |
|---|
| | | → longActive=true && size=0 |
|---|
| | | → reopenLongPosition() |
|---|
| | | → REST: 市价补开多 10 张 |
|---|
| | | → REST: 创建新的多头止盈单 |
|---|
| | | |
|---|
| | | 仓位推送: mode=dual_short, size=0 (空头被服务器止盈平掉了) |
|---|
| | | → shortActive=true && size=0 |
|---|
| | | → reopenShortPosition() |
|---|
| | | → REST: 市价补开空 10 张 |
|---|
| | | → REST: 创建新的空头止盈单 |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | > 注意：只补被平掉的方向（另一方向不受影响），不双方向重新开。补仓时检查 `longActive` / `shortActive` 防重复开仓。 |
|---|
| | | |
|---|
| | | ### 阶段 4：停止条件 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | 平仓推送: pnl=+0.2 |
|---|
| | | → cumulativePnl = 0.2, 未达阈值，继续 |
|---|
| | | |
|---|
| | | 平仓推送: pnl=+0.4 |
|---|
| | | → cumulativePnl = 0.6 ≥ 0.5 → strategyActive=false |
|---|
| | | |
|---|
| | | 平仓推送: pnl=-8 |
|---|
| | | → cumulativePnl = -8 ≤ -7.5 → strategyActive=false |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | | ## GateWebSocketClientManager |
|---|
| | | |
|---|
| | | **角色**: Spring Bean 入口，组装并管理所有 Gate 模块组件。 |
|---|
| | | |
|---|
| | | **关键方法**: |
|---|
| | | - `init()`: 创建 `GateGridTradeService` → 初始化 → 创建 `GateKlineWebSocketClient` + 注册 3 个 Handler → 启动策略 |
|---|
| | | - `destroy()`: 停止策略 → 关闭 WebSocket |
|---|
| | | |
|---|
| | | **当前参数**（硬编码在 `init()` 中）: |
|---|
| | | |
|---|
| | | | 参数 | 值 | 说明 | |
|---|
| | | |------|-----|------| |
|---|
| | | | 合约 | XAUT_USDT | 黄金（测试网） | |
|---|
| | | | 杠杆 | 30x | 全仓模式 | |
|---|
| | | | 持仓模式 | dual | 双向持仓 | |
|---|
| | | | 网格间距 | 0.0035 | 0.35% | |
|---|
| | | | 整体止盈 | 0.5 USDT | | |
|---|
| | | | 最大亏损 | 7.5 USDT | 本金 50×15% | |
|---|
| | | | 下单量 | 10 张 | | |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | | ## GateKlineWebSocketClient |
|---|
| | | |
|---|
| | | **角色**: WebSocket 连接管理器。负责建立连接、心跳检测、指数退避重连。频道逻辑委托给 `GateChannelHandler` 实现类。 |
|---|
| | | |
|---|
| | | **Handler 路由**: |
|---|
| | | |
|---|
| | | | 频道 | Handler | 认证 | 回调 | |
|---|
| | | |------|---------|------|------| |
|---|
| | | | `futures.candlesticks` | `CandlestickChannelHandler` | 否 | `onKline(closePx)` | |
|---|
| | | | `futures.positions` | `PositionsChannelHandler` | HMAC-SHA512 | `onPositionUpdate(mode, size, entryPrice)` | |
|---|
| | | | `futures.position_closes` | `PositionClosesChannelHandler` | HMAC-SHA512 | `onPositionClose(side, pnl)` | |
|---|
| | | |
|---|
| | | **消息路由** (`handleMessage`): |
|---|
| | | |
|---|
| | | | channel | event | 处理 | |
|---|
| | | |---------|-------|------| |
|---|
| | | | `futures.pong` | — | `cancelPongTimeout()` | |
|---|
| | | | — | `subscribe` | 打日志 | |
|---|
| | | | — | `unsubscribe` | 打日志 | |
|---|
| | | | — | `error` | 打错误日志 | |
|---|
| | | | 任意 | `update`/`all` | 遍历 channelHandlers → `handler.handleMessage()` | |
|---|
| | | |
|---|
| | | **签名算法**: |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | message = "channel={channel}&event=subscribe&time={秒级时间戳}" |
|---|
| | | SIGN = Hex(HmacSHA512(apiSecret.getBytes(UTF-8), message.getBytes(UTF-8))) |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | **连接管理**: |
|---|
| | | - 心跳: 10 秒超时，每 25 秒检查，超时发 ping |
|---|
| | | - 重连: 指数退避，最多 3 次，初始 5 秒 |
|---|
| | | - 关闭: 遍历 `handler.unsubscribe()` → 等 500ms → `closeBlocking()` → `sharedExecutor.shutdown()` |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | GateChannelHandler (接口) |
|---|
| | | ├── CandlestickChannelHandler (公开频道) |
|---|
| | | └── AbstractPrivateChannelHandler (抽象类) (私有频道基类) |
|---|
| | | ├── CandlestickChannelHandler (公开频道) |
|---|
| | | └── AbstractPrivateChannelHandler (私有频道基类: HMAC-SHA512) |
|---|
| | | ├── PositionsChannelHandler |
|---|
| | | └── PositionClosesChannelHandler |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | - **subscribe**: 发送订阅请求。私有Handler自动附加 auth 字段 |
|---|
| | | - **unsubscribe**: 发送取消订阅请求（私有频道也带签名认证） |
|---|
| | | - **handleMessage**: 解析推送数据并回调GateGridTradeService，返回true表示已处理 |
|---|
| | | - 消息路由: update/all事件 → 遍历channelHandlers → handler内部二次匹配channel名 → 匹配成功回调并停止遍历 |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | | ## 策略状态机 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | WAITING_KLINE ──onKline──→ OPENING ──双开成功──→ ACTIVE |
|---|
| | | │ │ │ |
|---|
| | | │ 双开失败 ├─ size=0 → REOPENING_L/S → ACTIVE |
|---|
| | | │ ├─ 补仓失败 retry → 仍失败 → STOPPED |
|---|
| | | │ └─ cumulativePnl≥TP 或 ≤-maxLoss → STOPPED |
|---|
| | | ▼ |
|---|
| | | STOPPED ←─────────────────────────────────────────┘ |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | | 状态 | 含义 | |
|---|
| | | |------|------| |
|---|
| | | | `WAITING_KLINE` | 等待首次K线价格 | |
|---|
| | | | `OPENING` | 正在异步双开（开多+开空已提交到GateTradeExecutor） | |
|---|
| | | | `ACTIVE` | 网格运行中，等待止盈触发 | |
|---|
| | | | `REOPENING_LONG` | 正在补开多头 | |
|---|
| | | | `REOPENING_SHORT` | 正在补开空头 | |
|---|
| | | | `STOPPED` | 停止（盈利达标 / 亏损超限 / 异常退出） | |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | | ## 策略时序 |
|---|
| | | |
|---|
| | | ### 阶段 1：启动 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | Spring @PostConstruct |
|---|
| | | → GateConfig.builder()...build() |
|---|
| | | → GateGridTradeService(config) |
|---|
| | | → init(): 查ID → 查账户切持仓 → 清旧条件单 → 设杠杆 |
|---|
| | | → GateKlineWebSocketClient(config.getWsUrl()) |
|---|
| | | → addChannelHandler x3 → init() → connect() |
|---|
| | | → onOpen: handlers依次subscribe → sendPing |
|---|
| | | → gridTradeService.startGrid() → state=WAITING_KLINE |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | ### 阶段 2：首次开仓 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | K线推送 → onKline(closePrice) → state=OPENING |
|---|
| | | → GateTradeExecutor.openLong → 市价开多 → onSuccess: longActive=true, 下TP单 |
|---|
| | | → GateTradeExecutor.openShort → 市价开空 → onSuccess: shortActive=true, 下TP单 |
|---|
| | | → 双开均完成 → state=ACTIVE |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | ### 阶段 3：止盈触发 → 补仓 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | 仓位推送: dual_long, size=0 → longActive且无仓位 → tryReopenLong |
|---|
| | | → GateTradeExecutor.openLong → 市价补多 → onSuccess: 下新TP单 |
|---|
| | | |
|---|
| | | 仓位推送: dual_short, size=0 → shortActive且无仓位 → tryReopenShort |
|---|
| | | → GateTradeExecutor.openShort → 市价补空 → onSuccess: 下新TP单 |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | > 止盈由 Gate 服务端条件单自动执行。只补被平掉的单方向，另一方不受影响。 |
|---|
| | | |
|---|
| | | ### 阶段 4：停止 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | 平仓推送: pnl=+0.6 → cumulativePnl=0.6 ≥ overallTp → state=STOPPED |
|---|
| | | 平仓推送: pnl=-8.0 → cumulativePnl=-8.0 ≤ -maxLoss → state=STOPPED |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | | ## GateConfig |
|---|
| | | |
|---|
| | | **角色**: 统一配置中心。Builder模式管理所有参数，提供 REST/WS URL 环境自动切换。 |
|---|
| | | |
|---|
| | | **核心方法**: |
|---|
| | | - `getRestBasePath()`: isProduction ? 生产网 : 测试网 |
|---|
| | | - `getWsUrl()`: 同上 |
|---|
| | | |
|---|
| | | **配置项**（含默认值）: |
|---|
| | | |
|---|
| | | | 参数 | 默认值 | 说明 | |
|---|
| | | |------|--------|------| |
|---|
| | | | contract | BTC_USDT | 合约 | |
|---|
| | | | leverage | 10 | 倍数 | |
|---|
| | | | marginMode | cross | 全仓 | |
|---|
| | | | positionMode | dual | 双向持仓 | |
|---|
| | | | gridRate | 0.0035 | 网格间距 0.35% | |
|---|
| | | | overallTp | 0.5 USDT | 整体止盈 | |
|---|
| | | | maxLoss | 7.5 USDT | 最大亏损 | |
|---|
| | | | quantity | 1 | 下单张数 | |
|---|
| | | | reopenMaxRetries | 3 | 补仓重试次数 | |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | | ## GateTradeExecutor |
|---|
| | | |
|---|
| | | **角色**: 独立线程池执行 REST API 下单，解决 WebSocket 回调线程阻塞问题。 |
|---|
| | | |
|---|
| | | **线程模型**: |
|---|
| | | - `ThreadPoolExecutor(1, 1, 60s, LinkedBlockingQueue(64), CallerRunsPolicy)` |
|---|
| | | - 单线程保序 + 有界队列防堆积 + CallerRuns背压 |
|---|
| | | |
|---|
| | | | 方法 | 说明 | |
|---|
| | | |------|------| |
|---|
| | | | `getChannelName()` | 返回频道名（如 `"futures.candlesticks"`） | |
|---|
| | | | `subscribe(ws)` | 发送订阅请求。私有频道自动附加 HMAC-SHA512 签名 | |
|---|
| | | | `unsubscribe(ws)` | 发送取消订阅请求 | |
|---|
| | | | `handleMessage(response)` | 解析推送数据并回调 `GateGridTradeService`，返回 `true` 表示已处理 | |
|---|
| | | | `openLong(qty, onSuccess)` | 异步 IOC 市价开多，成功回调 | |
|---|
| | | | `openShort(qty, onSuccess)` | 异步 IOC 市价开空 | |
|---|
| | | | `placeTakeProfit(trigger, rule, type, auto)` | 异步条件单。已存在则清除旧单重试 | |
|---|
| | | | `cancelAllPriceTriggeredOrders()` | 清除所有条件单 | |
|---|
| | | | `shutdown()` | 等待10秒，超时强制关闭 | |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | | ## GateGridTradeService |
|---|
| | | |
|---|
| | | **角色**: 使用 Gate SDK (`io.gate:gate-api:7.2.71`) 通过 REST API 执行合约下单。 |
|---|
| | | **角色**: 策略核心，使用 Gate SDK 管理状态和执行下单。 |
|---|
| | | |
|---|
| | | **状态机**: |
|---|
| | | **状态**: StrategyState enum + longActive/shortActive boolean |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | strategyActive=false ──startGrid()──→ strategyActive=true (等待K线) |
|---|
| | | │ |
|---|
| | | onKline(price) |
|---|
| | | │ |
|---|
| | | dualOpened=true |
|---|
| | | dualOpenPositions() |
|---|
| | | │ |
|---|
| | | ┌───────────┴───────────┐ |
|---|
| | | ▼ ▼ |
|---|
| | | longActive=true shortActive=true |
|---|
| | | │ │ |
|---|
| | | 仓位推送 size=0 仓位推送 size=0 |
|---|
| | | (止盈触发平仓) (止盈触发平仓) |
|---|
| | | │ │ |
|---|
| | | ▼ ▼ |
|---|
| | | reopenLong() reopenShort() |
|---|
| | | │ │ |
|---|
| | | └───────────┬───────────┘ |
|---|
| | | │ |
|---|
| | | 平仓推送 pnl (futures.position_closes) |
|---|
| | | │ |
|---|
| | | checkStopConditions() |
|---|
| | | │ |
|---|
| | | ┌───────────┴───────────┐ |
|---|
| | | ▼ ▼ |
|---|
| | | cumulativePnl≥0.5 cumulativePnl≤-7.5 |
|---|
| | | strategyActive=false strategyActive=false |
|---|
| | | ``` |
|---|
| | | **回调方法**: |
|---|
| | | - `onKline(closePrice)`: 缓存价格，WAITING_KLINE状态下首次触发双开 |
|---|
| | | - `onPositionUpdate(mode, size, entryPrice)`: size=0且方向活跃 → 补仓 |
|---|
| | | - `onPositionClose(side, pnl)`: 累加盈亏，检查停止条件 |
|---|
| | | |
|---|
| | | **止盈计算**: |
|---|
| | | |
|---|
| | | | 方向 | 公式 | 触发条件 | order_type | auto_size | |
|---|
| | | |------|------|----------|------------|-----------| |
|---|
| | | | 多头 TP | entryPrice × (1 + gridRate) | 最新价 ≥ 触发价 | `close-long-position` | `close_long` | |
|---|
| | | | 空头 TP | entryPrice × (1 - gridRate) | 最新价 ≤ 触发价 | `close-short-position` | `close_short` | |
|---|
| | | | 方向 | 公式 | order_type | auto_size | |
|---|
| | | |------|------|------------|-----------| |
|---|
| | | | 多头 TP | entry × (1+gridRate) | `close-long-position` | `close_long` | |
|---|
| | | | 空头 TP | entry × (1-gridRate) | `close-short-position` | `close_short` | |
|---|
| | | |
|---|
| | | **REST API 调用**: |
|---|
| | | |
|---|
| | | | 操作 | API | 方法 | |
|---|
| | | |------|-----|------| |
|---|
| | | | 获取用户 ID | `GET /account/detail` | `AccountApi.getAccountDetail()` | |
|---|
| | | | 切持仓模式 | `POST /futures/{settle}/set_position_mode` | `FuturesApi.setPositionMode()` | |
|---|
| | | | 设杠杆 | `POST /futures/{settle}/positions/{contract}/leverage` | `FuturesApi.updateContractPositionLeverageCall()` | |
|---|
| | | | 查账户 | `GET /futures/{settle}/accounts` | `FuturesApi.listFuturesAccounts()` | |
|---|
| | | | 清除条件单 | `DELETE /futures/{settle}/price_orders` | `FuturesApi.cancelPriceTriggeredOrderList()` | |
|---|
| | | | 市价下单 | `POST /futures/{settle}/orders` (price=0, tif=IOC) | `FuturesApi.createFuturesOrder()` | |
|---|
| | | | 止盈条件单 | `POST /futures/{settle}/price_orders` | `FuturesApi.createPriceTriggeredOrder()` | |
|---|
| | | |
|---|
| | | **初始化顺序** (`init()`): |
|---|
| | | ``` |
|---|
| | | 1. 获取用户 ID |
|---|
| | | 2. 查账户 → 如需要切持仓模式 |
|---|
| | | 3. 清除旧的止盈止损条件单 |
|---|
| | | 4. 设杠杆 |
|---|
| | | 5. 打印账户余额 |
|---|
| | | ``` |
|---|
| | | | 获取用户ID | `GET /account/detail` | `AccountApi.getAccountDetail()` | |
|---|
| | | | 切持仓模式 | `POST /futures/usdt/set_position_mode` | `FuturesApi.setPositionMode()` | |
|---|
| | | | 设杠杆 | `POST /futures/usdt/positions/{contract}/leverage` | `FuturesApi.updateContractPositionLeverageCall()` | |
|---|
| | | | 查账户 | `GET /futures/usdt/accounts` | `FuturesApi.listFuturesAccounts()` | |
|---|
| | | | 清除条件单 | `DELETE /futures/usdt/price_orders` | `FuturesApi.cancelPriceTriggeredOrderList()` | |
|---|
| | | | 市价单 | `POST /futures/usdt/orders` (price=0, IOC) | `FuturesApi.createFuturesOrder()` | |
|---|
| | | | 条件单 | `POST /futures/usdt/price_orders` | `FuturesApi.createPriceTriggeredOrder()` | |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | | ## GateWebSocketClientMain |
|---|
| | | |
|---|
| | | **角色**: 独立的 `main()` 方法入口，通过 Spring XML 上下文启动。 |
|---|
| | | 独立 `main()` 方法入口，通过 Spring XML 上下文启动，运行后手动关闭。 |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | | ## Example.java |
|---|
| | | |
|---|
| | | Gate SDK 使用示例，展示 `FuturesApi` 的基本用法。仅作参考，不参与实际策略运行。 |
|---|
| | | Gate SDK 使用示例，展示 `FuturesApi` 的基本用法。仅作参考。 |
|---|
