From 991e53d56e45094ca8e0db9685559bb71a015d2c Mon Sep 17 00:00:00 2001
From: Administrator <15274802129@163.com>
Date: Tue, 12 May 2026 16:11:26 +0800
Subject: [PATCH] feat(gateApi): 实现网格交易止盈队列和限价单管理功能
---
src/main/java/com/xcong/excoin/modules/gateApi/wsHandler/handler/PositionClosesChannelHandler.java | 19 +++++++++++++++++++
1 files changed, 19 insertions(+), 0 deletions(-)
diff --git a/src/main/java/com/xcong/excoin/modules/gateApi/wsHandler/handler/PositionClosesChannelHandler.java b/src/main/java/com/xcong/excoin/modules/gateApi/wsHandler/handler/PositionClosesChannelHandler.java
index 78950bb..3ca98ff 100644
--- a/src/main/java/com/xcong/excoin/modules/gateApi/wsHandler/handler/PositionClosesChannelHandler.java
+++ b/src/main/java/com/xcong/excoin/modules/gateApi/wsHandler/handler/PositionClosesChannelHandler.java
@@ -14,6 +14,7 @@
* <h3>数据用途</h3>
* 每笔平仓发生时推送 pnl（盈亏金额），累加到 {@code cumulativePnl} 用于判断策略停止条件：
* cumulativePnl ≥ overallTp（达到止盈目标）或 ≤ -maxLoss（超过亏损上限）。
+ * 止盈由 Gate 服务端条件单自动触发，平仓后仓位变为 0，盈亏通过本频道推送。
*
* <h3>推送字段</h3>
* contract, side（long / short）, pnl（该次平仓的盈亏，如 "+0.2" 或 "-0.1"）
@@ -34,6 +35,24 @@
super(CHANNEL_NAME, apiKey, apiSecret, contract, gridTradeService);
}
+ /**
+ * 处理平仓推送消息。
+ *
+ * <h3>数据提取</h3>
+ * result 数组中每个元素包含：
+ * <ul>
+ * <li>contract：合约名称</li>
+ * <li>side：平仓方向（"long" / "short"）</li>
+ * <li>pnl：本次平仓的盈亏金额（字符串格式，如 "+0.2" / "-0.1"）</li>
+ * </ul>
+ *
+ * <h3>数据处理</h3>
+ * 按合约名称过滤 → 提取 pnl 和 side → 调用 gridTradeService.onPositionClose() 累加盈亏。
+ * pnl 来自服务端，不受本地计算误差影响。
+ *
+ * @param response WebSocket 推送的完整 JSON
+ * @return true 表示已处理（匹配成功）
+ */
@Override
public boolean handleMessage(JSONObject response) {
if (!CHANNEL_NAME.equals(response.getString("channel"))) {
--
Gitblit v1.9.1