@okx_ai/okx-trade-cli 1.2.6 → 1.2.7-beta.2

package/dist/index.js

@@ -1524,7 +1524,8 @@ var BOT_DEFAULT_SUB_MODULES = ["bot.grid"];
 var EARN_SUB_MODULE_IDS = [
   "earn.savings",
   "earn.onchain",
-  "earn.dcd"
+  "earn.dcd",
+  "earn.autoearn"
 ];
 var MODULES = [
   "market",
@@ -2141,6 +2142,11 @@ function registerAlgoTradeTools() {
             type: "string",
             description: "Activation price; tracking starts after market reaches this level (move_order_stop only)"
           },
+          tgtCcy: {
+            type: "string",
+            enum: ["base_ccy", "quote_ccy"],
+            description: "Size unit. base_ccy(default): sz in contracts, quote_ccy: sz in USDT"
+          },
           reduceOnly: {
             type: "boolean",
             description: "Ensure order only reduces position"
@@ -2164,6 +2170,7 @@ function registerAlgoTradeTools() {
             posSide: readString(args, "posSide"),
             ordType: requireString(args, "ordType"),
             sz: requireString(args, "sz"),
+            tgtCcy: readString(args, "tgtCcy"),
             tpTriggerPx: readString(args, "tpTriggerPx"),
             tpOrdPx: readString(args, "tpOrdPx"),
             tpTriggerPxType: readString(args, "tpTriggerPxType"),
@@ -2468,6 +2475,11 @@ function registerFuturesAlgoTools() {
             type: "string",
             description: "Activation price; tracking starts after market reaches this level (move_order_stop only)"
           },
+          tgtCcy: {
+            type: "string",
+            enum: ["base_ccy", "quote_ccy"],
+            description: "Size unit. base_ccy(default): sz in contracts, quote_ccy: sz in USDT"
+          },
           reduceOnly: {
             type: "boolean",
             description: "Ensure order only reduces position"
@@ -2491,6 +2503,7 @@ function registerFuturesAlgoTools() {
             posSide: readString(args, "posSide"),
             ordType: requireString(args, "ordType"),
             sz: requireString(args, "sz"),
+            tgtCcy: readString(args, "tgtCcy"),
             tpTriggerPx: readString(args, "tpTriggerPx"),
             tpOrdPx: readString(args, "tpOrdPx"),
             tpTriggerPxType: readString(args, "tpTriggerPxType"),
@@ -2873,7 +2886,7 @@ function registerGridTools() {
             enum: ["active", "history"],
             description: "active=running (default); history=stopped"
           },
-          instId: { type: "string", description: "e.g. BTC-USDT" },
+          instId: { type: "string", description: "e.g. BTC-USDT, BTC-USD-SWAP" },
           algoId: { type: "string", description: "Grid bot algo order ID (not a trade ordId)" },
           after: { type: "string", description: "Cursor for older records" },
           before: { type: "string", description: "Cursor for newer records" },
@@ -2978,12 +2991,12 @@ function registerGridTools() {
     {
       name: "grid_create_order",
       module: "bot.grid",
-      description: "Create grid bot. [CAUTION] Real trades, locks funds. Spot('grid'): need quoteSz|baseSz. Contract('contract_grid'): need direction+lever+sz.",
+      description: "Create grid bot (spot, USDT-margined, or coin-margined contract). [CAUTION] Locks funds. Spot: quoteSz|baseSz. Contract: direction+lever+sz.",
       isWrite: true,
       inputSchema: {
         type: "object",
         properties: {
-          instId: { type: "string", description: "e.g. BTC-USDT" },
+          instId: { type: "string", description: "e.g. BTC-USDT, BTC-USDT-SWAP, BTC-USD-SWAP (coin-margined)" },
           algoOrdType: {
             type: "string",
             enum: ["grid", "contract_grid"],
@@ -3005,8 +3018,13 @@ function registerGridTools() {
             description: "Contract only"
           },
           lever: { type: "string", description: "Leverage. Contract only" },
-          sz: { type: "string", description: "Margin amount. Contract only" },
-          basePos: { type: "boolean", description: "Open base position for contract. Default: true" }
+          sz: { type: "string", description: "Margin in USDT or base coin (CoinM). Contract only" },
+          basePos: { type: "boolean", description: "Open base position for contract. Default: true" },
+          tpTriggerPx: { type: "string", description: "TP trigger price" },
+          slTriggerPx: { type: "string", description: "SL trigger price" },
+          tpRatio: { type: "string", description: "TP ratio e.g. 0.1=10%. Contract only" },
+          slRatio: { type: "string", description: "SL ratio e.g. 0.1=10%. Contract only" },
+          algoClOrdId: { type: "string", description: "User-defined ID. Alphanumeric, max 32, unique per user" }
         },
         required: ["instId", "algoOrdType", "maxPx", "minPx", "gridNum"]
       },
@@ -3025,9 +3043,15 @@ function registerGridTools() {
           direction: readString(args, "direction"),
           lever: readString(args, "lever"),
           sz: readString(args, "sz"),
+          tpTriggerPx: readString(args, "tpTriggerPx"),
+          slTriggerPx: readString(args, "slTriggerPx"),
+          tpRatio: readString(args, "tpRatio"),
+          slRatio: readString(args, "slRatio"),
+          algoClOrdId: readString(args, "algoClOrdId"),
           tag: context.config.sourceTag
         });
         if (algoOrdType === "contract_grid") {
+          requireString(args, "direction");
           body.triggerParams = [{ triggerAction: "start", triggerStrategy: "instant" }];
           body.basePos = readBoolean(args, "basePos") ?? true;
         }
@@ -3053,11 +3077,11 @@ function registerGridTools() {
             enum: ["grid", "contract_grid"],
             description: "grid=Spot, contract_grid=Contract"
           },
-          instId: { type: "string", description: "e.g. BTC-USDT" },
+          instId: { type: "string", description: "e.g. BTC-USDT, BTC-USD-SWAP" },
           stopType: {
             type: "string",
             enum: ["1", "2", "3", "5", "6"],
-            description: "1=close all; 2=keep assets (default); 3=limit close; 5=partial; 6=no sell"
+            description: "1=close all (default); 2=keep assets; 3=limit close; 5=partial; 6=no sell"
           }
         },
         required: ["algoId", "algoOrdType", "instId"]
@@ -3070,7 +3094,7 @@ function registerGridTools() {
             algoId: requireString(args, "algoId"),
             algoOrdType: requireString(args, "algoOrdType"),
             instId: requireString(args, "instId"),
-            stopType: readString(args, "stopType") ?? "2"
+            stopType: readString(args, "stopType") ?? "1"
           })],
           privateRateLimit("grid_stop_order", 20)
         );
@@ -3107,32 +3131,44 @@ function registerDcaTools() {
     {
       name: "dca_create_order",
       module: "bot.dca",
-      description: "Create Contract DCA (Martingale) bot. [CAUTION] Real trades. When maxSafetyOrds > 0: also need safetyOrdAmt, pxSteps, pxStepsMult, volMult.",
+      description: "Create a DCA (Martingale) bot. [CAUTION] Real trades. contract_dca requires lever; spot_dca must be long. If maxSafetyOrds>0: need safetyOrdAmt, pxSteps.",
       isWrite: true,
       inputSchema: {
         type: "object",
         properties: {
-          instId: { type: "string", description: "e.g. BTC-USDT-SWAP" },
-          lever: { type: "string", description: "Leverage, e.g. '3'" },
+          instId: { type: "string", description: "BTC-USDT (spot) or BTC-USDT-SWAP (contract)" },
+          algoOrdType: { type: "string", enum: ["spot_dca", "contract_dca"] },
+          lever: { type: "string", description: "Required for contract_dca" },
           direction: { type: "string", enum: ["long", "short"] },
-          initOrdAmt: { type: "string", description: "Initial order amount (USDT)" },
-          maxSafetyOrds: { type: "string", description: "Max safety orders, e.g. '3'" },
-          tpPct: { type: "string", description: "Take-profit ratio, e.g. '0.03' = 3%" },
-          safetyOrdAmt: { type: "string", description: "Safety order amount (USDT). Need when maxSafetyOrds > 0" },
-          pxSteps: { type: "string", description: "Price drop % per safety order, e.g. '0.03'. Need when maxSafetyOrds > 0" },
-          pxStepsMult: { type: "string", description: "Price step multiplier, e.g. '1.2'. Need when maxSafetyOrds > 0" },
-          volMult: { type: "string", description: "Safety order size multiplier, e.g. '1.5'. Need when maxSafetyOrds > 0" },
-          slPct: { type: "string", description: "Stop-loss ratio, e.g. '0.05' = 5%" },
-          slMode: { type: "string", enum: ["limit", "market"], description: "Stop-loss type. Default: market" },
-          allowReinvest: { type: "string", enum: ["true", "false"], description: "Reinvest profit. Default: 'true'" },
-          triggerStrategy: { type: "string", enum: ["instant", "price", "rsi"], default: "instant", description: "How bot starts. Default: instant" },
-          triggerPx: { type: "string", description: "Required when triggerStrategy='price'" }
+          initOrdAmt: { type: "string", description: "Initial amount in quote ccy" },
+          maxSafetyOrds: { type: "string", description: "0=no DCA, max 100" },
+          tpPct: { type: "string", description: "Take-profit ratio, 0.03=3%" },
+          safetyOrdAmt: { type: "string", description: "Safety order amount. Need if maxSafetyOrds>0" },
+          pxSteps: { type: "string", description: "Price drop per safety order. Need if maxSafetyOrds>0" },
+          pxStepsMult: { type: "string", description: "Step multiplier. Required when maxSafetyOrds>0, e.g. '1'" },
+          volMult: { type: "string", description: "Size multiplier. Required when maxSafetyOrds>0, e.g. '1'" },
+          slPct: { type: "string", description: "Stop-loss ratio, 0.05=5%" },
+          slMode: { type: "string", enum: ["limit", "market"] },
+          allowReinvest: { type: "boolean", description: "Default true" },
+          triggerStrategy: { type: "string", enum: ["instant", "price"] },
+          triggerPx: { type: "string", description: "Need if triggerStrategy=price" },
+          algoClOrdId: { type: "string", description: "Client order ID, 1-32 chars" },
+          // Backend expects boolean, but kept as string for backward compatibility with older clients.
+          reserveFunds: { type: "string", description: "'true' or 'false', default 'true'" },
+          tradeQuoteCcy: { type: "string" }
         },
-        required: ["instId", "lever", "direction", "initOrdAmt", "maxSafetyOrds", "tpPct"]
+        required: ["instId", "algoOrdType", "direction", "initOrdAmt", "maxSafetyOrds", "tpPct"]
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
         const instId = requireString(args, "instId");
+        const algoOrdType = requireString(args, "algoOrdType");
+        if (algoOrdType === "contract_dca" && !readString(args, "lever")) {
+          throw new OkxApiError("lever is required for contract_dca", {
+            code: "VALIDATION",
+            endpoint: `${BASE}/create`
+          });
+        }
         const triggerStrategy = readString(args, "triggerStrategy") ?? "instant";
         const triggerParam = {
           triggerAction: "start",
@@ -3141,24 +3177,55 @@ function registerDcaTools() {
         if (triggerStrategy === "price") {
           triggerParam["triggerPx"] = requireString(args, "triggerPx");
         }
+        const maxSafetyOrds = requireString(args, "maxSafetyOrds");
+        if (Number(maxSafetyOrds) > 0) {
+          if (!readString(args, "safetyOrdAmt")) {
+            throw new OkxApiError("safetyOrdAmt is required when maxSafetyOrds > 0", {
+              code: "VALIDATION",
+              endpoint: `${BASE}/create`
+            });
+          }
+          if (!readString(args, "pxSteps")) {
+            throw new OkxApiError("pxSteps is required when maxSafetyOrds > 0", {
+              code: "VALIDATION",
+              endpoint: `${BASE}/create`
+            });
+          }
+          if (!readString(args, "pxStepsMult")) {
+            throw new OkxApiError("pxStepsMult is required when maxSafetyOrds > 0", {
+              code: "VALIDATION",
+              endpoint: `${BASE}/create`
+            });
+          }
+          if (!readString(args, "volMult")) {
+            throw new OkxApiError("volMult is required when maxSafetyOrds > 0", {
+              code: "VALIDATION",
+              endpoint: `${BASE}/create`
+            });
+          }
+        }
         const response = await context.client.privatePost(
           `${BASE}/create`,
           compactObject({
             instId,
-            algoOrdType: "contract_dca",
-            lever: requireString(args, "lever"),
+            algoOrdType,
+            lever: readString(args, "lever"),
             direction: requireString(args, "direction"),
             initOrdAmt: requireString(args, "initOrdAmt"),
             safetyOrdAmt: readString(args, "safetyOrdAmt"),
-            maxSafetyOrds: requireString(args, "maxSafetyOrds"),
+            maxSafetyOrds,
             pxSteps: readString(args, "pxSteps"),
             pxStepsMult: readString(args, "pxStepsMult"),
             volMult: readString(args, "volMult"),
             tpPct: requireString(args, "tpPct"),
             slPct: readString(args, "slPct"),
             slMode: readString(args, "slMode"),
-            allowReinvest: readString(args, "allowReinvest"),
-            triggerParams: [triggerParam]
+            allowReinvest: args["allowReinvest"] !== void 0 ? args["allowReinvest"] === true || args["allowReinvest"] === "true" : void 0,
+            triggerParams: [triggerParam],
+            tag: context.config.sourceTag,
+            algoClOrdId: readString(args, "algoClOrdId"),
+            reserveFunds: readString(args, "reserveFunds"),
+            tradeQuoteCcy: readString(args, "tradeQuoteCcy")
           }),
           privateRateLimit("dca_create_order", 20)
         );
@@ -3168,21 +3235,31 @@ function registerDcaTools() {
     {
       name: "dca_stop_order",
       module: "bot.dca",
-      description: "Stop a running Contract DCA bot. [CAUTION] This will stop the bot.",
+      description: "Stop a running DCA bot. [CAUTION] spot_dca needs stopType: 1=sell, 2=keep.",
       isWrite: true,
       inputSchema: {
         type: "object",
         properties: {
-          algoId: { type: "string", description: "DCA bot algo order ID (not a trade ordId)" }
+          algoId: { type: "string", description: "Algo order ID" },
+          algoOrdType: { type: "string", enum: ["spot_dca", "contract_dca"] },
+          stopType: { type: "string", enum: ["1", "2"], description: "Required for spot_dca: 1=sell all, 2=keep tokens" }
         },
-        required: ["algoId"]
+        required: ["algoId", "algoOrdType"]
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
         const algoId = requireString(args, "algoId");
+        const algoOrdType = requireString(args, "algoOrdType");
+        const stopType = readString(args, "stopType");
+        if (algoOrdType === "spot_dca" && !stopType) {
+          throw new OkxApiError(
+            "stopType is required for spot_dca. Use '1' (sell all tokens) or '2' (keep tokens)",
+            { code: "VALIDATION", endpoint: `${BASE}/stop` }
+          );
+        }
         const response = await context.client.privatePost(
           `${BASE}/stop`,
-          { algoId, algoOrdType: "contract_dca" },
+          compactObject({ algoId, algoOrdType, stopType }),
           privateRateLimit("dca_stop_order", 20)
         );
         return normalizeWrite2(response);
@@ -3191,21 +3268,18 @@ function registerDcaTools() {
     {
       name: "dca_get_orders",
       module: "bot.dca",
-      description: "List DCA bots. status='active' for running; 'history' for stopped.",
+      description: "List DCA bots. Default: active (running). Use status=history for stopped.",
       isWrite: false,
       inputSchema: {
         type: "object",
         properties: {
-          status: {
-            type: "string",
-            enum: ["active", "history"],
-            description: "active=running (default); history=stopped"
-          },
-          algoId: { type: "string", description: "DCA bot algo order ID (not a trade ordId)" },
-          instId: { type: "string", description: "e.g. BTC-USDT-SWAP" },
-          after: { type: "string", description: "Cursor for older records" },
-          before: { type: "string", description: "Cursor for newer records" },
-          limit: { type: "number", description: "Default 100" }
+          status: { type: "string", enum: ["active", "history"] },
+          algoOrdType: { type: "string", enum: ["spot_dca", "contract_dca"], description: "Default: contract_dca" },
+          algoId: { type: "string", description: "Algo order ID" },
+          instId: { type: "string" },
+          after: { type: "string", description: "Pagination cursor" },
+          before: { type: "string", description: "Pagination cursor" },
+          limit: { type: "number" }
         },
         required: []
       },
@@ -3213,10 +3287,11 @@ function registerDcaTools() {
         const args = asRecord(rawArgs);
         const status = readString(args, "status") ?? "active";
         const path42 = status === "history" ? `${BASE}/history-list` : `${BASE}/ongoing-list`;
+        const algoOrdType = readString(args, "algoOrdType") ?? "contract_dca";
         const response = await context.client.privateGet(
           path42,
           compactObject({
-            algoOrdType: "contract_dca",
+            algoOrdType,
             algoId: readString(args, "algoId"),
             instId: readString(args, "instId"),
             after: readString(args, "after"),
@@ -3231,21 +3306,23 @@ function registerDcaTools() {
     {
       name: "dca_get_order_details",
       module: "bot.dca",
-      description: "Get DCA bot detail by algo ID. Returns current position details.",
+      description: "Get DCA bot position details (avgPx, upl, liqPx, etc).",
       isWrite: false,
       inputSchema: {
         type: "object",
         properties: {
-          algoId: { type: "string", description: "DCA bot algo order ID (not a trade ordId)" }
+          algoId: { type: "string", description: "Algo order ID" },
+          algoOrdType: { type: "string", enum: ["spot_dca", "contract_dca"] }
         },
-        required: ["algoId"]
+        required: ["algoId", "algoOrdType"]
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
         const algoId = requireString(args, "algoId");
+        const algoOrdType = requireString(args, "algoOrdType");
         const response = await context.client.privateGet(
           `${BASE}/position-details`,
-          { algoId, algoOrdType: "contract_dca" },
+          { algoId, algoOrdType },
           privateRateLimit("dca_get_order_details", 20)
         );
         return normalizeResponse(response);
@@ -3254,29 +3331,31 @@ function registerDcaTools() {
     {
       name: "dca_get_sub_orders",
       module: "bot.dca",
-      description: "Query DCA bot cycles or orders within a cycle. Omit cycleId for cycle list; provide cycleId for orders.",
+      description: "Get DCA cycles or orders in a cycle. Omit cycleId=cycle list; with cycleId=orders.",
       isWrite: false,
       inputSchema: {
         type: "object",
         properties: {
-          algoId: { type: "string", description: "DCA bot algo order ID (not a trade ordId)" },
-          cycleId: { type: "string", description: "Omit for cycle list; provide for orders within a cycle" },
-          after: { type: "string", description: "Cursor for older records (cycle-list mode only)" },
-          before: { type: "string", description: "Cursor for newer records (cycle-list mode only)" },
-          limit: { type: "number", description: "Default 100" }
+          algoId: { type: "string", description: "Algo order ID" },
+          algoOrdType: { type: "string", enum: ["spot_dca", "contract_dca"] },
+          cycleId: { type: "string", description: "Omit for cycles; provide for orders" },
+          after: { type: "string", description: "Pagination cursor" },
+          before: { type: "string", description: "Pagination cursor" },
+          limit: { type: "number" }
         },
-        required: ["algoId"]
+        required: ["algoId", "algoOrdType"]
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
         const algoId = requireString(args, "algoId");
+        const algoOrdType = requireString(args, "algoOrdType");
         const cycleId = readString(args, "cycleId");
         if (cycleId) {
           const response2 = await context.client.privateGet(
             `${BASE}/orders`,
             compactObject({
               algoId,
-              algoOrdType: "contract_dca",
+              algoOrdType,
               cycleId,
               limit: readNumber(args, "limit")
             }),
@@ -3288,7 +3367,7 @@ function registerDcaTools() {
           `${BASE}/cycle-list`,
           compactObject({
             algoId,
-            algoOrdType: "contract_dca",
+            algoOrdType,
             after: readString(args, "after"),
             before: readString(args, "before"),
             limit: readNumber(args, "limit")
@@ -3311,7 +3390,7 @@ function registerEarnTools() {
     {
       name: "earn_get_savings_balance",
       module: "earn.savings",
-      description: "Get Simple Earn (savings/flexible earn) balance. Returns current holdings for all currencies or a specific one. To show market rates alongside balance (\u5E02\u573A\u5747\u5229\u7387), call earn_get_lending_rate_history \u2014 do NOT use earn_get_lending_rate_summary for this purpose.",
+      description: "Get Simple Earn (savings/flexible earn) balance. Returns current holdings, lent amount, pending interest, and the user's set rate. Response fields: amt (total held), loanAmt (actively lent), pendingAmt (awaiting match), earnings (cumulative interest), rate (user's own minimum lending rate setting \u2014 NOT market yield, NOT APY). To get the actual market lending rate, call earn_get_lending_rate_history instead.",
       isWrite: false,
       inputSchema: {
         type: "object",
@@ -3350,7 +3429,7 @@ function registerEarnTools() {
           },
           rate: {
             type: "string",
-            description: "Lending rate. Annual rate in decimal, e.g. 0.01 = 1%. Defaults to 0.01 (1%, minimum rate, easiest to match)."
+            description: "Minimum lending rate threshold (annual, decimal). e.g. 0.01 = 1%. Only matched when market rate \u2265 this value. Defaults to 0.01. Keep at 0.01 to maximize matching probability \u2014 do NOT raise this to increase yield, as actual yield (lendingRate) is determined by market supply/demand, not this setting."
           }
         },
         required: ["ccy", "amt"]
@@ -3419,7 +3498,7 @@ function registerEarnTools() {
           },
           rate: {
             type: "string",
-            description: "Lending rate. Annual rate in decimal, e.g. 0.01 = 1%"
+            description: "Minimum lending rate threshold (annual, decimal). e.g. 0.01 = 1%. Only matched when market rate \u2265 this value. Keep at 0.01 to maximize matching probability \u2014 do NOT raise this to increase yield, as actual yield (lendingRate) is determined by market supply/demand, not this setting."
           }
         },
         required: ["ccy", "rate"]
@@ -3441,7 +3520,7 @@ function registerEarnTools() {
     {
       name: "earn_get_lending_history",
       module: "earn.savings",
-      description: "Get market lending rate history for Simple Earn. Use this tool to query market lending rates. Returns market lending records with amount, rate, and earnings data.",
+      description: "Get personal lending records for Simple Earn (your own lending history). NOT for market rate queries. Returns your lending records with amount, rate, and earnings data.",
       isWrite: false,
       inputSchema: {
         type: "object",
@@ -3479,34 +3558,10 @@ function registerEarnTools() {
         return normalizeResponse(response);
       }
     },
-    {
-      name: "earn_get_lending_rate_summary",
-      module: "earn.savings",
-      description: "Get coin lending market rate summary. NOT related to Simple Earn. Use this to query the lending/borrowing market rates (\u501F\u5E01\u5E02\u573A\u5229\u7387). Returns aggregate overview: average rate (avgRate), estimated next-cycle rate (estRate), previous-cycle rate (preRate), and available lending amounts.",
-      isWrite: false,
-      inputSchema: {
-        type: "object",
-        properties: {
-          ccy: {
-            type: "string",
-            description: "e.g. USDT. Omit for all."
-          }
-        }
-      },
-      handler: async (rawArgs, context) => {
-        const args = asRecord(rawArgs);
-        const response = await context.client.publicGet(
-          "/api/v5/finance/savings/lending-rate-summary",
-          compactObject({ ccy: readString(args, "ccy") }),
-          publicRateLimit("earn_get_lending_rate_summary", 6)
-        );
-        return normalizeResponse(response);
-      }
-    },
     {
       name: "earn_get_lending_rate_history",
       module: "earn.savings",
-      description: "Query Simple Earn lending rates. Use this tool when the user asks about current or historical lending rates for Simple Earn, or when displaying savings balance with market rate context (\u5E02\u573A\u5747\u5229\u7387). Returns actual settled lending rate records (lendingRate field) with timestamps, ordered newest-first.",
+      description: "Query Simple Earn lending rates. Public endpoint (no API key required). Use this tool when the user asks about current or historical lending rates for Simple Earn, or when displaying savings balance with market rate context. Response fields per record: rate (market lending rate \u2014 the rate borrowers pay this period; user's minimum setting must be \u2264 this to be eligible), lendingRate (actual yield received by lenders; stablecoins e.g. USDT/USDC only: subject to pro-rata dilution \u2014 when eligible supply exceeds borrowing demand total interest is shared so lendingRate < rate; non-stablecoins: lendingRate = rate, no dilution; always use lendingRate as the true APY to show users), ts (settlement timestamp ms). To get current APY: use limit=1 and read lendingRate.",
       isWrite: false,
       inputSchema: {
         type: "object",
@@ -3890,7 +3945,7 @@ function registerDcdTools() {
         properties: {
           baseCcy: { type: "string", description: "Base currency, e.g. BTC" },
           quoteCcy: { type: "string", description: "Quote currency, e.g. USDT" },
-          optType: { type: "string", description: "Option type: C (Call/\u9AD8\u5356) or P (Put/\u4F4E\u4E70)" }
+          optType: { type: "string", description: "Option type: C (Call, sell high) or P (Put, buy low)" }
         },
         required: ["baseCcy", "quoteCcy", "optType"]
       },
@@ -4129,11 +4184,53 @@ function registerDcdTools() {
     }
   ];
 }
+function registerAutoEarnTools() {
+  return [
+    {
+      name: "earn_auto_set",
+      module: "earn.autoearn",
+      description: "Enable or disable auto-earn for a currency. earnType='0' for auto-lend+stake (most currencies); earnType='1' for USDG earn (USDG, BUIDL). Use account_get_balance first: if autoLendStatus or autoStakingStatus != 'unsupported', use earnType='0'; for USDG/BUIDL use earnType='1'. [CAUTION] Cannot disable within 24h of enabling.",
+      isWrite: true,
+      inputSchema: {
+        type: "object",
+        properties: {
+          ccy: {
+            type: "string",
+            description: "Currency, e.g. SOL, USDG"
+          },
+          action: {
+            type: "string",
+            description: "turn_on or turn_off"
+          },
+          earnType: {
+            type: "string",
+            description: "0=auto-lend+stake (default), 1=USDG earn. Omit to use default."
+          }
+        },
+        required: ["ccy", "action"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const response = await context.client.privatePost(
+          "/api/v5/account/set-auto-earn",
+          compactObject({
+            ccy: requireString(args, "ccy"),
+            action: requireString(args, "action"),
+            earnType: readString(args, "earnType") ?? "0"
+          }),
+          privateRateLimit("earn_auto_set", 10)
+        );
+        return normalizeResponse(response);
+      }
+    }
+  ];
+}
 function registerAllEarnTools() {
   return [
     ...registerEarnTools(),
     ...registerOnchainEarnTools(),
-    ...registerDcdTools()
+    ...registerDcdTools(),
+    ...registerAutoEarnTools()
   ];
 }
 function buildContractTradeTools(cfg) {
@@ -5247,6 +5344,11 @@ function registerOptionAlgoTools() {
             type: "string",
             enum: ["last", "index", "mark"]
           },
+          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)"
+          },
           reduceOnly: {
             type: "boolean",
             description: "Ensure order only reduces position"
@@ -5269,6 +5371,7 @@ function registerOptionAlgoTools() {
             side: requireString(args, "side"),
             ordType: requireString(args, "ordType"),
             sz: requireString(args, "sz"),
+            tgtCcy: readString(args, "tgtCcy"),
             tpTriggerPx: readString(args, "tpTriggerPx"),
             tpOrdPx: readString(args, "tpOrdPx"),
             tpTriggerPxType: readString(args, "tpTriggerPxType"),
@@ -6116,6 +6219,11 @@ function registerSpotTradeTools() {
             type: "string",
             description: "SL order price, -1=market (conditional/oco only)"
           },
+          tgtCcy: {
+            type: "string",
+            enum: ["base_ccy", "quote_ccy"],
+            description: "Size unit. base_ccy(default): sz in base (e.g. BTC), quote_ccy: sz in quote (e.g. USDT)"
+          },
           callbackRatio: {
             type: "string",
             description: "Callback ratio e.g. 0.01=1%, use ratio or spread (move_order_stop only)"
@@ -6141,6 +6249,7 @@ function registerSpotTradeTools() {
             side: requireString(args, "side"),
             ordType: requireString(args, "ordType"),
             sz: requireString(args, "sz"),
+            tgtCcy: readString(args, "tgtCcy"),
             tpTriggerPx: readString(args, "tpTriggerPx"),
             tpOrdPx: readString(args, "tpOrdPx"),
             slTriggerPx: readString(args, "slTriggerPx"),
@@ -7142,6 +7251,12 @@ function fail(label, detail, hints) {
     outputLine(`    \u2192 ${hint}`);
   }
 }
+function warn(label, detail, hints = []) {
+  outputLine(`  \u26A0 ${label.padEnd(14)} ${detail}`);
+  for (const hint of hints) {
+    outputLine(`    \u2192 ${hint}`);
+  }
+}
 function section(title) {
   outputLine("");
   outputLine(`  ${title}`);
@@ -7252,59 +7367,154 @@ function checkMcpEntryPoint(report) {
     return { entryPath: null, passed: false };
   }
 }
-function checkClaudeDesktopConfig(report) {
-  section("Claude Desktop Config");
-  const configPath = getConfigPath("claude-desktop");
-  if (!configPath) {
-    ok("config path", "(not applicable on this platform)");
-    report.add("claude_cfg", "n/a");
-    return true;
-  }
-  if (!fs4.existsSync(configPath)) {
-    fail("config file", `not found: ${configPath}`, [
-      "Claude Desktop may not be installed",
-      "Run: okx setup --client claude-desktop to configure"
-    ]);
-    report.add("claude_cfg", `MISSING ${sanitize(configPath)}`);
-    return false;
-  }
-  ok("config file", configPath);
-  report.add("claude_cfg", sanitize(configPath));
+var MCP_SERVER_NAME = "okx-trade-mcp";
+var CLIENT_LIMITS = {
+  cursor: { perServer: 40, total: 80 }
+};
+function checkJsonMcpConfig(configPath) {
+  if (!fs4.existsSync(configPath)) return "missing";
   try {
     const raw = fs4.readFileSync(configPath, "utf8");
     const parsed = JSON.parse(raw);
     const mcpServers = parsed["mcpServers"];
-    if (!mcpServers) {
-      fail("mcp entry", "no mcpServers section found", [
-        "Run: okx setup --client claude-desktop"
-      ]);
-      report.add("claude_mcp", "NO_SECTION");
-      return false;
-    }
+    if (!mcpServers) return "not-configured";
     const entries = Object.entries(mcpServers);
-    const mcpEntry = entries.find(([, v]) => {
+    const found = entries.find(([name, v]) => {
+      if (name.includes(MCP_SERVER_NAME)) return true;
       const val = v;
       const cmd = String(val["command"] ?? "");
       const args = val["args"] ?? [];
-      return cmd.includes("okx-trade-mcp") || args.some((a) => a.includes("okx-trade-mcp"));
+      return cmd.includes(MCP_SERVER_NAME) || args.some((a) => a.includes(MCP_SERVER_NAME));
     });
-    if (mcpEntry) {
-      ok("mcp entry", `found: "${mcpEntry[0]}"`);
-      report.add("claude_mcp", `found:${mcpEntry[0]}`);
-      return true;
+    return found ? "found" : "not-configured";
+  } catch (_e) {
+    return "parse-error";
+  }
+}
+function checkClaudeCodeConfig() {
+  const home = os2.homedir();
+  const candidates = [
+    path2.join(home, ".claude", "settings.json"),
+    path2.join(home, ".claude.json")
+  ];
+  let anyFound = false;
+  let anyParseError = false;
+  for (const cfgPath of candidates) {
+    if (!fs4.existsSync(cfgPath)) continue;
+    anyFound = true;
+    const result = checkJsonMcpConfig(cfgPath);
+    if (result === "found") return "found";
+    if (result === "parse-error") anyParseError = true;
+  }
+  if (!anyFound) return "missing";
+  if (anyParseError) return "parse-error";
+  return "not-configured";
+}
+function checkMcpClients(report) {
+  section("MCP Client Config");
+  const jsonClients = ["claude-desktop", "cursor", "windsurf"];
+  const configuredClients = [];
+  let anyFailed = false;
+  for (const clientId of jsonClients) {
+    const configPath = getConfigPath(clientId);
+    if (!configPath) continue;
+    const name = CLIENT_NAMES[clientId];
+    const status = checkJsonMcpConfig(configPath);
+    if (status === "missing") {
+      continue;
+    }
+    if (status === "found") {
+      ok(name, `configured (${sanitize(configPath)})`);
+      report.add(`client_${clientId}`, `OK ${sanitize(configPath)}`);
+      configuredClients.push(clientId);
+    } else if (status === "not-configured") {
+      fail(name, "okx-trade-mcp not found in mcpServers", [
+        `Run: okx setup --client ${clientId}`
+      ]);
+      report.add(`client_${clientId}`, "NOT_CONFIGURED");
+      anyFailed = true;
     } else {
-      fail("mcp entry", "okx-trade-mcp not found in mcpServers", [
-        "Run: okx setup --client claude-desktop"
+      fail(name, `JSON parse error in ${sanitize(configPath)}`, [
+        `Check ${sanitize(configPath)} for JSON syntax errors`,
+        `Then run: okx setup --client ${clientId}`
       ]);
-      report.add("claude_mcp", "NOT_CONFIGURED");
-      return false;
+      report.add(`client_${clientId}`, "PARSE_ERROR");
+      anyFailed = true;
     }
-  } catch (e) {
-    fail("config parse", `JSON parse error: ${e instanceof Error ? e.message : String(e)}`, [
-      `Check ${configPath} for JSON syntax errors`
+  }
+  const claudeCodeStatus = checkClaudeCodeConfig();
+  if (claudeCodeStatus !== "missing") {
+    const name = CLIENT_NAMES["claude-code"];
+    if (claudeCodeStatus === "found") {
+      ok(name, "configured");
+      report.add("client_claude-code", "OK");
+      configuredClients.push("claude-code");
+    } else if (claudeCodeStatus === "not-configured") {
+      warn(name, "installed but okx-trade-mcp not configured", [
+        "Run: okx setup --client claude-code"
+      ]);
+      report.add("client_claude-code", "NOT_CONFIGURED");
+    } else {
+      fail(name, "settings file has JSON parse error", [
+        "Run: okx setup --client claude-code"
+      ]);
+      report.add("client_claude-code", "PARSE_ERROR");
+      anyFailed = true;
+    }
+  }
+  if (configuredClients.length === 0 && !anyFailed) {
+    fail("no client", "no MCP client configuration found", [
+      "Run: okx setup --client <client>",
+      "Supported clients: claude-desktop, cursor, windsurf, claude-code"
     ]);
-    report.add("claude_cfg_parse", "FAIL");
-    return false;
+    report.add("client_cfg", "NONE_FOUND");
+    return { passed: false, configuredClients };
+  }
+  const passed = configuredClients.length > 0 && !anyFailed;
+  report.add("client_cfg", passed ? `OK (${configuredClients.join(",")})` : "FAIL");
+  return { passed, configuredClients };
+}
+function checkToolCount(report, configuredClients, getSpecs = allToolSpecs) {
+  section("Tool Count");
+  const specs = getSpecs();
+  const totalCount = specs.length;
+  const defaultModuleSet = new Set(DEFAULT_MODULES);
+  const defaultCount = specs.filter((s) => defaultModuleSet.has(s.module)).length;
+  const defaultModulesArg = DEFAULT_MODULES.join(",");
+  const applicableLimits = configuredClients.map((id) => ({ id, limits: CLIENT_LIMITS[id] })).filter((x) => x.limits !== void 0);
+  if (applicableLimits.length === 0) {
+    ok("total tools", `${totalCount} tools loaded`);
+    report.add("tool_count", `${totalCount}`);
+    return;
+  }
+  let anyExceeded = false;
+  for (const { id, limits } of applicableLimits) {
+    const name = CLIENT_NAMES[id];
+    if (totalCount > limits.total) {
+      warn(
+        "tool count",
+        `${totalCount} tools loaded \u2014 exceeds ${name} limit (${limits.total} total / ${limits.perServer} per server)`,
+        [
+          `Use --modules to reduce: okx-trade-mcp --modules ${defaultModulesArg} (${defaultCount} tools)`
+        ]
+      );
+      report.add("tool_count", `${totalCount} EXCEEDS_${id.toUpperCase()}_LIMIT`);
+      anyExceeded = true;
+    } else if (totalCount > limits.perServer) {
+      warn(
+        "tool count",
+        `${totalCount} tools loaded \u2014 exceeds ${name} per-server limit (${limits.perServer})`,
+        [
+          `Use --modules to reduce: okx-trade-mcp --modules ${defaultModulesArg} (${defaultCount} tools)`
+        ]
+      );
+      report.add("tool_count", `${totalCount} EXCEEDS_${id.toUpperCase()}_PER_SERVER_LIMIT`);
+      anyExceeded = true;
+    }
+  }
+  if (!anyExceeded) {
+    ok("total tools", `${totalCount} tools loaded (within limits for all configured clients)`);
+    report.add("tool_count", `${totalCount} OK`);
   }
 }
 function readLogTail(logPath) {
@@ -7497,9 +7707,10 @@ async function cmdDiagnoseMcp(options = {}) {
   checkMcpPackageVersion(report);
   const nodePassed = checkNodeCompat(report);
   const { entryPath, passed: entryPassed } = checkMcpEntryPoint(report);
-  const cfgPassed = checkClaudeDesktopConfig(report);
+  const { passed: cfgPassed, configuredClients } = checkMcpClients(report);
   checkMcpLogs(report);
   const moduleLoadPassed = checkModuleLoading(entryPath, report);
+  checkToolCount(report, configuredClients);
   let handshakePassed = false;
   if (entryPath && entryPassed && moduleLoadPassed) {
     handshakePassed = await checkStdioHandshake(entryPath, report);
@@ -7524,7 +7735,7 @@ async function cmdDiagnoseMcp(options = {}) {
 
 // src/commands/diagnose.ts
 var CLI_VERSION = readCliVersion();
-var GIT_HASH = true ? "9f66f84" : "dev";
+var GIT_HASH = true ? "c270a0b" : "dev";
 function maskKey2(key) {
   if (!key) return "(not set)";
   if (key.length <= 8) return "****";
@@ -8253,11 +8464,7 @@ var HELP_TREE = {
           },
           "lending-history": {
             usage: "okx earn savings lending-history [--ccy <ccy>] [--limit <n>]",
-            description: "Get market lending rate history"
-          },
-          "rate-summary": {
-            usage: "okx earn savings rate-summary [<ccy>]",
-            description: "Get coin lending market rate summary (not Simple Earn, public)"
+            description: "Get personal lending records (requires auth)"
           },
           "rate-history": {
             usage: "okx earn savings rate-history [--ccy <ccy>] [--limit <n>]",
@@ -8294,6 +8501,23 @@ var HELP_TREE = {
           }
         }
       },
+      "auto-earn": {
+        description: "Auto-earn \u2014 automatically lend, stake, or earn on idle assets",
+        commands: {
+          status: {
+            usage: "okx earn auto-earn status [<ccy>]",
+            description: "Query auto-earn status for all or a specific currency"
+          },
+          on: {
+            usage: "okx earn auto-earn on <ccy>",
+            description: "Enable auto-earn for a currency (auto-detects lend/stake vs USDG earn)"
+          },
+          off: {
+            usage: "okx earn auto-earn off <ccy>",
+            description: "Disable auto-earn for a currency"
+          }
+        }
+      },
       dcd: {
         description: "DCD (Dual Currency Deposit) \u2014 structured products with fixed yield",
         commands: {
@@ -8344,7 +8568,7 @@ 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>] [--basePos] [--no-basePos]",
+            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]\n                   [--tpTriggerPx <px>] [--slTriggerPx <px>] [--tpRatio <n>] [--slRatio <n>] [--algoClOrdId <id>]",
             description: "Create a new grid bot order (contract grid opens base position by default)"
           },
           stop: {
@@ -8354,27 +8578,27 @@ var HELP_TREE = {
         }
       },
       dca: {
-        description: "Contract DCA (Martingale) bot \u2014 leveraged recurring buys on futures/swaps",
+        description: "DCA (Martingale) bot \u2014 spot or contract recurring buys",
         commands: {
           orders: {
-            usage: "okx bot dca orders [--algoId <id>] [--instId <id>] [--history]",
-            description: "List active or historical Contract DCA bot orders"
+            usage: "okx bot dca orders [--algoOrdType <spot_dca|contract_dca>] [--algoId <id>] [--instId <id>] [--history]",
+            description: "List DCA bots (spot and/or contract)"
           },
           details: {
-            usage: "okx bot dca details --algoId <id>",
-            description: "Get details of a specific Contract DCA bot order"
+            usage: "okx bot dca details --algoOrdType <spot_dca|contract_dca> --algoId <id>",
+            description: "Get DCA bot details (spot or contract)"
           },
           "sub-orders": {
-            usage: "okx bot dca sub-orders --algoId <id> [--cycleId <id>]",
-            description: "List cycles or orders within a cycle of a Contract DCA bot"
+            usage: "okx bot dca sub-orders --algoOrdType <spot_dca|contract_dca> --algoId <id> [--cycleId <id>]",
+            description: "Get DCA cycles/orders (spot or contract)"
           },
           create: {
-            usage: "okx bot dca create --instId <id> --lever <n> --direction <long|short>\n                 --initOrdAmt <n> --maxSafetyOrds <n> --tpPct <n>\n                 [--safetyOrdAmt <n>] [--pxSteps <n>] [--pxStepsMult <n>] [--volMult <n>]\n                 [--slPct <n>] [--slMode <limit|market>]\n                 [--allowReinvest <true|false>] [--triggerStrategy <instant|price|rsi>] [--triggerPx <price>]\n                 Note: safetyOrdAmt, pxSteps, pxStepsMult, volMult are required when maxSafetyOrds > 0",
-            description: "Create a new Contract DCA bot order"
+            usage: "okx bot dca create --algoOrdType <spot_dca|contract_dca> --instId <id> --direction <long|short>\n                 --initOrdAmt <n> --maxSafetyOrds <n> --tpPct <n>\n                 [--lever <n>] [--safetyOrdAmt <n>] [--pxSteps <n>] [--pxStepsMult <n>] [--volMult <n>]\n                 [--slPct <n>] [--slMode <limit|market>] [--allowReinvest <true|false>]\n                 [--triggerStrategy <instant|price|rsi>] [--triggerPx <price>]\n                 [--algoClOrdId <id>] [--reserveFunds <true|false>] [--tradeQuoteCcy <ccy>]\n                 Note: --lever required for contract_dca; safetyOrdAmt, pxSteps, pxStepsMult, volMult required when maxSafetyOrds > 0",
+            description: "Create a DCA (Martingale) bot (spot or contract)"
           },
           stop: {
-            usage: "okx bot dca stop --algoId <id>",
-            description: "Stop a running Contract DCA bot order"
+            usage: "okx bot dca stop --algoOrdType <spot_dca|contract_dca> --algoId <id> [--stopType <1|2>]\n                 Note: --stopType required for spot_dca (1=sell all, 2=keep tokens)",
+            description: "Stop a DCA bot (spot or contract)"
           }
         }
       }
@@ -8588,6 +8812,9 @@ var CLI_OPTIONS = {
   baseSz: { type: "string" },
   direction: { type: "string" },
   basePos: { type: "boolean", default: true },
+  tpRatio: { type: "string" },
+  slRatio: { type: "string" },
+  algoClOrdId: { type: "string" },
   stopType: { type: "string" },
   live: { type: "boolean", default: false },
   // market extras
@@ -8606,7 +8833,7 @@ var CLI_OPTIONS = {
   autoCxl: { type: "boolean", default: false },
   clOrdId: { type: "string" },
   newPx: { type: "string" },
-  // dca bot (contract only)
+  // dca bot (spot & contract)
   initOrdAmt: { type: "string" },
   safetyOrdAmt: { type: "string" },
   maxSafetyOrds: { type: "string" },
@@ -8620,6 +8847,8 @@ var CLI_OPTIONS = {
   triggerStrategy: { type: "string" },
   triggerPx: { type: "string" },
   cycleId: { type: "string" },
+  reserveFunds: { type: "string" },
+  tradeQuoteCcy: { type: "string" },
   // i18n
   lang: { type: "string" },
   // option
@@ -8839,10 +9068,15 @@ async function cmdMarketTicker(run, instId, json) {
   printKv({
     instId: t["instId"],
     last: t["last"],
-    "24h change %": t["sodUtc8"],
+    "24h open": t["open24h"],
     "24h high": t["high24h"],
     "24h low": t["low24h"],
     "24h vol": t["vol24h"],
+    "24h change %": (() => {
+      const last = Number(t["last"]);
+      const open24h = Number(t["open24h"]);
+      return open24h !== 0 ? ((last - open24h) / open24h * 100).toFixed(2) + "%" : "N/A";
+    })(),
     time: new Date(Number(t["ts"])).toLocaleString()
   });
 }
@@ -9263,6 +9497,7 @@ async function cmdSpotAlgoPlace(run, opts) {
     side: opts.side,
     ordType: opts.ordType,
     sz: opts.sz,
+    tgtCcy: opts.tgtCcy,
     tpTriggerPx: opts.tpTriggerPx,
     tpOrdPx: opts.tpOrdPx,
     slTriggerPx: opts.slTriggerPx,
@@ -9510,6 +9745,7 @@ async function cmdSwapAlgoPlace(run, opts) {
     side: opts.side,
     ordType: opts.ordType,
     sz: opts.sz,
+    tgtCcy: opts.tgtCcy,
     posSide: opts.posSide,
     tpTriggerPx: opts.tpTriggerPx,
     tpOrdPx: opts.tpOrdPx,
@@ -9915,6 +10151,7 @@ async function cmdFuturesAlgoPlace(run, opts) {
     side: opts.side,
     ordType: opts.ordType,
     sz: opts.sz,
+    tgtCcy: opts.tgtCcy,
     posSide: opts.posSide,
     tpTriggerPx: opts.tpTriggerPx,
     tpOrdPx: opts.tpOrdPx,
@@ -10209,6 +10446,7 @@ async function cmdOptionAlgoPlace(run, opts) {
     side: opts.side,
     ordType: opts.ordType,
     sz: opts.sz,
+    tgtCcy: opts.tgtCcy,
     tpTriggerPx: opts.tpTriggerPx,
     tpOrdPx: opts.tpOrdPx,
     slTriggerPx: opts.slTriggerPx,
@@ -10648,15 +10886,6 @@ async function cmdEarnLendingHistory(run, opts) {
     ts: new Date(Number(r["ts"])).toLocaleString()
   }));
 }
-async function cmdEarnLendingRateSummary(run, ccy, json) {
-  const data = extractData(await run("earn_get_lending_rate_summary", { ccy }));
-  printDataList(data, json, "No rate summary data", (r) => ({
-    ccy: r["ccy"],
-    avgRate: r["avgRate"],
-    estRate: r["estRate"],
-    avgAmt: r["avgAmt"]
-  }));
-}
 async function cmdEarnLendingRateHistory(run, opts) {
   const data = extractData(await run("earn_get_lending_rate_history", { ccy: opts.ccy, limit: opts.limit }));
   printDataList(data, opts.json, "No rate history data", (r) => ({
@@ -10667,6 +10896,92 @@ async function cmdEarnLendingRateHistory(run, opts) {
   }));
 }
 
+// src/commands/auto-earn.ts
+var USDG_EARN_CURRENCIES = /* @__PURE__ */ new Set(["USDG", "BUIDL"]);
+function isSupported(status) {
+  return !!status && status !== "unsupported";
+}
+function inferEarnType(detail) {
+  if (isSupported(detail.autoLendStatus) || isSupported(detail.autoStakingStatus)) return "0";
+  if (USDG_EARN_CURRENCIES.has(detail.ccy)) return "1";
+  return null;
+}
+async function getBalanceDetails(run, ccy) {
+  const result = await run("account_get_balance", ccy ? { ccy } : {});
+  const data = result.data;
+  const first = data?.[0];
+  return first?.details ?? [];
+}
+function earnTypeLabel(et) {
+  return et === "1" ? "USDG earn" : "lend+stake";
+}
+async function cmdAutoEarnStatus(run, ccy, json) {
+  const details = await getBalanceDetails(run, ccy);
+  const relevant = details.filter((d) => inferEarnType(d) !== null);
+  if (json) {
+    printJson(relevant);
+    return;
+  }
+  if (!relevant.length) {
+    outputLine(ccy ? `${ccy} does not support auto-earn` : "No currencies support auto-earn");
+    return;
+  }
+  printTable(relevant.map((d) => {
+    const et = inferEarnType(d);
+    return {
+      ccy: d.ccy,
+      earnType: earnTypeLabel(et),
+      autoLend: d.autoLendStatus,
+      autoStaking: d.autoStakingStatus,
+      invested: et === "1" ? d.eq || "-" : d.autoLendAmt || "-",
+      matched: d.autoLendMtAmt || "-",
+      apr: d.autoLendApr ? `${(Number(d.autoLendApr) * 100).toFixed(2)}%` : "-"
+    };
+  }));
+}
+async function cmdAutoEarnOn(run, ccy, json) {
+  const details = await getBalanceDetails(run, ccy);
+  const detail = details.find((d) => d.ccy === ccy);
+  if (!detail) {
+    errorLine(`Currency ${ccy} not found in account balance`);
+    process.exitCode = 1;
+    return;
+  }
+  const earnType = inferEarnType(detail);
+  if (earnType === null) {
+    errorLine(`${ccy} does not support auto-earn`);
+    process.exitCode = 1;
+    return;
+  }
+  const result = await run("earn_auto_set", { ccy, action: "turn_on", earnType });
+  if (json) {
+    printJson(result.data);
+    return;
+  }
+  outputLine(`Auto-earn enabled for ${ccy} (${earnTypeLabel(earnType)})`);
+}
+async function cmdAutoEarnOff(run, ccy, json) {
+  const details = await getBalanceDetails(run, ccy);
+  const detail = details.find((d) => d.ccy === ccy);
+  if (!detail) {
+    errorLine(`Currency ${ccy} not found in account balance`);
+    process.exitCode = 1;
+    return;
+  }
+  const earnType = inferEarnType(detail);
+  if (earnType === null) {
+    errorLine(`${ccy} does not support auto-earn`);
+    process.exitCode = 1;
+    return;
+  }
+  const result = await run("earn_auto_set", { ccy, action: "turn_off", earnType });
+  if (json) {
+    printJson(result.data);
+    return;
+  }
+  outputLine(`Auto-earn disabled for ${ccy} (${earnTypeLabel(earnType)})`);
+}
+
 // src/commands/bot.ts
 function emitWriteResult5(item, label, idKey) {
   const isError = item?.["sCode"] !== "0" && item?.["sCode"] !== 0;
@@ -10771,7 +11086,12 @@ async function cmdGridCreate(run, opts) {
     direction: opts.direction,
     lever: opts.lever,
     sz: opts.sz,
-    basePos: opts.basePos
+    basePos: opts.basePos,
+    tpTriggerPx: opts.tpTriggerPx,
+    slTriggerPx: opts.slTriggerPx,
+    tpRatio: opts.tpRatio,
+    slRatio: opts.slRatio,
+    algoClOrdId: opts.algoClOrdId
   });
   const data = getData7(result);
   if (opts.json) return printJson(data);
@@ -10793,6 +11113,7 @@ async function cmdGridStop(run, opts) {
 async function cmdDcaCreate(run, opts) {
   const result = await run("dca_create_order", {
     instId: opts.instId,
+    algoOrdType: opts.algoOrdType,
     lever: opts.lever,
     direction: opts.direction,
     initOrdAmt: opts.initOrdAmt,
@@ -10806,25 +11127,29 @@ async function cmdDcaCreate(run, opts) {
     slMode: opts.slMode,
     allowReinvest: opts.allowReinvest,
     triggerStrategy: opts.triggerStrategy,
-    triggerPx: opts.triggerPx
+    triggerPx: opts.triggerPx,
+    algoClOrdId: opts.algoClOrdId,
+    reserveFunds: opts.reserveFunds,
+    tradeQuoteCcy: opts.tradeQuoteCcy
   });
   const data = getData7(result);
   if (opts.json) return printJson(data);
-  const r = data?.[0];
   emitWriteResult5(data?.[0], "DCA bot created", "algoId");
 }
 async function cmdDcaStop(run, opts) {
   const result = await run("dca_stop_order", {
-    algoId: opts.algoId
+    algoId: opts.algoId,
+    algoOrdType: opts.algoOrdType,
+    stopType: opts.stopType
   });
   const data = getData7(result);
   if (opts.json) return printJson(data);
-  const r = data?.[0];
   emitWriteResult5(data?.[0], "DCA bot stopped", "algoId");
 }
 async function cmdDcaOrders(run, opts) {
   const result = await run("dca_get_orders", {
     status: opts.history ? "history" : "active",
+    algoOrdType: opts.algoOrdType,
     algoId: opts.algoId,
     instId: opts.instId
   });
@@ -10838,6 +11163,7 @@ async function cmdDcaOrders(run, opts) {
     orders.map((o) => ({
       algoId: o["algoId"],
       instId: o["instId"],
+      type: o["algoOrdType"],
       state: o["state"],
       pnl: o["pnl"],
       pnlRatio: o["pnlRatio"],
@@ -10847,7 +11173,8 @@ async function cmdDcaOrders(run, opts) {
 }
 async function cmdDcaDetails(run, opts) {
   const result = await run("dca_get_order_details", {
-    algoId: opts.algoId
+    algoId: opts.algoId,
+    algoOrdType: opts.algoOrdType
   });
   const detail = (getData7(result) ?? [])[0];
   if (!detail) {
@@ -10857,6 +11184,7 @@ async function cmdDcaDetails(run, opts) {
   if (opts.json) return printJson(detail);
   printKv({
     algoId: detail["algoId"],
+    algoOrdType: detail["algoOrdType"],
     instId: detail["instId"],
     sz: detail["sz"],
     avgPx: detail["avgPx"],
@@ -10874,26 +11202,42 @@ async function cmdDcaDetails(run, opts) {
 async function cmdDcaSubOrders(run, opts) {
   const result = await run("dca_get_sub_orders", {
     algoId: opts.algoId,
+    algoOrdType: opts.algoOrdType,
     cycleId: opts.cycleId
   });
-  const orders = getData7(result) ?? [];
-  if (opts.json) return printJson(orders);
-  if (!orders.length) {
+  const rows = getData7(result) ?? [];
+  if (opts.json) return printJson(rows);
+  if (!rows.length) {
     outputLine("No sub-orders");
     return;
   }
-  printTable(
-    orders.map((o) => ({
-      cycleId: o["cycleId"],
-      status: o["cycleStatus"],
-      current: o["currentCycle"] ? "yes" : "",
-      avgPx: o["avgPx"],
-      tpPx: o["tpPx"],
-      realizedPnl: o["realizedPnl"],
-      fee: o["fee"],
-      startTime: o["startTime"] ? new Date(Number(o["startTime"])).toLocaleString() : ""
-    }))
-  );
+  if (opts.cycleId) {
+    printTable(
+      rows.map((o) => ({
+        ordId: o["ordId"],
+        side: o["side"],
+        ordType: o["ordType"],
+        px: o["px"],
+        filledSz: o["filledSz"],
+        avgFillPx: o["avgFillPx"],
+        state: o["state"],
+        fee: o["fee"]
+      }))
+    );
+  } else {
+    printTable(
+      rows.map((o) => ({
+        cycleId: o["cycleId"],
+        status: o["cycleStatus"],
+        current: o["currentCycle"] ? "yes" : "",
+        avgPx: o["avgPx"],
+        tpPx: o["tpPx"],
+        realizedPnl: o["realizedPnl"],
+        fee: o["fee"],
+        startTime: o["startTime"] ? new Date(Number(o["startTime"])).toLocaleString() : ""
+      }))
+    );
+  }
 }
 
 // src/commands/onchain-earn.ts
@@ -11193,7 +11537,7 @@ async function cmdDcdQuoteAndBuy(run, opts) {
 // src/index.ts
 var _require3 = createRequire3(import.meta.url);
 var CLI_VERSION2 = _require3("../package.json").version;
-var GIT_HASH2 = true ? "9f66f84" : "dev";
+var GIT_HASH2 = true ? "c270a0b" : "dev";
 function handleConfigCommand(action, rest, json, lang, force) {
   if (action === "init") return cmdConfigInit(lang === "zh" ? "zh" : "en");
   if (action === "show") return cmdConfigShow(json);
@@ -11331,6 +11675,7 @@ function handleSpotAlgoCommand(run, subAction, v, json) {
       side: v.side,
       ordType: v.ordType ?? "conditional",
       sz: v.sz,
+      tgtCcy: v.tgtCcy,
       tpTriggerPx: v.tpTriggerPx,
       tpOrdPx: v.tpOrdPx,
       slTriggerPx: v.slTriggerPx,
@@ -11425,6 +11770,7 @@ function handleSwapAlgoCommand(run, subAction, v, json) {
       sz: v.sz,
       posSide: v.posSide,
       tdMode: v.tdMode ?? "cross",
+      tgtCcy: v.tgtCcy,
       tpTriggerPx: v.tpTriggerPx,
       tpOrdPx: v.tpOrdPx,
       slTriggerPx: v.slTriggerPx,
@@ -11537,6 +11883,7 @@ function handleOptionAlgoCommand(run, subAction, v, json) {
       side: v.side,
       ordType: v.ordType ?? "conditional",
       sz: v.sz,
+      tgtCcy: v.tgtCcy,
       tpTriggerPx: v.tpTriggerPx,
       tpOrdPx: v.tpOrdPx,
       slTriggerPx: v.slTriggerPx,
@@ -11637,6 +11984,7 @@ function handleFuturesAlgoCommand(run, subAction, v, json) {
       sz: v.sz,
       posSide: v.posSide,
       tdMode: v.tdMode ?? "cross",
+      tgtCcy: v.tgtCcy,
       tpTriggerPx: v.tpTriggerPx,
       tpOrdPx: v.tpOrdPx,
       slTriggerPx: v.slTriggerPx,
@@ -11779,6 +12127,11 @@ function handleBotGridCommand(run, v, rest, json) {
       lever: v.lever,
       sz: v.sz,
       basePos: v.basePos,
+      tpTriggerPx: v.tpTriggerPx,
+      slTriggerPx: v.slTriggerPx,
+      tpRatio: v.tpRatio,
+      slRatio: v.slRatio,
+      algoClOrdId: v.algoClOrdId,
       json
     });
   if (subAction === "stop")
@@ -11791,15 +12144,17 @@ function handleBotGridCommand(run, v, rest, json) {
     });
 }
 function handleBotDcaCommand(run, subAction, v, json) {
+  const algoOrdType = v.algoOrdType ?? "contract_dca";
   if (subAction === "orders")
-    return cmdDcaOrders(run, { algoId: v.algoId, instId: v.instId, history: v.history ?? false, json });
+    return cmdDcaOrders(run, { algoOrdType, algoId: v.algoId, instId: v.instId, history: v.history ?? false, json });
   if (subAction === "details")
-    return cmdDcaDetails(run, { algoId: v.algoId, json });
+    return cmdDcaDetails(run, { algoId: v.algoId, algoOrdType, json });
   if (subAction === "sub-orders")
-    return cmdDcaSubOrders(run, { algoId: v.algoId, cycleId: v.cycleId, json });
+    return cmdDcaSubOrders(run, { algoId: v.algoId, algoOrdType, cycleId: v.cycleId, json });
   if (subAction === "create")
     return cmdDcaCreate(run, {
       instId: v.instId,
+      algoOrdType,
       lever: v.lever,
       direction: v.direction,
       initOrdAmt: v.initOrdAmt,
@@ -11814,10 +12169,13 @@ function handleBotDcaCommand(run, subAction, v, json) {
       allowReinvest: v.allowReinvest,
       triggerStrategy: v.triggerStrategy,
       triggerPx: v.triggerPx,
+      algoClOrdId: v.algoClOrdId,
+      reserveFunds: v.reserveFunds,
+      tradeQuoteCcy: v.tradeQuoteCcy,
       json
     });
   if (subAction === "stop")
-    return cmdDcaStop(run, { algoId: v.algoId, json });
+    return cmdDcaStop(run, { algoId: v.algoId, algoOrdType, stopType: v.stopType, json });
 }
 function handleBotCommand(run, action, rest, v, json) {
   if (action === "grid") return handleBotGridCommand(run, v, rest, json);
@@ -11829,8 +12187,32 @@ function handleEarnCommand(run, submodule, rest, v, json) {
   if (submodule === "savings") return handleEarnSavingsCommand(run, action, innerRest, v, json);
   if (submodule === "onchain") return handleEarnOnchainCommand(run, action, v, json);
   if (submodule === "dcd") return handleEarnDcdCommand(run, action, v, json);
+  if (submodule === "auto-earn") return handleEarnAutoEarnCommand(run, action, innerRest, v, json);
   errorLine(`Unknown earn sub-module: ${submodule}`);
-  errorLine("Valid: savings, onchain, dcd");
+  errorLine("Valid: savings, onchain, dcd, auto-earn");
+  process.exitCode = 1;
+}
+function handleEarnAutoEarnCommand(run, action, rest, v, json) {
+  const ccy = rest[0] ?? v.ccy;
+  if (action === "status") return cmdAutoEarnStatus(run, ccy, json);
+  if (action === "on") {
+    if (!ccy) {
+      errorLine("Currency required: okx earn auto-earn on <ccy>");
+      process.exitCode = 1;
+      return;
+    }
+    return cmdAutoEarnOn(run, ccy, json);
+  }
+  if (action === "off") {
+    if (!ccy) {
+      errorLine("Currency required: okx earn auto-earn off <ccy>");
+      process.exitCode = 1;
+      return;
+    }
+    return cmdAutoEarnOff(run, ccy, json);
+  }
+  errorLine(`Unknown auto-earn command: ${action}`);
+  errorLine("Valid: status, on, off");
   process.exitCode = 1;
 }
 function handleEarnSavingsCommand(run, action, rest, v, json) {
@@ -11840,7 +12222,6 @@ function handleEarnSavingsCommand(run, action, rest, v, json) {
   if (action === "redeem") return cmdEarnSavingsRedeem(run, { ccy: v.ccy, amt: v.amt, json });
   if (action === "set-rate") return cmdEarnSetLendingRate(run, { ccy: v.ccy, rate: v.rate, json });
   if (action === "lending-history") return cmdEarnLendingHistory(run, { ccy: v.ccy, limit, json });
-  if (action === "rate-summary") return cmdEarnLendingRateSummary(run, rest[0] ?? v.ccy, json);
   if (action === "rate-history") return cmdEarnLendingRateHistory(run, { ccy: v.ccy, limit, json });
   errorLine(`Unknown earn savings command: ${action}`);
   process.exitCode = 1;