@pear-protocol/hyperliquid-sdk 0.0.48 → 0.0.49-hip3-alpha

package/dist/clients/hyperliquid.d.ts

@@ -1,4 +1,4 @@
-import type { ApiResponse, CandleInterval, CandleData, ExternalFillDto } from '../types';
+import type { ApiResponse, CandleInterval, CandleData, ExternalFillDto, AllPerpMetasResponse } from '../types';
 /**
  * Fetch historical candle data from HyperLiquid API
  */
@@ -7,3 +7,9 @@ export declare const fetchHistoricalCandles: (coin: string, startTime: number, e
  * Retrieve recent user fills from HyperLiquid and map to ExternalFillDto[]
  */
 export declare const fetchUserFillsFromHyperliquid: (user: string, startTime: number, aggregateByTime?: boolean) => Promise<ApiResponse<ExternalFillDto[]>>;
+/**
+ * Fetch all perp metas from HyperLiquid API
+ * Endpoint: https://api.hyperliquid.xyz/info
+ * Payload: { "type": "allPerpMetas" }
+ */
+export declare const fetchAllPerpMetas: () => Promise<ApiResponse<AllPerpMetasResponse>>;

package/dist/index.d.ts

@@ -28,7 +28,7 @@ type WebSocketConnectionState = 'connecting' | 'connected' | 'disconnected' | 'e
 /**
  * WebSocket channels
  */
-type WebSocketChannel = 'trade-histories' | 'open-positions' | 'open-orders' | 'account-summary' | 'twap-details' | 'notifications' | 'market-data' | 'market-data-all' | 'webData2' | '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
  */
@@ -323,6 +323,7 @@ interface WebSocketMessage {
     method: "subscribe" | "unsubscribe";
     subscription: {
         type: string;
+        dex?: string;
         coin?: string;
         interval?: string;
         user?: string;
@@ -332,13 +333,44 @@ interface WebSocketMessage {
 /**
  * WebSocket response from HyperLiquid native API
  */
-type HLChannel = 'webData2' | 'allMids' | 'activeAssetData' | 'candle';
+type HLChannel = 'webData3' | 'allMids' | 'activeAssetData' | 'candle';
 interface HLChannelDataMap {
-    webData2: WebData2Response;
+    webData3: WebData3Response;
     allMids: WsAllMidsData;
     activeAssetData: ActiveAssetData;
     candle: CandleData;
 }
+interface WebData3UserState {
+    agentAddress?: string;
+    agentValidUntil?: number;
+    cumLedger: string;
+    serverTime: number;
+    isVault: boolean;
+    user: string;
+    dexAbstractionEnabled?: boolean;
+}
+interface WebData3AssetCtx {
+    funding: string;
+    openInterest: string;
+    prevDayPx: string;
+    dayNtlVlm: string;
+    premium: string | null;
+    oraclePx: string;
+    markPx: string;
+    midPx: string | null;
+    impactPxs: string[] | null;
+    dayBaseVlm: string;
+}
+interface WebData3PerpDexState {
+    clearinghouseState: ClearinghouseState;
+    totalVaultEquity: string;
+    assetCtxs: WebData3AssetCtx[];
+    perpsAtOpenInterestCap: string[];
+}
+interface WebData3Response {
+    userState: WebData3UserState;
+    perpDexStates: WebData3PerpDexState[];
+}
 interface HLWebSocketResponse<T extends HLChannel = HLChannel> {
     channel: T;
     data: HLChannelDataMap[T];
@@ -372,17 +404,6 @@ interface UniverseAsset {
     onlyIsolated?: boolean;
     isDelisted?: boolean;
 }
-/**
- * WebData2 response structure
- */
-interface WebData2Response {
-    assetCtxs: AssetCtx[];
-    meta: {
-        universe: UniverseAsset[];
-    };
-    clearinghouseState: ClearinghouseState;
-    perpsAtOpenInterestCap?: string[];
-}
 interface ClearinghouseState {
     assetPositions: AssetPosition[];
     crossMaintenanceMarginUsed: string;
@@ -484,9 +505,6 @@ interface ActiveAssetData {
     availableToTrade: [string, string];
     markPx: string;
 }
-/**
- * Token metadata from WebData2 and AllMids
- */
 interface TokenMetadata {
     currentPrice: number;
     prevDayPrice: number;
@@ -518,7 +536,7 @@ interface TokenConflict {
     conflictMessage: string;
 }
 interface AssetMarketData {
-    asset: AssetCtx;
+    asset: WebData3AssetCtx | AssetCtx;
     universe: UniverseAsset;
 }
 interface PairAssetDto {
@@ -1118,19 +1136,16 @@ declare function toggleWatchlist(baseUrl: string, accessToken: string, longAsset
  * Account summary calculation utility class
  */
 declare class AccountSummaryCalculator {
-    private webData2;
-    constructor(webData2: WebData2Response | null);
+    private clearinghouseState;
+    constructor(clearinghouseState: ClearinghouseState | null);
     /**
-     * Calculate account summary from webData2 and platform orders
+     * Calculate account summary from real-time clearinghouse state and platform orders
      */
     calculateAccountSummary(platformAccountSummary: AccountSummaryResponseDto | null, platformOpenOrders: OpenLimitOrderDto[] | null, agentWalletAddress?: string, agentWalletStatus?: string): AccountSummaryResponseDto | null;
     /**
      * Calculate total USD value of open limit orders
      */
     private calculateTotalLimitOrderValue;
-    /**
-     * Get real-time clearinghouse state from webData2
-     */
     getClearinghouseState(): ClearinghouseState | null;
     /**
      * Check if real-time data is available
@@ -1153,34 +1168,36 @@ declare class ConflictDetector {
 }
 
 /**
- * Extracts token metadata from WebData2 and AllMids data
+ * Extracts token metadata from aggregated WebData3 contexts and AllMids data
  */
 declare class TokenMetadataExtractor {
     /**
      * Extracts comprehensive token metadata
      * @param symbol - Token symbol
-     * @param webData2 - WebData2 response containing asset context and universe data
+     * @param perpMetaAssets - Aggregated universe assets (flattened across dexes)
+     * @param finalAssetContexts - Aggregated asset contexts (flattened across dexes)
      * @param allMids - AllMids data containing current prices
      * @param activeAssetData - Optional active asset data containing leverage information
      * @returns TokenMetadata or null if token not found
      */
-    static extractTokenMetadata(symbol: string, webData2: WebData2Response | null, allMids: WsAllMidsData | null, activeAssetData?: Record<string, ActiveAssetData> | null): TokenMetadata | null;
+    static extractTokenMetadata(symbol: string, perpMetaAssets: UniverseAsset[] | null, finalAssetContexts: WebData3AssetCtx[] | null, allMids: WsAllMidsData | null, activeAssetData?: Record<string, ActiveAssetData> | null): TokenMetadata | null;
     /**
      * Extracts metadata for multiple tokens
      * @param symbols - Array of token symbols
-     * @param webData2 - WebData2 response
+     * @param perpMetaAssets - Aggregated universe assets
+     * @param finalAssetContexts - Aggregated asset contexts
      * @param allMids - AllMids data
      * @param activeAssetData - Optional active asset data containing leverage information
      * @returns Record of symbol to TokenMetadata
      */
-    static extractMultipleTokensMetadata(symbols: string[], webData2: WebData2Response | null, allMids: WsAllMidsData | null, activeAssetData?: Record<string, ActiveAssetData> | null): Record<string, TokenMetadata | null>;
+    static extractMultipleTokensMetadata(symbols: string[], perpMetaAssets: UniverseAsset[] | null, finalAssetContexts: WebData3AssetCtx[] | null, allMids: WsAllMidsData | null, activeAssetData?: Record<string, ActiveAssetData> | null): Record<string, TokenMetadata | null>;
     /**
-     * Checks if token data is available in WebData2
+     * Checks if token data is available in aggregated universe assets
      * @param symbol - Token symbol
-     * @param webData2 - WebData2 response
+     * @param perpMetaAssets - Aggregated universe assets
      * @returns boolean indicating if token exists in universe
      */
-    static isTokenAvailable(symbol: string, webData2: WebData2Response | null): boolean;
+    static isTokenAvailable(symbol: string, perpMetaAssets: UniverseAsset[] | null): boolean;
 }
 
 /**
@@ -1260,4 +1277,4 @@ declare function validatePositionSize(usdValue: number, longAssets?: PairAssetIn
 declare const useMarketData: any;
 
 export { AccountSummaryCalculator, AuthStatus, ConflictDetector, MINIMUM_ASSET_USD_VALUE, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, getPortfolio, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAddress, useAgentWallet, useAllBaskets, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePortfolio, usePosition, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMinimumAssetSize, validatePositionSize };
-export type { AccountSummaryResponseDto, ActiveAssetGroupItem, ActiveAssetsResponse, 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, CreatePositionRequestInput, CreatePositionResponseDto, CrossMarginSummaryDto, CumFundingDto, ExecutionType, HLWebSocketResponse, HistoricalRange, LadderConfigInput, MarginSummaryDto, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetDto, PairAssetInput, PerformanceOverlay, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, ToggleWatchlistResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, UniverseAsset, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAgentWalletOptions, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebData2Response, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };
+export type { AccountSummaryResponseDto, ActiveAssetGroupItem, ActiveAssetsResponse, 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, CreatePositionRequestInput, CreatePositionResponseDto, CrossMarginSummaryDto, CumFundingDto, ExecutionType, HLWebSocketResponse, HistoricalRange, LadderConfigInput, MarginSummaryDto, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetDto, PairAssetInput, PerformanceOverlay, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, ToggleWatchlistResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, UniverseAsset, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAgentWalletOptions, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };

package/dist/index.js

@@ -225,11 +225,13 @@ const useHyperliquidWebSocket = ({ wsUrl, address }) => {
 };
 
 const useHyperliquidData = create((set, get) => ({
-    webData2: null,
     allMids: null,
     activeAssetData: null,
     candleData: null,
-    setWebData2: (value) => set({ webData2: value }),
+    finalAssetContexts: null,
+    finalAtOICaps: null,
+    aggregatedClearingHouseState: null,
+    perpMetaAssets: null,
     setAllMids: (value) => set({ allMids: value }),
     setActiveAssetData: (value) => set((state) => ({
         activeAssetData: typeof value === 'function' ? value(state.activeAssetData) : value
@@ -268,7 +270,11 @@ const useHyperliquidData = create((set, get) => ({
             ...state.activeAssetData,
             [key]: value,
         }
-    }))
+    })),
+    setFinalAssetContexts: (value) => set({ finalAssetContexts: value }),
+    setFinalAtOICaps: (value) => set({ finalAtOICaps: value }),
+    setAggregatedClearingHouseState: (value) => set({ aggregatedClearingHouseState: value }),
+    setPerpMetaAssets: (value) => set({ perpMetaAssets: value })
 }));
 
 const DEFAULT_STATE = {
@@ -409,7 +415,7 @@ const useUserSelection$1 = create((set, get) => ({
 }));
 
 const useHyperliquidNativeWebSocket = ({ address, }) => {
-    const { setWebData2, setAllMids, setActiveAssetData, upsertActiveAssetData, setCandleData, deleteCandleSymbol, deleteActiveAssetData, addCandleData } = useHyperliquidData();
+    const { setAllMids, setActiveAssetData, upsertActiveAssetData, setCandleData, deleteCandleSymbol, deleteActiveAssetData, addCandleData, setFinalAssetContexts, setFinalAtOICaps, setAggregatedClearingHouseState } = useHyperliquidData();
     const { candleInterval } = useUserSelection$1();
     const longTokens = useUserSelection$1((s) => s.longTokens);
     const shortTokens = useUserSelection$1((s) => s.shortTokens);
@@ -442,8 +448,44 @@ const useHyperliquidNativeWebSocket = ({ address, }) => {
             if ('channel' in message && 'data' in message) {
                 const response = message;
                 switch (response.channel) {
-                    case 'webData2':
-                        setWebData2(response.data);
+                    case 'webData3':
+                        const webData3 = response.data;
+                        const finalAssetContexts = webData3.perpDexStates.flatMap((dex) => dex.assetCtxs);
+                        const finalAtOICaps = webData3.perpDexStates.flatMap((dex) => dex.perpsAtOpenInterestCap);
+                        const aggregatedClearingHouseState = (() => {
+                            const states = webData3.perpDexStates
+                                .map((dex) => dex.clearinghouseState)
+                                .filter(Boolean);
+                            const sum = (values) => values.reduce((acc, v) => acc + (parseFloat(v || '0') || 0), 0);
+                            const toStr = (n) => (Number.isFinite(n) ? n.toString() : '0');
+                            const assetPositions = states.flatMap((s) => s.assetPositions || []);
+                            const crossMaintenanceMarginUsed = toStr(sum(states.map((s) => s.crossMaintenanceMarginUsed)));
+                            const crossMarginSummary = {
+                                accountValue: toStr(sum(states.map((s) => { var _a; return (_a = s.crossMarginSummary) === null || _a === void 0 ? void 0 : _a.accountValue; }))),
+                                totalMarginUsed: toStr(sum(states.map((s) => { var _a; return (_a = s.crossMarginSummary) === null || _a === void 0 ? void 0 : _a.totalMarginUsed; }))),
+                                totalNtlPos: toStr(sum(states.map((s) => { var _a; return (_a = s.crossMarginSummary) === null || _a === void 0 ? void 0 : _a.totalNtlPos; }))),
+                                totalRawUsd: toStr(sum(states.map((s) => { var _a; return (_a = s.crossMarginSummary) === null || _a === void 0 ? void 0 : _a.totalRawUsd; }))),
+                            };
+                            const marginSummary = {
+                                accountValue: toStr(sum(states.map((s) => { var _a; return (_a = s.marginSummary) === null || _a === void 0 ? void 0 : _a.accountValue; }))),
+                                totalMarginUsed: toStr(sum(states.map((s) => { var _a; return (_a = s.marginSummary) === null || _a === void 0 ? void 0 : _a.totalMarginUsed; }))),
+                                totalNtlPos: toStr(sum(states.map((s) => { var _a; return (_a = s.marginSummary) === null || _a === void 0 ? void 0 : _a.totalNtlPos; }))),
+                                totalRawUsd: toStr(sum(states.map((s) => { var _a; return (_a = s.marginSummary) === null || _a === void 0 ? void 0 : _a.totalRawUsd; }))),
+                            };
+                            const withdrawable = toStr(sum(states.map((s) => s.withdrawable)));
+                            const time = Math.max(0, ...states.map((s) => s.time || 0));
+                            return {
+                                assetPositions,
+                                crossMaintenanceMarginUsed,
+                                crossMarginSummary,
+                                marginSummary,
+                                time,
+                                withdrawable,
+                            };
+                        })();
+                        setFinalAssetContexts(finalAssetContexts);
+                        setFinalAtOICaps(finalAtOICaps);
+                        setAggregatedClearingHouseState(aggregatedClearingHouseState);
                         break;
                     case 'allMids':
                         setAllMids(response.data);
@@ -466,7 +508,7 @@ const useHyperliquidNativeWebSocket = ({ address, }) => {
             console.error('[HyperLiquid WS] Parse error:', errorMessage, 'Raw message:', event.data);
             setLastError(errorMessage);
         }
-    }, [setWebData2, setAllMids, upsertActiveAssetData, addCandleData]);
+    }, [setAllMids, upsertActiveAssetData, addCandleData, setFinalAssetContexts, setFinalAtOICaps, setAggregatedClearingHouseState]);
     const connect = useCallback(() => {
         try {
             manualCloseRef.current = false;
@@ -551,17 +593,17 @@ const useHyperliquidNativeWebSocket = ({ address, }) => {
             const unsubscribeMessage = {
                 method: 'unsubscribe',
                 subscription: {
-                    type: 'webData2',
+                    type: 'webData3',
                     user: subscribedAddress,
                 },
             };
             sendJsonMessage(unsubscribeMessage);
         }
-        // Subscribe to webData2 with new address
-        const subscribeWebData2 = {
+        // Subscribe to webData3 with new address
+        const subscribeWebData3 = {
             method: 'subscribe',
             subscription: {
-                type: 'webData2',
+                type: 'webData3',
                 user: userAddress,
             },
         };
@@ -570,16 +612,18 @@ const useHyperliquidNativeWebSocket = ({ address, }) => {
             method: 'subscribe',
             subscription: {
                 type: 'allMids',
+                dex: 'ALL_DEXS',
             },
         };
-        sendJsonMessage(subscribeWebData2);
+        sendJsonMessage(subscribeWebData3);
         sendJsonMessage(subscribeAllMids);
         setSubscribedAddress(userAddress);
         // Clear previous data when address changes
         if (subscribedAddress && subscribedAddress !== userAddress) {
-            setWebData2(null);
+            // clear aggregatedClearingHouseState
+            setAggregatedClearingHouseState(null);
         }
-    }, [isConnected, address, subscribedAddress, sendJsonMessage, setWebData2]);
+    }, [isConnected, address, subscribedAddress, sendJsonMessage, setAggregatedClearingHouseState]);
     // Handle token subscriptions for activeAssetData
     useEffect(() => {
         if (!isConnected || !address)
@@ -4709,45 +4753,45 @@ const useAddress = () => {
  * Account summary calculation utility class
  */
 class AccountSummaryCalculator {
-    constructor(webData2) {
-        this.webData2 = webData2;
+    constructor(clearinghouseState) {
+        this.clearinghouseState = clearinghouseState;
     }
     /**
-     * Calculate account summary from webData2 and platform orders
+     * Calculate account summary from real-time clearinghouse state and platform orders
      */
     calculateAccountSummary(platformAccountSummary, platformOpenOrders, agentWalletAddress, agentWalletStatus) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
-        // If we don't have webData2, return platform data as-is
-        if (!((_a = this.webData2) === null || _a === void 0 ? void 0 : _a.clearinghouseState)) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+        // If we don't have real-time state, return platform data as-is
+        if (!this.clearinghouseState) {
             return platformAccountSummary;
         }
-        const clearinghouseState = this.webData2.clearinghouseState;
+        const clearinghouseState = this.clearinghouseState;
         // Calculate total limit order value from platform orders
         const totalLimitOrderValue = this.calculateTotalLimitOrderValue(platformOpenOrders || []);
-        // Use real-time data from webData2 clearinghouseState
+        // Use real-time data from clearinghouseState
         const withdrawableAmount = parseFloat(clearinghouseState.withdrawable || '0');
         const adjustedWithdrawable = Math.max(0, withdrawableAmount - totalLimitOrderValue);
         const accountSummary = {
             balanceSummary: {
                 crossMaintenanceMarginUsed: clearinghouseState.crossMaintenanceMarginUsed || '0',
                 crossMarginSummary: {
-                    accountValue: ((_b = clearinghouseState.crossMarginSummary) === null || _b === void 0 ? void 0 : _b.accountValue) || '0',
-                    totalMarginUsed: ((_c = clearinghouseState.crossMarginSummary) === null || _c === void 0 ? void 0 : _c.totalMarginUsed) || '0',
-                    totalNtlPos: ((_d = clearinghouseState.crossMarginSummary) === null || _d === void 0 ? void 0 : _d.totalNtlPos) || '0',
-                    totalRawUsd: ((_e = clearinghouseState.crossMarginSummary) === null || _e === void 0 ? void 0 : _e.totalRawUsd) || '0'
+                    accountValue: ((_a = clearinghouseState.crossMarginSummary) === null || _a === void 0 ? void 0 : _a.accountValue) || '0',
+                    totalMarginUsed: ((_b = clearinghouseState.crossMarginSummary) === null || _b === void 0 ? void 0 : _b.totalMarginUsed) || '0',
+                    totalNtlPos: ((_c = clearinghouseState.crossMarginSummary) === null || _c === void 0 ? void 0 : _c.totalNtlPos) || '0',
+                    totalRawUsd: ((_d = clearinghouseState.crossMarginSummary) === null || _d === void 0 ? void 0 : _d.totalRawUsd) || '0'
                 },
                 marginSummary: {
-                    accountValue: ((_f = clearinghouseState.marginSummary) === null || _f === void 0 ? void 0 : _f.accountValue) || '0',
-                    totalMarginUsed: ((_g = clearinghouseState.marginSummary) === null || _g === void 0 ? void 0 : _g.totalMarginUsed) || '0',
-                    totalNtlPos: ((_h = clearinghouseState.marginSummary) === null || _h === void 0 ? void 0 : _h.totalNtlPos) || '0',
-                    totalRawUsd: ((_j = clearinghouseState.marginSummary) === null || _j === void 0 ? void 0 : _j.totalRawUsd) || '0'
+                    accountValue: ((_e = clearinghouseState.marginSummary) === null || _e === void 0 ? void 0 : _e.accountValue) || '0',
+                    totalMarginUsed: ((_f = clearinghouseState.marginSummary) === null || _f === void 0 ? void 0 : _f.totalMarginUsed) || '0',
+                    totalNtlPos: ((_g = clearinghouseState.marginSummary) === null || _g === void 0 ? void 0 : _g.totalNtlPos) || '0',
+                    totalRawUsd: ((_h = clearinghouseState.marginSummary) === null || _h === void 0 ? void 0 : _h.totalRawUsd) || '0'
                 },
                 time: clearinghouseState.time || Date.now(),
                 withdrawable: adjustedWithdrawable.toString()
             },
             agentWallet: {
-                address: agentWalletAddress || ((_k = platformAccountSummary === null || platformAccountSummary === void 0 ? void 0 : platformAccountSummary.agentWallet) === null || _k === void 0 ? void 0 : _k.address) || '',
-                status: agentWalletStatus || ((_l = platformAccountSummary === null || platformAccountSummary === void 0 ? void 0 : platformAccountSummary.agentWallet) === null || _l === void 0 ? void 0 : _l.status) || 'UNKNOWN'
+                address: agentWalletAddress || ((_j = platformAccountSummary === null || platformAccountSummary === void 0 ? void 0 : platformAccountSummary.agentWallet) === null || _j === void 0 ? void 0 : _j.address) || '',
+                status: agentWalletStatus || ((_k = platformAccountSummary === null || platformAccountSummary === void 0 ? void 0 : platformAccountSummary.agentWallet) === null || _k === void 0 ? void 0 : _k.status) || 'UNKNOWN'
             }
         };
         return accountSummary;
@@ -4764,19 +4808,14 @@ class AccountSummaryCalculator {
             .reduce((sum, order) => sum + order.usdValue / order.leverage, 0);
         return totalValue;
     }
-    /**
-     * Get real-time clearinghouse state from webData2
-     */
     getClearinghouseState() {
-        var _a;
-        return ((_a = this.webData2) === null || _a === void 0 ? void 0 : _a.clearinghouseState) || null;
+        return this.clearinghouseState || null;
     }
     /**
      * Check if real-time data is available
      */
     hasRealTimeData() {
-        var _a;
-        return !!((_a = this.webData2) === null || _a === void 0 ? void 0 : _a.clearinghouseState);
+        return !!this.clearinghouseState;
     }
 }
 
@@ -4816,13 +4855,13 @@ const useAccountSummary = () => {
     }
     const openOrders = useUserData((state) => state.openOrders);
     const accountSummary = useUserData((state) => state.accountSummary);
-    const webData2 = useHyperliquidData((state) => state.webData2);
+    const aggregatedClearingHouseState = useHyperliquidData((state) => state.aggregatedClearingHouseState);
     const isLoading = useMemo(() => {
         // Loading is true initially and becomes false once we get the first data
         return accountSummary === null && context.isConnected;
     }, [accountSummary, context.isConnected]);
     // Create calculator and compute account summary
-    const calculator = new AccountSummaryCalculator(webData2);
+    const calculator = new AccountSummaryCalculator(aggregatedClearingHouseState);
     const calculated = calculator.calculateAccountSummary(accountSummary, openOrders, (_a = accountSummary === null || accountSummary === void 0 ? void 0 : accountSummary.agentWallet) === null || _a === void 0 ? void 0 : _a.address, (_b = accountSummary === null || accountSummary === void 0 ? void 0 : accountSummary.agentWallet) === null || _b === void 0 ? void 0 : _b.status);
     return { data: calculated, isLoading };
 };
@@ -4836,28 +4875,29 @@ const useUserSelection = () => {
  * Hook to access webData and native WebSocket state
  */
 const useWebData = () => {
-    var _a;
     const context = useContext(PearHyperliquidContext);
     if (!context) {
         throw new Error('useWebData must be used within a PearHyperliquidProvider');
     }
-    const webData2 = useHyperliquidData((state) => state.webData2);
+    const finalAssetContexts = useHyperliquidData((state) => state.finalAssetContexts);
+    const perpMetaAssets = useHyperliquidData((state) => state.perpMetaAssets);
+    const aggregatedClearinghouseState = useHyperliquidData((state) => state.aggregatedClearingHouseState);
+    const finalAtOICaps = useHyperliquidData((state) => state.finalAtOICaps);
     let marketDataBySymbol = {};
-    if ((webData2 === null || webData2 === void 0 ? void 0 : webData2.assetCtxs) && ((_a = webData2 === null || webData2 === void 0 ? void 0 : webData2.meta) === null || _a === void 0 ? void 0 : _a.universe)) {
-        const { assetCtxs, meta: { universe } } = webData2;
+    if (finalAssetContexts && perpMetaAssets && finalAssetContexts.length === perpMetaAssets.length) {
         const result = {};
-        for (let index = 0; index < universe.length; index++) {
-            const name = universe[index].name;
+        for (let index = 0; index < perpMetaAssets.length; index++) {
+            const name = perpMetaAssets[index].name;
             result[name] = {
-                asset: assetCtxs[index],
-                universe: universe[index],
+                asset: finalAssetContexts[index],
+                universe: perpMetaAssets[index],
             };
         }
         marketDataBySymbol = result;
     }
     return {
-        clearinghouseState: webData2 === null || webData2 === void 0 ? void 0 : webData2.clearinghouseState,
-        perpsAtOpenInterestCap: webData2 === null || webData2 === void 0 ? void 0 : webData2.perpsAtOpenInterestCap,
+        clearinghouseState: aggregatedClearinghouseState,
+        perpsAtOpenInterestCap: finalAtOICaps,
         marketDataBySymbol,
         isConnected: context.nativeIsConnected,
         error: context.nativeLastError,
@@ -4865,28 +4905,29 @@ const useWebData = () => {
 };
 
 /**
- * Extracts token metadata from WebData2 and AllMids data
+ * Extracts token metadata from aggregated WebData3 contexts and AllMids data
  */
 class TokenMetadataExtractor {
     /**
      * Extracts comprehensive token metadata
      * @param symbol - Token symbol
-     * @param webData2 - WebData2 response containing asset context and universe data
+     * @param perpMetaAssets - Aggregated universe assets (flattened across dexes)
+     * @param finalAssetContexts - Aggregated asset contexts (flattened across dexes)
      * @param allMids - AllMids data containing current prices
      * @param activeAssetData - Optional active asset data containing leverage information
      * @returns TokenMetadata or null if token not found
      */
-    static extractTokenMetadata(symbol, webData2, allMids, activeAssetData) {
-        if (!webData2 || !allMids) {
+    static extractTokenMetadata(symbol, perpMetaAssets, finalAssetContexts, allMids, activeAssetData) {
+        if (!perpMetaAssets || !finalAssetContexts || !allMids) {
             return null;
         }
-        // Find token index in universe
-        const universeIndex = webData2.meta.universe.findIndex(asset => asset.name === symbol);
+        // Find token index in aggregated universe
+        const universeIndex = perpMetaAssets.findIndex(asset => asset.name === symbol);
         if (universeIndex === -1) {
             return null;
         }
-        const universeAsset = webData2.meta.universe[universeIndex];
-        const assetCtx = webData2.assetCtxs[universeIndex];
+        const universeAsset = perpMetaAssets[universeIndex];
+        const assetCtx = finalAssetContexts[universeIndex];
         if (!assetCtx) {
             return null;
         }
@@ -4926,28 +4967,29 @@ class TokenMetadataExtractor {
     /**
      * Extracts metadata for multiple tokens
      * @param symbols - Array of token symbols
-     * @param webData2 - WebData2 response
+     * @param perpMetaAssets - Aggregated universe assets
+     * @param finalAssetContexts - Aggregated asset contexts
      * @param allMids - AllMids data
      * @param activeAssetData - Optional active asset data containing leverage information
      * @returns Record of symbol to TokenMetadata
      */
-    static extractMultipleTokensMetadata(symbols, webData2, allMids, activeAssetData) {
+    static extractMultipleTokensMetadata(symbols, perpMetaAssets, finalAssetContexts, allMids, activeAssetData) {
         const result = {};
         for (const symbol of symbols) {
-            result[symbol] = this.extractTokenMetadata(symbol, webData2, allMids, activeAssetData);
+            result[symbol] = this.extractTokenMetadata(symbol, perpMetaAssets, finalAssetContexts, allMids, activeAssetData);
         }
         return result;
     }
     /**
-     * Checks if token data is available in WebData2
+     * Checks if token data is available in aggregated universe assets
      * @param symbol - Token symbol
-     * @param webData2 - WebData2 response
+     * @param perpMetaAssets - Aggregated universe assets
      * @returns boolean indicating if token exists in universe
      */
-    static isTokenAvailable(symbol, webData2) {
-        if (!webData2)
+    static isTokenAvailable(symbol, perpMetaAssets) {
+        if (!perpMetaAssets)
             return false;
-        return webData2.meta.universe.some(asset => asset.name === symbol);
+        return perpMetaAssets.some(asset => asset.name === symbol);
     }
 }
 
@@ -4966,16 +5008,16 @@ const useTokenSelectionMetadataStore = create((set) => ({
     maxLeverage: 0,
     minMargin: 0,
     leverageMatched: true,
-    recompute: ({ webData2, allMids, activeAssetData, marketData, longTokens, shortTokens }) => {
-        const isPriceDataReady = !!(webData2 && allMids);
+    recompute: ({ perpMetaAssets, finalAssetContexts, allMids, activeAssetData, marketData, longTokens, shortTokens }) => {
+        const isPriceDataReady = !!(perpMetaAssets && finalAssetContexts && allMids);
         // Compute metadata when ready
         const longSymbols = longTokens.map((t) => t.symbol);
         const shortSymbols = shortTokens.map((t) => t.symbol);
         const longTokensMetadata = isPriceDataReady
-            ? TokenMetadataExtractor.extractMultipleTokensMetadata(longSymbols, webData2, allMids, activeAssetData)
+            ? TokenMetadataExtractor.extractMultipleTokensMetadata(longSymbols, perpMetaAssets, finalAssetContexts, allMids, activeAssetData)
             : {};
         const shortTokensMetadata = isPriceDataReady
-            ? TokenMetadataExtractor.extractMultipleTokensMetadata(shortSymbols, webData2, allMids, activeAssetData)
+            ? TokenMetadataExtractor.extractMultipleTokensMetadata(shortSymbols, perpMetaAssets, finalAssetContexts, allMids, activeAssetData)
             : {};
         // Determine loading state
         const allTokens = [...longTokens, ...shortTokens];
@@ -5084,15 +5126,14 @@ const useTokenSelectionMetadataStore = create((set) => ({
         })();
         // Max leverage (minimum across all tokens)
         const maxLeverage = (() => {
-            var _a;
-            if (!((_a = webData2 === null || webData2 === void 0 ? void 0 : webData2.meta) === null || _a === void 0 ? void 0 : _a.universe))
+            if (!perpMetaAssets)
                 return 0;
             const allTokenSymbols = [...longTokens, ...shortTokens].map((t) => t.symbol);
             if (allTokenSymbols.length === 0)
                 return 0;
             let minLev = Infinity;
             allTokenSymbols.forEach((symbol) => {
-                const tokenUniverse = webData2.meta.universe.find((u) => u.name === symbol);
+                const tokenUniverse = perpMetaAssets.find((u) => u.name === symbol);
                 if (tokenUniverse === null || tokenUniverse === void 0 ? void 0 : tokenUniverse.maxLeverage)
                     minLev = Math.min(minLev, tokenUniverse.maxLeverage);
             });
@@ -5144,7 +5185,8 @@ const useTokenSelectionMetadata = () => {
     if (!context) {
         throw new Error('useTokenSelection must be used within PearHyperliquidProvider');
     }
-    const webData2 = useHyperliquidData((state) => state.webData2);
+    const perpMetaAssets = useHyperliquidData((state) => state.perpMetaAssets);
+    const finalAssetContexts = useHyperliquidData((state) => state.finalAssetContexts);
     const allMids = useHyperliquidData((state) => state.allMids);
     const activeAssetData = useHyperliquidData((state) => state.activeAssetData);
     const marketData = useMarketData((state) => state.marketData);
@@ -5153,7 +5195,8 @@ const useTokenSelectionMetadata = () => {
     // Recompute derived metadata when inputs change
     useEffect(() => {
         recompute({
-            webData2,
+            perpMetaAssets,
+            finalAssetContexts,
             allMids,
             activeAssetData: activeAssetData || null,
             marketData: marketData || null,
@@ -5162,7 +5205,7 @@ const useTokenSelectionMetadata = () => {
         });
         // We want to recompute when token lists or upstream data change
         // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [webData2, allMids, activeAssetData, JSON.stringify(longTokens), JSON.stringify(shortTokens)]);
+    }, [perpMetaAssets, finalAssetContexts, allMids, activeAssetData, JSON.stringify(longTokens), JSON.stringify(shortTokens)]);
     return {
         // Loading states
         isLoading,
@@ -5337,6 +5380,23 @@ const fetchUserFillsFromHyperliquid = async (user, startTime, aggregateByTime =
         throw toApiError(error);
     }
 };
+/**
+ * Fetch all perp metas from HyperLiquid API
+ * Endpoint: https://api.hyperliquid.xyz/info
+ * Payload: { "type": "allPerpMetas" }
+ */
+const fetchAllPerpMetas = async () => {
+    const request = { type: 'allPerpMetas' };
+    try {
+        const response = await axios$1.post('https://api.hyperliquid.xyz/info', request, {
+            headers: { 'Content-Type': 'application/json' },
+        });
+        return { data: response.data, status: response.status, headers: response.headers };
+    }
+    catch (error) {
+        throw toApiError(error);
+    }
+};
 
 const useHistoricalPriceData = () => {
     const context = useContext(PearHyperliquidContext);
@@ -5444,7 +5504,6 @@ const useHistoricalPriceData = () => {
         }
     }, [
         getAllTokens,
-        candleInterval,
         storeHasData,
         getHistoricalPriceData,
         setTokenLoading,
@@ -6251,7 +6310,7 @@ const calculatePositionAsset = (asset, currentPrice, totalInitialPositionSize, l
         initialWeight: totalInitialPositionSize > 0 ? entryNotional / totalInitialPositionSize : 0,
     };
 };
-const buildPositionValue = (rawPositions, webData2, allMids) => {
+const buildPositionValue = (rawPositions, clearinghouseState, allMids) => {
     return rawPositions.map((position) => {
         let mappedPosition = {
             positionId: position.positionId,
@@ -6270,7 +6329,7 @@ const buildPositionValue = (rawPositions, webData2, allMids) => {
         mappedPosition.longAssets = position.longAssets.map(longAsset => {
             var _a, _b, _c;
             const currentPrice = parseFloat(allMids.mids[longAsset.coin]);
-            const assetState = (_a = webData2.clearinghouseState.assetPositions.find(ap => ap.position.coin === longAsset.coin)) === null || _a === void 0 ? void 0 : _a.position;
+            const assetState = (_a = clearinghouseState.assetPositions.find(ap => ap.position.coin === longAsset.coin)) === null || _a === void 0 ? void 0 : _a.position;
             const leverage = (_c = (_b = assetState === null || assetState === void 0 ? void 0 : assetState.leverage) === null || _b === void 0 ? void 0 : _b.value) !== null && _c !== void 0 ? _c : 0;
             const mappedPositionAssets = calculatePositionAsset(longAsset, currentPrice, totalInitialPositionSize, leverage, true);
             mappedPosition.entryPositionValue += mappedPositionAssets.entryPositionValue;
@@ -6284,7 +6343,7 @@ const buildPositionValue = (rawPositions, webData2, allMids) => {
         mappedPosition.shortAssets = position.shortAssets.map(shortAsset => {
             var _a, _b, _c;
             const currentPrice = parseFloat(allMids.mids[shortAsset.coin]);
-            const assetState = (_a = webData2.clearinghouseState.assetPositions.find(ap => ap.position.coin === shortAsset.coin)) === null || _a === void 0 ? void 0 : _a.position;
+            const assetState = (_a = clearinghouseState.assetPositions.find(ap => ap.position.coin === shortAsset.coin)) === null || _a === void 0 ? void 0 : _a.position;
             const leverage = (_c = (_b = assetState === null || assetState === void 0 ? void 0 : assetState.leverage) === null || _b === void 0 ? void 0 : _b.value) !== null && _c !== void 0 ? _c : 0;
             const mappedPositionAssets = calculatePositionAsset(shortAsset, currentPrice, totalInitialPositionSize, leverage, false);
             mappedPosition.entryPositionValue += mappedPositionAssets.entryPositionValue;
@@ -6349,16 +6408,16 @@ function usePosition() {
     };
     // Open positions using WS data, with derived values
     const userOpenPositions = useUserData((state) => state.rawOpenPositions);
-    const webData2 = useHyperliquidData((state) => state.webData2);
+    const aggregatedClearingHouseState = useHyperliquidData((state) => state.aggregatedClearingHouseState);
     const allMids = useHyperliquidData((state) => state.allMids);
     const isLoading = useMemo(() => {
         return userOpenPositions === null && isConnected;
     }, [userOpenPositions, isConnected]);
     const openPositions = useMemo(() => {
-        if (!userOpenPositions || !webData2 || !allMids)
+        if (!userOpenPositions || !aggregatedClearingHouseState || !allMids)
             return null;
-        return buildPositionValue(userOpenPositions, webData2, allMids);
-    }, [userOpenPositions, webData2, allMids]);
+        return buildPositionValue(userOpenPositions, aggregatedClearingHouseState, allMids);
+    }, [userOpenPositions, aggregatedClearingHouseState, allMids]);
     return { createPosition: createPosition$1, updateRiskParameters: updateRiskParameters$1, closePosition: closePosition$1, closeAllPositions: closeAllPositions$1, adjustPosition: adjustPosition$1, openPositions, isLoading };
 }
 
@@ -6710,13 +6769,22 @@ const PearHyperliquidProvider = ({ children, apiBaseUrl = 'https://hl-v2.pearpro
     const { isConnected: nativeIsConnected, lastError: nativeLastError } = useHyperliquidNativeWebSocket({
         address,
     });
+    const perpsMetaAssets = useHyperliquidData((state) => state.perpMetaAssets);
+    const setPerpMetaAssets = useHyperliquidData((state) => state.setPerpMetaAssets);
     // Auth hook
-    // Auth state inside provider (replaces useAuth internal state)
     const [authStatus, setAuthStatus] = useState(AuthStatus.Idle);
     const [user, setUser] = useState(null);
     const [authError, setAuthError] = useState(null);
     const [accessToken, setAccessToken] = useState(null);
     const isAuthenticated = useMemo(() => !!accessToken, [accessToken]);
+    useEffect(() => {
+        if (perpsMetaAssets === null) {
+            fetchAllPerpMetas().then(res => {
+                const aggregatedPerpMetas = res.data.flatMap(item => item.universe);
+                setPerpMetaAssets(aggregatedPerpMetas);
+            });
+        }
+    }, [perpsMetaAssets]);
     // Hydrate from existing token
     useEffect(() => {
         const access = localStorage.getItem('accessToken');

package/dist/store/tokenSelectionMetadataStore.d.ts

@@ -1,4 +1,4 @@
-import type { ActiveAssetData, TokenSelection, TokenMetadata, WebData2Response, WsAllMidsData, ActiveAssetsResponse } from "../types";
+import type { ActiveAssetData, TokenSelection, TokenMetadata, WsAllMidsData, ActiveAssetsResponse, UniverseAsset, WebData3AssetCtx } from "../types";
 export interface TokenSelectionMetadataState {
     isPriceDataReady: boolean;
     isLoading: boolean;
@@ -15,7 +15,8 @@ export interface TokenSelectionMetadataState {
     minMargin: number;
     leverageMatched: boolean;
     recompute: (args: {
-        webData2: WebData2Response | null;
+        perpMetaAssets: UniverseAsset[] | null;
+        finalAssetContexts: WebData3AssetCtx[] | null;
         allMids: WsAllMidsData | null;
         activeAssetData: Record<string, ActiveAssetData> | null;
         marketData: ActiveAssetsResponse | null;

package/dist/types.d.ts

@@ -57,7 +57,7 @@ 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' | 'webData2' | '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
  */
@@ -416,6 +416,7 @@ export interface WebSocketMessage {
     method: "subscribe" | "unsubscribe";
     subscription: {
         type: string;
+        dex?: string;
         coin?: string;
         interval?: string;
         user?: string;
@@ -425,13 +426,44 @@ export interface WebSocketMessage {
 /**
  * WebSocket response from HyperLiquid native API
  */
-export type HLChannel = 'webData2' | 'allMids' | 'activeAssetData' | 'candle';
+export type HLChannel = 'webData3' | 'allMids' | 'activeAssetData' | 'candle';
 export interface HLChannelDataMap {
-    webData2: WebData2Response;
+    webData3: WebData3Response;
     allMids: WsAllMidsData;
     activeAssetData: ActiveAssetData;
     candle: CandleData;
 }
+export interface WebData3UserState {
+    agentAddress?: string;
+    agentValidUntil?: number;
+    cumLedger: string;
+    serverTime: number;
+    isVault: boolean;
+    user: string;
+    dexAbstractionEnabled?: boolean;
+}
+export interface WebData3AssetCtx {
+    funding: string;
+    openInterest: string;
+    prevDayPx: string;
+    dayNtlVlm: string;
+    premium: string | null;
+    oraclePx: string;
+    markPx: string;
+    midPx: string | null;
+    impactPxs: string[] | null;
+    dayBaseVlm: string;
+}
+export interface WebData3PerpDexState {
+    clearinghouseState: ClearinghouseState;
+    totalVaultEquity: string;
+    assetCtxs: WebData3AssetCtx[];
+    perpsAtOpenInterestCap: string[];
+}
+export interface WebData3Response {
+    userState: WebData3UserState;
+    perpDexStates: WebData3PerpDexState[];
+}
 export interface HLWebSocketResponse<T extends HLChannel = HLChannel> {
     channel: T;
     data: HLChannelDataMap[T];
@@ -465,17 +497,24 @@ export interface UniverseAsset {
     onlyIsolated?: boolean;
     isDelisted?: boolean;
 }
-/**
- * WebData2 response structure
- */
-export interface WebData2Response {
-    assetCtxs: AssetCtx[];
-    meta: {
-        universe: UniverseAsset[];
-    };
-    clearinghouseState: ClearinghouseState;
-    perpsAtOpenInterestCap?: string[];
+export interface PerpMetaAsset extends UniverseAsset {
+    marginTableId: number;
 }
+export interface MarginTier {
+    lowerBound: string;
+    maxLeverage: number;
+}
+export interface MarginTableDef {
+    description: string;
+    marginTiers: MarginTier[];
+}
+export type MarginTablesEntry = [number, MarginTableDef];
+export interface AllPerpMetasItem {
+    universe: PerpMetaAsset[];
+    marginTables: MarginTablesEntry[];
+    collateralToken: number;
+}
+export type AllPerpMetasResponse = AllPerpMetasItem[];
 export interface ClearinghouseState {
     assetPositions: AssetPosition[];
     crossMaintenanceMarginUsed: string;
@@ -577,9 +616,6 @@ export interface ActiveAssetData {
     availableToTrade: [string, string];
     markPx: string;
 }
-/**
- * Token metadata from WebData2 and AllMids
- */
 export interface TokenMetadata {
     currentPrice: number;
     prevDayPrice: number;
@@ -611,7 +647,7 @@ export interface TokenConflict {
     conflictMessage: string;
 }
 export interface AssetMarketData {
-    asset: AssetCtx;
+    asset: WebData3AssetCtx | AssetCtx;
     universe: UniverseAsset;
 }
 export interface PairAssetDto {

package/dist/utils/account-summary-calculator.d.ts

@@ -1,22 +1,19 @@
-import type { AccountSummaryResponseDto, WebData2Response, OpenLimitOrderDto } from '../types';
+import type { AccountSummaryResponseDto, ClearinghouseState, OpenLimitOrderDto } from '../types';
 /**
  * Account summary calculation utility class
  */
 export declare class AccountSummaryCalculator {
-    private webData2;
-    constructor(webData2: WebData2Response | null);
+    private clearinghouseState;
+    constructor(clearinghouseState: ClearinghouseState | null);
     /**
-     * Calculate account summary from webData2 and platform orders
+     * Calculate account summary from real-time clearinghouse state and platform orders
      */
     calculateAccountSummary(platformAccountSummary: AccountSummaryResponseDto | null, platformOpenOrders: OpenLimitOrderDto[] | null, agentWalletAddress?: string, agentWalletStatus?: string): AccountSummaryResponseDto | null;
     /**
      * Calculate total USD value of open limit orders
      */
     private calculateTotalLimitOrderValue;
-    /**
-     * Get real-time clearinghouse state from webData2
-     */
-    getClearinghouseState(): import("../types").ClearinghouseState | null;
+    getClearinghouseState(): ClearinghouseState | null;
     /**
      * Check if real-time data is available
      */

package/dist/utils/position-processor.d.ts

@@ -1,2 +1,2 @@
-import { OpenPositionDto, RawPositionDto, WebData2Response, WsAllMidsData } from "../types";
-export declare const buildPositionValue: (rawPositions: RawPositionDto[], webData2: WebData2Response, allMids: WsAllMidsData) => OpenPositionDto[];
+import { OpenPositionDto, RawPositionDto, ClearinghouseState, WsAllMidsData } from "../types";
+export declare const buildPositionValue: (rawPositions: RawPositionDto[], clearinghouseState: ClearinghouseState, allMids: WsAllMidsData) => OpenPositionDto[];

package/dist/utils/token-metadata-extractor.d.ts

@@ -1,31 +1,33 @@
-import type { WebData2Response, WsAllMidsData, TokenMetadata, ActiveAssetData } from '../types';
+import type { WsAllMidsData, TokenMetadata, ActiveAssetData, UniverseAsset, WebData3AssetCtx } from '../types';
 /**
- * Extracts token metadata from WebData2 and AllMids data
+ * Extracts token metadata from aggregated WebData3 contexts and AllMids data
  */
 export declare class TokenMetadataExtractor {
     /**
      * Extracts comprehensive token metadata
      * @param symbol - Token symbol
-     * @param webData2 - WebData2 response containing asset context and universe data
+     * @param perpMetaAssets - Aggregated universe assets (flattened across dexes)
+     * @param finalAssetContexts - Aggregated asset contexts (flattened across dexes)
      * @param allMids - AllMids data containing current prices
      * @param activeAssetData - Optional active asset data containing leverage information
      * @returns TokenMetadata or null if token not found
      */
-    static extractTokenMetadata(symbol: string, webData2: WebData2Response | null, allMids: WsAllMidsData | null, activeAssetData?: Record<string, ActiveAssetData> | null): TokenMetadata | null;
+    static extractTokenMetadata(symbol: string, perpMetaAssets: UniverseAsset[] | null, finalAssetContexts: WebData3AssetCtx[] | null, allMids: WsAllMidsData | null, activeAssetData?: Record<string, ActiveAssetData> | null): TokenMetadata | null;
     /**
      * Extracts metadata for multiple tokens
      * @param symbols - Array of token symbols
-     * @param webData2 - WebData2 response
+     * @param perpMetaAssets - Aggregated universe assets
+     * @param finalAssetContexts - Aggregated asset contexts
      * @param allMids - AllMids data
      * @param activeAssetData - Optional active asset data containing leverage information
      * @returns Record of symbol to TokenMetadata
      */
-    static extractMultipleTokensMetadata(symbols: string[], webData2: WebData2Response | null, allMids: WsAllMidsData | null, activeAssetData?: Record<string, ActiveAssetData> | null): Record<string, TokenMetadata | null>;
+    static extractMultipleTokensMetadata(symbols: string[], perpMetaAssets: UniverseAsset[] | null, finalAssetContexts: WebData3AssetCtx[] | null, allMids: WsAllMidsData | null, activeAssetData?: Record<string, ActiveAssetData> | null): Record<string, TokenMetadata | null>;
     /**
-     * Checks if token data is available in WebData2
+     * Checks if token data is available in aggregated universe assets
      * @param symbol - Token symbol
-     * @param webData2 - WebData2 response
+     * @param perpMetaAssets - Aggregated universe assets
      * @returns boolean indicating if token exists in universe
      */
-    static isTokenAvailable(symbol: string, webData2: WebData2Response | null): boolean;
+    static isTokenAvailable(symbol: string, perpMetaAssets: UniverseAsset[] | null): boolean;
 }

package/package.json

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