@blackcube/xgate-sdk 0.25.3 → 0.25.5

package/dist/index.d.cts

@@ -480,10 +480,23 @@ declare function subscriptionLimitOf(xex: XgateEx): number | undefined;
  *
  * **aster** — 1500 ; non documenté, API de forme binance.
  *
- * **hyperliquid** et **pacifica** n'acceptent AUCUN `limit` : leurs SDK n'envoient que `startTime`/`endTime`
- * (`get-candle-snapshot.ts`, `get-candle-data.ts`). Le nombre sert alors à dimensionner la FENÊTRE demandée, pas
- * à remplir un paramètre. Pour hyperliquid, la venue borne d'elle-même à ~5 000 bougies par (coin, intervalle) —
- * et l'horizon que ça couvre dépend de l'activité du coin, ce n'est donc pas une durée fixe.
+ * **pacifica** — **4 000**, et c'est SA DOCUMENTATION qui le dit : « `limit` : Capped at 4000; defaults to 4000
+ * if not provided » (`docs.pacifica.fi/api-documentation/api/rest-api/markets/get-candle-data`). Le plafond joue
+ * même sans `limit`, puisque 4 000 est aussi le défaut.
+ *
+ * ⚠️ AU-DELÀ, ELLE NE TRONQUE PAS : ELLE REND UN TABLEAU VIDE, avec `success: true`. Vérifié le 2026-08-24 sur
+ * SOL en 15m — 4 000 barres demandées rendent 3 883 bougies, 4 010 en rendent ZÉRO. Une fenêtre trop large ne
+ * coûte donc pas quelques barres perdues, elle coûte l'appel entier, en silence.
+ *
+ * ⚠️ CETTE ENTRÉE A VALU 500 PENDANT DES MOIS, sur la foi du commentaire ci-dessous qui affirmait que pacifica
+ * « n'accepte aucun limit ». C'est faux : son endpoint le documente. Huit fois trop d'appels, à quatre secondes
+ * de cadence chacun — mesuré le 2026-08-24, un backfill 15m sur ses 74 séries a coûté 1 026 appels et 72
+ * minutes là où il en fallait huit fois moins.
+ *
+ * **hyperliquid** n'accepte, elle, aucun `limit` : son SDK n'envoie que `startTime`/`endTime`
+ * (`get-candle-snapshot.ts`). Le nombre sert alors à dimensionner la FENÊTRE demandée, pas à remplir un
+ * paramètre. La venue borne d'elle-même à ~5 000 bougies par (coin, intervalle) — et l'horizon que ça couvre
+ * dépend de l'activité du coin, ce n'est donc pas une durée fixe.
  *
  * ⚠️ UNE VENUE ABSENTE DE CETTE TABLE N'A PAS DE PLAFOND DOCUMENTÉ — ce qui n'est pas « pas de plafond ». On ne
  * devine aucun chiffre : le jour où l'une d'elles s'en approche, on lit sa documentation et on l'ajoute.
@@ -546,6 +559,35 @@ declare const REST_THROTTLE_MS: Partial<Record<XgateEx, number>>;
  * plus vite que ce que la table annonce. C'est à lui de sérialiser par venue.
  */
 declare function restThrottleOf(xex: XgateEx): number | undefined;
