@pear-protocol/hyperliquid-sdk 0.0.20 → 0.0.24

package/dist/hooks/index.d.ts

@@ -5,3 +5,4 @@ export * from './useWebData';
 export * from './useTokenSelectionMetadata';
 export * from './useHistoricalPriceData';
 export * from './useBasketCandles';
+export * from './usePerformanceOverlays';

package/dist/hooks/useBasketCandles.d.ts

@@ -1,8 +1,21 @@
-import type { WeightedCandleData } from '../types';
+import type { CandleData, CandleInterval } from '../types';
 export interface UseBasketCandlesReturn {
-    fetchBasketCandles: (startTime: number, endTime: number) => Promise<WeightedCandleData[]>;
+    fetchBasketCandles: (startTime: number, endTime: number, interval: CandleInterval) => Promise<CandleData[]>;
+    fetchPerformanceCandles: (startTime: number, endTime: number, interval: CandleInterval, symbol: string) => Promise<CandleData[]>;
+    fetchOverallPerformanceCandles: (startTime: number, endTime: number, interval: CandleInterval) => Promise<CandleData[]>;
     isLoading: boolean;
+    addRealtimeListener: (cb: RealtimeBarsCallback) => string;
+    removeRealtimeListener: (id: string) => void;
 }
+export type RealtimeBar = {
+    time: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume?: number;
+};
+export type RealtimeBarsCallback = (bar: RealtimeBar) => void;
 /**
  * Composes historical price fetching with basket candle computation.
  * - Listens to `longTokens` and `shortTokens` from user selection.

package/dist/hooks/useHistoricalPriceData.d.ts

@@ -1,8 +1,11 @@
-import type { CandleData } from '../types';
+import { TokenHistoricalPriceData } from '../store/historicalPriceDataStore';
+import type { CandleData, CandleInterval } from '../types';
 export interface UseHistoricalPriceDataReturn {
-    fetchHistoricalPriceData: (startTime: number, endTime: number, callback?: (data: Record<string, CandleData[]>) => void) => Promise<Record<string, CandleData[]>>;
-    hasHistoricalPriceData: (startTime: number, endTime: number) => boolean;
-    getHistoricalPriceData: (startTime: number, endTime: number) => Record<string, CandleData[]>;
+    fetchHistoricalPriceData: (startTime: number, endTime: number, interval: CandleInterval, callback?: (data: Record<string, CandleData[]>) => void) => Promise<Record<string, CandleData[]>>;
+    hasHistoricalPriceData: (startTime: number, endTime: number, interval: CandleInterval) => boolean;
+    getHistoricalPriceData: (startTime: number, endTime: number, interval: CandleInterval) => Record<string, CandleData[]>;
+    getAllHistoricalPriceData(): Promise<Record<string, TokenHistoricalPriceData>>;
+    fetchFirstCandle: (symbol: string, interval: CandleInterval) => Promise<CandleData | null>;
     isLoading: (symbol?: string) => boolean;
     clearCache: () => void;
 }

package/dist/hooks/usePerformanceOverlays.d.ts

@@ -0,0 +1,14 @@
+export interface PerformanceOverlay {
+    id: string;
+    symbol: string;
+    label: string;
+    color: string;
+    enabled: boolean;
+    type: 'asset' | 'portfolio';
+    weight?: number;
+}
+export interface UsePerformanceOverlaysReturn {
+    overlays: PerformanceOverlay[];
+    generateOverlaySymbols: () => string[];
+}
+export declare const usePerformanceOverlays: () => UsePerformanceOverlaysReturn;

package/dist/hyperliquid-websocket.d.ts

@@ -1,13 +1,11 @@
 import { ReadyState } from 'react-use-websocket';
-import type { CandleInterval } from './types';
 export interface UseHyperliquidNativeWebSocketProps {
     address: string | null;
     tokens?: string[];
-    candleInterval?: CandleInterval;
 }
 export interface UseHyperliquidNativeWebSocketReturn {
     connectionStatus: ReadyState;
     isConnected: boolean;
     lastError: string | null;
 }
-export declare const useHyperliquidNativeWebSocket: ({ address, tokens, candleInterval }: UseHyperliquidNativeWebSocketProps) => UseHyperliquidNativeWebSocketReturn;
+export declare const useHyperliquidNativeWebSocket: ({ address, }: UseHyperliquidNativeWebSocketProps) => UseHyperliquidNativeWebSocketReturn;

package/dist/index.d.ts

@@ -291,6 +291,7 @@ interface PositionAssetDetailDto {
     unrealizedPnl: number;
     liquidationPrice: number;
     isExternallyModified: boolean;
+    initialWeight: number;
 }
 /**
  * Position sync status
@@ -615,22 +616,19 @@ type CandleInterval = "1m" | "3m" | "5m" | "15m" | "30m" | "1h" | "2h" | "4h" |
  * Candle data structure from WebSocket
  */
 interface CandleData {
+    s?: string;
     t: number;
     T: number;
-    s: string;
-    i: string;
-    o: string;
-    c: string;
-    h: string;
-    l: string;
-    v: string;
-    n: number;
+    o: number;
+    c: number;
+    h: number;
+    l: number;
 }
 /**
  * Candle chart data organized by symbol only
  * Since new candles always have latest timestamp, no need to store per interval
  */
