@pear-protocol/hyperliquid-sdk 0.1.28 → 0.1.31

package/dist/index.d.ts

@@ -888,6 +888,7 @@ type CandleInterval = '1m' | '3m' | '5m' | '15m' | '30m' | '1h' | '2h' | '4h' |
  */
 interface CandleData {
     s?: string;
+    i?: CandleInterval;
     t: number;
     T: number;
     o: number;

package/dist/index.js

@@ -972,6 +972,37 @@ const useUserSelection$1 = create((set, get) => ({
     resetToDefaults: () => set((prev) => ({ ...prev, ...DEFAULT_STATE })),
 }));
 
+const STABLE_QUOTE_SYMBOLS = new Set([
+    'USDC',
+    'USDH',
+    'USDE',
+    'USDT',
+    'USDT0',
+]);
+const isStableQuoteSymbol = (symbol) => STABLE_QUOTE_SYMBOLS.has(symbol.toUpperCase());
+const hasNonStableTokens = (tokens) => tokens.some((token) => !isStableQuoteSymbol(token.symbol));
+const isStableOnlySide = (tokens) => tokens.length === 0 || tokens.every((token) => isStableQuoteSymbol(token.symbol));
+const isSingleAssetSideAgainstStableQuote = (longTokens, shortTokens) => {
+    const longHasNonStable = hasNonStableTokens(longTokens);
+    const shortHasNonStable = hasNonStableTokens(shortTokens);
+    return ((longHasNonStable && isStableOnlySide(shortTokens)) ||
+        (shortHasNonStable && isStableOnlySide(longTokens)));
+};
+
+const CANDLE_STALE_WARNING_MS = 90000;
+const getCandleSubscriptionKey = (coin, interval) => `${coin}:${interval}`;
+const debugHyperliquidWs = (message, payload) => {
+    if (typeof window === "undefined")
+        return;
+    if (window.localStorage.getItem("pear:debug:hl-ws") !== "1")
+        return;
+    if (payload === undefined) {
+        console.debug(`[HyperLiquid WS] ${message}`);
+    }
+    else {
+        console.debug(`[HyperLiquid WS] ${message}`, payload);
+    }
+};
 const useHyperliquidNativeWebSocket = ({ address, enabled = true, onUserFills, }) => {
     const { setAllMids, setActiveAssetData, upsertActiveAssetData, setCandleData, deleteCandleSymbol, deleteActiveAssetData, addCandleData, setFinalAtOICaps, setAggregatedClearingHouseState, setRawClearinghouseStates, setAssetContextsByDex, } = useHyperliquidData();
     const { setSpotState, setUserAbstractionMode } = useUserData();
@@ -979,14 +1010,19 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, onUserFills, }
     const userSummary = useUserData((state) => state.accountSummary);
     const longTokens = useUserSelection$1((s) => s.longTokens);
     const shortTokens = useUserSelection$1((s) => s.shortTokens);
-    const selectedTokenSymbols = useMemo(() => [...longTokens, ...shortTokens].map((t) => t.symbol), [longTokens, shortTokens]);
+    const selectedTokenSymbols = useMemo(() => [...longTokens, ...shortTokens]
+        .map((t) => t.symbol)
+        .filter((symbol) => !isStableQuoteSymbol(symbol)), [longTokens, shortTokens]);
     const [lastError, setLastError] = useState(null);
     const [subscribedAddress, setSubscribedAddress] = useState(null);
     const [subscribedTokens, setSubscribedTokens] = useState([]);
     const [subscribedCandleTokens, setSubscribedCandleTokens] = useState([]);
     const [clearinghouseStateReceived, setClearinghouseStateReceived] = useState(false);
     const prevCandleIntervalRef = useRef(null);
+    const currentCandleIntervalRef = useRef(candleInterval);
     const prevActiveAssetAddressRef = useRef(null);
+    const lastCandleMessageAtRef = useRef(null);
+    const lastCandleBySubscriptionRef = useRef(new Map());
     const pingIntervalRef = useRef(null);
     const wsRef = useRef(null);
     const reconnectAttemptsRef = useRef(0);
@@ -998,8 +1034,11 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, onUserFills, }
     useEffect(() => {
         onUserFillsRef.current = onUserFills;
     }, [onUserFills]);
