@okx_ai/okx-trade-mcp 1.2.5 → 1.2.6

package/dist/index.js

@@ -882,9 +882,9 @@ var OKX_CODE_BEHAVIORS = {
   "50100": { retry: false, suggestion: "API key lacks required permissions. Update API key permissions." },
   "50110": { retry: false, suggestion: "API key expired. Generate a new API key." },
   // Insufficient funds / margin → do not retry
-  "51008": { retry: false, suggestion: "Insufficient balance. Top up account before retrying." },
-  "51119": { retry: false, suggestion: "Insufficient margin. Add margin before retrying." },
-  "51127": { retry: false, suggestion: "Insufficient available margin. Reduce position or add margin." },
+  "51008": { retry: false, suggestion: "Insufficient balance in trading account. Check funding account via account_get_asset_balance \u2014 funds may be there. Use account_transfer (from=18, to=6) to move funds to trading account, then retry." },
+  "51119": { retry: false, suggestion: "Insufficient margin. Add margin or check funding account (account_get_asset_balance). Transfer via account_transfer (from=18, to=6) if needed." },
+  "51127": { retry: false, suggestion: "Insufficient available margin. Reduce position, add margin, or transfer from funding account (account_transfer from=18 to=6)." },
   // Instrument unavailable → do not retry
   "51021": { retry: false, suggestion: "Instrument does not exist. Check instId." },
   "51022": { retry: false, suggestion: "Instrument not available for trading." },
@@ -967,6 +967,15 @@ var OkxRestClient = class {
       rateLimit
     });
   }