+/**
+ * TOUT L'HISTORIQUE QU'UNE VENUE ACCEPTE DE SERVIR, en bougies par (marché, intervalle).
+ *
+ * ⚠️ CE N'EST PAS `CANDLES_PER_CALL`, ET LES CONFONDRE FAIT LIRE UN BACKFILL DE TRAVERS. Le premier plafond dit
+ * combien de bougies tiennent dans UN appel : binance en rend 1 500 à la fois et sert pourtant quarante-quatre
+ * mois, parce qu'on pagine. Celui-ci dit combien la venue en garde EN TOUT — au-delà, aucune pagination ne sert à
+ * rien, elle répond une liste vide.
+ *
+ * **hyperliquid** : « Only the most recent 5000 candles are available » (documentation officielle,
+ * `info` endpoint, `candleSnapshot`). La fenêtre GLISSE : ce qui sort des 5 000 dernières devient définitivement
+ * hors de portée. Sondé le 2026-08-16 sur dix symboles au 2024-09-14 en 15m — POL rend ~500 barres (coin peu
+ * traité, ses 5 000 bougies s'étalent sur deux ans), les neuf autres rendent ZÉRO.
+ *
+ * L'horizon couvert dépend donc de l'ACTIVITÉ du marché, jamais d'une durée fixe : en 1d et 1w la venue est
+ * complète, le plafond ne mord que sous le jour.
+ *
+ * ⚠️ UNE VENUE ABSENTE DE CETTE TABLE SERT SON HISTORIQUE COMPLET par pagination, pour autant qu'on sache. Ce
+ * n'est pas une valeur par défaut confortable : c'est ce qui a été constaté. Le jour où l'une d'elles s'arrête,
+ * on lit sa documentation et on l'ajoute — on ne devine aucun chiffre ici.
+ */
+declare const CANDLES_MAX_HISTORY: Partial<Record<XgateEx, number>>;
+/**
+ * Combien de bougies une venue garde au total, ou `undefined` quand elle sert tout son historique.
+ *
+ * ⚠️ LA CLÉ EST LA VENUE, PAS LA LIGNE DE CATALOGUE DE L'APPELANT — même règle que `candlesPerCallOf` : un
+ * consommateur qui sépare le comptant du perpétuel (`binance` / `binance-spot`) résout vers la venue avant de
+ * demander, sinon il lit `undefined` et croit à un historique complet.
+ */
+declare function candlesMaxHistoryOf(xex: XgateEx): number | undefined;
 
 /**
  * UNE COTATION, TELLE QU'XGATE LA REND — quelle que soit la venue d'où elle vient.
@@ -1815,4 +1857,4 @@ declare function expiryOf(xtras?: Record<string, unknown>): Date | undefined;
  */
 declare function isDated(xtras?: Record<string, unknown>): boolean;
 
-export { CANDLES_PER_CALL, CandlesService, CandlesStreamRegistry, CandlesStreamService, CatalogService, type Direction, type IAccountState, type IBalance, type ICandle, type ICandlesQuery, type IEntryWithProtection, type IEquityPoint, type IFundingPaid, type IMoveStop, type IMovement, type IOrder, type IPair, type IPosition, type IPrice, type IProtection, type IProtectionInput, type IProtectionLeg, type IPublicTrade, type ITarget, type ITrade, type ITradingAccess, type IWalletAccess, type IXexAccess, type IXexSpotSource, type MarketKind, type MovementKind, type MovementStatus, ORDER_STATUSES, type OrderStatus, type OrderType, PricesService, REST_THROTTLE_MS, SPOT_XEXES, type Side, SpotCandlesService, SpotCatalogService, SpotPricesService, SpotWsCandlesService, TIMEFRAME_MINUTES, type TimeInForce, Timeframe, TradingService, type Unsubscribe, WALLET_XEXES, WS_SUBSCRIPTION_LIMITS, WalletService, WsCandlesService, WsTradesService, XGATE_EXCHANGES, XgateEx, XgateModule, buildLevels, buildProtection, candlesPerCallOf, canonicalFromBase, canonicalFromXex, expiryOf, isDated, multiplierFromXex, restThrottleOf, roundPrice, roundToStep, servesNatively, servesSpot, sourceFor, subscriptionLimitOf, timeframeMs };
+export { CANDLES_MAX_HISTORY, CANDLES_PER_CALL, CandlesService, CandlesStreamRegistry, CandlesStreamService, CatalogService, type Direction, type IAccountState, type IBalance, type ICandle, type ICandlesQuery, type IEntryWithProtection, type IEquityPoint, type IFundingPaid, type IMoveStop, type IMovement, type IOrder, type IPair, type IPosition, type IPrice, type IProtection, type IProtectionInput, type IProtectionLeg, type IPublicTrade, type ITarget, type ITrade, type ITradingAccess, type IWalletAccess, type IXexAccess, type IXexSpotSource, type MarketKind, type MovementKind, type MovementStatus, ORDER_STATUSES, type OrderStatus, type OrderType, PricesService, REST_THROTTLE_MS, SPOT_XEXES, type Side, SpotCandlesService, SpotCatalogService, SpotPricesService, SpotWsCandlesService, TIMEFRAME_MINUTES, type TimeInForce, Timeframe, TradingService, type Unsubscribe, WALLET_XEXES, WS_SUBSCRIPTION_LIMITS, WalletService, WsCandlesService, WsTradesService, XGATE_EXCHANGES, XgateEx, XgateModule, buildLevels, buildProtection, candlesMaxHistoryOf, candlesPerCallOf, canonicalFromBase, canonicalFromXex, expiryOf, isDated, multiplierFromXex, restThrottleOf, roundPrice, roundToStep, servesNatively, servesSpot, sourceFor, subscriptionLimitOf, timeframeMs };

