feat(gateApi): 添加网格交易累计止损功能

Administrator

2026-06-16 618b7de11fc6eda81a462788501659bde95c5dc9

 src/main/java/com/xcong/excoin/modules/gateApi/wsHandler/handler/PositionClosesChannelHandler.java

@@ -9,17 +9,7 @@
import java.math.BigDecimal;

/**
 * 平仓频道处理器。
 *
 * <h3>数据用途</h3>
 * 每笔平仓发生时推送 pnl（盈亏金额），累加到 {@code cumulativePnl} 用于判断策略停止条件：
 * cumulativePnl ≥ overallTp（达到止盈目标）或 ≤ -maxLoss（超过亏损上限）。
 *
 * <h3>推送字段</h3>
 * contract, side（long / short）, pnl（该次平仓的盈亏，如 "+0.2" 或 "-0.1"）
 *
 * <h3>注意</h3>
 * 平仓盈亏来自服务器端，不受本地计算误差影响。这是策略停止的唯一盈亏判断来源。
 * 平仓频道处理器（futures.position_closes），接收平仓盈亏推送并回调 {@link GateGridTradeService#onPositionClose}。
 *
 * @author Administrator
 */
@@ -28,21 +18,51 @@

    private static final String CHANNEL_NAME = "futures.position_closes";

    /**
     * @param apiKey           Gate API v4 密钥，用于签名认证
     * @param apiSecret        Gate API v4 签名密钥
     * @param contract         合约名称（如 ETH_USDT）
     * @param gridTradeService 网格交易策略服务实例
     */
    public PositionClosesChannelHandler(String apiKey, String apiSecret,
                                         String contract,
                                         GateGridTradeService gridTradeService) {
        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"))) return false;
        if (!CHANNEL_NAME.equals(response.getString("channel"))) {
            return false;
        }
        try {
            JSONArray resultArray = response.getJSONArray("result");
            if (resultArray == null || resultArray.isEmpty()) return true;
            if (resultArray == null || resultArray.isEmpty()) {
                return true;
            }
            for (int i = 0; i < resultArray.size(); i++) {
                JSONObject item = resultArray.getJSONObject(i);
                if (!getContract().equals(item.getString("contract"))) continue;
                if (!getContract().equals(item.getString("contract"))) {
                    continue;
                }
                BigDecimal pnl = new BigDecimal(item.getString("pnl"));
                String side = item.getString("side");
                log.info("[{}] 平仓更新, 方向:{}, 盈亏:{}", CHANNEL_NAME, side, pnl);