@blackcube/xgate-sdk 0.21.1 → 0.23.0

package/dist/index.cjs

@@ -21,135 +21,12 @@ var __decorateClass = (decorators, target, key, kind) => {
   return result;
 };
 
-// src/enums/timeframe.enums.ts
-var Timeframe = /* @__PURE__ */ ((Timeframe2) => {
-  Timeframe2["M1"] = "1m";
-  Timeframe2["M5"] = "5m";
-  Timeframe2["M15"] = "15m";
-  Timeframe2["H1"] = "1h";
-  Timeframe2["H4"] = "4h";
-  Timeframe2["D"] = "1d";
-  Timeframe2["W"] = "1w";
-  return Timeframe2;
-})(Timeframe || {});
-var TIMEFRAME_MINUTES = {
-  ["1m" /* M1 */]: 1,
-  ["5m" /* M5 */]: 5,
-  ["15m" /* M15 */]: 15,
-  ["1h" /* H1 */]: 60,
-  ["4h" /* H4 */]: 240,
-  ["1d" /* D */]: 1440,
-  ["1w" /* W */]: 10080
-};
-function timeframeMs(timeframe) {
-  return TIMEFRAME_MINUTES[timeframe] * 6e4;
-}
-
-// src/helpers/decimal.ts
-function parse(value) {
-  const trimmed = value.trim();
-  if (/^-?\d+(\.\d+)?$/.test(trimmed) === false) {
-    throw new Error(`D\xE9cimal illisible : "${value}".`);
-  }
-  const dot = trimmed.indexOf(".");
-  if (dot < 0) {
-    return { digits: BigInt(trimmed), scale: 0 };
-  }
-  return {
-    digits: BigInt(trimmed.slice(0, dot) + trimmed.slice(dot + 1)),
-    scale: trimmed.length - dot - 1
-  };
-}
-function format(digits, scale) {
-  const negative = digits < 0n;
-  const plain = (negative === true ? -digits : digits).toString().padStart(scale + 1, "0");
-  const sign = negative === true ? "-" : "";
-  if (scale === 0) {
-    return sign + plain;
-  }
-  const whole = plain.slice(0, plain.length - scale);
-  const fraction = plain.slice(plain.length - scale).replace(/0+$/, "");
-  return fraction === "" ? sign + whole : `${sign + whole}.${fraction}`;
-}
-function addDecimals(left, right) {
-  const a = parse(left);
-  const b = parse(right);
-  const scale = Math.max(a.scale, b.scale);
-  const digits = a.digits * 10n ** BigInt(scale - a.scale) + b.digits * 10n ** BigInt(scale - b.scale);
-  return format(digits, scale);
-}
-function compareDecimals(left, right) {
-  const a = parse(left);
-  const b = parse(right);
-  const scale = Math.max(a.scale, b.scale);
-  const x = a.digits * 10n ** BigInt(scale - a.scale);
-  const y = b.digits * 10n ** BigInt(scale - b.scale);
-  if (x === y) {
-    return 0;
-  }
-  return x > y ? 1 : -1;
-}
-
-// src/helpers/candle-aggregator.ts
-var MONDAY_OFFSET_MS = 4 * 24 * 60 * 60 * 1e3;
-function aggregate(source, target, now = Date.now()) {
-  if (source.length === 0) {
-    return [];
-  }
-  const sourceMs = timeframeMs(source[0]?.interval ?? "1m" /* M1 */);
-  const targetMs = timeframeMs(target);
-  if (targetMs <= sourceMs) {
-    return [];
-  }
-  const offsetMs = target === "1w" /* W */ ? MONDAY_OFFSET_MS : 0;
-  const expected = targetMs / sourceMs;
-  const buckets = /* @__PURE__ */ new Map();
-  const sorted = [...source].sort(
-    (left, right) => left.openedAt.getTime() - right.openedAt.getTime()
-  );
-  for (const candle of sorted) {
-    const start = Math.floor((candle.openedAt.getTime() - offsetMs) / targetMs) * targetMs + offsetMs;
-    const bucket = buckets.get(start);
-    if (bucket === void 0) {
-      buckets.set(start, {
-        sources: 1,
-        candle: {
-          ...candle,
-          interval: target,
-          openedAt: new Date(start),
-          // Dernière milliseconde du créneau, comme les bougies servies par les venues.
-          closedAt: new Date(start + targetMs - 1),
-          derived: true
-        }
-      });
-    } else {
-      bucket.sources += 1;
-      const built = bucket.candle;
-      built.high = compareDecimals(candle.high, built.high) > 0 ? candle.high : built.high;
-      built.low = compareDecimals(candle.low, built.low) < 0 ? candle.low : built.low;
-      built.close = candle.close;
-      built.volume = sum(built.volume, candle.volume);
-      built.quoteVolume = sum(built.quoteVolume, candle.quoteVolume);
-      built.takerBuyQuoteVolume = sum(built.takerBuyQuoteVolume, candle.takerBuyQuoteVolume);
-      built.trades = built.trades === null || candle.trades === null ? null : built.trades + candle.trades;
-    }
-  }
-  return [...buckets.keys()].sort((left, right) => left - right).map((start) => buckets.get(start)).filter((bucket) => bucket !== void 0).filter((bucket) => {
-    const stillOpen = bucket.candle.openedAt.getTime() + targetMs > now;
-    return bucket.sources >= expected || stillOpen === true;
-  }).map((bucket) => bucket.candle);
-}
-function sum(left, right) {
-  if (left === null || right === null) {
-    return null;
-  }
-  return addDecimals(left, right);
-}
-
 // src/helpers/symbol-naming.ts
 var CONCAT_QUOTE_XEXS = /* @__PURE__ */ new Set(["aster", "binance", "bybit"]);
 var K_MULTIPLIER = /^k(?=[A-Z])/u;
 var NUMERIC_MULTIPLIER = /^10{3,}(?=[A-Z0-9])/u;
