@pionex/pionex-trade-mcp 0.2.37 → 0.2.39

package/README.md

@@ -39,6 +39,7 @@ Credentials are read from `~/.pionex/config.toml` when the server starts; the cl
 - **Account** (auth): `pionex_account_get_balance`
 - **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_get_fills_by_order_id`, `pionex_orders_cancel_all_orders`
 - **Bot / Futures Grid** (auth): `pionex_bot_futures_grid_get_order`, `pionex_bot_futures_grid_create`, `pionex_bot_futures_grid_adjust_params`, `pionex_bot_futures_grid_reduce`, `pionex_bot_futures_grid_cancel`
+- **Bot / Spot Grid** (auth): `pionex_bot_spot_grid_get_order`, `pionex_bot_spot_grid_get_ai_strategy`, `pionex_bot_spot_grid_create`, `pionex_bot_spot_grid_adjust_params`, `pionex_bot_spot_grid_invest_in`, `pionex_bot_spot_grid_cancel`, `pionex_bot_spot_grid_profit`
 
 ### `pionex_bot_futures_grid_create` (strict OpenAPI)
 

package/dist/index.js

@@ -1536,6 +1536,24 @@ var createFuturesGridCreateToolInputSchema = {
     __dryRun: { type: "boolean", description: "Internal: when true, return resolved body without POST" }
   }
 };
+var CREATE_SPOT_GRID_ORDER_DATA_KEYS = [
+  "top",
+  "bottom",
+  "row",
+  "gridType",
+  "quoteTotalInvestment",
+  "lossStopType",
+  "lossStop",
+  "lossStopDelay",
+  "profitStopType",
+  "profitStop",
+  "profitStopDelay",
+  "condition",
+  "conditionDirection",
+  "slippage",
+  "closeSellModel"
+];
+var ORDER_DATA_KEY_SET2 = new Set(CREATE_SPOT_GRID_ORDER_DATA_KEYS);
 function asNonEmptyString2(value, field) {
   if (typeof value !== "string" || value.trim().length === 0) {
     throw new Error(`Invalid "${field}": expected non-empty string.`);
@@ -1560,13 +1578,181 @@ function asPositiveInteger2(value, field) {
   }
   return n;
 }
+function asNonNegativeInteger(value, field) {
+  const n = asFiniteNumber2(value, field);
+  if (n < 0 || !Number.isInteger(n)) {
+    throw new Error(`Invalid "${field}": expected non-negative integer.`);
+  }
+  return n;
+}
+function assertEnum2(value, field, allowed) {
+  if (!allowed.includes(value)) {
+    throw new Error(`Invalid "${field}": expected one of ${allowed.join(", ")}.`);
+  }
+}
+function asPositiveDecimalStringLoose2(value, field) {
+  if (typeof value === "number" && Number.isFinite(value) && value > 0) {
+    return String(value);
+  }
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new Error(`Invalid "${field}": expected positive decimal string.`);
+  }
+  const s = value.trim();
+  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 asOptionalString2(value, field) {
+  if (typeof value !== "string") {
+    throw new Error(`Invalid "${field}": expected string.`);
+  }
+  return value;
+}
+function parseAndValidateCreateSpotGridBuOrderData(raw) {
+  const data = { ...raw };
+  for (const k of Object.keys(data)) {
+    if (!ORDER_DATA_KEY_SET2.has(k)) {
+      throw new Error(`Unknown buOrderData property "${k}". Allowed keys: ${CREATE_SPOT_GRID_ORDER_DATA_KEYS.join(", ")}.`);
+    }
+  }
+  const top = asPositiveDecimalStringLoose2(data.top, "buOrderData.top");
+  const bottom = asPositiveDecimalStringLoose2(data.bottom, "buOrderData.bottom");
+  if (Number(top) <= Number(bottom)) {
+    throw new Error('Invalid "buOrderData.top": expected top > bottom.');
+  }
+  const row = asPositiveInteger2(data.row, "buOrderData.row");
+  if (row < 2 || row > 200) {
+    throw new Error('Invalid "buOrderData.row": expected integer between 2 and 200.');
+  }
+  const gridType = asNonEmptyString2(data.gridType, "buOrderData.gridType");
+  assertEnum2(gridType, "buOrderData.gridType", ["arithmetic", "geometric"]);
+  const quoteTotalInvestment = asPositiveDecimalStringLoose2(data.quoteTotalInvestment, "buOrderData.quoteTotalInvestment");
+  const out = {
+    top,
+    bottom,
+    row,
+    gridType,
+    quoteTotalInvestment
+  };
+  if (data.lossStopType != null) {
+    const v = asNonEmptyString2(data.lossStopType, "buOrderData.lossStopType");
+    assertEnum2(v, "buOrderData.lossStopType", ["price", "profit_amount", "profit_ratio"]);
+    out.lossStopType = v;
+  }
+  if (data.lossStop != null) out.lossStop = asOptionalString2(data.lossStop, "buOrderData.lossStop");
+  if (data.lossStopDelay != null) out.lossStopDelay = asNonNegativeInteger(data.lossStopDelay, "buOrderData.lossStopDelay");
+  if (data.profitStopType != null) {
+    const v = asNonEmptyString2(data.profitStopType, "buOrderData.profitStopType");
+    assertEnum2(v, "buOrderData.profitStopType", ["price", "profit_amount", "profit_ratio"]);
+    out.profitStopType = v;
+  }
+  if (data.profitStop != null) out.profitStop = asOptionalString2(data.profitStop, "buOrderData.profitStop");
+  if (data.profitStopDelay != null) out.profitStopDelay = asNonNegativeInteger(data.profitStopDelay, "buOrderData.profitStopDelay");
+  if (data.condition != null) out.condition = asOptionalString2(data.condition, "buOrderData.condition");
+  if (data.conditionDirection != null) {
+    const v = asNonEmptyString2(data.conditionDirection, "buOrderData.conditionDirection");
+    assertEnum2(v, "buOrderData.conditionDirection", ["-1", "1"]);
+    out.conditionDirection = v;
+  }
+  if (data.slippage != null) out.slippage = asOptionalString2(data.slippage, "buOrderData.slippage");
+  if (data.closeSellModel != null) {
+    const v = asNonEmptyString2(data.closeSellModel, "buOrderData.closeSellModel");
+    assertEnum2(v, "buOrderData.closeSellModel", ["NOT_SELL", "TO_QUOTE", "TO_USDT"]);
+    out.closeSellModel = v;
+  }
+  return out;
+}
+var createSpotGridOrderDataJsonSchema = {
+  type: "object",
+  additionalProperties: false,
+  description: "CreateSpotGridOrderData (openapi_bot.yaml PR #7). Required: top, bottom, row, gridType, quoteTotalInvestment.",
+  required: ["top", "bottom", "row", "gridType", "quoteTotalInvestment"],
+  properties: {
+    top: { type: "string", description: "Grid upper price" },
+    bottom: { type: "string", description: "Grid lower price" },
+    row: { type: "number", description: "Number of grid levels (2\u2013200)" },
+    gridType: {
+      type: "string",
+      enum: ["arithmetic", "geometric"],
+      description: "Grid spacing: arithmetic (equal difference) or geometric (equal ratio)"
+    },
+    quoteTotalInvestment: { type: "string", description: "Total quote currency investment amount" },
+    lossStopType: {
+      type: "string",
+      enum: ["price", "profit_amount", "profit_ratio"],
+      description: "Stop loss type"
+    },
+    lossStop: { type: "string", description: "Stop loss threshold value" },
+    lossStopDelay: { type: "number", description: "Seconds before executing stop loss (0=immediate)" },
+    profitStopType: {
+      type: "string",
+      enum: ["price", "profit_amount", "profit_ratio"],
+      description: "Take profit type"
+    },
+    profitStop: { type: "string", description: "Take profit threshold value" },
+    profitStopDelay: { type: "number", description: "Seconds before executing take profit (0=immediate)" },
+    condition: { type: "string", description: "Trigger price for conditional start" },
+    conditionDirection: {
+      type: "string",
+      enum: ["-1", "1"],
+      description: 'Trigger direction: "-1" drop below, "1" rise above'
+    },
+    slippage: { type: "string", description: "Slippage tolerance e.g. 0.01 = 1%" },
+    closeSellModel: {
+      type: "string",
+      enum: ["NOT_SELL", "TO_QUOTE", "TO_USDT"],
+      description: "Close sell model (default: NOT_SELL)"
+    }
+  }
+};
+var createSpotGridCreateToolInputSchema = {
+  type: "object",
+  additionalProperties: false,
+  required: ["base", "quote", "buOrderData"],
+  properties: {
+    base: { type: "string", description: "Base currency (e.g. BTC)" },
+    quote: { type: "string", description: "Quote currency (e.g. USDT)" },
+    note: { type: "string", description: "Optional order note" },
+    buOrderData: createSpotGridOrderDataJsonSchema,
+    __dryRun: { type: "boolean", description: "Internal: when true, return resolved body without POST" }
+  }
+};
+function asNonEmptyString3(value, field) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new Error(`Invalid "${field}": expected non-empty string.`);
+  }
+  return value.trim();
+}
+function asFiniteNumber3(value, field) {
+  if (typeof value !== "number" || !Number.isFinite(value)) {
+    throw new Error(`Invalid "${field}": expected finite number.`);
+  }
+  return value;
+}
+function asPositiveNumber3(value, field) {
+  const n = asFiniteNumber3(value, field);
+  if (n <= 0) throw new Error(`Invalid "${field}": expected number > 0.`);
+  return n;
+}
+function asPositiveInteger3(value, field) {
+  const n = asPositiveNumber3(value, field);
+  if (!Number.isInteger(n)) {
+    throw new Error(`Invalid "${field}": expected positive integer.`);
+  }
+  return n;
+}
 function asBoolean2(value, field) {
   if (typeof value !== "boolean") {
     throw new Error(`Invalid "${field}": expected boolean.`);
   }
   return value;
 }
-function assertEnum2(value, field, allowed) {
+function assertEnum3(value, field, allowed) {
   if (!allowed.includes(value)) {
     throw new Error(`Invalid "${field}": expected one of ${allowed.join(", ")}.`);
   }
@@ -1578,7 +1764,7 @@ function asObject(value, field) {
   return value;
 }
 function asPositiveDecimalString2(value, field) {
-  const s = asNonEmptyString2(value, field);
+  const s = asNonEmptyString3(value, field);
   if (!/^\d+(\.\d+)?$/.test(s)) {
     throw new Error(`Invalid "${field}": expected positive decimal string.`);
   }
@@ -1624,9 +1810,9 @@ function registerBotTools() {
         if (config.readOnly) {
           throw new Error("Server is running in --read-only mode; bot futures_grid create is disabled.");
         }
-        const rawBase = asNonEmptyString2(args.base, "base");
+        const rawBase = asNonEmptyString3(args.base, "base");
         const base = normalizePerpBase(rawBase);
-        const quote = asNonEmptyString2(args.quote, "quote");
+        const quote = asNonEmptyString3(args.quote, "quote");
         const buOrderDataOut = parseAndValidateCreateFuturesGridBuOrderData(asObject(args.buOrderData, "buOrderData"));
         const row = buOrderDataOut.row;
         const gridType = buOrderDataOut.grid_type;
@@ -1686,12 +1872,12 @@ function registerBotTools() {
         if (config.readOnly) {
           throw new Error("Server is running in --read-only mode; bot futures_grid adjust_params is disabled.");
         }
-        const buOrderId = asNonEmptyString2(args.buOrderId, "buOrderId");
-        const type = asNonEmptyString2(args.type, "type");
-        assertEnum2(type, "type", ["invest_in", "adjust_params", "invest_in_trigger"]);
+        const buOrderId = asNonEmptyString3(args.buOrderId, "buOrderId");
+        const type = asNonEmptyString3(args.type, "type");
+        assertEnum3(type, "type", ["invest_in", "adjust_params", "invest_in_trigger"]);
         const extraMargin = asBoolean2(args.extraMargin, "extraMargin");
         if (type === "invest_in" && args.quoteInvestment != null) {
-          asPositiveNumber2(args.quoteInvestment, "quoteInvestment");
+          asPositiveNumber3(args.quoteInvestment, "quoteInvestment");
         }
         if (type === "adjust_params") {
           const bottom = asPositiveDecimalString2(args.bottom, "bottom");
@@ -1699,35 +1885,35 @@ function registerBotTools() {
           if (Number(top) <= Number(bottom)) {
             throw new Error('Invalid "top": expected top > bottom.');
           }
-          asPositiveInteger2(args.row, "row");
+          asPositiveInteger3(args.row, "row");
         }
         if (type === "invest_in_trigger") {
           asPositiveDecimalString2(args.condition, "condition");
-          const conditionDirection = asNonEmptyString2(args.conditionDirection, "conditionDirection");
-          assertEnum2(conditionDirection, "conditionDirection", ["1", "-1"]);
+          const conditionDirection = asNonEmptyString3(args.conditionDirection, "conditionDirection");
+          assertEnum3(conditionDirection, "conditionDirection", ["1", "-1"]);
         }
         const body = {
           buOrderId,
           type,
           extraMargin
         };
-        if (args.quoteInvestment != null) body.quoteInvestment = asFiniteNumber2(args.quoteInvestment, "quoteInvestment");
+        if (args.quoteInvestment != null) body.quoteInvestment = asFiniteNumber3(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.row != null) body.row = asPositiveInteger3(args.row, "row");
+        if (args.extraMarginAmount != null) body.extraMarginAmount = asFiniteNumber3(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 = asNonEmptyString2(args.investmentFrom, "investmentFrom");
-          assertEnum2(investmentFrom, "investmentFrom", ["USER", "LOCK_ACTIVITY"]);
+          const investmentFrom = asNonEmptyString3(args.investmentFrom, "investmentFrom");
+          assertEnum3(investmentFrom, "investmentFrom", ["USER", "LOCK_ACTIVITY"]);
           body.investmentFrom = investmentFrom;
         }
         if (args.condition != null) body.condition = asPositiveDecimalString2(args.condition, "condition");
         if (args.conditionDirection != null) {
-          const conditionDirection = asNonEmptyString2(args.conditionDirection, "conditionDirection");
-          assertEnum2(conditionDirection, "conditionDirection", ["1", "-1"]);
+          const conditionDirection = asNonEmptyString3(args.conditionDirection, "conditionDirection");
+          assertEnum3(conditionDirection, "conditionDirection", ["1", "-1"]);
           body.conditionDirection = conditionDirection;
         }
         if (args.slippage != null) body.slippage = String(args.slippage);
@@ -1756,8 +1942,8 @@ function registerBotTools() {
         if (config.readOnly) {
           throw new Error("Server is running in --read-only mode; bot futures_grid reduce is disabled.");
         }
-        const buOrderId = asNonEmptyString2(args.buOrderId, "buOrderId");
-        const reduceNum = asPositiveInteger2(args.reduceNum, "reduceNum");
+        const buOrderId = asNonEmptyString3(args.buOrderId, "buOrderId");
+        const reduceNum = asPositiveInteger3(args.reduceNum, "reduceNum");
         const body = {
           buOrderId,
           reduceNum
@@ -1765,8 +1951,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 = asNonEmptyString2(args.conditionDirection, "conditionDirection");
-          assertEnum2(conditionDirection, "conditionDirection", ["1", "-1"]);
+          const conditionDirection = asNonEmptyString3(args.conditionDirection, "conditionDirection");
+          assertEnum3(conditionDirection, "conditionDirection", ["1", "-1"]);
           body.conditionDirection = conditionDirection;
         }
         return (await client.signedPost("/api/v1/bot/orders/futuresGrid/reduce", body)).data;
@@ -1830,18 +2016,188 @@ function registerBotTools() {
         if (config.readOnly) {
           throw new Error("Server is running in --read-only mode; bot futures_grid cancel is disabled.");
         }
-        const buOrderId = asNonEmptyString2(args.buOrderId, "buOrderId");
+        const buOrderId = asNonEmptyString3(args.buOrderId, "buOrderId");
         const body = { buOrderId };
         if (args.closeNote != null) body.closeNote = String(args.closeNote);
         if (args.closeSellModel != null) {
-          const closeSellModel = asNonEmptyString2(args.closeSellModel, "closeSellModel");
-          assertEnum2(closeSellModel, "closeSellModel", ["TO_QUOTE", "TO_USDT"]);
+          const closeSellModel = asNonEmptyString3(args.closeSellModel, "closeSellModel");
+          assertEnum3(closeSellModel, "closeSellModel", ["TO_QUOTE", "TO_USDT"]);
           body.closeSellModel = closeSellModel;
         }
         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;
       }
+    },
+    {
+      name: "pionex_bot_spot_grid_get_order",
+      module: "bot",
+      isWrite: false,
+      description: "Get one spot grid bot order by buOrderId.",
+      inputSchema: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          buOrderId: { type: "string", description: "Spot grid bot order id." }
+        },
+        required: ["buOrderId"]
+      },
+      async handler(args, { client }) {
+        const buOrderId = asNonEmptyString3(args.buOrderId, "buOrderId");
+        const q = { buOrderId };
+        return (await client.signedGet("/api/v1/bot/orders/spotGrid/order", q)).data;
+      }
+    },
+    {
+      name: "pionex_bot_spot_grid_get_ai_strategy",
+      module: "bot",
+      isWrite: false,
+      description: "Retrieve AI-recommended spot grid strategy parameters for a trading pair.",
+      inputSchema: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          base: { type: "string", description: "Base currency (e.g. BTC)" },
+          quote: { type: "string", description: "Quote currency (e.g. USDT)" }
+        },
+        required: ["base", "quote"]
+      },
+      async handler(args, { client }) {
+        const base = asNonEmptyString3(args.base, "base");
+        const quote = asNonEmptyString3(args.quote, "quote");
+        return (await client.signedGet("/api/v1/bot/orders/spotGrid/aiStrategy", { base, quote })).data;
+      }
+    },
+    {
+      name: "pionex_bot_spot_grid_create",
+      module: "bot",
+      isWrite: true,
+      description: "Create a spot grid bot order (openapi_bot.yaml CreateSpotGridRequest / CreateSpotGridOrderData). Required: base, quote, buOrderData. Optional: note. buOrderData required: top, bottom, row, gridType, quoteTotalInvestment; unknown keys rejected.",
+      inputSchema: createSpotGridCreateToolInputSchema,
+      async handler(args, { client, config }) {
+        if (config.readOnly) {
+          throw new Error("Server is running in --read-only mode; bot spot_grid create is disabled.");
+        }
+        const base = asNonEmptyString3(args.base, "base");
+        const quote = asNonEmptyString3(args.quote, "quote");
+        const buOrderDataOut = parseAndValidateCreateSpotGridBuOrderData(asObject(args.buOrderData, "buOrderData"));
+        const body = { base, quote, buOrderData: buOrderDataOut };
+        if (args.note != null) body.note = String(args.note);
+        if (args.__dryRun === true) {
+          return {
+            dryRun: true,
+            note: "No order was sent. Body matches openapi_bot.yaml CreateSpotGridRequest.",
+            resolvedBody: body
+          };
+        }
+        return (await client.signedPost("/api/v1/bot/orders/spotGrid/create", body)).data;
+      }
+    },
+    {
+      name: "pionex_bot_spot_grid_adjust_params",
+      module: "bot",
+      isWrite: true,
+      description: "Adjust spot grid bot range or investment parameters.",
+      inputSchema: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          buOrderId: { type: "string" },
+          top: { type: "string", description: "New upper price" },
+          bottom: { type: "string", description: "New lower price" },
+          row: { type: "number", description: "New number of grid levels" },
+          quoteInvest: { type: "string", description: "Additional quote investment amount" }
+        },
+        required: ["buOrderId"]
+      },
+      async handler(args, { client, config }) {
+        if (config.readOnly) {
+          throw new Error("Server is running in --read-only mode; bot spot_grid adjust_params is disabled.");
+        }
+        const buOrderId = asNonEmptyString3(args.buOrderId, "buOrderId");
+        const body = { buOrderId };
+        if (args.top != null) body.top = asPositiveDecimalString2(args.top, "top");
+        if (args.bottom != null) body.bottom = asPositiveDecimalString2(args.bottom, "bottom");
+        if (args.row != null) body.row = asPositiveInteger3(args.row, "row");
+        if (args.quoteInvest != null) body.quoteInvest = asPositiveDecimalString2(args.quoteInvest, "quoteInvest");
+        return (await client.signedPost("/api/v1/bot/orders/spotGrid/adjustParams", body)).data;
+      }
+    },
+    {
+      name: "pionex_bot_spot_grid_invest_in",
+      module: "bot",
+      isWrite: true,
+      description: "Add additional quote investment to a running spot grid bot.",
+      inputSchema: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          buOrderId: { type: "string" },
+          quoteInvest: { type: "string", description: "Quote amount to invest" }
+        },
+        required: ["buOrderId", "quoteInvest"]
+      },
+      async handler(args, { client, config }) {
+        if (config.readOnly) {
+          throw new Error("Server is running in --read-only mode; bot spot_grid invest_in is disabled.");
+        }
+        const buOrderId = asNonEmptyString3(args.buOrderId, "buOrderId");
+        const quoteInvest = asPositiveDecimalString2(args.quoteInvest, "quoteInvest");
+        return (await client.signedPost("/api/v1/bot/orders/spotGrid/investIn", { buOrderId, quoteInvest })).data;
+      }
+    },
+    {
+      name: "pionex_bot_spot_grid_cancel",
+      module: "bot",
+      isWrite: true,
+      description: "Cancel and close a spot grid bot order.",
+      inputSchema: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          buOrderId: { type: "string" },
+          closeSellModel: { type: "string", enum: ["NOT_SELL", "TO_QUOTE", "TO_USDT"] },
+          slippage: { type: "string" }
+        },
+        required: ["buOrderId"]
+      },
+      async handler(args, { client, config }) {
+        if (config.readOnly) {
+          throw new Error("Server is running in --read-only mode; bot spot_grid cancel is disabled.");
+        }
+        const buOrderId = asNonEmptyString3(args.buOrderId, "buOrderId");
+        const body = { buOrderId };
+        if (args.closeSellModel != null) {
+          const closeSellModel = asNonEmptyString3(args.closeSellModel, "closeSellModel");
+          assertEnum3(closeSellModel, "closeSellModel", ["NOT_SELL", "TO_QUOTE", "TO_USDT"]);
+          body.closeSellModel = closeSellModel;
+        }
+        if (args.slippage != null) body.slippage = String(args.slippage);
+        return (await client.signedPost("/api/v1/bot/orders/spotGrid/cancel", body)).data;
+      }
+    },
+    {
+      name: "pionex_bot_spot_grid_profit",
+      module: "bot",
+      isWrite: true,
+      description: "Extract accumulated grid profit from a spot grid bot order.",
+      inputSchema: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          buOrderId: { type: "string" },
+          amount: { type: "string", description: "Amount of profit to extract" }
+        },
+        required: ["buOrderId", "amount"]
+      },
+      async handler(args, { client, config }) {
+        if (config.readOnly) {
+          throw new Error("Server is running in --read-only mode; bot spot_grid profit is disabled.");
+        }
+        const buOrderId = asNonEmptyString3(args.buOrderId, "buOrderId");
+        const amount = asPositiveDecimalString2(args.amount, "amount");
+        return (await client.signedPost("/api/v1/bot/orders/spotGrid/profit", { buOrderId, amount })).data;
+      }
     }
   ];
 }