@okx_ai/okx-trade-mcp 1.3.8-beta.5 → 1.3.8

package/dist/index.js

@@ -2102,10 +2102,60 @@ function buildAlgoConditionalCommonFields(args) {
     slOrdPx: readString(args, "slOrdPx"),
     slTriggerPxType: readString(args, "slTriggerPxType"),
     slTriggerRatio: readString(args, "slTriggerRatio"),
-    closeFraction: readString(args, "closeFraction"),
+    // NOTE: closeFraction intentionally excluded - only valid for FUTURES/SWAP
+    // conditional/oco ordTypes. Spot must not forward this field. The swap/futures
+    // handlers manage closeFraction via resolveAlgoSzOrCloseFraction() (issue #200).
     activePx: readString(args, "activePx")
   };
 }
+var CLOSE_FRACTION_VALID_ORD_TYPES = /* @__PURE__ */ new Set(["conditional", "oco"]);
+function isNonMarketOrdPx(px) {
+  return px !== void 0 && px !== "-1";
+}
+function assertCloseFractionConstraints(args, ordType, sz, closeFraction) {
+  if (!CLOSE_FRACTION_VALID_ORD_TYPES.has(ordType)) {
+    throw new ValidationError(
+      `closeFraction is only valid for ordType conditional or oco (got "${ordType}").`
+    );
+  }
+  if (closeFraction !== "1") {
+    throw new ValidationError(
+      `closeFraction must be "1" (only full-position close is supported). Got "${closeFraction}".`
+    );
+  }
+  if (sz !== void 0 && sz.length > 0) {
+    throw new ValidationError(
+      `Provide sz OR closeFraction, not both. sz="${sz}", closeFraction="${closeFraction}".`
+    );
+  }
+  if (isNonMarketOrdPx(readString(args, "tpOrdPx")) || isNonMarketOrdPx(readString(args, "slOrdPx"))) {
+    throw new ValidationError(
+      `closeFraction only applies to market TP/SL orders - tpOrdPx/slOrdPx must be "-1" (market) when provided.`
+    );
+  }
+  if (readString(args, "posSide") === "net" && args["reduceOnly"] !== true) {
+    throw new ValidationError(
+      `When closeFraction is used with posSide="net", reduceOnly must be true.`
+    );
+  }
+}
+function resolveAlgoSzOrCloseFraction(args, ordType) {
+  const sz = readString(args, "sz");
+  const closeFraction = readString(args, "closeFraction");
+  if (closeFraction !== void 0) {
+    assertCloseFractionConstraints(args, ordType, sz, closeFraction);
+    return { sz: void 0, closeFraction: "1" };
+  }
+  if (!sz || sz.length === 0) {
+    if (CLOSE_FRACTION_VALID_ORD_TYPES.has(ordType)) {
+      throw new ValidationError(
+        `sz or closeFraction is required for ordType "${ordType}".`
+      );
+    }
+    throw new ValidationError(`Missing required parameter "sz".`);
+  }
+  return { sz, closeFraction: void 0 };
+}
 function buildAttachAlgoOrds(source) {
   const tpLevels = source["tpLevels"];
   if (Array.isArray(tpLevels) && tpLevels.length > 0) {
@@ -3461,7 +3511,12 @@ function registerAlgoTradeTools() {
           },
           sz: {
             type: "string",
-            description: "Number of contracts to close (NOT USDT amount). Use market_get_instruments to get ctVal for conversion."
+            description: "Number of contracts to close (NOT USDT amount). Use market_get_instruments to get ctVal for conversion. Required unless closeFraction is provided (conditional/oco only)."
+          },
+          closeFraction: {
+            type: "string",
+            enum: ["1"],
+            description: 'Close 100% of position (full close). Use instead of sz for conditional/oco ordTypes only. Must be "1" (only full-position close is supported). When posSide=net, reduceOnly must also be true.'
           },
           tpTriggerPx: {
             type: "string",
@@ -3506,28 +3561,29 @@ function registerAlgoTradeTools() {
           },
           reduceOnly: {
             type: "boolean",
-            description: "Ensure order only reduces position"
+            description: "Ensure order only reduces position. Required when closeFraction is used with posSide=net."
           },
-          clOrdId: {
+          algoClOrdId: {
             type: "string",
-            description: "Client order ID (max 32 chars)"
+            description: "Client-assigned algo order ID (1-32 alphanumeric chars). Legacy alias clOrdId is also accepted."
           }
         },
-        required: ["instId", "tdMode", "side", "ordType", "sz"]
+        required: ["instId", "tdMode", "side", "ordType"]
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
         const reduceOnly = args.reduceOnly;
         const cxlOnClosePos = args.cxlOnClosePos;
         const ordType = requireString(args, "ordType");
-        const resolved = await resolveQuoteCcySz(
+        const szOrCf = resolveAlgoSzOrCloseFraction(args, ordType);
+        const resolved = szOrCf.sz !== void 0 ? await resolveQuoteCcySz(
           requireString(args, "instId"),
-          requireString(args, "sz"),
+          szOrCf.sz,
           readString(args, "tgtCcy"),
           "SWAP",
           context.client,
           readString(args, "tdMode")
-        );
+        ) : { sz: void 0, tgtCcy: void 0, conversionNote: void 0 };
         const base = compactObject({
           instId: requireString(args, "instId"),
           tdMode: requireString(args, "tdMode"),
@@ -3535,11 +3591,12 @@ function registerAlgoTradeTools() {
           posSide: readString(args, "posSide"),
           ordType,
           sz: resolved.sz,
+          closeFraction: szOrCf.closeFraction,
           tgtCcy: resolved.tgtCcy,
           stpMode: readString(args, "stpMode"),
           cxlOnClosePos: typeof cxlOnClosePos === "boolean" ? String(cxlOnClosePos) : void 0,
           reduceOnly: typeof reduceOnly === "boolean" ? String(reduceOnly) : void 0,
-          clOrdId: readString(args, "clOrdId"),
+          algoClOrdId: readString(args, "algoClOrdId") ?? readString(args, "clOrdId"),
           // Phase 3a+c CLI power-user flags (issue #182, CLI-only no MCP/skill exposure)
           pxAmendType: readString(args, "pxAmendType"),
           tag: context.config.sourceTag
@@ -3624,9 +3681,9 @@ function registerAlgoTradeTools() {
             type: "boolean",
             description: "Ensure order only reduces position"
           },
-          clOrdId: {
+          algoClOrdId: {
             type: "string",
-            description: "Client order ID (max 32 chars)"
+            description: "Client-assigned algo order ID (1-32 alphanumeric chars). Legacy alias clOrdId is also accepted."
           }
         },
         required: ["instId", "tdMode", "side", "sz"]
@@ -3647,7 +3704,7 @@ function registerAlgoTradeTools() {
             callBackSpread: readString(args, "callbackSpread"),
             activePx: readString(args, "activePx"),
             reduceOnly: typeof reduceOnly === "boolean" ? String(reduceOnly) : void 0,
-            clOrdId: readString(args, "clOrdId")
+            algoClOrdId: readString(args, "algoClOrdId") ?? readString(args, "clOrdId")
           }),
           privateRateLimit("swap_place_move_stop_order", 20)
         );
@@ -3828,7 +3885,12 @@ function registerFuturesAlgoTools() {
           },
           sz: {
             type: "string",
-            description: "Number of contracts (NOT USDT amount)."
+            description: "Number of contracts (NOT USDT amount). Required unless closeFraction is provided (conditional/oco only)."
+          },
+          closeFraction: {
+            type: "string",
+            enum: ["1"],
+            description: 'Close 100% of position (full close). Use instead of sz for conditional/oco ordTypes only. Must be "1" (only full-position close is supported). When posSide=net, reduceOnly must also be true.'
           },
           tpTriggerPx: {
             type: "string",
@@ -3873,28 +3935,29 @@ function registerFuturesAlgoTools() {
           },
           reduceOnly: {
             type: "boolean",
-            description: "Ensure order only reduces position"
+            description: "Ensure order only reduces position. Required when closeFraction is used with posSide=net."
           },
-          clOrdId: {
+          algoClOrdId: {
             type: "string",
-            description: "Client order ID (max 32 chars)"
+            description: "Client-assigned algo order ID (1-32 alphanumeric chars). Legacy alias clOrdId is also accepted."
           }
         },
-        required: ["instId", "tdMode", "side", "ordType", "sz"]
+        required: ["instId", "tdMode", "side", "ordType"]
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
         const reduceOnly = args.reduceOnly;
         const cxlOnClosePos = args.cxlOnClosePos;
         const ordType = requireString(args, "ordType");
-        const resolved = await resolveQuoteCcySz(
+        const szOrCf = resolveAlgoSzOrCloseFraction(args, ordType);
+        const resolved = szOrCf.sz !== void 0 ? await resolveQuoteCcySz(
           requireString(args, "instId"),
-          requireString(args, "sz"),
+          szOrCf.sz,
           readString(args, "tgtCcy"),
           "FUTURES",
           context.client,
           readString(args, "tdMode")
-        );
+        ) : { sz: void 0, tgtCcy: void 0, conversionNote: void 0 };
         const base = compactObject({
           instId: requireString(args, "instId"),
           tdMode: requireString(args, "tdMode"),
@@ -3902,11 +3965,12 @@ function registerFuturesAlgoTools() {
           posSide: readString(args, "posSide"),
           ordType,
           sz: resolved.sz,
+          closeFraction: szOrCf.closeFraction,
           tgtCcy: resolved.tgtCcy,
           stpMode: readString(args, "stpMode"),
           cxlOnClosePos: typeof cxlOnClosePos === "boolean" ? String(cxlOnClosePos) : void 0,
           reduceOnly: typeof reduceOnly === "boolean" ? String(reduceOnly) : void 0,
-          clOrdId: readString(args, "clOrdId"),
+          algoClOrdId: readString(args, "algoClOrdId") ?? readString(args, "clOrdId"),
           // Phase 3a+c CLI power-user flags (issue #182, CLI-only no MCP/skill exposure)
           pxAmendType: readString(args, "pxAmendType"),
           tag: context.config.sourceTag
@@ -3991,9 +4055,9 @@ function registerFuturesAlgoTools() {
             type: "boolean",
             description: "Ensure order only reduces position"
           },
-          clOrdId: {
+          algoClOrdId: {
             type: "string",
-            description: "Client order ID (max 32 chars)"
+            description: "Client-assigned algo order ID (1-32 alphanumeric chars). Legacy alias clOrdId is also accepted."
           }
         },
         required: ["instId", "tdMode", "side", "sz"]
@@ -4014,7 +4078,7 @@ function registerFuturesAlgoTools() {
             callBackSpread: readString(args, "callbackSpread"),
             activePx: readString(args, "activePx"),
             reduceOnly: typeof reduceOnly === "boolean" ? String(reduceOnly) : void 0,
-            clOrdId: readString(args, "clOrdId")
+            algoClOrdId: readString(args, "algoClOrdId") ?? readString(args, "clOrdId")
           }),
           privateRateLimit("futures_place_move_stop_order", 20)
         );
@@ -10492,9 +10556,9 @@ function registerOptionAlgoTools() {
             type: "boolean",
             description: "Ensure order only reduces position"
           },
-          clOrdId: {
+          algoClOrdId: {
             type: "string",
-            description: "Client order ID (max 32 chars)"
+            description: "Client-assigned algo order ID (1-32 alphanumeric chars). Legacy alias clOrdId is also accepted."
           }
         },
         required: ["instId", "tdMode", "side", "ordType", "sz"]
@@ -10526,7 +10590,7 @@ function registerOptionAlgoTools() {
             slOrdPx: readString(args, "slOrdPx"),
             slTriggerPxType: readString(args, "slTriggerPxType"),
             reduceOnly: reduceOnly !== void 0 ? String(reduceOnly) : void 0,
-            clOrdId: readString(args, "clOrdId"),
+            algoClOrdId: readString(args, "algoClOrdId") ?? readString(args, "clOrdId"),
             tag: context.config.sourceTag
           }),
           privateRateLimit("option_place_algo_order", 20)
@@ -11434,6 +11498,10 @@ function registerSpotTradeTools() {
           },
           slTriggerPxType: SL_TRIGGER_PX_TYPE_SCHEMA,
           stpMode: STP_MODE_SCHEMA,
+          algoClOrdId: {
+            type: "string",
+            description: "Client-assigned algo order ID (1-32 alphanumeric chars). Legacy alias clOrdId is also accepted."
+          },
           tgtCcy: {
             type: "string",
             enum: ["base_ccy", "quote_ccy"],
@@ -11468,6 +11536,7 @@ function registerSpotTradeTools() {
           sz: requireString(args, "sz"),
           tgtCcy: readString(args, "tgtCcy"),
           stpMode: readString(args, "stpMode"),
+          algoClOrdId: readString(args, "algoClOrdId") ?? readString(args, "clOrdId"),
           // Phase 3a+c CLI power-user flags (issue #182, CLI-only no MCP/skill exposure)
           pxAmendType: readString(args, "pxAmendType"),
           tag: context.config.sourceTag
@@ -12646,7 +12715,7 @@ var _require = createRequire(import.meta.url);
 var pkg = _require("../package.json");
 var SERVER_NAME = "okx-trade-mcp";
 var SERVER_VERSION = pkg.version;
-var GIT_HASH = true ? "884b3632" : "dev";
+var GIT_HASH = true ? "d21e140e" : "dev";
 
 // src/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";