@okx_ai/okx-trade-mcp 1.2.7 → 1.2.8-beta.2

package/dist/index.js

@@ -1534,7 +1534,7 @@ function registerAccountTools() {
     {
       name: "account_get_asset_balance",
       module: "account",
-      description: "Get funding account balance (asset account). Different from account_get_balance which queries the trading account.",
+      description: "Get funding account balance (asset account). Different from account_get_balance which queries the trading account. Optionally includes total asset valuation across all account types (trading, funding, earn, etc.).",
       isWrite: false,
       inputSchema: {
         type: "object",
@@ -1542,17 +1542,41 @@ function registerAccountTools() {
           ccy: {
             type: "string",
             description: "e.g. BTC or BTC,ETH. Omit for all."
+          },
+          showValuation: {
+            type: "boolean",
+            description: "Include total asset valuation breakdown by account type (trading/funding/earn). Default false."
           }
         }
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
-        const response = await context.client.privateGet(
+        const ccy = readString(args, "ccy");
+        const showValuation = readBoolean(args, "showValuation");
+        if (showValuation) {
+          const balanceResp2 = await context.client.privateGet(
+            "/api/v5/asset/balances",
+            compactObject({ ccy }),
+            privateRateLimit("account_get_asset_balance", 6)
+          );
+          let valuationData = null;
+          try {
+            const valuationResp = await context.client.privateGet(
+              "/api/v5/asset/asset-valuation",
+              {},
+              privateRateLimit("account_get_asset_valuation", 1)
+            );
+            valuationData = valuationResp.data;
+          } catch {
+          }
+          return { ...normalizeResponse(balanceResp2), valuation: valuationData };
+        }
+        const balanceResp = await context.client.privateGet(
           "/api/v5/asset/balances",
-          compactObject({ ccy: readString(args, "ccy") }),
+          compactObject({ ccy }),
           privateRateLimit("account_get_asset_balance", 6)
         );
-        return normalizeResponse(response);
+        return normalizeResponse(balanceResp);
       }
     },
     {
@@ -2967,6 +2991,39 @@ function registerGridTools() {
   ];
 }
 var BASE = "/api/v5/tradingBot/dca";
+function buildTriggerParam(args, algoOrdType) {
+  const triggerStrategy = readString(args, "triggerStrategy") ?? "instant";
+  if (triggerStrategy === "price" && algoOrdType === "spot_dca") {
+    throw new OkxApiError(
+      "triggerStrategy 'price' is only supported for contract_dca. spot_dca supports: instant, rsi",
+      { code: "VALIDATION", endpoint: `${BASE}/create` }
+    );
+  }
+  const param = { triggerAction: "start", triggerStrategy };
+  if (triggerStrategy === "price") {
+    param["triggerPx"] = requireString(args, "triggerPx");
+    const triggerCond = readString(args, "triggerCond");
+    if (triggerCond) param["triggerCond"] = triggerCond;
+  } else if (triggerStrategy === "rsi") {
+    param["triggerCond"] = requireString(args, "triggerCond");
+    param["thold"] = requireString(args, "thold");
+    param["timeframe"] = requireString(args, "timeframe");
+    param["timePeriod"] = readString(args, "timePeriod") ?? "14";
+  }
+  return param;
+}
+function validateSafetyOrderParams(args, maxSafetyOrds) {
+  if (Number(maxSafetyOrds) <= 0) return;
+  const required = ["safetyOrdAmt", "pxSteps", "pxStepsMult", "volMult"];
+  for (const field of required) {
+    if (!readString(args, field)) {
+      throw new OkxApiError(`${field} is required when maxSafetyOrds > 0`, {
+        code: "VALIDATION",
+        endpoint: `${BASE}/create`
+      });
+    }
+  }
+}
 function normalizeWrite2(response) {
   const data = response.data;
   if (Array.isArray(data) && data.length > 0) {
@@ -3036,57 +3093,11 @@ function registerDcaTools() {
             endpoint: `${BASE}/create`
           });
         }
-        const triggerStrategy = readString(args, "triggerStrategy") ?? "instant";
-        if (triggerStrategy === "price" && algoOrdType === "spot_dca") {
-          throw new OkxApiError("triggerStrategy 'price' is only supported for contract_dca. spot_dca supports: instant, rsi", {
-            code: "VALIDATION",
-            endpoint: `${BASE}/create`
-          });
-        }
-        const triggerParam = {
-          triggerAction: "start",
-          triggerStrategy
-        };
-        if (triggerStrategy === "price") {
-          triggerParam["triggerPx"] = requireString(args, "triggerPx");
-          const triggerCond = readString(args, "triggerCond");
-          if (triggerCond) {
-            triggerParam["triggerCond"] = triggerCond;
-          }
-        } else if (triggerStrategy === "rsi") {
-          triggerParam["triggerCond"] = requireString(args, "triggerCond");
-          triggerParam["thold"] = requireString(args, "thold");
-          triggerParam["timeframe"] = requireString(args, "timeframe");
-          const timePeriod = readString(args, "timePeriod");
-          triggerParam["timePeriod"] = timePeriod ?? "14";
-        }
+        const triggerParam = buildTriggerParam(args, algoOrdType);
         const maxSafetyOrds = requireString(args, "maxSafetyOrds");
-        if (Number(maxSafetyOrds) > 0) {
-          if (!readString(args, "safetyOrdAmt")) {
-            throw new OkxApiError("safetyOrdAmt is required when maxSafetyOrds > 0", {
-              code: "VALIDATION",
-              endpoint: `${BASE}/create`
-            });
-          }
-          if (!readString(args, "pxSteps")) {
-            throw new OkxApiError("pxSteps is required when maxSafetyOrds > 0", {
-              code: "VALIDATION",
-              endpoint: `${BASE}/create`
-            });
-          }
-          if (!readString(args, "pxStepsMult")) {
-            throw new OkxApiError("pxStepsMult is required when maxSafetyOrds > 0", {
-              code: "VALIDATION",
-              endpoint: `${BASE}/create`
-            });
-          }
-          if (!readString(args, "volMult")) {
-            throw new OkxApiError("volMult is required when maxSafetyOrds > 0", {
-              code: "VALIDATION",
-              endpoint: `${BASE}/create`
-            });
-          }
-        }
+        validateSafetyOrderParams(args, maxSafetyOrds);
+        const allowReinvestRaw = args["allowReinvest"];
+        const allowReinvest = allowReinvestRaw !== void 0 ? allowReinvestRaw === true || allowReinvestRaw === "true" : void 0;
         const response = await context.client.privatePost(
           `${BASE}/create`,
           compactObject({
@@ -3103,7 +3114,7 @@ function registerDcaTools() {
             tpPct: requireString(args, "tpPct"),
             slPct: readString(args, "slPct"),
             slMode: readString(args, "slMode"),
-            allowReinvest: args["allowReinvest"] !== void 0 ? args["allowReinvest"] === true || args["allowReinvest"] === "true" : void 0,
+            allowReinvest,
             triggerParams: [triggerParam],
             tag: context.config.sourceTag,
             algoClOrdId: readString(args, "algoClOrdId"),
@@ -4663,6 +4674,7 @@ function registerFuturesTools() {
     }
   ];
 }
+var TWO_DAYS_MS = 2 * 24 * 60 * 60 * 1e3;
 function registerMarketTools() {
   return [
     {
@@ -4762,7 +4774,7 @@ function registerMarketTools() {
     {
       name: "market_get_candles",
       module: "market",
-      description: "Get candlestick (OHLCV) data for an instrument. history=false (default): recent candles up to 1440 bars; history=true: older historical data.",
+      description: "Get candlestick (OHLCV) data for an instrument. Automatically retrieves historical data (back to 2021) when requesting older time ranges. Use the `after` parameter to paginate back in time (the old `history` parameter has been removed). IMPORTANT: Before fetching with `after`/`before`, estimate the number of candles: time_range_ms / bar_interval_ms. If the estimate exceeds ~500 candles, inform the user of the estimated count and ask for confirmation before proceeding.",
       isWrite: false,
       inputSchema: {
         type: "object",
@@ -4787,29 +4799,29 @@ function registerMarketTools() {
           limit: {
             type: "number",
             description: "Max results (default 100)"
-          },
-          history: {
-            type: "boolean",
-            description: "true=older historical data beyond recent window"
           }
         },
         required: ["instId"]
       },
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
-        const isHistory = readBoolean(args, "history") ?? false;
-        const path4 = isHistory ? "/api/v5/market/history-candles" : "/api/v5/market/candles";
-        const response = await context.client.publicGet(
-          path4,
-          compactObject({
-            instId: requireString(args, "instId"),
-            bar: readString(args, "bar"),
-            after: readString(args, "after"),
-            before: readString(args, "before"),
-            limit: readNumber(args, "limit")
-          }),
-          publicRateLimit("market_get_candles", 40)
-        );
+        const afterTs = readString(args, "after");
+        const beforeTs = readString(args, "before");
+        const query = compactObject({
+          instId: requireString(args, "instId"),
+          bar: readString(args, "bar"),
+          after: afterTs,
+          before: beforeTs,
+          limit: readNumber(args, "limit")
+        });
+        const rateLimit = publicRateLimit("market_get_candles", 40);
+        const hasTimestamp = afterTs !== void 0 || beforeTs !== void 0;
+        const useHistory = afterTs !== void 0 && Number(afterTs) < Date.now() - TWO_DAYS_MS;
+        const path4 = useHistory ? "/api/v5/market/history-candles" : "/api/v5/market/candles";
+        const response = await context.client.publicGet(path4, query, rateLimit);
+        if (!useHistory && hasTimestamp && Array.isArray(response.data) && response.data.length === 0) {
+          return normalizeResponse(await context.client.publicGet("/api/v5/market/history-candles", query, rateLimit));
+        }
         return normalizeResponse(response);
       }
     },
@@ -5662,7 +5674,14 @@ function registerOptionTools() {
       handler: async (rawArgs, context) => {
         const args = asRecord(rawArgs);
         const status = readString(args, "status") ?? "live";
-        const path4 = status === "archive" ? "/api/v5/trade/orders-history-archive" : status === "history" ? "/api/v5/trade/orders-history" : "/api/v5/trade/orders-pending";
+        let path4;
+        if (status === "archive") {
+          path4 = "/api/v5/trade/orders-history-archive";
+        } else if (status === "history") {
+          path4 = "/api/v5/trade/orders-history";
+        } else {
+          path4 = "/api/v5/trade/orders-pending";
+        }
         const response = await context.client.privateGet(
           path4,
           compactObject({
@@ -7070,7 +7089,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 ? "475621d" : "dev";
+var GIT_HASH = true ? "f9ea608" : "dev";
 
 // src/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";