@okx_ai/okx-trade-mcp 1.3.3 → 1.3.4-beta.2

package/dist/index.js

@@ -2131,14 +2131,16 @@ var OKX_INST_TYPES = [
 function publicRateLimit(key, rps = 20) {
   return {
     key: `public:${key}`,
-    capacity: rps,
+    capacity: Math.max(1, rps),
+    // capacity >= 1 so the token bucket can fire at least once before refilling
     refillPerSecond: rps
   };
 }
 function privateRateLimit(key, rps = 10) {
   return {
     key: `private:${key}`,
-    capacity: rps,
+    capacity: Math.max(1, rps),
+    // capacity >= 1 so the token bucket can fire at least once before refilling
     refillPerSecond: rps
   };
 }
@@ -9324,6 +9326,58 @@ function registerMarketFilterTools() {
         );
         return normalizeResponse(response);
       }
+    },
+    // ─────────────────────────────────────────────────────────────────────────
+    // market_get_pair_spread — /api/v5/aigc/mcp/pair-spread
+    // ─────────────────────────────────────────────────────────────────────────
+    {
+      name: "market_get_pair_spread",
+      module: "market",
+      description: "Compute spread statistics between two instruments over a lookback window. Returns absolute and ratio spread (mean / stdDev / median / min / max) plus an optional realtime spread snapshot. Use to size pairs trades, detect mean-reversion setups, or compare cross-listed contracts. Results are cached ~60s per (pair, bar, window) tuple. Read-only, no credentials required.\nDo NOT use to fetch raw candles (use market_get_candles) or single-instrument OI/funding (use market_get_oi_history / market_filter_oi_change).",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          instIdA: {
+            type: "string",
+            description: "First instrument ID, e.g. BTC-USDT-SWAP"
+          },
+          instIdB: {
+            type: "string",
+            description: "Second instrument ID; must differ from instIdA"
+          },
+          bar: {
+            type: "string",
+            enum: ["5m", "15m"],
+            description: "Bar size for the spread series. Default 15m. 1m is not supported."
+          },
+          window: {
+            type: "string",
+            description: "Lookback window. Format <n><unit>, units m/H/D/W (case-sensitive), max 1W. Default 1W."
+          },
+          backtestTime: {
+            type: "number",
+            description: "Anchor timestamp (ms epoch) for backtest mode. When provided, realtime is omitted."
+          }
+        },
+        required: ["instIdA", "instIdB"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const body = compactObject({
+          instIdA: requireString(args, "instIdA"),
+          instIdB: requireString(args, "instIdB"),
+          bar: readString(args, "bar"),
+          window: readString(args, "window"),
+          backtestTime: readNumber(args, "backtestTime")
+        });
+        const response = await context.client.publicPost(
+          "/api/v5/aigc/mcp/pair-spread",
+          body,
+          publicRateLimit("market_get_pair_spread", 5)
+        );
+        return normalizeResponse(response);
+      }
     }
   ];
 }
@@ -9332,6 +9386,219 @@ var NEWS_DETAIL = "/api/v5/orbit/news-detail";
 var NEWS_DOMAINS = "/api/v5/orbit/news-platform";
 var SENTIMENT_QUERY = "/api/v5/orbit/currency-sentiment-query";
 var SENTIMENT_RANKING = "/api/v5/orbit/currency-sentiment-ranking";