package/dist/index.d.ts

@@ -480,10 +480,23 @@ declare function subscriptionLimitOf(xex: XgateEx): number | undefined;
  *
  * **aster** — 1500 ; non documenté, API de forme binance.
  *
- * **hyperliquid** et **pacifica** n'acceptent AUCUN `limit` : leurs SDK n'envoient que `startTime`/`endTime`
- * (`get-candle-snapshot.ts`, `get-candle-data.ts`). Le nombre sert alors à dimensionner la FENÊTRE demandée, pas
- * à remplir un paramètre. Pour hyperliquid, la venue borne d'elle-même à ~5 000 bougies par (coin, intervalle) —
- * et l'horizon que ça couvre dépend de l'activité du coin, ce n'est donc pas une durée fixe.
+ * **pacifica** — **4 000**, et c'est SA DOCUMENTATION qui le dit : « `limit` : Capped at 4000; defaults to 4000
+ * if not provided » (`docs.pacifica.fi/api-documentation/api/rest-api/markets/get-candle-data`). Le plafond joue
+ * même sans `limit`, puisque 4 000 est aussi le défaut.
+ *
+ * ⚠️ AU-DELÀ, ELLE NE TRONQUE PAS : ELLE REND UN TABLEAU VIDE, avec `success: true`. Vérifié le 2026-08-24 sur
+ * SOL en 15m — 4 000 barres demandées rendent 3 883 bougies, 4 010 en rendent ZÉRO. Une fenêtre trop large ne
+ * coûte donc pas quelques barres perdues, elle coûte l'appel entier, en silence.
+ *
+ * ⚠️ CETTE ENTRÉE A VALU 500 PENDANT DES MOIS, sur la foi du commentaire ci-dessous qui affirmait que pacifica
+ * « n'accepte aucun limit ». C'est faux : son endpoint le documente. Huit fois trop d'appels, à quatre secondes
+ * de cadence chacun — mesuré le 2026-08-24, un backfill 15m sur ses 74 séries a coûté 1 026 appels et 72
+ * minutes là où il en fallait huit fois moins.
+ *
+ * **hyperliquid** n'accepte, elle, aucun `limit` : son SDK n'envoie que `startTime`/`endTime`
+ * (`get-candle-snapshot.ts`). Le nombre sert alors à dimensionner la FENÊTRE demandée, pas à remplir un
+ * paramètre. La venue borne d'elle-même à ~5 000 bougies par (coin, intervalle) — et l'horizon que ça couvre
+ * dépend de l'activité du coin, ce n'est donc pas une durée fixe.
  *
  * ⚠️ UNE VENUE ABSENTE DE CETTE TABLE N'A PAS DE PLAFOND DOCUMENTÉ — ce qui n'est pas « pas de plafond ». On ne
  * devine aucun chiffre : le jour où l'une d'elles s'en approche, on lit sa documentation et on l'ajoute.
@@ -546,6 +559,35 @@ declare const REST_THROTTLE_MS: Partial<Record<XgateEx, number>>;
  * plus vite que ce que la table annonce. C'est à lui de sérialiser par venue.
  */
 declare function restThrottleOf(xex: XgateEx): number | undefined;