+    useEffect(() => {
+        currentCandleIntervalRef.current = candleInterval;
+    }, [candleInterval]);
     const handleMessage = useCallback((event) => {
-        var _a;
+        var _a, _b;
         try {
             const message = JSON.parse(event.data);
             // Handle subscription responses
@@ -1097,7 +1136,27 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, onUserFills, }
                         {
                             const candleDataItem = response.data;
                             const symbol = candleDataItem.s || "";
+                            const messageInterval = (_b = candleDataItem.i) !== null && _b !== void 0 ? _b : currentCandleIntervalRef.current;
+                            if (messageInterval !== currentCandleIntervalRef.current) {
+                                debugHyperliquidWs("ignoring stale candle interval", {
+                                    symbol,
+                                    messageInterval,
+                                    currentInterval: currentCandleIntervalRef.current,
+                                    t: candleDataItem.t,
+                                    T: candleDataItem.T,
+                                });
+                                break;
+                            }
                             addCandleData(symbol, candleDataItem);
+                            const now = Date.now();
+                            lastCandleMessageAtRef.current = now;
+                            lastCandleBySubscriptionRef.current.set(getCandleSubscriptionKey(symbol, messageInterval), now);
+                            debugHyperliquidWs("candle received", {
+                                symbol,
+                                interval: messageInterval,
+                                t: candleDataItem.t,
+                                T: candleDataItem.T,
+                            });
                         }
                         break;
                     case "spotState":
@@ -1166,6 +1225,7 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, onUserFills, }
                 setSubscribedAddress(null);
                 setSubscribedTokens([]);
                 setSubscribedCandleTokens([]);
+                lastCandleBySubscriptionRef.current.clear();
                 setClearinghouseStateReceived(false);
                 if (!manualCloseRef.current) {
                     reconnectAttemptsRef.current += 1;
@@ -1197,6 +1257,7 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, onUserFills, }
             setSubscribedAddress(null);
             setSubscribedTokens([]);
             setSubscribedCandleTokens([]);
+            lastCandleBySubscriptionRef.current.clear();
             setClearinghouseStateReceived(false);
             // Close existing socket if in a bad state
             if (wsRef.current &&
@@ -1486,9 +1547,13 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, onUserFills, }
         if (!isConnected)
             return;
         const effectiveTokens = selectedTokenSymbols;
-        // Unsubscribe from previous candle subscriptions if interval changed
         const prevInterval = prevCandleIntervalRef.current;
-        if (prevInterval && prevInterval !== candleInterval) {
+        const intervalChanged = prevInterval !== null && prevInterval !== candleInterval;
+        const activeSubscribedCandleTokens = intervalChanged
+            ? []
+            : subscribedCandleTokens;
+        // Unsubscribe from previous candle subscriptions if interval changed
+        if (intervalChanged && prevInterval !== null) {
             subscribedCandleTokens.forEach((token) => {
                 const unsubscribeMessage = {
                     method: "unsubscribe",
@@ -1499,12 +1564,17 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, onUserFills, }
                     },
                 };
                 sendJsonMessage(unsubscribeMessage);
+                lastCandleBySubscriptionRef.current.delete(getCandleSubscriptionKey(token, prevInterval));
+                debugHyperliquidWs("candle unsubscribe", {
+                    token,
+                    interval: prevInterval,
+                    reason: "interval-change",
+                });
             });
             setCandleData(new Map());
-            setSubscribedCandleTokens([]);
         }
-        const tokensToSubscribe = effectiveTokens.filter((token) => token && !subscribedCandleTokens.includes(token));
-        const tokensToUnsubscribe = subscribedCandleTokens.filter((token) => !effectiveTokens.includes(token));
+        const tokensToSubscribe = effectiveTokens.filter((token) => token && !activeSubscribedCandleTokens.includes(token));
+        const tokensToUnsubscribe = activeSubscribedCandleTokens.filter((token) => !effectiveTokens.includes(token));
         // Unsubscribe from tokens no longer in the list
         tokensToUnsubscribe.forEach((token) => {
             const unsubscribeMessage = {
@@ -1516,6 +1586,12 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, onUserFills, }
                 },
             };
             sendJsonMessage(unsubscribeMessage);
+            lastCandleBySubscriptionRef.current.delete(getCandleSubscriptionKey(token, candleInterval));
+            debugHyperliquidWs("candle unsubscribe", {
+                token,
+                interval: candleInterval,
+                reason: "token-removed",
+            });
         });
         // Subscribe to new tokens
         tokensToSubscribe.forEach((token) => {
@@ -1528,6 +1604,11 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, onUserFills, }
                 },
             };
             sendJsonMessage(subscribeMessage);
