@pionex/pionex-ai-kit 0.2.27 → 0.2.29

package/dist/index.js

@@ -1480,6 +1480,44 @@ function registerOrdersTools() {
     }
   ];
 }
+var CREATE_FUTURES_GRID_ORDER_DATA_KEYS = [
+  "top",
+  "bottom",
+  "row",
+  "grid_type",
+  "trend",
+  "leverage",
+  "extraMargin",
+  "quoteInvestment",
+  "condition",
+  "conditionDirection",
+  "lossStopType",
+  "lossStop",
+  "lossStopDelay",
+  "profitStopType",
+  "profitStop",
+  "profitStopDelay",
+  "lossStopHigh",
+  "shareRatio",
+  "investCoin",
+  "investmentFrom",
+  "uiInvestCoin",
+  "lossStopLimitPrice",
+  "lossStopLimitHighPrice",
+  "profitStopLimitPrice",
+  "slippage",
+  "bonusId",
+  "uiExtraData",
+  "movingIndicatorType",
+  "movingIndicatorInterval",
+  "movingIndicatorParam",
+  "movingTrailingUpParam",
+  "cateType",
+  "movingTop",
+  "movingBottom",
+  "enableFollowClosed"
+];
+var ORDER_DATA_KEY_SET = new Set(CREATE_FUTURES_GRID_ORDER_DATA_KEYS);
 function asNonEmptyString(value, field) {
   if (typeof value !== "string" || value.trim().length === 0) {
     throw new Error(`Invalid "${field}": expected non-empty string.`);
@@ -1515,12 +1553,6 @@ function assertEnum(value, field, allowed) {
     throw new Error(`Invalid "${field}": expected one of ${allowed.join(", ")}.`);
   }
 }
-function asObject(value, field) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    throw new Error(`Invalid "${field}": expected JSON object.`);
-  }
-  return value;
-}
 function asPositiveDecimalString(value, field) {
   const s = asNonEmptyString(value, field);
   if (!/^\d+(\.\d+)?$/.test(s)) {
@@ -1532,6 +1564,12 @@ function asPositiveDecimalString(value, field) {
   }
   return s;
 }
+function asPositiveDecimalStringLoose(value, field) {
+  if (typeof value === "number" && Number.isFinite(value) && value > 0) {
+    return String(value);
+  }
+  return asPositiveDecimalString(value, field);
+}
 function asNonNegativeDecimalString(value, field) {
   const s = asNonEmptyString(value, field);
   if (!/^\d+(\.\d+)?$/.test(s)) {
@@ -1543,82 +1581,236 @@ function asNonNegativeDecimalString(value, field) {
   }
   return s;
 }
-function toTrimmedDecimal(value) {
-  return value.toFixed(8).replace(/\.?0+$/, "");
+function asOptionalString(value, field) {
+  if (typeof value !== "string") {
+    throw new Error(`Invalid "${field}": expected string.`);
+  }
+  return value;
 }
-function decimalPlaces(value) {
-  const idx = value.indexOf(".");
-  return idx === -1 ? 0 : value.length - idx - 1;
+function asOptionalNonNegativeNumber(value, field) {
+  const n = asFiniteNumber(value, field);
+  if (n < 0) throw new Error(`Invalid "${field}": expected number >= 0.`);
+  return n;
 }
-function tenPow(exp) {
-  let out = 1n;
-  for (let i = 0; i < exp; i++) out *= 10n;
+function parseAndValidateCreateFuturesGridBuOrderData(raw) {
+  const data = { ...raw };
+  delete data.openPrice;
+  delete data.keyId;
+  delete data.key_id;
+  for (const k of Object.keys(data)) {
+    if (!ORDER_DATA_KEY_SET.has(k)) {
+      throw new Error(`Unknown buOrderData property "${k}". Allowed keys: ${CREATE_FUTURES_GRID_ORDER_DATA_KEYS.join(", ")}.`);
+    }
+  }
+  const top = asPositiveDecimalStringLoose(data.top, "buOrderData.top");
+  const bottom = asPositiveDecimalStringLoose(data.bottom, "buOrderData.bottom");
+  if (Number(top) <= Number(bottom)) {
+    throw new Error('Invalid "buOrderData.top": expected top > bottom.');
+  }
+  const row = asPositiveInteger(data.row, "buOrderData.row");
+  const gridType = asNonEmptyString(data.grid_type, "buOrderData.grid_type");
+  assertEnum(gridType, "buOrderData.grid_type", ["arithmetic", "geometric"]);
+  const trend = asNonEmptyString(data.trend, "buOrderData.trend");
+  assertEnum(trend, "buOrderData.trend", ["long", "short", "no_trend"]);
+  const leverage = asPositiveNumber(data.leverage, "buOrderData.leverage");
+  const quoteInvestment = asPositiveDecimalStringLoose(data.quoteInvestment, "buOrderData.quoteInvestment");
+  const out = {
+    top,
+    bottom,
+    row,
+    grid_type: gridType,
+    trend,
+    leverage,
+    quoteInvestment
+  };
+  if (data.extraMargin != null) {
+    out.extraMargin = asNonNegativeDecimalString(data.extraMargin, "buOrderData.extraMargin");
+  }
+  if (data.condition != null) out.condition = asOptionalString(data.condition, "buOrderData.condition");
+  if (data.conditionDirection != null) {
+    const v = asNonEmptyString(data.conditionDirection, "buOrderData.conditionDirection");
+    assertEnum(v, "buOrderData.conditionDirection", ["-1", "1"]);
+    out.conditionDirection = v;
+  }
+  if (data.lossStopType != null) {
+    const v = asNonEmptyString(data.lossStopType, "buOrderData.lossStopType");
+    assertEnum(v, "buOrderData.lossStopType", ["price", "profit_amount", "profit_ratio", "price_limit"]);
+    out.lossStopType = v;
+  }
+  if (data.lossStop != null) out.lossStop = asOptionalString(data.lossStop, "buOrderData.lossStop");
+  if (data.lossStopDelay != null) out.lossStopDelay = asOptionalNonNegativeNumber(data.lossStopDelay, "buOrderData.lossStopDelay");
+  if (data.profitStopType != null) {
+    const v = asNonEmptyString(data.profitStopType, "buOrderData.profitStopType");
+    assertEnum(v, "buOrderData.profitStopType", ["price", "profit_amount", "profit_ratio", "price_limit"]);
+    out.profitStopType = v;
+  }
+  if (data.profitStop != null) out.profitStop = asOptionalString(data.profitStop, "buOrderData.profitStop");
+  if (data.profitStopDelay != null) out.profitStopDelay = asOptionalNonNegativeNumber(data.profitStopDelay, "buOrderData.profitStopDelay");
+  if (data.lossStopHigh != null) out.lossStopHigh = asOptionalString(data.lossStopHigh, "buOrderData.lossStopHigh");
+  if (data.shareRatio != null) out.shareRatio = asOptionalString(data.shareRatio, "buOrderData.shareRatio");
+  if (data.investCoin != null) out.investCoin = asOptionalString(data.investCoin, "buOrderData.investCoin");
+  if (data.investmentFrom != null) {
+    const v = asNonEmptyString(data.investmentFrom, "buOrderData.investmentFrom");
+    assertEnum(v, "buOrderData.investmentFrom", ["USER", "LOCK_ACTIVITY", "FUTURE_GRID_BONUS"]);
+    out.investmentFrom = v;
+  }
+  if (data.uiInvestCoin != null) out.uiInvestCoin = asOptionalString(data.uiInvestCoin, "buOrderData.uiInvestCoin");
+  if (data.lossStopLimitPrice != null) out.lossStopLimitPrice = asOptionalString(data.lossStopLimitPrice, "buOrderData.lossStopLimitPrice");
+  if (data.lossStopLimitHighPrice != null) out.lossStopLimitHighPrice = asOptionalString(data.lossStopLimitHighPrice, "buOrderData.lossStopLimitHighPrice");
+  if (data.profitStopLimitPrice != null) out.profitStopLimitPrice = asOptionalString(data.profitStopLimitPrice, "buOrderData.profitStopLimitPrice");
+  if (data.slippage != null) out.slippage = asOptionalString(data.slippage, "buOrderData.slippage");
+  if (data.bonusId != null) out.bonusId = asOptionalString(data.bonusId, "buOrderData.bonusId");
+  if (data.uiExtraData != null) out.uiExtraData = asOptionalString(data.uiExtraData, "buOrderData.uiExtraData");
+  if (data.movingIndicatorType != null) out.movingIndicatorType = asOptionalString(data.movingIndicatorType, "buOrderData.movingIndicatorType");
+  if (data.movingIndicatorInterval != null) out.movingIndicatorInterval = asOptionalString(data.movingIndicatorInterval, "buOrderData.movingIndicatorInterval");
+  if (data.movingIndicatorParam != null) out.movingIndicatorParam = asOptionalString(data.movingIndicatorParam, "buOrderData.movingIndicatorParam");
+  if (data.movingTrailingUpParam != null) out.movingTrailingUpParam = asOptionalString(data.movingTrailingUpParam, "buOrderData.movingTrailingUpParam");
+  if (data.cateType != null) {
+    const v = asNonEmptyString(data.cateType, "buOrderData.cateType");
+    assertEnum(v, "buOrderData.cateType", ["FULLY_HEDGING", "LOAN_GRID", "LEVERAGE_GRID", "FUTURE_GRID_COIN_MARGINED"]);
+    out.cateType = v;
+  }
+  if (data.movingTop != null) out.movingTop = asOptionalString(data.movingTop, "buOrderData.movingTop");
+  if (data.movingBottom != null) out.movingBottom = asOptionalString(data.movingBottom, "buOrderData.movingBottom");
+  if (data.enableFollowClosed != null) out.enableFollowClosed = asBoolean(data.enableFollowClosed, "buOrderData.enableFollowClosed");
   return out;
 }
-function decimalStringToInt(value) {
-  const [whole, frac = ""] = value.split(".");
-  return { intVal: BigInt(`${whole}${frac}`), scale: frac.length };
-}
-function intToDecimalString(value, scale) {
-  const negative = value < 0n;
-  const abs = negative ? -value : value;
-  const digits = abs.toString().padStart(scale + 1, "0");
-  const whole = digits.slice(0, digits.length - scale);
-  const frac = scale > 0 ? digits.slice(digits.length - scale) : "";
-  const merged = scale > 0 ? `${whole}.${frac}` : whole;
-  const trimmed = merged.replace(/\.?0+$/, "");
-  return negative ? `-${trimmed}` : trimmed;
-}
-function multiplyDecimalByRatio(value, numerator, denominator, outScale) {
-  const { intVal, scale } = decimalStringToInt(value);
-  const n = BigInt(numerator);
-  const d = BigInt(denominator);
-  const scaledNumerator = intVal * n * tenPow(outScale);
-  const scaledDenominator = d * tenPow(scale);
-  const rounded = (scaledNumerator + scaledDenominator / 2n) / scaledDenominator;
-  return intToDecimalString(rounded, outScale);
-}
-function maybePositiveDecimalString(value) {
-  if (typeof value === "string" && /^\d+(\.\d+)?$/.test(value)) {
-    const n = Number(value);
-    if (Number.isFinite(n) && n > 0) return value;
+var createFuturesGridOrderDataJsonSchema = {
+  type: "object",
+  additionalProperties: false,
+  description: "CreateFuturesGridOrderData (openapi_bot.yaml). Required: top, bottom, row, grid_type, trend, leverage, quoteInvestment.",
+  required: ["top", "bottom", "row", "grid_type", "trend", "leverage", "quoteInvestment"],
+  properties: {
+    top: { type: "string", description: "Grid upper price" },
+    bottom: { type: "string", description: "Grid lower price" },
+    row: { type: "number", description: "Number of grid levels" },
+    grid_type: {
+      type: "string",
+      enum: ["arithmetic", "geometric"],
+      description: "Grid spacing: arithmetic (equal difference) or geometric (equal ratio)"
+    },
+    trend: {
+      type: "string",
+      enum: ["long", "short", "no_trend"],
+      description: "Grid direction"
+    },
+    leverage: { type: "number", description: "Leverage multiplier" },
+    extraMargin: { type: "string", description: "Extra margin amount (optional)" },
+    quoteInvestment: { type: "string", description: "Investment amount" },
+    condition: { type: "string", description: "Trigger price (conditional orders)" },
+    conditionDirection: { type: "string", enum: ["-1", "1"], description: "Trigger direction" },
+    lossStopType: {
+      type: "string",
+      enum: ["price", "profit_amount", "profit_ratio", "price_limit"],
+      description: "Stop loss type"
+    },
+    lossStop: { type: "string", description: "Stop loss value" },
+    lossStopDelay: { type: "number", description: "Stop loss delay (seconds)" },
+    profitStopType: {
+      type: "string",
+      enum: ["price", "profit_amount", "profit_ratio", "price_limit"],
+      description: "Take profit type"
+    },
+    profitStop: { type: "string", description: "Take profit value" },
+    profitStopDelay: { type: "number", description: "Take profit delay (seconds)" },
+    lossStopHigh: { type: "string", description: "Upper stop loss price for neutral grid" },
+    shareRatio: { type: "string", description: "Profit sharing ratio" },
+    investCoin: { type: "string", description: "Investment currency" },
+    investmentFrom: {
+      type: "string",
+      enum: ["USER", "LOCK_ACTIVITY", "FUTURE_GRID_BONUS"],
+      description: "Funding source"
+    },
+    uiInvestCoin: { type: "string", description: "Frontend-recorded investment currency" },
+    lossStopLimitPrice: { type: "string", description: "Limit SL price (lossStopType=price_limit)" },
+    lossStopLimitHighPrice: { type: "string", description: "Upper limit SL for neutral grid" },
+    profitStopLimitPrice: { type: "string", description: "Limit TP price (profitStopType=price_limit)" },
+    slippage: { type: "string", description: "Open slippage e.g. 0.01 = 1%" },
+    bonusId: { type: "string", description: "Bonus UUID" },
+    uiExtraData: { type: "string", description: "Frontend extra (coin-margined)" },
+    movingIndicatorType: { type: "string", description: "e.g. sma" },
+    movingIndicatorInterval: { type: "string", description: "e.g. 1m, 15m" },
+    movingIndicatorParam: { type: "string", description: "JSON params e.g. length" },
+    movingTrailingUpParam: { type: "string", description: "SMA trailing up ratio" },
+    cateType: {
+      type: "string",
+      enum: ["FULLY_HEDGING", "LOAN_GRID", "LEVERAGE_GRID", "FUTURE_GRID_COIN_MARGINED"],
+      description: "Category type"
+    },
+    movingTop: { type: "string", description: "Moving grid upper limit" },
+    movingBottom: { type: "string", description: "Moving grid lower limit" },
+    enableFollowClosed: { type: "boolean", description: "Follow close" }
   }
-  if (typeof value === "number" && Number.isFinite(value) && value > 0) {
-    return toTrimmedDecimal(value);
+};
+var createFuturesGridCreateToolInputSchema = {
+  type: "object",
+  additionalProperties: false,
+  required: ["base", "quote", "buOrderData"],
+  properties: {
+    base: { type: "string", description: "Base currency (e.g. BTC); *.PERP normalized in handler" },
+    quote: { type: "string", description: "Quote currency (e.g. USDT)" },
+    exchange: { type: "string", description: "Optional. Futures exchange identifier (temporary compatibility)." },
+    copyFrom: { type: "string", description: "Optional. Copy source order ID" },
+    copyType: { type: "string", description: "Optional. Copy type" },
+    copyBotOrderId: { type: "string", description: "Optional. Copy bot order ID" },
+    buOrderData: createFuturesGridOrderDataJsonSchema,
+    __dryRun: { type: "boolean", description: "Internal: when true, return resolved body without POST" }
+  }
+};
+function asNonEmptyString2(value, field) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new Error(`Invalid "${field}": expected non-empty string.`);
   }
-  return void 0;
+  return value.trim();
 }
-function normalizePerpBase(base) {
-  return base.endsWith(".PERP") ? base : `${base}.PERP`;
+function asFiniteNumber2(value, field) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new Error(`Invalid "${field}": expected finite number.`);
+  }
+  return value;
 }
-function tryExtractCurrentPrice(payload, symbol) {
-  const stacks = [payload];
-  while (stacks.length > 0) {
-    const node = stacks.pop();
-    if (!node || typeof node !== "object") continue;
-    const obj = node;
-    const nodeSymbol = typeof obj.symbol === "string" ? obj.symbol : void 0;
-    const candidateClose = maybePositiveDecimalString(obj.close) ?? maybePositiveDecimalString(obj.last) ?? maybePositiveDecimalString(obj.lastPrice) ?? maybePositiveDecimalString(obj.price);
-    if (candidateClose && (!nodeSymbol || nodeSymbol === symbol)) {
-      return candidateClose;
-    }
-    for (const v of Object.values(obj)) {
-      if (Array.isArray(v)) {
-        for (const item of v) stacks.push(item);
-      } else if (v && typeof v === "object") {
-        stacks.push(v);
-      }
-    }
+function asPositiveNumber2(value, field) {
+  const n = asFiniteNumber2(value, field);
+  if (n <= 0) throw new Error(`Invalid "${field}": expected number > 0.`);
+  return n;
+}
+function asPositiveInteger2(value, field) {
+  const n = asPositiveNumber2(value, field);
+  if (!Number.isInteger(n)) {
+    throw new Error(`Invalid "${field}": expected positive integer.`);
   }
-  return void 0;
+  return n;
 }
-async function getCurrentSymbolPrice(client, symbol) {
-  const tickerPayload = (await client.publicGet("/api/v1/market/tickers", { symbol })).data;
-  const extracted = tryExtractCurrentPrice(tickerPayload, symbol);
-  if (!extracted) {
-    throw new Error(`Unable to infer current market price for ${symbol} from ticker response. Please provide buOrderData.top and buOrderData.bottom explicitly.`);
+function asBoolean2(value, field) {
+  if (typeof value !== "boolean") {
+    throw new Error(`Invalid "${field}": expected boolean.`);
   }
-  return extracted;
+  return value;
+}
+function assertEnum2(value, field, allowed) {
+  if (!allowed.includes(value)) {
+    throw new Error(`Invalid "${field}": expected one of ${allowed.join(", ")}.`);
+  }
+}
+function asObject(value, field) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(`Invalid "${field}": expected JSON object.`);
+  }
+  return value;
+}
+function asPositiveDecimalString2(value, field) {
+  const s = asNonEmptyString2(value, field);
+  if (!/^\d+(\.\d+)?$/.test(s)) {
+    throw new Error(`Invalid "${field}": expected positive decimal string.`);
+  }
+  const n = Number(s);
+  if (!Number.isFinite(n) || n <= 0) {
+    throw new Error(`Invalid "${field}": expected positive decimal string.`);
+  }
+  return s;
+}
+function normalizePerpBase(base) {
+  return base.endsWith(".PERP") ? base : `${base}.PERP`;
 }
 function registerBotTools() {
   return [
@@ -1647,121 +1839,38 @@ function registerBotTools() {
       name: "pionex_bot_create_futures_grid_order",
       module: "bot",
       isWrite: true,
-      description: "Create a futures grid bot order.",
-      inputSchema: {
-        type: "object",
-        additionalProperties: false,
-        properties: {
-          keyId: { type: "string" },
-          exchange: { type: "string", description: "e.g. pionex.v2" },
-          base: { type: "string", description: "e.g. BTC" },
-          quote: { type: "string", description: "e.g. USDT" },
-          copyFrom: { type: "string" },
-          copyType: { type: "string" },
-          groupId: { type: "string" },
-          copyBotOrderId: { type: "string" },
-          lang: { type: "string" },
-          buOrderData: {
-            type: "object",
-            additionalProperties: true,
-            description: "CreateFuturesGridOrderData payload from openapi_bot.yaml."
-          }
-        },
-        required: ["base", "buOrderData"]
-      },
+      description: "Create a futures grid order (openapi_bot.yaml CreateFuturesGridRequest / CreateFuturesGridOrderData). https://github.com/pionex-official/pionex-open-api/blob/main/openapi_bot.yaml \u2014 Required: base, quote, buOrderData. Optional: copyFrom, copyType, copyBotOrderId. buOrderData required: top, bottom, row, grid_type, trend, leverage, quoteInvestment; unknown keys rejected.",
+      inputSchema: createFuturesGridCreateToolInputSchema,
       async handler(args, { client, config }) {
         if (config.readOnly) {
           throw new Error("Server is running in --read-only mode; bot create is disabled.");
         }
-        const defaultsApplied = {};
-        const exchange = asNonEmptyString(args.exchange ?? "pionex.v2", "exchange");
-        if (args.exchange == null) defaultsApplied.exchange = exchange;
-        const rawBase = asNonEmptyString(args.base, "base");
+        const rawBase = asNonEmptyString2(args.base, "base");
         const base = normalizePerpBase(rawBase);
-        if (base !== rawBase) defaultsApplied.base = base;
-        const quote = asNonEmptyString(args.quote ?? "USDT", "quote");
-        if (args.quote == null) defaultsApplied.quote = quote;
-        const buOrderData = asObject(args.buOrderData, "buOrderData");
-        const symbol = `${base}_${quote}`;
-        const needsTickerForTopBottom = buOrderData.top == null || buOrderData.bottom == null;
-        const shouldTryTicker = needsTickerForTopBottom;
-        let currentPrice;
-        if (shouldTryTicker) {
-          try {
-            currentPrice = asPositiveDecimalString(await getCurrentSymbolPrice(client, symbol), "currentPrice");
-          } catch {
-            currentPrice = void 0;
-          }
-        }
-        if (needsTickerForTopBottom && currentPrice == null) {
-          throw new Error(`Unable to infer current market price for ${symbol} from ticker response. Please provide buOrderData.top and buOrderData.bottom explicitly.`);
-        }
-        const autoPriceScale = currentPrice == null ? void 0 : Math.min(8, Math.max(2, decimalPlaces(currentPrice) + 2));
-        const top = asPositiveDecimalString(
-          buOrderData.top ?? multiplyDecimalByRatio(currentPrice, 105, 100, autoPriceScale),
-          "buOrderData.top"
-        );
-        if (buOrderData.top == null) defaultsApplied.top = top;
-        const bottom = asPositiveDecimalString(
-          buOrderData.bottom ?? multiplyDecimalByRatio(currentPrice, 95, 100, autoPriceScale),
-          "buOrderData.bottom"
-        );
-        if (buOrderData.bottom == null) defaultsApplied.bottom = bottom;
-        if (Number(top) <= Number(bottom)) {
-          throw new Error('Invalid "buOrderData.top": expected top > bottom.');
-        }
-        const row = asPositiveInteger(buOrderData.row ?? 10, "buOrderData.row");
-        if (buOrderData.row == null) defaultsApplied.row = row;
-        const gridType = asNonEmptyString(buOrderData.grid_type ?? "arithmetic", "buOrderData.grid_type");
-        assertEnum(gridType, "buOrderData.grid_type", ["arithmetic", "geometric"]);
-        if (buOrderData.grid_type == null) defaultsApplied.grid_type = gridType;
-        const openPrice = buOrderData.openPrice == null ? void 0 : asPositiveDecimalString(buOrderData.openPrice, "buOrderData.openPrice");
-        const trend = asNonEmptyString(buOrderData.trend, "buOrderData.trend");
-        assertEnum(trend, "buOrderData.trend", ["long", "short", "no_trend"]);
-        const leverage = asPositiveNumber(buOrderData.leverage ?? 2, "buOrderData.leverage");
-        if (buOrderData.leverage == null) defaultsApplied.leverage = leverage;
-        const extraMargin = asNonNegativeDecimalString(buOrderData.extraMargin ?? "0", "buOrderData.extraMargin");
-        if (buOrderData.extraMargin == null) defaultsApplied.extraMargin = extraMargin;
-        const quoteInvestment = asPositiveDecimalString(buOrderData.quoteInvestment, "buOrderData.quoteInvestment");
+        const quote = asNonEmptyString2(args.quote, "quote");
+        const exchange = args.exchange != null ? asNonEmptyString2(args.exchange, "exchange") : void 0;
+        const buOrderDataOut = parseAndValidateCreateFuturesGridBuOrderData(asObject(args.buOrderData, "buOrderData"));
+        const row = buOrderDataOut.row;
+        const gridType = buOrderDataOut.grid_type;
+        const leverage = buOrderDataOut.leverage;
         const body = {
-          exchange,
           base,
           quote,
-          buOrderData: {
-            ...buOrderData,
-            top,
-            bottom,
-            row,
-            grid_type: gridType,
-            trend,
-            leverage,
-            extraMargin,
-            quoteInvestment
-          }
+          buOrderData: buOrderDataOut
         };
-        if (openPrice != null) {
-          body.buOrderData.openPrice = openPrice;
-        }
-        if (args.keyId != null) body.keyId = asNonEmptyString(args.keyId, "keyId");
+        if (exchange != null) body.exchange = exchange;
         if (args.copyFrom != null) body.copyFrom = String(args.copyFrom);
         if (args.copyType != null) body.copyType = String(args.copyType);
-        if (args.groupId != null) body.groupId = String(args.groupId);
         if (args.copyBotOrderId != null) body.copyBotOrderId = String(args.copyBotOrderId);
-        if (args.lang != null) body.lang = String(args.lang);
         if (args.__dryRun === true) {
-          const rowSource = buOrderData.row == null ? "default" : "user";
           return {
             dryRun: true,
-            note: "No order was sent. This is the resolved request body after applying defaults.",
-            marketSymbol: symbol,
-            marketPriceUsed: currentPrice,
+            note: "No order was sent. Body matches openapi_bot.yaml CreateFuturesGridRequest.",
             resolvedParams: {
               row,
-              rowSource,
               grid_type: gridType,
               leverage
             },
-            defaultsApplied,
             resolvedBody: body
           };
         }
@@ -1801,26 +1910,26 @@ function registerBotTools() {
         if (config.readOnly) {
           throw new Error("Server is running in --read-only mode; bot adjust is disabled.");
         }
-        const buOrderId = asNonEmptyString(args.buOrderId, "buOrderId");
-        const type = asNonEmptyString(args.type, "type");
-        assertEnum(type, "type", ["invest_in", "adjust_params", "invest_in_trigger"]);
-        const extraMargin = asBoolean(args.extraMargin, "extraMargin");
-        const openPrice = asFiniteNumber(args.openPrice, "openPrice");
+        const buOrderId = asNonEmptyString2(args.buOrderId, "buOrderId");
+        const type = asNonEmptyString2(args.type, "type");
+        assertEnum2(type, "type", ["invest_in", "adjust_params", "invest_in_trigger"]);
+        const extraMargin = asBoolean2(args.extraMargin, "extraMargin");
+        const openPrice = asFiniteNumber2(args.openPrice, "openPrice");
         if (type === "invest_in" && args.quoteInvestment != null) {
-          asPositiveNumber(args.quoteInvestment, "quoteInvestment");
+          asPositiveNumber2(args.quoteInvestment, "quoteInvestment");
         }
         if (type === "adjust_params") {
-          const bottom = asPositiveDecimalString(args.bottom, "bottom");
-          const top = asPositiveDecimalString(args.top, "top");
+          const bottom = asPositiveDecimalString2(args.bottom, "bottom");
+          const top = asPositiveDecimalString2(args.top, "top");
           if (Number(top) <= Number(bottom)) {
             throw new Error('Invalid "top": expected top > bottom.');
           }
-          asPositiveInteger(args.row, "row");
+          asPositiveInteger2(args.row, "row");
         }
         if (type === "invest_in_trigger") {
-          asPositiveDecimalString(args.condition, "condition");
-          const conditionDirection = asNonEmptyString(args.conditionDirection, "conditionDirection");
-          assertEnum(conditionDirection, "conditionDirection", ["1", "-1"]);
+          asPositiveDecimalString2(args.condition, "condition");
+          const conditionDirection = asNonEmptyString2(args.conditionDirection, "conditionDirection");
+          assertEnum2(conditionDirection, "conditionDirection", ["1", "-1"]);
         }
         const body = {
           buOrderId,
@@ -1828,23 +1937,23 @@ function registerBotTools() {
           extraMargin,
           openPrice
         };
-        if (args.quoteInvestment != null) body.quoteInvestment = asFiniteNumber(args.quoteInvestment, "quoteInvestment");
-        if (args.bottom != null) body.bottom = asPositiveDecimalString(args.bottom, "bottom");
-        if (args.top != null) body.top = asPositiveDecimalString(args.top, "top");
-        if (args.row != null) body.row = asPositiveInteger(args.row, "row");
-        if (args.extraMarginAmount != null) body.extraMarginAmount = asFiniteNumber(args.extraMarginAmount, "extraMarginAmount");
-        if (args.isRecommend != null) body.isRecommend = asBoolean(args.isRecommend, "isRecommend");
-        if (args.isReinvest != null) body.isReinvest = asBoolean(args.isReinvest, "isReinvest");
+        if (args.quoteInvestment != null) body.quoteInvestment = asFiniteNumber2(args.quoteInvestment, "quoteInvestment");
+        if (args.bottom != null) body.bottom = asPositiveDecimalString2(args.bottom, "bottom");
+        if (args.top != null) body.top = asPositiveDecimalString2(args.top, "top");
+        if (args.row != null) body.row = asPositiveInteger2(args.row, "row");
+        if (args.extraMarginAmount != null) body.extraMarginAmount = asFiniteNumber2(args.extraMarginAmount, "extraMarginAmount");
+        if (args.isRecommend != null) body.isRecommend = asBoolean2(args.isRecommend, "isRecommend");
+        if (args.isReinvest != null) body.isReinvest = asBoolean2(args.isReinvest, "isReinvest");
         if (args.investCoin != null) body.investCoin = String(args.investCoin);
         if (args.investmentFrom != null) {
-          const investmentFrom = asNonEmptyString(args.investmentFrom, "investmentFrom");
-          assertEnum(investmentFrom, "investmentFrom", ["USER", "LOCK_ACTIVITY"]);
+          const investmentFrom = asNonEmptyString2(args.investmentFrom, "investmentFrom");
+          assertEnum2(investmentFrom, "investmentFrom", ["USER", "LOCK_ACTIVITY"]);
           body.investmentFrom = investmentFrom;
         }
-        if (args.condition != null) body.condition = asPositiveDecimalString(args.condition, "condition");
+        if (args.condition != null) body.condition = asPositiveDecimalString2(args.condition, "condition");
         if (args.conditionDirection != null) {
-          const conditionDirection = asNonEmptyString(args.conditionDirection, "conditionDirection");
-          assertEnum(conditionDirection, "conditionDirection", ["1", "-1"]);
+          const conditionDirection = asNonEmptyString2(args.conditionDirection, "conditionDirection");
+          assertEnum2(conditionDirection, "conditionDirection", ["1", "-1"]);
           body.conditionDirection = conditionDirection;
         }
         if (args.slippage != null) body.slippage = String(args.slippage);
@@ -1874,9 +1983,9 @@ function registerBotTools() {
         if (config.readOnly) {
           throw new Error("Server is running in --read-only mode; bot reduce is disabled.");
         }
-        const buOrderId = asNonEmptyString(args.buOrderId, "buOrderId");
-        const openPrice = asPositiveDecimalString(args.openPrice, "openPrice");
-        const reduceNum = asPositiveInteger(args.reduceNum, "reduceNum");
+        const buOrderId = asNonEmptyString2(args.buOrderId, "buOrderId");
+        const openPrice = asPositiveDecimalString2(args.openPrice, "openPrice");
+        const reduceNum = asPositiveInteger2(args.reduceNum, "reduceNum");
         const body = {
           buOrderId,
           openPrice,
@@ -1885,8 +1994,8 @@ function registerBotTools() {
         if (args.slippage != null) body.slippage = String(args.slippage);
         if (args.condition != null) body.condition = String(args.condition);
         if (args.conditionDirection != null) {
-          const conditionDirection = asNonEmptyString(args.conditionDirection, "conditionDirection");
-          assertEnum(conditionDirection, "conditionDirection", ["1", "-1"]);
+          const conditionDirection = asNonEmptyString2(args.conditionDirection, "conditionDirection");
+          assertEnum2(conditionDirection, "conditionDirection", ["1", "-1"]);
           body.conditionDirection = conditionDirection;
         }
         return (await client.signedPost("/api/v1/bot/orders/futuresGrid/reduce", body)).data;
@@ -1913,15 +2022,15 @@ function registerBotTools() {
         if (config.readOnly) {
           throw new Error("Server is running in --read-only mode; bot cancel is disabled.");
         }
-        const buOrderId = asNonEmptyString(args.buOrderId, "buOrderId");
+        const buOrderId = asNonEmptyString2(args.buOrderId, "buOrderId");
         const body = { buOrderId };
         if (args.closeNote != null) body.closeNote = String(args.closeNote);
         if (args.closeSellModel != null) {
-          const closeSellModel = asNonEmptyString(args.closeSellModel, "closeSellModel");
-          assertEnum(closeSellModel, "closeSellModel", ["TO_QUOTE", "TO_USDT"]);
+          const closeSellModel = asNonEmptyString2(args.closeSellModel, "closeSellModel");
+          assertEnum2(closeSellModel, "closeSellModel", ["TO_QUOTE", "TO_USDT"]);
           body.closeSellModel = closeSellModel;
         }
-        if (args.immediate != null) body.immediate = asBoolean(args.immediate, "immediate");
+        if (args.immediate != null) body.immediate = asBoolean2(args.immediate, "immediate");
         if (args.closeSlippage != null) body.closeSlippage = String(args.closeSlippage);
         return (await client.signedPost("/api/v1/bot/orders/futuresGrid/cancel", body)).data;
       }
@@ -2100,27 +2209,29 @@ Examples:
   pionex orders new --symbol BTC_USDT --side BUY --type MARKET --amount 10
   pionex orders cancel --symbol BTC_USDT --order-id 123
   pionex bot get --bu-order-id <id>
-  pionex bot create --base BTC --bu-order-data-json '{"top":"110000","bottom":"90000","row":100,"grid_type":"arithmetic","openPrice":"100000","trend":"long","leverage":5,"extraMargin":"0","quoteInvestment":"100"}'
+  pionex bot create --base BTC --quote USDT --bu-order-data-json '{"top":"110000","bottom":"90000","row":100,"grid_type":"arithmetic","trend":"long","leverage":5,"quoteInvestment":"100"}'
 
 Global flags:
   --profile <name>     Profile in ~/.pionex/config.toml
   --modules <list>     Comma-separated modules (market,account,orders or all)
   --base-url <url>     Override API base URL
   --read-only          Disable write operations (orders new/cancel)
-  --dry-run            Print the tool call payload without executing (write ops only)
+  --dry-run            Print resolved futures-grid create body without executing (bot create only)
 
-Bot create defaults:
-  exchange             Defaults to pionex.v2 when missing
-  quote                Defaults to USDT when missing
-  base                 Auto-normalized to <BASE>.PERP when missing suffix
-  --key-id             Optional
-  buOrderData.top      Defaults to current price * 1.05 when missing
-  buOrderData.bottom   Defaults to current price * 0.95 when missing
-  buOrderData.row      Defaults to 10 when missing
-  buOrderData.grid_type Defaults to arithmetic when missing
-  buOrderData.leverage Defaults to 2 when missing
-  buOrderData.openPrice Optional. If omitted, it is not sent
-  buOrderData.extraMargin Defaults to "0" when missing
+Futures grid create (pionex bot create) \u2014 strict OpenAPI (same validation as MCP):
+  --base               Required; normalized to <BASE>.PERP if suffix missing
+  --quote              Required (e.g. USDT)
+  --bu-order-data-json Required JSON object \u2014 ONLY keys from CreateFuturesGridOrderData in openapi_bot.yaml
+  Optional: --copy-from, --copy-type, --copy-bot-order-id
+  buOrderData required: top, bottom, row, grid_type, trend, leverage, quoteInvestment
+  buOrderData optional (names only): extraMargin, condition, conditionDirection, lossStopType, lossStop,
+    lossStopDelay, profitStopType, profitStop, profitStopDelay, lossStopHigh, shareRatio, investCoin,
+    investmentFrom, uiInvestCoin, lossStopLimitPrice, lossStopLimitHighPrice, profitStopLimitPrice,
+    slippage, bonusId, uiExtraData, movingIndicatorType, movingIndicatorInterval, movingIndicatorParam,
+    movingTrailingUpParam, cateType, movingTop, movingBottom, enableFollowClosed
+  Unknown keys \u2192 error
+  YAML: https://github.com/pionex-official/pionex-open-api/blob/main/openapi_bot.yaml
+  Docs: https://www.pionex.com/docs/api-docs/bot-api/futures-grid
 `);
 }
 function parseJsonFlag(raw, flagName) {
@@ -2295,21 +2406,18 @@ async function runPionexCommand(argv) {
       return;
     }
     if (command === "create") {
-      const keyId = typeof flags["key-id"] === "string" ? flags["key-id"] : typeof flags.keyId === "string" ? flags.keyId : void 0;
-      const exchange = typeof flags.exchange === "string" ? flags.exchange : void 0;
       const base = typeof flags.base === "string" ? flags.base : void 0;
       const quote = typeof flags.quote === "string" ? flags.quote : void 0;
+      const exchange = typeof flags.exchange === "string" ? flags.exchange : void 0;
       const copyFrom = typeof flags["copy-from"] === "string" ? flags["copy-from"] : typeof flags.copyFrom === "string" ? flags.copyFrom : void 0;
       const copyType = typeof flags["copy-type"] === "string" ? flags["copy-type"] : typeof flags.copyType === "string" ? flags.copyType : void 0;
-      const groupId = typeof flags["group-id"] === "string" ? flags["group-id"] : typeof flags.groupId === "string" ? flags.groupId : void 0;
       const copyBotOrderId = typeof flags["copy-bot-order-id"] === "string" ? flags["copy-bot-order-id"] : typeof flags.copyBotOrderId === "string" ? flags.copyBotOrderId : void 0;
-      const lang = typeof flags.lang === "string" ? flags.lang : void 0;
-      const buOrderData = parseJsonFlag(flags["bu-order-data-json"] ?? flags.buOrderDataJson, "bu-order-data-json");
-      if (!base) {
-        throw new Error("Missing required flags: --base --bu-order-data-json");
+      const buOrderDataRaw = parseJsonFlag(flags["bu-order-data-json"] ?? flags.buOrderDataJson, "bu-order-data-json");
+      if (!base || !quote) {
+        throw new Error("Missing required flags: --base --quote --bu-order-data-json");
       }
-      const payload = { exchange, base, quote, copyFrom, copyType, groupId, copyBotOrderId, lang, buOrderData };
-      if (keyId) payload.keyId = keyId;
+      const buOrderData = parseAndValidateCreateFuturesGridBuOrderData(buOrderDataRaw);
+      const payload = { base, quote, exchange, copyFrom, copyType, copyBotOrderId, buOrderData };
       if (dryRun) {
         const out2 = await runTool("pionex_bot_create_futures_grid_order", { ...payload, __dryRun: true });
         process.stdout.write(JSON.stringify(out2.data, null, 2) + "\n");