@tradejs/connectors 1.0.5 → 1.0.6

package/dist/index.d.mts

@@ -19,6 +19,7 @@ type MarketDataProviderName = 'coinalyze' | 'binance_coinbase_spread';
 type ProviderWindowParams = {
     symbol: string;
     marketSymbol?: string;
+    apiKey?: string;
     interval: DerivativesInterval;
     fromMs: number;
     toMs: number;

package/dist/index.d.ts

@@ -19,6 +19,7 @@ type MarketDataProviderName = 'coinalyze' | 'binance_coinbase_spread';
 type ProviderWindowParams = {
     symbol: string;
     marketSymbol?: string;
+    apiKey?: string;
     interval: DerivativesInterval;
     fromMs: number;
     toMs: number;

package/dist/index.js

@@ -47,6 +47,7 @@ module.exports = __toCommonJS(index_exports);
 // src/ByBit/index.ts
 var import_lodash = __toESM(require("lodash"));
 var import_chalk = __toESM(require("chalk"));
+var import_async = require("@tradejs/core/async");
 var import_constants2 = require("@tradejs/core/constants");
 var import_data = require("@tradejs/core/data");
 var import_data2 = require("@tradejs/core/data");
@@ -61,7 +62,13 @@ var import_bybit_api = require("bybit-api");
 var import_logger = require("@tradejs/infra/logger");
 var import_redis = require("@tradejs/infra/redis");
 var useTestnet = false;
-var getClient = async ({ userName }) => {
+var getClient = async ({ userName }, access = "private") => {
+  if (access === "public") {
+    return new import_bybit_api.RestClientV5({
+      parseAPIRateLimits: true,
+      testnet: useTestnet
+    });
+  }
   const user = await (0, import_redis.getData)(import_redis.redisKeys.user(userName));
   if (!user) {
     import_logger.logger.log("error", "connection config not found: %s", userName);
@@ -70,6 +77,7 @@ var getClient = async ({ userName }) => {
   const client = new import_bybit_api.RestClientV5({
     key: user.BYBIT_API_KEY,
     secret: user.BYBIT_API_SECRET,
+    parseAPIRateLimits: true,
     testnet: useTestnet
   });
   return client;
@@ -169,6 +177,12 @@ var mapPositionData = (data) => {
 // src/ByBit/index.ts
 var LIMIT = 1e3;
 var CACHE_FALLBACK_WINDOW = 1e3;
+var BYBIT_RATE_LIMIT_RETCODE = 10006;
+var BYBIT_TRADING_STOP_NOT_MODIFIED_RETCODE = 34040;
+var KLINE_RATE_LIMIT_MAX_ATTEMPTS = 3;
+var KLINE_RATE_LIMIT_BASE_DELAY_MS = 800;
+var KLINE_RATE_LIMIT_MAX_DELAY_MS = 1e4;
+var KLINE_RATE_LIMIT_RESET_BUFFER_MS = 50;
 var INTERVAL_TO_MINUTES = {
   "1": 1,
   "3": 3,
@@ -185,9 +199,37 @@ var INTERVAL_TO_MINUTES = {
   M: 43200
 };
 var getLogLevel = (res) => res.retCode === 0 ? "info" : "error";
+var isTradingStopNotModified = (res) => res?.retCode === BYBIT_TRADING_STOP_NOT_MODIFIED_RETCODE;
+var isTradingStopAccepted = (res) => res?.retCode === 0 || isTradingStopNotModified(res);
+var isKlineRateLimited = (res) => res?.retCode === BYBIT_RATE_LIMIT_RETCODE;
+var resolveKlineRetryDelayMs = (res, attempt) => {
+  const resetAtRaw = Number(res?.rateLimitApi?.resetAtTimestamp);
+  if (Number.isFinite(resetAtRaw) && resetAtRaw > 0) {
+    return Math.max(
+      KLINE_RATE_LIMIT_RESET_BUFFER_MS,
+      resetAtRaw - Date.now() + KLINE_RATE_LIMIT_RESET_BUFFER_MS
+    );
+  }
+  const jitterMs = Math.round(Math.random() * 250);
+  const backoffMs = Math.min(
+    KLINE_RATE_LIMIT_MAX_DELAY_MS,
+    KLINE_RATE_LIMIT_BASE_DELAY_MS * 2 ** (attempt - 1)
+  );
+  return backoffMs + jitterMs;
+};
 var ByBitConnectorCreator = async (config) => {
   let state = {};
   let isTimescaleFallbackMode = false;
+  let publicClientPromise = null;
+  let privateClientPromise = null;
+  const getPublicClient = async () => {
+    publicClientPromise ??= getClient(config, "public");
+    return publicClientPromise;
+  };
+  const getPrivateClient = async () => {
+    privateClientPromise ??= getClient(config, "private");
+    return privateClientPromise;
+  };
   const request = async ({
     symbol,
     interval,
@@ -201,41 +243,60 @@ var ByBitConnectorCreator = async (config) => {
     );
     const normalizedEnd = (0, import_math.round)(end || Date.now());
     try {
-      const client = await getClient(config);
+      const client = await getPublicClient();
       if (!client) return [];
       if (normalizedEnd <= normalizedStart) {
         return [];
       }
-      const kline = await client.getKline({
-        category: import_constants2.MARKET_CATEGORY,
-        symbol,
-        interval,
-        start: normalizedStart,
-        end: normalizedEnd,
-        limit: LIMIT
-      });
-      if (!kline?.result?.list) {
-        const responseError = typeof kline?.retMsg === "string" && kline.retMsg !== "OK" ? `${kline.retMsg}${typeof kline?.retCode === "number" ? ` (retCode: ${kline.retCode})` : ""}` : typeof kline?.retCode === "number" && kline.retCode !== 0 ? `retCode: ${kline.retCode}` : "";
-        import_logger2.logger.log(
-          "error",
-          "empty kline.list for %s %s%s",
+      for (let attempt = 1; attempt <= KLINE_RATE_LIMIT_MAX_ATTEMPTS; attempt += 1) {
+        const kline = await client.getKline({
+          category: import_constants2.MARKET_CATEGORY,
           symbol,
           interval,
-          responseError ? `: ${responseError}` : ""
-        );
-        return [];
-      }
-      if (!silent) {
-        import_logger2.logger.log(
-          "info",
-          "%s %s %s %s",
-          import_chalk.default.yellow((0, import_time2.formatUnix)(normalizedEnd)),
-          import_chalk.default.cyan(symbol),
-          import_chalk.default.cyan(interval),
-          import_chalk.default.yellow(kline.result.list.length)
-        );
+          start: normalizedStart,
+          end: normalizedEnd,
+          limit: LIMIT
+        });
+        if (isKlineRateLimited(kline)) {
+          if (attempt < KLINE_RATE_LIMIT_MAX_ATTEMPTS) {
+            const waitMs = resolveKlineRetryDelayMs(kline, attempt);
+            import_logger2.logger.log(
+              "warn",
+              "kline rate limited for %s %s: attempt=%s/%s waitMs=%s",
+              symbol,
+              interval,
+              attempt,
+              KLINE_RATE_LIMIT_MAX_ATTEMPTS,
+              waitMs
+            );
+            await (0, import_async.delay)(waitMs);
+            continue;
+          }
+        }
+        if (!kline?.result?.list) {
+          const responseError = typeof kline?.retMsg === "string" && kline.retMsg !== "OK" ? `${kline.retMsg}${typeof kline?.retCode === "number" ? ` (retCode: ${kline.retCode})` : ""}` : typeof kline?.retCode === "number" && kline.retCode !== 0 ? `retCode: ${kline.retCode}` : "";
+          import_logger2.logger.log(
+            "error",
+            "empty kline.list for %s %s%s",
+            symbol,
+            interval,
+            responseError ? `: ${responseError}` : ""
+          );
+          return [];
+        }
+        if (!silent) {
+          import_logger2.logger.log(
+            "info",
+            "%s %s %s %s",
+            import_chalk.default.yellow((0, import_time2.formatUnix)(normalizedEnd)),
+            import_chalk.default.cyan(symbol),
+            import_chalk.default.cyan(interval),
+            import_chalk.default.yellow(kline.result.list.length)
+          );
+        }
+        return mapKlineToChartData(kline.result.list.reverse());
       }
-      return mapKlineToChartData(kline.result.list.reverse());
+      return [];
     } catch (error) {
       import_logger2.logger.log(
         "error",
@@ -327,6 +388,190 @@ var ByBitConnectorCreator = async (config) => {
       await (0, import_timescale.upsertCandles)((0, import_timescale.toRows)(symbol, intMinutes, part));
     }
   };
+  const getPositionSnapshot = async (symbol) => {
+    const client = await getPrivateClient();
+    if (!client) {
+      return null;
+    }
+    const positionRes = await client.getPositionInfo({
+      symbol,
+      category: import_constants2.MARKET_CATEGORY
+    });
+    if (positionRes.retCode !== 0) {
+      import_logger2.logger.log(
+        getLogLevel(positionRes),
+        "position retCode: %s, %s",
+        symbol,
+        positionRes.retCode
+      );
+      return null;
+    }
+    const positions = mapPositionData(positionRes.result.list);
+    if (!positions || import_lodash.default.isEmpty(positions)) {
+      return null;
+    }
+    const position = positions[0];
+    import_logger2.logger.log(
+      "debug",
+      "position: %s %s qty=%s price=%s",
+      position.symbol,
+      position.direction,
+      position.qty,
+      position.price
+    );
+    return {
+      ...position
+    };
+  };
+  const setTakeProfits = async ({
+    symbol,
+    direction,
+    qty,
+    takeProfits
+  }) => {
+    const client = await getPrivateClient();
+    const marketDataClient = await getPublicClient();
+    if (!client || !marketDataClient) {
+      return false;
+    }
+    if (!Array.isArray(takeProfits) || takeProfits.length === 0) {
+      return true;
+    }
+    const meta = await getSymbolMeta(marketDataClient, symbol);
+    const positionQty = qty ?? (await getPositionSnapshot(symbol))?.qty ?? 0;
+    if (!Number.isFinite(positionQty) || positionQty <= 0) {
+      import_logger2.logger.log(
+        "warn",
+        "setTakeProfits: missing position qty: %s",
+        (0, import_data2.toJson)({ symbol, qty, positionQty, takeProfits }, true)
+      );
+      return false;
+    }
+    const isLong = direction === "LONG";
+    for (const tp of takeProfits) {
+      const tpSizeRaw = positionQty * tp.rate;
+      const { qtyNum: tpSizeNum, qtyStr: tpSizeStr } = normalizeQty(
+        tpSizeRaw,
+        meta
+      );
+      if (!tpSizeNum || tpSizeNum < meta.minOrderQty) {
+        import_logger2.logger.log(
+          "warn",
+          "tp skipped: size too small %s",
+          (0, import_data2.toJson)(
+            { symbol, tp, tpSizeNum, minOrderQty: meta.minOrderQty },
+            true
+          )
+        );
+        continue;
+      }
+      const tpPriceNorm = normalizePrice(
+        tp.price,
+        isLong ? "TP_LONG" : "TP_SHORT",
+        meta
+      );
+      const isFullMode = takeProfits.length === 1 && tp.rate === 1;
+      const tpRes = await client.setTradingStop({
+        category: import_constants2.MARKET_CATEGORY,
+        symbol,
+        tpSize: isFullMode ? void 0 : tpSizeStr,
+        tpslMode: isFullMode ? "Full" : "Partial",
+        takeProfit: tpPriceNorm.priceStr,
+        tpTriggerBy: "MarkPrice",
+        tpOrderType: "Market",
+        positionIdx: 0
+      });
+      if (isTradingStopNotModified(tpRes)) {
+        import_logger2.logger.log(
+          "debug",
+          "tp unchanged: %s %s price=%s rate=%s",
+          symbol,
+          direction,
+          tpPriceNorm.priceStr,
+          tp.rate
+        );
+      } else if (tpRes.retCode === 0) {
+        import_logger2.logger.log(
+          "info",
+          "tp updated: %s %s price=%s rate=%s",
+          symbol,
+          direction,
+          tpPriceNorm.priceStr,
+          tp.rate
+        );
+      } else {
+        import_logger2.logger.log(
+          "error",
+          "tp failed: %s %s price=%s rate=%s %s",
+          symbol,
+          direction,
+          tpPriceNorm.priceStr,
+          tp.rate,
+          (0, import_data2.toJson)(tpRes, true)
+        );
+      }
+      if (!isTradingStopAccepted(tpRes)) {
+        return false;
+      }
+    }
+    return true;
+  };
+  const setStopLoss = async ({
+    symbol,
+    direction,
+    stopLossPrice
+  }) => {
+    const client = await getPrivateClient();
+    const marketDataClient = await getPublicClient();
+    if (!client || !marketDataClient) {
+      return false;
+    }
+    if (typeof stopLossPrice !== "number" || !Number.isFinite(stopLossPrice)) {
+      return true;
+    }
+    const meta = await getSymbolMeta(marketDataClient, symbol);
+    const isLong = direction === "LONG";
+    const slNormalized = normalizePrice(
+      stopLossPrice,
+      isLong ? "SL_LONG" : "SL_SHORT",
+      meta
+    );
+    const slRes = await client.setTradingStop({
+      category: import_constants2.MARKET_CATEGORY,
+      symbol,
+      tpslMode: "Full",
+      stopLoss: slNormalized.priceStr,
+      slTriggerBy: "LastPrice",
+      positionIdx: 0
+    });
+    if (isTradingStopNotModified(slRes)) {
+      import_logger2.logger.log(
+        "debug",
+        "sl unchanged: %s %s stopLoss=%s",
+        symbol,
+        direction,
+        slNormalized.priceStr
+      );
+    } else if (slRes.retCode === 0) {
+      import_logger2.logger.log(
+        "info",
+        "sl updated: %s %s stopLoss=%s",
+        symbol,
+        direction,
+        slNormalized.priceStr
+      );
+    } else {
+      import_logger2.logger.log(
+        "error",
+        "sl failed: %s %s stopLoss=%s %s",
+        symbol,
+        direction,
+        slNormalized.priceStr,
+        (0, import_data2.toJson)(slRes, true)
+      );
+    }
+    return isTradingStopAccepted(slRes);
+  };
   return {
     getState: async () => state,
     setState: async (newState) => {
@@ -338,7 +583,8 @@ var ByBitConnectorCreator = async (config) => {
       start: defaultStart,
       end: defaultEnd,
       silent = false,
-      cacheOnly = false
+      cacheOnly = false,
+      warmOnly = false
     }) => {
       const intMinutes = intervalToMinutes(interval);
       if (!intMinutes) {
@@ -414,6 +660,16 @@ var ByBitConnectorCreator = async (config) => {
         if (!cacheOnly && isRightEdgeQuery) {
           await refreshTail({ symbol, interval, silent });
         }
+        if (warmOnly) {
+          if (isTimescaleFallbackMode) {
+            isTimescaleFallbackMode = false;
+            import_logger2.logger.log(
+              "info",
+              "TimescaleDB connection restored for kline cache"
+            );
+          }
+          return [];
+        }
         const rangeStart = defaultStart ?? dataStart ?? 0;
         const rangeEnd = defaultEnd ?? dataEnd ?? Date.now();
         const { normStart: finalStart, normEnd: finalEnd } = normalizeRangeToClosed(intervalMs, rangeStart, rangeEnd);
@@ -439,7 +695,7 @@ var ByBitConnectorCreator = async (config) => {
             String(error)
           );
         }
-        if (cacheOnly) {
+        if (cacheOnly || warmOnly) {
           return [];
         }
         return request({
@@ -451,41 +707,9 @@ var ByBitConnectorCreator = async (config) => {
         });
       }
     },
-    getPosition: async (symbol) => {
-      const client = await getClient(config);
-      if (!client) {
-        return null;
-      }
-      const positionRes = await client.getPositionInfo({
-        symbol,
-        category: import_constants2.MARKET_CATEGORY
-      });
-      import_logger2.logger.log(
-        getLogLevel(positionRes),
-        "position retCode: %s, %s",
-        symbol,
-        positionRes.retCode
-      );
-      if (positionRes.retCode !== 0) {
-        return null;
-      }
-      const positions = mapPositionData(positionRes.result.list);
-      if (!positions || import_lodash.default.isEmpty(positions)) {
-        return null;
-      }
-      const position = positions[0];
-      import_logger2.logger.log(
-        getLogLevel(positionRes),
-        "position: %s, %s",
-        symbol,
-        (0, import_data2.toJson)(positionRes, true)
-      );
-      return {
-        ...position
-      };
-    },
+    getPosition: async (symbol) => getPositionSnapshot(symbol),
     getPositions: async () => {
-      const client = await getClient(config);
+      const client = await getPrivateClient();
       if (!client) {
         return [];
       }
@@ -493,12 +717,12 @@ var ByBitConnectorCreator = async (config) => {
         category: import_constants2.MARKET_CATEGORY,
         settleCoin: "USDT"
       });
-      import_logger2.logger.log(
-        getLogLevel(positionRes),
-        "positions retCode: %s, %s",
-        positionRes.retCode
-      );
       if (positionRes.retCode !== 0) {
+        import_logger2.logger.log(
+          getLogLevel(positionRes),
+          "positions retCode: %s, %s",
+          positionRes.retCode
+        );
         return [];
       }
       const positions = mapPositionData(positionRes.result.list);
@@ -507,13 +731,14 @@ var ByBitConnectorCreator = async (config) => {
       }
       return positions;
     },
-    placeOrder: async ({ symbol, price, qty, direction, isLimit }, TP = [], slPrice) => {
-      const client = await getClient(config);
-      if (!client) {
+    placeOrder: async ({ symbol, price, qty, direction, isLimit }) => {
+      const client = await getPrivateClient();
+      const marketDataClient = await getPublicClient();
+      if (!client || !marketDataClient) {
         return false;
       }
       const isLong = direction === "LONG";
-      const meta = await getSymbolMeta(client, symbol);
+      const meta = await getSymbolMeta(marketDataClient, symbol);
       const { qtyNum: orderQty, qtyStr: orderQtyStr } = normalizeQty(qty, meta);
       if (orderQty < meta.minOrderQty) {
         import_logger2.logger.log(
@@ -527,9 +752,6 @@ var ByBitConnectorCreator = async (config) => {
         return false;
       }
       const entryNormalized = isLimit ? normalizePrice(price, "ENTRY", meta) : void 0;
-      const slNormalized = slPrice ? normalizePrice(slPrice, isLong ? "SL_LONG" : "SL_SHORT", meta) : void 0;
-      const firstTP = TP?.[0];
-      const tpNormalized = firstTP && firstTP.rate === 1 ? normalizePrice(firstTP.price, isLong ? "TP_LONG" : "TP_SHORT", meta) : void 0;
       import_logger2.logger.log(
         "info",
         "placeOrder: %s",
@@ -540,10 +762,7 @@ var ByBitConnectorCreator = async (config) => {
             qty,
             direction,
             orderQty,
-            orderQtyStr,
-            slPrice,
-            slPriceNorm: slNormalized?.priceStr,
-            TP
+            orderQtyStr
           },
           true
         )
@@ -558,10 +777,6 @@ var ByBitConnectorCreator = async (config) => {
         category: import_constants2.MARKET_CATEGORY,
         symbol,
         price: entryNormalized?.priceStr || void 0,
-        takeProfit: tpNormalized?.priceStr || void 0,
-        tpTriggerBy: "MarkPrice",
-        stopLoss: slNormalized?.priceStr || void 0,
-        slTriggerBy: "LastPrice",
         side: isLong ? "Buy" : "Sell",
         orderType: isLimit ? "Limit" : "Market",
         qty: orderQtyStr,
@@ -575,53 +790,12 @@ var ByBitConnectorCreator = async (config) => {
       if (orderRes.retCode !== 0) {
         return false;
       }
-      if (!isLimit) {
-        for (const tp of TP) {
-          const tpSizeRaw = orderQty * tp.rate;
-          const { qtyNum: tpSizeNum, qtyStr: tpSizeStr } = normalizeQty(
-            tpSizeRaw,
-            meta
-          );
-          if (!tpSizeNum || tpSizeNum < meta.minOrderQty) {
-            import_logger2.logger.log(
-              "warn",
-              "tp skipped: size too small %s",
-              (0, import_data2.toJson)(
-                { symbol, tp, tpSizeNum, minOrderQty: meta.minOrderQty },
-                true
-              )
-            );
-            continue;
-          }
-          const tpPriceNorm = normalizePrice(
-            tp.price,
-            isLong ? "TP_LONG" : "TP_SHORT",
-            meta
-          );
-          const isFullMode = TP.length === 1 && tp.rate === 1;
-          const tpRes = await client.setTradingStop({
-            category: import_constants2.MARKET_CATEGORY,
-            symbol,
-            tpSize: isFullMode ? void 0 : tpSizeStr,
-            tpslMode: isFullMode ? "Full" : "Partial",
-            takeProfit: tpPriceNorm.priceStr,
-            stopLoss: isFullMode && slNormalized ? slNormalized.priceStr : void 0,
-            slTriggerBy: "LastPrice",
-            tpOrderType: "Market",
-            positionIdx: 0
-          });
-          import_logger2.logger.log(
-            getLogLevel(tpRes),
-            "tp: %s %s",
-            (0, import_data2.toJson)(tp, true),
-            (0, import_data2.toJson)(tpRes, true)
-          );
-        }
-      }
       return true;
     },
+    setTakeProfits,
+    setStopLoss,
     closePosition: async ({ symbol, direction }) => {
-      const client = await getClient(config);
+      const client = await getPrivateClient();
       if (!client) {
         return false;
       }
@@ -646,7 +820,7 @@ var ByBitConnectorCreator = async (config) => {
       return true;
     },
     getTickers: async () => {
-      const client = await getClient(config);
+      const client = await getPublicClient();
       if (!client) {
         return [];
       }
@@ -747,6 +921,8 @@ var BinanceConnectorCreator = async () => {
     getPosition: async () => null,
     getPositions: async () => [],
     placeOrder: async () => false,
+    setTakeProfits: async () => false,
+    setStopLoss: async () => false,
     closePosition: async () => false,
     getTickers: async () => {
       const baseUrl = process.env.BINANCE_BASE_URL?.trim() || "https://api.binance.com";
@@ -906,6 +1082,8 @@ var CoinbaseConnectorCreator = async () => {
     getPosition: async () => null,
     getPositions: async () => [],
     placeOrder: async () => false,
+    setTakeProfits: async () => false,
+    setStopLoss: async () => false,
     closePosition: async () => false,
     getTickers: async () => {
       const baseUrl = process.env.COINBASE_BASE_URL?.trim() || "https://api.exchange.coinbase.com";
@@ -1117,7 +1295,7 @@ var binanceCoinbaseSpreadProvider = {
 };
 
 // src/marketData/providers/coinalyze.ts
-var import_async = require("@tradejs/core/async");
+var import_async2 = require("@tradejs/core/async");
 var import_indicators2 = require("@tradejs/core/indicators");
 var coinalyzeIntervalMap = {
   "15m": "15min",
@@ -1168,12 +1346,8 @@ var normalizeMetricPayload = (metric, raw) => {
   }));
 };
 var fetchCoinalyzeSeries = async (params) => {
-  const { endpoint, metric, symbol, interval, fromMs, toMs } = params;
+  const { endpoint, metric, symbol, apiKey, interval, fromMs, toMs } = params;
   const baseUrl = process.env.COINALYZE_BASE_URL?.trim() || "https://api.coinalyze.net/v1";
-  const apiKey = process.env.COINALYZE_API_KEY?.trim();
-  if (!apiKey) {
-    throw new Error("Missing COINALYZE_API_KEY");
-  }
   const url = new URL(`${baseUrl}${endpoint}`);
   url.searchParams.set("symbols", symbol);
   url.searchParams.set("interval", coinalyzeIntervalMap[interval] || interval);
@@ -1191,7 +1365,7 @@ var fetchCoinalyzeSeries = async (params) => {
       lastRequestTs + coinalyzeMinRequestDelayMs - now
     );
     if (waitMs > 0) {
-      await (0, import_async.delay)(waitMs);
+      await (0, import_async2.delay)(waitMs);
     }
     lastRequestTs = Date.now();
     const response = await fetch(url.toString(), { headers });
@@ -1205,7 +1379,7 @@ var fetchCoinalyzeSeries = async (params) => {
     const transient = response.status === 429 || response.status >= 500;
     if (attempt < coinalyzeMaxRetries && transient) {
       const backoffMs = Math.min(1e4, 750 * 2 ** attempt);
-      await (0, import_async.delay)(retryAfterMs ?? backoffMs);
+      await (0, import_async2.delay)(retryAfterMs ?? backoffMs);
       continue;
     }
     throw new Error(`Coinalyze ${endpoint} ${response.status}: ${text}`);
@@ -1214,15 +1388,27 @@ var fetchCoinalyzeSeries = async (params) => {
 };
 var coinalyzeProvider = {
   name: "coinalyze",
-  fetchWindow: async ({ symbol, marketSymbol, interval, fromMs, toMs }) => {
+  fetchWindow: async ({
+    symbol,
+    marketSymbol,
+    apiKey,
+    interval,
+    fromMs,
+    toMs
+  }) => {
+    if (!apiKey?.trim()) {
+      throw new Error("Missing COINALYZE_API_KEY in user settings");
+    }
     const oiPath = process.env.COINALYZE_OI_PATH?.trim() || "/open-interest-history";
     const fundingPath = process.env.COINALYZE_FUNDING_PATH?.trim() || "/funding-rate-history";
     const liqPath = process.env.COINALYZE_LIQ_PATH?.trim() || "/liquidation-history";
     const requestSymbol = (marketSymbol || symbol).trim().toUpperCase();
+    const normalizedApiKey = apiKey.trim();
     const oiRaw = await fetchCoinalyzeSeries({
       endpoint: oiPath,
       metric: "oi",
       symbol: requestSymbol,
+      apiKey: normalizedApiKey,
       interval,
       fromMs,
       toMs
@@ -1231,6 +1417,7 @@ var coinalyzeProvider = {
       endpoint: fundingPath,
       metric: "funding",
       symbol: requestSymbol,
+      apiKey: normalizedApiKey,
       interval,
       fromMs,
       toMs
@@ -1239,6 +1426,7 @@ var coinalyzeProvider = {
       endpoint: liqPath,
       metric: "liq",
       symbol: requestSymbol,
+      apiKey: normalizedApiKey,
       interval,
       fromMs,
       toMs

package/dist/index.mjs

@@ -1,6 +1,7 @@
 // src/ByBit/index.ts
 import _ from "lodash";
 import chalk from "chalk";
+import { delay } from "@tradejs/core/async";
 import {
   MARKET_CATEGORY as MARKET_CATEGORY2,
   PRELOAD_FALLBACK_DAYS
@@ -23,7 +24,13 @@ import { RestClientV5 } from "bybit-api";
 import { logger } from "@tradejs/infra/logger";
 import { getData, redisKeys } from "@tradejs/infra/redis";
 var useTestnet = false;
-var getClient = async ({ userName }) => {
+var getClient = async ({ userName }, access = "private") => {
+  if (access === "public") {
+    return new RestClientV5({
+      parseAPIRateLimits: true,
+      testnet: useTestnet
+    });
+  }
   const user = await getData(redisKeys.user(userName));
   if (!user) {
     logger.log("error", "connection config not found: %s", userName);
@@ -32,6 +39,7 @@ var getClient = async ({ userName }) => {
   const client = new RestClientV5({
     key: user.BYBIT_API_KEY,
     secret: user.BYBIT_API_SECRET,
+    parseAPIRateLimits: true,
     testnet: useTestnet
   });
   return client;
@@ -131,6 +139,12 @@ var mapPositionData = (data) => {
 // src/ByBit/index.ts
 var LIMIT = 1e3;
 var CACHE_FALLBACK_WINDOW = 1e3;
+var BYBIT_RATE_LIMIT_RETCODE = 10006;
+var BYBIT_TRADING_STOP_NOT_MODIFIED_RETCODE = 34040;
+var KLINE_RATE_LIMIT_MAX_ATTEMPTS = 3;
+var KLINE_RATE_LIMIT_BASE_DELAY_MS = 800;
+var KLINE_RATE_LIMIT_MAX_DELAY_MS = 1e4;
+var KLINE_RATE_LIMIT_RESET_BUFFER_MS = 50;
 var INTERVAL_TO_MINUTES = {
   "1": 1,
   "3": 3,
@@ -147,9 +161,37 @@ var INTERVAL_TO_MINUTES = {
   M: 43200
 };
 var getLogLevel = (res) => res.retCode === 0 ? "info" : "error";
+var isTradingStopNotModified = (res) => res?.retCode === BYBIT_TRADING_STOP_NOT_MODIFIED_RETCODE;
+var isTradingStopAccepted = (res) => res?.retCode === 0 || isTradingStopNotModified(res);
+var isKlineRateLimited = (res) => res?.retCode === BYBIT_RATE_LIMIT_RETCODE;
+var resolveKlineRetryDelayMs = (res, attempt) => {
+  const resetAtRaw = Number(res?.rateLimitApi?.resetAtTimestamp);
+  if (Number.isFinite(resetAtRaw) && resetAtRaw > 0) {
+    return Math.max(
+      KLINE_RATE_LIMIT_RESET_BUFFER_MS,
+      resetAtRaw - Date.now() + KLINE_RATE_LIMIT_RESET_BUFFER_MS
+    );
+  }
+  const jitterMs = Math.round(Math.random() * 250);
+  const backoffMs = Math.min(
+    KLINE_RATE_LIMIT_MAX_DELAY_MS,
+    KLINE_RATE_LIMIT_BASE_DELAY_MS * 2 ** (attempt - 1)
+  );
+  return backoffMs + jitterMs;
+};
 var ByBitConnectorCreator = async (config) => {
   let state = {};
   let isTimescaleFallbackMode = false;
+  let publicClientPromise = null;
+  let privateClientPromise = null;
+  const getPublicClient = async () => {
+    publicClientPromise ??= getClient(config, "public");
+    return publicClientPromise;
+  };
+  const getPrivateClient = async () => {
+    privateClientPromise ??= getClient(config, "private");
+    return privateClientPromise;
+  };
   const request = async ({
     symbol,
     interval,
@@ -163,41 +205,60 @@ var ByBitConnectorCreator = async (config) => {
     );
     const normalizedEnd = round(end || Date.now());
     try {
-      const client = await getClient(config);
+      const client = await getPublicClient();
       if (!client) return [];
       if (normalizedEnd <= normalizedStart) {
         return [];
       }
-      const kline = await client.getKline({
-        category: MARKET_CATEGORY2,
-        symbol,
-        interval,
-        start: normalizedStart,
-        end: normalizedEnd,
-        limit: LIMIT
-      });
-      if (!kline?.result?.list) {
-        const responseError = typeof kline?.retMsg === "string" && kline.retMsg !== "OK" ? `${kline.retMsg}${typeof kline?.retCode === "number" ? ` (retCode: ${kline.retCode})` : ""}` : typeof kline?.retCode === "number" && kline.retCode !== 0 ? `retCode: ${kline.retCode}` : "";
-        logger2.log(
-          "error",
-          "empty kline.list for %s %s%s",
+      for (let attempt = 1; attempt <= KLINE_RATE_LIMIT_MAX_ATTEMPTS; attempt += 1) {
+        const kline = await client.getKline({
+          category: MARKET_CATEGORY2,
           symbol,
           interval,
-          responseError ? `: ${responseError}` : ""
-        );
-        return [];
-      }
-      if (!silent) {
-        logger2.log(
-          "info",
-          "%s %s %s %s",
-          chalk.yellow(formatUnix2(normalizedEnd)),
-          chalk.cyan(symbol),
-          chalk.cyan(interval),
-          chalk.yellow(kline.result.list.length)
-        );
+          start: normalizedStart,
+          end: normalizedEnd,
+          limit: LIMIT
+        });
+        if (isKlineRateLimited(kline)) {
+          if (attempt < KLINE_RATE_LIMIT_MAX_ATTEMPTS) {
+            const waitMs = resolveKlineRetryDelayMs(kline, attempt);
+            logger2.log(
+              "warn",
+              "kline rate limited for %s %s: attempt=%s/%s waitMs=%s",
+              symbol,
+              interval,
+              attempt,
+              KLINE_RATE_LIMIT_MAX_ATTEMPTS,
+              waitMs
+            );
+            await delay(waitMs);
+            continue;
+          }
+        }
+        if (!kline?.result?.list) {
+          const responseError = typeof kline?.retMsg === "string" && kline.retMsg !== "OK" ? `${kline.retMsg}${typeof kline?.retCode === "number" ? ` (retCode: ${kline.retCode})` : ""}` : typeof kline?.retCode === "number" && kline.retCode !== 0 ? `retCode: ${kline.retCode}` : "";
+          logger2.log(
+            "error",
+            "empty kline.list for %s %s%s",
+            symbol,
+            interval,
+            responseError ? `: ${responseError}` : ""
+          );
+          return [];
+        }
+        if (!silent) {
+          logger2.log(
+            "info",
+            "%s %s %s %s",
+            chalk.yellow(formatUnix2(normalizedEnd)),
+            chalk.cyan(symbol),
+            chalk.cyan(interval),
+            chalk.yellow(kline.result.list.length)
+          );
+        }
+        return mapKlineToChartData(kline.result.list.reverse());
       }
-      return mapKlineToChartData(kline.result.list.reverse());
+      return [];
     } catch (error) {
       logger2.log(
         "error",
@@ -289,6 +350,190 @@ var ByBitConnectorCreator = async (config) => {
       await upsertCandles(toRows(symbol, intMinutes, part));
     }
   };
+  const getPositionSnapshot = async (symbol) => {
+    const client = await getPrivateClient();
+    if (!client) {
+      return null;
+    }
+    const positionRes = await client.getPositionInfo({
+      symbol,
+      category: MARKET_CATEGORY2
+    });
+    if (positionRes.retCode !== 0) {
+      logger2.log(
+        getLogLevel(positionRes),
+        "position retCode: %s, %s",
+        symbol,
+        positionRes.retCode
+      );
+      return null;
+    }
+    const positions = mapPositionData(positionRes.result.list);
+    if (!positions || _.isEmpty(positions)) {
+      return null;
+    }
+    const position = positions[0];
+    logger2.log(
+      "debug",
+      "position: %s %s qty=%s price=%s",
+      position.symbol,
+      position.direction,
+      position.qty,
+      position.price
+    );
+    return {
+      ...position
+    };
+  };
+  const setTakeProfits = async ({
+    symbol,
+    direction,
+    qty,
+    takeProfits
+  }) => {
+    const client = await getPrivateClient();
+    const marketDataClient = await getPublicClient();
+    if (!client || !marketDataClient) {
+      return false;
+    }
+    if (!Array.isArray(takeProfits) || takeProfits.length === 0) {
+      return true;
+    }
+    const meta = await getSymbolMeta(marketDataClient, symbol);
+    const positionQty = qty ?? (await getPositionSnapshot(symbol))?.qty ?? 0;
+    if (!Number.isFinite(positionQty) || positionQty <= 0) {
+      logger2.log(
+        "warn",
+        "setTakeProfits: missing position qty: %s",
+        toJson({ symbol, qty, positionQty, takeProfits }, true)
+      );
+      return false;
+    }
+    const isLong = direction === "LONG";
+    for (const tp of takeProfits) {
+      const tpSizeRaw = positionQty * tp.rate;
+      const { qtyNum: tpSizeNum, qtyStr: tpSizeStr } = normalizeQty(
+        tpSizeRaw,
+        meta
+      );
+      if (!tpSizeNum || tpSizeNum < meta.minOrderQty) {
+        logger2.log(
+          "warn",
+          "tp skipped: size too small %s",
+          toJson(
+            { symbol, tp, tpSizeNum, minOrderQty: meta.minOrderQty },
+            true
+          )
+        );
+        continue;
+      }
+      const tpPriceNorm = normalizePrice(
+        tp.price,
+        isLong ? "TP_LONG" : "TP_SHORT",
+        meta
+      );
+      const isFullMode = takeProfits.length === 1 && tp.rate === 1;
+      const tpRes = await client.setTradingStop({
+        category: MARKET_CATEGORY2,
+        symbol,
+        tpSize: isFullMode ? void 0 : tpSizeStr,
+        tpslMode: isFullMode ? "Full" : "Partial",
+        takeProfit: tpPriceNorm.priceStr,
+        tpTriggerBy: "MarkPrice",
+        tpOrderType: "Market",
+        positionIdx: 0
+      });
+      if (isTradingStopNotModified(tpRes)) {
+        logger2.log(
+          "debug",
+          "tp unchanged: %s %s price=%s rate=%s",
+          symbol,
+          direction,
+          tpPriceNorm.priceStr,
+          tp.rate
+        );
+      } else if (tpRes.retCode === 0) {
+        logger2.log(
+          "info",
+          "tp updated: %s %s price=%s rate=%s",
+          symbol,
+          direction,
+          tpPriceNorm.priceStr,
+          tp.rate
+        );
+      } else {
+        logger2.log(
+          "error",
+          "tp failed: %s %s price=%s rate=%s %s",
+          symbol,
+          direction,
+          tpPriceNorm.priceStr,
+          tp.rate,
+          toJson(tpRes, true)
+        );
+      }
+      if (!isTradingStopAccepted(tpRes)) {
+        return false;
+      }
+    }
+    return true;
+  };
+  const setStopLoss = async ({
+    symbol,
+    direction,
+    stopLossPrice
+  }) => {
+    const client = await getPrivateClient();
+    const marketDataClient = await getPublicClient();
+    if (!client || !marketDataClient) {
+      return false;
+    }
+    if (typeof stopLossPrice !== "number" || !Number.isFinite(stopLossPrice)) {
+      return true;
+    }
+    const meta = await getSymbolMeta(marketDataClient, symbol);
+    const isLong = direction === "LONG";
+    const slNormalized = normalizePrice(
+      stopLossPrice,
+      isLong ? "SL_LONG" : "SL_SHORT",
+      meta
+    );
+    const slRes = await client.setTradingStop({
+      category: MARKET_CATEGORY2,
+      symbol,
+      tpslMode: "Full",
+      stopLoss: slNormalized.priceStr,
+      slTriggerBy: "LastPrice",
+      positionIdx: 0
+    });
+    if (isTradingStopNotModified(slRes)) {
+      logger2.log(
+        "debug",
+        "sl unchanged: %s %s stopLoss=%s",
+        symbol,
+        direction,
+        slNormalized.priceStr
+      );
+    } else if (slRes.retCode === 0) {
+      logger2.log(
+        "info",
+        "sl updated: %s %s stopLoss=%s",
+        symbol,
+        direction,
+        slNormalized.priceStr
+      );
+    } else {
+      logger2.log(
+        "error",
+        "sl failed: %s %s stopLoss=%s %s",
+        symbol,
+        direction,
+        slNormalized.priceStr,
+        toJson(slRes, true)
+      );
+    }
+    return isTradingStopAccepted(slRes);
+  };
   return {
     getState: async () => state,
     setState: async (newState) => {
@@ -300,7 +545,8 @@ var ByBitConnectorCreator = async (config) => {
       start: defaultStart,
       end: defaultEnd,
       silent = false,
-      cacheOnly = false
+      cacheOnly = false,
+      warmOnly = false
     }) => {
       const intMinutes = intervalToMinutes(interval);
       if (!intMinutes) {
@@ -376,6 +622,16 @@ var ByBitConnectorCreator = async (config) => {
         if (!cacheOnly && isRightEdgeQuery) {
           await refreshTail({ symbol, interval, silent });
         }
+        if (warmOnly) {
+          if (isTimescaleFallbackMode) {
+            isTimescaleFallbackMode = false;
+            logger2.log(
+              "info",
+              "TimescaleDB connection restored for kline cache"
+            );
+          }
+          return [];
+        }
         const rangeStart = defaultStart ?? dataStart ?? 0;
         const rangeEnd = defaultEnd ?? dataEnd ?? Date.now();
         const { normStart: finalStart, normEnd: finalEnd } = normalizeRangeToClosed(intervalMs, rangeStart, rangeEnd);
@@ -401,7 +657,7 @@ var ByBitConnectorCreator = async (config) => {
             String(error)
           );
         }
-        if (cacheOnly) {
+        if (cacheOnly || warmOnly) {
           return [];
         }
         return request({
@@ -413,41 +669,9 @@ var ByBitConnectorCreator = async (config) => {
         });
       }
     },
-    getPosition: async (symbol) => {
-      const client = await getClient(config);
-      if (!client) {
-        return null;
-      }
-      const positionRes = await client.getPositionInfo({
-        symbol,
-        category: MARKET_CATEGORY2
-      });
-      logger2.log(
-        getLogLevel(positionRes),
-        "position retCode: %s, %s",
-        symbol,
-        positionRes.retCode
-      );
-      if (positionRes.retCode !== 0) {
-        return null;
-      }
-      const positions = mapPositionData(positionRes.result.list);
-      if (!positions || _.isEmpty(positions)) {
-        return null;
-      }
-      const position = positions[0];
-      logger2.log(
-        getLogLevel(positionRes),
-        "position: %s, %s",
-        symbol,
-        toJson(positionRes, true)
-      );
-      return {
-        ...position
-      };
-    },
+    getPosition: async (symbol) => getPositionSnapshot(symbol),
     getPositions: async () => {
-      const client = await getClient(config);
+      const client = await getPrivateClient();
       if (!client) {
         return [];
       }
@@ -455,12 +679,12 @@ var ByBitConnectorCreator = async (config) => {
         category: MARKET_CATEGORY2,
         settleCoin: "USDT"
       });
-      logger2.log(
-        getLogLevel(positionRes),
-        "positions retCode: %s, %s",
-        positionRes.retCode
-      );
       if (positionRes.retCode !== 0) {
+        logger2.log(
+          getLogLevel(positionRes),
+          "positions retCode: %s, %s",
+          positionRes.retCode
+        );
         return [];
       }
       const positions = mapPositionData(positionRes.result.list);
@@ -469,13 +693,14 @@ var ByBitConnectorCreator = async (config) => {
       }
       return positions;
     },
-    placeOrder: async ({ symbol, price, qty, direction, isLimit }, TP = [], slPrice) => {
-      const client = await getClient(config);
-      if (!client) {
+    placeOrder: async ({ symbol, price, qty, direction, isLimit }) => {
+      const client = await getPrivateClient();
+      const marketDataClient = await getPublicClient();
+      if (!client || !marketDataClient) {
         return false;
       }
       const isLong = direction === "LONG";
-      const meta = await getSymbolMeta(client, symbol);
+      const meta = await getSymbolMeta(marketDataClient, symbol);
       const { qtyNum: orderQty, qtyStr: orderQtyStr } = normalizeQty(qty, meta);
       if (orderQty < meta.minOrderQty) {
         logger2.log(
@@ -489,9 +714,6 @@ var ByBitConnectorCreator = async (config) => {
         return false;
       }
       const entryNormalized = isLimit ? normalizePrice(price, "ENTRY", meta) : void 0;
-      const slNormalized = slPrice ? normalizePrice(slPrice, isLong ? "SL_LONG" : "SL_SHORT", meta) : void 0;
-      const firstTP = TP?.[0];
-      const tpNormalized = firstTP && firstTP.rate === 1 ? normalizePrice(firstTP.price, isLong ? "TP_LONG" : "TP_SHORT", meta) : void 0;
       logger2.log(
         "info",
         "placeOrder: %s",
@@ -502,10 +724,7 @@ var ByBitConnectorCreator = async (config) => {
             qty,
             direction,
             orderQty,
-            orderQtyStr,
-            slPrice,
-            slPriceNorm: slNormalized?.priceStr,
-            TP
+            orderQtyStr
           },
           true
         )
@@ -520,10 +739,6 @@ var ByBitConnectorCreator = async (config) => {
         category: MARKET_CATEGORY2,
         symbol,
         price: entryNormalized?.priceStr || void 0,
-        takeProfit: tpNormalized?.priceStr || void 0,
-        tpTriggerBy: "MarkPrice",
-        stopLoss: slNormalized?.priceStr || void 0,
-        slTriggerBy: "LastPrice",
         side: isLong ? "Buy" : "Sell",
         orderType: isLimit ? "Limit" : "Market",
         qty: orderQtyStr,
@@ -537,53 +752,12 @@ var ByBitConnectorCreator = async (config) => {
       if (orderRes.retCode !== 0) {
         return false;
       }
-      if (!isLimit) {
-        for (const tp of TP) {
-          const tpSizeRaw = orderQty * tp.rate;
-          const { qtyNum: tpSizeNum, qtyStr: tpSizeStr } = normalizeQty(
-            tpSizeRaw,
-            meta
-          );
-          if (!tpSizeNum || tpSizeNum < meta.minOrderQty) {
-            logger2.log(
-              "warn",
-              "tp skipped: size too small %s",
-              toJson(
-                { symbol, tp, tpSizeNum, minOrderQty: meta.minOrderQty },
-                true
-              )
-            );
-            continue;
-          }
-          const tpPriceNorm = normalizePrice(
-            tp.price,
-            isLong ? "TP_LONG" : "TP_SHORT",
-            meta
-          );
-          const isFullMode = TP.length === 1 && tp.rate === 1;
-          const tpRes = await client.setTradingStop({
-            category: MARKET_CATEGORY2,
-            symbol,
-            tpSize: isFullMode ? void 0 : tpSizeStr,
-            tpslMode: isFullMode ? "Full" : "Partial",
-            takeProfit: tpPriceNorm.priceStr,
-            stopLoss: isFullMode && slNormalized ? slNormalized.priceStr : void 0,
-            slTriggerBy: "LastPrice",
-            tpOrderType: "Market",
-            positionIdx: 0
-          });
-          logger2.log(
-            getLogLevel(tpRes),
-            "tp: %s %s",
-            toJson(tp, true),
-            toJson(tpRes, true)
-          );
-        }
-      }
       return true;
     },
+    setTakeProfits,
+    setStopLoss,
     closePosition: async ({ symbol, direction }) => {
-      const client = await getClient(config);
+      const client = await getPrivateClient();
       if (!client) {
         return false;
       }
@@ -608,7 +782,7 @@ var ByBitConnectorCreator = async (config) => {
       return true;
     },
     getTickers: async () => {
-      const client = await getClient(config);
+      const client = await getPublicClient();
       if (!client) {
         return [];
       }
@@ -709,6 +883,8 @@ var BinanceConnectorCreator = async () => {
     getPosition: async () => null,
     getPositions: async () => [],
     placeOrder: async () => false,
+    setTakeProfits: async () => false,
+    setStopLoss: async () => false,
     closePosition: async () => false,
     getTickers: async () => {
       const baseUrl = process.env.BINANCE_BASE_URL?.trim() || "https://api.binance.com";
@@ -868,6 +1044,8 @@ var CoinbaseConnectorCreator = async () => {
     getPosition: async () => null,
     getPositions: async () => [],
     placeOrder: async () => false,
+    setTakeProfits: async () => false,
+    setStopLoss: async () => false,
     closePosition: async () => false,
     getTickers: async () => {
       const baseUrl = process.env.COINBASE_BASE_URL?.trim() || "https://api.exchange.coinbase.com";
@@ -1083,7 +1261,7 @@ var binanceCoinbaseSpreadProvider = {
 };
 
 // src/marketData/providers/coinalyze.ts
-import { delay } from "@tradejs/core/async";
+import { delay as delay2 } from "@tradejs/core/async";
 import {
   coinalyzePointsToRows,
   mergeCoinalyzeMetrics
@@ -1137,12 +1315,8 @@ var normalizeMetricPayload = (metric, raw) => {
   }));
 };
 var fetchCoinalyzeSeries = async (params) => {
-  const { endpoint, metric, symbol, interval, fromMs, toMs } = params;
+  const { endpoint, metric, symbol, apiKey, interval, fromMs, toMs } = params;
   const baseUrl = process.env.COINALYZE_BASE_URL?.trim() || "https://api.coinalyze.net/v1";
-  const apiKey = process.env.COINALYZE_API_KEY?.trim();
-  if (!apiKey) {
-    throw new Error("Missing COINALYZE_API_KEY");
-  }
   const url = new URL(`${baseUrl}${endpoint}`);
   url.searchParams.set("symbols", symbol);
   url.searchParams.set("interval", coinalyzeIntervalMap[interval] || interval);
@@ -1160,7 +1334,7 @@ var fetchCoinalyzeSeries = async (params) => {
       lastRequestTs + coinalyzeMinRequestDelayMs - now
     );
     if (waitMs > 0) {
-      await delay(waitMs);
+      await delay2(waitMs);
     }
     lastRequestTs = Date.now();
     const response = await fetch(url.toString(), { headers });
@@ -1174,7 +1348,7 @@ var fetchCoinalyzeSeries = async (params) => {
     const transient = response.status === 429 || response.status >= 500;
     if (attempt < coinalyzeMaxRetries && transient) {
       const backoffMs = Math.min(1e4, 750 * 2 ** attempt);
-      await delay(retryAfterMs ?? backoffMs);
+      await delay2(retryAfterMs ?? backoffMs);
       continue;
     }
     throw new Error(`Coinalyze ${endpoint} ${response.status}: ${text}`);
@@ -1183,15 +1357,27 @@ var fetchCoinalyzeSeries = async (params) => {
 };
 var coinalyzeProvider = {
   name: "coinalyze",
-  fetchWindow: async ({ symbol, marketSymbol, interval, fromMs, toMs }) => {
+  fetchWindow: async ({
+    symbol,
+    marketSymbol,
+    apiKey,
+    interval,
+    fromMs,
+    toMs
+  }) => {
+    if (!apiKey?.trim()) {
+      throw new Error("Missing COINALYZE_API_KEY in user settings");
+    }
     const oiPath = process.env.COINALYZE_OI_PATH?.trim() || "/open-interest-history";
     const fundingPath = process.env.COINALYZE_FUNDING_PATH?.trim() || "/funding-rate-history";
     const liqPath = process.env.COINALYZE_LIQ_PATH?.trim() || "/liquidation-history";
     const requestSymbol = (marketSymbol || symbol).trim().toUpperCase();
+    const normalizedApiKey = apiKey.trim();
     const oiRaw = await fetchCoinalyzeSeries({
       endpoint: oiPath,
       metric: "oi",
       symbol: requestSymbol,
+      apiKey: normalizedApiKey,
       interval,
       fromMs,
       toMs
@@ -1200,6 +1386,7 @@ var coinalyzeProvider = {
       endpoint: fundingPath,
       metric: "funding",
       symbol: requestSymbol,
+      apiKey: normalizedApiKey,
       interval,
       fromMs,
       toMs
@@ -1208,6 +1395,7 @@ var coinalyzeProvider = {
       endpoint: liqPath,
       metric: "liq",
       symbol: requestSymbol,
+      apiKey: normalizedApiKey,
       interval,
       fromMs,
       toMs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tradejs/connectors",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "Built-in exchange connectors and market data providers for the TradeJS open-source framework.",
   "keywords": [
     "tradejs",
@@ -33,10 +33,10 @@
     }
   },
   "dependencies": {
-    "@tradejs/core": "^1.0.5",
-    "@tradejs/infra": "^1.0.5",
-    "@tradejs/node": "^1.0.5",
-    "@tradejs/types": "^1.0.5",
+    "@tradejs/core": "^1.0.6",
+    "@tradejs/infra": "^1.0.6",
+    "@tradejs/node": "^1.0.6",
+    "@tradejs/types": "^1.0.6",
     "bybit-api": "^3.9.0",
     "chalk": "4.1.2",
     "lodash": "^4.17.21"