@okx_ai/okx-trade-cli 1.3.8-beta.6 → 1.3.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OKX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.js

@@ -2277,10 +2277,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) {
@@ -3714,7 +3764,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",
@@ -3759,28 +3814,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"),
@@ -3788,11 +3844,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
@@ -3877,9 +3934,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"]
@@ -3900,7 +3957,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)
         );
@@ -4081,7 +4138,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",
@@ -4126,28 +4188,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"),
@@ -4155,11 +4218,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
@@ -4244,9 +4308,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"]
@@ -4267,7 +4331,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)
         );
@@ -11145,9 +11209,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"]
@@ -11179,7 +11243,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)
@@ -12087,6 +12151,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"],
@@ -12121,6 +12189,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
@@ -14849,7 +14918,7 @@ async function cmdDiagnoseMcp(options = {}) {
 
 // src/commands/diagnose.ts
 var CLI_VERSION = readCliVersion();
-var GIT_HASH = true ? "e2de3b7e" : "dev";
+var GIT_HASH = true ? "d21e140e" : "dev";
 function maskKey2(key) {
   if (!key) return "(not set)";
   if (key.length <= 8) return "****";
@@ -21738,7 +21807,7 @@ async function cmdEventCancel(run, opts) {
 // src/index.ts
 var _require3 = createRequire3(import.meta.url);
 var CLI_VERSION2 = _require3("../package.json").version;
-var GIT_HASH2 = true ? "e2de3b7e" : "dev";
+var GIT_HASH2 = true ? "d21e140e" : "dev";
 function handlePilotCommand(action, json, force, binaryPath) {
   if (action === "status") return cmdPilotStatus(json, binaryPath);
   if (action === "install") return cmdPilotInstall(json, binaryPath);