@okx_ai/okx-trade-cli 1.2.8 → 1.2.9-beta.2

package/dist/index.js

@@ -2191,6 +2191,59 @@ function registerAccountTools() {
     }
   ];
 }
+async function resolveQuoteCcySz(instId, sz, tgtCcy, instType, client) {
+  if (tgtCcy !== "quote_ccy") {
+    return { sz, tgtCcy, conversionNote: void 0 };
+  }
+  const [instrumentsRes, tickerRes] = await Promise.all([
+    client.publicGet("/api/v5/public/instruments", {
+      instType,
+      instId
+    }),
+    client.publicGet("/api/v5/market/ticker", { instId })
+  ]);
+  const instruments = Array.isArray(instrumentsRes.data) ? instrumentsRes.data : [];
+  if (instruments.length === 0) {
+    throw new Error(
+      `Failed to fetch instrument info for ${instId}: empty instrument list. Cannot determine ctVal for quote_ccy conversion.`
+    );
+  }
+  const ctValStr = String(instruments[0].ctVal ?? "");
+  const ctVal = parseFloat(ctValStr);
+  if (!isFinite(ctVal) || ctVal <= 0) {
+    throw new Error(
+      `Invalid ctVal "${ctValStr}" for ${instId}. ctVal must be a positive number for quote_ccy conversion.`
+    );
+  }
+  const tickers = Array.isArray(tickerRes.data) ? tickerRes.data : [];
+  if (tickers.length === 0) {
+    throw new Error(
+      `Failed to fetch ticker price for ${instId}: empty ticker response. Cannot determine last price for quote_ccy conversion.`
+    );
+  }
+  const lastStr = String(tickers[0].last ?? "");
+  const lastPx = parseFloat(lastStr);
+  if (!isFinite(lastPx) || lastPx <= 0) {
+    throw new Error(
+      `Invalid last price "${lastStr}" for ${instId}. Last price must be a positive number for quote_ccy conversion.`
+    );
+  }
+  const usdtAmount = parseFloat(sz);
+  const contractValue = ctVal * lastPx;
+  const contracts = Math.floor(usdtAmount / contractValue);
+  if (contracts <= 0) {
+    const minUsdt = contractValue.toFixed(2);
+    throw new Error(
+      `sz=${sz} USDT is too small to buy even 1 contract of ${instId}. Minimum amount required is at least ${minUsdt} USDT (ctVal=${ctValStr}, lastPx=${lastStr}, 1 contract = ${minUsdt} USDT).`
+    );
+  }
+  const conversionNote = `Converting ${sz} USDT \u2192 ${contracts} contracts (ctVal=${ctValStr}, lastPx=${lastStr}, formula: floor(${sz} / (${ctValStr} \xD7 ${lastStr})) = ${contracts})`;
+  return {
+    sz: String(contracts),
+    tgtCcy: void 0,
+    conversionNote
+  };
+}
 function registerAlgoTradeTools() {
   return [
     {
@@ -2286,6 +2339,13 @@ function registerAlgoTradeTools() {
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
         const reduceOnly = args.reduceOnly;
+        const resolved = await resolveQuoteCcySz(
+          requireString(args, "instId"),
+          requireString(args, "sz"),
+          readString(args, "tgtCcy"),
+          "SWAP",
+          context.client
+        );
         const response = await context.client.privatePost(
           "/api/v5/trade/order-algo",
           compactObject({
@@ -2294,8 +2354,8 @@ function registerAlgoTradeTools() {
             side: requireString(args, "side"),
             posSide: readString(args, "posSide"),
             ordType: requireString(args, "ordType"),
-            sz: requireString(args, "sz"),
-            tgtCcy: readString(args, "tgtCcy"),
+            sz: resolved.sz,
+            tgtCcy: resolved.tgtCcy,
             tpTriggerPx: readString(args, "tpTriggerPx"),
             tpOrdPx: readString(args, "tpOrdPx"),
             tpTriggerPxType: readString(args, "tpTriggerPxType"),
@@ -2311,7 +2371,11 @@ function registerAlgoTradeTools() {
           }),
           privateRateLimit("swap_place_algo_order", 20)
         );
-        return normalizeResponse(response);
+        const result = normalizeResponse(response);
+        if (resolved.conversionNote) {
+          result._conversion = resolved.conversionNote;
+        }
+        return result;
       }
     },
     {
@@ -2619,6 +2683,13 @@ function registerFuturesAlgoTools() {
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
         const reduceOnly = args.reduceOnly;
+        const resolved = await resolveQuoteCcySz(
+          requireString(args, "instId"),
+          requireString(args, "sz"),
+          readString(args, "tgtCcy"),
+          "FUTURES",
+          context.client
+        );
         const response = await context.client.privatePost(
           "/api/v5/trade/order-algo",
           compactObject({
@@ -2627,8 +2698,8 @@ function registerFuturesAlgoTools() {
             side: requireString(args, "side"),
             posSide: readString(args, "posSide"),
             ordType: requireString(args, "ordType"),
-            sz: requireString(args, "sz"),
-            tgtCcy: readString(args, "tgtCcy"),
+            sz: resolved.sz,
+            tgtCcy: resolved.tgtCcy,
             tpTriggerPx: readString(args, "tpTriggerPx"),
             tpOrdPx: readString(args, "tpOrdPx"),
             tpTriggerPxType: readString(args, "tpTriggerPxType"),
@@ -2644,7 +2715,11 @@ function registerFuturesAlgoTools() {
           }),
           privateRateLimit("futures_place_algo_order", 20)
         );
-        return normalizeResponse(response);
+        const result = normalizeResponse(response);
+        if (resolved.conversionNote) {
+          result._conversion = resolved.conversionNote;
+        }
+        return result;
       }
     },
     {
@@ -3209,7 +3284,7 @@ function registerSkillsTools() {
     {
       name: "skills_download",
       module: "skills",
-      description: "Download a skill zip file from OKX Skills Marketplace to a local directory. Always call skills_search first to confirm the skill name exists. Downloads the latest approved version. NOTE: This only downloads the zip \u2014 it does NOT install to agents. For full installation use CLI: okx skill add <name>. Use when the user wants to inspect or manually install a skill package.",
+      description: "Download a skill zip file from OKX Skills Marketplace to a local directory. Always call skills_search first to confirm the skill name exists. Downloads the latest approved version. NOTE: Downloads third-party developer content as a zip \u2014 does NOT install to agents. For full installation use CLI: okx skill add <name>. Use when the user wants to inspect or manually install a skill package.",
       inputSchema: {
         type: "object",
         properties: {
@@ -4730,6 +4805,13 @@ function buildContractTradeTools(cfg) {
         const args = asRecord(rawArgs);
         const reduceOnly = args.reduceOnly;
         const attachAlgoOrds = buildAttachAlgoOrds(args);
+        const resolved = await resolveQuoteCcySz(
+          requireString(args, "instId"),
+          requireString(args, "sz"),
+          readString(args, "tgtCcy"),
+          defaultType,
+          context.client
+        );
         const response = await context.client.privatePost(
           "/api/v5/trade/order",
           compactObject({
@@ -4738,8 +4820,8 @@ function buildContractTradeTools(cfg) {
             side: requireString(args, "side"),
             posSide: readString(args, "posSide"),
             ordType: requireString(args, "ordType"),
-            sz: requireString(args, "sz"),
-            tgtCcy: readString(args, "tgtCcy"),
+            sz: resolved.sz,
+            tgtCcy: resolved.tgtCcy,
             px: readString(args, "px"),
             reduceOnly: typeof reduceOnly === "boolean" ? String(reduceOnly) : void 0,
             clOrdId: readString(args, "clOrdId"),
@@ -4748,7 +4830,11 @@ function buildContractTradeTools(cfg) {
           }),
           privateRateLimit(n("place_order"), 60)
         );
-        return normalizeResponse(response);
+        const result = normalizeResponse(response);
+        if (resolved.conversionNote) {
+          result._conversion = resolved.conversionNote;
+        }
+        return result;
       }
     },
     // ── cancel_order ─────────────────────────────────────────────────────────
@@ -5823,7 +5909,7 @@ function registerOptionAlgoTools() {
           tgtCcy: {
             type: "string",
             enum: ["base_ccy", "quote_ccy"],
-            description: "Size unit. base_ccy(default): sz in contracts, quote_ccy: sz in USDT (may not be supported for options)"
+            description: "Size unit. base_ccy(default): sz in contracts, quote_ccy: sz in USDT (auto-converted to contracts)"
           },
           reduceOnly: {
             type: "boolean",
@@ -5839,6 +5925,13 @@ function registerOptionAlgoTools() {
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
         const reduceOnly = readBoolean(args, "reduceOnly");
+        const resolved = await resolveQuoteCcySz(
+          requireString(args, "instId"),
+          requireString(args, "sz"),
+          readString(args, "tgtCcy"),
+          "OPTION",
+          context.client
+        );
         const response = await context.client.privatePost(
           "/api/v5/trade/order-algo",
           compactObject({
@@ -5846,8 +5939,8 @@ function registerOptionAlgoTools() {
             tdMode: requireString(args, "tdMode"),
             side: requireString(args, "side"),
             ordType: requireString(args, "ordType"),
-            sz: requireString(args, "sz"),
-            tgtCcy: readString(args, "tgtCcy"),
+            sz: resolved.sz,
+            tgtCcy: resolved.tgtCcy,
             tpTriggerPx: readString(args, "tpTriggerPx"),
             tpOrdPx: readString(args, "tpOrdPx"),
             tpTriggerPxType: readString(args, "tpTriggerPxType"),
@@ -8248,7 +8341,7 @@ async function cmdDiagnoseMcp(options = {}) {
 
 // src/commands/diagnose.ts
 var CLI_VERSION = readCliVersion();
-var GIT_HASH = true ? "0b9b3b7" : "dev";
+var GIT_HASH = true ? "5f833a2" : "dev";
 function maskKey2(key) {
   if (!key) return "(not set)";
   if (key.length <= 8) return "****";
@@ -12270,6 +12363,7 @@ function resolveNpx() {
   if (existsSync7(sibling)) return sibling;
   return "npx";
 }
+var THIRD_PARTY_INSTALL_NOTICE = "Note: This skill was created by a third-party developer, not by OKX. Review SKILL.md before use.";
 async function cmdSkillSearch(run, opts) {
   const args = {};
   if (opts.keyword) args.keyword = opts.keyword;
@@ -12345,11 +12439,7 @@ async function cmdSkillAdd(name, config, json) {
       throw e;
     }
     upsertSkillRecord(meta);
-    if (json) {
-      outputLine(JSON.stringify({ name: meta.name, version: meta.version, status: "installed" }, null, 2));
-    } else {
-      outputLine(`\u2713 Skill "${meta.name}" v${meta.version} installed`);
-    }
+    printSkillInstallResult(meta, json);
   } finally {
     rmSync(tmpBase, { recursive: true, force: true });
   }
@@ -12442,11 +12532,19 @@ function cmdSkillList(json) {
   outputLine("");
   outputLine(`${skills.length} skills installed.`);
 }
+function printSkillInstallResult(meta, json) {
+  if (json) {
+    outputLine(JSON.stringify({ name: meta.name, version: meta.version, status: "installed" }, null, 2));
+  } else {
+    outputLine(`\u2713 Skill "${meta.name}" v${meta.version} installed`);
+    outputLine(`  ${THIRD_PARTY_INSTALL_NOTICE}`);
+  }
+}
 
 // src/index.ts
 var _require3 = createRequire3(import.meta.url);
 var CLI_VERSION2 = _require3("../package.json").version;
-var GIT_HASH2 = true ? "0b9b3b7" : "dev";
+var GIT_HASH2 = true ? "5f833a2" : "dev";
 function handleConfigCommand(action, rest, json, lang, force) {
   if (action === "init") return cmdConfigInit(lang === "zh" ? "zh" : "en");
   if (action === "show") return cmdConfigShow(json);