+/**
+ * TOUT L'HISTORIQUE QU'UNE VENUE ACCEPTE DE SERVIR, en bougies par (marché, intervalle).
+ *
+ * ⚠️ CE N'EST PAS `CANDLES_PER_CALL`, ET LES CONFONDRE FAIT LIRE UN BACKFILL DE TRAVERS. Le premier plafond dit
+ * combien de bougies tiennent dans UN appel : binance en rend 1 500 à la fois et sert pourtant quarante-quatre
+ * mois, parce qu'on pagine. Celui-ci dit combien la venue en garde EN TOUT — au-delà, aucune pagination ne sert à
+ * rien, elle répond une liste vide.
+ *
+ * **hyperliquid** : « Only the most recent 5000 candles are available » (documentation officielle,
+ * `info` endpoint, `candleSnapshot`). La fenêtre GLISSE : ce qui sort des 5 000 dernières devient définitivement
+ * hors de portée. Sondé le 2026-08-16 sur dix symboles au 2024-09-14 en 15m — POL rend ~500 barres (coin peu
+ * traité, ses 5 000 bougies s'étalent sur deux ans), les neuf autres rendent ZÉRO.
+ *
+ * L'horizon couvert dépend donc de l'ACTIVITÉ du marché, jamais d'une durée fixe : en 1d et 1w la venue est
+ * complète, le plafond ne mord que sous le jour.
+ *
+ * ⚠️ UNE VENUE ABSENTE DE CETTE TABLE SERT SON HISTORIQUE COMPLET par pagination, pour autant qu'on sache. Ce
+ * n'est pas une valeur par défaut confortable : c'est ce qui a été constaté. Le jour où l'une d'elles s'arrête,
+ * on lit sa documentation et on l'ajoute — on ne devine aucun chiffre ici.
+ */
+declare const CANDLES_MAX_HISTORY: Partial<Record<XgateEx, number>>;
+/**
+ * Combien de bougies une venue garde au total, ou `undefined` quand elle sert tout son historique.
+ *
+ * ⚠️ LA CLÉ EST LA VENUE, PAS LA LIGNE DE CATALOGUE DE L'APPELANT — même règle que `candlesPerCallOf` : un
+ * consommateur qui sépare le comptant du perpétuel (`binance` / `binance-spot`) résout vers la venue avant de
+ * demander, sinon il lit `undefined` et croit à un historique complet.
+ */
+declare function candlesMaxHistoryOf(xex: XgateEx): number | undefined;
 
 /**
  * UNE COTATION, TELLE QU'XGATE LA REND — quelle que soit la venue d'où elle vient.
@@ -1815,4 +1857,4 @@ declare function expiryOf(xtras?: Record<string, unknown>): Date | undefined;
  */
 declare function isDated(xtras?: Record<string, unknown>): boolean;
 