-type CandleChartData = Record<string, CandleData>;
+type CandleChartData = Map<string, CandleData>;
 /**
  * Historical candle data request
  */
@@ -643,19 +641,6 @@ interface CandleSnapshotRequest {
     };
     type: "candleSnapshot";
 }
-/**
- * Weighted candle data for chart visualization
- */
-interface WeightedCandleData {
-    t: number;
-    T: number;
-    o: number;
-    c: number;
-    h: number;
-    l: number;
-    v: number;
-    n: number;
-}
 
 /**
  * Main SDK client for Pear Protocol Hyperliquid API integration
@@ -840,6 +825,7 @@ interface UserSelectionState {
     openConflictModal: boolean;
     conflicts: TokenConflict[];
     candleInterval: CandleInterval;
+    isWeightBalanced: boolean;
     setLongTokens: (tokens: TokenSelection[]) => void;
     setShortTokens: (tokens: TokenSelection[]) => void;
     setOpenTokenSelector: (open: boolean) => void;
@@ -882,19 +868,47 @@ interface UseTokenSelectionMetadataReturn {
 }
 declare const useTokenSelectionMetadata: () => UseTokenSelectionMetadataReturn;
 
+interface HistoricalRange {
+    start: number;
+    end: number;
+}
+interface TokenHistoricalPriceData {
+    symbol: string;
+    interval: CandleInterval;
+    candles: CandleData[];
+    oldestTime: number | null;
+    latestTime: number | null;
+}
+declare const useHistoricalPriceDataStore: any;
+
 interface UseHistoricalPriceDataReturn {
-    fetchHistoricalPriceData: (startTime: number, endTime: number, callback?: (data: Record<string, CandleData[]>) => void) => Promise<Record<string, CandleData[]>>;
-    hasHistoricalPriceData: (startTime: number, endTime: number) => boolean;
-    getHistoricalPriceData: (startTime: number, endTime: number) => Record<string, CandleData[]>;
+    fetchHistoricalPriceData: (startTime: number, endTime: number, interval: CandleInterval, callback?: (data: Record<string, CandleData[]>) => void) => Promise<Record<string, CandleData[]>>;
+    hasHistoricalPriceData: (startTime: number, endTime: number, interval: CandleInterval) => boolean;
+    getHistoricalPriceData: (startTime: number, endTime: number, interval: CandleInterval) => Record<string, CandleData[]>;
+    getAllHistoricalPriceData(): Promise<Record<string, TokenHistoricalPriceData>>;
+    fetchFirstCandle: (symbol: string, interval: CandleInterval) => Promise<CandleData | null>;
     isLoading: (symbol?: string) => boolean;
     clearCache: () => void;
 }
 declare const useHistoricalPriceData: () => UseHistoricalPriceDataReturn;
 
 interface UseBasketCandlesReturn {
-    fetchBasketCandles: (startTime: number, endTime: number) => Promise<WeightedCandleData[]>;
+    fetchBasketCandles: (startTime: number, endTime: number, interval: CandleInterval) => Promise<CandleData[]>;
+    fetchPerformanceCandles: (startTime: number, endTime: number, interval: CandleInterval, symbol: string) => Promise<CandleData[]>;
+    fetchOverallPerformanceCandles: (startTime: number, endTime: number, interval: CandleInterval) => Promise<CandleData[]>;
     isLoading: boolean;
+    addRealtimeListener: (cb: RealtimeBarsCallback) => string;
+    removeRealtimeListener: (id: string) => void;
 }
+type RealtimeBar = {
+    time: number;
+    open: number;
+    high: number;
+    low: number;
+    close: number;
+    volume?: number;
+};
+type RealtimeBarsCallback = (bar: RealtimeBar) => void;
 /**
  * Composes historical price fetching with basket candle computation.
  * - Listens to `longTokens` and `shortTokens` from user selection.
@@ -903,6 +917,21 @@ interface UseBasketCandlesReturn {
  */
 declare const useBasketCandles: () => UseBasketCandlesReturn;
 
