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

package/dist/index.js

@@ -733,19 +733,19 @@ import * as os3 from "os";
 import { execFileSync } from "child_process";
 var EXEC_TIMEOUT_MS = 3e4;
 var ALLOWED_DOMAIN_RE = /^[\w.-]+\.okx\.com$/;
-var DOH_BIN_DIR = join(homedir(), ".okx", "bin");
-function getDohBinaryPath() {
-  if (process.env.OKX_DOH_BINARY_PATH) {
-    return process.env.OKX_DOH_BINARY_PATH;
+var PILOT_BIN_DIR = join(homedir(), ".okx", "bin");
+function getPilotBinaryPath() {
+  if (process.env.OKX_PILOT_BINARY_PATH) {
+    return process.env.OKX_PILOT_BINARY_PATH;
   }
   const ext = process.platform === "win32" ? ".exe" : "";
-  return join(DOH_BIN_DIR, `okx-pilot${ext}`);
+  return join(PILOT_BIN_DIR, `okx-pilot${ext}`);
 }
-function execDohBinary(domain, exclude = [], userAgent) {
+function execPilotBinary(domain, exclude = [], userAgent) {
   if (!ALLOWED_DOMAIN_RE.test(domain)) {
     return Promise.resolve(null);
   }
-  const binPath = getDohBinaryPath();
+  const binPath = getPilotBinaryPath();
   const args = ["--domain", domain];
   if (exclude.length > 0) {
     args.push("--exclude", exclude.join(","));
@@ -778,7 +778,7 @@ function execDohBinary(domain, exclude = [], userAgent) {
   });
 }
 function getDefaultCachePath() {
-  return process.env.OKX_DOH_CACHE_PATH || join2(homedir2(), ".okx", "doh-cache.json");
+  return process.env.OKX_PILOT_CACHE_PATH || join2(homedir2(), ".okx", "pilot-cache.json");
 }
 function readCache(hostname, cachePath = getDefaultCachePath()) {
   try {
@@ -832,7 +832,7 @@ function getActiveFailedNodes(nodes) {
   const now = Date.now();
   return nodes.filter((n) => now - n.failedAt < FAILED_NODE_TTL_MS);
 }
-function resolveDoh(hostname, cachePath) {
+function resolvePilot(hostname, cachePath) {
   const entry = readCache(hostname, cachePath);
   if (entry) {
     if (entry.mode === "direct") {
@@ -844,53 +844,53 @@ function resolveDoh(hostname, cachePath) {
   }
   return { mode: null, node: null };
 }
-async function reResolveDoh(hostname, failedIp, userAgent, cachePath) {
+async function reResolvePilot(hostname, failedIp, userAgent, cachePath) {
   const entry = readCache(hostname, cachePath);
   const active = getActiveFailedNodes(entry?.failedNodes);
   const now = Date.now();
   const alreadyFailed = failedIp && active.some((n) => n.ip === failedIp);
   const failedNodes = failedIp && !alreadyFailed ? [...active, { ip: failedIp, failedAt: now }] : active;
   const excludeIps = failedNodes.map((n) => n.ip);
-  const node = await execDohBinary(hostname, excludeIps, userAgent);
+  const node = await execPilotBinary(hostname, excludeIps, userAgent);
   return classifyAndCache(node, hostname, failedNodes, cachePath);
 }
 function vlog(message) {
   process.stderr.write(`[verbose] ${message}
 `);
 }
-var DohManager = class {
+var PilotManager = class {
   opts;
-  // DoH proxy state (lazy-resolved on first request)
-  dohResolved = false;
-  dohRetried = false;
+  // Pilot proxy state (lazy-resolved on first request)
+  pilotResolved = false;
+  pilotRetried = false;
   directUnverified = false;
   // The first direct connection has not yet been verified
-  dohNode = null;
-  dohAgent = null;
-  dohBaseUrl = null;
+  pilotNode = null;
+  pilotAgent = null;
+  pilotBaseUrl = null;
   constructor(opts) {
     this.opts = opts;
   }
   /**
-   * Lazily resolve the DoH proxy node on the first request.
+   * Lazily resolve the Pilot proxy node on the first request.
    * Uses cache-first strategy via the resolver.
    */
-  prepareDoh() {
-    if (this.dohResolved || this.opts.hasCustomProxy) return;
-    this.dohResolved = true;
+  preparePilot() {
+    if (this.pilotResolved || this.opts.hasCustomProxy) return;
+    this.pilotResolved = true;
     try {
       const { hostname, protocol } = new URL(this.opts.baseUrl);
-      const result = resolveDoh(hostname);
+      const result = resolvePilot(hostname);
       if (!result.mode) {
         this.directUnverified = true;
         if (this.opts.verbose) {
-          vlog("DoH: no cache, trying direct connection first");
+          vlog("Pilot: no cache, trying direct connection first");
         }
         return;
       }
       if (result.mode === "direct") {
         if (this.opts.verbose) {
-          vlog("DoH: mode=direct (overseas or cached), using direct connection");
+          vlog("Pilot: mode=direct (overseas or cached), using direct connection");
         }
         return;
       }
@@ -900,57 +900,57 @@ var DohManager = class {
     } catch (err) {
       if (this.opts.verbose) {
         const cause = err instanceof Error ? err.message : String(err);
-        vlog(`DoH resolution failed, falling back to direct: ${cause}`);
+        vlog(`Pilot resolution failed, falling back to direct: ${cause}`);
       }
     }
   }
   /** Get connection parameters for the current request. */
   getConnectionParams() {
-    const baseUrl = this.dohNode ? this.dohBaseUrl : this.opts.baseUrl;
+    const baseUrl = this.pilotNode ? this.pilotBaseUrl : this.opts.baseUrl;
     const result = { baseUrl };
-    if (this.dohAgent) {
-      result.dispatcher = this.dohAgent;
+    if (this.pilotAgent) {
+      result.dispatcher = this.pilotAgent;
     }
-    if (this.dohNode) {
-      result.userAgent = this.dohUserAgent;
+    if (this.pilotNode) {
+      result.userAgent = this.pilotUserAgent;
     }
     return result;
   }
-  /** Whether a DoH proxy node is currently active. */
+  /** Whether a Pilot proxy node is currently active. */
   get isProxyActive() {
-    return this.dohNode !== null;
+    return this.pilotNode !== null;
   }
   /** Whether we have already retried after network failure. */
   get hasRetried() {
-    return this.dohRetried;
+    return this.pilotRetried;
   }
   /**
    * Handle network failure: re-resolve with --exclude and retry once.
    * Returns true if retry should proceed, false if already retried.
    */
   async handleNetworkFailure() {
-    if (this.dohRetried) return false;
-    this.dohRetried = true;
-    const failedIp = this.dohNode?.ip ?? "";
+    if (this.pilotRetried) return false;
+    this.pilotRetried = true;
+    const failedIp = this.pilotNode?.ip ?? "";
     const { hostname, protocol } = new URL(this.opts.baseUrl);
-    this.dohNode = null;
-    this.dohAgent = null;
-    this.dohBaseUrl = null;
+    this.pilotNode = null;
+    this.pilotAgent = null;
+    this.pilotBaseUrl = null;
     if (!failedIp) this.directUnverified = false;
     if (this.opts.verbose) {
-      vlog(failedIp ? `DoH: proxy node ${failedIp} failed, re-resolving with --exclude` : "DoH: direct connection failed, calling binary for DoH resolution");
+      vlog(failedIp ? `Pilot: proxy node ${failedIp} failed, re-resolving with --exclude` : "Pilot: direct connection failed, calling binary for Pilot resolution");
     }
     try {
-      const result = await reResolveDoh(hostname, failedIp, this.dohUserAgent);
+      const result = await reResolvePilot(hostname, failedIp, this.pilotUserAgent);
       if (result.mode === "proxy" && result.node) {
         this.applyNode(result.node, protocol);
-        this.dohRetried = false;
+        this.pilotRetried = false;
         return true;
       }
     } catch {
     }
     if (this.opts.verbose) {
-      vlog("DoH: re-resolution failed or switched to direct, retrying with direct connection");
+      vlog("Pilot: re-resolution failed or switched to direct, retrying with direct connection");
     }
     return true;
   }
@@ -959,7 +959,7 @@ var DohManager = class {
    * (Even if the business response is an error, the network path is valid.)
    */
   cacheDirectIfNeeded() {
-    if (!this.directUnverified || this.dohNode) return;
+    if (!this.directUnverified || this.pilotNode) return;
     this.directUnverified = false;
     const { hostname } = new URL(this.opts.baseUrl);
     writeCache(hostname, {
@@ -969,25 +969,25 @@ var DohManager = class {
       updatedAt: Date.now()
     });
     if (this.opts.verbose) {
-      vlog("DoH: direct connection succeeded, cached mode=direct");
+      vlog("Pilot: direct connection succeeded, cached mode=direct");
     }
   }
-  /** User-Agent for DoH proxy requests: OKX/@okx_ai/{packageName}/{version} */
-  get dohUserAgent() {
+  /** User-Agent for Pilot proxy requests: OKX/@okx_ai/{packageName}/{version} */
+  get pilotUserAgent() {
     return `OKX/@okx_ai/${this.opts.packageUserAgent ?? "unknown"}`;
   }
   /**
-   * Apply a DoH node: set up the custom Agent + base URL.
+   * Apply a Pilot node: set up the custom Agent + base URL.
    *
    * node.ip may be a real IP or a domain (CNAME like *.aliyunddos1021.com).
    * - Real IP → use directly in lookup callback
    * - Domain  → dns.lookup on every connection to get a fresh IP
    */
   applyNode(node, protocol) {
-    this.dohNode = node;
-    this.dohBaseUrl = `${protocol}//${node.host}`;
+    this.pilotNode = node;
+    this.pilotBaseUrl = `${protocol}//${node.host}`;
     const nodeIpIsRealIp = !!isIP(node.ip);
-    this.dohAgent = new Agent({
+    this.pilotAgent = new Agent({
       connect: {
         lookup: (_hostname, options, callback) => {
           if (nodeIpIsRealIp) {
@@ -1011,7 +1011,7 @@ var DohManager = class {
       }
     });
     if (this.opts.verbose) {
-      vlog(`DoH proxy active: \u2192 ${node.host} (${node.ip}), ttl=${node.ttl}s`);
+      vlog(`Pilot proxy active: \u2192 ${node.host} (${node.ip}), ttl=${node.ttl}s`);
     }
   }
 };
@@ -1233,14 +1233,14 @@ var OkxRestClient = class _OkxRestClient {
   config;
   rateLimiter;
   dispatcher;
-  doh;
+  pilot;
   constructor(config) {
     this.config = config;
     this.rateLimiter = new RateLimiter(3e4, config.verbose);
     if (config.proxyUrl) {
       this.dispatcher = new ProxyAgent(config.proxyUrl);
     }
-    this.doh = new DohManager({
+    this.pilot = new PilotManager({
       baseUrl: config.baseUrl,
       packageUserAgent: config.userAgent,
       verbose: config.verbose,
@@ -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) {
@@ -1422,12 +1423,12 @@ var OkxRestClient = class _OkxRestClient {
    * Security: validates Content-Type and enforces maxBytes limit.
    */
   async privatePostBinary(path4, body, opts) {
-    this.doh.prepareDoh();
+    this.pilot.preparePilot();
     const maxBytes = opts?.maxBytes ?? _OkxRestClient.DEFAULT_MAX_BYTES;
     const expectedCT = opts?.expectedContentType ?? "application/octet-stream";
     const bodyJson = body ? JSON.stringify(body) : "";
     const endpoint = `POST ${path4}`;
-    const conn = this.doh.getConnectionParams();
+    const conn = this.pilot.getConnectionParams();
     this.logRequest("POST", `${conn.baseUrl}${path4}`, "private");
     const reqConfig = { method: "POST", path: path4, auth: "private" };
     const headers = this.buildHeaders(reqConfig, path4, bodyJson, getNow());
@@ -1439,13 +1440,15 @@ var OkxRestClient = class _OkxRestClient {
     try {
       response = await this.fetchBinary(path4, endpoint, headers, bodyJson, t0);
     } catch (error) {
-      this.doh.handleNetworkFailure().catch(() => {
-      });
+      try {
+        await this.pilot.handleNetworkFailure();
+      } catch {
+      }
       throw error;
     }
     const elapsed = Date.now() - t0;
     const traceId = extractTraceId(response.headers);
-    this.doh.cacheDirectIfNeeded();
+    this.pilot.cacheDirectIfNeeded();
     if (!response.ok) {
       const text = await response.text();
       this.logResponse(response.status, text.length, elapsed, traceId, String(response.status));
@@ -1471,15 +1474,15 @@ var OkxRestClient = class _OkxRestClient {
   /**
    * Send an unauthenticated GET request and return the raw binary response.
    * Used for pre-signed download URLs where auth is embedded in the token.
-   * Inherits proxy, timeout, DoH, and verbose capabilities from the client.
+   * Inherits proxy, timeout, Pilot, and verbose capabilities from the client.
    */
   async publicGetBinary(path4, query, opts) {
-    this.doh.prepareDoh();
+    this.pilot.preparePilot();
     const maxBytes = opts?.maxBytes ?? _OkxRestClient.DEFAULT_MAX_BYTES;
     const expectedCT = opts?.expectedContentType ?? "application/octet-stream";
     const queryString = buildQueryString(query);
     const requestPath = queryString ? `${path4}?${queryString}` : path4;
-    const conn = this.doh.getConnectionParams();
+    const conn = this.pilot.getConnectionParams();
     const url = `${conn.baseUrl}${requestPath}`;
     this.logRequest("GET", url, "public");
     const headers = new Headers({ Accept: "application/octet-stream" });
@@ -1495,13 +1498,15 @@ var OkxRestClient = class _OkxRestClient {
         dispatcher: this.dispatcher ?? conn.dispatcher
       });
     } catch (error) {
-      this.doh.handleNetworkFailure().catch(() => {
-      });
+      try {
+        await this.pilot.handleNetworkFailure();
+      } catch {
+      }
       throw new NetworkError(`Failed to call OKX endpoint GET ${path4}.`, `GET ${path4}`, error);
     }
     const elapsed = Date.now() - t0;
     const traceId = extractTraceId(response.headers);
-    this.doh.cacheDirectIfNeeded();
+    this.pilot.cacheDirectIfNeeded();
     if (!response.ok) {
       const text = await response.text();
       this.logResponse(response.status, text.length, elapsed, traceId, String(response.status));
@@ -1526,7 +1531,7 @@ var OkxRestClient = class _OkxRestClient {
   }
   /** Execute fetch for binary endpoint, wrapping network errors. */
   async fetchBinary(path4, endpoint, headers, bodyJson, t0) {
-    const conn = this.doh.getConnectionParams();
+    const conn = this.pilot.getConnectionParams();
     try {
       const fetchOptions = {
         method: "POST",
@@ -1573,17 +1578,17 @@ var OkxRestClient = class _OkxRestClient {
   // JSON request
   // ---------------------------------------------------------------------------
   /**
-   * Handle network error during a JSON request: refresh DoH and maybe retry.
+   * Handle network error during a JSON request: refresh Pilot and maybe retry.
    * Always either returns a retry result or throws NetworkError.
    */
   async handleRequestNetworkError(error, reqConfig, requestPath, t0) {
-    if (!this.doh.hasRetried) {
+    if (!this.pilot.hasRetried) {
       if (this.config.verbose) {
         const cause = error instanceof Error ? error.message : String(error);
-        vlog2(`Network failure, refreshing DoH: ${cause}`);
+        vlog2(`Network failure, refreshing Pilot: ${cause}`);
       }
-      const shouldRetry = await this.doh.handleNetworkFailure();
-      if (shouldRetry && reqConfig.method === "GET") {
+      const shouldRetry = await this.pilot.handleNetworkFailure();
+      if (shouldRetry && (reqConfig.method === "GET" || reqConfig.retryOnNetworkError)) {
         return this.request(reqConfig);
       }
     }
@@ -1599,10 +1604,10 @@ var OkxRestClient = class _OkxRestClient {
     );
   }
   async request(reqConfig) {
-    this.doh.prepareDoh();
+    this.pilot.preparePilot();
     const queryString = buildQueryString(reqConfig.query);
     const requestPath = queryString.length > 0 ? `${reqConfig.path}?${queryString}` : reqConfig.path;
-    const conn = this.doh.getConnectionParams();
+    const conn = this.pilot.getConnectionParams();
     const url = `${conn.baseUrl}${requestPath}`;
     const bodyJson = reqConfig.body ? JSON.stringify(reqConfig.body) : "";
     const timestamp = getNow();
@@ -1631,7 +1636,7 @@ var OkxRestClient = class _OkxRestClient {
     const rawText = await response.text();
     const elapsed = Date.now() - t0;
     const traceId = extractTraceId(response.headers);
-    this.doh.cacheDirectIfNeeded();
+    this.pilot.cacheDirectIfNeeded();
     return this.processResponse(rawText, response, elapsed, traceId, reqConfig, requestPath);
   }
 };
@@ -2059,6 +2064,7 @@ var MODULES = [
   "account",
   "event",
   "news",
+  "smartmoney",
   ...EARN_SUB_MODULE_IDS,
   ...BOT_SUB_MODULE_IDS,
   "skills"
@@ -2209,6 +2215,10 @@ function registerAccountTools() {
           showValuation: {
             type: "boolean",
             description: "Include total asset valuation breakdown by account type (trading/funding/earn). Default false."
+          },
+          valuationCcy: {
+            type: "string",
+            description: "Currency used to denominate the total asset valuation (e.g. USDT, BTC). Default USDT. Only applies when showValuation=true."
           }
         }
       },
@@ -2216,6 +2226,7 @@ function registerAccountTools() {
         const args = asRecord(rawArgs);
         const ccy = readString(args, "ccy");
         const showValuation = readBoolean(args, "showValuation");
+        const valuationCcy = readString(args, "valuationCcy") ?? "USDT";
         if (showValuation) {
           const balanceResp2 = await context.client.privateGet(
             "/api/v5/asset/balances",
@@ -2223,16 +2234,26 @@ function registerAccountTools() {
             privateRateLimit("account_get_asset_balance", 6)
           );
           let valuationData = null;
+          let valuationError;
           try {
             const valuationResp = await context.client.privateGet(
               "/api/v5/asset/asset-valuation",
-              {},
+              { ccy: valuationCcy },
               privateRateLimit("account_get_asset_valuation", 1)
             );
             valuationData = valuationResp.data;
-          } catch {
+          } catch (err) {
+            valuationError = err instanceof Error ? err.message : String(err);
           }
-          return { ...normalizeResponse(balanceResp2), valuation: valuationData };
+          const valuationResult = {
+            ...normalizeResponse(balanceResp2),
+            valuation: valuationData,
+            valuationCcy
+          };
+          if (valuationError !== void 0) {
+            valuationResult["valuationError"] = valuationError;
+          }
+          return valuationResult;
         }
         const balanceResp = await context.client.privateGet(
           "/api/v5/asset/balances",
@@ -3904,10 +3925,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 +4060,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 +4081,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 +6230,384 @@ 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/smartmoney/overview";
+var PATH_SIGNAL = "/api/v5/journal/smartmoney/signal";
+var PATH_SIGNAL_HISTORY = "/api/v5/journal/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 [];
+}
+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. Prefer instId (e.g. BTC-USDT-SWAP); instCcy is accepted but may return empty \u2014 use instId for reliable results. 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: "Recommended. e.g. BTC-USDT-SWAP"
+          },
+          instCcy: {
+            type: "string",
+            description: "e.g. BTC, SPOT/SWAP only. May return empty \u2014 prefer 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 (default 1h)"
+          },
+          limit: {
+            type: "string",
+            description: "Data points 1-500 (default 24)"
+          },
+          ...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;
+}
 function buildContractTradeTools(cfg) {
   const { prefix, module, label, instTypes, instIdExample } = cfg;
   const [defaultType, otherType] = instTypes;
@@ -6425,31 +6949,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 +7873,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 +7986,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 +8004,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 +8061,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 +8072,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 +9733,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 +9940,7 @@ function allToolSpecs() {
     ...registerNewsTools(),
     ...registerBotTools(),
     ...registerAllEarnTools(),
+    ...registerSmartmoneyTools(),
     ...registerAuditTools(),
     ...registerSkillsTools()
   ];
@@ -9757,7 +10385,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 ? "e0ee5a96" : "dev";
 
 // src/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -9927,11 +10555,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"