+var ECONOMIC_CALENDAR = "/api/v5/public/economic-calendar";
+var CALENDAR_REGIONS = [
+  "afghanistan",
+  "albania",
+  "algeria",
+  "andorra",
+  "angola",
+  "antigua_and_barbuda",
+  "argentina",
+  "armenia",
+  "aruba",
+  "australia",
+  "austria",
+  "azerbaijan",
+  "bahamas",
+  "bahrain",
+  "bangladesh",
+  "barbados",
+  "belarus",
+  "belgium",
+  "belize",
+  "benin",
+  "bermuda",
+  "bhutan",
+  "bolivia",
+  "bosnia_and_herzegovina",
+  "botswana",
+  "brazil",
+  "brunei",
+  "bulgaria",
+  "burkina_faso",
+  "burundi",
+  "cambodia",
+  "cameroon",
+  "canada",
+  "cape_verde",
+  "cayman_islands",
+  "central_african_republic",
+  "chad",
+  "chile",
+  "china",
+  "colombia",
+  "comoros",
+  "congo",
+  "costa_rica",
+  "croatia",
+  "cuba",
+  "cyprus",
+  "czech_republic",
+  "denmark",
+  "djibouti",
+  "dominica",
+  "dominican_republic",
+  "east_timor",
+  "ecuador",
+  "egypt",
+  "el_salvador",
+  "equatorial_guinea",
+  "eritrea",
+  "estonia",
+  "ethiopia",
+  "euro_area",
+  "european_union",
+  "faroe_islands",
+  "fiji",
+  "finland",
+  "france",
+  "g20",
+  "g7",
+  "gabon",
+  "gambia",
+  "georgia",
+  "germany",
+  "ghana",
+  "greece",
+  "greenland",
+  "grenada",
+  "guatemala",
+  "guinea",
+  "guinea_bissau",
+  "guyana",
+  "haiti",
+  "honduras",
+  "hong_kong",
+  "hungary",
+  "iceland",
+  "imf",
+  "india",
+  "indonesia",
+  "iran",
+  "iraq",
+  "ireland",
+  "isle_of_man",
+  "israel",
+  "italy",
+  "ivory_coast",
+  "jamaica",
+  "japan",
+  "jordan",
+  "kazakhstan",
+  "kenya",
+  "kiribati",
+  "kosovo",
+  "kuwait",
+  "kyrgyzstan",
+  "laos",
+  "latvia",
+  "lebanon",
+  "lesotho",
+  "liberia",
+  "libya",
+  "liechtenstein",
+  "lithuania",
+  "luxembourg",
+  "macau",
+  "macedonia",
+  "madagascar",
+  "malawi",
+  "malaysia",
+  "maldives",
+  "mali",
+  "malta",
+  "mauritania",
+  "mauritius",
+  "mexico",
+  "micronesia",
+  "moldova",
+  "monaco",
+  "mongolia",
+  "montenegro",
+  "morocco",
+  "mozambique",
+  "myanmar",
+  "namibia",
+  "nepal",
+  "netherlands",
+  "new_caledonia",
+  "new_zealand",
+  "nicaragua",
+  "niger",
+  "nigeria",
+  "north_korea",
+  "northern_mariana_islands",
+  "norway",
+  "oman",
+  "opec",
+  "pakistan",
+  "palau",
+  "palestine",
+  "panama",
+  "papua_new_guinea",
+  "paraguay",
+  "peru",
+  "philippines",
+  "poland",
+  "portugal",
+  "puerto_rico",
+  "qatar",
+  "republic_of_the_congo",
+  "romania",
+  "russia",
+  "rwanda",
+  "samoa",
+  "san_marino",
+  "sao_tome_and_principe",
+  "saudi_arabia",
+  "senegal",
+  "serbia",
+  "seychelles",
+  "sierra_leone",
+  "singapore",
+  "slovakia",
+  "slovenia",
+  "solomon_islands",
+  "somalia",
+  "south_africa",
+  "south_korea",
+  "south_sudan",
+  "spain",
+  "sri_lanka",
+  "st_kitts_and_nevis",
+  "st_lucia",
+  "sudan",
+  "suriname",
+  "swaziland",
+  "sweden",
+  "switzerland",
+  "syria",
+  "taiwan",
+  "tajikistan",
+  "tanzania",
+  "thailand",
+  "togo",
+  "tonga",
+  "trinidad_and_tobago",
+  "tunisia",
+  "turkey",
+  "turkmenistan",
+  "uganda",
+  "ukraine",
+  "united_arab_emirates",
+  "united_kingdom",
+  "united_states",
+  "uruguay",
+  "uzbekistan",
+  "vanuatu",
+  "venezuela",
+  "vietnam",
+  "world",
+  "yemen",
+  "zambia",
+  "zimbabwe"
+];
 var NEWS_LANGUAGE = ["en-US", "zh-CN"];
 function langHeader(lang) {
   if (lang === "zh-CN" || lang === "zh_CN") return { "Accept-Language": "zh-CN" };
@@ -9629,12 +9896,61 @@ function registerNewsTools() {
         );
         return normalizeResponse(response);
       }
+    },
+    // -----------------------------------------------------------------------
+    // Economic calendar
+    // -----------------------------------------------------------------------
+    {
+      name: "news_list_calendar_regions",
+      module: "news",
+      description: "List all valid region values for the economic calendar. Returns a string array of snake_case region codes. Call this when economic-calendar returns empty results to verify the region value, or to help the user pick a valid region. Do NOT use to list news source platforms \u2014 use news_get_domains instead.",
+      isWrite: false,
+      inputSchema: { type: "object", properties: {}, required: [] },
+      handler: async () => ({ data: CALENDAR_REGIONS })
+    },
+    {
+      name: "news_get_economic_calendar",
+      module: "news",
+      description: "Get macro-economic calendar data (GDP, CPI, NFP, interest rate decisions, PMI, etc.). Returns scheduled and released economic events with forecast, previous, and actual values. Use when user asks about economic calendar, macro data, or specific indicators like NFP/CPI/GDP/FOMC. Do NOT use for news articles or sentiment \u2014 use news_get_latest or news_search instead.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          region: { type: "string", description: "Country/region filter in snake_case (e.g. united_states, euro_area, japan). Invalid values return empty results silently. If empty results, call news_list_calendar_regions to verify the value." },
+          importance: { type: "string", enum: ["1", "2", "3"], description: "Importance level: 1=low, 2=medium, 3=high. Omit for all levels." },
+          before: { type: "string", description: "Lower time bound \u2014 returns events NEWER than this timestamp (reversed semantics). Pair with 'after' for future-event windows. Unix ms." },
+          after: { type: "string", description: "Upper time bound \u2014 returns events OLDER than this timestamp (reversed semantics). Default=now (returns past events). Pair with 'before' for a bounded window. Unix ms." },
+          limit: { type: "number", minimum: 1, maximum: 100, description: "Number of results (default 100, max 100)." }
+        },
+        required: []
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const rawLimit = readNumber(args, "limit");
+        const limit = rawLimit !== void 0 ? Math.min(rawLimit, 100) : void 0;
+        const response = await context.client.privateGet(
+          ECONOMIC_CALENDAR,
+          compactObject({
+            region: readString(args, "region"),
+            importance: readString(args, "importance"),
+            before: readString(args, "before"),
+            after: readString(args, "after"),
+            limit
+          }),
+          publicRateLimit("news_get_economic_calendar", 0.2)
+        );
+        return normalizeResponse(response);
+      }
     }
   ];
-  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];
+  const exempt = /* @__PURE__ */ new Set(["news_get_domains", "news_list_calendar_regions"]);
+  const exempted = [];
+  const guarded = [];
+  for (const t of tools) {
+    if (exempt.has(t.name)) exempted.push(t);
+    else guarded.push(t);
+  }
+  return [...guarded.map(withNewsDemoGuard), ...exempted];
 }
 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.";
@@ -11752,7 +12068,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 ? "e6ad1d1e" : "dev";
+var GIT_HASH = true ? "0566db8f" : "dev";
 
 // src/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";