+interface PerformanceOverlay {
+    id: string;
+    symbol: string;
+    label: string;
+    color: string;
+    enabled: boolean;
+    type: 'asset' | 'portfolio';
+    weight?: number;
+}
+interface UsePerformanceOverlaysReturn {
+    overlays: PerformanceOverlay[];
+    generateOverlaySymbols: () => string[];
+}
+declare const usePerformanceOverlays: () => UsePerformanceOverlaysReturn;
+
 interface UseHyperliquidWebSocketProps {
     wsUrl: string;
     address: string | null;
@@ -916,14 +945,13 @@ declare const useHyperliquidWebSocket: ({ wsUrl, address }: UseHyperliquidWebSoc
 interface UseHyperliquidNativeWebSocketProps {
     address: string | null;
     tokens?: string[];
-    candleInterval?: CandleInterval;
 }
 interface UseHyperliquidNativeWebSocketReturn {
     connectionStatus: ReadyState;
     isConnected: boolean;
     lastError: string | null;
 }
-declare const useHyperliquidNativeWebSocket: ({ address, tokens, candleInterval }: UseHyperliquidNativeWebSocketProps) => UseHyperliquidNativeWebSocketReturn;
+declare const useHyperliquidNativeWebSocket: ({ address, }: UseHyperliquidNativeWebSocketProps) => UseHyperliquidNativeWebSocketReturn;
 
 /**
  * Account summary calculation utility class
@@ -1016,20 +1044,16 @@ declare const getCompleteTimestamps: (candleLookups: Record<string, Map<number,
  * Compute basket candles from individual token candles using weighted ratios
  * Optimized version that creates lookup maps once and reuses them
  */
-declare const computeBasketCandles: (longTokens: TokenSelection[], shortTokens: TokenSelection[], tokenCandles: Record<string, CandleData[]>) => WeightedCandleData[];
+declare const computeBasketCandles: (longTokens: TokenSelection[], shortTokens: TokenSelection[], tokenCandles: Record<string, CandleData[]>) => CandleData[];
 
-interface HistoricalRange {
-    start: number;
-    end: number;
-}
-interface TokenHistoricalPriceData {
-    symbol: string;
-    interval: CandleInterval;
-    candles: CandleData[];
-    oldestTime: number | null;
-    latestTime: number | null;
-}
-declare const useHistoricalPriceDataStore: any;
+/**
+ * Maps TradingView ResolutionString to CandleInterval
+ */
+declare function mapTradingViewIntervalToCandleInterval(interval: string): CandleInterval;
+/**
+ * Maps CandleInterval to TradingView ResolutionString
+ */
+declare function mapCandleIntervalToTradingViewInterval(interval: CandleInterval): string;
 
-export { AccountSummaryCalculator, ConflictDetector, PearHyperliquidClient, PearHyperliquidProvider, PearMigrationSDK, TokenMetadataExtractor, calculateWeightedRatio, computeBasketCandles, createCandleLookups, PearHyperliquidClient as default, getCompleteTimestamps, useAccountSummary, useAddress, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMigrationSDK, useOpenOrders, useOpenPositions, usePearHyperliquidClient, useTokenSelectionMetadata, useTradeHistories, useUserSelection, useWebData };
-export type { AccountSummaryResponseDto, AgentWalletDto, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, BalanceSummaryDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ClearinghouseState, CrossMarginSummaryDto, CumFundingDto, HLWebSocketResponse, HistoricalRange, MarginSummaryDto, MigrationHookState, MigrationHooks, OpenLimitOrderDto, OpenOrderV1Dto, OpenPositionDto, OpenPositionV1Dto, OrderAssetDto, OrderStatus, PearHyperliquidConfig, PnlDto, PositionAssetDetailDto, PositionSideDto, PositionSyncStatus, RawValueDto, SyncOpenOrderDto, SyncOpenOrderResponseDto, SyncOpenPositionDto, SyncOpenPositionResponseDto, SyncTradeHistoryDto, SyncTradeHistoryResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlDto, TradeHistoryAssetDataDto, TradeHistoryDataDto, TradeHistoryV1Dto, UniverseAsset, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseTokenSelectionMetadataReturn, UserSelectionState, WebData2Response, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WeightedCandleData, WsAllMidsData };
+export { AccountSummaryCalculator, ConflictDetector, PearHyperliquidClient, PearHyperliquidProvider, PearMigrationSDK, TokenMetadataExtractor, calculateWeightedRatio, computeBasketCandles, createCandleLookups, PearHyperliquidClient as default, getCompleteTimestamps, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, useAccountSummary, useAddress, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMigrationSDK, useOpenOrders, useOpenPositions, usePearHyperliquidClient, usePerformanceOverlays, useTokenSelectionMetadata, useTradeHistories, useUserSelection, useWebData };
+export type { AccountSummaryResponseDto, AgentWalletDto, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, BalanceSummaryDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ClearinghouseState, CrossMarginSummaryDto, CumFundingDto, HLWebSocketResponse, HistoricalRange, MarginSummaryDto, MigrationHookState, MigrationHooks, OpenLimitOrderDto, OpenOrderV1Dto, OpenPositionDto, OpenPositionV1Dto, OrderAssetDto, OrderStatus, PearHyperliquidConfig, PerformanceOverlay, PnlDto, PositionAssetDetailDto, PositionSideDto, PositionSyncStatus, RawValueDto, RealtimeBar, RealtimeBarsCallback, SyncOpenOrderDto, SyncOpenOrderResponseDto, SyncOpenPositionDto, SyncOpenPositionResponseDto, SyncTradeHistoryDto, SyncTradeHistoryResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlDto, TradeHistoryAssetDataDto, TradeHistoryDataDto, TradeHistoryV1Dto, UniverseAsset, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UsePerformanceOverlaysReturn, UseTokenSelectionMetadataReturn, UserSelectionState, WebData2Response, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };