@okx_ai/okx-trade-cli 1.3.1-beta.9 → 1.3.2-beta.1

package/dist/index.js

@@ -969,7 +969,7 @@ function classifyAndCache(node, hostname, failedNodes, cachePath) {
   if (!node) {
     return { mode: null, node: null };
   }
-  if (node.ip === hostname || node.host === hostname) {
+  if (node.ip === hostname && node.host === hostname) {
     writeCache(hostname, {
       mode: "direct",
       node: null,
@@ -1453,13 +1453,14 @@ var OkxRestClient = class _OkxRestClient {
       rateLimit
     });
   }
-  async privatePost(path42, body, rateLimit) {
+  async privatePost(path42, body, rateLimit, retryOnNetworkError) {
     return this.request({
       method: "POST",
       path: path42,
       auth: "private",
       body,
-      rateLimit
+      rateLimit,
+      retryOnNetworkError
     });
   }
   setAuthHeaders(headers, method, requestPath, bodyJson, timestamp) {
@@ -1742,7 +1743,7 @@ var OkxRestClient = class _OkxRestClient {
         vlog2(`Network failure, refreshing DoH: ${cause}`);
       }
       const shouldRetry = await this.doh.handleNetworkFailure();
-      if (shouldRetry && reqConfig.method === "GET") {
+      if (shouldRetry && (reqConfig.method === "GET" || reqConfig.retryOnNetworkError)) {
         return this.request(reqConfig);
       }
     }
@@ -2218,6 +2219,7 @@ var MODULES = [
   "account",
   "event",
   "news",
+  "smartmoney",
   ...EARN_SUB_MODULE_IDS,
   ...BOT_SUB_MODULE_IDS,
   "skills"
@@ -2240,6 +2242,7 @@ var MODULE_DESCRIPTIONS = {
   "bot.grid": "Grid trading bot \u2014 create, monitor, and stop grid orders",
   "bot.dca": "DCA (Martingale) bot \u2014 spot or contract recurring buys",
   news: "Crypto news, sentiment analysis, and coin trend tracking",
+  smartmoney: "Smart money signals \u2014 trader leaderboard, consensus signals, and position analysis",
   skills: SKILLS_MARKETPLACE_DESC,
   earn: "Earn products \u2014 Simple Earn, On-chain Earn, DCD, Flash Earn, and Auto-Earn",
   bot: "Trading bot strategies (grid, dca)",
@@ -4246,10 +4249,133 @@ function registerGridTools() {
         return normalizeWrite(response);
       }
     },
+    {
+      name: "grid_amend_order",
+      module: "bot.grid",
+      description: "Amend a running grid bot. [CAUTION] Modifies a running bot. Use grid_list_orders to confirm the bot is running and obtain the algoId before calling.\nSupports two modes, which can be combined in a single call:\n\u2022 Price-range mode (maxPx+minPx+gridNum): change upper/lower price boundary and grid count. Contract grid: if new range requires more margin, pass topUpAmt; omit to auto-use the minimum required. Spot grid: topUpAmt is not supported.\n\u2022 TP/SL mode (instId + any of tpTriggerPx/slTriggerPx/tpRatio/slRatio): update take-profit and/or stop-loss. Pass '-1' to explicitly clear an existing TP or SL. tpTriggerPx/slTriggerPx are absolute prices; tpRatio/slRatio are profit ratios (e.g. '0.1' = 10%).\nWhen both sets of params are provided, both APIs are called sequentially.\nDo NOT use to create a new grid bot \u2014 use grid_create_order instead. Do NOT use to stop a grid bot \u2014 use grid_stop_order instead.",
+      isWrite: true,
+      inputSchema: {
+        type: "object",
+        properties: {
+          algoId: {
+            type: "string",
+            description: "Grid bot algo order ID (required)"
+          },
+          // ── Price-range mode ──────────────────────────────────────────────
+          maxPx: {
+            type: "string",
+            description: "[Price-range mode] New upper price boundary. Triggers amend-algo-basic-param when provided."
+          },
+          minPx: {
+            type: "string",
+            description: "[Price-range mode] New lower price boundary. Required when maxPx is set."
+          },
+          gridNum: {
+            type: "string",
+            description: "[Price-range mode] New number of grid intervals (integer). Required when maxPx is set."
+          },
+          // ── TP/SL mode ────────────────────────────────────────────────────
+          instId: {
+            type: "string",
+            description: "[TP/SL mode] Instrument ID, e.g. BTC-USDT. Required when setting TP/SL."
+          },
+          tpTriggerPx: {
+            type: "string",
+            description: "[TP/SL mode] Take-profit trigger price (absolute). Pass '-1' to clear."
+          },
+          slTriggerPx: {
+            type: "string",
+            description: "[TP/SL mode] Stop-loss trigger price (absolute). Pass '-1' to clear."
+          },
+          tpRatio: {
+            type: "string",
+            description: "[TP/SL mode] Take-profit ratio, e.g. '0.1' = 10% profit. Pass '-1' to clear."
+          },
+          slRatio: {
+            type: "string",
+            description: "[TP/SL mode] Stop-loss ratio, e.g. '0.1' = 10% drawdown. Pass '-1' to clear."
+          },
+          // ── Shared optional ───────────────────────────────────────────────
+          topUpAmt: {
+            type: "string",
+            description: "Top-up amount. In price-range mode maps to topupAmount (contract grid only; omit to use minimum required). In TP/SL mode maps to topUpAmt."
+          }
+        },
+        required: ["algoId"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const algoId = requireString(args, "algoId");
+        const maxPx = readString(args, "maxPx");
+        const instId = readString(args, "instId");
+        const hasTpsl = readString(args, "tpTriggerPx") || readString(args, "slTriggerPx") || readString(args, "tpRatio") || readString(args, "slRatio");
+        if (!maxPx && !hasTpsl) {
+          throw new OkxApiError(
+            "Nothing to amend. Provide maxPx+minPx+gridNum for price-range mode, or any of tpTriggerPx/slTriggerPx/tpRatio/slRatio (instId also required) for TP/SL mode (both can be combined).",
+            { code: "", endpoint: "grid_amend_order" }
+          );
+        }
+        if (hasTpsl && !instId) {
+          throw new OkxApiError(
+            "TP/SL mode requires instId. Provide instId alongside the TP/SL parameters.",
+            { code: "", endpoint: "grid_amend_order" }
+          );
+        }
+        const results = [];
+        if (maxPx) {
+          results.push(normalizeWrite(await context.client.privatePost(
+            "/api/v5/tradingBot/grid/amend-algo-basic-param",
+            compactObject({
+              algoId,
+              maxPx,
+              minPx: requireString(args, "minPx"),
+              gridNum: requireString(args, "gridNum"),
+              // API field is "topupAmount" (lowercase u) — different from TP/SL mode's "topUpAmt"
+              // Contract grid only; omitting lets the API use the minimum required
+              topupAmount: readString(args, "topUpAmt")
+            }),
+            privateRateLimit("grid_amend_order", 20),
+            true
+            // retryOnNetworkError: amend sets fixed values, safe to retry
+          )));
+        }
+        if (hasTpsl) {
+          try {
+            results.push(normalizeWrite(await context.client.privatePost(
+              "/api/v5/tradingBot/grid/amend-order-algo",
+              compactObject({
+                algoId,
+                instId,
+                tpTriggerPx: readString(args, "tpTriggerPx"),
+                slTriggerPx: readString(args, "slTriggerPx"),
+                tpRatio: readString(args, "tpRatio"),
+                slRatio: readString(args, "slRatio"),
+                topUpAmt: readString(args, "topUpAmt")
+                // API field is "topUpAmt" (uppercase U) — different from price-range mode's "topupAmount"
+              }),
+              privateRateLimit("grid_amend_order", 20),
+              true
+              // retryOnNetworkError: amend sets fixed values, safe to retry
+            )));
+          } catch (err) {
+            if (results.length > 0) {
+              const msg = err instanceof Error ? err.message : String(err);
+              throw new OkxApiError(
+                `TP/SL amend failed (price-range amend already succeeded): ${msg}`,
+                { code: "", endpoint: "grid_amend_order" }
+              );
+            }
+            throw err;
+          }
+        }
+        const merged = results.flatMap((r) => Array.isArray(r.data) ? r.data : [r.data]);
+        return { endpoint: results[0].endpoint, requestTime: results[0].requestTime, data: merged };
+      }
+    },
     {
       name: "grid_stop_order",
       module: "bot.grid",
-      description: "Stop a grid bot. [CAUTION] Closes or cancels orders. For contract: stopType controls close ('1') vs cancel-only ('2').",
+      description: "Stop a running grid bot. [CAUTION] This stops the strategy and handles open orders/positions according to stopType. Default (stopType='1') closes all positions immediately \u2014 use this for a clean exit. stopType='2' stops the strategy without selling: spot grid keeps all base assets as-is (no sell-back to quote); contract grid cancels all grid orders but leaves the position open for manual close later.",
       isWrite: true,
       inputSchema: {
         type: "object",
@@ -4258,13 +4384,13 @@ function registerGridTools() {
           algoOrdType: {
             type: "string",
             enum: ["grid", "contract_grid"],
-            description: "grid=Spot, contract_grid=Contract"
+            description: "grid=Spot grid, contract_grid=Contract grid"
           },
-          instId: { type: "string", description: "e.g. BTC-USDT, BTC-USD-SWAP" },
+          instId: { type: "string", description: "Instrument ID, e.g. BTC-USDT, BTC-USDT-SWAP" },
           stopType: {
             type: "string",
-            enum: ["1", "2", "3", "5", "6"],
-            description: "1=close all (default); 2=keep assets; 3=limit close; 5=partial; 6=no sell"
+            enum: ["1", "2"],
+            description: "'1' (default): stop strategy and sell \u2014 spot grid sells all base assets back to quote; contract grid market-closes all positions. '2': stop strategy without selling \u2014 spot grid keeps base assets as-is; contract grid cancels all grid orders but leaves the position open. After stopType='2', the remaining position can be closed manually from the Positions page."
           }
         },
         required: ["algoId", "algoOrdType", "instId"]
@@ -4279,7 +4405,9 @@ function registerGridTools() {
             instId: requireString(args, "instId"),
             stopType: readString(args, "stopType") ?? "1"
           })],
-          privateRateLimit("grid_stop_order", 20)
+          privateRateLimit("grid_stop_order", 20),
+          true
+          // retryOnNetworkError: safe to retry — already-stopped returns an error but does not harm state
         );
         return normalizeWrite(response);
       }
@@ -6426,6 +6554,401 @@ function registerEventContractTools() {
     }
   ];
 }
+var PATH_LEADERBOARD = "/api/v5/orbit/public/leaderboard";
+var PATH_POSITION_CURRENT = "/api/v5/orbit/public/position-current";
+var PATH_TRADE_RECORDS = "/api/v5/orbit/public/trade-records";
+var PATH_OVERVIEW = "/api/v5/journal/public/smartmoney/overview";
+var PATH_SIGNAL = "/api/v5/journal/public/smartmoney/signal";
+var PATH_SIGNAL_HISTORY = "/api/v5/journal/public/smartmoney/signal-history";
+var SIGNAL_POOL_FILTER_PROPS = {
+  sortType: {
+    type: "string",
+    description: "pnl or pnlRatio"
+  },
+  period: {
+    type: "string",
+    description: "3|7|30|90 days"
+  },
+  pnl: {
+    type: "string",
+    description: "PNL_ANY|PNL_TOP50|PNL_TOP20|PNL_TOP5"
+  },
+  winRatio: {
+    type: "string",
+    description: "WR_ANY|WR_GE_50|WR_GE_80"
+  },
+  maxRetreat: {
+    type: "string",
+    description: "MR_ANY|MR_LE_20|MR_LE_50"
+  },
+  asset: {
+    type: "string",
+    description: "AUM_ANY|AUM_TOP50|AUM_TOP20|AUM_TOP5"
+  }
+};
+var LEADERBOARD_POOL_FILTER_PROPS = {
+  sortType: {
+    type: "string",
+    description: "pnl or pnl_ratio"
+  },
+  period: {
+    type: "string",
+    description: "3|7|30|90 days, empty=all"
+  },
+  pnl: {
+    type: "string",
+    description: "Min PnL USD"
+  },
+  winRatio: {
+    type: "string",
+    description: "Min ratio (0.8=80%)"
+  },
+  maxRetreat: {
+    type: "string",
+    description: "Max DD (0.1=10%)"
+  },
+  asset: {
+    type: "string",
+    description: "Min AUM USD"
+  }
+};
+var POOL_FILTER_KEYS = ["sortType", "period", "pnl", "winRatio", "maxRetreat", "asset"];
+function readPoolFilters(args) {
+  const result = {};
+  for (const key of POOL_FILTER_KEYS) {
+    const val = readString(args, key);
+    if (val) result[key] = val;
+  }
+  return result;
+}
+function extractLeaderboardData(data) {
+  if (Array.isArray(data)) return data;
+  if (data && typeof data === "object") {
+    const inner = data.data;
+    if (Array.isArray(inner)) return inner;
+  }
+  return [];
+}
+var SMARTMONEY_DEMO_MESSAGE = "Smart Money features are not available in demo/simulated trading mode.";
+var SMARTMONEY_DEMO_SUGGESTION = "Switch to a live profile to use Smart Money features.";
+function withSmartmoneyDemoGuard(tool) {
+  const originalHandler = tool.handler;
+  return {
+    ...tool,
+    handler: async (args, context) => {
+      if (context.config.demo) {
+        throw new ConfigError(
+          SMARTMONEY_DEMO_MESSAGE,
+          SMARTMONEY_DEMO_SUGGESTION
+        );
+      }
+      return originalHandler(args, context);
+    }
+  };
+}
+function registerSmartmoneyTools() {
+  const tools = [
+    /* ---------- 1. Overview ---------- */
+    {
+      name: "smartmoney_get_overview",
+      module: "smartmoney",
+      description: "Multi-currency smart money overview ranked by most-watched currencies. Pass ts=Date.now() for latest data, or dataVersion (yyyyMMddHHmm) from a prior call. For single-currency signal with entry prices and trend, use smartmoney_get_signal.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          dataVersion: {
+            type: "string",
+            description: "yyyyMMddHHmm UTC (or use ts)"
+          },
+          ts: {
+            type: "string",
+            description: "Timestamp ms (or use dataVersion)"
+          },
+          instType: {
+            type: "string",
+            description: "SPOT|MARGIN|FUTURES|SWAP|OPTION"
+          },
+          ...SIGNAL_POOL_FILTER_PROPS,
+          lmtNum: {
+            type: "string",
+            description: "Trader pool size 1-500"
+          },
+          instCcyList: {
+            type: "string",
+            description: "Comma-separated e.g. BTC,ETH,SOL"
+          },
+          instCcy: {
+            type: "string",
+            description: "Single currency e.g. BTC"
+          },
+          topInstruments: {
+            type: "string",
+            description: "Top N instruments 1-100"
+          }
+        }
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const dv = readString(args, "dataVersion");
+        const ts = readString(args, "ts");
+        if (!dv && !ts) {
+          throw new ValidationError('Either "dataVersion" or "ts" is required for smartmoney_get_overview.');
+        }
+        const response = await context.client.privateGet(
+          PATH_OVERVIEW,
+          compactObject({
+            dataVersion: dv,
+            ts,
+            instType: readString(args, "instType"),
+            ...readPoolFilters(args),
+            lmtNum: readString(args, "lmtNum"),
+            instCcyList: readString(args, "instCcyList"),
+            instCcy: readString(args, "instCcy"),
+            topInstruments: readString(args, "topInstruments")
+          }),
+          publicRateLimit("smartmoney_get_overview", 5)
+        );
+        return normalizeResponse(response);
+      }
+    },
+    /* ---------- 2. Signal ---------- */
+    {
+      name: "smartmoney_get_signal",
+      module: "smartmoney",
+      description: "Single-currency consensus signal: long/short ratio, entry prices, trend, capital flow. Requires instId or instCcy. Pass ts=Date.now() for latest data, or dataVersion from a prior call. For multi-currency overview, use smartmoney_get_overview. For timeline, use smartmoney_get_signal_history.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          instId: {
+            type: "string",
+            description: "e.g. BTC-USDT-SWAP (or use instCcy)"
+          },
+          instCcy: {
+            type: "string",
+            description: "e.g. BTC, SPOT/SWAP only (or use instId)"
+          },
+          dataVersion: {
+            type: "string",
+            description: "yyyyMMddHHmm UTC (or use ts)"
+          },
+          ts: {
+            type: "string",
+            description: "Timestamp ms (or use dataVersion)"
+          },
+          ...SIGNAL_POOL_FILTER_PROPS,
+          lmtNum: {
+            type: "string",
+            description: "Trader pool size 1-500"
+          },
+          authorIds: {
+            type: "string",
+            description: "Comma-separated user IDs e.g. 1001,1002"
+          }
+        }
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const instId = readString(args, "instId");
+        const instCcy = readString(args, "instCcy");
+        if (!instId && !instCcy) {
+          throw new ValidationError('Either "instId" or "instCcy" is required for smartmoney_get_signal.');
+        }
+        const dv = readString(args, "dataVersion");
+        const ts = readString(args, "ts");
+        if (!dv && !ts) {
+          throw new ValidationError('Either "dataVersion" or "ts" is required for smartmoney_get_signal.');
+        }
+        const response = await context.client.privateGet(
+          PATH_SIGNAL,
+          compactObject({
+            instId,
+            instCcy,
+            dataVersion: dv,
+            ts,
+            ...readPoolFilters(args),
+            lmtNum: readString(args, "lmtNum"),
+            authorIds: readString(args, "authorIds")
+          }),
+          publicRateLimit("smartmoney_get_signal", 5)
+        );
+        return normalizeResponse(response);
+      }
+    },
+    /* ---------- 3. Signal History ---------- */
+    {
+      name: "smartmoney_get_signal_history",
+      module: "smartmoney",
+      description: "Signal history timeline sorted by ts DESC for trend analysis. Requires instId. Pass ts=Date.now() for latest data, or dataVersion from a prior call. For current snapshot, use smartmoney_get_signal.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          instId: {
+            type: "string",
+            description: "e.g. BTC-USDT-SWAP"
+          },
+          dataVersion: {
+            type: "string",
+            description: "yyyyMMddHHmm UTC (or use ts)"
+          },
+          ts: {
+            type: "string",
+            description: "Timestamp ms (or use dataVersion)"
+          },
+          granularity: {
+            type: "string",
+            description: "1h or 1d"
+          },
+          limit: {
+            type: "string",
+            description: "Data points 1-500"
+          },
+          ...SIGNAL_POOL_FILTER_PROPS
+        },
+        required: ["instId"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const dv = readString(args, "dataVersion");
+        const ts = readString(args, "ts");
+        if (!dv && !ts) {
+          throw new ValidationError('Either "dataVersion" or "ts" is required for smartmoney_get_signal_history.');
+        }
+        const response = await context.client.privateGet(
+          PATH_SIGNAL_HISTORY,
+          compactObject({
+            instId: requireString(args, "instId"),
+            dataVersion: dv,
+            ts,
+            granularity: readString(args, "granularity"),
+            limit: readString(args, "limit"),
+            ...readPoolFilters(args)
+          }),
+          publicRateLimit("smartmoney_get_signal_history", 5)
+        );
+        return normalizeResponse(response);
+      }
+    },
+    /* ---------- 4. Traders (list) ---------- */
+    {
+      name: "smartmoney_get_traders",
+      module: "smartmoney",
+      description: "List/filter leaderboard traders. For single trader detail: smartmoney_get_trader_detail.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          dataVersion: {
+            type: "string",
+            description: "yyyyMMddHHmm, omit=latest"
+          },
+          ...LEADERBOARD_POOL_FILTER_PROPS,
+          authorIds: {
+            type: "string",
+            description: "Comma-separated author IDs"
+          },
+          after: {
+            type: "string",
+            description: "Cursor after this authorId"
+          },
+          before: {
+            type: "string",
+            description: "Cursor before this authorId"
+          },
+          limit: {
+            type: "string",
+            description: "Max results 1-100"
+          }
+        }
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const response = await context.client.privateGet(
+          PATH_LEADERBOARD,
+          compactObject({
+            dataVersion: readString(args, "dataVersion"),
+            ...readPoolFilters(args),
+            authorIds: readString(args, "authorIds"),
+            after: readString(args, "after"),
+            before: readString(args, "before"),
+            limit: readString(args, "limit")
+          }),
+          publicRateLimit("smartmoney_get_traders", 5)
+        );
+        const normalized = normalizeResponse(response);
+        return { ...normalized, data: extractLeaderboardData(normalized.data) };
+      }
+    },
+    /* ---------- 5. Trader Detail (composite) ---------- */
+    {
+      name: "smartmoney_get_trader_detail",
+      module: "smartmoney",
+      description: "Trader portrait: profile + positions + trades. Requires authorId from smartmoney_get_traders. Do NOT use for listing \u2014 use smartmoney_get_traders.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          authorId: {
+            type: "string",
+            description: "Trader author ID"
+          },
+          period: {
+            type: "string",
+            description: "3|7|30|90 days, omit=all"
+          },
+          instCcy: {
+            type: "string",
+            description: "Currency filter e.g. BTC"
+          },
+          tradeLimit: {
+            type: "string",
+            description: "Max trades 1-100"
+          }
+        },
+        required: ["authorId"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const authorId = requireString(args, "authorId");
+        const period = readString(args, "period");
+        const instCcy = readString(args, "instCcy");
+        const tradeLimit = readString(args, "tradeLimit");
+        const [profileRes, positionsRes, tradesRes] = await Promise.all([
+          context.client.privateGet(
+            PATH_LEADERBOARD,
+            compactObject({ authorIds: authorId, period }),
+            publicRateLimit("smartmoney_get_traders", 5)
+          ),
+          context.client.privateGet(
+            PATH_POSITION_CURRENT,
+            compactObject({ authorId, instCcy }),
+            publicRateLimit("smartmoney_trader_positions", 5)
+          ),
+          context.client.privateGet(
+            PATH_TRADE_RECORDS,
+            compactObject({ authorId, instCcy, limit: tradeLimit }),
+            publicRateLimit("smartmoney_trade_records", 5)
+          )
+        ]);
+        const profileNorm = normalizeResponse(profileRes);
+        const positionsNorm = normalizeResponse(positionsRes);
+        const tradesNorm = normalizeResponse(tradesRes);
+        return {
+          endpoint: "smartmoney_get_trader_detail (composite)",
+          requestTime: (/* @__PURE__ */ new Date()).toISOString(),
+          data: {
+            profile: extractLeaderboardData(profileNorm.data),
+            positions: positionsNorm.data,
+            trades: tradesNorm.data
+          }
+        };
+      }
+    }
+  ];
+  return tools.map(withSmartmoneyDemoGuard);
+}
 function buildContractTradeTools(cfg) {
   const { prefix, module, label, instTypes, instIdExample } = cfg;
   const [defaultType, otherType] = instTypes;
@@ -6767,31 +7290,58 @@ function buildContractTradeTools(cfg) {
     {
       name: n("set_leverage"),
       module,
-      description: `Set leverage for a ${label} instrument or position. [CAUTION] Changes risk parameters.`,
+      description: `Set leverage for a ${label} instrument or position. [CAUTION] Changes risk parameters.
+Scenarios (SWAP/FUTURES only):
+  \u2022 cross + any instId under the index \u2192 sets leverage at the index level
+  \u2022 isolated + buy-sell (net) posMode \u2192 instId only
+  \u2022 isolated + long-short (hedge) posMode \u2192 instId + posSide=long|short (BOTH directions must be set separately)
+Not supported: PORTFOLIO MARGIN accounts cannot adjust cross leverage for SWAP/FUTURES \u2014 the request will be rejected by OKX. Use account_get_config first if unsure of the account's margin mode.`,
       isWrite: true,
       inputSchema: {
         type: "object",
         properties: {
           instId: { type: "string", description: instIdExample },
-          lever: { type: "string", description: "Leverage, e.g. '10'" },
+          lever: {
+            type: "string",
+            description: "Leverage multiplier as a positive number string, e.g. '10'. Max value depends on the instrument (query market_get_instruments \u2192 lever)."
+          },
           mgnMode: { type: "string", enum: ["cross", "isolated"] },
           posSide: {
             type: "string",
-            enum: ["long", "short", "net"],
-            description: "Required for isolated margin in hedge mode"
+            enum: ["long", "short"],
+            description: "REQUIRED when mgnMode=isolated AND the account is in hedge (long/short) position mode. Use 'long' or 'short' \u2014 setting one side does NOT auto-apply to the other. Omit entirely for one-way (net) position mode or for cross margin."
           }
         },
         required: ["instId", "lever", "mgnMode"]
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
+        const instId = requireString(args, "instId");
+        const leverRaw = requireString(args, "lever");
+        const leverNum = Number(leverRaw);
+        if (!Number.isFinite(leverNum) || leverNum <= 0) {
+          throw new ValidationError(
+            `Parameter "lever" must be a positive number string, got "${leverRaw}".`
+          );
+        }
+        const mgnMode = requireString(args, "mgnMode");
+        assertEnum(mgnMode, "mgnMode", ["cross", "isolated"]);
+        const posSide = readString(args, "posSide");
+        if (posSide !== void 0) {
+          assertEnum(posSide, "posSide", ["long", "short"]);
+          if (mgnMode === "cross") {
+            throw new ValidationError(
+              `posSide="${posSide}" is only valid with mgnMode="isolated" in hedge mode. Omit posSide for cross margin.`
+            );
+          }
+        }
         const response = await context.client.privatePost(
           "/api/v5/account/set-leverage",
           compactObject({
-            instId: requireString(args, "instId"),
-            lever: requireString(args, "lever"),
-            mgnMode: requireString(args, "mgnMode"),
-            posSide: readString(args, "posSide")
+            instId,
+            lever: leverRaw,
+            mgnMode,
+            posSide
           }),
           privateRateLimit(n("set_leverage"), 20)
         );
@@ -7664,7 +8214,7 @@ function registerMarketFilterTools() {
           sortBy: {
             type: "string",
             enum: ["last", "chg24hPct", "marketCapUsd", "volUsd24h", "fundingRate", "oiUsd", "listTime"],
-            description: "Sort field. Default: volUsd24h. Note: marketCapUsd is only meaningful for SPOT (null for SWAP/FUTURES)."
+            description: "Sort field. Default: volUsd24h. Note: marketCapUsd is only meaningful for SPOT (null for SWAP/FUTURES). To rank by OI *change* (oiDeltaPct / absOiDeltaPct), use market_filter_oi_change \u2014 market_filter only sorts by the current snapshot."
           },
           sortOrder: {
             type: "string",
@@ -7777,7 +8327,7 @@ function registerMarketFilterTools() {
           bar: {
             type: "string",
             enum: [...OI_BARS],
-            description: "Bar window for OI change computation: 5m, 15m, 1H, 4H, 1D. Default: 1H"
+            description: "Bar window for OI change computation: 5m, 15m, 1H, 4H, 1D (case-insensitive on server, but send canonical form here). Default: 1H"
           },
           // Filters
           minOiUsd: {
@@ -7795,8 +8345,8 @@ function registerMarketFilterTools() {
           // Sort / pagination
           sortBy: {
             type: "string",
-            enum: ["oiUsd", "oiDeltaUsd", "oiDeltaPct", "volUsd24h", "last"],
-            description: "Sort field. Default: oiDeltaPct (largest movers first)"
+            enum: ["oiUsd", "oiDeltaUsd", "oiDeltaPct", "absOiDeltaPct", "volUsd24h", "fundingRate", "last"],
+            description: "Sort field. Default: oiDeltaPct (largest movers first, signed \u2014 longs and shorts separate). Use absOiDeltaPct to sort by |oiDeltaPct| (largest-magnitude moves regardless of direction). fundingRate is also supported for SWAP. Do NOT use the market_filter tool's sort fields (chg24hPct, marketCapUsd, listTime) here \u2014 they are not in the OI-change Row."
           },
           sortOrder: {
             type: "string",
@@ -7843,32 +8393,34 @@ function langHeader(lang) {
   return { "Accept-Language": "en-US" };
 }
 var NEWS_DETAIL_LVL = ["brief", "summary", "full"];
-var NEWS_IMPORTANCE = ["high", "medium", "low"];
+var NEWS_IMPORTANCE = ["high", "low"];
 var NEWS_SENTIMENT = ["bullish", "bearish", "neutral"];
 var NEWS_SORT = ["latest", "relevant"];
 var SENTIMENT_PERIOD = ["1h", "4h", "24h"];
 var D_COINS_NEWS = 'Comma-separated uppercase ticker symbols (e.g. "BTC,ETH"). Normalize names/aliases to standard tickers.';
 var D_COINS_SENTIMENT = 'Comma-separated uppercase ticker symbols, max 20 (e.g. "BTC,ETH"). Normalize names/aliases to standard tickers.';
 var D_LANGUAGE = "Content language: zh-CN or en-US. Infer from user's message. No server default.";
-var D_BEGIN = "Start time, Unix epoch milliseconds. Parse relative time if given (e.g. 'yesterday', 'last 7 days').";
+var D_BEGIN = "Start time, Unix epoch milliseconds. API defaults to 72 hours ago when omitted. Pass explicitly for older topics (e.g. 'last 30 days'). Max range: 180 days. Parse relative time if given.";
 var D_END = "End time, Unix epoch milliseconds. Parse relative time if given. Omit for no upper bound.";
-var D_IMPORTANCE = "Importance filter: high (server default), medium, low. Omit unless user wants broader coverage.";
+var D_IMPORTANCE = "Importance filter: 'low' returns all news (both low and high importance); 'high' narrows to major/breaking news only. Omitted \u2192 server default (high-only). Default to 'low' for broad browsing; pass 'high' only when the user explicitly asks for major news.";
+var D_PLATFORM = "Filter by news source. Use values from news_get_domains (e.g. blockbeats, odaily_flash). Omit for all sources.";
 var D_LIMIT = "Number of results (default 10, max 50).";
 function registerNewsTools() {
-  return [
+  const tools = [
     // -----------------------------------------------------------------------
     // News browsing tools
     // -----------------------------------------------------------------------
     {
       name: "news_get_latest",
       module: "news",
-      description: "Get crypto news sorted by time. Omitting importance still returns only high-importance news (server default). Pass importance='medium' or 'low' explicitly to broaden results. Use when user asks 'what happened recently', 'latest news', 'any big news today', or wants to browse without a keyword. For coin-specific news, use news_get_by_coin instead.",
+      description: "Get crypto news sorted by time. For broad browsing ('what happened recently', 'latest news', 'any big news today'), pass importance='low' to include both high and low importance. Server default (when importance omitted) returns only high-importance news. For coin-specific news, use news_get_by_coin instead.",
       isWrite: false,
       inputSchema: {
         type: "object",
         properties: {
           coins: { type: "string", description: D_COINS_NEWS + " Optional." },
           importance: { type: "string", enum: [...NEWS_IMPORTANCE], description: D_IMPORTANCE },
+          platform: { type: "string", description: D_PLATFORM },
           begin: { type: "number", description: D_BEGIN },
           end: { type: "number", description: D_END },
           language: { type: "string", enum: [...NEWS_LANGUAGE], description: D_LANGUAGE },
@@ -7889,6 +8441,7 @@ function registerNewsTools() {
           compactObject({
             sortBy: "latest",
             importance: readString(args, "importance"),
+            platform: readString(args, "platform"),
             ccyList: readString(args, "coins"),
             begin: readNumber(args, "begin"),
             end: readNumber(args, "end"),
@@ -7912,6 +8465,7 @@ function registerNewsTools() {
         properties: {
           coins: { type: "string", description: D_COINS_NEWS + " Required." },
           importance: { type: "string", enum: [...NEWS_IMPORTANCE], description: D_IMPORTANCE },
+          platform: { type: "string", description: D_PLATFORM },
           begin: { type: "number", description: D_BEGIN },
           end: { type: "number", description: D_END },
           language: { type: "string", enum: [...NEWS_LANGUAGE], description: D_LANGUAGE },
@@ -7932,6 +8486,7 @@ function registerNewsTools() {
             sortBy: "latest",
             ccyList: coins,
             importance: readString(args, "importance"),
+            platform: readString(args, "platform"),
             begin: readNumber(args, "begin"),
             end: readNumber(args, "end"),
             detailLvl: readString(args, "detailLvl"),
@@ -7957,6 +8512,7 @@ function registerNewsTools() {
           },
           coins: { type: "string", description: D_COINS_NEWS + " Optional." },
           importance: { type: "string", enum: [...NEWS_IMPORTANCE], description: D_IMPORTANCE },
+          platform: { type: "string", description: D_PLATFORM },
           sentiment: {
             type: "string",
             enum: [...NEWS_SENTIMENT],
@@ -7984,6 +8540,7 @@ function registerNewsTools() {
             keyword: readString(args, "keyword") || void 0,
             sortBy: readString(args, "sortBy") ?? "relevant",
             importance: readString(args, "importance"),
+            platform: readString(args, "platform"),
             ccyList: readString(args, "coins"),
             sentiment: readString(args, "sentiment"),
             begin: readNumber(args, "begin"),
@@ -8129,6 +8686,24 @@ function registerNewsTools() {
       }
     }
   ];
+  const domainsIdx = tools.findIndex((t) => t.name === "news_get_domains");
+  if (domainsIdx === -1) throw new Error("news_get_domains not found in tools list");
+  const [domainsTool] = tools.splice(domainsIdx, 1);
+  return [...tools.map(withNewsDemoGuard), domainsTool];
+}
+var NEWS_DEMO_MESSAGE = "News features are not available in demo/simulated trading mode.";
+var NEWS_DEMO_SUGGESTION = "Switch to a live profile to use News features.";
+function withNewsDemoGuard(tool) {
+  const originalHandler = tool.handler;
+  return {
+    ...tool,
+    handler: async (args, context) => {
+      if (context.config.demo) {
+        throw new ConfigError(NEWS_DEMO_MESSAGE, NEWS_DEMO_SUGGESTION);
+      }
+      return originalHandler(args, context);
+    }
+  };
 }
 function registerOptionAlgoTools() {
   return [
@@ -9499,6 +10074,82 @@ function registerSpotTradeTools() {
         );
         return normalizeResponse(response);
       }
+    },
+    // ── set_leverage (SPOT margin: instId-level isolated OR ccy-level cross) ──
+    // Covers OKX scenarios 1–5 (everything except SWAP/FUTURES, which are in
+    // contract-trade.ts). Callers supply exactly one of {instId, ccy}:
+    //  • instId + isolated       → scenario 1 (pair-level margin)
+    //  • instId + cross          → scenario 3 (contract-mode pair-level cross margin)
+    //  • ccy + cross             → scenarios 2 / 4 / 5 (spot/multi-ccy/PM currency-level cross)
+    // Not applicable: posSide (spot has no long/short hedge).
+    {
+      name: "spot_set_leverage",
+      module: "spot",
+      description: "Set leverage for SPOT margin trading. Provide exactly ONE of instId (pair-level) or ccy (currency-level cross, requires borrow-enabled account / multi-ccy / portfolio margin). [CAUTION] Changes risk parameters.\nScenarios:\n  \u2022 instId + mgnMode=isolated \u2192 pair-level isolated margin\n  \u2022 instId + mgnMode=cross    \u2192 pair-level cross margin (contract-mode account)\n  \u2022 ccy    + mgnMode=cross    \u2192 currency-level cross margin (spot-with-borrow / multi-ccy / portfolio margin)\nWhen ccy is supplied, mgnMode MUST be cross. posSide is never applicable to spot margin.",
+      isWrite: true,
+      inputSchema: {
+        type: "object",
+        properties: {
+          instId: {
+            type: "string",
+            description: "Spot pair, e.g. BTC-USDT. Provide instId OR ccy, not both."
+          },
+          ccy: {
+            type: "string",
+            description: "Margin currency, e.g. BTC. Required only for currency-level cross margin (borrow-enabled / multi-ccy / portfolio margin). Mutually exclusive with instId."
+          },
+          lever: {
+            type: "string",
+            description: "Leverage multiplier as a positive number string, e.g. '3'. Max depends on the pair (query market_get_instruments \u2192 lever) or the account policy for ccy-level."
+          },
+          mgnMode: {
+            type: "string",
+            enum: ["cross", "isolated"],
+            description: "cross or isolated. Must be cross when ccy is supplied."
+          }
+        },
+        required: ["lever", "mgnMode"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const instId = readString(args, "instId");
+        const ccy = readString(args, "ccy");
+        if (!instId && !ccy) {
+          throw new ValidationError(
+            `Missing required parameter: provide either "instId" (pair-level) or "ccy" (currency-level cross margin).`
+          );
+        }
+        if (instId && ccy) {
+          throw new ValidationError(
+            `Parameters "instId" and "ccy" are mutually exclusive \u2014 provide only one. instId sets pair-level leverage; ccy sets currency-level cross margin leverage.`
+          );
+        }
+        const leverRaw = requireString(args, "lever");
+        const leverNum = Number(leverRaw);
+        if (!Number.isFinite(leverNum) || leverNum <= 0) {
+          throw new ValidationError(
+            `Parameter "lever" must be a positive number string, got "${leverRaw}".`
+          );
+        }
+        const mgnMode = requireString(args, "mgnMode");
+        assertEnum(mgnMode, "mgnMode", ["cross", "isolated"]);
+        if (ccy && mgnMode !== "cross") {
+          throw new ValidationError(
+            `When "ccy" is supplied, "mgnMode" must be "cross" (currency-level leverage only applies to cross margin).`
+          );
+        }
+        const response = await context.client.privatePost(
+          "/api/v5/account/set-leverage",
+          compactObject({
+            instId,
+            ccy,
+            lever: leverRaw,
+            mgnMode
+          }),
+          privateRateLimit("spot_set_leverage", 20)
+        );
+        return normalizeResponse(response);
+      }
     }
   ];
 }
@@ -9630,6 +10281,7 @@ function allToolSpecs() {
     ...registerNewsTools(),
     ...registerBotTools(),
     ...registerAllEarnTools(),
+    ...registerSmartmoneyTools(),
     ...registerAuditTools(),
     ...registerSkillsTools()
   ];
@@ -10990,7 +11642,7 @@ async function cmdDiagnoseMcp(options = {}) {
 
 // src/commands/diagnose.ts
 var CLI_VERSION = readCliVersion();
-var GIT_HASH = true ? "e0312e6" : "dev";
+var GIT_HASH = true ? "d5c8ab1" : "dev";
 function maskKey2(key) {
   if (!key) return "(not set)";
   if (key.length <= 8) return "****";
@@ -11529,17 +12181,17 @@ var CLI_REGISTRY = {
       },
       filter: {
         toolName: "market_filter",
-        usage: "okx market filter --instType <SPOT|SWAP|FUTURES> [--sortBy <field>] [--sortOrder <asc|desc>] [--limit <n>] [--baseCcy <ccy>] [--quoteCcy <ccy>] [--settleCcy <ccy>] [--instFamily <fam>] [--ctType <linear|inverse>] [--minLast <n>] [--maxLast <n>] [--minChg24hPct <n>] [--maxChg24hPct <n>] [--minMarketCapUsd <n>] [--maxMarketCapUsd <n>] [--minVolUsd24h <n>] [--maxVolUsd24h <n>] [--minFundingRate <n>] [--maxFundingRate <n>] [--minOiUsd <n>] [--maxOiUsd <n>]",
-        description: "Screen / rank instruments by multi-dimensional criteria (price, volume, OI, funding rate, market cap, etc.)"
+        usage: "okx market filter --instType <SPOT|SWAP|FUTURES> [--sortBy <last|chg24hPct|marketCapUsd|volUsd24h|fundingRate|oiUsd|listTime>] [--sortOrder <asc|desc>] [--limit <1-100>] [--baseCcy <ccy>] [--quoteCcy <ccy>] [--settleCcy <ccy>] [--instFamily <fam>] [--ctType <linear|inverse>] [--minLast <n>] [--maxLast <n>] [--minChg24hPct <n>] [--maxChg24hPct <n>] [--minMarketCapUsd <n>] [--maxMarketCapUsd <n>] [--minVolUsd24h <n>] [--maxVolUsd24h <n>] [--minFundingRate <n>] [--maxFundingRate <n>] [--minOiUsd <n>] [--maxOiUsd <n>]",
+        description: "Screen / rank instruments by multi-dimensional criteria (price, volume, OI, funding rate, market cap, etc.). For OI *change* ranking use `market oi-change`."
       },
       "oi-history": {
         toolName: "market_get_oi_history",
-        usage: "okx market oi-history <instId> [--bar <5m|15m|1H|4H|1D>] [--limit <n>] [--ts <ms>]",
+        usage: "okx market oi-history <instId> [--bar <5m|15m|1H|4H|1D>] [--limit <1-500>] [--ts <ms>]",
         description: "Open interest history time series with bar-over-bar delta for a single instrument"
       },
       "oi-change": {
         toolName: "market_filter_oi_change",
-        usage: "okx market oi-change --instType <SWAP|FUTURES> [--bar <5m|15m|1H|4H|1D>] [--sortBy <field>] [--sortOrder <asc|desc>] [--limit <n>] [--minOiUsd <n>] [--minVolUsd24h <n>] [--minAbsOiDeltaPct <n>]",
+        usage: "okx market oi-change --instType <SWAP|FUTURES> [--bar <5m|15m|1H|4H|1D>] [--sortBy <oiUsd|oiDeltaUsd|oiDeltaPct|absOiDeltaPct|volUsd24h|fundingRate|last>] [--sortOrder <asc|desc>] [--limit <1-100>] [--minOiUsd <n>] [--minVolUsd24h <n>] [--minAbsOiDeltaPct <n>]",
         description: "Find instruments with largest OI changes over a bar window (accumulation/distribution scanner)"
       }
     },
@@ -11552,10 +12204,10 @@ var CLI_REGISTRY = {
             usage: "okx market indicator list",
             description: "List all supported technical indicators"
           },
-          "<instId> <indicator>": {
+          "<indicator> <instId>": {
             toolName: "market_get_indicator",
-            usage: "okx market indicator <instId> <indicator> [--bar <bar>] [--limit <n>] [--backtest-time <ts>] [--params <json>]",
-            description: "Get indicator values for an instrument (e.g. okx market indicator BTC-USDT-SWAP rsi)"
+            usage: "okx market indicator <indicator> <instId> [--bar <3m|5m|15m|1H|4H|12Hutc|1Dutc|3Dutc|1Wutc>] [--limit <1-100>] [--backtest-time <ts>] [--params <json>]",
+            description: "Get indicator values for an instrument (e.g. okx market indicator rsi BTC-USDT-SWAP). NOTE: 1m is not supported for indicators."
           }
         }
       }
@@ -11675,6 +12327,11 @@ var CLI_REGISTRY = {
         alternateTools: ["spot_batch_amend", "spot_batch_cancel"],
         usage: "okx spot batch --action <place|amend|cancel> --orders '<json>'",
         description: "Batch place, amend, or cancel spot orders"
+      },
+      leverage: {
+        toolName: "spot_set_leverage",
+        usage: "okx spot leverage ( --instId <pair> | --ccy <ccy> ) --lever <positive-number> --mgnMode <cross|isolated>",
+        description: "Set leverage for SPOT margin. Provide instId (pair-level) OR ccy (currency-level cross, for borrow-enabled/multi-ccy/portfolio margin). When ccy is used, mgnMode must be cross."
       }
     },
     subgroups: {
@@ -11757,8 +12414,8 @@ var CLI_REGISTRY = {
       },
       leverage: {
         toolName: "swap_set_leverage",
-        usage: "okx swap leverage --instId <id> --lever <n> --mgnMode <cross|isolated> [--posSide <side>]",
-        description: "Set leverage for a swap instrument"
+        usage: "okx swap leverage --instId <id> --lever <positive-number> --mgnMode <cross|isolated> [--posSide <long|short>]",
+        description: "Set leverage for a swap instrument. posSide is REQUIRED when mgnMode=isolated and account is in hedge mode \u2014 must be set for BOTH long and short separately. Not supported for portfolio margin + cross."
       },
       "get-leverage": {
         toolName: "swap_get_leverage",
@@ -11856,8 +12513,8 @@ var CLI_REGISTRY = {
       },
       leverage: {
         toolName: "futures_set_leverage",
-        usage: "okx futures leverage --instId <id> --lever <n> --mgnMode <cross|isolated> [--posSide <net|long|short>]",
-        description: "Set leverage for a futures instrument"
+        usage: "okx futures leverage --instId <id> --lever <positive-number> --mgnMode <cross|isolated> [--posSide <long|short>]",
+        description: "Set leverage for a futures instrument. posSide is REQUIRED when mgnMode=isolated and account is in hedge mode \u2014 must be set for BOTH long and short separately. Not supported for portfolio margin + cross."
       },
       batch: {
         toolName: "futures_batch_orders",
@@ -12167,9 +12824,14 @@ var CLI_REGISTRY = {
             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)"
           },
+          amend: {
+            toolName: "grid_amend_order",
+            usage: "okx bot grid amend --algoId <id> --maxPx <px> --minPx <px> --gridNum <n> [--topUpAmt <n>]\n                   okx bot grid amend --algoId <id> --instId <id> [--tpTriggerPx <px>] [--slTriggerPx <px>] [--tpRatio <n>] [--slRatio <n>] [--topUpAmt <n>]",
+            description: "Amend a running grid bot. Price-range mode: provide --maxPx/--minPx/--gridNum. TP/SL mode: provide --instId and TP/SL flags."
+          },
           stop: {
             toolName: "grid_stop_order",
-            usage: "okx bot grid stop --algoId <id> --algoOrdType <type> --instId <id> [--stopType <1|2|3|5|6>]",
+            usage: "okx bot grid stop --algoId <id> --algoOrdType <type> --instId <id> [--stopType <1|2>]",
             description: "Stop a running grid bot order"
           }
         }
@@ -12257,6 +12919,37 @@ var CLI_REGISTRY = {
       }
     }
   },
+  // ── smartmoney ─────────────────────────────────────────────────────────────
+  smartmoney: {
+    description: "Smart money signals \u2014 trader leaderboard, consensus signals, and position analysis",
+    commands: {
+      overview: {
+        toolName: "smartmoney_get_overview",
+        usage: "okx smartmoney overview [--dataVersion <ver>] [--ts <ms>] [--instType <SWAP|SPOT>] [--sortType <pnl|pnlRatio>] [--period <3|7|30|90>] [--pnl <tier>] [--winRatio <tier>] [--maxRetreat <tier>] [--asset <tier>] [--lmtNum <n>] [--instCcyList <ccys>] [--instCcy <ccy>] [--topInstruments <n>] [--json]",
+        description: "Multi-currency smart money overview with aggregated signals"
+      },
+      signal: {
+        toolName: "smartmoney_get_signal",
+        usage: "okx smartmoney signal [--instId <id>] [--instCcy <ccy>] [--dataVersion <ver>] [--ts <ms>] [--sortType <pnl|pnlRatio>] [--period <3|7|30|90>] [--pnl <tier>] [--winRatio <tier>] [--maxRetreat <tier>] [--asset <tier>] [--lmtNum <n>] [--authorIds <ids>] [--json]",
+        description: "Single-currency aggregated consensus signal"
+      },
+      "signal-history": {
+        toolName: "smartmoney_get_signal_history",
+        usage: "okx smartmoney signal-history --instId <id> [--dataVersion <ver>] [--ts <ms>] [--granularity <1h|1d>] [--limit <n>] [--sortType <pnl|pnlRatio>] [--period <3|7|30|90>] [--pnl <tier>] [--winRatio <tier>] [--maxRetreat <tier>] [--asset <tier>] [--json]",
+        description: "Signal history timeline for trend analysis"
+      },
+      traders: {
+        toolName: "smartmoney_get_traders",
+        usage: 'okx smartmoney traders [--dataVersion <ts>] [--sortType <pnl|pnl_ratio>] [--period <""|3|7|30|90>] [--pnl <n>] [--winRatio <r>] [--maxRetreat <r>] [--asset <n>] [--authorIds <ids>] [--limit <n>] [--after <id>] [--before <id>] [--json]',
+        description: "List/filter traders from the smart money leaderboard"
+      },
+      trader: {
+        toolName: "smartmoney_get_trader_detail",
+        usage: "okx smartmoney trader --authorId <id> [--period <3|7|30|90>] [--instCcy <ccy>] [--tradeLimit <n>] [--json]",
+        description: "Trader full portrait (profile + positions + trades)"
+      }
+    }
+  },
   // ── config ─────────────────────────────────────────────────────────────────
   config: {
     description: "Manage CLI configuration profiles",
@@ -12314,7 +13007,7 @@ var CLI_REGISTRY = {
     commands: {
       latest: {
         toolName: "news_get_latest",
-        usage: "okx news latest [--coins BTC,ETH] [--lang zh-CN] [--limit 20]"
+        usage: "okx news latest [--coins BTC,ETH] [--platform blockbeats] [--lang zh-CN] [--limit 20]"
       },
       important: {
         toolName: "news_get_latest",
@@ -12323,20 +13016,20 @@ var CLI_REGISTRY = {
       },
       "by-coin": {
         toolName: "news_get_by_coin",
-        usage: "okx news by-coin --coins BTC [--importance high] [--lang zh-CN]"
+        usage: "okx news by-coin --coins BTC [--importance high] [--platform blockbeats] [--lang zh-CN]"
       },
       search: {
         toolName: "news_search",
-        usage: "okx news search --keyword <term> [--coins BTC] [--sentiment bullish] [--lang zh-CN]"
+        usage: "okx news search --keyword <term> [--coins BTC] [--sentiment bullish] [--platform blockbeats] [--lang zh-CN]"
       },
       detail: {
         toolName: "news_get_detail",
         usage: "okx news detail <id> [--lang zh-CN]"
       },
-      domains: {
+      platforms: {
         toolName: "news_get_domains",
-        usage: "okx news domains",
-        description: "List available news source domains"
+        usage: "okx news platforms",
+        description: "List available news platforms"
       },
       "coin-sentiment": {
         toolName: "news_get_coin_sentiment",
@@ -12349,7 +13042,7 @@ var CLI_REGISTRY = {
       },
       "by-sentiment": {
         toolName: "news_search",
-        usage: "okx news by-sentiment --sentiment bullish [--coins BTC] [--sort-by latest]",
+        usage: "okx news by-sentiment --sentiment bullish [--coins BTC] [--importance high] [--platform <source>] [--sort-by latest] [--begin <ms>] [--end <ms>]",
         description: "Browse news filtered by sentiment direction"
       },
       "sentiment-rank": {
@@ -12556,7 +13249,8 @@ function formatTime(ts) {
 async function cmdNewsLatest(run, opts) {
   const result = await run("news_get_latest", {
     coins: opts.coins,
-    importance: opts.importance,
+    importance: opts.importance ?? "low",
+    platform: opts.platform,
     begin: opts.begin,
     end: opts.end,
     language: opts.language,
@@ -12583,6 +13277,7 @@ async function cmdNewsImportant(run, opts) {
   const result = await run("news_get_latest", {
     coins: opts.coins,
     importance: "high",
+    platform: opts.platform,
     begin: opts.begin,
     end: opts.end,
     language: opts.language,
@@ -12606,7 +13301,8 @@ async function cmdNewsImportant(run, opts) {
 async function cmdNewsByCoin(run, coins, opts) {
   const result = await run("news_get_by_coin", {
     coins,
-    importance: opts.importance,
+    importance: opts.importance ?? "low",
+    platform: opts.platform,
     begin: opts.begin,
     end: opts.end,
     language: opts.language,
@@ -12631,7 +13327,8 @@ async function cmdNewsSearch(run, keyword, opts) {
   const result = await run("news_search", {
     keyword: keyword || void 0,
     coins: opts.coins,
-    importance: opts.importance,
+    importance: opts.importance ?? "low",
+    platform: opts.platform,
     sentiment: opts.sentiment,
     sortBy: opts.sortBy,
     begin: opts.begin,
@@ -12684,12 +13381,12 @@ async function cmdNewsDetail(run, id, opts) {
     content
   });
 }
-async function cmdNewsDomains(run, opts) {
+async function cmdNewsPlatforms(run, opts) {
   const result = await run("news_get_domains", {});
   const raw = getData(result);
   const items = raw?.[0]?.["platform"] ?? [];
   if (opts.json) return printJson(items);
-  outputLine("Available news source domains:");
+  outputLine("Available news platforms:");
   items.forEach((d) => outputLine(`  ${d}`));
 }
 async function cmdNewsCoinSentiment(run, coins, opts) {
@@ -12979,6 +13676,7 @@ var CLI_OPTIONS = {
   slRatio: { type: "string" },
   algoClOrdId: { type: "string" },
   stopType: { type: "string" },
+  topUpAmt: { type: "string" },
   live: { type: "boolean", default: false },
   // market extras
   instType: { type: "string" },
@@ -13035,6 +13733,22 @@ var CLI_OPTIONS = {
   // audit
   since: { type: "string" },
   tool: { type: "string" },
+  // smartmoney
+  authorId: { type: "string" },
+  authorIds: { type: "string" },
+  dataVersion: { type: "string" },
+  sortType: { type: "string" },
+  granularity: { type: "string" },
+  lmtNum: { type: "string" },
+  instCcy: { type: "string" },
+  instCcyList: { type: "string" },
+  topInstruments: { type: "string" },
+  tradeLimit: { type: "string" },
+  // smartmoney pool filters
+  pnl: { type: "string" },
+  winRatio: { type: "string" },
+  maxRetreat: { type: "string" },
+  asset: { type: "string" },
   // upgrade
   beta: { type: "boolean", default: false },
   check: { type: "boolean", default: false },
@@ -13071,6 +13785,7 @@ var CLI_OPTIONS = {
   coins: { type: "string" },
   sentiment: { type: "string" },
   importance: { type: "string" },
+  platform: { type: "string" },
   keyword: { type: "string" },
   "detail-lvl": { type: "string" },
   period: { type: "string" },
@@ -14035,6 +14750,19 @@ async function cmdSpotBatch(run, opts) {
   if (opts.json) return printJson(data);
   emitBatchResults(data ?? []);
 }
+async function cmdSpotSetLeverage(run, opts) {
+  const result = await run("spot_set_leverage", {
+    instId: opts.instId,
+    ccy: opts.ccy,
+    lever: opts.lever,
+    mgnMode: opts.mgnMode
+  });
+  const data = getData4(result);
+  if (opts.json) return printJson(data);
+  const r = data?.[0];
+  const target = r?.["instId"] ?? r?.["ccy"] ?? "";
+  outputLine(`Leverage set: ${r?.["lever"]}x ${target} (${r?.["mgnMode"]})`);
+}
 
 // src/commands/swap.ts
 function getData5(result) {
@@ -15402,6 +16130,178 @@ function extractFixedOffers(result) {
   return [];
 }
 
+// src/commands/smartmoney.ts
+function printDataList2(data, json, emptyMsg, mapper) {
+  if (json) {
+    printJson(data);
+    return;
+  }
+  if (!data.length) {
+    outputLine(emptyMsg);
+    return;
+  }
+  printTable(data.map(mapper));
+}
+function poolFilterArgs(o) {
+  const result = {};
+  if (o.sortType) result.sortType = o.sortType;
+  if (o.period) result.period = o.period;
+  if (o.pnl) result.pnl = o.pnl;
+  if (o.winRatio) result.winRatio = o.winRatio;
+  if (o.maxRetreat) result.maxRetreat = o.maxRetreat;
+  if (o.asset) result.asset = o.asset;
+  return result;
+}
+async function cmdSmartmoneyOverview(run, opts) {
+  const result = await run("smartmoney_get_overview", {
+    dataVersion: opts.dataVersion,
+    ts: opts.ts,
+    instType: opts.instType,
+    ...poolFilterArgs(opts),
+    lmtNum: opts.lmtNum,
+    instCcyList: opts.instCcyList,
+    instCcy: opts.instCcy,
+    topInstruments: opts.topInstruments
+  });
+  const data = extractData(result);
+  printDataList2(data, opts.json, "No overview data", (r) => ({
+    instId: r["instId"],
+    tradersWithPosition: r["tradersWithPosition"],
+    longRatio: r["longRatio"],
+    weightedLongRatio: r["weightedLongRatio"],
+    netNotionalUsdt: r["netNotionalUsdt"],
+    vs24h: r["vs24h"]
+  }));
+}
+async function cmdSmartmoneySignal(run, opts) {
+  const result = await run("smartmoney_get_signal", {
+    instId: opts.instId,
+    instCcy: opts.instCcy,
+    dataVersion: opts.dataVersion,
+    ts: opts.ts,
+    ...poolFilterArgs(opts),
+    lmtNum: opts.lmtNum,
+    authorIds: opts.authorIds
+  });
+  const data = extractData(result);
+  const signal = data[0];
+  if (opts.json) {
+    printJson(signal ?? {});
+    return;
+  }
+  if (!signal) {
+    outputLine("No signal data");
+    return;
+  }
+  printKv({
+    instId: signal["instId"],
+    instType: signal["instType"],
+    tradersWithPosition: signal["tradersWithPosition"],
+    tradersTotal: signal["tradersTotal"],
+    longRatio: signal["longRatio"],
+    weightedLongRatio: signal["weightedLongRatio"],
+    avgLongWinRatio: signal["avgLongWinRatio"],
+    avgShortWinRatio: signal["avgShortWinRatio"],
+    longNotionalUsdt: signal["longNotionalUsdt"],
+    shortNotionalUsdt: signal["shortNotionalUsdt"],
+    netNotionalUsdt: signal["netNotionalUsdt"],
+    longTraders: signal["longTraders"],
+    shortTraders: signal["shortTraders"],
+    vs1h: signal["vs1h"],
+    vs24h: signal["vs24h"],
+    vs7d: signal["vs7d"],
+    smartMoneyLongAvgEntry: signal["smartMoneyLongAvgEntry"],
+    smartMoneyShortAvgEntry: signal["smartMoneyShortAvgEntry"],
+    totalNotionalVs24h: signal["totalNotionalVs24h"],
+    currentPrice: signal["currentPrice"],
+    priceChange24h: signal["priceChange24h"],
+    fundingRate: signal["fundingRate"],
+    openInterest: signal["openInterest"],
+    longShortAccountRatio: signal["longShortAccountRatio"]
+  });
+}
+async function cmdSmartmoneySignalHistory(run, opts) {
+  const result = await run("smartmoney_get_signal_history", {
+    instId: opts.instId,
+    dataVersion: opts.dataVersion,
+    ts: opts.ts,
+    granularity: opts.granularity,
+    limit: opts.limit,
+    ...poolFilterArgs(opts)
+  });
+  const data = extractData(result);
+  printDataList2(data, opts.json, "No signal history data", (r) => ({
+    ts: r["ts"],
+    longRatio: r["longRatio"],
+    weightedLongRatio: r["weightedLongRatio"],
+    tradersWithPosition: r["tradersWithPosition"],
+    netNotionalUsdt: r["netNotionalUsdt"],
+    totalNotionalUsdt: r["totalNotionalUsdt"],
+    tradersQualified: r["tradersQualified"]
+  }));
+}
+async function cmdSmartmoneyTraders(run, opts) {
+  const data = extractData(await run("smartmoney_get_traders", {
+    dataVersion: opts.dataVersion,
+    ...poolFilterArgs(opts),
+    authorIds: opts.authorIds,
+    after: opts.after,
+    before: opts.before,
+    limit: opts.limit
+  }));
+  printDataList2(data, opts.json, "No traders found", (r) => ({
+    authorId: r["authorId"],
+    nickName: r["nickName"],
+    pnl: r["pnl"],
+    pnlRatio: r["pnlRatio"],
+    winRatio: r["winRatio"],
+    asset: r["asset"]
+  }));
+}
+async function cmdSmartmoneyTraderDetail(run, opts) {
+  const result = await run("smartmoney_get_trader_detail", {
+    authorId: opts.authorId,
+    period: opts.period,
+    instCcy: opts.instCcy,
+    tradeLimit: opts.tradeLimit
+  });
+  const data = result;
+  const inner = data["data"];
+  if (opts.json) {
+    printJson(inner ?? {});
+    return;
+  }
+  if (!inner) {
+    outputLine("No data");
+    return;
+  }
+  const profileArr = inner["profile"];
+  if (Array.isArray(profileArr) && profileArr.length > 0) {
+    const p = profileArr[0];
+    outputLine("=== Profile ===");
+    printKv({
+      authorId: p["authorId"],
+      nickName: p["nickName"],
+      pnl: p["pnl"],
+      pnlRatio: p["pnlRatio"],
+      winRatio: p["winRatio"],
+      maxRetreat: p["maxRetreat"],
+      asset: p["asset"],
+      onboardDuration: p["onboardDuration"]
+    });
+  }
+  const posArr = inner["positions"];
+  if (Array.isArray(posArr) && posArr.length > 0) {
+    outputLine("\n=== Current Positions ===");
+    printJson(posArr);
+  }
+  const tradeArr = inner["trades"];
+  if (Array.isArray(tradeArr) && tradeArr.length > 0) {
+    outputLine("\n=== Recent Trades ===");
+    printJson(tradeArr);
+  }
+}
+
 // src/commands/auto-earn.ts
 var USDG_EARN_CURRENCIES = /* @__PURE__ */ new Set(["USDG", "BUIDL"]);
 function isSupported(status) {
@@ -15655,6 +16555,28 @@ async function cmdGridCreate(run, opts) {
   if (opts.json) return printJson(data);
   emitWriteResult5(data?.[0], "Grid bot created", "algoId");
 }
+async function cmdGridAmend(run, opts) {
+  const result = await run("grid_amend_order", {
+    algoId: opts.algoId,
+    instId: opts.instId,
+    maxPx: opts.maxPx,
+    minPx: opts.minPx,
+    gridNum: opts.gridNum,
+    tpTriggerPx: opts.tpTriggerPx,
+    slTriggerPx: opts.slTriggerPx,
+    tpRatio: opts.tpRatio,
+    slRatio: opts.slRatio,
+    topUpAmt: opts.topUpAmt
+  });
+  const data = getData8(result);
+  if (opts.json) return printJson(data);
+  const item = data?.[0];
+  if (item?.["algoId"]) {
+    outputLine(`Grid bot amended: ${item["algoId"]} (OK)`);
+  } else {
+    emitWriteResult5(item, "Grid bot amended", "algoId");
+  }
+}
 async function cmdGridStop(run, opts) {
   const result = await run("grid_stop_order", {
     algoId: opts.algoId,
@@ -16882,7 +17804,7 @@ async function cmdEventCancel(run, opts) {
 // src/index.ts
 var _require3 = createRequire3(import.meta.url);
 var CLI_VERSION2 = _require3("../package.json").version;
-var GIT_HASH2 = true ? "e0312e6" : "dev";
+var GIT_HASH2 = true ? "d5c8ab1" : "dev";
 function handleDohCommand(action, json, force, binaryPath) {
   if (action === "status") return cmdDohStatus(json, binaryPath);
   if (action === "install") return cmdDohInstall(json, binaryPath);
@@ -16987,6 +17909,9 @@ function handleMarketFilterCommand(run, action, rest, v, json) {
       limit,
       json
     });
+  errorLine(`Unknown market command: ${action}`);
+  errorLine("Valid: ticker, tickers, orderbook, candles, trades, instruments, mark-price, funding-rate, open-interest, index-ticker, price-limit, stock-tokens, instruments-by-category, indicator, filter, oi-history, oi-change");
+  process.exitCode = 1;
 }
 function handleIndicatorAction(run, rest, v, json) {
   if (rest[0] === "list") return cmdMarketIndicatorList(json);
@@ -17157,6 +18082,14 @@ function handleSpotCommand(run, action, rest, v, json) {
     return handleSpotAlgoCommand(run, rest[0], v, json);
   if (action === "batch")
     return cmdSpotBatch(run, { action: v.action, orders: v.orders, json });
+  if (action === "leverage")
+    return cmdSpotSetLeverage(run, {
+      instId: v.instId,
+      ccy: v.ccy,
+      lever: v.lever,
+      mgnMode: v.mgnMode,
+      json
+    });
 }
 function handleSwapAlgoCommand(run, subAction, v, json) {
   if (subAction === "trail")
@@ -17550,6 +18483,20 @@ function handleBotGridCommand(run, v, rest, json) {
       algoClOrdId: v.algoClOrdId,
       json
     });
+  if (subAction === "amend")
+    return cmdGridAmend(run, {
+      algoId: v.algoId,
+      instId: v.instId,
+      maxPx: v.maxPx,
+      minPx: v.minPx,
+      gridNum: v.gridNum,
+      tpTriggerPx: v.tpTriggerPx,
+      slTriggerPx: v.slTriggerPx,
+      tpRatio: v.tpRatio,
+      slRatio: v.slRatio,
+      topUpAmt: v.topUpAmt,
+      json
+    });
   if (subAction === "stop")
     return cmdGridStop(run, {
       algoId: v.algoId,
@@ -17642,6 +18589,82 @@ function handleEarnFlashEarnCommand(run, action, v, json) {
   errorLine("Valid: projects");
   process.exitCode = 1;
 }
+function handleSmartmoneyCommand(run, action, rest, v, json) {
+  const poolFilters = {
+    sortType: v.sortType,
+    period: v.period,
+    pnl: v.pnl,
+    winRatio: v.winRatio,
+    maxRetreat: v.maxRetreat,
+    asset: v.asset
+  };
+  if (action === "overview")
+    return cmdSmartmoneyOverview(run, {
+      dataVersion: v.dataVersion,
+      ts: v.ts,
+      instType: v.instType,
+      ...poolFilters,
+      lmtNum: v.lmtNum,
+      instCcyList: v.instCcyList,
+      instCcy: v.instCcy,
+      topInstruments: v.topInstruments,
+      json
+    });
+  if (action === "signal")
+    return cmdSmartmoneySignal(run, {
+      instId: v.instId,
+      dataVersion: v.dataVersion,
+      ts: v.ts,
+      ...poolFilters,
+      instCcy: v.instCcy,
+      lmtNum: v.lmtNum,
+      authorIds: v.authorIds,
+      json
+    });
+  if (action === "signal-history") {
+    if (!v.instId) {
+      errorLine("Missing required --instId: okx smartmoney signal-history --instId <id>");
+      process.exitCode = 1;
+      return;
+    }
+    return cmdSmartmoneySignalHistory(run, {
+      instId: v.instId,
+      dataVersion: v.dataVersion,
+      ts: v.ts,
+      granularity: v.granularity,
+      limit: v.limit,
+      ...poolFilters,
+      json
+    });
+  }
+  if (action === "traders")
+    return cmdSmartmoneyTraders(run, {
+      dataVersion: v.dataVersion,
+      ...poolFilters,
+      authorIds: v.authorIds,
+      after: v.after,
+      before: v.before,
+      limit: v.limit,
+      json
+    });
+  if (action === "trader") {
+    if (!v.authorId) {
+      errorLine("Missing required --authorId: okx smartmoney trader --authorId <id>");
+      process.exitCode = 1;
+      return;
+    }
+    return cmdSmartmoneyTraderDetail(run, {
+      authorId: v.authorId,
+      period: v.period,
+      instCcy: v.instCcy,
+      tradeLimit: v.tradeLimit,
+      json
+    });
+  }
+  errorLine(`Unknown smartmoney command: ${action}`);
+  errorLine("Valid: overview, signal, signal-history, traders, trader");
+  process.exitCode = 1;
+}
 function handleEarnSavingsCommand(run, action, rest, v, json) {
   const limit = v.limit !== void 0 ? Number(v.limit) : void 0;
   if (action === "balance") return cmdEarnSavingsBalance(run, rest[0] ?? v.ccy, json);
@@ -17732,15 +18755,16 @@ function handleNewsCommand(run, action, rest, v, json) {
   const period = v.period;
   const points = v.points !== void 0 ? Number(v.points) : 24;
   const sortBy = v["sort-by"];
-  const searchOpts = { coins: v.coins, importance: v.importance, sentiment: v.sentiment, sortBy, begin, end, language, detailLvl, limit, after, json };
-  const listOpts = { coins: v.coins, importance: v.importance, begin, end, language, detailLvl, limit, after, json };
+  const platform2 = v.platform;
+  const searchOpts = { coins: v.coins, importance: v.importance, platform: platform2, sentiment: v.sentiment, sortBy, begin, end, language, detailLvl, limit, after, json };
+  const listOpts = { coins: v.coins, importance: v.importance, platform: platform2, begin, end, language, detailLvl, limit, after, json };
   const dispatch = {
     latest: () => cmdNewsLatest(run, listOpts),
-    important: () => cmdNewsImportant(run, { coins: v.coins, begin, end, language, detailLvl, limit, json }),
-    "by-coin": () => cmdNewsByCoin(run, v.coins ?? rest[0], { importance: v.importance, begin, end, language, detailLvl, limit, json }),
+    important: () => cmdNewsImportant(run, { coins: v.coins, platform: platform2, begin, end, language, detailLvl, limit, json }),
+    "by-coin": () => cmdNewsByCoin(run, v.coins ?? rest[0], { importance: v.importance, platform: platform2, begin, end, language, detailLvl, limit, json }),
     search: () => cmdNewsSearch(run, v.keyword ?? rest[0], searchOpts),
     detail: () => cmdNewsDetail(run, rest[0], { language, json }),
-    domains: () => cmdNewsDomains(run, { json }),
+    platforms: () => cmdNewsPlatforms(run, { json }),
     "coin-sentiment": () => cmdNewsCoinSentiment(run, v.coins ?? rest[0], { period, json }),
     "coin-trend": () => cmdNewsCoinTrend(run, v.coins ?? rest[0], { period, points, json }),
     // by-sentiment is a convenience wrapper over news_search (no keyword, sentiment filter only)
@@ -17930,6 +18954,7 @@ async function main() {
     news: () => handleNewsCommand(run, action, rest, v, json),
     bot: () => handleBotCommand(run, action, rest, v, json),
     earn: () => handleEarnCommand(run, action, rest, v, json),
+    smartmoney: () => handleSmartmoneyCommand(run, action, rest, v, json),
     skill: () => handleSkillCommand(run, action, rest, v, json, config)
   };
   const handler = moduleHandlers[module];
@@ -17964,6 +18989,7 @@ export {
   handleOptionCommand,
   handleSetupCommand,
   handleSkillCommand,
+  handleSmartmoneyCommand,
   handleSpotAlgoCommand,
   handleSpotCommand,
   handleSwapAlgoCommand,