@pionex/pionex-trade-mcp 0.2.22 → 0.2.24

package/README.md

@@ -40,14 +40,33 @@ Credentials are read from `~/.pionex/config.toml` when the server starts; the cl
 - **Orders** (auth): `pionex_orders_new_order`, `pionex_orders_get_order`, `pionex_orders_get_order_by_client_order_id`, `pionex_orders_get_open_orders`, `pionex_orders_get_all_orders`, `pionex_orders_cancel_order`, `pionex_orders_get_fills`, `pionex_orders_cancel_all_orders`
 - **Bot / Futures Grid** (auth): `pionex_bot_get_futures_grid_order`, `pionex_bot_create_futures_grid_order`, `pionex_bot_adjust_futures_grid_params`, `pionex_bot_reduce_futures_grid_position`, `pionex_bot_cancel_futures_grid_order`
 
-For `pionex_bot_create_futures_grid_order`:
-- `keyId` is optional.
-- `exchange` defaults to `pionex.v2` if missing.
-- `quote` defaults to `USDT` if missing.
-- `base` is normalized to `<BASE>.PERP` when the suffix is missing.
-- If `buOrderData.top`/`bottom` are missing, defaults are computed from current market price (`+5%`/`-5%`).
-- `buOrderData.openPrice` is optional; if missing, it is not sent.
-- If `buOrderData.row` is missing, default is `10`.
-- If `buOrderData.grid_type` is missing, default is `arithmetic`.
-- If `buOrderData.leverage` is missing, default is `2`.
-- If `buOrderData.extraMargin` is missing, default is `"0"`.
+### `pionex_bot_create_futures_grid_order` (strict OpenAPI)
+
+Source: [openapi_bot.yaml](https://github.com/pionex-official/pionex-open-api/blob/main/openapi_bot.yaml) — `CreateFuturesGridRequest` / `CreateFuturesGridOrderData`.
+
+Implementation (JSON Schema + runtime validation): `@pionex-ai/core` → `schemas/futures-grid-create.ts` (exported as `createFuturesGridCreateToolInputSchema`, `parseAndValidateCreateFuturesGridBuOrderData`).
+
+**Tool arguments = `CreateFuturesGridRequest` (+ internal `__dryRun` optional)**
+
+| Field | Required | OpenAPI |
+|-------|----------|---------|
+| `base` | yes | yes |
+| `quote` | yes | yes |
+| `buOrderData` | yes | yes |
+| `copyFrom` | no | no |
+| `copyType` | no | no |
+| `copyBotOrderId` | no | no |
+| `__dryRun` | no | internal (CLI): preview body without POST |
+
+**`buOrderData` = `CreateFuturesGridOrderData` — only these keys allowed** (`additionalProperties: false` in schema; unknown keys rejected at runtime).
+
+**Required in `buOrderData`:** `top`, `bottom`, `row`, `grid_type`, `trend`, `leverage`, `quoteInvestment`
+
+**Optional in `buOrderData` (if present, types must match YAML):**  
+`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`
+
+**Not in create schema / stripped:** `openPrice`, `keyId` (if sent, removed before validation; unknown keys then error).
+
+**Handler:** `base` is normalized to `*.PERP` when the futures suffix is missing.
+
+Docs: [Futures Grid API](https://www.pionex.com/docs/api-docs/bot-api/futures-grid)

package/dist/index.js

@@ -1213,6 +1213,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.`);
@@ -1248,12 +1286,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)) {
@@ -1265,6 +1297,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)) {
@@ -1276,50 +1314,235 @@ 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 maybePositiveDecimalString(value) {
-  if (typeof value === "string" && /^\d+(\.\d+)?$/.test(value)) {
-    const n = Number(value);
-    if (Number.isFinite(n) && n > 0) return value;
+function asOptionalNonNegativeNumber(value, field) {
+  const n = asFiniteNumber(value, field);
+  if (n < 0) throw new Error(`Invalid "${field}": expected number >= 0.`);
+  return n;
+}
+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(", ")}.`);
+    }
   }
-  if (typeof value === "number" && Number.isFinite(value) && value > 0) {
-    return toTrimmedDecimal(value);
+  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 leverage2 = asPositiveNumber(data.leverage, "buOrderData.leverage");
+  const quoteInvestment = asPositiveDecimalStringLoose(data.quoteInvestment, "buOrderData.quoteInvestment");
+  const out = {
+    top,
+    bottom,
+    row,
+    grid_type: gridType,
+    trend,
+    leverage: leverage2,
+    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;
+}
+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" }
   }
-  return void 0;
+};
+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)" },
+    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 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 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.`);
   }
-  return extracted;
+  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 [
@@ -1348,113 +1571,35 @@ 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; openPrice/keyId stripped if present.",
+      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 = Number(await getCurrentSymbolPrice(client, symbol));
-          } catch {
-            currentPrice = void 0;
-          }
-        }
-        if (needsTickerForTopBottom && (currentPrice == null || !Number.isFinite(currentPrice) || currentPrice <= 0)) {
-          throw new Error(`Unable to infer current market price for ${symbol} from ticker response. Please provide buOrderData.top and buOrderData.bottom explicitly.`);
-        }
-        const top = asPositiveDecimalString(
-          buOrderData.top ?? toTrimmedDecimal(currentPrice * 1.05),
-          "buOrderData.top"
-        );
-        if (buOrderData.top == null) defaultsApplied.top = top;
-        const bottom = asPositiveDecimalString(
-          buOrderData.bottom ?? toTrimmedDecimal(currentPrice * 0.95),
-          "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 buOrderDataOut = parseAndValidateCreateFuturesGridBuOrderData(asObject(args.buOrderData, "buOrderData"));
+        const row = buOrderDataOut.row;
+        const gridType = buOrderDataOut.grid_type;
         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 (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) {
           return {
             dryRun: true,
-            note: "No order was sent. This is the resolved request body after applying defaults.",
-            marketSymbol: symbol,
-            marketPriceUsed: currentPrice == null ? void 0 : toTrimmedDecimal(currentPrice),
-            defaultsApplied,
+            note: "No order was sent. Body matches openapi_bot.yaml CreateFuturesGridRequest (no keyId/openPrice/exchange; groupId/lang not in create schema).",
+            resolvedParams: {
+              row,
+              grid_type: gridType,
+              leverage
+            },
             resolvedBody: body
           };
         }
@@ -1494,26 +1639,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,
@@ -1521,23 +1666,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);
@@ -1567,9 +1712,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,
@@ -1578,8 +1723,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;
@@ -1606,15 +1751,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;
       }