| | |
|---|
| | | | [GateWebSocketClientManager](#gatewebsocketclientmanager) | `@Component` | Spring 启动入口，组装组件 + 生命周期 | |
|---|
| | | | [GateConfig](#gateconfig) | 配置 | Builder 模式：API 密钥、合约、策略参数、环境切换 | |
|---|
| | | | [GateKlineWebSocketClient](#gateklinewebsocketclient) | WS 连接管理 | 连接/心跳/重连/消息路由 | |
|---|
| | | | [GateGridTradeService](#gategridtradeservice) | 交易服务 | 网格策略状态机 + 盈亏管理 + 补仓重试 | |
|---|
| | | | [GateGridTradeService](#gategridtradeservice) | 交易服务 | 网格队列策略 + 保证金安全阀 + 盈亏管理 | |
|---|
| | | | [GateTradeExecutor](#gatetradeexecutor) | 异步执行器 | 独立线程池执行 REST 下单，成功/失败双回调 | |
|---|
| | | | [GateWebSocketClientMain](#gatewebsocketclientmain) | main 入口 | 独立测试启动 | |
|---|
| | | | [Example.java](#examplejava) | 示例 | Gate SDK 用法参考 | |
|---|
| | |
|---|
| | | ├─ futures.candlesticks (公开) |
|---|
| | | │ └─ CandlestickChannelHandler |
|---|
| | | │ └─ gridTradeService.onKline(closePx) |
|---|
| | | │ ├─ state=WAITING_KLINE → 异步双开 + 止盈单 |
|---|
| | | │ └─ 后续 → 仅缓存 lastKlinePrice |
|---|
| | | │ ├─ 更新 unrealizedPnl（浮动盈亏） |
|---|
| | | │ ├─ state=WAITING_KLINE → 异步双开基底仓位 |
|---|
| | | │ └─ state=ACTIVE → processShortGrid/processLongGrid 网格触发 |
|---|
| | | │ |
|---|
| | | ├─ futures.positions (私有, HMAC-SHA512) |
|---|
| | | │ └─ PositionsChannelHandler |
|---|
| | | │ ├─ 解析 mode → Position.ModeEnum（DUAL_LONG / DUAL_SHORT） |
|---|
| | | │ └─ gridTradeService.onPositionUpdate(mode, size, entryPrice) |
|---|
| | | │ ├─ DUAL_LONG, size=0 && longActive → tryReopenLong() |
|---|
| | | │ └─ DUAL_SHORT, size=0 && shortActive → tryReopenShort() |
|---|
| | | │ └─ gridTradeService.onPositionUpdate(contract, mode, size, entryPrice) |
|---|
| | | │ ├─ 有仓位: 标记活跃，首次成交记录入场价并设止盈 |
|---|
| | | │ │ ├─ 基底开仓 → 首次成交 → 记录基底入场价 → 双基底都成交后生成网格队列 |
|---|
| | | │ │ └─ 网格开仓 → 成交后立即设止盈单 |
|---|
| | | │ └─ 无仓位(size=0): 标记不活跃 |
|---|
| | | │ |
|---|
| | | ├─ futures.position_closes (私有, HMAC-SHA512) |
|---|
| | | │ └─ PositionClosesChannelHandler |
|---|
| | | │ └─ gridTradeService.onPositionClose(side, pnl) |
|---|
| | | │ └─ gridTradeService.onPositionClose(contract, side, pnl) |
|---|
| | | │ └─ cumulativePnl += pnl → checkStopConditions() |
|---|
| | | │ |
|---|
| | | └─ 所有下单操作 |
|---|
| | | └─ GateTradeExecutor (单线程 + 64队列 + CallerRunsPolicy) |
|---|
| | | ├─ openLong/Short(qty, onSuccess, onFailure) |
|---|
| | | │ └─ 失败回调 → tryReopenXxx() 递归重试 |
|---|
| | | └─ placeTakeProfit → 条件单 (REST) |
|---|
| | | ``` |
|---|
| | | |
|---|
| | |
|---|
| | | - **unsubscribe**: 发送取消订阅请求（私有频道也带签名认证） |
|---|
| | | - **handleMessage**: 解析推送数据并回调GateGridTradeService，返回true表示已处理 |
|---|
| | | - 消息路由: update/all事件 → 遍历channelHandlers → handler内部二次匹配channel名 → 匹配成功回调并停止遍历 |
|---|
| | | - **PositionsChannelHandler 特殊处理**: 推送的 mode 字符串（"dual_long"）通过 `Position.ModeEnum.fromValue()` 转为枚举，避免调用方用字符串匹配 |
|---|
| | | - **PositionsChannelHandler 特殊处理**: 推送的 mode 字符串（"dual_long"）通过 `Position.ModeEnum.fromValue()` 转为枚举 |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | | ## 策略状态机 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | WAITING_KLINE ──onKline──→ OPENING ──双开成功──→ ACTIVE |
|---|
| | | │ │ │ |
|---|
| | | │ 双开失败 ├─ size=0 → REOPENING_L/S |
|---|
| | | │ │ ├─ 补仓成功 → ACTIVE |
|---|
| | | │ │ └─ 补仓失败 → 递归重试 |
|---|
| | | │ │ └─ 超 reopenMaxRetries → STOPPED |
|---|
| | | │ └─ cumPnl≥TP 或 ≤-maxLoss → STOPPED |
|---|
| | | ▼ |
|---|
| | | STOPPED ←─────────────────────────────────────────┘ |
|---|
| | | WAITING_KLINE ──onKline──→ OPENING ──双基底都成交──→ ACTIVE |
|---|
| | | │ │ │ |
|---|
| | | │ 下单异常 ├─ 每根K线: 更新 unrealizedPnl |
|---|
| | | │ │ ├─ cumPnl ≥ overallTp → STOPPED |
|---|
| | | │ │ ├─ cumPnl ≤ -maxLoss → STOPPED |
|---|
| | | │ │ ├─ 保证金超限 → 跳过开仓，队列照常更新 |
|---|
| | | │ │ └─ 网格触发 → 开仓+设止盈+队列转移 |
|---|
| | | ▼ ▼ |
|---|
| | | STOPPED ←──────────────────┘ |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | | 状态 | 含义 | |
|---|
| | | |------|------| |
|---|
| | | | `WAITING_KLINE` | 等待首次K线价格 | |
|---|
| | | | `OPENING` | 正在异步双开（开多+开空已提交到GateTradeExecutor） | |
|---|
| | | | `ACTIVE` | 网格运行中，等待止盈触发 | |
|---|
| | | | `REOPENING_LONG` | 正在补开多头 | |
|---|
| | | | `REOPENING_SHORT` | 正在补开空头 | |
|---|
| | | | `STOPPED` | 停止（盈利达标 / 亏损超限 / 补仓重试耗尽 / 异常退出） | |
|---|
| | | | `OPENING` | 正在异步开基底多空仓位（已提交到GateTradeExecutor） | |
|---|
| | | | `ACTIVE` | 网格队列激活，K线触发网格元素 → 开仓+止盈 | |
|---|
| | | | `STOPPED` | 停止（盈利达标 / 亏损超限） | |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | | ## 策略核心：网格队列机制 |
|---|
| | | |
|---|
| | | ### 概述 |
|---|
| | | |
|---|
| | | 策略采用"基底 + 价格网格队列"模式：先开一对基底多空仓位，然后以基底入场价为基准生成价格队列。每当K线穿破队列元素，就开新仓位并设止盈条件单，同时将穿破的元素转移到反方向队列。 |
|---|
| | | |
|---|
| | | ### 基底开仓 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | K线到达 → 双开基底（市价开多 + 市价开空） |
|---|
| | | → 成交回调: baseLongOpened=true, longActive=true |
|---|
| | | → 成交回调: baseShortOpened=true, shortActive=true |
|---|
| | | → 两者都成交 → generateShortQueue() + generateLongQueue() → state=ACTIVE |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | ### 网格队列生成 |
|---|
| | | |
|---|
| | | 以基底入场价为基准，按 `gridRate` 步长生成 N 个价格（N = gridQueueSize，默认50）： |
|---|
| | | |
|---|
| | | | 队列 | 计算方式 | 排序 | |
|---|
| | | |------|---------|------| |
|---|
| | | | 空仓队列 shortPriceQueue | 基底空入场价 - gridRate × i (i=1..N) | 降序（大→小） | |
|---|
| | | | 多仓队列 longPriceQueue | 基底多入场价 + gridRate × i (i=1..N) | 升序（小→大） | |
|---|
| | | |
|---|
| | | ### K线触发网格 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | K线到达(ACTIVE状态): |
|---|
| | | │ |
|---|
| | | ├─ processShortGrid: 当前价 < 空仓队列元素（价格跌破了队列中的高价） |
|---|
| | | │ ├─ 匹配: 收集所有 > 当前价的空仓队列元素 |
|---|
| | | │ ├─ 保证金检查: positionInitialMargin / initialPrincipal < marginRatioLimit(20%) |
|---|
| | | │ │ ├─ 安全 → openShort 开空单（成交后仓位推送会自动设止盈） |
|---|
| | | │ │ └─ 超限 → 跳过开仓，队列照常更新 |
|---|
| | | │ ├─ 空仓队列: 移除匹配元素，尾部补充新价格（按步长递减） |
|---|
| | | │ └─ 多仓队列: 接收匹配元素，升序排列，截断到 gridQueueSize |
|---|
| | | │ |
|---|
| | | └─ processLongGrid: 当前价 > 多仓队列元素（价格涨超了队列中的低价） |
|---|
| | | ├─ 匹配: 收集所有 < 当前价的多仓队列元素 |
|---|
| | | ├─ 保证金检查: 同上 |
|---|
| | | │ ├─ 安全 → openLong 开多单 |
|---|
| | | │ └─ 超限 → 跳过开仓 |
|---|
| | | ├─ 多仓队列: 移除匹配元素，尾部补充新价格（按步长递增） |
|---|
| | | └─ 空仓队列: 接收匹配元素，降序排列，截断到 gridQueueSize |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | ### 队列转移示意 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | 初始状态: |
|---|
| | | 空仓队列: [100, 99, 98, 97] (降序) |
|---|
| | | 多仓队列: [102, 103, 104, 105] (升序) |
|---|
| | | |
|---|
| | | 价格跌到 98.5 → processShortGrid 触发: |
|---|
| | | 匹配: [100, 99]（都 > 98.5） |
|---|
| | | |
|---|
| | | 空仓队列: 移除[100,99] → [98,97] → 补充[96,95] → [98,97,96,95] |
|---|
| | | 多仓队列: 接收[100,99] → [100,99,102,103,104,105] → 截断到4 → [102,103,104,105] |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | |
|---|
| | | → GateConfig.builder()...build() |
|---|
| | | → GateGridTradeService(config) |
|---|
| | | → init(): |
|---|
| | | 1. 查用户ID |
|---|
| | | 2. 查账户 → 如需要切持仓模式 |
|---|
| | | 1. 查用户ID（用于私有频道订阅） |
|---|
| | | 2. 查账户 → 记录初始本金 initialPrincipal → 如需要切持仓模式 |
|---|
| | | 3. 清除旧止盈止损条件单 |
|---|
| | | 4. 查当前合约所有仓位 → 逐个市价平仓（reduce_only, IOC） |
|---|
| | | - 单向持仓: size=相反数平仓 |
|---|
| | |
|---|
| | | → gridTradeService.startGrid() → state=WAITING_KLINE |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | ### 阶段 2：首次开仓 |
|---|
| | | ### 阶段 2：首次开仓 → 生成网格队列 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | K线推送 → onKline(closePrice) → state=OPENING |
|---|
| | | → GateTradeExecutor.openLong(qty, onSuccess, null) |
|---|
| | | → 市价开多 → onSuccess: longActive=true, placeTakeProfit(多头TP) |
|---|
| | | → GateTradeExecutor.openShort(-qty, onSuccess, null) |
|---|
| | | → 市价开空 → onSuccess: shortActive=true, placeTakeProfit(空头TP) |
|---|
| | | → 双开均完成 → state=ACTIVE |
|---|
| | | → executor.openLong(qty, onSuccess, onFailure) |
|---|
| | | → 成交 → 仓位推送: DUAL_LONG, size>0, entryPrice=X |
|---|
| | | → baseLongOpened=true, longBaseEntryPrice=X |
|---|
| | | → tryGenerateQueues(): 双基底都成交? → 生成队列 → state=ACTIVE |
|---|
| | | → executor.openShort(-qty, onSuccess, onFailure) |
|---|
| | | → 成交 → 仓位推送: DUAL_SHORT, size<0, entryPrice=Y |
|---|
| | | → baseShortOpened=true, shortBaseEntryPrice=Y |
|---|
| | | → tryGenerateQueues(): 双基底都成交? → 生成队列 → state=ACTIVE |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | ### 阶段 3：止盈触发 → 补仓（含重试） |
|---|
| | | ### 阶段 3：ACTIVE 状态 — K线驱动网格 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | 仓位推送: mode=DUAL_LONG, size=0 → longActive且无仓位 → tryReopenLong() |
|---|
| | | ┌─ longReopenFails++ → 超 reopenMaxRetries → STOPPED |
|---|
| | | └─ GateTradeExecutor.openLong(qty, |
|---|
| | | onSuccess: failCount=0, ACTIVE, 下新TP单, |
|---|
| | | onFailure: → 递归调用 tryReopenLong() 再试 |
|---|
| | | ) |
|---|
| | | 每根K线 → onKline → updateUnrealizedPnl → processShortGrid + processLongGrid |
|---|
| | | |
|---|
| | | 仓位推送: mode=DUAL_SHORT, size=0 → 同理 tryReopenShort() |
|---|
| | | 仓位推送（每次开仓成交后自动触发）: |
|---|
| | | → DUAL_LONG, size>0, 非基底 → 设多头止盈单 entryPrice × (1+gridRate) |
|---|
| | | → DUAL_SHORT, size<0, 非基底 → 设空头止盈单 entryPrice × (1-gridRate) |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | > 止盈由 Gate 服务端条件单自动执行。只补被平掉的单方向，另一方不受影响。 |
|---|
| | | > 补仓失败通过 onFailure 回调递归重试，连续失败超过 `reopenMaxRetries`（默认3次）则停止策略。 |
|---|
| | | > 止盈由 Gate 服务端条件单自动执行。服务端监控价格，达到触发价后自动平仓。 |
|---|
| | | > 平仓后仓位变为0，盈亏通过 position_closes 频道推送到 cumulativePnl。 |
|---|
| | | |
|---|
| | | ### 阶段 4：停止 |
|---|
| | | |
|---|
| | | ``` |
|---|
| | | 平仓推送: pnl=+0.6 → cumulativePnl=0.6 ≥ overallTp → state=STOPPED |
|---|
| | | 平仓推送: pnl=-8.0 → cumulativePnl=-8.0 ≤ -maxLoss → state=STOPPED |
|---|
| | | 补仓连续失败 4 次 → 超过 reopenMaxRetries=3 → state=STOPPED |
|---|
| | | 平仓推送: pnl=+0.6 → cumulativePnl=0.6 ≥ overallTp(0.5) → state=STOPPED |
|---|
| | | 平仓推送: pnl=-8.0 → cumulativePnl=-8.0 ≤ -maxLoss(7.5) → state=STOPPED |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | --- |
|---|
| | |
|---|
| | | | overallTp | 0.5 USDT | 整体止盈 | |
|---|
| | | | maxLoss | 7.5 USDT | 最大亏损 | |
|---|
| | | | quantity | 1 | 下单张数 | |
|---|
| | | | reopenMaxRetries | 3 | 补仓最大重试次数 | |
|---|
| | | | reopenMaxRetries | 3 | 补仓最大重试次数（当前版本未使用） | |
|---|
| | | | gridQueueSize | 50 | 网格价格队列容量 | |
|---|
| | | | marginRatioLimit | 0.2 | 保证金占初始本金比例上限（20%），超限跳过开仓 | |
|---|
| | | | contractMultiplier | 0.001 | 合约乘数（单张合约代表的基础资产数量） | |
|---|
| | | | unrealizedPnlPriceMode | LAST_PRICE | 未实现盈亏计价模式：LAST_PRICE / MARK_PRICE | |
|---|
| | | |
|---|
| | | --- |
|---|
| | | |
|---|
| | | ## GateTradeExecutor |
|---|
| | | |
|---|
| | | **角色**: 独立线程池执行 REST API 下单。采用成功/失败双回调模式支持补仓重试。 |
|---|
| | | **角色**: 独立线程池执行 REST API 下单。采用成功/失败双回调模式。 |
|---|
| | | |
|---|
| | | **线程模型**: |
|---|
| | | - `ThreadPoolExecutor(1, 1, 60s, LinkedBlockingQueue(64), CallerRunsPolicy)` |
|---|
| | | - 单线程保序 + 有界队列防堆积 + CallerRuns背压 |
|---|
| | | - allowCoreThreadTimeOut: 60s 空闲后线程回收 |
|---|
| | | |
|---|
| | | **回调设计**: |
|---|
| | | - 每个下单方法接受 `onSuccess` 和 `onFailure` 两个 `Runnable` |
|---|
| | | - REST 调用成功 → 执行 `onSuccess`（更新状态、下止盈单、重置失败计数） |
|---|
| | | - REST 调用失败 → 执行 `onFailure`（递归重试入口） |
|---|
| | | - REST 调用成功 → 执行 `onSuccess`（标记基底已开等） |
|---|
| | | - REST 调用失败 → 执行 `onFailure`（当前版本多为 null，依赖 position 推送修正） |
|---|
| | | |
|---|
| | | | 方法 | 说明 | |
|---|
| | | |------|------| |
|---|
| | |
|---|
| | | |
|---|
| | | ## GateGridTradeService |
|---|
| | | |
|---|
| | | **角色**: 策略核心，使用 Gate SDK 管理状态和执行下单。 |
|---|
| | | **角色**: 策略核心，管理网格队列状态和执行下单。 |
|---|
| | | |
|---|
| | | **状态**: `StrategyState` enum + `longActive`/`shortActive` boolean |
|---|
| | | **状态**: `StrategyState` enum: `WAITING_KLINE` / `OPENING` / `ACTIVE` / `STOPPED` |
|---|
| | | |
|---|
| | | **关键常量**（替代字面字符串）: |
|---|
| | | **关键常量**: |
|---|
| | | ```java |
|---|
| | | private static final String AUTO_SIZE_LONG = "close_long"; |
|---|
| | | private static final String AUTO_SIZE_SHORT = "close_short"; |
|---|
| | |
|---|
| | | private static final String ORDER_TYPE_CLOSE_SHORT = "close-short-position"; |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | **回调方法**: |
|---|
| | | - `onKline(closePrice)`: 缓存价格，WAITING_KLINE状态下首次触发双开 |
|---|
| | | - `onPositionUpdate(Position.ModeEnum mode, size, entryPrice)`: `== DUAL_LONG/DUAL_SHORT` 枚举比较，size=0且方向活跃 → 补仓重试 |
|---|
| | | - `onPositionClose(side, pnl)`: 累加盈亏，检查停止条件 |
|---|
| | | **核心数据结构**: |
|---|
| | | |
|---|
| | | **补仓重试逻辑**: |
|---|
| | | ``` |
|---|
| | | tryReopenLong(): |
|---|
| | | 1. longReopenFails++（失败计数递增） |
|---|
| | | 2. 超过 reopenMaxRetries → STOPPED |
|---|
| | | 3. openLong(qty, |
|---|
| | | onSuccess → failCount=0, ACTIVE, 下新TP单, |
|---|
| | | onFailure → 递归 tryReopenLong() 重试 |
|---|
| | | ) |
|---|
| | | ``` |
|---|
| | | | 字段 | 类型 | 说明 | |
|---|
| | | |------|------|------| |
|---|
| | | | shortPriceQueue | List\<BigDecimal\> | 空仓价格队列，降序（大→小），容量 gridQueueSize | |
|---|
| | | | longPriceQueue | List\<BigDecimal\> | 多仓价格队列，升序（小→大），容量 gridQueueSize | |
|---|
| | | | shortBaseEntryPrice | BigDecimal | 基底空头入场价 | |
|---|
| | | | longBaseEntryPrice | BigDecimal | 基底多头入场价 | |
|---|
| | | | shortEntryPrice | BigDecimal | 当前空仓入场价（推送更新） | |
|---|
| | | | longEntryPrice | BigDecimal | 当前多仓入场价（推送更新） | |
|---|
| | | | shortPositionSize | BigDecimal | 当前空仓持仓量（绝对值） | |
|---|
| | | | longPositionSize | BigDecimal | 当前多仓持仓量 | |
|---|
| | | | baseLongOpened | boolean | 基底多头是否已开 | |
|---|
| | | | baseShortOpened | boolean | 基底空头是否已开 | |
|---|
| | | | longActive / shortActive | boolean | 多/空方向是否持有仓位 | |
|---|
| | | | cumulativePnl | BigDecimal | 累计已实现盈亏（平仓推送驱动） | |
|---|
| | | | unrealizedPnl | BigDecimal | 未实现盈亏（每根K线更新，浮动盈亏） | |
|---|
| | | | markPrice | BigDecimal | 标记价格（外部注入，MARK_PRICE 模式使用） | |
|---|
| | | | initialPrincipal | BigDecimal | 初始本金（启动时账户总资产） | |
|---|
| | | |
|---|
| | | **回调方法**: |
|---|
| | | - `onKline(closePrice)`: 更新 lastKlinePrice → 计算 unrealizedPnl → WAITING_KLINE 时触发基底双开，ACTIVE 时驱动 processShortGrid+processLongGrid |
|---|
| | | - `onPositionUpdate(contract, mode, size, entryPrice)`: 记录当前入场价和持仓量 → 有仓位时标记活跃+设止盈，无仓位时清空持仓量并标记不活跃 |
|---|
| | | - `onPositionClose(contract, side, pnl)`: 累加已实现盈亏，检查停止条件 |
|---|
| | | |
|---|
| | | **未实现盈亏计算** (`updateUnrealizedPnl()`): |
|---|
| | | |
|---|
| | | 正向合约公式（含合约乘数）： |
|---|
| | | |
|---|
| | | | 方向 | 公式 | |
|---|
| | | |------|------| |
|---|
| | | | 多仓 | 持仓量 × contractMultiplier × (计价价格 − 开仓均价) | |
|---|
| | | | 空仓 | 持仓量（绝对值）× contractMultiplier × (开仓均价 − 计价价格) | |
|---|
| | | |
|---|
| | | 计价价格由 `unrealizedPnlPriceMode` 决定： |
|---|
| | | - `LAST_PRICE`：使用最新成交价（`lastKlinePrice`，每根 K 线更新） |
|---|
| | | - `MARK_PRICE`：使用标记价格（通过 `setMarkPrice()` 外部注入，如未注入则回退到最新成交价） |
|---|
| | | |
|---|
| | | 入场价和持仓量由 `onPositionUpdate` 实时推送更新。 |
|---|
| | | |
|---|
| | | **保证金安全阀** (`isMarginSafe()`): |
|---|
| | | - 实时查询 `positionInitialMargin / initialPrincipal` |
|---|
| | | - 比例 ≥ marginRatioLimit（默认20%）→ 跳过开仓，队列照常更新 |
|---|
| | | - REST 查询失败 → 默认放行（避免因查询异常阻塞策略） |
|---|
| | | |
|---|
| | | **止盈计算**: |
|---|
| | | |
|---|
| | | | 方向 | 公式 | order_type | auto_size | |
|---|
| | | |------|------|------------|-----------| |
|---|
| | | | 多头 TP | entry × (1+gridRate) | `close-long-position` | `close_long` | |
|---|
| | | | 空头 TP | entry × (1-gridRate) | `close-short-position` | `close_short` | |
|---|
| | | | 方向 | 公式 | order_type | auto_size | rule | |
|---|
| | | |------|------|------------|-----------|------| |
|---|
| | | | 多头 TP | entry × (1+gridRate) | `close-long-position` | `close_long` | NUMBER_1(≥触发价) | |
|---|
| | | | 空头 TP | entry × (1-gridRate) | `close-short-position` | `close_short` | NUMBER_2(≤触发价) | |
|---|
| | | |
|---|
| | | **REST API 调用**: |
|---|
| | | |
|---|
| | |
|---|
| | | | 切持仓模式 | `POST /futures/usdt/set_position_mode` | `FuturesApi.setPositionMode()` | | |
|---|
| | | | 查仓位 | `GET /futures/usdt/positions` | `FuturesApi.listPositions()` | 遍历所有仓位，按合约过滤 | |
|---|
| | | | 市价平仓 | `POST /futures/usdt/orders` | `FuturesApi.createFuturesOrder()` | reduce_only, IOC。双向: size=0+close=false+autoSize | |
|---|
| | | | 设杠杆 | `POST /futures/usdt/positions/{contract}/leverage` | `FuturesApi.updateContractPositionLeverageCall()` | | |
|---|
| | | | 查账户 | `GET /futures/usdt/accounts` | `FuturesApi.listFuturesAccounts()` | | |
|---|
| | | | 设杠杆 | `POST /futures/usdt/dual_comp/positions/{contract}/leverage` | `FuturesApi.updateDualModePositionLeverageCall()` | 双向模式专用 | |
|---|
| | | | 查账户 | `GET /futures/usdt/accounts` | `FuturesApi.listFuturesAccounts()` | 获取初始本金和保证金 | |
|---|
| | | | 清除条件单 | `DELETE /futures/usdt/price_orders` | `FuturesApi.cancelPriceTriggeredOrderList()` | | |
|---|
| | | | 市价单 | `POST /futures/usdt/orders` | `FuturesApi.createFuturesOrder()` | price=0, tif=IOC | |
|---|
| | | | 条件单 | `POST /futures/usdt/price_orders` | `FuturesApi.createPriceTriggeredOrder()` | strategy=0, price_type=0, expiration=0 | |
|---|
| | |
|---|
| | | **初始化顺序** (`init()`): |
|---|
| | | ``` |
|---|
| | | 1. 获取用户 ID |
|---|
| | | 2. 查账户 → 如需要切持仓模式 |
|---|
| | | 2. 查账户 → 记录初始本金 → 如需要切持仓模式 |
|---|
| | | 3. 清除旧的止盈止损条件单 |
|---|
| | | 4. 查当前合约所有仓位 → 逐个市价平仓 |
|---|
| | | - 单向持仓(single): size=相反数, reduce_only=true |
|---|
