@pear-protocol/hyperliquid-sdk 0.0.60-beta-usdh-3 → 0.0.60-beta-usdh-4

package/dist/hooks/index.d.ts

@@ -17,3 +17,4 @@ export * from './useMarketData';
 export * from './useWatchlist';
 export * from './usePortfolio';
 export * from './useAuth';
+export * from './useSpotBalances';

package/dist/hooks/useSpotBalances.d.ts

@@ -0,0 +1,7 @@
+interface SpotBalances {
+    usdhBalance: number | undefined;
+    spotUsdcBalance: number | undefined;
+    isLoading: boolean;
+}
+export declare const useSpotBalances: () => SpotBalances;
+export {};

package/dist/index.d.ts

@@ -47,7 +47,7 @@ interface ExternalFillDto {
     coin: string;
     px: string;
     sz: string;
-    side: "B" | "A";
+    side: 'B' | 'A';
     time: number;
     dir: string;
     fee: string;
@@ -74,16 +74,16 @@ interface TwapSliceFillResponseItem {
 /**
  * WebSocket connection states
  */
-type WebSocketConnectionState = "connecting" | "connected" | "disconnected" | "error";
+type WebSocketConnectionState = 'connecting' | 'connected' | 'disconnected' | 'error';
 /**
  * WebSocket channels
  */
-type WebSocketChannel = "trade-histories" | "open-positions" | "open-orders" | "account-summary" | "twap-details" | "notifications" | "market-data" | "market-data-all" | "webData3" | "allMids" | "activeAssetData";
+type WebSocketChannel = 'trade-histories' | 'open-positions' | 'open-orders' | 'account-summary' | 'twap-details' | 'notifications' | 'market-data' | 'market-data-all' | 'webData3' | 'allMids' | 'activeAssetData';
 /**
  * WebSocket subscription message
  */
 interface WebSocketSubscribeMessage {
-    action?: "subscribe" | "unsubscribe";
+    action?: 'subscribe' | 'unsubscribe';
     address: string;
 }
 /**
@@ -113,7 +113,7 @@ interface WatchlistItemDto {
 interface ToggleWatchlistResponseDto {
     items: WatchlistItemDto[];
 }
-type NotificationCategory = "TRADE_OPENED_OUTSIDE_PEAR" | "TRADE_CLOSED_OUTSIDE_PEAR" | "POSITION_LIQUIDATED" | "LIMIT_ORDER_FILLED" | "LIMIT_ORDER_FAILED" | "TP_ORDER_FILLED" | "TP_ORDER_FAILED" | "SL_ORDER_FILLED" | "SL_ORDER_FAILED";
+type NotificationCategory = 'TRADE_OPENED_OUTSIDE_PEAR' | 'TRADE_CLOSED_OUTSIDE_PEAR' | 'POSITION_LIQUIDATED' | 'LIMIT_ORDER_FILLED' | 'LIMIT_ORDER_FAILED' | 'TP_ORDER_FILLED' | 'TP_ORDER_FAILED' | 'SL_ORDER_FILLED' | 'SL_ORDER_FAILED';
 interface NotificationDto {
     id: string;
     address: string;
@@ -130,7 +130,7 @@ interface ChunkFillDto {
     size: number;
     executedAt: string;
 }
-type TwapChunkStatus = "PENDING" | "SCHEDULED" | "EXECUTING" | "COMPLETED" | "FAILED" | "CANCELLED";
+type TwapChunkStatus = 'PENDING' | 'SCHEDULED' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED';
 interface TwapChunkStatusDto {
     chunkId: string;
     chunkIndex: number;
@@ -141,7 +141,7 @@ interface TwapChunkStatusDto {
     fills: ChunkFillDto[];
     errorMessage?: string;
 }
-type TwapOrderOverallStatus = "OPEN" | "EXECUTING" | "COMPLETED" | "PARTIALLY_COMPLETED" | "FAILED" | "CANCELLED";
+type TwapOrderOverallStatus = 'OPEN' | 'EXECUTING' | 'COMPLETED' | 'PARTIALLY_COMPLETED' | 'FAILED' | 'CANCELLED';
 interface TwapMonitoringDto {
     orderId: string;
     positionId?: string;
@@ -232,7 +232,7 @@ interface PositionAssetDetailDto {
     collateralToken?: CollateralToken;
 }
 interface TpSlThreshold {
-    type: "PERCENTAGE" | "DOLLAR" | "POSITION_VALUE";
+    type: 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE';
     value: number;
 }
 /**
@@ -267,16 +267,16 @@ interface OrderAssetDto {
 /**
  * Order status
  */
-type OrderStatus = "OPEN" | "PARTIALLY_FILLED" | "PROCESSING";
+type OrderStatus = 'OPEN' | 'PARTIALLY_FILLED' | 'PROCESSING';
 /**
  * Order type
  */
-type OrderType = "TP" | "SL" | "LIMIT" | "MARKET" | "LIMIT_BTCDOM" | "TWAP";
+type OrderType = 'TP' | 'SL' | 'LIMIT' | 'MARKET' | 'LIMIT_BTCDOM' | 'TWAP';
 /**
  * TP/SL trigger type
  */
-type TpSlTriggerType = "PERCENTAGE" | "DOLLAR" | "POSITION_VALUE";
-type OrderDirection = "MORE_THAN" | "LESS_THAN" | null;
+type TpSlTriggerType = 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE';
+type OrderDirection = 'MORE_THAN' | 'LESS_THAN' | null;
 /**
  * Open limit order data structure
  */
@@ -382,7 +382,7 @@ interface RefreshTokenResponse {
     tokenType: string;
     expiresIn: number;
 }
-type AgentWalletStatus = "ACTIVE" | "EXPIRED" | "NOT_FOUND";
+type AgentWalletStatus = 'ACTIVE' | 'EXPIRED' | 'NOT_FOUND';
 interface CreateAgentWalletResponseDto {
     agentWalletAddress: string;
     message: string;
@@ -395,7 +395,7 @@ interface ExtraAgent {
 interface AgentWalletState {
     address: string | null;
     name: string | null;
-    status: AgentWalletStatus | "PENDING" | null;
+    status: AgentWalletStatus | 'PENDING' | null;
     isActive: boolean;
 }
 /**
@@ -415,12 +415,16 @@ interface WebSocketMessage {
 /**
  * WebSocket response from HyperLiquid native API
  */
-type HLChannel = "webData3" | "allMids" | "activeAssetData" | "candle";
+type HLChannel = 'webData3' | 'allMids' | 'activeAssetData' | 'candle' | 'spotState';
 interface HLChannelDataMap {
     webData3: WebData3Response;
     allMids: WsAllMidsData;
     activeAssetData: ActiveAssetData;
     candle: CandleData;
+    spotState: {
+        user: string;
+        spotState: SpotState;
+    };
 }
 interface WebData3UserState {
     agentAddress?: string;
@@ -624,7 +628,7 @@ interface TokenSelection {
  */
 interface TokenConflict {
     symbol: string;
-    conflictType: "long" | "short";
+    conflictType: 'long' | 'short';
     conflictMessage: string;
 }
 interface AssetMarketData {
@@ -686,7 +690,7 @@ interface ActiveAssetsAllResponse {
 /**
  * Candle interval options
  */
-type CandleInterval = "1m" | "3m" | "5m" | "15m" | "30m" | "1h" | "2h" | "4h" | "8h" | "12h" | "1d" | "3d" | "1w" | "1M";
+type CandleInterval = '1m' | '3m' | '5m' | '15m' | '30m' | '1h' | '2h' | '4h' | '8h' | '12h' | '1d' | '3d' | '1w' | '1M';
 /**
  * Candle data structure from WebSocket
  */
@@ -720,6 +724,17 @@ interface TokenSelectorConfig {
     isLong: boolean;
     index: number;
 }
+interface SpotBalance {
+    coin: string;
+    token: number;
+    total: string;
+    hold: string;
+    entryNtl: string;
+}
+interface SpotState {
+    user: string;
+    balances: SpotBalance[];
+}
 
 declare const useAccountSummary: () => {
     data: AccountSummaryResponseDto | null;
@@ -1225,6 +1240,13 @@ declare function useAuth(): {
     readonly logout: () => Promise<void>;
 };
 
+interface SpotBalances {
+    usdhBalance: number | undefined;
+    spotUsdcBalance: number | undefined;
+    isLoading: boolean;
+}
+declare const useSpotBalances: () => SpotBalances;
+
 interface UseHyperliquidWebSocketProps {
     wsUrl: string;
     address: string | null;
@@ -1446,5 +1468,5 @@ declare function isHip3Market(symbol: string): boolean;
 
 declare const useMarketData: any;
 
-export { AccountSummaryCalculator, ConflictDetector, MINIMUM_ASSET_USD_VALUE, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getAvailableMarkets, getCompleteTimestamps, getMarketPrefix, getPortfolio, isHip3Market, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toBackendSymbol, toBackendSymbolWithMarket, toDisplaySymbol, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePerpMetaAssets, usePortfolio, usePosition, useSpotOrder, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMinimumAssetSize, validatePositionSize };
-export type { AccountSummaryResponseDto, ActiveAssetGroupItem, ActiveAssetsResponse, AdjustAdvanceAssetInput, AdjustAdvanceItemInput, AdjustAdvanceResponseDto, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, AutoSyncFillsOptions, AutoSyncFillsState, BalanceSummaryDto, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ClearinghouseState, CloseAllPositionsResponseDto, CloseAllPositionsResultDto, CloseExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CollateralFilter, CollateralToken, CreatePositionRequestInput, CreatePositionResponseDto, CrossMarginSummaryDto, CumFundingDto, ExecutionType, ExtraAgent, HLWebSocketResponse, HistoricalRange, LadderConfigInput, MarginSummaryDto, MarketDataBySymbol, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetDto, PairAssetInput, PerformanceOverlay, PlatformAccountSummaryResponseDto, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, SpotOrderFilledStatus, SpotOrderHyperliquidData, SpotOrderHyperliquidResult, SpotOrderRequestInput, SpotOrderResponseDto, ToggleWatchlistResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, TwapSliceFillResponseItem, UniverseAsset, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseSpotOrderResult, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };
+export { AccountSummaryCalculator, ConflictDetector, MINIMUM_ASSET_USD_VALUE, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getAvailableMarkets, getCompleteTimestamps, getMarketPrefix, getPortfolio, isHip3Market, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toBackendSymbol, toBackendSymbolWithMarket, toDisplaySymbol, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePerpMetaAssets, usePortfolio, usePosition, useSpotBalances, useSpotOrder, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMinimumAssetSize, validatePositionSize };
+export type { AccountSummaryResponseDto, ActiveAssetGroupItem, ActiveAssetsResponse, AdjustAdvanceAssetInput, AdjustAdvanceItemInput, AdjustAdvanceResponseDto, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, AutoSyncFillsOptions, AutoSyncFillsState, BalanceSummaryDto, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ClearinghouseState, CloseAllPositionsResponseDto, CloseAllPositionsResultDto, CloseExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CollateralFilter, CollateralToken, CreatePositionRequestInput, CreatePositionResponseDto, CrossMarginSummaryDto, CumFundingDto, ExecutionType, ExtraAgent, HLWebSocketResponse, HistoricalRange, LadderConfigInput, MarginSummaryDto, MarketDataBySymbol, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetDto, PairAssetInput, PerformanceOverlay, PlatformAccountSummaryResponseDto, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, SpotBalance, SpotOrderFilledStatus, SpotOrderHyperliquidData, SpotOrderHyperliquidResult, SpotOrderRequestInput, SpotOrderResponseDto, SpotState, ToggleWatchlistResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, TwapSliceFillResponseItem, UniverseAsset, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseSpotOrderResult, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };

package/dist/index.js

@@ -23,6 +23,7 @@ const useUserData = create((set) => ({
     twapDetails: null,
     notifications: null,
     userExtraAgents: null,
+    spotState: null,
     setAccessToken: (token) => set({ accessToken: token }),
     setRefreshToken: (token) => set({ refreshToken: token }),
     setIsAuthenticated: (value) => set({ isAuthenticated: value }),
@@ -43,6 +44,7 @@ const useUserData = create((set) => ({
     setAccountSummary: (value) => set({ accountSummary: value }),
     setTwapDetails: (value) => set({ twapDetails: value }),
     setNotifications: (value) => set({ notifications: value }),
+    setSpotState: (value) => set({ spotState: value }),
     clean: () => set({
         accessToken: null,
         refreshToken: null,
@@ -54,6 +56,7 @@ const useUserData = create((set) => ({
         accountSummary: null,
         twapDetails: null,
         notifications: null,
+        spotState: null,
     }),
     setUserExtraAgents: (value) => set({ userExtraAgents: value }),
 }));
@@ -559,6 +562,7 @@ const useUserSelection$1 = create((set, get) => ({
 
 const useHyperliquidNativeWebSocket = ({ address, enabled = true, }) => {
     const { setAllMids, setActiveAssetData, upsertActiveAssetData, setCandleData, deleteCandleSymbol, deleteActiveAssetData, addCandleData, setFinalAssetContexts, setFinalAtOICaps, setAggregatedClearingHouseState, } = useHyperliquidData();
+    const { setSpotState } = useUserData();
     const { candleInterval } = useUserSelection$1();
     const longTokens = useUserSelection$1((s) => s.longTokens);
     const shortTokens = useUserSelection$1((s) => s.shortTokens);
@@ -680,6 +684,14 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, }) => {
                             addCandleData(symbol, normalized);
                         }
                         break;
+                    case 'spotState':
+                        {
+                            const spotStateData = response.data;
+                            if (spotStateData === null || spotStateData === void 0 ? void 0 : spotStateData.spotState) {
+                                setSpotState(spotStateData.spotState);
+                            }
+                        }
+                        break;
                     default:
                         console.warn(`[HyperLiquid WS] Unknown channel: ${response.channel}`);
                 }
@@ -697,6 +709,7 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, }) => {
         setFinalAssetContexts,
         setFinalAtOICaps,
         setAggregatedClearingHouseState,
+        setSpotState,
     ]);
     const connect = useCallback(() => {
         if (!enabled)
@@ -795,6 +808,17 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, }) => {
                 },
             };
             sendJsonMessage(unsubscribeMessage);
+            // Unsubscribe from spotState for previous address
+            if (subscribedAddress !== DEFAULT_ADDRESS) {
+                const unsubscribeSpotState = {
+                    method: 'unsubscribe',
+                    subscription: {
+                        type: 'spotState',
+                        user: subscribedAddress,
+                    },
+                };
+                sendJsonMessage(unsubscribeSpotState);
+            }
         }
         // Subscribe to webData3 with new address
         const subscribeWebData3 = {
@@ -814,11 +838,25 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, }) => {
         };
         sendJsonMessage(subscribeWebData3);
         sendJsonMessage(subscribeAllMids);
+        // Subscribe to spotState for real-time spot balances (USDH, USDC, etc.)
+        // Only subscribe if we have a real user address (not the default)
+        if (userAddress !== DEFAULT_ADDRESS) {
+            const subscribeSpotState = {
+                method: 'subscribe',
+                subscription: {
+                    type: 'spotState',
+                    user: userAddress,
+                },
+            };
+            sendJsonMessage(subscribeSpotState);
+        }
         setSubscribedAddress(userAddress);
         // Clear previous data when address changes
         if (subscribedAddress && subscribedAddress !== userAddress) {
             // clear aggregatedClearingHouseState
             setAggregatedClearingHouseState(null);
+            // clear spotState
+            setSpotState(null);
         }
     }, [
         isConnected,
@@ -826,6 +864,7 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, }) => {
         subscribedAddress,
         sendJsonMessage,
         setAggregatedClearingHouseState,
+        setSpotState,
     ]);
     // Handle token subscriptions for activeAssetData
     useEffect(() => {
@@ -7701,6 +7740,35 @@ function useAuth() {
     };
 }
 
+const useSpotBalances = () => {
+    const spotState = useUserData((state) => state.spotState);
+    return useMemo(() => {
+        if (!spotState) {
+            return {
+                usdhBalance: undefined,
+                spotUsdcBalance: undefined,
+                isLoading: true,
+            };
+        }
+        const balances = spotState.balances || [];
+        let usdhBal = 0;
+        let spotUsdcBal = 0;
+        for (const balance of balances) {
+            if (balance.coin === 'USDH') {
+                usdhBal = parseFloat(balance.hold || '0') + parseFloat(balance.total || '0');
+            }
+            if (balance.coin === 'USDC') {
+                spotUsdcBal = parseFloat(balance.hold || '0') + parseFloat(balance.total || '0');
+            }
+        }
+        return {
+            usdhBalance: usdhBal,
+            spotUsdcBalance: spotUsdcBal,
+            isLoading: false,
+        };
+    }, [spotState]);
+};
+
 const PearHyperliquidContext = createContext(undefined);
 /**
  * React Provider for PearHyperliquidClient
@@ -7731,6 +7799,8 @@ const PearHyperliquidProvider = ({ children, apiBaseUrl = "https://hl-v2.pearpro
                 const marketPrefixes = new Map(); // "xyz:TSLA" -> "xyz"
                 const cleanedPerpMetas = [];
                 // Process each market group (different collateral tokens)
+                // Filter out vntl HIP-3 assets from being sent to frontend
+                const FILTERED_PREFIXES = ['vntl'];
                 res.data.forEach((item) => {
                     // Convert numeric collateral token to human-readable name
                     const collateralToken = item.collateralToken === 360 ? "USDH" : "USDC";
@@ -7740,6 +7810,10 @@ const PearHyperliquidProvider = ({ children, apiBaseUrl = "https://hl-v2.pearpro
                         if (maybeMarket) {
                             // HIP-3 market with prefix (e.g., "xyz:TSLA")
                             const prefix = maybePrefix.toLowerCase();
+                            // Skip filtered prefixes (e.g., vntl)
+                            if (FILTERED_PREFIXES.includes(prefix)) {
+                                return;
+                            }
                             const displayName = maybeMarket;
                             const fullName = `${prefix}:${displayName}`;
                             // Store full market name with prefix
@@ -7911,4 +7985,4 @@ function mapCandleIntervalToTradingViewInterval(interval) {
     }
 }
 
-export { AccountSummaryCalculator, ConflictDetector, MINIMUM_ASSET_USD_VALUE, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getAvailableMarkets, getCompleteTimestamps, getMarketPrefix, getPortfolio, isHip3Market, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toBackendSymbol, toBackendSymbolWithMarket, toDisplaySymbol, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePerpMetaAssets, usePortfolio, usePosition, useSpotOrder, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMinimumAssetSize, validatePositionSize };
+export { AccountSummaryCalculator, ConflictDetector, MINIMUM_ASSET_USD_VALUE, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getAvailableMarkets, getCompleteTimestamps, getMarketPrefix, getPortfolio, isHip3Market, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toBackendSymbol, toBackendSymbolWithMarket, toDisplaySymbol, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePerpMetaAssets, usePortfolio, usePosition, useSpotBalances, useSpotOrder, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMinimumAssetSize, validatePositionSize };

package/dist/types.d.ts

@@ -20,7 +20,7 @@ export interface ExternalFillDto {
     coin: string;
     px: string;
     sz: string;
-    side: "B" | "A";
+    side: 'B' | 'A';
     time: number;
     dir: string;
     fee: string;
@@ -52,7 +52,7 @@ export interface TwapSliceFillResponseItem {
 /**
  * WebSocket connection states
  */
-export type WebSocketConnectionState = "connecting" | "connected" | "disconnected" | "error";
+export type WebSocketConnectionState = 'connecting' | 'connected' | 'disconnected' | 'error';
 export declare enum ReadyState {
     CONNECTING = 0,
     OPEN = 1,
@@ -62,12 +62,12 @@ export declare enum ReadyState {
 /**
  * WebSocket channels
  */
-export type WebSocketChannel = "trade-histories" | "open-positions" | "open-orders" | "account-summary" | "twap-details" | "notifications" | "market-data" | "market-data-all" | "webData3" | "allMids" | "activeAssetData";
+export type WebSocketChannel = 'trade-histories' | 'open-positions' | 'open-orders' | 'account-summary' | 'twap-details' | 'notifications' | 'market-data' | 'market-data-all' | 'webData3' | 'allMids' | 'activeAssetData';
 /**
  * WebSocket subscription message
  */
 export interface WebSocketSubscribeMessage {
-    action?: "subscribe" | "unsubscribe";
+    action?: 'subscribe' | 'unsubscribe';
     address: string;
 }
 /**
@@ -97,7 +97,7 @@ export interface WatchlistItemDto {
 export interface ToggleWatchlistResponseDto {
     items: WatchlistItemDto[];
 }
-export type NotificationCategory = "TRADE_OPENED_OUTSIDE_PEAR" | "TRADE_CLOSED_OUTSIDE_PEAR" | "POSITION_LIQUIDATED" | "LIMIT_ORDER_FILLED" | "LIMIT_ORDER_FAILED" | "TP_ORDER_FILLED" | "TP_ORDER_FAILED" | "SL_ORDER_FILLED" | "SL_ORDER_FAILED";
+export type NotificationCategory = 'TRADE_OPENED_OUTSIDE_PEAR' | 'TRADE_CLOSED_OUTSIDE_PEAR' | 'POSITION_LIQUIDATED' | 'LIMIT_ORDER_FILLED' | 'LIMIT_ORDER_FAILED' | 'TP_ORDER_FILLED' | 'TP_ORDER_FAILED' | 'SL_ORDER_FILLED' | 'SL_ORDER_FAILED';
 export interface NotificationDto {
     id: string;
     address: string;
@@ -114,7 +114,7 @@ export interface ChunkFillDto {
     size: number;
     executedAt: string;
 }
-export type TwapChunkStatus = "PENDING" | "SCHEDULED" | "EXECUTING" | "COMPLETED" | "FAILED" | "CANCELLED";
+export type TwapChunkStatus = 'PENDING' | 'SCHEDULED' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED';
 export interface TwapChunkStatusDto {
     chunkId: string;
     chunkIndex: number;
@@ -125,7 +125,7 @@ export interface TwapChunkStatusDto {
     fills: ChunkFillDto[];
     errorMessage?: string;
 }
-export type TwapOrderOverallStatus = "OPEN" | "EXECUTING" | "COMPLETED" | "PARTIALLY_COMPLETED" | "FAILED" | "CANCELLED";
+export type TwapOrderOverallStatus = 'OPEN' | 'EXECUTING' | 'COMPLETED' | 'PARTIALLY_COMPLETED' | 'FAILED' | 'CANCELLED';
 export interface TwapMonitoringDto {
     orderId: string;
     positionId?: string;
@@ -216,7 +216,7 @@ export interface PositionAssetDetailDto {
     collateralToken?: CollateralToken;
 }
 export interface TpSlThreshold {
-    type: "PERCENTAGE" | "DOLLAR" | "POSITION_VALUE";
+    type: 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE';
     value: number;
 }
 /**
@@ -251,16 +251,16 @@ export interface OrderAssetDto {
 /**
  * Order status
  */
-export type OrderStatus = "OPEN" | "PARTIALLY_FILLED" | "PROCESSING";
+export type OrderStatus = 'OPEN' | 'PARTIALLY_FILLED' | 'PROCESSING';
 /**
  * Order type
  */
-export type OrderType = "TP" | "SL" | "LIMIT" | "MARKET" | "LIMIT_BTCDOM" | "TWAP";
+export type OrderType = 'TP' | 'SL' | 'LIMIT' | 'MARKET' | 'LIMIT_BTCDOM' | 'TWAP';
 /**
  * TP/SL trigger type
  */
-export type TpSlTriggerType = "PERCENTAGE" | "DOLLAR" | "POSITION_VALUE";
-export type OrderDirection = "MORE_THAN" | "LESS_THAN" | null;
+export type TpSlTriggerType = 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE';
+export type OrderDirection = 'MORE_THAN' | 'LESS_THAN' | null;
 /**
  * Open limit order data structure
  */
@@ -374,7 +374,7 @@ export interface PrivyAuthDetails {
     accessToken: string;
 }
 export interface AuthenticateRequest {
-    method: "eip712" | "api_key" | "privy_access_token";
+    method: 'eip712' | 'api_key' | 'privy_access_token';
     address: string;
     clientId: string;
     details: {
@@ -407,7 +407,7 @@ export interface LogoutRequest {
 export interface LogoutResponse {
     message: string;
 }
-export type AgentWalletStatus = "ACTIVE" | "EXPIRED" | "NOT_FOUND";
+export type AgentWalletStatus = 'ACTIVE' | 'EXPIRED' | 'NOT_FOUND';
 export interface GetAgentWalletResponseDto {
     agentWalletAddress?: string;
     agentName: string;
@@ -425,7 +425,7 @@ export interface ExtraAgent {
 export interface AgentWalletState {
     address: string | null;
     name: string | null;
-    status: AgentWalletStatus | "PENDING" | null;
+    status: AgentWalletStatus | 'PENDING' | null;
     isActive: boolean;
 }
 /**
@@ -445,12 +445,16 @@ export interface WebSocketMessage {
 /**
  * WebSocket response from HyperLiquid native API
  */
-export type HLChannel = "webData3" | "allMids" | "activeAssetData" | "candle";
+export type HLChannel = 'webData3' | 'allMids' | 'activeAssetData' | 'candle' | 'spotState';
 export interface HLChannelDataMap {
     webData3: WebData3Response;
     allMids: WsAllMidsData;
     activeAssetData: ActiveAssetData;
     candle: CandleData;
+    spotState: {
+        user: string;
+        spotState: SpotState;
+    };
 }
 export interface WebData3UserState {
     agentAddress?: string;
@@ -672,7 +676,7 @@ export interface TokenSelection {
  */
 export interface TokenConflict {
     symbol: string;
-    conflictType: "long" | "short";
+    conflictType: 'long' | 'short';
     conflictMessage: string;
 }
 export interface AssetMarketData {
@@ -734,7 +738,7 @@ export interface ActiveAssetsAllResponse {
 /**
  * Candle interval options
  */
-export type CandleInterval = "1m" | "3m" | "5m" | "15m" | "30m" | "1h" | "2h" | "4h" | "8h" | "12h" | "1d" | "3d" | "1w" | "1M";
+export type CandleInterval = '1m' | '3m' | '5m' | '15m' | '30m' | '1h' | '2h' | '4h' | '8h' | '12h' | '1d' | '3d' | '1w' | '1M';
 /**
  * Candle data structure from WebSocket
  */
@@ -768,3 +772,14 @@ export interface TokenSelectorConfig {
     isLong: boolean;
     index: number;
 }
+export interface SpotBalance {
+    coin: string;
+    token: number;
+    total: string;
+    hold: string;
+    entryNtl: string;
+}
+export interface SpotState {
+    user: string;
+    balances: SpotBalance[];
+}

package/package.json

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