-export { CANDLES_PER_CALL, CandlesService, CandlesStreamRegistry, CandlesStreamService, CatalogService, type Direction, type IAccountState, type IBalance, type ICandle, type ICandlesQuery, type IEntryWithProtection, type IEquityPoint, type IFundingPaid, type IMoveStop, type IMovement, type IOrder, type IPair, type IPosition, type IPrice, type IProtection, type IProtectionInput, type IProtectionLeg, type IPublicTrade, type ITarget, type ITrade, type ITradingAccess, type IWalletAccess, type IXexAccess, type IXexSpotSource, type MarketKind, type MovementKind, type MovementStatus, ORDER_STATUSES, type OrderStatus, type OrderType, PricesService, REST_THROTTLE_MS, SPOT_XEXES, type Side, SpotCandlesService, SpotCatalogService, SpotPricesService, SpotWsCandlesService, TIMEFRAME_MINUTES, type TimeInForce, Timeframe, TradingService, type Unsubscribe, WALLET_XEXES, WS_SUBSCRIPTION_LIMITS, WalletService, WsCandlesService, WsTradesService, XGATE_EXCHANGES, XgateEx, XgateModule, buildLevels, buildProtection, candlesPerCallOf, canonicalFromBase, canonicalFromXex, expiryOf, isDated, multiplierFromXex, restThrottleOf, roundPrice, roundToStep, servesNatively, servesSpot, sourceFor, subscriptionLimitOf, timeframeMs };
+export { CANDLES_MAX_HISTORY, CANDLES_PER_CALL, CandlesService, CandlesStreamRegistry, CandlesStreamService, CatalogService, type Direction, type IAccountState, type IBalance, type ICandle, type ICandlesQuery, type IEntryWithProtection, type IEquityPoint, type IFundingPaid, type IMoveStop, type IMovement, type IOrder, type IPair, type IPosition, type IPrice, type IProtection, type IProtectionInput, type IProtectionLeg, type IPublicTrade, type ITarget, type ITrade, type ITradingAccess, type IWalletAccess, type IXexAccess, type IXexSpotSource, type MarketKind, type MovementKind, type MovementStatus, ORDER_STATUSES, type OrderStatus, type OrderType, PricesService, REST_THROTTLE_MS, SPOT_XEXES, type Side, SpotCandlesService, SpotCatalogService, SpotPricesService, SpotWsCandlesService, TIMEFRAME_MINUTES, type TimeInForce, Timeframe, TradingService, type Unsubscribe, WALLET_XEXES, WS_SUBSCRIPTION_LIMITS, WalletService, WsCandlesService, WsTradesService, XGATE_EXCHANGES, XgateEx, XgateModule, buildLevels, buildProtection, candlesMaxHistoryOf, candlesPerCallOf, canonicalFromBase, canonicalFromXex, expiryOf, isDated, multiplierFromXex, restThrottleOf, roundPrice, roundToStep, servesNatively, servesSpot, sourceFor, subscriptionLimitOf, timeframeMs };

package/dist/index.js

@@ -2137,7 +2137,7 @@ var CANDLES_PER_CALL = {
   blofin: 1440,
   aster: 1500,
   hyperliquid: 5e3,
-  pacifica: 500
+  pacifica: 4e3
 };
 function candlesPerCallOf(xex) {
   return CANDLES_PER_CALL[xex];
@@ -2156,7 +2156,13 @@ var REST_THROTTLE_MS = {
 function restThrottleOf(xex) {
   return REST_THROTTLE_MS[xex];
 }
+var CANDLES_MAX_HISTORY = {
+  hyperliquid: 5e3
+};
+function candlesMaxHistoryOf(xex) {
+  return CANDLES_MAX_HISTORY[xex];
+}
 
-export { CANDLES_PER_CALL, CandlesService, CandlesStreamRegistry, CandlesStreamService, CatalogService, ORDER_STATUSES, PricesService, REST_THROTTLE_MS, SPOT_XEXES, SpotCandlesService, SpotCatalogService, SpotPricesService, SpotWsCandlesService, TIMEFRAME_MINUTES, Timeframe, TradingService, WALLET_XEXES, WS_SUBSCRIPTION_LIMITS, WalletService, WsCandlesService, WsTradesService, XGATE_EXCHANGES, XgateEx, XgateModule, buildLevels, buildProtection, candlesPerCallOf, canonicalFromBase, canonicalFromXex, expiryOf, isDated, multiplierFromXex, restThrottleOf, roundPrice, roundToStep, servesNatively, servesSpot, sourceFor, subscriptionLimitOf, timeframeMs };
+export { CANDLES_MAX_HISTORY, CANDLES_PER_CALL, CandlesService, CandlesStreamRegistry, CandlesStreamService, CatalogService, ORDER_STATUSES, PricesService, REST_THROTTLE_MS, SPOT_XEXES, SpotCandlesService, SpotCatalogService, SpotPricesService, SpotWsCandlesService, TIMEFRAME_MINUTES, Timeframe, TradingService, WALLET_XEXES, WS_SUBSCRIPTION_LIMITS, WalletService, WsCandlesService, WsTradesService, XGATE_EXCHANGES, XgateEx, XgateModule, buildLevels, buildProtection, candlesMaxHistoryOf, candlesPerCallOf, canonicalFromBase, canonicalFromXex, expiryOf, isDated, multiplierFromXex, restThrottleOf, roundPrice, roundToStep, servesNatively, servesSpot, sourceFor, subscriptionLimitOf, timeframeMs };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map