+var ABBREV_MULTIPLIER = /^1([MK])(?=[A-Z]{2,})/u;
+var ABBREV_FACTOR = { M: 1e6, K: 1e3 };
 var STOCK_24_5 = /_24_5$/u;
 var TICKER_ALIASES = {
   GOOG: "GOOGL",
@@ -174,13 +51,26 @@ function canonicalFromXex(rawSymbol, xexId) {
     s = s.replace(/-USD-PERP$/u, "").replace(/-PERP$/u, "").replace(/-USDT$/u, "").replace(/-USDC$/u, "").replace(/-USD$/u, "");
   }
   s = s.replace(NUMERIC_MULTIPLIER, "");
+  s = s.replace(ABBREV_MULTIPLIER, "");
   s = s.replace(STOCK_24_5, "");
   return TICKER_ALIASES[s] ?? s;
 }
 function canonicalFromBase(base) {
-  const s = base.replace(K_MULTIPLIER, "").toUpperCase().replace(NUMERIC_MULTIPLIER, "").replace(STOCK_24_5, "");
+  const s = base.replace(K_MULTIPLIER, "").toUpperCase().replace(NUMERIC_MULTIPLIER, "").replace(ABBREV_MULTIPLIER, "").replace(STOCK_24_5, "");
   return TICKER_ALIASES[s] ?? s;
 }
+function multiplierFromXex(rawSymbol) {
+  if (K_MULTIPLIER.test(rawSymbol)) {
+    return 1e3;
+  }
+  const upper = rawSymbol.toUpperCase();
+  const abbrev = ABBREV_MULTIPLIER.exec(upper);
+  if (abbrev !== null) {
+    return ABBREV_FACTOR[abbrev[1]] ?? 1;
+  }
+  const zeros = NUMERIC_MULTIPLIER.exec(upper);
+  return zeros === null ? 1 : Number(zeros[0]);
+}
 
 // src/helpers/candle-mapper.ts
 function toCandle(wire, xex, interval, quote) {
@@ -206,15 +96,13 @@ function toCandle(wire, xex, interval, quote) {
   };
 }
 
-// src/helpers/candle-query.ts
-function toXexQuery(query) {
-  return {
-    name: query.symbol,
-    interval: query.interval,
-    startTime: query.startTime,
-    endTime: query.endTime,
-    limit: query.limit
-  };
+// src/helpers/ws-limits.ts
+var WS_SUBSCRIPTION_LIMITS = {
+  aster: 200,
+  hyperliquid: 1e3
+};
+function subscriptionLimitOf(xex) {
+  return WS_SUBSCRIPTION_LIMITS[xex];
 }
 
 // src/enums/xgate-ex.enums.ts
@@ -265,6 +153,19 @@ function createAccountXex(xex, access) {
         },
         { default: "a" }
       );
