@okx_ai/okx-trade-cli 1.3.0-beta.1 → 1.3.0-beta.2

package/dist/index.js

@@ -854,6 +854,9 @@ function stringify(obj, { maxDepth = 1e3, numbersAsFloat = false } = {}) {
 import { readFileSync as readFileSync4, writeFileSync as writeFileSync4, mkdirSync as mkdirSync5, existsSync as existsSync4 } from "fs";
 import { join as join5 } from "path";
 import { homedir as homedir3 } from "os";
+import fs2 from "fs";
+import path2 from "path";
+import os2 from "os";
 import * as fs3 from "fs";
 import * as path3 from "path";
 import * as os3 from "os";
@@ -2322,58 +2325,111 @@ function registerAccountTools() {
     }
   ];
 }
-async function resolveQuoteCcySz(instId, sz, tgtCcy, instType, client) {
-  if (tgtCcy !== "quote_ccy") {
-    return { sz, tgtCcy, conversionNote: void 0 };
-  }
-  const [instrumentsRes, tickerRes] = await Promise.all([
-    client.publicGet("/api/v5/public/instruments", {
-      instType,
-      instId
-    }),
-    client.publicGet("/api/v5/market/ticker", { instId })
-  ]);
-  const instruments = Array.isArray(instrumentsRes.data) ? instrumentsRes.data : [];
+function extractInstrumentParams(instId, data) {
+  const instruments = Array.isArray(data) ? data : [];
   if (instruments.length === 0) {
-    throw new Error(
-      `Failed to fetch instrument info for ${instId}: empty instrument list. Cannot determine ctVal for quote_ccy conversion.`
-    );
+    throw new Error(`Failed to fetch instrument info for ${instId}: empty instrument list. Cannot determine ctVal for conversion.`);
   }
-  const ctValStr = String(instruments[0].ctVal ?? "");
+  const inst = instruments[0];
+  const ctValStr = String(inst.ctVal ?? "");
   const ctVal = parseFloat(ctValStr);
   if (!isFinite(ctVal) || ctVal <= 0) {
-    throw new Error(
-      `Invalid ctVal "${ctValStr}" for ${instId}. ctVal must be a positive number for quote_ccy conversion.`
-    );
+    throw new Error(`Invalid ctVal "${ctValStr}" for ${instId}. ctVal must be a positive number for conversion.`);
+  }
+  const minSzStr = String(inst.minSz ?? "1");
+  const minSz = parseFloat(minSzStr);
+  if (!isFinite(minSz) || minSz <= 0) {
+    throw new Error(`Invalid minSz "${minSzStr}" for ${instId}. minSz must be a positive number for conversion.`);
+  }
+  const lotSzStr = String(inst.lotSz ?? "1");
+  const lotSz = parseFloat(lotSzStr);
+  if (!isFinite(lotSz) || lotSz <= 0) {
+    throw new Error(`Invalid lotSz "${lotSzStr}" for ${instId}. lotSz must be a positive number for conversion.`);
   }
-  const tickers = Array.isArray(tickerRes.data) ? tickerRes.data : [];
+  return { ctVal, ctValStr, minSz, minSzStr, lotSz, lotSzStr };
+}
+function extractLastPx(instId, data) {
+  const tickers = Array.isArray(data) ? data : [];
   if (tickers.length === 0) {
-    throw new Error(
-      `Failed to fetch ticker price for ${instId}: empty ticker response. Cannot determine last price for quote_ccy conversion.`
-    );
+    throw new Error(`Failed to fetch ticker price for ${instId}: empty ticker response. Cannot determine last price for conversion.`);
   }
   const lastStr = String(tickers[0].last ?? "");
   const lastPx = parseFloat(lastStr);
   if (!isFinite(lastPx) || lastPx <= 0) {
+    throw new Error(`Invalid last price "${lastStr}" for ${instId}. Last price must be a positive number for conversion.`);
+  }
+  return { lastPx, lastStr };
+}
+function extractLeverage(instId, mgnMode, data) {
+  const leverageData = Array.isArray(data) ? data : [];
+  if (leverageData.length === 0) {
     throw new Error(
-      `Invalid last price "${lastStr}" for ${instId}. Last price must be a positive number for quote_ccy conversion.`
+      `Failed to fetch leverage info for ${instId} (mgnMode=${mgnMode}): empty response. Cannot determine leverage for margin conversion. Please set leverage first using set_leverage.`
     );
   }
-  const usdtAmount = parseFloat(sz);
+  const leverStr = String(leverageData[0].lever ?? "1");
+  const lever = parseFloat(leverStr);
+  if (!isFinite(lever) || lever <= 0) {
+    throw new Error(`Invalid leverage "${leverStr}" for ${instId}. Leverage must be a positive number for margin conversion.`);
+  }
+  return { lever, leverStr };
+}
+function computeContracts(p) {
+  const { instId, sz, isMarginMode, inst, lastPx, lastStr, lever, leverStr } = p;
+  const { ctVal, ctValStr, minSz, minSzStr, lotSz, lotSzStr } = inst;
+  const userAmount = parseFloat(sz);
   const contractValue = ctVal * lastPx;
-  const contracts = Math.floor(usdtAmount / contractValue);
-  if (contracts <= 0) {
-    const minUsdt = contractValue.toFixed(2);
+  const effectiveNotional = isMarginMode ? userAmount * lever : userAmount;
+  const lotSzDecimals = lotSzStr.includes(".") ? lotSzStr.split(".")[1].length : 0;
+  const precision = 10 ** (lotSzDecimals + 4);
+  const rawContracts = Math.round(effectiveNotional / contractValue * precision) / precision;
+  const rawLots = Math.round(rawContracts / lotSz * precision) / precision;
+  const contractsRounded = parseFloat((Math.floor(rawLots) * lotSz).toFixed(lotSzDecimals));
+  if (contractsRounded < minSz) {
+    const minAmount = isMarginMode ? (minSz * contractValue / lever).toFixed(2) : (minSz * contractValue).toFixed(2);
+    const unit = isMarginMode ? "USDT margin" : "USDT";
     throw new Error(
-      `sz=${sz} USDT is too small to buy even 1 contract of ${instId}. Minimum amount required is at least ${minUsdt} USDT (ctVal=${ctValStr}, lastPx=${lastStr}, 1 contract = ${minUsdt} USDT).`
+      `sz=${sz} ${unit} is too small for ${instId}. Minimum order size is ${minSzStr} contracts (\u2248 ${minAmount} ${unit}). (ctVal=${ctValStr}, lastPx=${lastStr}, minSz=${minSzStr}, lotSz=${lotSzStr}` + (isMarginMode ? `, lever=${leverStr}` : "") + `).
+`
     );
   }
-  const conversionNote = `Converting ${sz} USDT \u2192 ${contracts} contracts (ctVal=${ctValStr}, lastPx=${lastStr}, formula: floor(${sz} / (${ctValStr} \xD7 ${lastStr})) = ${contracts})`;
-  return {
-    sz: String(contracts),
-    tgtCcy: void 0,
-    conversionNote
-  };
+  const contractsStr = contractsRounded.toFixed(lotSzDecimals);
+  const conversionNote = isMarginMode ? `Converting ${sz} USDT margin (${leverStr}x leverage) \u2192 ${contractsStr} contracts (notional value \u2248 ${(contractsRounded * contractValue).toFixed(2)} USDT, ctVal=${ctValStr}, lastPx=${lastStr}, lever=${leverStr}, minSz=${minSzStr}, lotSz=${lotSzStr})` : `Converting ${sz} USDT \u2192 ${contractsStr} contracts (ctVal=${ctValStr}, lastPx=${lastStr}, minSz=${minSzStr}, lotSz=${lotSzStr})`;
+  return { contractsStr, conversionNote };
+}
+async function resolveQuoteCcySz(instId, sz, tgtCcy, instType, client, tdMode) {
+  if (tgtCcy !== "quote_ccy" && tgtCcy !== "margin") {
+    return { sz, tgtCcy, conversionNote: void 0 };
+  }
+  const isMarginMode = tgtCcy === "margin";
+  if (isMarginMode && !tdMode) {
+    throw new Error(
+      "tdMode (cross or isolated) is required when tgtCcy=margin. Cannot determine leverage without knowing the margin mode."
+    );
+  }
+  const mgnMode = tdMode === "cross" ? "cross" : "isolated";
+  const fetchPromises = [
+    client.publicGet("/api/v5/public/instruments", { instType, instId }),
+    client.publicGet("/api/v5/market/ticker", { instId })
+  ];
+  if (isMarginMode) {
+    fetchPromises.push(client.privateGet("/api/v5/account/leverage-info", { instId, mgnMode }));
+  }
+  const results = await Promise.all(fetchPromises);
+  const inst = extractInstrumentParams(instId, results[0].data);
+  const { lastPx, lastStr } = extractLastPx(instId, results[1].data);
+  const { lever, leverStr } = isMarginMode ? extractLeverage(instId, mgnMode, results[2].data) : { lever: 1, leverStr: "1" };
+  const { contractsStr, conversionNote } = computeContracts({
+    instId,
+    sz,
+    isMarginMode,
+    inst,
+    lastPx,
+    lastStr,
+    lever,
+    leverStr
+  });
+  return { sz: contractsStr, tgtCcy: void 0, conversionNote };
 }
 function registerAlgoTradeTools() {
   return [
@@ -2453,8 +2509,8 @@ function registerAlgoTradeTools() {
           },
           tgtCcy: {
             type: "string",
-            enum: ["base_ccy", "quote_ccy"],
-            description: "Size unit. base_ccy(default): sz in contracts, quote_ccy: sz in USDT"
+            enum: ["base_ccy", "quote_ccy", "margin"],
+            description: "Size unit. base_ccy(default): sz in contracts; quote_ccy: sz in USDT notional value; margin: sz in USDT margin cost (actual position = sz * leverage)"
           },
           reduceOnly: {
             type: "boolean",
@@ -2475,7 +2531,8 @@ function registerAlgoTradeTools() {
           requireString(args, "sz"),
           readString(args, "tgtCcy"),
           "SWAP",
-          context.client
+          context.client,
+          readString(args, "tdMode")
         );
         const response = await context.client.privatePost(
           "/api/v5/trade/order-algo",
@@ -2797,8 +2854,8 @@ function registerFuturesAlgoTools() {
           },
           tgtCcy: {
             type: "string",
-            enum: ["base_ccy", "quote_ccy"],
-            description: "Size unit. base_ccy(default): sz in contracts, quote_ccy: sz in USDT"
+            enum: ["base_ccy", "quote_ccy", "margin"],
+            description: "Size unit. base_ccy(default): sz in contracts; quote_ccy: sz in USDT notional value; margin: sz in USDT margin cost (actual position = sz * leverage)"
           },
           reduceOnly: {
             type: "boolean",
@@ -2819,7 +2876,8 @@ function registerFuturesAlgoTools() {
           requireString(args, "sz"),
           readString(args, "tgtCcy"),
           "FUTURES",
-          context.client
+          context.client,
+          readString(args, "tdMode")
         );
         const response = await context.client.privatePost(
           "/api/v5/trade/order-algo",
@@ -4021,7 +4079,7 @@ function registerEarnTools() {
     {
       name: "earn_get_savings_balance",
       module: "earn.savings",
-      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.",
+      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. earn_get_lending_rate_history also returns fixed-term (\u5B9A\u671F) product offers, so one call gives a complete view of both flexible and fixed options. Do NOT use for fixed-term (\u5B9A\u671F) order queries \u2014 use earn_get_fixed_order_list instead.",
       isWrite: false,
       inputSchema: {
         type: "object",
@@ -4042,6 +4100,43 @@ function registerEarnTools() {
         return normalizeResponse(response);
       }
     },
+    {
+      name: "earn_get_fixed_order_list",
+      module: "earn.savings",
+      description: "Get Simple Earn Fixed (\u5B9A\u671F\u8D5A\u5E01) lending order list. Returns orders sorted by creation time descending. Use this to check status of fixed-term lending orders (pending/earning/expired/settled/cancelled). Do NOT use for flexible earn balance \u2014 use earn_get_savings_balance instead. If the result is empty, do NOT display any fixed-term section in the output.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          ccy: {
+            type: "string",
+            description: "Currency, e.g. USDT. Omit for all."
+          },
+          state: {
+            type: "string",
+            description: "Order state: pending (\u5339\u914D\u4E2D), earning (\u8D5A\u5E01\u4E2D), expired (\u903E\u671F), settled (\u5DF2\u7ED3\u7B97), cancelled (\u5DF2\u64A4\u9500). Omit for all."
+          }
+        }
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const response = await context.client.privateGet(
+          "/api/v5/finance/simple-earn-fixed/order-list",
+          compactObject({
+            ccy: readString(args, "ccy"),
+            state: readString(args, "state")
+          }),
+          privateRateLimit("earn_get_fixed_order_list", 3)
+        );
+        const result = normalizeResponse(response);
+        if (Array.isArray(result["data"])) {
+          result["data"] = result["data"].map(
+            ({ finalSettlementDate: _, ...rest }) => rest
+          );
+        }
+        return result;
+      }
+    },
     {
       name: "earn_savings_purchase",
       module: "earn.savings",
@@ -4186,10 +4281,112 @@ function registerEarnTools() {
         return normalizeResponse(response);
       }
     },
+    {
+      name: "earn_fixed_purchase",
+      module: "earn.savings",
+      description: "Purchase Simple Earn Fixed (\u5B9A\u671F) product, two-step flow. First call (confirm omitted or false): returns purchase preview with product details and risk warning. Preview offer fields: lendQuota = remaining quota (\u5269\u4F59\u989D\u5EA6), soldOut = whether product is sold out (lendQuota is 0). YOU MUST display the 'warning' field from the preview response to the user VERBATIM before asking for confirmation \u2014 do NOT omit or summarize it. Second call (confirm=true): executes the purchase. Only proceed after the user explicitly confirms. IMPORTANT: Orders in 'pending' (\u5339\u914D\u4E2D) state can still be cancelled via earn_fixed_redeem; once the status changes to 'earning' (\u8D5A\u5E01\u4E2D), funds are LOCKED until maturity \u2014 no early redemption allowed.",
+      isWrite: true,
+      inputSchema: {
+        type: "object",
+        properties: {
+          ccy: {
+            type: "string",
+            description: "Currency, e.g. USDT"
+          },
+          amt: {
+            type: "string",
+            description: "Purchase amount"
+          },
+          term: {
+            type: "string",
+            description: "Term, e.g. 90D"
+          },
+          confirm: {
+            type: "boolean",
+            description: "Omit or false on the first call to preview the purchase details; set to true on the second call to execute after user confirms."
+          }
+        },
+        required: ["ccy", "amt", "term"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const ccy = requireString(args, "ccy");
+        const amt = requireString(args, "amt");
+        const term = requireString(args, "term");
+        const confirm = readBoolean(args, "confirm") ?? false;
+        if (!confirm) {
+          const [rateResponse, fixedResponse] = await Promise.all([
+            context.client.publicGet(
+              "/api/v5/finance/savings/lending-rate-history",
+              compactObject({ ccy, limit: 1 }),
+              publicRateLimit("earn_get_lending_rate_history", 6)
+            ),
+            context.client.privateGet(
+              "/api/v5/finance/simple-earn-fixed/offers",
+              compactObject({ ccy }),
+              privateRateLimit("earn_fixed_purchase_preview_offers", 2)
+            ).catch(() => null)
+          ]);
+          const rateResult = normalizeResponse(rateResponse);
+          const fixedResult = fixedResponse ? normalizeResponse(fixedResponse) : { data: [] };
+          const rateArr = Array.isArray(rateResult["data"]) ? rateResult["data"] : [];
+          const allOffers = Array.isArray(fixedResult["data"]) ? fixedResult["data"] : [];
+          const matchedOffer = allOffers.find(
+            (o) => o["term"] === term && o["ccy"] === ccy
+          );
+          const { borrowingOrderQuota: _, ...offerWithoutTotal } = matchedOffer ?? {};
+          const offerWithSoldOut = matchedOffer ? { ...offerWithoutTotal, soldOut: offerWithoutTotal["lendQuota"] === "0" } : null;
+          return {
+            preview: true,
+            ccy,
+            amt,
+            term,
+            offer: offerWithSoldOut,
+            currentFlexibleRate: rateArr[0]?.["lendingRate"] ?? null,
+            warning: "\u26A0\uFE0F Orders still in 'pending' state can be cancelled before matching completes. Once the status changes to 'earning', funds are LOCKED until maturity \u2014 early redemption is NOT allowed. Please call again with confirm=true to proceed."
+          };
+        }
+        assertNotDemo(context.config, "earn_fixed_purchase");
+        const response = await context.client.privatePost(
+          "/api/v5/finance/simple-earn-fixed/purchase",
+          { ccy, amt, term },
+          privateRateLimit("earn_fixed_purchase", 2)
+        );
+        return normalizeResponse(response);
+      }
+    },
+    {
+      name: "earn_fixed_redeem",
+      module: "earn.savings",
+      description: "Redeem Simple Earn Fixed (\u5B9A\u671F\u8D5A\u5E01) order. [CAUTION] Redeems a fixed-term lending order. Always redeems the full order amount. Only orders in 'pending' (\u5339\u914D\u4E2D) state can be redeemed \u2014 orders in 'earning' state are locked until maturity and cannot be redeemed early. Do NOT use for flexible earn redemption \u2014 use earn_savings_redeem instead.",
+      isWrite: true,
+      inputSchema: {
+        type: "object",
+        properties: {
+          reqId: {
+            type: "string",
+            description: "Request ID of the fixed-term order to redeem"
+          }
+        },
+        required: ["reqId"]
+      },
+      handler: async (rawArgs, context) => {
+        assertNotDemo(context.config, "earn_fixed_redeem");
+        const args = asRecord(rawArgs);
+        const response = await context.client.privatePost(
+          "/api/v5/finance/simple-earn-fixed/redeem",
+          {
+            reqId: requireString(args, "reqId")
+          },
+          privateRateLimit("earn_fixed_redeem", 2)
+        );
+        return normalizeResponse(response);
+      }
+    },
     {
       name: "earn_get_lending_rate_history",
       module: "earn.savings",
-      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.",
+      description: "Query Simple Earn lending rates and fixed-term offers. Use this tool when the user asks about Simple Earn products, current or historical lending rates, or when displaying savings balance with market rate context (\u5E02\u573A\u5747\u5229\u7387). Returns lending rate history (lendingRate field, newest-first) AND available fixed-term (\u5B9A\u671F) offers with APR, term, min amount, and quota \u2014 one call gives a complete view of both flexible and fixed options. In fixedOffers: lendQuota = remaining quota (\u5269\u4F59\u989D\u5EA6), soldOut = whether product is sold out (lendQuota is 0). To get current flexible APY: use limit=1 and read lendingRate.",
       isWrite: false,
       inputSchema: {
         type: "object",
@@ -4208,23 +4405,45 @@ function registerEarnTools() {
           },
           limit: {
             type: "number",
-            description: "Max results (default 100)"
+            description: "Max results (default 7)"
           }
         }
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
-        const response = await context.client.publicGet(
-          "/api/v5/finance/savings/lending-rate-history",
-          compactObject({
-            ccy: readString(args, "ccy"),
-            after: readString(args, "after"),
-            before: readString(args, "before"),
-            limit: readNumber(args, "limit")
-          }),
-          publicRateLimit("earn_get_lending_rate_history", 6)
-        );
-        return normalizeResponse(response);
+        const ccy = readString(args, "ccy");
+        const [rateResponse, fixedResponse] = await Promise.all([
+          context.client.publicGet(
+            "/api/v5/finance/savings/lending-rate-history",
+            compactObject({
+              ccy,
+              after: readString(args, "after"),
+              before: readString(args, "before"),
+              limit: readNumber(args, "limit") ?? 7
+            }),
+            publicRateLimit("earn_get_lending_rate_history", 6)
+          ),
+          context.client.privateGet(
+            "/api/v5/finance/simple-earn-fixed/offers",
+            compactObject({ ccy }),
+            privateRateLimit("earn_get_lending_rate_history_fixed", 2)
+          ).catch(() => null)
+        ]);
+        const rateResult = normalizeResponse(rateResponse);
+        const rateData = Array.isArray(rateResult["data"]) ? rateResult["data"].map(
+          ({ rate: _, ...rest }) => rest
+        ) : [];
+        const fixedResult = fixedResponse ? normalizeResponse(fixedResponse) : { data: [] };
+        const allOffers = fixedResult["data"] ?? [];
+        const fixedOffers = allOffers.map(({ borrowingOrderQuota: _, ...rest }) => ({
+          ...rest,
+          soldOut: rest["lendQuota"] === "0"
+        }));
+        return {
+          ...rateResult,
+          data: rateData,
+          fixedOffers
+        };
       }
     }
   ];
@@ -4861,7 +5080,7 @@ function registerAutoEarnTools() {
 }
 var EARN_DEMO_MESSAGE = "Earn features (savings, DCD, on-chain staking, auto-earn) are not available in simulated trading mode.";
 var EARN_DEMO_SUGGESTION = "Switch to a live account to use Earn features.";
-var DEMO_GUARD_SKIP = /* @__PURE__ */ new Set(["dcd_redeem"]);
+var DEMO_GUARD_SKIP = /* @__PURE__ */ new Set(["dcd_redeem", "earn_fixed_purchase"]);
 function withDemoGuard(tool) {
   if (!tool.isWrite || DEMO_GUARD_SKIP.has(tool.name)) return tool;
   const originalHandler = tool.handler;
@@ -4922,12 +5141,12 @@ function buildContractTradeTools(cfg) {
           },
           sz: {
             type: "string",
-            description: "Number of contracts. Each contract = ctVal units (e.g. 0.1 ETH for ETH-USDT-SWAP). Query market_get_instruments for exact ctVal. Set tgtCcy=quote_ccy to specify sz in USDT instead."
+            description: "Number of contracts. Each contract = ctVal units (e.g. 0.1 ETH for ETH-USDT-SWAP). Query market_get_instruments for exact ctVal. Set tgtCcy=quote_ccy to specify sz in USDT notional value; set tgtCcy=margin to specify sz as margin cost (notional = sz * leverage)."
           },
           tgtCcy: {
             type: "string",
-            enum: ["base_ccy", "quote_ccy"],
-            description: "Size unit. base_ccy(default): sz in contracts, quote_ccy: sz in USDT"
+            enum: ["base_ccy", "quote_ccy", "margin"],
+            description: "Size unit. base_ccy(default): sz in contracts; quote_ccy: sz in USDT notional value; margin: sz in USDT margin cost (actual position = sz * leverage)"
           },
           px: { type: "string", description: "Required for limit/post_only/fok/ioc" },
           reduceOnly: {
@@ -4951,7 +5170,8 @@ function buildContractTradeTools(cfg) {
           requireString(args, "sz"),
           readString(args, "tgtCcy"),
           defaultType,
-          context.client
+          context.client,
+          readString(args, "tdMode")
         );
         const response = await context.client.privatePost(
           "/api/v5/trade/order",
@@ -6049,8 +6269,8 @@ function registerOptionAlgoTools() {
           },
           tgtCcy: {
             type: "string",
-            enum: ["base_ccy", "quote_ccy"],
-            description: "Size unit. base_ccy(default): sz in contracts, quote_ccy: sz in USDT (auto-converted to contracts)"
+            enum: ["base_ccy", "quote_ccy", "margin"],
+            description: "Size unit. base_ccy(default): sz in contracts; quote_ccy: sz in USDT notional value; margin: sz in USDT margin cost (actual position = sz * leverage)"
           },
           reduceOnly: {
             type: "boolean",
@@ -6071,7 +6291,8 @@ function registerOptionAlgoTools() {
           requireString(args, "sz"),
           readString(args, "tgtCcy"),
           "OPTION",
-          context.client
+          context.client,
+          readString(args, "tdMode")
         );
         const response = await context.client.privatePost(
           "/api/v5/trade/order-algo",
@@ -6288,12 +6509,12 @@ function registerOptionTools() {
           },
           sz: {
             type: "string",
-            description: "Contracts count by default. Set tgtCcy=quote_ccy to use USDT amount instead."
+            description: "Contracts count by default. Set tgtCcy=quote_ccy to specify USDT notional value; set tgtCcy=margin to specify USDT margin cost (notional = sz * leverage)."
           },
           tgtCcy: {
             type: "string",
-            enum: ["base_ccy", "quote_ccy"],
-            description: "Size unit. base_ccy(default): sz in contracts, quote_ccy: sz in USDT (auto-converted to contracts)"
+            enum: ["base_ccy", "quote_ccy", "margin"],
+            description: "Size unit. base_ccy(default): sz in contracts; quote_ccy: sz in USDT notional value; margin: sz in USDT margin cost (actual position = sz * leverage)"
           },
           px: {
             type: "string",
@@ -6335,7 +6556,8 @@ function registerOptionTools() {
           requireString(args, "sz"),
           readString(args, "tgtCcy"),
           "OPTION",
-          context.client
+          context.client,
+          readString(args, "tdMode")
         );
         const response = await context.client.privatePost(
           "/api/v5/trade/order",
@@ -7735,6 +7957,69 @@ Run: npm install -g ${packageName}
     refreshCacheInBackground(packageName);
   }
 }
+var LOG_LEVEL_PRIORITY = {
+  error: 0,
+  warn: 1,
+  info: 2,
+  debug: 3
+};
+var SENSITIVE_KEY_PATTERN = /apiKey|secretKey|passphrase|password|secret/i;
+function sanitize(value) {
+  if (value === null || value === void 0) {
+    return value;
+  }
+  if (Array.isArray(value)) {
+    return value.map(sanitize);
+  }
+  if (typeof value === "object") {
+    const result = {};
+    for (const [k, v] of Object.entries(value)) {
+      if (SENSITIVE_KEY_PATTERN.test(k)) {
+        result[k] = "[REDACTED]";
+      } else {
+        result[k] = sanitize(v);
+      }
+    }
+    return result;
+  }
+  return value;
+}
+var TradeLogger = class {
+  logLevel;
+  logDir;
+  constructor(logLevel = "info", logDir) {
+    this.logLevel = logLevel;
+    this.logDir = logDir ?? path2.join(os2.homedir(), ".okx", "logs");
+  }
+  getLogPath(date) {
+    const d = date ?? /* @__PURE__ */ new Date();
+    const yyyy = d.getUTCFullYear();
+    const mm = String(d.getUTCMonth() + 1).padStart(2, "0");
+    const dd = String(d.getUTCDate()).padStart(2, "0");
+    return path2.join(this.logDir, `trade-${yyyy}-${mm}-${dd}.log`);
+  }
+  log(level, tool, params, result, durationMs) {
+    if (LOG_LEVEL_PRIORITY[level] > LOG_LEVEL_PRIORITY[this.logLevel]) {
+      return;
+    }
+    const entry = {
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      level: level.toUpperCase(),
+      tool,
+      durationMs,
+      params: sanitize(params),
+      result: sanitize(result)
+    };
+    try {
+      fs2.mkdirSync(this.logDir, { recursive: true });
+      fs2.appendFileSync(this.getLogPath(), JSON.stringify(entry) + "\n", "utf8");
+    } catch {
+    }
+  }
+  static sanitize(params) {
+    return sanitize(params);
+  }
+};
 var CLIENT_NAMES = {
   "claude-desktop": "Claude Desktop",
   cursor: "Cursor",
@@ -7884,11 +8169,11 @@ function runSetup(options) {
 // src/commands/diagnose.ts
 import dns from "dns/promises";
 import net from "net";
-import os4 from "os";
+import os5 from "os";
 import tls from "tls";
 
 // src/commands/diagnose-utils.ts
-import fs2 from "fs";
+import fs4 from "fs";
 import { createRequire } from "module";
 
 // src/formatter.ts
@@ -7917,8 +8202,12 @@ function outputLine(message) {
 function errorLine(message) {
   activeOutput.err(message + EOL);
 }
+var jsonEnvEnabled = false;
+function setJsonEnvEnabled(enabled) {
+  jsonEnvEnabled = enabled;
+}
 function printJson(data) {
-  const payload = envContext ? {
+  const payload = jsonEnvEnabled && envContext ? {
     env: envContext.demo ? "demo" : "live",
     profile: envContext.profile,
     data
@@ -8006,7 +8295,7 @@ var Report = class {
         lines.push(`${key.padEnd(14)} ${value}`);
       }
       lines.push(sep2, "");
-      fs2.writeFileSync(filePath, lines.join("\n"), "utf8");
+      fs4.writeFileSync(filePath, lines.join("\n"), "utf8");
       return true;
     } catch (_e) {
       return false;
@@ -8041,7 +8330,7 @@ function writeReportIfRequested(report, outputPath) {
     errorLine(`  Warning: failed to write report to: ${outputPath}`);
   }
 }
-function sanitize(value) {
+function sanitize2(value) {
   value = value.replace(
     /\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/gi,
     "****-uuid-****"
@@ -8052,14 +8341,14 @@ function sanitize(value) {
 }
 
 // src/commands/diagnose-mcp.ts
-import fs4 from "fs";
-import path2 from "path";
-import os2 from "os";
+import fs5 from "fs";
+import path4 from "path";
+import os4 from "os";
 import { spawnSync, spawn } from "child_process";
 import { createRequire as createRequire2 } from "module";
 import { fileURLToPath } from "url";
 var _require2 = createRequire2(import.meta.url);
-var __dirname = path2.dirname(fileURLToPath(import.meta.url));
+var __dirname = path4.dirname(fileURLToPath(import.meta.url));
 function readMcpVersion() {
   const candidates = [
     // Installed as global or local dependency
@@ -8112,13 +8401,13 @@ function checkMcpEntryPoint(report) {
   if (!entryPath) {
     const candidates = [
       // Installed locally
-      path2.join(process.cwd(), "node_modules", ".bin", "okx-trade-mcp"),
+      path4.join(process.cwd(), "node_modules", ".bin", "okx-trade-mcp"),
       // Monorepo workspace (e.g. running from source)
-      path2.join(__dirname, "..", "..", "..", "..", "mcp", "dist", "index.js")
+      path4.join(__dirname, "..", "..", "..", "..", "mcp", "dist", "index.js")
     ];
     for (const candidate of candidates) {
       try {
-        fs4.accessSync(candidate, fs4.constants.X_OK | fs4.constants.R_OK);
+        fs5.accessSync(candidate, fs5.constants.X_OK | fs5.constants.R_OK);
         entryPath = candidate;
         break;
       } catch (_e) {
@@ -8143,9 +8432,9 @@ var CLIENT_LIMITS = {
   cursor: { perServer: 40, total: 80 }
 };
 function checkJsonMcpConfig(configPath) {
-  if (!fs4.existsSync(configPath)) return "missing";
+  if (!fs5.existsSync(configPath)) return "missing";
   try {
-    const raw = fs4.readFileSync(configPath, "utf8");
+    const raw = fs5.readFileSync(configPath, "utf8");
     const parsed = JSON.parse(raw);
     const mcpServers = parsed["mcpServers"];
     if (!mcpServers) return "not-configured";
@@ -8163,15 +8452,15 @@ function checkJsonMcpConfig(configPath) {
   }
 }
 function checkClaudeCodeConfig() {
-  const home = os2.homedir();
+  const home = os4.homedir();
   const candidates = [
-    path2.join(home, ".claude", "settings.json"),
-    path2.join(home, ".claude.json")
+    path4.join(home, ".claude", "settings.json"),
+    path4.join(home, ".claude.json")
   ];
   let anyFound = false;
   let anyParseError = false;
   for (const cfgPath of candidates) {
-    if (!fs4.existsSync(cfgPath)) continue;
+    if (!fs5.existsSync(cfgPath)) continue;
     anyFound = true;
     const result = checkJsonMcpConfig(cfgPath);
     if (result === "found") return "found";
@@ -8188,8 +8477,8 @@ function handleJsonClient(clientId, report, configuredClients) {
   const status = checkJsonMcpConfig(configPath);
   if (status === "missing") return false;
   if (status === "found") {
-    ok(name, `configured (${sanitize(configPath)})`);
-    report.add(`client_${clientId}`, `OK ${sanitize(configPath)}`);
+    ok(name, `configured (${sanitize2(configPath)})`);
+    report.add(`client_${clientId}`, `OK ${sanitize2(configPath)}`);
     configuredClients.push(clientId);
     return false;
   }
@@ -8197,8 +8486,8 @@ function handleJsonClient(clientId, report, configuredClients) {
     fail(name, "okx-trade-mcp not found in mcpServers", [`Run: okx setup --client ${clientId}`]);
     report.add(`client_${clientId}`, "NOT_CONFIGURED");
   } else {
-    fail(name, `JSON parse error in ${sanitize(configPath)}`, [
-      `Check ${sanitize(configPath)} for JSON syntax errors`,
+    fail(name, `JSON parse error in ${sanitize2(configPath)}`, [
+      `Check ${sanitize2(configPath)} for JSON syntax errors`,
       `Then run: okx setup --client ${clientId}`
     ]);
     report.add(`client_${clientId}`, "PARSE_ERROR");
@@ -8291,37 +8580,37 @@ function checkToolCount(report, configuredClients, getSpecs = allToolSpecs) {
   }
 }
 function readLogTail(logPath) {
-  const stat = fs4.statSync(logPath);
+  const stat = fs5.statSync(logPath);
   const readSize = Math.min(8192, stat.size);
   const buffer = Buffer.alloc(readSize);
-  const fd = fs4.openSync(logPath, "r");
+  const fd = fs5.openSync(logPath, "r");
   try {
-    fs4.readSync(fd, buffer, 0, readSize, Math.max(0, stat.size - readSize));
+    fs5.readSync(fd, buffer, 0, readSize, Math.max(0, stat.size - readSize));
   } finally {
-    fs4.closeSync(fd);
+    fs5.closeSync(fd);
   }
   return buffer.toString("utf8").split("\n").filter((l) => l.trim()).slice(-5);
 }
 function getMcpLogCandidates() {
   if (process.platform === "darwin") {
-    const logsDir = path2.join(os2.homedir(), "Library", "Logs", "Claude");
+    const logsDir = path4.join(os4.homedir(), "Library", "Logs", "Claude");
     const candidates = [
-      path2.join(logsDir, "mcp.log"),
-      path2.join(logsDir, "mcp-server-okx-trade-mcp.log")
+      path4.join(logsDir, "mcp.log"),
+      path4.join(logsDir, "mcp-server-okx-trade-mcp.log")
     ];
     try {
-      const extra = fs4.readdirSync(logsDir).filter((f) => f.startsWith("mcp") && f.endsWith(".log")).map((f) => path2.join(logsDir, f));
+      const extra = fs5.readdirSync(logsDir).filter((f) => f.startsWith("mcp") && f.endsWith(".log")).map((f) => path4.join(logsDir, f));
       candidates.push(...extra);
     } catch (_e) {
     }
     return candidates;
   }
   if (process.platform === "win32") {
-    const appData2 = process.env.APPDATA ?? path2.join(os2.homedir(), "AppData", "Roaming");
-    return [path2.join(appData2, "Claude", "logs", "mcp.log")];
+    const appData2 = process.env.APPDATA ?? path4.join(os4.homedir(), "AppData", "Roaming");
+    return [path4.join(appData2, "Claude", "logs", "mcp.log")];
   }
-  const configHome = process.env.XDG_CONFIG_HOME ?? path2.join(os2.homedir(), ".config");
-  return [path2.join(configHome, "Claude", "logs", "mcp.log")];
+  const configHome = process.env.XDG_CONFIG_HOME ?? path4.join(os4.homedir(), ".config");
+  return [path4.join(configHome, "Claude", "logs", "mcp.log")];
 }
 function checkMcpLogs(report) {
   section("MCP Server Logs (recent)");
@@ -8335,7 +8624,7 @@ function checkMcpLogs(report) {
       report.add("mcp_log", logPath);
       if (lines.length > 0) {
         ok("last lines", `(${lines.length} shown)`);
-        for (const line of lines) outputLine(`    ${sanitize(line)}`);
+        for (const line of lines) outputLine(`    ${sanitize2(line)}`);
       } else {
         ok("last lines", "(empty log)");
       }
@@ -8461,11 +8750,11 @@ function checkModuleLoading(entryPath, report) {
     return true;
   } else {
     const errMsg = result.stderr?.trim() || result.error?.message || "non-zero exit";
-    fail("module load", `failed: ${sanitize(errMsg)}`, [
+    fail("module load", `failed: ${sanitize2(errMsg)}`, [
       "MCP server may have import errors or missing dependencies",
       `Try: node ${entryPath} --version`
     ]);
-    report.add("module_load", `FAIL ${sanitize(errMsg)}`);
+    report.add("module_load", `FAIL ${sanitize2(errMsg)}`);
     return false;
   }
 }
@@ -8476,7 +8765,7 @@ async function cmdDiagnoseMcp(options = {}) {
   const report = new Report();
   report.add("ts", (/* @__PURE__ */ new Date()).toISOString());
   report.add("mode", "mcp");
-  report.add("os", `${process.platform} ${process.arch} ${os2.release()}`);
+  report.add("os", `${process.platform} ${process.arch} ${os4.release()}`);
   checkMcpPackageVersion(report);
   const nodePassed = checkNodeCompat(report);
   const { entryPath, passed: entryPassed } = checkMcpEntryPoint(report);
@@ -8508,7 +8797,7 @@ async function cmdDiagnoseMcp(options = {}) {
 
 // src/commands/diagnose.ts
 var CLI_VERSION = readCliVersion();
-var GIT_HASH = true ? "ab11ece" : "dev";
+var GIT_HASH = true ? "0a5911f" : "dev";
 function maskKey2(key) {
   if (!key) return "(not set)";
   if (key.length <= 8) return "****";
@@ -8588,14 +8877,14 @@ function checkEnvironment(report) {
   }
   ok("CLI", `v${CLI_VERSION} (${GIT_HASH})`);
   ok("OS", `${process.platform} ${process.arch}`);
-  ok("OS release", os4.release());
+  ok("OS release", os5.release());
   ok("Shell", process.env.SHELL ?? "(unknown)");
   ok("Locale", `${process.env.LANG ?? process.env.LC_ALL ?? "(unknown)"}`);
   ok("Timezone", Intl.DateTimeFormat().resolvedOptions().timeZone);
   report.add("cli", `${CLI_VERSION} (${GIT_HASH})`);
   report.add("node", `${nodeVersion} ${process.platform} ${process.arch}`);
-  const machine = typeof os4.machine === "function" ? os4.machine() : process.arch;
-  report.add("os", `${os4.type()} ${os4.release()} ${machine}`);
+  const machine = typeof os5.machine === "function" ? os5.machine() : process.arch;
+  report.add("os", `${os5.type()} ${os5.release()} ${machine}`);
   report.add("shell", process.env.SHELL ?? "-");
   report.add("locale", process.env.LANG ?? process.env.LC_ALL ?? "-");
   report.add("tz", Intl.DateTimeFormat().resolvedOptions().timeZone);
@@ -8752,10 +9041,10 @@ async function cmdDiagnose(config, profile, options = {}) {
 }
 function checkConfigFile(report) {
   section("Config File");
-  const path5 = configFilePath();
+  const path6 = configFilePath();
   try {
     readFullConfig();
-    ok("Config parse", `${path5} OK`);
+    ok("Config parse", `${path6} OK`);
     report.add("config_parse", "OK");
     return true;
   } catch (e) {
@@ -8925,7 +9214,7 @@ function loadProfileConfig(opts) {
 import { EOL as EOL2 } from "os";
 
 // src/commands/client-setup.ts
-import * as fs5 from "fs";
+import * as fs6 from "fs";
 var DETECTABLE_CLIENTS = ["claude-desktop", "cursor", "windsurf"];
 function cmdSetupClient(options) {
   runSetup(options);
@@ -8934,14 +9223,14 @@ function cmdSetupClients() {
   const detected = [];
   for (const id of DETECTABLE_CLIENTS) {
     const p = getConfigPath(id);
-    if (p && fs5.existsSync(p)) {
+    if (p && fs6.existsSync(p)) {
       detected.push({ id, path: p });
     }
   }
   if (detected.length > 0) {
     outputLine("Detected clients:");
-    for (const { id, path: path5 } of detected) {
-      outputLine(`  ${id.padEnd(16)} ${path5}`);
+    for (const { id, path: path6 } of detected) {
+      outputLine(`  ${id.padEnd(16)} ${path6}`);
     }
     outputLine("");
   }
@@ -9325,7 +9614,7 @@ var HELP_TREE = {
     description: "Earn products \u2014 Simple Earn, On-chain Earn, and DCD (Dual Currency Deposit)",
     subgroups: {
       savings: {
-        description: "Simple Earn \u2014 flexible savings and lending",
+        description: "Simple Earn \u2014 flexible savings, fixed-term, and lending",
         commands: {
           balance: {
             usage: "okx earn savings balance [<ccy>]",
@@ -9349,7 +9638,19 @@ var HELP_TREE = {
           },
           "rate-history": {
             usage: "okx earn savings rate-history [--ccy <ccy>] [--limit <n>]",
-            description: "Query Simple Earn lending rates (public, no auth needed)"
+            description: "Query Simple Earn lending rates and fixed-term offers (requires auth)"
+          },
+          "fixed-orders": {
+            usage: "okx earn savings fixed-orders [--ccy <ccy>] [--state <pending|earning|expired|settled|cancelled>]",
+            description: "List fixed-term earn orders"
+          },
+          "fixed-purchase": {
+            usage: "okx earn savings fixed-purchase --ccy <ccy> --amt <n> --term <term> [--confirm]",
+            description: "Purchase Simple Earn Fixed (\u5B9A\u671F). Preview by default; add --confirm to execute. Funds locked until maturity"
+          },
+          "fixed-redeem": {
+            usage: "okx earn savings fixed-redeem <reqId>",
+            description: "Redeem a fixed-term earn order (full amount)"
           }
         }
       },
@@ -9529,6 +9830,7 @@ function printGlobalHelp() {
     "  --demo             Use simulated trading (demo) mode",
     "  --live             Force live trading mode (overrides profile demo=true; mutually exclusive with --demo)",
     "  --json             Output raw JSON",
+    "  --env              With --json, wrap output as {env, profile, data}",
     "  --verbose          Show detailed network request/response info (stderr)",
     "  --version, -v      Show version",
     "  --help             Show this help",
@@ -9643,8 +9945,8 @@ function printCommandList(lines, commands) {
     lines.push("");
   }
 }
-function printHelp(...path5) {
-  const [moduleName, subgroupName] = path5;
+function printHelp(...path6) {
+  const [moduleName, subgroupName] = path6;
   if (!moduleName) {
     printGlobalHelp();
   } else if (!subgroupName) {
@@ -9660,6 +9962,7 @@ var CLI_OPTIONS = {
   profile: { type: "string" },
   demo: { type: "boolean", default: false },
   json: { type: "boolean", default: false },
+  env: { type: "boolean", default: false },
   help: { type: "boolean", default: false },
   version: { type: "boolean", short: "v", default: false },
   // setup command
@@ -9765,6 +10068,8 @@ var CLI_OPTIONS = {
   orders: { type: "string" },
   // earn
   rate: { type: "string" },
+  reqId: { type: "string" },
+  confirm: { type: "boolean", default: false },
   // audit
   since: { type: "string" },
   tool: { type: "string" },
@@ -10141,9 +10446,9 @@ async function cmdMarketStockTokens(run, opts) {
 }
 
 // src/commands/account.ts
-import * as fs6 from "fs";
-import * as path4 from "path";
-import * as os5 from "os";
+import * as fs7 from "fs";
+import * as path5 from "path";
+import * as os6 from "os";
 function getData2(result) {
   return result.data;
 }
@@ -10354,10 +10659,10 @@ function readAuditLogs(logDir, days = 7) {
     const yyyy = d.getUTCFullYear();
     const mm = String(d.getUTCMonth() + 1).padStart(2, "0");
     const dd = String(d.getUTCDate()).padStart(2, "0");
-    const filePath = path4.join(logDir, `trade-${yyyy}-${mm}-${dd}.log`);
+    const filePath = path5.join(logDir, `trade-${yyyy}-${mm}-${dd}.log`);
     let content;
     try {
-      content = fs6.readFileSync(filePath, "utf8");
+      content = fs7.readFileSync(filePath, "utf8");
     } catch {
       continue;
     }
@@ -10373,7 +10678,7 @@ function readAuditLogs(logDir, days = 7) {
   return entries;
 }
 function cmdAccountAudit(opts) {
-  const logDir = path4.join(os5.homedir(), ".okx", "logs");
+  const logDir = path5.join(os6.homedir(), ".okx", "logs");
   const limit = Math.min(Number(opts.limit) || 20, 100);
   let entries = readAuditLogs(logDir);
   if (opts.tool) entries = entries.filter((e) => e.tool === opts.tool);
@@ -11829,6 +12134,22 @@ async function cmdEarnSavingsBalance(run, ccy, json) {
     pendingAmt: r["pendingAmt"]
   }));
 }
+async function cmdEarnFixedOrderList(run, opts) {
+  const data = extractData(await run("earn_get_fixed_order_list", {
+    ccy: opts.ccy,
+    state: opts.state
+  }));
+  printDataList(data, opts.json, "No fixed earn orders", (r) => ({
+    reqId: r["reqId"],
+    ccy: r["ccy"],
+    amt: r["amt"],
+    rate: r["rate"],
+    term: r["term"],
+    state: r["state"],
+    accruedInterest: r["accruedInterest"],
+    cTime: new Date(Number(r["cTime"])).toLocaleString()
+  }));
+}
 async function cmdEarnSavingsPurchase(run, opts) {
   const data = extractData(await run("earn_savings_purchase", { ccy: opts.ccy, amt: opts.amt, rate: opts.rate }));
   if (opts.json) {
@@ -11874,14 +12195,107 @@ async function cmdEarnLendingHistory(run, opts) {
     ts: new Date(Number(r["ts"])).toLocaleString()
   }));
 }
+function printFixedPurchasePreview(rec) {
+  const offer = rec["offer"];
+  outputLine("");
+  outputLine("\u{1F4CB} Fixed Earn Purchase Preview");
+  outputLine(`  Currency: ${rec["ccy"]}`);
+  outputLine(`  Amount:   ${rec["amt"]}`);
+  outputLine(`  Term:     ${rec["term"]}`);
+  if (rec["currentFlexibleRate"]) {
+    outputLine(`  Current flexible rate: ${rec["currentFlexibleRate"]}`);
+  }
+  if (offer) {
+    printKv({
+      rate: offer["rate"],
+      minLend: offer["minLend"],
+      remainingQuota: offer["lendQuota"],
+      soldOut: offer["soldOut"] ? "Yes" : "No"
+    });
+  } else {
+    outputLine("  \u26A0\uFE0F  No matching offer found for this term.");
+  }
+  outputLine("");
+  outputLine(rec["warning"] ?? "");
+  outputLine("");
+  outputLine("Re-run with --confirm to execute.");
+}
+async function cmdEarnFixedPurchase(run, opts) {
+  const result = await run("earn_fixed_purchase", {
+    ccy: opts.ccy,
+    amt: opts.amt,
+    term: opts.term,
+    confirm: opts.confirm
+  });
+  if (!result || typeof result !== "object") {
+    outputLine("No response data");
+    return;
+  }
+  const rec = result;
+  if (rec["preview"]) {
+    if (opts.json) {
+      printJson(rec);
+      return;
+    }
+    printFixedPurchasePreview(rec);
+    return;
+  }
+  const data = extractData(result);
+  if (opts.json) {
+    printJson(data);
+    return;
+  }
+  const r = data[0];
+  if (!r) {
+    outputLine("No response data");
+    return;
+  }
+  printKv({ reqId: r["reqId"], ccy: r["ccy"], amt: r["amt"], term: r["term"] });
+}
+async function cmdEarnFixedRedeem(run, opts) {
+  const data = extractData(await run("earn_fixed_redeem", { reqId: opts.reqId }));
+  if (opts.json) {
+    printJson(data);
+    return;
+  }
+  if (!data.length) {
+    outputLine("No response data");
+    return;
+  }
+  printTable(data.map((r) => ({ reqId: r["reqId"] })));
+}
 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) => ({
+  const result = await run("earn_get_lending_rate_history", { ccy: opts.ccy, limit: opts.limit });
+  const data = extractData(result);
+  const fixedOffers = extractFixedOffers(result);
+  if (opts.json) {
+    printJson({ data, fixedOffers });
+    return;
+  }
+  printDataList(data, false, "No rate history data", (r) => ({
     ccy: r["ccy"],
     lendingRate: r["lendingRate"],
-    rate: r["rate"],
     ts: new Date(Number(r["ts"])).toLocaleString()
   }));
+  if (fixedOffers.length > 0) {
+    outputLine("");
+    outputLine("Fixed-term offers:");
+    printTable(fixedOffers.map((r) => ({
+      ccy: r["ccy"],
+      term: r["term"],
+      rate: r["rate"],
+      minLend: r["minLend"],
+      remainingQuota: r["lendQuota"],
+      soldOut: r["soldOut"] ? "Yes" : "No"
+    })));
+  }
+}
+function extractFixedOffers(result) {
+  if (result && typeof result === "object") {
+    const offers = result["fixedOffers"];
+    if (Array.isArray(offers)) return offers;
+  }
+  return [];
 }
 
 // src/commands/auto-earn.ts
@@ -12716,7 +13130,7 @@ function printSkillInstallResult(meta, json) {
 // src/index.ts
 var _require3 = createRequire3(import.meta.url);
 var CLI_VERSION2 = _require3("../package.json").version;
-var GIT_HASH2 = true ? "ab11ece" : "dev";
+var GIT_HASH2 = true ? "0a5911f" : "dev";
 function handleConfigCommand(action, rest, json, lang, force) {
   if (action === "init") return cmdConfigInit(lang === "zh" ? "zh" : "en");
   if (action === "show") return cmdConfigShow(json);
@@ -13416,6 +13830,9 @@ function handleEarnSavingsCommand(run, action, rest, v, 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-history") return cmdEarnLendingRateHistory(run, { ccy: v.ccy, limit, json });
+  if (action === "fixed-orders") return cmdEarnFixedOrderList(run, { ccy: v.ccy, state: v.state, json });
+  if (action === "fixed-purchase") return cmdEarnFixedPurchase(run, { ccy: v.ccy, amt: v.amt, term: v.term, confirm: v.confirm ?? false, json });
+  if (action === "fixed-redeem") return cmdEarnFixedRedeem(run, { reqId: v.reqId, json });
   errorLine(`Unknown earn savings command: ${action}`);
   process.exitCode = 1;
 }
@@ -13534,6 +13951,23 @@ function printHelpForLevel(positionals) {
   else if (!subgroup) printHelp(module);
   else printHelp(module, subgroup);
 }
+function wrapRunnerWithLogger(baseRunner, logger) {
+  const writeToolNames = new Set(allToolSpecs().filter((t) => t.isWrite).map((t) => t.name));
+  return async (toolName, args) => {
+    const startTime = Date.now();
+    try {
+      const result = await baseRunner(toolName, args);
+      if (writeToolNames.has(toolName)) {
+        markFailedIfSCodeError(result.data);
+      }
+      logger.log("info", toolName, args, result, Date.now() - startTime);
+      return result;
+    } catch (error) {
+      logger.log("error", toolName, args, error, Date.now() - startTime);
+      throw error;
+    }
+  };
+}
 async function runDiagnose(v) {
   let config;
   try {
@@ -13566,16 +14000,11 @@ async function main() {
   if (module === "diagnose") return runDiagnose(v);
   const config = loadProfileConfig({ profile: v.profile, demo: v.demo, live: v.live, verbose: v.verbose, userAgent: `okx-trade-cli/${CLI_VERSION2}`, sourceTag: "CLI" });
   setEnvContext({ demo: config.demo, profile: v.profile ?? "default" });
+  setJsonEnvEnabled(v.env ?? false);
   const client = new OkxRestClient(config);
   const baseRunner = createToolRunner(client, config);
-  const writeToolNames = new Set(allToolSpecs().filter((t) => t.isWrite).map((t) => t.name));
-  const run = async (toolName, args) => {
-    const result = await baseRunner(toolName, args);
-    if (writeToolNames.has(toolName)) {
-      markFailedIfSCodeError(result.data);
-    }
-    return result;
-  };
+  const logger = new TradeLogger("info");
+  const run = wrapRunnerWithLogger(baseRunner, logger);
   const moduleHandlers = {
     market: () => handleMarketCommand(run, action, rest, v, json),
     account: () => handleAccountCommand(run, action, rest, v, json),
@@ -13620,7 +14049,8 @@ export {
   handleSpotCommand,
   handleSwapAlgoCommand,
   handleSwapCommand,
-  printHelp
+  printHelp,
+  wrapRunnerWithLogger
 };
 /*! Bundled license information: