@okx_ai/okx-trade-cli 1.1.7 → 1.1.9

package/dist/index.js

@@ -2452,7 +2452,7 @@ function registerGridTools() {
     {
       name: "grid_create_order",
       module: "bot.grid",
-      description: "Create a new grid trading bot. [CAUTION] Executes real trades and locks funds. Supports Spot Grid ('grid') and Contract Grid ('contract_grid'). For spot grid, provide quoteSz (invest in quote currency) or baseSz (invest in base currency). For contract grids, provide direction, lever, and sz (number of contracts). Private endpoint. Rate limit: 20 req/2s per UID.",
+      description: "Create a new grid trading bot. [CAUTION] Executes real trades and locks funds. Supports Spot Grid ('grid') and Contract Grid ('contract_grid'). For spot grid, provide quoteSz (invest in quote currency) or baseSz (invest in base currency). For contract grids, provide direction, lever, and sz (investment amount in margin currency, e.g. USDT for USDT-margined contracts). Private endpoint. Rate limit: 20 req/2s per UID.",
       isWrite: true,
       inputSchema: {
         type: "object",
@@ -2502,7 +2502,11 @@ function registerGridTools() {
           },
           sz: {
             type: "string",
-            description: "Contracts to invest. Required for contract_grid."
+            description: "Investment amount in margin currency (e.g. USDT for USDT-margined contracts). Required for contract_grid."
+          },
+          basePos: {
+            type: "boolean",
+            description: "Whether to open a base position for contract grid. Ignored for neutral direction and spot grid. Default: true"
           }
         },
         required: ["instId", "algoOrdType", "maxPx", "minPx", "gridNum"]
@@ -2525,6 +2529,7 @@ function registerGridTools() {
         });
         if (algoOrdType === "contract_grid") {
           body.triggerParams = [{ triggerAction: "start", triggerStrategy: "instant" }];
+          body.basePos = readBoolean(args, "basePos") ?? true;
         }
         const response = await context.client.privatePost(
           "/api/v5/tradingBot/grid/order-algo",
@@ -6207,8 +6212,8 @@ var HELP_TREE = {
             description: "List sub-orders of a grid bot (filled or live)"
           },
           create: {
-            usage: "okx bot grid create --instId <id> --algoOrdType <grid|contract_grid> --maxPx <px> --minPx <px> --gridNum <n>\n                   [--runType <1|2>] [--quoteSz <n>] [--baseSz <n>]\n                   [--direction <long|short|neutral>] [--lever <n>] [--sz <n>]",
-            description: "Create a new grid bot order"
+            usage: "okx bot grid create --instId <id> --algoOrdType <grid|contract_grid> --maxPx <px> --minPx <px> --gridNum <n>\n                   [--runType <1|2>] [--quoteSz <n>] [--baseSz <n>]\n                   [--direction <long|short|neutral>] [--lever <n>] [--sz <n>] [--basePos] [--no-basePos]",
+            description: "Create a new grid bot order (contract grid opens base position by default)"
           },
           stop: {
             usage: "okx bot grid stop --algoId <id> --algoOrdType <type> --instId <id> [--stopType <1|2|3|5|6>]",
@@ -6447,6 +6452,7 @@ var CLI_OPTIONS = {
   quoteSz: { type: "string" },
   baseSz: { type: "string" },
   direction: { type: "string" },
+  basePos: { type: "boolean", default: true },
   stopType: { type: "string" },
   live: { type: "boolean", default: false },
   // market extras
@@ -6488,14 +6494,30 @@ var CLI_OPTIONS = {
   orders: { type: "string" },
   // audit
   since: { type: "string" },
-  tool: { type: "string" }
+  tool: { type: "string" },
+  // config profile
+  force: { type: "boolean", default: false }
 };
 function parseCli(argv) {
+  const negated = /* @__PURE__ */ new Set();
+  const filtered = argv.filter((arg) => {
+    if (arg.startsWith("--no-")) {
+      const key = arg.slice(5);
+      if (key in CLI_OPTIONS && CLI_OPTIONS[key].type === "boolean") {
+        negated.add(key);
+        return false;
+      }
+    }
+    return true;
+  });
   const { values, positionals } = parseArgs({
-    args: argv,
+    args: filtered,
     options: CLI_OPTIONS,
     allowPositionals: true
   });
+  for (const key of negated) {
+    values[key] = false;
+  }
   return { values, positionals };
 }
 
@@ -7855,7 +7877,7 @@ function cmdConfigShow(json) {
     process.stdout.write(`[${name}]
 `);
     printKv({
-      api_key: profile.api_key ? "***" + profile.api_key.slice(-4) : "(not set)",
+      api_key: profile.api_key ? maskSecret(profile.api_key) : "(not set)",
       demo: profile.demo ?? false,
       base_url: profile.base_url ?? "(default)"
     }, 2);
@@ -7876,10 +7898,24 @@ function cmdConfigSet(key, value) {
   }
 }
 function parseSiteKey(raw) {
-  if (raw === "2") return "eea";
-  if (raw === "3") return "us";
+  const lower = raw.toLowerCase();
+  if (lower === "eea" || raw === "2") return "eea";
+  if (lower === "us" || raw === "3") return "us";
+  if (lower === "global" || raw === "1") return "global";
   return "global";
 }
+function inferSiteFromBaseUrl(baseUrl) {
+  if (!baseUrl) return "global";
+  for (const id of SITE_IDS) {
+    const site = OKX_SITES[id];
+    if (baseUrl === site.apiBaseUrl || baseUrl === site.webUrl) return id;
+  }
+  return "global";
+}
+function maskSecret(value) {
+  if (!value || value.length < 4) return "****";
+  return "***" + value.slice(-4);
+}
 function buildApiUrl(siteKey, demo) {
   const query = demo ? "?go-demo-trading=1" : "?go-live-trading=1";
   return `${OKX_SITES[siteKey].webUrl}/account/my-api${query}`;
@@ -7979,6 +8015,105 @@ async function cmdConfigInit(lang = "en") {
     rl.close();
   }
 }
+function cmdConfigAddProfile(kvPairs, force) {
+  const params = {};
+  for (const pair of kvPairs) {
+    const eqIdx = pair.indexOf("=");
+    if (eqIdx === -1) continue;
+    const key = pair.slice(0, eqIdx).trim();
+    const value = pair.slice(eqIdx + 1);
+    params[key.toUpperCase()] = value;
+  }
+  const ak = params["AK"];
+  const sk = params["SK"];
+  const pp = params["PP"];
+  const missing = [];
+  if (!ak) missing.push("AK");
+  if (!sk) missing.push("SK");
+  if (!pp) missing.push("PP");
+  if (missing.length > 0) {
+    process.stderr.write(`Error: missing required parameter(s): ${missing.join(", ")}
+`);
+    process.stderr.write("Usage: okx config add-profile AK=<key> SK=<secret> PP=<passphrase> [site=global|eea|us] [demo=true|false] [name=<name>] [--force]\n");
+    process.exitCode = 1;
+    return;
+  }
+  const siteKey = parseSiteKey(params["SITE"] ?? "");
+  const demo = params["DEMO"] !== void 0 ? params["DEMO"].toLowerCase() !== "false" : true;
+  const defaultName = demo ? "demo" : "live";
+  const profileName = params["NAME"] ?? defaultName;
+  const config = readFullConfig();
+  if (config.profiles[profileName] && !force) {
+    process.stderr.write(`Error: profile "${profileName}" already exists. Use --force to overwrite.
+`);
+    process.exitCode = 1;
+    return;
+  }
+  const entry = buildProfileEntry(siteKey, ak, sk, pp, demo);
+  entry.site = siteKey;
+  config.profiles[profileName] = entry;
+  config.default_profile = profileName;
+  writeCliConfig(config);
+  process.stdout.write(`Profile "${profileName}" saved to ${configFilePath()}
+`);
+  process.stdout.write(`Default profile set to: ${profileName}
+`);
+}
+function cmdConfigListProfile() {
+  const config = readFullConfig();
+  const entries = Object.entries(config.profiles);
+  if (entries.length === 0) {
+    process.stdout.write("No profiles found. Run: okx config add-profile AK=<key> SK=<secret> PP=<passphrase>\n");
+    return;
+  }
+  process.stdout.write(`Config: ${configFilePath()}
+
+`);
+  for (const [name, profile] of entries) {
+    const isDefault = name === config.default_profile;
+    const marker = isDefault ? " *" : "";
+    const site = profile.site ?? inferSiteFromBaseUrl(profile.base_url);
+    const mode = profile.demo !== false ? "demo (\u6A21\u62DF\u76D8)" : "live (\u5B9E\u76D8)";
+    process.stdout.write(`[${name}]${marker}
+`);
+    process.stdout.write(`  api_key:    ${maskSecret(profile.api_key)}
+`);
+    process.stdout.write(`  secret_key: ${maskSecret(profile.secret_key)}
+`);
+    process.stdout.write(`  passphrase: ${maskSecret(profile.passphrase)}
+`);
+    process.stdout.write(`  site:       ${site}
+`);
+    process.stdout.write(`  mode:       ${mode}
+`);
+    process.stdout.write("\n");
+  }
+}
+function cmdConfigUse(profileName) {
+  if (!profileName) {
+    process.stderr.write("Error: profile name is required.\nUsage: okx config use <profile-name>\n");
+    process.exitCode = 1;
+    return;
+  }
+  const config = readFullConfig();
+  const available = Object.keys(config.profiles);
+  if (!config.profiles[profileName]) {
+    process.stderr.write(`Error: profile "${profileName}" does not exist.
+`);
+    if (available.length > 0) {
+      process.stderr.write(`Available profiles: ${available.join(", ")}
+`);
+    } else {
+      process.stderr.write("No profiles configured. Run: okx config add-profile AK=<key> SK=<secret> PP=<passphrase>\n");
+    }
+    process.exitCode = 1;
+    return;
+  }
+  config.default_profile = profileName;
+  writeCliConfig(config);
+  process.stdout.write(`Default profile set to: "${profileName}"
+`);
+}
 
 // src/commands/bot.ts
 function getData7(result) {
@@ -8075,7 +8210,8 @@ async function cmdGridCreate(run, opts) {
     baseSz: opts.baseSz,
     direction: opts.direction,
     lever: opts.lever,
-    sz: opts.sz
+    sz: opts.sz,
+    basePos: opts.basePos
   });
   const data = getData7(result);
   if (opts.json) return printJson(data);
@@ -8251,12 +8387,15 @@ async function cmdDcaSubOrders(run, opts) {
 // src/index.ts
 var _require = createRequire(import.meta.url);
 var CLI_VERSION = _require("../package.json").version;
-var GIT_HASH = true ? "b0b33d7" : "dev";
-function handleConfigCommand(action, rest, json, lang) {
+var GIT_HASH = true ? "9eed480" : "dev";
+function handleConfigCommand(action, rest, json, lang, force) {
   if (action === "init") return cmdConfigInit(lang === "zh" ? "zh" : "en");
   if (action === "show") return cmdConfigShow(json);
   if (action === "set") return cmdConfigSet(rest[0], rest[1]);
   if (action === "setup-clients") return cmdSetupClients();
+  if (action === "add-profile") return cmdConfigAddProfile(rest, force ?? false);
+  if (action === "list-profile") return cmdConfigListProfile();
+  if (action === "use") return cmdConfigUse(rest[0]);
   process.stderr.write(`Unknown config command: ${action}
 `);
   process.exitCode = 1;
@@ -8653,6 +8792,7 @@ function handleBotGridCommand(run, v, rest, json) {
       direction: v.direction,
       lever: v.lever,
       sz: v.sz,
+      basePos: v.basePos,
       json
     });
   if (subAction === "stop")
@@ -8720,7 +8860,7 @@ async function main() {
   const [module, action, ...rest] = positionals;
   const v = values;
   const json = v.json ?? false;
-  if (module === "config") return handleConfigCommand(action, rest, json, v.lang);
+  if (module === "config") return handleConfigCommand(action, rest, json, v.lang, v.force);
   if (module === "setup") return handleSetupCommand(v);
   const config = loadProfileConfig({ profile: v.profile, demo: v.demo, userAgent: `okx-trade-cli/${CLI_VERSION}` });
   const client = new OkxRestClient(config);