+    case "lighter" /* Lighter */:
+      return new lighterSdk.Lighter(
+        {
+          a: {
+            apiPrivateKey: access.privateKey ?? NULL_KEY,
+            apiKeyIndex: access.apiKeyIndex ?? 0,
+            accountIndex: access.accountIndex ?? 0,
+            l1Address: adresse(),
+            network: access.network ?? "mainnet"
+          }
+        },
+        { default: "a" }
+      );
     case "aster" /* Aster */:
       if (access.privateKey === void 0 || access.privateKey === "") {
         throw new Error(
@@ -305,6 +206,7 @@ var WALLET_XEXES = [
   "hyperliquid" /* Hyperliquid */,
   "pacifica" /* Pacifica */,
   "aster" /* Aster */,
+  "lighter" /* Lighter */,
   "blofin" /* Blofin */
 ];
 function createPublicXex(xex) {
@@ -348,9 +250,288 @@ function createPublicSpotXex(xex) {
   }
 }
 
+// src/services/candles-stream.service.ts
+var CandlesStreamService = class {
+  constructor(xex, kind = "perp") {
+    this.xex = xex;
+    this.kind = kind;
+    this.logger = new common.Logger(`CandlesStream:${xex}${kind === "spot" ? ":spot" : ""}`);
+    this.maxSubscriptions = subscriptionLimitOf(xex) ?? null;
+  }
+  xex;
+  kind;
+  logger;
+  source = null;
+  unsubscribes = [];
+  /** Le plafond de souscriptions documenté par la venue, ou `null` si personne ne l'a publié. */
+  maxSubscriptions;
+  /**
+   * Ouvre le flux sur une LISTE de marchés, sur une seule socket.
+   *
+   * **UNE ERREUR DE FLUX COUPE TOUT, PUIS LÈVE.** Elle n'arrive pas à la souscription : mesuré le
+   * 2026-08-07, la venue accepte un symbole inconnu sans broncher, puis ferme la connexion en le
+   * découvrant. Le SDK reconnecte, elle referme — cinq cycles en douze secondes, et sur une socket
+   * partagée **tous** les marchés valides cessent de recevoir, en silence.
+   *
+   * On refuse cette boucle : à la première erreur, les souscriptions sont coupées, l'incident est
+   * journalisé en `error`, et l'exception part. Un flux à moitié mort qui se tait coûte plus cher
+   * qu'un arrêt franc — on ne découvre le premier qu'en constatant l'absence de données.
+   *
+   * ⚠️ L'exception naît dans un rappel de socket : elle ne remonte pas à l'appelant de `start()`,
+   * elle sort en erreur non capturée. C'est délibéré — elle doit être impossible à ignorer.
+   *
+   * **binance et bybit ne remontent pas encore leurs erreurs** : leur client gère la fermeture en
+   * interne sans l'exposer. Sur ces deux venues, la boucle silencieuse reste possible.
+   */
+  start(symbolsXex, interval, onCandle) {
+    const ws = this.wire();
+    if ("onError" in ws) {
+      ws.onError = (error) => {
+        const raison = lisible(error);
+        this.logger.error(`${this.xex} : erreur de flux \u2014 ${raison}. Souscriptions coup\xE9es.`);
+        this.stop();
+        throw new Error(`stream(${this.xex}) : flux interrompu \u2014 ${raison}`);
+      };
+    }
+    for (const symbolXex of symbolsXex) {
+      this.unsubscribes.push(
+        ws.subscribeCandles({ name: symbolXex, interval }, (wire) => {
+          onCandle(toCandle(wire, this.xex, interval, this.quoteOf(symbolXex)));
+        })
+      );
+    }
+    this.logger.log(`${this.unsubscribes.length}/${symbolsXex.length} souscription(s) ouvertes`);
+  }
+  /** Coupe tout. Un désabonnement qui échoue ne doit pas empêcher les autres de se fermer. */
+  stop() {
+    for (const unsubscribe of this.unsubscribes.splice(0)) {
+      try {
+        unsubscribe();
+      } catch {
+      }
+    }
+  }
+  /** Le nombre de souscriptions ouvertes. La liste des désabonnements EST le compteur. */
+  subscriptionCount() {
+    return this.unsubscribes.length;
+  }
+  /**
+   * Le client temps réel, sur le bon marché.
+   *
+   * Les deux contrats ne signent pas `ws()` pareil, et c'est voulu : côté comptant le marché est
+   * **obligatoire** (`ws('spot')`), parce que les façades ouvrent du perpétuel par défaut — un
+   * `ws()` nu y diffuserait des prix de perpétuel à qui croit écouter le comptant.
+   */
+  wire() {
+    const source = this.instance();
+    return this.kind === "spot" ? source.ws("spot") : source.ws();
+  }
+  /** La façade de la venue, créée une seule fois : c'est elle qui porte la socket partagée. */
+  instance() {
+    if (this.source === null) {
+      if (this.kind === "spot" && servesSpot(this.xex) === false) {
+        throw new Error(`stream(${this.xex}) : cette venue ne sert pas de comptant.`);
+      }
+      this.source = this.kind === "spot" ? createPublicSpotXex(this.xex) : createPublicXex(this.xex);
+    }
+    return this.source;
+  }
+  /** Voir `CandlesService.quoteOf` : la cotation se déduit du symbole natif, faute d'être publiée. */
+  quoteOf(symbolXex) {
+    const parts = symbolXex.split("-");
+    const last = parts[parts.length - 1];
+    return parts.length > 1 && last !== void 0 ? last : "";
+  }
+};
+exports.CandlesStreamRegistry = class CandlesStreamRegistry {
+  streams = /* @__PURE__ */ new Map();
+  /** Le flux d'une venue, créé au premier appel puis réutilisé. */
+  of(xex, kind = "perp") {
+    const cle = `${xex}:${kind}`;
+    let stream = this.streams.get(cle);
+    if (stream === void 0) {
+      stream = new CandlesStreamService(xex, kind);
+      this.streams.set(cle, stream);
+    }
+    return stream;
+  }
+  /** Coupe tous les flux ouverts, toutes venues confondues. */
+  stopAll() {
+    for (const stream of this.streams.values()) {
+      stream.stop();
+    }
+  }
+  /** Ce qui est ouvert, par venue — pour surveiller sans avoir à tenir de compteur soi-même. */
+  counts() {
+    const total = {};
+    for (const [cle, stream] of this.streams) {
+      total[cle] = stream.subscriptionCount();
+    }
+    return total;
+  }
+};
+exports.CandlesStreamRegistry = __decorateClass([
+  common.Injectable()
+], exports.CandlesStreamRegistry);
+function lisible(error) {
+  if (error instanceof Error) {
+    return error.message;
+  }
+  const event = error;
+  if (event !== null && typeof event === "object") {
+    const message = event.message ?? event.error?.message;
+    if (typeof message === "string" && message !== "") {
+      return message;
+    }
+    if (typeof event.type === "string" && event.type !== "") {
+      return `\xE9v\xE9nement \xAB ${event.type} \xBB`;
+    }
+  }
+  return String(error);
+}
+
+// src/enums/timeframe.enums.ts
+var Timeframe = /* @__PURE__ */ ((Timeframe2) => {
+  Timeframe2["M1"] = "1m";
+  Timeframe2["M5"] = "5m";
+  Timeframe2["M15"] = "15m";
+  Timeframe2["H1"] = "1h";
+  Timeframe2["H4"] = "4h";
+  Timeframe2["D"] = "1d";
+  Timeframe2["W"] = "1w";
+  return Timeframe2;
+})(Timeframe || {});
+var TIMEFRAME_MINUTES = {
+  ["1m" /* M1 */]: 1,
+  ["5m" /* M5 */]: 5,
+  ["15m" /* M15 */]: 15,
+  ["1h" /* H1 */]: 60,
+  ["4h" /* H4 */]: 240,
+  ["1d" /* D */]: 1440,
+  ["1w" /* W */]: 10080
+};
+function timeframeMs(timeframe) {
+  return TIMEFRAME_MINUTES[timeframe] * 6e4;
+}
+
+// src/helpers/decimal.ts
+function parse(value) {
+  const trimmed = value.trim();
+  if (/^-?\d+(\.\d+)?$/.test(trimmed) === false) {
+    throw new Error(`D\xE9cimal illisible : "${value}".`);
+  }
+  const dot = trimmed.indexOf(".");
+  if (dot < 0) {
+    return { digits: BigInt(trimmed), scale: 0 };
+  }
+  return {
+    digits: BigInt(trimmed.slice(0, dot) + trimmed.slice(dot + 1)),
+    scale: trimmed.length - dot - 1
+  };
+}
+function format(digits, scale) {
+  const negative = digits < 0n;
+  const plain = (negative === true ? -digits : digits).toString().padStart(scale + 1, "0");
+  const sign = negative === true ? "-" : "";
+  if (scale === 0) {
+    return sign + plain;
+  }
+  const whole = plain.slice(0, plain.length - scale);
+  const fraction = plain.slice(plain.length - scale).replace(/0+$/, "");
+  return fraction === "" ? sign + whole : `${sign + whole}.${fraction}`;
+}
+function addDecimals(left, right) {
+  const a = parse(left);
+  const b = parse(right);
+  const scale = Math.max(a.scale, b.scale);
+  const digits = a.digits * 10n ** BigInt(scale - a.scale) + b.digits * 10n ** BigInt(scale - b.scale);
+  return format(digits, scale);
+}
+function compareDecimals(left, right) {
+  const a = parse(left);
+  const b = parse(right);
+  const scale = Math.max(a.scale, b.scale);
+  const x = a.digits * 10n ** BigInt(scale - a.scale);
+  const y = b.digits * 10n ** BigInt(scale - b.scale);
+  if (x === y) {
+    return 0;
+  }
+  return x > y ? 1 : -1;
+}
+
+// src/helpers/candle-aggregator.ts
+var MONDAY_OFFSET_MS = 4 * 24 * 60 * 60 * 1e3;
+function aggregate(source, target, now = Date.now()) {
+  if (source.length === 0) {
+    return [];
+  }
+  const sourceMs = timeframeMs(source[0]?.interval ?? "1m" /* M1 */);
+  const targetMs = timeframeMs(target);
+  if (targetMs <= sourceMs) {
+    return [];
+  }
+  const offsetMs = target === "1w" /* W */ ? MONDAY_OFFSET_MS : 0;
+  const expected = targetMs / sourceMs;
+  const buckets = /* @__PURE__ */ new Map();
+  const sorted = [...source].sort(
+    (left, right) => left.openedAt.getTime() - right.openedAt.getTime()
+  );
+  for (const candle of sorted) {
+    const start = Math.floor((candle.openedAt.getTime() - offsetMs) / targetMs) * targetMs + offsetMs;
+    const bucket = buckets.get(start);
+    if (bucket === void 0) {
+      buckets.set(start, {
+        sources: 1,
+        candle: {
+          ...candle,
+          interval: target,
+          openedAt: new Date(start),
+          // Dernière milliseconde du créneau, comme les bougies servies par les venues.
+          closedAt: new Date(start + targetMs - 1),
+          derived: true
+        }
+      });
+    } else {
+      bucket.sources += 1;
+      const built = bucket.candle;
+      built.high = compareDecimals(candle.high, built.high) > 0 ? candle.high : built.high;
+      built.low = compareDecimals(candle.low, built.low) < 0 ? candle.low : built.low;
+      built.close = candle.close;
+      built.volume = sum(built.volume, candle.volume);
+      built.quoteVolume = sum(built.quoteVolume, candle.quoteVolume);
+      built.takerBuyQuoteVolume = sum(built.takerBuyQuoteVolume, candle.takerBuyQuoteVolume);
+      built.trades = built.trades === null || candle.trades === null ? null : built.trades + candle.trades;
+    }
+  }
+  return [...buckets.keys()].sort((left, right) => left - right).map((start) => buckets.get(start)).filter((bucket) => bucket !== void 0).filter((bucket) => {
+    const stillOpen = bucket.candle.openedAt.getTime() + targetMs > now;
+    return bucket.sources >= expected || stillOpen === true;
+  }).map((bucket) => bucket.candle);
+}
+function sum(left, right) {
+  if (left === null || right === null) {
+    return null;
+  }
+  return addDecimals(left, right);
+}
+
+// src/helpers/candle-query.ts
+function toXexQuery(query) {
+  return {
+    name: query.symbol,
+    interval: query.interval,
+    startTime: query.startTime,
+    endTime: query.endTime,
+    limit: query.limit
+  };
+}
+
 // src/helpers/xex-timeframes.ts
+var HYPERLIQUID_NATIVE = Object.values(Timeframe).filter(
+  (interval) => interval !== "1w" /* W */
+);
 var NATIVE = {
-  ["hyperliquid" /* Hyperliquid */]: Object.values(Timeframe),
+  ["hyperliquid" /* Hyperliquid */]: HYPERLIQUID_NATIVE,
   ["pacifica" /* Pacifica */]: Object.values(Timeframe),
   ["aster" /* Aster */]: Object.values(Timeframe),
   ["blofin" /* Blofin */]: Object.values(Timeframe),
@@ -478,6 +659,43 @@ exports.CandlesService = class CandlesService {
 exports.CandlesService = __decorateClass([
   common.Injectable()
 ], exports.CandlesService);
+
+// src/helpers/contract-expiry.ts
+var DATED_CONTRACT_TYPES = /* @__PURE__ */ new Set([
+  // binance : les trimestriels (`BTCUSDT_260925`, `ETHUSDT_261225`).
+  "CURRENT_QUARTER",
+  "NEXT_QUARTER",
+  "CURRENT_QUARTER_DELIVERING",
+  "NEXT_QUARTER_DELIVERING",
+  "PERPETUAL_DELIVERING",
+  // bybit : les datés (`BTCUSDT-25DEC26`), face à `LinearPerpetual`.
+  "LinearFutures",
+  "InverseFutures"
+]);
+var EXPIRY_FIELDS = ["deliveryTime", "deliveryDate", "expiryTime", "settleTime"];
+function expiryOf(xtras) {
+  if (xtras === void 0) {
+    return void 0;
+  }
+  const type = xtras.contractType;
+  if (typeof type !== "string" || DATED_CONTRACT_TYPES.has(type) === false) {
+    return void 0;
+  }
+  for (const field of EXPIRY_FIELDS) {
+    const brut = xtras[field];
+    const ms = typeof brut === "string" ? Number(brut) : brut;
+    if (typeof ms === "number" && Number.isFinite(ms) === true && ms > 0) {
+      return new Date(ms);
+    }
+  }
+  return void 0;
+}
+function isDated(xtras) {
+  const type = xtras?.contractType;
+  return typeof type === "string" && DATED_CONTRACT_TYPES.has(type);
+}
+
+// src/services/catalog.service.ts
 var NAMES_ITS_BASE = /* @__PURE__ */ new Set(["binance" /* Binance */, "bybit" /* Bybit */]);
 exports.CatalogService = class CatalogService {
   logger = new common.Logger(exports.CatalogService.name);
@@ -523,6 +741,8 @@ exports.CatalogService = class CatalogService {
       symbolXex: pair.name,
       xex,
       kind: pair.kind,
+      multiplier: multiplierFromXex(pair.name),
+      expiresAt: expiryOf(pair.xtras),
       ref: pair.ref ?? null,
       szDecimals: pair.szDecimals,
       tickSize: pair.tickSize,
@@ -597,6 +817,65 @@ exports.PricesService = class PricesService {
 exports.PricesService = __decorateClass([
   common.Injectable()
 ], exports.PricesService);
+exports.SpotCandlesService = class SpotCandlesService {
+  logger = new common.Logger(exports.SpotCandlesService.name);
+  /** Les venues dont XGate sert le comptant. */
+  venues() {
+    return SPOT_XEXES;
+  }
+  /**
+   * Les bougies comptant d'une venue, sur une plage de **dates**.
+   *
+   * **Lève** si la venue ne sert pas de comptant, plutôt que de rendre une liste vide : « cette
+   * venue n'a pas de marché comptant » et « ce marché n'a pas coté » appellent des suites très
+   * différentes.
+   */
+  async candles(xex, query) {
+    if (servesSpot(xex) === false) {
+      throw new Error(
+        `spotCandles(${xex}) : cette venue ne sert pas de comptant. Disponibles : ${SPOT_XEXES.join(", ")}.`
+      );
+    }
+    const spot = createPublicSpotXex(xex).spot();
+    if (spot.getCandles === void 0) {
+      throw new Error(`spotCandles(${xex}) : cette venue ne sert pas de bougies comptant en REST.`);
+    }
+    const wires = await spot.getCandles(toXexQuery(query));
+    return wires.map((wire) => toCandle(wire, xex, query.interval, ""));
+  }
+  /**
+   * Les bougies comptant d'un même marché chez PLUSIEURS venues, en une liste.
+   *
+   * Même politique d'échec que partout ailleurs : seule, une venue en échec fait échouer l'appel ;
+   * parmi d'autres, elle est journalisée et ignorée. Chaque bougie porte son `xex`.
+   */
+  async candlesOf(xexes, query) {
+    if (xexes.length === 0) {
+      throw new Error("spotCandlesOf() : aucune venue demand\xE9e \u2014 pr\xE9cise au moins un XgateEx.");
+    }
+    const solo = xexes.length === 1;
+    const collected = await Promise.all(
+      xexes.map(async (xex) => {
+        try {
+          return await this.candles(xex, query);
+        } catch (error) {
+          if (solo === true) {
+            throw error;
+          }
+          const message = error instanceof Error ? error.message : String(error);
+          this.logger.error(
+            `spotCandles(${xex}, ${query.interval}) a \xE9chou\xE9, venue ignor\xE9e : ${message}`
+          );
+          return [];
+        }
+      })
+    );
+    return collected.flat();
+  }
+};
+exports.SpotCandlesService = __decorateClass([
+  common.Injectable()
+], exports.SpotCandlesService);
 exports.SpotCatalogService = class SpotCatalogService {
   logger = new common.Logger(exports.SpotCatalogService.name);
   /** Les venues dont XGate sert le comptant. */
@@ -648,6 +927,9 @@ exports.SpotCatalogService = class SpotCatalogService {
       symbolXex: pair.name,
       xex,
       kind: pair.kind,
+      // Le comptant porte les mêmes échelles que le perp : `SATSUSDT` (×1) et `1000SATSUSDT`
+      // coexistent, et c'est justement entre eux que la comparaison serait fausse.
+      multiplier: multiplierFromXex(pair.name),
       ref: pair.ref ?? null,
       szDecimals: pair.szDecimals,
       tickSize: pair.tickSize,
@@ -665,6 +947,133 @@ exports.SpotCatalogService = class SpotCatalogService {
 exports.SpotCatalogService = __decorateClass([
   common.Injectable()
 ], exports.SpotCatalogService);
+exports.SpotPricesService = class SpotPricesService {
+  logger = new common.Logger(exports.SpotPricesService.name);
+  /** Les venues dont XGate sert les prix comptant. */
+  venues() {
+    return SPOT_XEXES;
+  }
+  /**
+   * Les prix comptant d'une ou plusieurs venues, en une seule liste.
+   *
+   * Même politique d'échec que partout : seule, une venue en échec fait échouer l'appel ; parmi
+   * d'autres, elle est journalisée et ignorée. Chaque prix porte son `xex`.
+   */
+  async prices(...xexes) {
+    if (xexes.length === 0) {
+      throw new Error("spot prices() : aucune venue demand\xE9e \u2014 pr\xE9cise au moins un XgateEx.");
+    }
+    const solo = xexes.length === 1;
+    const collected = await Promise.all(
+      xexes.map(async (xex) => {
+        try {
+          return await this.pricesOf(xex);
+        } catch (error) {
+          if (solo === true) {
+            throw error;
+          }
+          const message = error instanceof Error ? error.message : String(error);
+          this.logger.error(`spot prices(${xex}) a \xE9chou\xE9, venue ignor\xE9e : ${message}`);
+          return [];
+        }
+      })
+    );
+    return collected.flat();
+  }
+  /** Les prix comptant d'UNE venue, traduits vers {@link IPrice}. */
+  async pricesOf(xex) {
+    if (servesSpot(xex) === false) {
+      throw new Error(
+        `spot prices(${xex}) : cette venue ne sert pas de comptant. Disponibles : ${SPOT_XEXES.join(", ")}.`
+      );
+    }
+    const spot = createPublicSpotXex(xex).spot();
+    if (spot.getPrices === void 0) {
+      throw new Error(`spot prices(${xex}) : cette venue ne sert pas de prix comptant.`);
+    }
+    const prices = await spot.getPrices();
+    return prices.map((price) => ({
+      // `canonicalFromXex`, et non `canonicalFromBase` : les prix ne portent QUE le symbole
+      // concaténé (`BTCUSDT`), jamais la base — contrairement au catalogue, où la venue déclare
+      // `baseAsset`. Passer le symbole à `canonicalFromBase` rendrait `BTCUSDT` tel quel, puisque
+      // cette fonction ne strippe volontairement aucune cotation.
+      //
+      // ⚠️ La limite est connue et assumée : le strip ne retire que `USDT`/`USDC` finaux, donc une
+      // paire cotée en BTC (`ROSEBTC`, `ETHBTC`) garde son nom entier. Le catalogue comptant, lui,
+      // résout ces cas — c'est là qu'il faut aller chercher `symbol` et `quote` justes.
+      symbol: canonicalFromXex(price.name, xex),
+      symbolXex: price.name,
+      xex,
+      kind: price.kind,
+      mark: price.mark,
+      oracle: price.oracle,
+      mid: price.mid,
+      bid: price.bid,
+      ask: price.ask,
+      last: price.last,
+      funding: price.funding,
+      openInterest: price.openInterest,
+      volume24h: price.volume24h,
+      prevDayPrice: price.prevDayPrice,
+      quotedAt: price.quotedAt,
+      xtras: price.xtras
+    }));
+  }
+};
+exports.SpotPricesService = __decorateClass([
+  common.Injectable()
+], exports.SpotPricesService);
+exports.SpotWsCandlesService = class SpotWsCandlesService {
+  logger = new common.Logger(exports.SpotWsCandlesService.name);
+  /** Les venues dont XGate diffuse le comptant en temps réel. */
+  venues() {
+    return SPOT_XEXES;
+  }
+  /**
+   * Souscrit aux bougies **comptant** d'un marché. Rend la fonction de désabonnement.
+   *
+   * Le handler reçoit une bougie à la fois, au format unifié ; la bougie en cours est repoussée à
+   * chaque mise à jour tant qu'elle n'est pas close.
+   */
+  subscribe(xex, query, handler) {
+    if (servesSpot(xex) === false) {
+      throw new Error(
+        `spot subscribe(${xex}) : cette venue ne sert pas de comptant. Disponibles : ${SPOT_XEXES.join(", ")}.`
+      );
+    }
+    this.logger.log(`souscription bougies COMPTANT ${query.symbol} ${query.interval} sur ${xex}`);
+    return createPublicSpotXex(xex).ws("spot").subscribeCandles({ name: query.symbol, interval: query.interval }, (wire) => {
+      handler(toCandle(wire, xex, query.interval, ""));
+    });
+  }
+  /**
+   * Souscrit au MÊME marché comptant chez plusieurs venues, avec un seul handler.
+   *
+   * Chaque bougie porte son `xex`. La fonction rendue coupe tous les flux d'un coup.
+   */
+  subscribeAll(xexes, query, handler) {
+    if (xexes.length === 0) {
+      throw new Error("spot subscribeAll() : aucune venue demand\xE9e \u2014 pr\xE9cise au moins un XgateEx.");
+    }
+    const stops = [];
+    for (const xex of xexes) {
+      try {
+        stops.push(this.subscribe(xex, query, handler));
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        this.logger.error(`souscription comptant ${xex} refus\xE9e, venue ignor\xE9e : ${message}`);
+      }
+    }
+    return () => {
+      for (const stop of stops) {
+        stop();
+      }
+    };
+  }
+};
+exports.SpotWsCandlesService = __decorateClass([
+  common.Injectable()
+], exports.SpotWsCandlesService);
 
 // src/helpers/protection.ts
 var SLIPPAGE_DEFAUT = 5e-3;
@@ -1209,38 +1618,52 @@ exports.XgateModule = __decorateClass([
     providers: [
       exports.CatalogService,
       exports.CandlesService,
+      exports.CandlesStreamRegistry,
       exports.WsCandlesService,
       exports.PricesService,
       exports.SpotCatalogService,
+      exports.SpotCandlesService,
+      exports.SpotPricesService,
+      exports.SpotWsCandlesService,
       exports.WalletService
     ],
     exports: [
       exports.CatalogService,
       exports.CandlesService,
+      exports.CandlesStreamRegistry,
       exports.WsCandlesService,
       exports.PricesService,
       exports.SpotCatalogService,
+      exports.SpotCandlesService,
+      exports.SpotPricesService,
+      exports.SpotWsCandlesService,
       exports.WalletService
     ]
   })
 ], exports.XgateModule);
 
+exports.CandlesStreamService = CandlesStreamService;
 exports.ORDER_STATUSES = ORDER_STATUSES;
 exports.SPOT_XEXES = SPOT_XEXES;
 exports.TIMEFRAME_MINUTES = TIMEFRAME_MINUTES;
 exports.Timeframe = Timeframe;
 exports.WALLET_XEXES = WALLET_XEXES;
+exports.WS_SUBSCRIPTION_LIMITS = WS_SUBSCRIPTION_LIMITS;
 exports.XGATE_EXCHANGES = XGATE_EXCHANGES;
 exports.XgateEx = XgateEx;
 exports.buildLevels = buildLevels;
 exports.buildProtection = buildProtection;
 exports.canonicalFromBase = canonicalFromBase;
 exports.canonicalFromXex = canonicalFromXex;
+exports.expiryOf = expiryOf;
+exports.isDated = isDated;
+exports.multiplierFromXex = multiplierFromXex;
 exports.roundPrice = roundPrice;
 exports.roundToStep = roundToStep;
 exports.servesNatively = servesNatively;
 exports.servesSpot = servesSpot;
 exports.sourceFor = sourceFor;
+exports.subscriptionLimitOf = subscriptionLimitOf;
 exports.timeframeMs = timeframeMs;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map