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

package/dist/index.js

@@ -1294,13 +1294,14 @@ var OkxRestClient = class _OkxRestClient {
       rateLimit
     });
   }
-  async privatePost(path4, body, rateLimit) {
+  async privatePost(path4, body, rateLimit, retryOnNetworkError) {
     return this.request({
       method: "POST",
       path: path4,
       auth: "private",
       body,
-      rateLimit
+      rateLimit,
+      retryOnNetworkError
     });
   }
   setAuthHeaders(headers, method, requestPath, bodyJson, timestamp) {
@@ -1583,7 +1584,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);
       }
     }
@@ -2059,6 +2060,7 @@ var MODULES = [
   "account",
   "event",
   "news",
+  "smartmoney",
   ...EARN_SUB_MODULE_IDS,
   ...BOT_SUB_MODULE_IDS,
   "skills"
@@ -3904,10 +3906,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",
@@ -3916,13 +4041,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"]
@@ -3937,7 +4062,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);
       }
@@ -6084,6 +6211,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;
@@ -6425,31 +6947,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)
         );
@@ -7322,7 +7871,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",
@@ -7435,7 +7984,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: {
@@ -7453,8 +8002,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",
@@ -7510,7 +8059,7 @@ var D_COINS_SENTIMENT = 'Comma-separated uppercase ticker symbols, max 20 (e.g.
 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. 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) or 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() {
@@ -7521,7 +8070,7 @@ function registerNewsTools() {
     {
       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='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",
@@ -9182,6 +9731,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);
+      }
     }
   ];
 }
@@ -9313,6 +9938,7 @@ function allToolSpecs() {
     ...registerNewsTools(),
     ...registerBotTools(),
     ...registerAllEarnTools(),
+    ...registerSmartmoneyTools(),
     ...registerAuditTools(),
     ...registerSkillsTools()
   ];
@@ -9757,7 +10383,7 @@ var _require = createRequire(import.meta.url);
 var pkg = _require("../package.json");
 var SERVER_NAME = "okx-trade-mcp";
 var SERVER_VERSION = pkg.version;
-var GIT_HASH = true ? "e9764c9" : "dev";
+var GIT_HASH = true ? "d5c8ab1" : "dev";
 
 // src/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -9927,11 +10553,14 @@ Usage: okx-trade-mcp [options]
 
 Options:
   --modules <list>     Comma-separated list of modules to load
-                       Available: market, spot, swap, futures, option, account, news
+                       Available: market, spot, swap, futures, option, account,
+                                  event, news, smartmoney, skills,
+                                  earn.savings, earn.onchain, earn.dcd, earn.autoearn, earn.flash,
                                   bot.grid, bot.dca
-                       Alias: "bot" = all bot sub-modules (bot.grid + bot.dca)
+                       Alias: "bot" = bot.grid + bot.dca
+                              "earn" / "earn.all" = all earn sub-modules
                        Special: "all" loads all modules
-                       Default: spot,swap,option,account,bot.grid
+                       Default: spot,swap,option,account,bot.grid,skills
 
   --profile <name>     Profile to load from ${configFilePath()}
                        Falls back to default_profile in config, then "default"