+  async publicPost(path4, body, rateLimit) {
+    return this.request({
+      method: "POST",
+      path: path4,
+      auth: "public",
+      body,
+      rateLimit
+    });
+  }
   async privatePost(path4, body, rateLimit) {
     return this.request({
       method: "POST",
@@ -1121,46 +1130,6 @@ var OkxRestClient = class {
     return this.processResponse(rawText, response, elapsed, traceId, reqConfig, requestPath);
   }
 };
-var DEFAULT_SOURCE_TAG = "MCP";
-var OKX_SITES = {
-  global: {
-    label: "Global",
-    apiBaseUrl: "https://www.okx.com",
-    webUrl: "https://www.okx.com"
-  },
-  eea: {
-    label: "EEA",
-    apiBaseUrl: "https://eea.okx.com",
-    webUrl: "https://my.okx.com"
-  },
-  us: {
-    label: "US",
-    apiBaseUrl: "https://app.okx.com",
-    webUrl: "https://app.okx.com"
-  }
-};
-var SITE_IDS = Object.keys(OKX_SITES);
-var BOT_SUB_MODULE_IDS = [
-  "bot.grid",
-  "bot.dca"
-];
-var BOT_DEFAULT_SUB_MODULES = ["bot.grid"];
-var EARN_SUB_MODULE_IDS = [
-  "earn.savings",
-  "earn.onchain",
-  "earn.dcd"
-];
-var MODULES = [
-  "market",
-  "spot",
-  "swap",
-  "futures",
-  "option",
-  "account",
-  ...EARN_SUB_MODULE_IDS,
-  ...BOT_SUB_MODULE_IDS
-];
-var DEFAULT_MODULES = ["spot", "swap", "option", "account", ...BOT_DEFAULT_SUB_MODULES];
 function asRecord(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     return {};
@@ -1285,6 +1254,152 @@ function assertNotDemo(config, endpoint) {
     );
   }
 }
+var INDICATOR_BARS = [
+  "3m",
+  "5m",
+  "15m",
+  "1H",
+  "4H",
+  "12Hutc",
+  "1Dutc",
+  "3Dutc",
+  "1Wutc"
+];
+var INDICATOR_CODE_OVERRIDES = {
+  "rainbow": "BTCRAINBOW",
+  "range-filter": "RANGEFILTER",
+  "stoch-rsi": "STOCHRSI",
+  "pi-cycle-top": "PI_CYCLE_TOP",
+  "pi-cycle-bottom": "PI_CYCLE_BOTTOM",
+  // boll is an alias for bb; server supports BB not BOLL
+  "boll": "BB"
+};
+function resolveIndicatorCode(name) {
+  const lower = name.toLowerCase();
+  return INDICATOR_CODE_OVERRIDES[lower] ?? name.toUpperCase().replace(/-/g, "_");
+}
+function readNumberArray(args, key) {
+  const value = args[key];
+  if (value === void 0 || value === null) return void 0;
+  if (!Array.isArray(value)) return void 0;
+  return value.map((item) => Number(item));
+}
+function registerIndicatorTools() {
+  return [
+    {
+      name: "market_get_indicator",
+      module: "market",
+      description: "Get technical indicator values for an instrument (MA, EMA, RSI, MACD, BB, KDJ, SUPERTREND, AHR999, BTCRAINBOW, and more). No credentials required.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          instId: {
+            type: "string",
+            description: "Instrument ID, e.g. BTC-USDT"
+          },
+          indicator: {
+            type: "string",
+            description: "Indicator name (case-insensitive). Examples: ma, ema, rsi, macd, bb, kdj, supertrend, ahr999, rainbow, pi-cycle-top, pi-cycle-bottom, mayer, envelope, halftrend, alphatrend, pmax, waddah, tdi, qqe, range-filter"
+          },
+          bar: {
+            type: "string",
+            enum: [...INDICATOR_BARS],
+            description: "Timeframe. Default: 1H"
+          },
+          params: {
+            type: "array",
+            items: { type: "number" },
+            description: "Indicator parameters, e.g. [5, 20] for MA with periods 5 and 20"
+          },
+          returnList: {
+            type: "boolean",
+            description: "Return a historical list instead of the latest value only. Default: false"
+          },
+          limit: {
+            type: "integer",
+            minimum: 1,
+            maximum: 100,
+            description: "Number of historical records to return (only used when returnList=true). Default: 10"
+          },
+          backtestTime: {
+            type: "integer",
+            description: "Backtest timestamp in milliseconds. Omit for live (real-time) mode"
+          }
+        },
+        required: ["instId", "indicator"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const instId = requireString(args, "instId");
+        const indicator = requireString(args, "indicator");
+        const bar = readString(args, "bar") ?? "1H";
+        const params = readNumberArray(args, "params");
+        const returnList = readBoolean(args, "returnList") ?? false;
+        const limit = readNumber(args, "limit") ?? 10;
+        const backtestTime = readNumber(args, "backtestTime");
+        const apiCode = resolveIndicatorCode(indicator);
+        const indicatorConfig = compactObject({
+          paramList: params && params.length > 0 ? params : void 0,
+          returnList,
+          limit: returnList ? limit : void 0
+        });
+        const body = compactObject({
+          instId,
+          timeframes: [bar],
+          indicators: { [apiCode]: indicatorConfig },
+          backtestTime
+        });
+        const response = await context.client.publicPost(
+          "/api/v5/aigc/mcp/indicators",
+          body,
+          publicRateLimit("market_get_indicator", 5)
+        );
+        return normalizeResponse(response);
+      }
+    }
+  ];
+}
+var DEFAULT_SOURCE_TAG = "MCP";
+var OKX_SITES = {
+  global: {
+    label: "Global",
+    apiBaseUrl: "https://www.okx.com",
+    webUrl: "https://www.okx.com"
+  },
+  eea: {
+    label: "EEA",
+    apiBaseUrl: "https://eea.okx.com",
+    webUrl: "https://my.okx.com"
+  },
+  us: {
+    label: "US",
+    apiBaseUrl: "https://app.okx.com",
+    webUrl: "https://app.okx.com"
+  }
+};
+var SITE_IDS = Object.keys(OKX_SITES);
+var BOT_SUB_MODULE_IDS = [
+  "bot.grid",
+  "bot.dca"
+];
+var BOT_DEFAULT_SUB_MODULES = ["bot.grid"];
+var EARN_SUB_MODULE_IDS = [
+  "earn.savings",
+  "earn.onchain",
+  "earn.dcd"
+];
+var MODULES = [
+  "market",
+  "spot",
+  "swap",
+  "futures",
+  "option",
+  "account",
+  ...EARN_SUB_MODULE_IDS,
+  ...BOT_SUB_MODULE_IDS
+];
+var DEFAULT_MODULES = ["spot", "swap", "option", "account", ...BOT_DEFAULT_SUB_MODULES];
 function registerAccountTools() {
   return [
     {
@@ -3922,7 +4037,12 @@ function buildContractTradeTools(cfg) {
           },
           sz: {
             type: "string",
-            description: "Contracts count (NOT USDT). Use market_get_instruments for ctVal."
+            description: "Contracts count by default. Set tgtCcy=quote_ccy to use USDT amount instead."
+          },
+          tgtCcy: {
+            type: "string",
+            enum: ["base_ccy", "quote_ccy"],
+            description: "Size unit. base_ccy(default): sz in contracts, quote_ccy: sz in USDT"
           },
           px: { type: "string", description: "Required for limit/post_only/fok/ioc" },
           reduceOnly: {
@@ -3950,6 +4070,7 @@ function buildContractTradeTools(cfg) {
             posSide: readString(args, "posSide"),
             ordType: requireString(args, "ordType"),
             sz: requireString(args, "sz"),
+            tgtCcy: readString(args, "tgtCcy"),
             px: readString(args, "px"),
             reduceOnly: typeof reduceOnly === "boolean" ? String(reduceOnly) : void 0,
             clOrdId: readString(args, "clOrdId"),
@@ -5605,6 +5726,11 @@ function registerSpotTradeTools() {
             type: "string",
             description: "Buy market: quote amount, all others: base amount"
           },
+          tgtCcy: {
+            type: "string",
+            enum: ["base_ccy", "quote_ccy"],
+            description: "Size unit. base_ccy(default): sz in base (e.g. BTC), quote_ccy: sz in quote (e.g. USDT)"
+          },
           px: {
             type: "string",
             description: "Required for limit/post_only/fok/ioc"
@@ -5643,6 +5769,7 @@ function registerSpotTradeTools() {
             side: requireString(args, "side"),
             ordType: requireString(args, "ordType"),
             sz: requireString(args, "sz"),
+            tgtCcy: readString(args, "tgtCcy"),
             px: readString(args, "px"),
             clOrdId: readString(args, "clOrdId"),
             tag: context.config.sourceTag,
@@ -6371,6 +6498,7 @@ function registerSwapTradeTools() {
 function allToolSpecs() {
   return [
     ...registerMarketTools(),
+    ...registerIndicatorTools(),
     ...registerSpotTradeTools(),
     ...registerSwapTradeTools(),
     ...registerFuturesTools(),
@@ -6412,7 +6540,18 @@ function readFullConfig() {
   const path4 = configFilePath();
   if (!existsSync(path4)) return { profiles: {} };
   const raw = readFileSync(path4, "utf-8");
-  return parse(raw);
+  try {
+    return parse(raw);
+  } catch (err) {
+    throw new ConfigError(
+      `Failed to parse ${path4}: ${err instanceof Error ? err.message : String(err)}`,
+      `If your passphrase or keys contain special characters:
+  - Contains # \\ "  \u2192 use single quotes:  passphrase = 'your#pass'
+  - Contains '       \u2192 use double quotes:  passphrase = "your'pass"
+  - Contains both    \u2192 use triple quotes:  passphrase = '''your'#pass'''
+Or re-run: okx config init`
+    );
+  }
 }
 function readTomlProfile(profileName) {
   const config = readFullConfig();
@@ -6802,7 +6941,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 ? "c00f777" : "dev";
+var GIT_HASH = true ? "9f66f84" : "dev";
 
 // src/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";