+            lastCandleBySubscriptionRef.current.delete(getCandleSubscriptionKey(token, candleInterval));
+            debugHyperliquidWs("candle subscribe", {
+                token,
+                interval: candleInterval,
+            });
         });
         // Update subscribed state
         if (tokensToSubscribe.length > 0 ||
@@ -1544,7 +1625,48 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, onUserFills, }
         subscribedCandleTokens,
         sendJsonMessage,
         setCandleData,
+        deleteCandleSymbol,
     ]);
+    useEffect(() => {
+        if (!isConnected)
+            return;
+        const checkCandleSubscriptionHealth = () => {
+            const effectiveTokens = selectedTokenSymbols.filter((token) => token);
+            if (effectiveTokens.length === 0)
+                return;
+            const now = Date.now();
+            const missingSubscriptionState = effectiveTokens.filter((token) => !subscribedCandleTokens.includes(token));
+            const missingCandles = effectiveTokens.filter((token) => {
+                const key = getCandleSubscriptionKey(token, candleInterval);
+                return !lastCandleBySubscriptionRef.current.has(key);
+            });
+            const staleCandles = effectiveTokens.filter((token) => {
+                const key = getCandleSubscriptionKey(token, candleInterval);
+                const lastSeenAt = lastCandleBySubscriptionRef.current.get(key);
+                return (lastSeenAt !== undefined &&
+                    now - lastSeenAt > CANDLE_STALE_WARNING_MS);
+            });
+            if (missingSubscriptionState.length === 0 &&
+                missingCandles.length === 0 &&
+                staleCandles.length === 0) {
+                return;
+            }
+            debugHyperliquidWs("candle subscription health", {
+                interval: candleInterval,
+                selectedTokens: effectiveTokens,
+                subscribedTokens: subscribedCandleTokens,
+                missingSubscriptionState,
+                missingCandles,
+                staleCandles,
+                lastAnyCandleAgeMs: lastCandleMessageAtRef.current === null
+                    ? null
+                    : now - lastCandleMessageAtRef.current,
+            });
+        };
+        checkCandleSubscriptionHealth();
+        const healthInterval = setInterval(checkCandleSubscriptionHealth, 30000);
+        return () => clearInterval(healthInterval);
+    }, [isConnected, selectedTokenSymbols, candleInterval, subscribedCandleTokens]);
     return {
         isConnected,
         lastError,
@@ -1801,7 +1923,7 @@ const useTokenSelectionMetadataStore = create((set) => ({
                 ...longTokensMetadata,
                 ...shortTokensMetadata,
             };
-            return allTokens.some((token) => !allMetadata[token.symbol]);
+            return allTokens.some((token) => !isStableQuoteSymbol(token.symbol) && !allMetadata[token.symbol]);
         })();
         // Open interest and volume (from market data for matching asset basket)
         const { openInterest, volume } = (() => {
@@ -1824,9 +1946,15 @@ const useTokenSelectionMetadataStore = create((set) => ({
                 ? { openInterest: match.openInterest, volume: match.volume }
                 : empty;
         })();
+        const getPrice = (metadata, symbol, field) => {
+            var _a;
+            if (isStableQuoteSymbol(symbol))
+                return 1;
+            return (_a = metadata === null || metadata === void 0 ? void 0 : metadata[field]) !== null && _a !== void 0 ? _a : 0;
+        };
+        const shouldUseAbsoluteQuoteRatio = isSingleAssetSideAgainstStableQuote(longTokens, shortTokens);
         // Price ratio (only when exactly one long and one short)
         const { priceRatio, priceRatio24h } = (() => {
-            var _a, _b, _c, _d;
             if (longTokens.length !== 1 || shortTokens.length !== 1) {
                 return { priceRatio: 1, priceRatio24h: 1 };
             }
@@ -1834,10 +1962,22 @@ const useTokenSelectionMetadataStore = create((set) => ({
             const shortSymbol = shortTokens[0].symbol;
             const longMeta = longTokensMetadata[longSymbol];
             const shortMeta = shortTokensMetadata[shortSymbol];
-            const currentLong = (_a = longMeta === null || longMeta === void 0 ? void 0 : longMeta.currentPrice) !== null && _a !== void 0 ? _a : 0;
-            const currentShort = (_b = shortMeta === null || shortMeta === void 0 ? void 0 : shortMeta.currentPrice) !== null && _b !== void 0 ? _b : 0;
-            const prevLong = (_c = longMeta === null || longMeta === void 0 ? void 0 : longMeta.prevDayPrice) !== null && _c !== void 0 ? _c : 0;
-            const prevShort = (_d = shortMeta === null || shortMeta === void 0 ? void 0 : shortMeta.prevDayPrice) !== null && _d !== void 0 ? _d : 0;
+            const currentLong = getPrice(longMeta, longSymbol, "currentPrice");
+            const currentShort = getPrice(shortMeta, shortSymbol, "currentPrice");
+            const prevLong = getPrice(longMeta, longSymbol, "prevDayPrice");
+            const prevShort = getPrice(shortMeta, shortSymbol, "prevDayPrice");
+            if (isStableQuoteSymbol(longSymbol) && !isStableQuoteSymbol(shortSymbol)) {
+                return {
+                    priceRatio: currentShort || 1,
+                    priceRatio24h: prevShort || 1,
+                };
+            }
+            if (isStableQuoteSymbol(shortSymbol) && !isStableQuoteSymbol(longSymbol)) {
+                return {
+                    priceRatio: currentLong || 1,
+                    priceRatio24h: prevLong || 1,
+                };
+            }
             const ratio = currentShort !== 0 ? currentLong / currentShort : 1;
             const ratio24h = prevShort !== 0 ? prevLong / prevShort : 1;
             return { priceRatio: ratio, priceRatio24h: ratio24h };
@@ -1848,16 +1988,20 @@ const useTokenSelectionMetadataStore = create((set) => ({
             let shortProduct = 1;
             longTokens.forEach((token) => {
                 const metadata = longTokensMetadata[token.symbol];
-                if ((metadata === null || metadata === void 0 ? void 0 : metadata.currentPrice) && token.weight > 0) {
+                const price = getPrice(metadata, token.symbol, "currentPrice");
+                if (price && token.weight > 0) {
                     const weightFactor = token.weight / 100;
-                    longProduct *= Math.pow(metadata.currentPrice, weightFactor);
+                    longProduct *= Math.pow(price, weightFactor);
                 }
             });
             shortTokens.forEach((token) => {
                 const metadata = shortTokensMetadata[token.symbol];
-                if ((metadata === null || metadata === void 0 ? void 0 : metadata.currentPrice) && token.weight > 0) {
-                    const weightFactor = token.weight / 100;
-                    shortProduct *= Math.pow(metadata.currentPrice, -weightFactor);
+                const price = getPrice(metadata, token.symbol, "currentPrice");
+                if (price && token.weight > 0) {
+                    const weightFactor = shouldUseAbsoluteQuoteRatio
+                        ? token.weight / 100
+                        : -(token.weight / 100);
+                    shortProduct *= Math.pow(price, weightFactor);
                 }
             });
             return longProduct * shortProduct;
@@ -1868,16 +2012,20 @@ const useTokenSelectionMetadataStore = create((set) => ({
             let shortProduct = 1;
             longTokens.forEach((token) => {
                 const metadata = longTokensMetadata[token.symbol];
-                if ((metadata === null || metadata === void 0 ? void 0 : metadata.prevDayPrice) && token.weight > 0) {
+                const price = getPrice(metadata, token.symbol, "prevDayPrice");
+                if (price && token.weight > 0) {
                     const weightFactor = token.weight / 100;
-                    longProduct *= Math.pow(metadata.prevDayPrice, weightFactor);
+                    longProduct *= Math.pow(price, weightFactor);
                 }
             });
             shortTokens.forEach((token) => {
                 const metadata = shortTokensMetadata[token.symbol];
-                if ((metadata === null || metadata === void 0 ? void 0 : metadata.prevDayPrice) && token.weight > 0) {
-                    const weightFactor = token.weight / 100;
-                    shortProduct *= Math.pow(metadata.prevDayPrice, -weightFactor);
+                const price = getPrice(metadata, token.symbol, "prevDayPrice");
+                if (price && token.weight > 0) {
+                    const weightFactor = shouldUseAbsoluteQuoteRatio
+                        ? token.weight / 100
+                        : -(token.weight / 100);
+                    shortProduct *= Math.pow(price, weightFactor);
                 }
             });
             return longProduct * shortProduct;
@@ -6337,7 +6485,7 @@ const useHistoricalPriceData = () => {
     const prevIntervalRef = useRef(null);
     // Get all tokens from long and short selections
     const getAllTokens = useCallback(() => {
-        return [...longTokens, ...shortTokens];
+        return [...longTokens, ...shortTokens].filter((token) => !isStableQuoteSymbol(token.symbol));
     }, [longTokens, shortTokens]);
     // Track token and interval changes and manage cache accordingly
     useEffect(() => {
@@ -6475,10 +6623,10 @@ const createCandleLookups = (tokenCandles) => {
 const calculateWeightedRatio = (longTokens, shortTokens, candleLookups, timestamp, priceType) => {
     let longProduct = 1;
     let shortProduct = 1;
+    const shouldUseAbsoluteQuoteRatio = isSingleAssetSideAgainstStableQuote(longTokens, shortTokens);
     // Long side: PRICE^(WEIGHT/100)
     for (const token of longTokens) {
-        const lookup = candleLookups[token.symbol];
-        const candle = lookup === null || lookup === void 0 ? void 0 : lookup.get(timestamp);
+        const candle = getCandleOrStableQuote(candleLookups, token.symbol, timestamp);
         if (candle) {
             const price = candle[priceType];
             if (price > 0) {
@@ -6492,13 +6640,14 @@ const calculateWeightedRatio = (longTokens, shortTokens, candleLookups, timestam
     }
     // Short side: PRICE^-(WEIGHT/100)
     for (const token of shortTokens) {
-        const lookup = candleLookups[token.symbol];
-        const candle = lookup === null || lookup === void 0 ? void 0 : lookup.get(timestamp);
+        const candle = getCandleOrStableQuote(candleLookups, token.symbol, timestamp);
         if (candle) {
             const price = candle[priceType];
             if (price > 0) {
-                const weightFactor = token.weight / 100;
-                shortProduct *= Math.pow(price, -weightFactor);
+                const weightFactor = shouldUseAbsoluteQuoteRatio
+                    ? token.weight / 100
+                    : -(token.weight / 100);
+                shortProduct *= Math.pow(price, weightFactor);
             }
         }
         else {
@@ -6551,19 +6700,37 @@ const getCompleteTimestamps = (candleLookups, requiredSymbols) => {
     result.sort((a, b) => a - b);
     return result;
 };
+const getRequiredSymbols = (longTokens, shortTokens) => [...longTokens, ...shortTokens]
+    .map((token) => token.symbol)
+    .filter((symbol) => !isStableQuoteSymbol(symbol));
+const getCandleOrStableQuote = (candleLookups, symbol, timestamp) => {
+    var _a, _b;
+    if (isStableQuoteSymbol(symbol)) {
+        return {
+            s: symbol,
+            t: timestamp,
+            T: timestamp,
+            o: 1,
+            h: 1,
+            l: 1,
+            c: 1,
+        };
+    }
+    return (_b = (_a = candleLookups[symbol]) === null || _a === void 0 ? void 0 : _a.get(timestamp)) !== null && _b !== void 0 ? _b : null;
+};
 /**
  * Compute basket candles from individual token candles using weighted ratios
  * Optimized version that creates lookup maps once and reuses them
  */
 const computeBasketCandles = (longTokens, shortTokens, tokenCandles) => {
-    var _a, _b;
     if (longTokens.length === 0 && shortTokens.length === 0) {
         return [];
     }
     // Create efficient lookup maps once
     const candleLookups = createCandleLookups(tokenCandles);
-    const allSymbols = [...longTokens, ...shortTokens].map(t => t.symbol);
+    const allSymbols = getRequiredSymbols(longTokens, shortTokens);
     const completeTimestamps = getCompleteTimestamps(candleLookups, allSymbols);
+    const shouldUseAbsoluteQuoteRatio = isSingleAssetSideAgainstStableQuote(longTokens, shortTokens);
     const basketCandles = [];
     for (const timestamp of completeTimestamps) {
         // Compute all OHLC products in a single pass per side
@@ -6573,7 +6740,7 @@ const computeBasketCandles = (longTokens, shortTokens, tokenCandles) => {
         let missing = false;
         // Accumulate volume/trades and compute long side contributions
         for (const token of longTokens) {
-            const candle = (_a = candleLookups[token.symbol]) === null || _a === void 0 ? void 0 : _a.get(timestamp);
+            const candle = getCandleOrStableQuote(candleLookups, token.symbol, timestamp);
             if (!candle) {
                 missing = true;
                 break;
@@ -6598,12 +6765,14 @@ const computeBasketCandles = (longTokens, shortTokens, tokenCandles) => {
             continue;
         // Short side contributions (negative exponent)
         for (const token of shortTokens) {
-            const candle = (_b = candleLookups[token.symbol]) === null || _b === void 0 ? void 0 : _b.get(timestamp);
+            const candle = getCandleOrStableQuote(candleLookups, token.symbol, timestamp);
             if (!candle) {
                 missing = true;
                 break;
             }
-            const weightFactor = -(token.weight / 100);
+            const weightFactor = shouldUseAbsoluteQuoteRatio
+                ? token.weight / 100
+                : -(token.weight / 100);
             const o = candle.o;
             const h = candle.h;
             const l = candle.l;
@@ -6633,6 +6802,22 @@ const computeBasketCandles = (longTokens, shortTokens, tokenCandles) => {
     return basketCandles;
 };
 
+const CANDLE_INTERVAL_MS = {
+    '1m': 60 * 1000,
+    '3m': 3 * 60 * 1000,
+    '5m': 5 * 60 * 1000,
+    '15m': 15 * 60 * 1000,
+    '30m': 30 * 60 * 1000,
+    '1h': 60 * 60 * 1000,
+    '2h': 2 * 60 * 60 * 1000,
+    '4h': 4 * 60 * 60 * 1000,
+    '8h': 8 * 60 * 60 * 1000,
+    '12h': 12 * 60 * 60 * 1000,
+    '1d': 24 * 60 * 60 * 1000,
+    '3d': 3 * 24 * 60 * 60 * 1000,
+    '1w': 7 * 24 * 60 * 60 * 1000,
+    '1M': 30 * 24 * 60 * 60 * 1000,
+};
 /**
  * Composes historical price fetching with basket candle computation.
  * - Listens to `longTokens` and `shortTokens` from user selection.
@@ -6642,6 +6827,7 @@ const computeBasketCandles = (longTokens, shortTokens, tokenCandles) => {
 const useBasketCandles = () => {
     const longTokens = useUserSelection$1((state) => state.longTokens);
     const shortTokens = useUserSelection$1((state) => state.shortTokens);
+    const candleInterval = useUserSelection$1((state) => state.candleInterval);
     const candleData = useHyperliquidData((s) => s.candleData);
     const { fetchHistoricalPriceData, isLoading: tokenLoading, getAllHistoricalPriceData, getEffectiveDataBoundary } = useHistoricalPriceData();
     const fetchBasketCandles = useCallback(async (startTime, endTime, interval) => {
@@ -6660,7 +6846,7 @@ const useBasketCandles = () => {
     const fetchOverallPerformanceCandles = useCallback(async (startTime, endTime, interval) => {
         await fetchHistoricalPriceData(startTime, endTime, interval);
         const allCandles = await getAllHistoricalPriceData();
-        const allTokens = [...longTokens, ...shortTokens];
+        const allTokens = [...longTokens, ...shortTokens].filter((token) => !isStableQuoteSymbol(token.symbol));
         if (allTokens.length === 0)
             return [];
         const symbolsData = {};
@@ -6747,40 +6933,70 @@ const useBasketCandles = () => {
     const removeRealtimeListener = useCallback((id) => {
         listenersRef.current.delete(id);
     }, []);
-    // Helper: compute weighted bar from latest snapshot if all tokens aligned
+    // Helper: compute weighted bar from latest snapshot, carrying forward lagging
+    // symbols so one sparse feed does not suppress every realtime chart update.
     const computeRealtimeBar = useCallback(() => {
         if (!candleData)
             return null;
         const allTokens = [...longTokens, ...shortTokens];
         if (allTokens.length === 0)
             return null;
-        // Collect candles, ensure presence and alignment
         const symbolSet = new Set(allTokens.map((t) => t.symbol));
         const snapshot = {};
+        let t = null;
+        let T = null;
         for (const symbol of symbolSet) {
+            if (isStableQuoteSymbol(symbol))
+                continue;
             const c = candleData.get(symbol);
             if (!c)
                 return null; // missing latest candle for symbol
             snapshot[symbol] = c;
-        }
-        // Verify same interval window (t and T match across symbols)
-        let t = null;
-        let T = null;
-        for (const symbol of symbolSet) {
-            const c = snapshot[symbol];
-            if (t === null) {
+            if (t === null || c.t > t) {
                 t = c.t;
                 T = c.T;
             }
-            else if (c.t !== t || c.T !== T) {
-                return null; // not aligned yet
-            }
         }
+        if (t === null || T === null)
+            return null;
+        const intervalMs = CANDLE_INTERVAL_MS[candleInterval];
+        const maxCarryForwardMs = intervalMs * 2;
+        const getCandleForTargetWindow = (symbol) => {
+            if (isStableQuoteSymbol(symbol)) {
+                return {
+                    s: symbol,
+                    t,
+                    T,
+                    o: 1,
+                    h: 1,
+                    l: 1,
+                    c: 1,
+                };
+            }
+            const c = snapshot[symbol];
+            if (c.t === t)
+                return c;
+            if (c.t > t || t - c.t > maxCarryForwardMs)
+                return null;
+            const price = c.c;
+            if (!(price > 0))
+                return null;
+            return {
+                s: c.s,
+                t,
+                T,
+                o: price,
+                h: price,
+                l: price,
+                c: price,
+            };
+        };
         // Compute weighted OHLC similar to computeBasketCandles
         let longOpen = 1, longHigh = 1, longLow = 1, longClose = 1;
         let shortOpen = 1, shortHigh = 1, shortLow = 1, shortClose = 1;
+        const shouldUseAbsoluteQuoteRatio = isSingleAssetSideAgainstStableQuote(longTokens, shortTokens);
         for (const token of longTokens) {
-            const c = snapshot[token.symbol];
+            const c = getCandleForTargetWindow(token.symbol);
             if (!c)
                 return null;
             const w = token.weight / 100;
@@ -6793,10 +7009,12 @@ const useBasketCandles = () => {
             longClose *= Math.pow(cl, w);
         }
         for (const token of shortTokens) {
-            const c = snapshot[token.symbol];
+            const c = getCandleForTargetWindow(token.symbol);
             if (!c)
                 return null;
-            const w = -(token.weight / 100);
+            const w = shouldUseAbsoluteQuoteRatio
+                ? token.weight / 100
+                : -(token.weight / 100);
             const o = c.o, h = c.h, l = c.l, cl = c.c;
             if (!(o > 0 && h > 0 && l > 0 && cl > 0))
                 return null;
@@ -6805,8 +7023,6 @@ const useBasketCandles = () => {
             shortLow *= Math.pow(l, w);
             shortClose *= Math.pow(cl, w);
         }
-        if (t === null || T === null)
-            return null;
         const weighted = {
             t,
             T,
@@ -6816,8 +7032,8 @@ const useBasketCandles = () => {
             c: longClose * shortClose,
         };
         return weighted;
-    }, [candleData, longTokens, shortTokens]);
-    // Emit realtime bars when aligned snapshot updates
+    }, [candleData, candleInterval, longTokens, shortTokens]);
+    // Emit realtime bars when the latest snapshot can produce a valid bar.
     useEffect(() => {
         if (listenersRef.current.size === 0)
             return;

package/dist/types.d.ts

@@ -860,6 +860,7 @@ export type CandleInterval = '1m' | '3m' | '5m' | '15m' | '30m' | '1h' | '2h' |
  */
 export interface CandleData {
     s?: string;
+    i?: CandleInterval;
     t: number;
     T: number;
     o: number;

package/dist/utils/quote-assets.d.ts

@@ -0,0 +1,6 @@
+import type { TokenSelection } from '../types';
+export declare const STABLE_QUOTE_SYMBOLS: Set<string>;
+export declare const isStableQuoteSymbol: (symbol: string) => boolean;
+export declare const hasNonStableTokens: (tokens: TokenSelection[]) => boolean;
+export declare const isStableOnlySide: (tokens: TokenSelection[]) => boolean;
+export declare const isSingleAssetSideAgainstStableQuote: (longTokens: TokenSelection[], shortTokens: TokenSelection[]) => boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pear-protocol/hyperliquid-sdk",
-  "version": "0.1.28",
+  "version": "0.1.31",
   "description": "React SDK for Pear Protocol Hyperliquid API integration",
   "type": "module",
   "main": "dist/index.js",