@okx_ai/okx-trade-cli 1.1.6 → 1.1.8

package/dist/index.js

@@ -1232,7 +1232,7 @@ var MODULES = [
   "account",
   ...BOT_SUB_MODULE_IDS
 ];
-var DEFAULT_MODULES = ["spot", "swap", "account", ...BOT_DEFAULT_SUB_MODULES];
+var DEFAULT_MODULES = ["spot", "swap", "option", "account", ...BOT_DEFAULT_SUB_MODULES];
 function asRecord(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     return {};
@@ -2503,6 +2503,10 @@ function registerGridTools() {
           sz: {
             type: "string",
             description: "Contracts to invest. 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",
@@ -5541,7 +5546,7 @@ function parseModuleList(rawModules) {
   }
   const trimmed = rawModules.trim().toLowerCase();
   if (trimmed === "all") {
-    return [...BASE_MODULES, ...BOT_DEFAULT_SUB_MODULES];
+    return [...BASE_MODULES, ...BOT_SUB_MODULE_IDS];
   }
   const requested = trimmed.split(",").map((item) => item.trim()).filter((item) => item.length > 0);
   if (requested.length === 0) {
@@ -5871,128 +5876,526 @@ function cmdSetupClients() {
 }
 
 // src/help.ts
-function printHelp() {
-  process.stdout.write(`
-Usage: okx [--profile <name>] [--json] <command> [args]
-
-Global Options:
-  --profile <name>   Use a named profile from ${configFilePath()}
-  --demo             Use simulated trading (demo) mode
-  --json             Output raw JSON
-  --version, -v      Show version
-  --help             Show this help
-
-Commands:
-  market ticker <instId>
-  market tickers <instType>               (SPOT|SWAP|FUTURES|OPTION)
-  market orderbook <instId> [--sz <n>]
-  market candles <instId> [--bar <bar>] [--limit <n>]
-  market instruments --instType <type> [--instId <id>]
-  market funding-rate <instId> [--history] [--limit <n>]
-  market mark-price --instType <MARGIN|SWAP|FUTURES|OPTION> [--instId <id>]
-  market trades <instId> [--limit <n>]
-  market index-ticker [--instId <id>] [--quoteCcy <ccy>]
-  market index-candles <instId> [--bar <bar>] [--limit <n>] [--history]
-  market price-limit <instId>
-  market open-interest --instType <SWAP|FUTURES|OPTION> [--instId <id>]
-
-  account balance [<ccy>]
-  account asset-balance [--ccy <ccy>]
-  account positions [--instType <type>] [--instId <id>]
-  account positions-history [--instType <type>] [--instId <id>] [--limit <n>]
-  account bills [--instType <type>] [--ccy <ccy>] [--limit <n>] [--archive]
-  account fees --instType <type> [--instId <id>]
-  account config
-  account set-position-mode --posMode <long_short_mode|net_mode>
-  account max-size --instId <id> --tdMode <cross|isolated> [--px <price>]
-  account max-avail-size --instId <id> --tdMode <cross|isolated|cash>
-  account max-withdrawal [--ccy <ccy>]
-  account transfer --ccy <ccy> --amt <n> --from <acct> --to <acct> [--transferType <0|1|2|3>]
-  account audit [--tool <name>] [--since <ISO-date>] [--limit <n>]
-
-  spot orders [--instId <id>] [--history]
-  spot get --instId <id> --ordId <id>
-  spot fills [--instId <id>] [--ordId <id>]
-  spot place --instId <id> --side <buy|sell> --ordType <type> --sz <n> [--px <price>] [--tdMode <cash|cross|isolated>]
-  spot amend --instId <id> --ordId <id> [--newSz <n>] [--newPx <price>]
-  spot cancel <instId> --ordId <id>
-  spot algo orders [--instId <id>] [--history] [--ordType <conditional|oco>]
-  spot algo place --instId <id> --side <buy|sell> --sz <n> [--ordType <conditional|oco>]
-                  [--tpTriggerPx <price>] [--tpOrdPx <price|-1>]
-                  [--slTriggerPx <price>] [--slOrdPx <price|-1>] [--tdMode <cash|cross|isolated>]
-  spot algo amend --instId <id> --algoId <id> [--newSz <n>]
-                  [--newTpTriggerPx <price>] [--newTpOrdPx <price|-1>]
-                  [--newSlTriggerPx <price>] [--newSlOrdPx <price|-1>]
-  spot algo cancel --instId <id> --algoId <id>
-  spot batch --action <place|amend|cancel> --orders '<json>'
-
-  swap positions [<instId>]
-  swap orders [--instId <id>] [--history] [--archive]
-  swap get --instId <id> --ordId <id>
-  swap fills [--instId <id>] [--ordId <id>] [--archive]
-  swap place --instId <id> --side <buy|sell> --ordType <type> --sz <n> [--posSide <side>] [--px <price>] [--tdMode <cross|isolated>]
-  swap cancel <instId> --ordId <id>
-  swap amend --instId <id> --ordId <id> [--newSz <n>] [--newPx <price>]
-  swap close --instId <id> --mgnMode <cross|isolated> [--posSide <net|long|short>] [--autoCxl]
-  swap leverage --instId <id> --lever <n> --mgnMode <cross|isolated> [--posSide <side>]
-  swap get-leverage --instId <id> --mgnMode <cross|isolated>
-  swap algo orders [--instId <id>] [--history] [--ordType <conditional|oco>]
-  swap algo trail --instId <id> --side <buy|sell> --sz <n> --callbackRatio <ratio>
-                  [--activePx <price>] [--posSide <net|long|short>] [--tdMode <cross|isolated>] [--reduceOnly]
-  swap algo place --instId <id> --side <buy|sell> --sz <n> [--ordType <conditional|oco>]
-                  [--tpTriggerPx <price>] [--tpOrdPx <price|-1>]
-                  [--slTriggerPx <price>] [--slOrdPx <price|-1>]
-                  [--posSide <net|long|short>] [--tdMode <cross|isolated>] [--reduceOnly]
-  swap algo amend --instId <id> --algoId <id> [--newSz <n>]
-                  [--newTpTriggerPx <price>] [--newTpOrdPx <price|-1>]
-                  [--newSlTriggerPx <price>] [--newSlOrdPx <price|-1>]
-  swap algo cancel --instId <id> --algoId <id>
-  swap batch --action <place|amend|cancel> --orders '<json>'
-
-  futures orders [--instId <id>] [--history] [--archive]
-  futures positions [--instId <id>]
-  futures fills [--instId <id>] [--ordId <id>] [--archive]
-  futures place --instId <id> --side <buy|sell> --ordType <type> --sz <n> [--tdMode <cross|isolated>]
-                [--posSide <net|long|short>] [--px <price>] [--reduceOnly]
-  futures cancel <instId> --ordId <id>
-  futures get --instId <id> --ordId <id>
-
-  option orders [--instId <id>] [--uly <uly>] [--history] [--archive]
-  option get --instId <id> [--ordId <id>] [--clOrdId <id>]
-  option positions [--instId <id>] [--uly <uly>]
-  option fills [--instId <id>] [--ordId <id>] [--archive]
-  option instruments --uly <uly> [--expTime <date>]
-  option greeks --uly <uly> [--expTime <date>]
-  option place --instId <id> --tdMode <cash|cross|isolated> --side <buy|sell> --ordType <type> --sz <n> [--px <price>] [--reduceOnly] [--clOrdId <id>]
-  option cancel --instId <id> [--ordId <id>] [--clOrdId <id>]
-  option amend --instId <id> [--ordId <id>] [--clOrdId <id>] [--newSz <n>] [--newPx <price>]
-  option batch-cancel --orders '<json>'
-
-  bot grid orders --algoOrdType <grid|contract_grid|moon_grid> [--instId <id>] [--algoId <id>] [--history]
-  bot grid details --algoOrdType <type> --algoId <id>
-  bot grid sub-orders --algoOrdType <type> --algoId <id> [--live]
-  bot grid create --instId <id> --algoOrdType <grid|contract_grid> --maxPx <px> --minPx <px> --gridNum <n>
-                  [--runType <1|2>] [--quoteSz <n>] [--baseSz <n>]
-                  [--direction <long|short|neutral>] [--lever <n>] [--sz <n>]
-  bot grid stop --algoId <id> --algoOrdType <type> --instId <id> [--stopType <1|2|3|5|6>]
-
-  bot dca orders [--type <spot|contract>] [--history]
-  bot dca details [--type <spot|contract>] --algoId <id>
-  bot dca sub-orders [--type <spot|contract>] --algoId <id> [--live] [--cycleId <id>]
-  bot dca create --instId <id> --initOrdAmt <n> --safetyOrdAmt <n> --maxSafetyOrds <n>
-                 --pxSteps <n> --pxStepsMult <n> --volMult <n> --tpPct <n> [--slPct <n>]
-                 [--type <spot|contract>] [--triggerType <1|2>] [--lever <n>] [--side <buy|sell>]
-  bot dca stop [--type <spot|contract>] --algoId <id> --instId <id> [--stopType <1|2>]
-
-  config init [--lang zh]
-  config show
-  config set <key> <value>
-  config setup-clients
-
-  setup --client <client> [--profile <name>] [--modules <list>]
-
-  Clients: ${SUPPORTED_CLIENTS.join(", ")}
+var HELP_TREE = {
+  market: {
+    description: "Market data (ticker, orderbook, candles, trades)",
+    commands: {
+      ticker: {
+        usage: "okx market ticker <instId>",
+        description: "Get latest ticker data for an instrument"
+      },
+      tickers: {
+        usage: "okx market tickers <instType>",
+        description: "Get all tickers for an instrument type (SPOT|SWAP|FUTURES|OPTION)"
+      },
+      orderbook: {
+        usage: "okx market orderbook <instId> [--sz <n>]",
+        description: "Get order book depth for an instrument"
+      },
+      candles: {
+        usage: "okx market candles <instId> [--bar <bar>] [--limit <n>]",
+        description: "Get candlestick (OHLCV) data"
+      },
+      instruments: {
+        usage: "okx market instruments --instType <type> [--instId <id>]",
+        description: "List tradable instruments of a given type"
+      },
+      "funding-rate": {
+        usage: "okx market funding-rate <instId> [--history] [--limit <n>]",
+        description: "Get current or historical funding rate for perpetual swaps"
+      },
+      "mark-price": {
+        usage: "okx market mark-price --instType <MARGIN|SWAP|FUTURES|OPTION> [--instId <id>]",
+        description: "Get mark price for instruments"
+      },
+      trades: {
+        usage: "okx market trades <instId> [--limit <n>]",
+        description: "Get recent trades for an instrument"
+      },
+      "index-ticker": {
+        usage: "okx market index-ticker [--instId <id>] [--quoteCcy <ccy>]",
+        description: "Get index ticker data"
+      },
+      "index-candles": {
+        usage: "okx market index-candles <instId> [--bar <bar>] [--limit <n>] [--history]",
+        description: "Get index candlestick data"
+      },
+      "price-limit": {
+        usage: "okx market price-limit <instId>",
+        description: "Get price limit for an instrument"
+      },
+      "open-interest": {
+        usage: "okx market open-interest --instType <SWAP|FUTURES|OPTION> [--instId <id>]",
+        description: "Get open interest for instruments"
+      }
+    }
+  },
+  account: {
+    description: "Account balance, positions, bills, and configuration",
+    commands: {
+      balance: {
+        usage: "okx account balance [<ccy>]",
+        description: "Get trading account balance"
+      },
+      "asset-balance": {
+        usage: "okx account asset-balance [--ccy <ccy>]",
+        description: "Get funding account asset balance"
+      },
+      positions: {
+        usage: "okx account positions [--instType <type>] [--instId <id>]",
+        description: "Get current open positions"
+      },
+      "positions-history": {
+        usage: "okx account positions-history [--instType <type>] [--instId <id>] [--limit <n>]",
+        description: "Get historical positions"
+      },
+      bills: {
+        usage: "okx account bills [--instType <type>] [--ccy <ccy>] [--limit <n>] [--archive]",
+        description: "Get account bill history"
+      },
+      fees: {
+        usage: "okx account fees --instType <type> [--instId <id>]",
+        description: "Get trading fee rates"
+      },
+      config: {
+        usage: "okx account config",
+        description: "Get account configuration"
+      },
+      "set-position-mode": {
+        usage: "okx account set-position-mode --posMode <long_short_mode|net_mode>",
+        description: "Set position mode (long/short or net)"
+      },
+      "max-size": {
+        usage: "okx account max-size --instId <id> --tdMode <cross|isolated> [--px <price>]",
+        description: "Get maximum order size for an instrument"
+      },
+      "max-avail-size": {
+        usage: "okx account max-avail-size --instId <id> --tdMode <cross|isolated|cash>",
+        description: "Get maximum available tradable amount"
+      },
+      "max-withdrawal": {
+        usage: "okx account max-withdrawal [--ccy <ccy>]",
+        description: "Get maximum withdrawable amount"
+      },
+      transfer: {
+        usage: "okx account transfer --ccy <ccy> --amt <n> --from <acct> --to <acct> [--transferType <0|1|2|3>]",
+        description: "Transfer funds between accounts"
+      },
+      audit: {
+        usage: "okx account audit [--tool <name>] [--since <ISO-date>] [--limit <n>]",
+        description: "Audit account activity and tool call history"
+      }
+    }
+  },
+  spot: {
+    description: "Spot trading (orders, algo orders)",
+    commands: {
+      orders: {
+        usage: "okx spot orders [--instId <id>] [--history]",
+        description: "List open or historical spot orders"
+      },
+      get: {
+        usage: "okx spot get --instId <id> --ordId <id>",
+        description: "Get details of a specific spot order"
+      },
+      fills: {
+        usage: "okx spot fills [--instId <id>] [--ordId <id>]",
+        description: "Get trade fill history for spot orders"
+      },
+      place: {
+        usage: "okx spot place --instId <id> --side <buy|sell> --ordType <type> --sz <n> [--px <price>] [--tdMode <cash|cross|isolated>]",
+        description: "Place a new spot order"
+      },
+      amend: {
+        usage: "okx spot amend --instId <id> --ordId <id> [--newSz <n>] [--newPx <price>]",
+        description: "Amend a pending spot order"
+      },
+      cancel: {
+        usage: "okx spot cancel <instId> --ordId <id>",
+        description: "Cancel a pending spot order"
+      },
+      batch: {
+        usage: "okx spot batch --action <place|amend|cancel> --orders '<json>'",
+        description: "Batch place, amend, or cancel spot orders"
+      }
+    },
+    subgroups: {
+      algo: {
+        description: "Spot algo orders (conditional, OCO, take-profit/stop-loss)",
+        commands: {
+          orders: {
+            usage: "okx spot algo orders [--instId <id>] [--history] [--ordType <conditional|oco>]",
+            description: "List spot algo orders"
+          },
+          place: {
+            usage: "okx spot algo place --instId <id> --side <buy|sell> --sz <n> [--ordType <conditional|oco>]\n                    [--tpTriggerPx <price>] [--tpOrdPx <price|-1>]\n                    [--slTriggerPx <price>] [--slOrdPx <price|-1>] [--tdMode <cash|cross|isolated>]",
+            description: "Place a spot algo order (take-profit/stop-loss)"
+          },
+          amend: {
+            usage: "okx spot algo amend --instId <id> --algoId <id> [--newSz <n>]\n                    [--newTpTriggerPx <price>] [--newTpOrdPx <price|-1>]\n                    [--newSlTriggerPx <price>] [--newSlOrdPx <price|-1>]",
+            description: "Amend a pending spot algo order"
+          },
+          cancel: {
+            usage: "okx spot algo cancel --instId <id> --algoId <id>",
+            description: "Cancel a pending spot algo order"
+          }
+        }
+      }
+    }
+  },
+  swap: {
+    description: "Perpetual swap trading (orders, algo orders)",
+    commands: {
+      positions: {
+        usage: "okx swap positions [<instId>]",
+        description: "Get current perpetual swap positions"
+      },
+      orders: {
+        usage: "okx swap orders [--instId <id>] [--history] [--archive]",
+        description: "List open or historical swap orders"
+      },
+      get: {
+        usage: "okx swap get --instId <id> --ordId <id>",
+        description: "Get details of a specific swap order"
+      },
+      fills: {
+        usage: "okx swap fills [--instId <id>] [--ordId <id>] [--archive]",
+        description: "Get trade fill history for swap orders"
+      },
+      place: {
+        usage: "okx swap place --instId <id> --side <buy|sell> --ordType <type> --sz <n> [--posSide <side>] [--px <price>] [--tdMode <cross|isolated>]",
+        description: "Place a new perpetual swap order"
+      },
+      cancel: {
+        usage: "okx swap cancel <instId> --ordId <id>",
+        description: "Cancel a pending swap order"
+      },
+      amend: {
+        usage: "okx swap amend --instId <id> --ordId <id> [--newSz <n>] [--newPx <price>]",
+        description: "Amend a pending swap order"
+      },
+      close: {
+        usage: "okx swap close --instId <id> --mgnMode <cross|isolated> [--posSide <net|long|short>] [--autoCxl]",
+        description: "Close a swap position"
+      },
+      leverage: {
+        usage: "okx swap leverage --instId <id> --lever <n> --mgnMode <cross|isolated> [--posSide <side>]",
+        description: "Set leverage for a swap instrument"
+      },
+      "get-leverage": {
+        usage: "okx swap get-leverage --instId <id> --mgnMode <cross|isolated>",
+        description: "Get current leverage setting for a swap instrument"
+      },
+      batch: {
+        usage: "okx swap batch --action <place|amend|cancel> --orders '<json>'",
+        description: "Batch place, amend, or cancel swap orders"
+      }
+    },
+    subgroups: {
+      algo: {
+        description: "Perpetual swap algo orders (trailing stop, conditional, OCO)",
+        commands: {
+          orders: {
+            usage: "okx swap algo orders [--instId <id>] [--history] [--ordType <conditional|oco>]",
+            description: "List swap algo orders"
+          },
+          trail: {
+            usage: "okx swap algo trail --instId <id> --side <buy|sell> --sz <n> --callbackRatio <ratio>\n                   [--activePx <price>] [--posSide <net|long|short>] [--tdMode <cross|isolated>] [--reduceOnly]",
+            description: "Place a trailing stop algo order for perpetual swap"
+          },
+          place: {
+            usage: "okx swap algo place --instId <id> --side <buy|sell> --sz <n> [--ordType <conditional|oco>]\n                   [--tpTriggerPx <price>] [--tpOrdPx <price|-1>]\n                   [--slTriggerPx <price>] [--slOrdPx <price|-1>]\n                   [--posSide <net|long|short>] [--tdMode <cross|isolated>] [--reduceOnly]",
+            description: "Place a swap algo order (take-profit/stop-loss)"
+          },
+          amend: {
+            usage: "okx swap algo amend --instId <id> --algoId <id> [--newSz <n>]\n                   [--newTpTriggerPx <price>] [--newTpOrdPx <price|-1>]\n                   [--newSlTriggerPx <price>] [--newSlOrdPx <price|-1>]",
+            description: "Amend a pending swap algo order"
+          },
+          cancel: {
+            usage: "okx swap algo cancel --instId <id> --algoId <id>",
+            description: "Cancel a pending swap algo order"
+          }
+        }
+      }
+    }
+  },
+  futures: {
+    description: "Futures trading (orders, positions)",
+    commands: {
+      orders: {
+        usage: "okx futures orders [--instId <id>] [--history] [--archive]",
+        description: "List open or historical futures orders"
+      },
+      positions: {
+        usage: "okx futures positions [--instId <id>]",
+        description: "Get current futures positions"
+      },
+      fills: {
+        usage: "okx futures fills [--instId <id>] [--ordId <id>] [--archive]",
+        description: "Get trade fill history for futures orders"
+      },
+      place: {
+        usage: "okx futures place --instId <id> --side <buy|sell> --ordType <type> --sz <n>\n                 [--tdMode <cross|isolated>] [--posSide <net|long|short>] [--px <price>] [--reduceOnly]",
+        description: "Place a new futures order"
+      },
+      cancel: {
+        usage: "okx futures cancel <instId> --ordId <id>",
+        description: "Cancel a pending futures order"
+      },
+      get: {
+        usage: "okx futures get --instId <id> --ordId <id>",
+        description: "Get details of a specific futures order"
+      }
+    }
+  },
+  option: {
+    description: "Options trading (orders, positions, greeks)",
+    commands: {
+      orders: {
+        usage: "okx option orders [--instId <id>] [--uly <uly>] [--history] [--archive]",
+        description: "List open or historical option orders"
+      },
+      get: {
+        usage: "okx option get --instId <id> [--ordId <id>] [--clOrdId <id>]",
+        description: "Get details of a specific option order"
+      },
+      positions: {
+        usage: "okx option positions [--instId <id>] [--uly <uly>]",
+        description: "Get current option positions"
+      },
+      fills: {
+        usage: "okx option fills [--instId <id>] [--ordId <id>] [--archive]",
+        description: "Get trade fill history for option orders"
+      },
+      instruments: {
+        usage: "okx option instruments --uly <uly> [--expTime <date>]",
+        description: "List tradable option instruments for an underlying"
+      },
+      greeks: {
+        usage: "okx option greeks --uly <uly> [--expTime <date>]",
+        description: "Get option greeks (delta, gamma, theta, vega)"
+      },
+      place: {
+        usage: "okx option place --instId <id> --tdMode <cash|cross|isolated> --side <buy|sell> --ordType <type> --sz <n>\n               [--px <price>] [--reduceOnly] [--clOrdId <id>]",
+        description: "Place a new option order"
+      },
+      cancel: {
+        usage: "okx option cancel --instId <id> [--ordId <id>] [--clOrdId <id>]",
+        description: "Cancel a pending option order"
+      },
+      amend: {
+        usage: "okx option amend --instId <id> [--ordId <id>] [--clOrdId <id>] [--newSz <n>] [--newPx <price>]",
+        description: "Amend a pending option order"
+      },
+      "batch-cancel": {
+        usage: "okx option batch-cancel --orders '<json>'",
+        description: "Batch cancel option orders"
+      }
+    }
+  },
+  bot: {
+    description: "Trading bot strategies (grid, dca)",
+    subgroups: {
+      grid: {
+        description: "Grid trading bot \u2014 create, monitor, and stop grid orders",
+        commands: {
+          orders: {
+            usage: "okx bot grid orders --algoOrdType <grid|contract_grid|moon_grid> [--instId <id>] [--algoId <id>] [--history]",
+            description: "List active or historical grid bot orders"
+          },
+          details: {
+            usage: "okx bot grid details --algoOrdType <type> --algoId <id>",
+            description: "Get details of a specific grid bot order"
+          },
+          "sub-orders": {
+            usage: "okx bot grid sub-orders --algoOrdType <type> --algoId <id> [--live]",
+            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>] [--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>]",
+            description: "Stop a running grid bot order"
+          }
+        }
+      },
+      dca: {
+        description: "DCA (Dollar Cost Averaging) bot \u2014 automated recurring buys",
+        commands: {
+          orders: {
+            usage: "okx bot dca orders [--type <spot|contract>] [--history]",
+            description: "List active or historical DCA bot orders"
+          },
+          details: {
+            usage: "okx bot dca details [--type <spot|contract>] --algoId <id>",
+            description: "Get details of a specific DCA bot order"
+          },
+          "sub-orders": {
+            usage: "okx bot dca sub-orders [--type <spot|contract>] --algoId <id> [--live] [--cycleId <id>]",
+            description: "List sub-orders of a DCA bot"
+          },
+          create: {
+            usage: "okx bot dca create --instId <id> --initOrdAmt <n> --safetyOrdAmt <n> --maxSafetyOrds <n>\n                 --pxSteps <n> --pxStepsMult <n> --volMult <n> --tpPct <n> [--slPct <n>]\n                 [--type <spot|contract>] [--triggerType <1|2>] [--lever <n>] [--side <buy|sell>]\n                 [--reserveFunds <true|false>]",
+            description: "Create a new DCA bot order"
+          },
+          stop: {
+            usage: "okx bot dca stop [--type <spot|contract>] --algoId <id> --instId <id> [--stopType <1|2>]",
+            description: "Stop a running DCA bot order"
+          }
+        }
+      }
+    }
+  },
+  config: {
+    description: "Manage CLI configuration profiles",
+    commands: {
+      init: {
+        usage: "okx config init [--lang zh]",
+        description: "Initialize a new configuration profile interactively"
+      },
+      show: {
+        usage: "okx config show",
+        description: `Show current configuration (file: ${configFilePath()})`
+      },
+      set: {
+        usage: "okx config set <key> <value>",
+        description: "Set a configuration value"
+      },
+      "setup-clients": {
+        usage: "okx config setup-clients",
+        description: "Set up MCP client integrations (Cursor, Windsurf, etc.)"
+      }
+    }
+  },
+  setup: {
+    description: "Set up client integrations (Cursor, Windsurf, Claude, etc.)",
+    usage: `okx setup --client <${SUPPORTED_CLIENTS.join("|")}> [--profile <name>] [--modules <list>]`
+  }
+};
+function printGlobalHelp() {
+  const lines = [
+    "",
+    `Usage: okx [--profile <name>] [--demo] [--json] <module> <action> [args...]`,
+    "",
+    "Global Options:",
+    `  --profile <name>   Use a named profile from ${configFilePath()}`,
+    "  --demo             Use simulated trading (demo) mode",
+    "  --json             Output raw JSON",
+    "  --version, -v      Show version",
+    "  --help             Show this help",
+    "",
+    "Modules:"
+  ];
+  const colWidth = 12;
+  for (const [name, group] of Object.entries(HELP_TREE)) {
+    lines.push(`  ${name.padEnd(colWidth)}${group.description}`);
+  }
+  lines.push("", 'Run "okx <module> --help" for module details.', "");
+  process.stdout.write(lines.join("\n"));
+}
+function printModuleHelp(moduleName) {
+  const group = HELP_TREE[moduleName];
+  if (!group) {
+    process.stderr.write(`Unknown module: ${moduleName}
+`);
+    process.exitCode = 1;
+    return;
+  }
+  const hasSubgroups = group.subgroups && Object.keys(group.subgroups).length > 0;
+  const hasCommands = group.commands && Object.keys(group.commands).length > 0;
+  const lines = [""];
+  if (hasSubgroups && !hasCommands) {
+    const subgroupNames = Object.keys(group.subgroups);
+    lines.push(`Usage: okx ${moduleName} <strategy> <action> [args...]`);
+    lines.push("", `${group.description}.`, "");
+    lines.push("Strategies:");
+    const colWidth = Math.max(...subgroupNames.map((n) => n.length)) + 4;
+    for (const [sgName, sg] of Object.entries(group.subgroups)) {
+      lines.push(`  ${sgName.padEnd(colWidth)}${sg.description}`);
+    }
+    lines.push("", `Run "okx ${moduleName} <strategy> --help" for details.`);
+  } else if (hasSubgroups && hasCommands) {
+    lines.push(`Usage: okx ${moduleName} <action> [args...]`);
+    lines.push("", `${group.description}.`, "", "Commands:");
+    printCommandList(lines, group.commands);
+    lines.push("", "Subgroups:");
+    const subgroupEntries = Object.entries(group.subgroups);
+    const colWidth = Math.max(...subgroupEntries.map(([n]) => n.length)) + 4;
+    for (const [sgName, sg] of subgroupEntries) {
+      lines.push(`  ${sgName.padEnd(colWidth)}${sg.description}`);
+    }
+    lines.push("", `Run "okx ${moduleName} <subgroup> --help" for subgroup details.`);
+  } else if (hasCommands) {
+    lines.push(`Usage: okx ${moduleName} <action> [args...]`);
+    lines.push("", `${group.description}.`, "", "Commands:");
+    printCommandList(lines, group.commands);
+  } else if (group.usage) {
+    lines.push(`Usage: ${group.usage}`);
+    lines.push("", `${group.description}.`);
+    if (group.commands) {
+      lines.push("");
+      for (const cmd of Object.values(group.commands)) {
+        lines.push(`  ${cmd.description}`);
+        lines.push(`  Usage: ${cmd.usage}`);
+      }
+    }
+  }
+  lines.push("");
+  process.stdout.write(lines.join("\n"));
+}
+function printSubgroupHelp(moduleName, subgroupName) {
+  const group = HELP_TREE[moduleName];
+  if (!group) {
+    process.stderr.write(`Unknown module: ${moduleName}
+`);
+    process.exitCode = 1;
+    return;
+  }
+  const subgroup = group.subgroups?.[subgroupName];
+  if (!subgroup) {
+    process.stderr.write(`Unknown subgroup: ${moduleName} ${subgroupName}
 `);
+    process.exitCode = 1;
+    return;
+  }
+  const lines = [
+    "",
+    `Usage: okx ${moduleName} ${subgroupName} <action> [args...]`,
+    "",
+    `${subgroup.description}.`,
+    "",
+    "Commands:"
+  ];
+  if (subgroup.commands) {
+    printCommandList(lines, subgroup.commands);
+  }
+  lines.push("");
+  process.stdout.write(lines.join("\n"));
+}
+function printCommandList(lines, commands) {
+  const names = Object.keys(commands);
+  const colWidth = Math.max(...names.map((n) => n.length)) + 4;
+  for (const [name, cmd] of Object.entries(commands)) {
+    lines.push(`  ${name.padEnd(colWidth)}${cmd.description}`);
+    const usageLines = cmd.usage.split("\n");
+    lines.push(`  ${" ".repeat(colWidth)}Usage: ${usageLines[0]}`);
+    for (const extra of usageLines.slice(1)) {
+      lines.push(`  ${" ".repeat(colWidth)}       ${extra.trimStart()}`);
+    }
+    lines.push("");
+  }
+}
+function printHelp(...path4) {
+  const [moduleName, subgroupName] = path4;
+  if (!moduleName) {
+    printGlobalHelp();
+  } else if (!subgroupName) {
+    printModuleHelp(moduleName);
+  } else {
+    printSubgroupHelp(moduleName, subgroupName);
+  }
 }
 
 // src/parser.ts
@@ -6049,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
@@ -6090,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 };
 }
 
@@ -7457,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);
@@ -7478,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}`;
@@ -7581,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) {
@@ -7677,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);
@@ -7853,11 +8387,15 @@ async function cmdDcaSubOrders(run, opts) {
 // src/index.ts
 var _require = createRequire(import.meta.url);
 var CLI_VERSION = _require("../package.json").version;
-function handleConfigCommand(action, rest, json, lang) {
+var GIT_HASH = true ? "53a7589" : "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;
@@ -8254,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")
@@ -8303,18 +8842,25 @@ async function main() {
   checkForUpdates("@okx_ai/okx-trade-cli", CLI_VERSION);
   const { values, positionals } = parseCli(process.argv.slice(2));
   if (values.version) {
-    process.stdout.write(`${CLI_VERSION}
+    process.stdout.write(`${CLI_VERSION} (${GIT_HASH})
 `);
     return;
   }
   if (values.help || positionals.length === 0) {
-    printHelp();
+    const [module2, subgroup] = positionals;
+    if (!module2) {
+      printHelp();
+    } else if (!subgroup) {
+      printHelp(module2);
+    } else {
+      printHelp(module2, subgroup);
+    }
     return;
   }
   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);