feat(gateApi): 更新网格交易逻辑文档和参数配置

Administrator

15 hours ago 2ba5828bc900a5a3646d9dfe78f53ff68e444fd4

 src/main/java/com/xcong/excoin/modules/gateApi/GateTradeExecutor.java

@@ -14,6 +14,7 @@
import java.util.concurrent.LinkedBlockingQueue;
import java.util.concurrent.ThreadPoolExecutor;
import java.util.concurrent.TimeUnit;
import java.util.function.Consumer;

/**
 * Gate REST API 执行器。
@@ -73,7 +74,8 @@
    }

    /**
     * 优雅关闭：等待 10 秒，超时则强制中断。
     * 优雅关闭：等待 10 秒让队列中的任务执行完毕，超时则强制中断。
     * 关闭后的 REST 调用将通过 CallerRunsPolicy 直接在提交线程执行。
     */
    public void shutdown() {
        executor.shutdown();
@@ -86,19 +88,36 @@
    }

    /**
     * 异步市价开多。quantity 为正数（如 "10"）。
     * 异步 IOC 市价开多。quantity 为正数（如 "1"）。
     *
     * @param quantity  开仓张数（正数）
     * @param onSuccess 成交成功回调（可为 null）
     * @param onFailure 成交失败回调（可为 null）
     */
    public void openLong(String quantity, Runnable onSuccess, Runnable onFailure) {
        openPosition(quantity, "t-grid-long", "开多", onSuccess, onFailure);
    }

    /**
     * 异步市价开空。quantity 为负数（如 "-10"）。
     * 异步 IOC 市价开空。quantity 为负数（如 "-1"）。
     *
     * @param quantity  开仓张数（负数）
     * @param onSuccess 成交成功回调（可为 null）
     * @param onFailure 成交失败回调（可为 null）
     */
    public void openShort(String quantity, Runnable onSuccess, Runnable onFailure) {
        openPosition(quantity, "t-grid-short", "开空", onSuccess, onFailure);
    }

    /**
     * 通用异步 IOC 市价下单。
     *
     * @param size      下单张数（正=开多 / 负=开空）
     * @param text      订单标记文本（如 "t-grid-long"），用于区分订单来源
     * @param label     日志标签（如 "开多"/"开空"）
     * @param onSuccess 成功回调
     * @param onFailure 失败回调
     */
    private void openPosition(String size, String text, String label, Runnable onSuccess, Runnable onFailure) {
        executor.execute(() -> {
            try {
@@ -191,6 +210,56 @@
    }

    /**
     * 异步挂限价单（GTC），用于网格限价开仓。
     *
     * @param price     限价价格
     * @param size      下单张数（正=多 / 负=空）
     * @param onSuccess 成功回调，接收 orderId（可为 null）
     * @param onFailure 失败回调（可为 null）
     */
    public void placeGridLimitOrder(BigDecimal price, String size, Consumer<String> onSuccess, Runnable onFailure) {
        executor.execute(() -> {
            try {
                FuturesOrder order = new FuturesOrder();
                order.setContract(contract);
                order.setSize(size);
                order.setPrice(price.toString());
                order.setTif(FuturesOrder.TifEnum.GTC);
                order.setText(size.startsWith("-") ? "t-grid-limit-short" : "t-grid-limit-long");
                FuturesOrder result = futuresApi.createFuturesOrder(SETTLE, order, null);
                log.info("[TradeExec] 限价单已挂, price:{}, size:{}, id:{}, status:{}", price, size, result.getId(), result.getStatus());
                if (onSuccess != null) {
                    onSuccess.accept(String.valueOf(result.getId()));
                }
            } catch (Exception e) {
                log.error("[TradeExec] 限价单挂单失败, price:{}, size:{}", price, size, e);
                if (onFailure != null) {
                    onFailure.run();
                }
            }
        });
    }

    /**
     * 异步取消指定订单。
     *
     * @param orderId 订单 ID，为 null 时跳过
     */
    public void cancelOrder(String orderId) {
        if (orderId == null) {
            return;
        }
        executor.execute(() -> {
            try {
                FuturesOrder cancelled = futuresApi.cancelFuturesOrder(SETTLE, orderId, null);
                log.info("[TradeExec] 订单已取消, id:{}, status:{}", orderId, cancelled.getStatus());
            } catch (Exception e) {
                log.warn("[TradeExec] 取消订单失败(可能已成交), id:{}", orderId);
            }
        });
    }

    /**
     * 构建 FuturesPriceTriggeredOrder 对象。
     *
     * <p>策略=0（价格触发），price_type=0（最新价），expiration=0（永不过期），