@okx_ai/okx-trade-cli 1.1.5 → 1.1.7

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 {};
@@ -5541,7 +5541,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 +5871,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>]",
+            description: "Create a new grid bot order"
+          },
+          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
@@ -7853,6 +8251,7 @@ 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) {
   if (action === "init") return cmdConfigInit(lang === "zh" ? "zh" : "en");
   if (action === "show") return cmdConfigShow(json);
@@ -8303,12 +8702,19 @@ 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;