@pear-protocol/hyperliquid-sdk 0.0.72 → 0.0.73-beta-1

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import React, { ReactNode } from 'react';
+import * as zustand from 'zustand';
 
 interface PearHyperliquidContextType {
     clientId: string;
@@ -47,7 +48,7 @@ interface ExternalFillDto {
     coin: string;
     px: string;
     sz: string;
-    side: "B" | "A";
+    side: 'B' | 'A';
     time: number;
     dir: string;
     fee: string;
@@ -74,16 +75,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 +114,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 +131,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 +142,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;
@@ -178,6 +179,8 @@ interface TradeHistoryAssetDataDto {
     externalFeePaid: number;
     builderFeePaid: number;
     realizedPnl: number;
+    marketPrefix?: string | null;
+    collateralToken?: CollateralToken;
 }
 /**
  * Trade history data structure
@@ -226,10 +229,15 @@ interface PositionAssetDetailDto {
     liquidationPrice: number;
     initialWeight: number;
     fundingPaid?: number;
+    marketPrefix?: string | null;
+    collateralToken?: CollateralToken;
 }
 interface TpSlThreshold {
-    type: "PERCENTAGE" | "DOLLAR" | "POSITION_VALUE";
+    type: 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE' | 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO';
     value: number;
+    isTrailing?: boolean;
+    trailingDeltaValue?: number;
+    trailingActivationValue?: number;
 }
 /**
  * Open position data structure
@@ -259,38 +267,96 @@ interface OpenPositionDto {
 interface OrderAssetDto {
     asset: string;
     weight: number;
+    marketPrefix?: string | null;
+    collateralToken?: CollateralToken;
 }
 /**
  * Order status
  */
-type OrderStatus = "OPEN" | "PARTIALLY_FILLED" | "PROCESSING";
+type OrderStatus = 'OPEN' | 'PROCESSING' | 'EXECUTED' | 'CANCELLED' | 'FAILED' | 'PARTIALLY_FILLED';
 /**
  * Order type
  */
-type OrderType = "TP" | "SL" | "LIMIT" | "MARKET" | "LIMIT_BTCDOM" | "TWAP";
+type OrderType = 'SYNC' | 'MARKET' | 'TRIGGER' | 'TWAP' | 'LADDER' | 'TP' | 'SL' | 'SPOT_MARKET' | 'SPOT_LIMIT' | 'SPOT_TWAP';
 /**
  * TP/SL trigger type
  */
-type TpSlTriggerType = "PERCENTAGE" | "DOLLAR" | "POSITION_VALUE";
-type OrderDirection = "MORE_THAN" | "LESS_THAN" | null;
+type TpSlTriggerType = 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE' | 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO';
+/**
+ * Trigger type for trigger orders
+ */
+type TriggerType$1 = 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO' | 'BTC_DOM' | 'CROSS_ASSET_PRICE' | 'PREDICTION_MARKET_OUTCOME';
+type OrderDirection = 'MORE_THAN' | 'LESS_THAN';
+/**
+ * Market order parameters
+ */
+interface MarketOrderParameters {
+    leverage?: number;
+    usdValue: number;
+    reduceOnly?: boolean;
+}
+/**
+ * Trigger order parameters
+ */
+interface TriggerOrderParameters {
+    leverage: number;
+    usdValue: number;
+    triggerType: TriggerType$1;
+    triggerValue: number;
+    direction: OrderDirection;
+    reduceOnly?: boolean;
+    assetName?: string;
+    marketCode?: string;
+}
+/**
+ * TWAP order parameters
+ */
+interface TwapOrderParameters {
+    leverage: number;
+    usdValue: number;
+    duration: string;
+    intervalSeconds?: number;
+    chunkUsdValue: number;
+    randomizeExecution?: boolean;
+    reduceOnly?: boolean;
+}
+/**
+ * TP/SL order parameters
+ */
+interface TpSlOrderParameters {
+    triggerType: TpSlTriggerType;
+    triggerValue: number;
+    isTrailing?: boolean;
+    trailingDeltaValue?: number;
+    trailingActivationValue?: number;
+    reduceOnly?: boolean;
+}
+/**
+ * Ladder order parameters
+ */
+interface LadderOrderParameters {
+    leverage: number;
+    usdValue: number;
+    ratioStart: number;
+    ratioEnd: number;
+    numberOfLevels: number;
+    reduceOnly?: boolean;
+}
+/**
+ * Union type for all order parameters
+ */
+type OrderParameters = MarketOrderParameters | TriggerOrderParameters | TwapOrderParameters | TpSlOrderParameters | LadderOrderParameters;
 /**
  * Open limit order data structure
  */
 interface OpenLimitOrderDto {
     orderId: string;
     address: string;
-    clientId: string | null;
+    clientId?: string | null;
     positionId?: string | null;
-    leverage: number;
-    usdValue: number;
-    triggerValue?: number | null;
-    twapDuration?: string | null;
-    tpSlTriggerType?: TpSlTriggerType | null;
-    randomizeFlag: boolean;
-    reduceOnlyFlag: boolean;
-    status: OrderStatus;
+    parameters: OrderParameters;
     orderType: OrderType;
-    direction?: OrderDirection | null;
+    status: OrderStatus;
     longAssets: OrderAssetDto[];
     shortAssets: OrderAssetDto[];
     createdAt: string;
@@ -378,7 +444,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;
@@ -391,14 +457,14 @@ interface ExtraAgent {
 interface AgentWalletState {
     address: string | null;
     name: string | null;
-    status: AgentWalletStatus | "PENDING" | null;
+    status: AgentWalletStatus | 'PENDING' | null;
     isActive: boolean;
 }
 /**
  * WebSocket message from HyperLiquid native API
  */
 interface WebSocketMessage {
-    method: "subscribe" | "unsubscribe";
+    method: 'subscribe' | 'unsubscribe';
     subscription: {
         type: string;
         dex?: string;
@@ -411,14 +477,19 @@ interface WebSocketMessage {
 /**
  * WebSocket response from HyperLiquid native API
  */
-type HLChannel = "webData3" | "allMids" | "activeAssetData" | "candle" | "allDexsClearinghouseState" | "allDexsAssetCtxs";
+type HLChannel = 'webData3' | 'allMids' | 'activeAssetData' | 'candle' | 'spotState' | 'allDexsClearinghouseState' | 'allDexsAssetCtxs' | 'userFills';
 interface HLChannelDataMap {
     webData3: WebData3Response;
     allMids: WsAllMidsData;
     activeAssetData: ActiveAssetData;
     candle: CandleData;
+    spotState: {
+        user: string;
+        spotState: SpotState;
+    };
     allDexsClearinghouseState: AllDexsClearinghouseStateData;
     allDexsAssetCtxs: AllDexsAssetCtxsData;
+    userFills: any;
 }
 interface WebData3UserState {
     agentAddress?: string;
@@ -481,6 +552,12 @@ interface AssetCtx {
     impactPxs?: string[];
     oraclePx: string;
 }
+/**
+ * Collateral token type
+ * 0 = USDC
+ * 360 = USDH
+ */
+type CollateralToken = 'USDC' | 'USDH';
 /**
  * Universe asset metadata
  */
@@ -490,6 +567,8 @@ interface UniverseAsset {
     maxLeverage: number;
     onlyIsolated?: boolean;
     isDelisted?: boolean;
+    marketPrefix?: string;
+    collateralToken?: CollateralToken;
 }
 interface ClearinghouseState {
     assetPositions: AssetPosition[];
@@ -560,6 +639,8 @@ interface RawAssetDto {
     size: number;
     side: string;
     fundingPaid?: number;
+    marketPrefix?: string | null;
+    collateralToken?: CollateralToken;
     leverage: number;
 }
 /**
@@ -608,6 +689,7 @@ interface TokenMetadata {
     leverage?: LeverageInfo;
     maxTradeSzs?: [string, string];
     availableToTrade?: [string, string];
+    collateralToken?: CollateralToken;
 }
 /**
  * Enhanced token selection with weight and metadata for basket trading
@@ -621,16 +703,37 @@ interface TokenSelection {
  */
 interface TokenConflict {
     symbol: string;
-    conflictType: "long" | "short";
+    conflictType: 'long' | 'short';
     conflictMessage: string;
 }
 interface AssetMarketData {
     asset: WebData3AssetCtx | AssetCtx;
     universe: UniverseAsset;
 }
+/**
+ * Nested market data structure for multi-market assets.
+ * Each symbol maps to its market variants (keyed by prefix).
+ * For non-HIP3 assets, use "default" as the key.
+ *
+ * @example
+ * ```ts
+ * {
+ *   "TSLA": {
+ *     "xyz": { asset: {...}, universe: { collateralToken: "USDC", ... } },
+ *     "flx": { asset: {...}, universe: { collateralToken: "USDH", ... } }
+ *   },
+ *   "BTC": {
+ *     "default": { asset: {...}, universe: {...} }
+ *   }
+ * }
+ * ```
+ */
+type MarketDataBySymbol = Record<string, Record<string, AssetMarketData>>;
 interface PairAssetDto {
     asset: string;
     weight: number;
+    collateralToken: CollateralToken;
+    marketPrefix: string | null;
 }
 interface ActiveAssetGroupItem {
     longAssets: PairAssetDto[];
@@ -644,6 +747,7 @@ interface ActiveAssetGroupItem {
     weightedRatio?: string;
     weightedPrevRatio?: string;
     weightedChange24h?: string;
+    collateralType: 'USDC' | 'USDH' | 'MIXED';
 }
 interface ActiveAssetsResponse {
     active: ActiveAssetGroupItem[];
@@ -661,7 +765,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
  */
@@ -689,12 +793,23 @@ interface CandleSnapshotRequest {
         endTime: number;
         interval: CandleInterval;
     };
-    type: "candleSnapshot";
+    type: 'candleSnapshot';
 }
 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;
@@ -705,9 +820,6 @@ declare const useTradeHistories: () => {
     data: TradeHistoryDataDto[] | null;
     isLoading: boolean;
 };
-/**
- * Hook to access open orders with loading state
- */
 declare const useOpenOrders: () => {
     data: OpenLimitOrderDto[] | null;
     isLoading: boolean;
@@ -746,8 +858,26 @@ declare const useUserSelection: () => UserSelectionState;
 declare const useWebData: () => {
     clearinghouseState: ClearinghouseState | null;
     perpsAtOpenInterestCap: string[] | null;
-    marketDataBySymbol: Record<string, AssetMarketData>;
-    hip3Assets: Map<string, string>;
+    /**
+     * Market data keyed by symbol, with nested market variants.
+     * Each symbol maps to its market variants (keyed by prefix).
+     * For non-HIP3 assets, use "default" as the key.
+     *
+     * @example
+     * ```ts
+     * // HIP-3 asset with multiple markets
+     * marketDataBySymbol["TSLA"]["xyz"]  // { asset, universe: { collateralToken: "USDC" } }
+     * marketDataBySymbol["TSLA"]["flx"]  // { asset, universe: { collateralToken: "USDH" } }
+     *
+     * // Regular asset
+     * marketDataBySymbol["BTC"]["default"]  // { asset, universe }
+     * ```
+     */
+    marketDataBySymbol: MarketDataBySymbol;
+    /** Map of display name -> all full market names (e.g., "TSLA" -> ["xyz:TSLA", "flx:TSLA"]) */
+    hip3Assets: Map<string, string[]>;
+    /** Map of full market name -> prefix (e.g., "xyz:TSLA" -> "xyz") */
+    hip3MarketPrefixes: Map<string, string>;
     isConnected: boolean;
     error: string | null;
 };
@@ -781,7 +911,18 @@ interface TokenHistoricalPriceData {
     oldestTime: number | null;
     latestTime: number | null;
 }
-declare const useHistoricalPriceDataStore: any;
+interface HistoricalPriceDataState {
+    historicalPriceData: Record<string, TokenHistoricalPriceData>;
+    loadingTokens: Set<string>;
+    addHistoricalPriceData: (symbol: string, interval: CandleInterval, candles: CandleData[], range: HistoricalRange) => void;
+    hasHistoricalPriceData: (symbol: string, interval: CandleInterval, startTime: number, endTime: number) => boolean;
+    getHistoricalPriceData: (symbol: string, interval: CandleInterval, startTime: number, endTime: number) => CandleData[];
+    setTokenLoading: (symbol: string, loading: boolean) => void;
+    isTokenLoading: (symbol: string) => boolean;
+    removeTokenPriceData: (symbol: string, interval: CandleInterval) => void;
+    clearData: () => void;
+}
+declare const useHistoricalPriceDataStore: zustand.UseBoundStore<zustand.StoreApi<HistoricalPriceDataState>>;
 
 interface UseHistoricalPriceDataReturn {
     fetchHistoricalPriceData: (startTime: number, endTime: number, interval: CandleInterval, callback?: (data: Record<string, CandleData[]>) => void) => Promise<Record<string, CandleData[]>>;
@@ -839,25 +980,6 @@ declare function useAgentWallet(): {
     readonly notifyAgentWalletApproved: () => Promise<void>;
 };
 
-interface AutoSyncFillsOptions {
-    baseUrl: string;
-    address: string | null;
-    intervalMs?: number;
-    aggregateByTime?: boolean;
-}
-interface AutoSyncFillsState {
-    lastRunAt: number | null;
-    lastResult: SyncFillsResponseDto | null;
-    error: string | null;
-    isSyncing: boolean;
-    triggerSync: () => Promise<void>;
-}
-/**
- * Listens to address changes and periodically syncs user fills
- * Defaults: aggregate=true, interval=60s
- */
-declare function useAutoSyncFills(options: AutoSyncFillsOptions): AutoSyncFillsState;
-
 interface AdjustOrderRequestInput {
     limitRatio?: number;
     usdValue?: number;
@@ -881,9 +1003,51 @@ interface CancelTwapResponseDto {
     cancelledAt: string;
 }
 declare function cancelTwapOrder(baseUrl: string, orderId: string): Promise<ApiResponse<CancelTwapResponseDto>>;
+interface SpotOrderRequestInput {
+    /** Asset to buy/sell (e.g., "USDH") */
+    asset: string;
+    /** Whether to buy (true) or sell (false) the asset */
+    isBuy: boolean;
+    /** Amount of asset to buy/sell (minimum: 11) */
+    amount: number;
+}
+/** Filled order status from Hyperliquid */
+interface SpotOrderFilledStatus {
+    filled: {
+        totalSz: string;
+        avgPx: string;
+        oid: number;
+        cloid: string;
+    };
+}
+/** Hyperliquid order response data */
+interface SpotOrderHyperliquidData {
+    statuses: SpotOrderFilledStatus[];
+}
+/** Hyperliquid result from spot order execution */
+interface SpotOrderHyperliquidResult {
+    status: 'ok' | 'error';
+    response: {
+        type: 'order';
+        data: SpotOrderHyperliquidData;
+    };
+}
+interface SpotOrderResponseDto {
+    orderId: string;
+    status: 'EXECUTED' | 'FAILED' | 'PENDING';
+    asset: string;
+    createdAt: string;
+    hyperliquidResult?: SpotOrderHyperliquidResult;
+}
+/**
+ * Execute a spot order (swap) using Pear Hyperliquid service
+ * POST /orders/spot
+ */
+declare function executeSpotOrder(baseUrl: string, payload: SpotOrderRequestInput): Promise<ApiResponse<SpotOrderResponseDto>>;
 
-type ExecutionType = "MARKET" | "LIMIT" | "TWAP" | "LADDER" | "LIMIT_BTCDOM";
-type TpSlThresholdType = "PERCENTAGE" | "DOLLAR" | "POSITION_VALUE";
+type ExecutionType = "MARKET" | "TRIGGER" | "TWAP" | "LADDER" | "TP" | "SL" | "SPOT_MARKET" | "SPOT_LIMIT" | "SPOT_TWAP";
+type TriggerType = "PRICE" | "PRICE_RATIO" | "WEIGHTED_RATIO" | "BTC_DOM" | "CROSS_ASSET_PRICE" | "PREDICTION_MARKET_OUTCOME";
+type TpSlThresholdType = "PERCENTAGE" | "DOLLAR" | "POSITION_VALUE" | "PRICE" | "PRICE_RATIO" | "WEIGHTED_RATIO";
 interface PairAssetInput {
     asset: string;
     weight?: number;
@@ -891,6 +1055,9 @@ interface PairAssetInput {
 interface TpSlThresholdInput {
     type: TpSlThresholdType;
     value: number;
+    isTrailing?: boolean;
+    trailingDeltaValue?: number;
+    trailingActivationValue?: number;
 }
 interface LadderConfigInput {
     ratioStart: number;
@@ -904,8 +1071,11 @@ interface CreatePositionRequestInput {
     usdValue: number;
     longAssets?: PairAssetInput[];
     shortAssets?: PairAssetInput[];
-    triggerValue?: number;
+    triggerValue?: string | number;
+    triggerType?: TriggerType;
     direction?: "MORE_THAN" | "LESS_THAN";
+    assetName?: string;
+    marketCode?: string;
     twapDuration?: number;
     twapIntervalSeconds?: number;
     randomizeExecution?: boolean;
@@ -914,24 +1084,9 @@ interface CreatePositionRequestInput {
     takeProfit?: TpSlThresholdInput | null;
     stopLoss?: TpSlThresholdInput | null;
 }
-type PositionResponseStatus = "SUCCESS" | "FAILED" | "PENDING" | "PARTIALLY_FILLED" | "OPEN";
-interface PositionAssetSummaryDto {
-    asset: string;
-    side: "LONG" | "SHORT";
-    size: number;
-    entryRatio: number;
-    usdValue: number;
-    orderId: string;
-}
 interface CreatePositionResponseDto {
-    positionId: string | null;
     orderId: string;
-    status: PositionResponseStatus;
-    createdAt: string;
-    assets?: PositionAssetSummaryDto[];
-    stopLoss?: TpSlThresholdInput | null;
-    takeProfit?: TpSlThresholdInput | null;
-    hyperliquidResult?: any;
+    fills?: ExternalFillDto[];
 }
 /**
  * Create a position (MARKET/LIMIT/TWAP) using Pear Hyperliquid service
@@ -939,7 +1094,7 @@ interface CreatePositionResponseDto {
  * @throws MinimumPositionSizeError if any asset has less than $11 USD value
  * @throws MaxAssetsPerLegError if any leg exceeds the maximum allowed assets (15)
  */
-declare function createPosition(baseUrl: string, payload: CreatePositionRequestInput, displayToFull: Map<string, string>): Promise<ApiResponse<CreatePositionResponseDto>>;
+declare function createPosition(baseUrl: string, payload: CreatePositionRequestInput, hip3Assets: Map<string, string[]>): Promise<ApiResponse<CreatePositionResponseDto>>;
 interface UpdateRiskParametersRequestInput {
     stopLoss?: TpSlThresholdInput | null;
     takeProfit?: TpSlThresholdInput | null;
@@ -1006,7 +1161,7 @@ interface AdjustAdvanceResponseDto {
     status: string;
     executedAt: string;
 }
-declare function adjustAdvancePosition(baseUrl: string, positionId: string, payload: AdjustAdvanceItemInput[], displayToFull: Map<string, string>): Promise<ApiResponse<AdjustAdvanceResponseDto>>;
+declare function adjustAdvancePosition(baseUrl: string, positionId: string, payload: AdjustAdvanceItemInput[], hip3Assets: Map<string, string[]>): Promise<ApiResponse<AdjustAdvanceResponseDto>>;
 declare function cancelTwap(baseUrl: string, orderId: string): Promise<ApiResponse<CancelTwapResponseDto>>;
 interface UpdateLeverageRequestInput {
     leverage: number;
@@ -1036,6 +1191,18 @@ declare function useOrders(): {
     readonly isLoading: boolean;
 };
 
+interface UseSpotOrderResult {
+    executeSpotOrder: (payload: SpotOrderRequestInput) => Promise<ApiResponse<SpotOrderResponseDto>>;
+    isLoading: boolean;
+    error: ApiErrorResponse | null;
+    resetError: () => void;
+}
+/**
+ * Hook for executing spot orders (swaps) on Hyperliquid
+ * Use this to swap between USDC and USDH or other spot assets
+ */
+declare function useSpotOrder(): UseSpotOrderResult;
+
 declare function useTwap(): {
     readonly orders: TwapMonitoringDto[];
     readonly cancelTwap: (orderId: string) => Promise<ApiResponse<CancelTwapResponseDto>>;
@@ -1057,14 +1224,16 @@ interface UseNotificationsResult {
  */
 declare function useNotifications(): UseNotificationsResult;
 
+type CollateralFilter = 'USDC' | 'USDH' | 'ALL';
 declare const useMarketDataPayload: () => ActiveAssetsResponse | null;
 declare const useMarketDataAllPayload: () => ActiveAssetsAllResponse | null;
-declare const useActiveBaskets: () => ActiveAssetGroupItem[];
-declare const useTopGainers: (limit?: number) => ActiveAssetGroupItem[];
-declare const useTopLosers: (limit?: number) => ActiveAssetGroupItem[];
-declare const useHighlightedBaskets: () => ActiveAssetGroupItem[];
-declare const useWatchlistBaskets: () => ActiveAssetGroupItem[];
-declare const useAllBaskets: () => ActiveAssetGroupItem[];
+declare const usePerpMetaAssets: () => UniverseAsset[] | null;
+declare const useActiveBaskets: (collateralFilter?: CollateralFilter) => ActiveAssetGroupItem[];
+declare const useTopGainers: (limit?: number, collateralFilter?: CollateralFilter) => ActiveAssetGroupItem[];
+declare const useTopLosers: (limit?: number, collateralFilter?: CollateralFilter) => ActiveAssetGroupItem[];
+declare const useHighlightedBaskets: (collateralFilter?: CollateralFilter) => ActiveAssetGroupItem[];
+declare const useWatchlistBaskets: (collateralFilter?: CollateralFilter) => ActiveAssetGroupItem[];
+declare const useAllBaskets: (collateralFilter?: CollateralFilter) => ActiveAssetGroupItem[];
 declare const useFindBasket: (longs: string[], shorts: string[]) => ActiveAssetGroupItem | undefined;
 
 declare function useWatchlist(): {
@@ -1127,9 +1296,9 @@ declare function usePortfolio(): UsePortfolioResult;
 
 declare function useAuth(): {
     readonly isReady: boolean;
-    readonly isAuthenticated: any;
-    readonly accessToken: any;
-    readonly refreshToken: any;
+    readonly isAuthenticated: boolean;
+    readonly accessToken: string | null;
+    readonly refreshToken: string | null;
     readonly getEip712: (address: string) => Promise<GetEIP712MessageResponse>;
     readonly loginWithSignedMessage: (address: string, signature: string, timestamp: number) => Promise<void>;
     readonly loginWithPrivyToken: (address: string, appId: string, privyAccessToken: string) => Promise<void>;
@@ -1137,6 +1306,32 @@ declare function useAuth(): {
     readonly logout: () => Promise<void>;
 };
 
+interface AllUserBalances {
+    spotUsdcBalance: number | undefined;
+    availableToTradeUsdc: number | undefined;
+    spotUsdhBalance: number | undefined;
+    availableToTradeUsdh: number | undefined;
+    isLoading: boolean;
+}
+declare const useAllUserBalances: () => AllUserBalances;
+
+interface UseHyperliquidUserFillsOptions {
+    baseUrl: string;
+    address: string | null;
+    aggregateByTime?: boolean;
+}
+interface UseHyperliquidUserFillsState {
+    lastRunAt: number | null;
+    lastResult: SyncFillsResponseDto | null;
+    error: string | null;
+    isSyncing: boolean;
+    handleUserFillsEvent: () => Promise<void>;
+}
+/**
+ * Provides a callback to sync user fills whenever the native WebSocket emits a userFills event.
+ */
+declare function useHyperliquidUserFills(options: UseHyperliquidUserFillsOptions): UseHyperliquidUserFillsState;
+
 interface UseHyperliquidWebSocketProps {
     wsUrl: string;
     address: string | null;
@@ -1151,12 +1346,13 @@ interface UseHyperliquidNativeWebSocketProps {
     address: string | null;
     tokens?: string[];
     enabled?: boolean;
+    onUserFills?: () => void | Promise<void>;
 }
 interface UseHyperliquidNativeWebSocketReturn {
     isConnected: boolean;
     lastError: string | null;
 }
-declare const useHyperliquidNativeWebSocket: ({ address, enabled, }: UseHyperliquidNativeWebSocketProps) => UseHyperliquidNativeWebSocketReturn;
+declare const useHyperliquidNativeWebSocket: ({ address, enabled, onUserFills, }: UseHyperliquidNativeWebSocketProps) => UseHyperliquidNativeWebSocketReturn;
 
 /**
  * Mark notifications as read up to a given timestamp (ms)
@@ -1171,7 +1367,7 @@ declare function markNotificationReadById(baseUrl: string, id: string): Promise<
     updated: number;
 }>>;
 
-declare function toggleWatchlist(baseUrl: string, longAssets: WatchlistAssetDto[], shortAssets: WatchlistAssetDto[], displayToFull: Map<string, string>): Promise<ApiResponse<ToggleWatchlistResponseDto>>;
+declare function toggleWatchlist(baseUrl: string, longAssets: WatchlistAssetDto[], shortAssets: WatchlistAssetDto[], hip3Assets: Map<string, string[]>): Promise<ApiResponse<ToggleWatchlistResponseDto>>;
 
 /**
  * Account summary calculation utility class
@@ -1210,24 +1406,28 @@ declare class ConflictDetector {
 declare class TokenMetadataExtractor {
     /**
      * Extracts comprehensive token metadata
-     * @param symbol - Token symbol
+     * @param symbol - Token symbol (base symbol without prefix, e.g., "TSLA")
      * @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
+     * @param marketPrefix - Optional market prefix (e.g., "xyz", "flx") for HIP3 multi-market assets
      * @returns TokenMetadata or null if token not found
      */
-    static extractTokenMetadata(symbol: string, perpMetaAssets: UniverseAsset[] | null, finalAssetContexts: WebData3AssetCtx[] | 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, marketPrefix?: string | null): TokenMetadata | null;
     /**
      * Extracts metadata for multiple tokens
-     * @param symbols - Array of token symbols
+     * @param tokens - Array of token objects with symbol and optional marketPrefix
      * @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
+     * @returns Record of unique key to TokenMetadata. Key is "{prefix}:{symbol}" for HIP3 assets, or just "{symbol}" otherwise
      */
-    static extractMultipleTokensMetadata(symbols: string[], perpMetaAssets: UniverseAsset[] | null, finalAssetContexts: WebData3AssetCtx[] | null, allMids: WsAllMidsData | null, activeAssetData?: Record<string, ActiveAssetData> | null): Record<string, TokenMetadata | null>;
+    static extractMultipleTokensMetadata(tokens: Array<{
+        symbol: string;
+        marketPrefix?: string | null;
+    }>, 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 aggregated universe assets
      * @param symbol - Token symbol
@@ -1331,7 +1531,112 @@ declare function validatePositionSize(usdValue: number, longAssets?: PairAssetIn
     minimumRequired?: number;
 };
 
-declare const useMarketData: any;
+/**
+ * Convert a full/prefixed symbol (e.g., "xyz:XYZ100") to a display symbol (e.g., "XYZ100").
+ */
+declare function toDisplaySymbol(symbol: string): string;
+/**
+ * Convert a display symbol back to backend form using a provided map.
+ * If mapping is missing, returns the original symbol.
+ * For multi-market assets, returns the first available market.
+ * @param displaySymbol e.g., "TSLA"
+ * @param hip3Assets map of display -> all full market names (e.g., "TSLA" -> ["xyz:TSLA", "flx:TSLA"])
+ */
+declare function toBackendSymbol(displaySymbol: string, hip3Assets: Map<string, string[]>): string;
+/**
+ * Convert a display symbol to backend form for a specific market prefix.
+ * This is useful when an asset is available on multiple markets (e.g., xyz:TSLA and flx:TSLA).
+ * @param displaySymbol e.g., "TSLA"
+ * @param marketPrefix e.g., "xyz" or "flx"
+ * @param hip3Assets map of display -> all full market names
+ * @returns Full market name if found, null if prefix not specified for multi-market asset, otherwise displaySymbol with prefix
+ */
+declare function toBackendSymbolWithMarket(displaySymbol: string, marketPrefix: string | undefined, hip3Assets: Map<string, string[]>): string | null;
+/**
+ * Get all available markets for a display symbol.
+ * @param displaySymbol e.g., "TSLA"
+ * @param hip3Assets map of display -> all full market names
+ * @returns Array of full market names, e.g., ["xyz:TSLA", "flx:TSLA"]
+ */
+declare function getAvailableMarkets(displaySymbol: string, hip3Assets: Map<string, string[]>): string[];
+/**
+ * Extract the market prefix from a full market name.
+ * @param fullSymbol e.g., "xyz:TSLA"
+ * @returns The prefix (e.g., "xyz") or undefined if no prefix
+ */
+declare function getMarketPrefix(fullSymbol: string): string | undefined;
+/**
+ * Check if a symbol is a HIP-3 market (has a prefix).
+ * @param symbol e.g., "xyz:TSLA" or "TSLA"
+ * @returns true if the symbol has a market prefix
+ */
+declare function isHip3Market(symbol: string): boolean;
+
+/**
+ * Helper functions to safely extract values from order parameters
+ * based on the order type and parameter structure.
+ */
+/**
+ * Get leverage from order parameters (available for Market, Trigger, Twap, Ladder orders)
+ */
+declare function getOrderLeverage(order: OpenLimitOrderDto): number | undefined;
+/**
+ * Get USD value from order parameters (available for Market, Trigger, Twap, Ladder orders)
+ */
+declare function getOrderUsdValue(order: OpenLimitOrderDto): number | undefined;
+/**
+ * Get trigger value from order parameters (available for TP/SL and Trigger orders)
+ */
+declare function getOrderTriggerValue(order: OpenLimitOrderDto): number | undefined;
+/**
+ * Get TP/SL trigger type from order parameters (only for TP/SL orders)
+ */
+declare function getOrderTpSlTriggerType(order: OpenLimitOrderDto): TpSlTriggerType | undefined;
+/**
+ * Get trigger type from order parameters (for Trigger orders)
+ */
+declare function getOrderTriggerType(order: OpenLimitOrderDto): TriggerType$1 | undefined;
+/**
+ * Get order direction from order parameters (for Trigger orders)
+ */
+declare function getOrderDirection(order: OpenLimitOrderDto): OrderDirection | undefined;
+/**
+ * Get reduce only flag from order parameters (available for all order types)
+ */
+declare function getOrderReduceOnly(order: OpenLimitOrderDto): boolean;
+/**
+ * Get TWAP duration from order parameters (only for TWAP orders)
+ */
+declare function getOrderTwapDuration(order: OpenLimitOrderDto): string | undefined;
+/**
+ * Get ladder config from order parameters (only for Ladder orders)
+ */
+declare function getOrderLadderConfig(order: OpenLimitOrderDto): {
+    ratioStart: number;
+    ratioEnd: number;
+    numberOfLevels: number;
+} | undefined;
+/**
+ * Check if the order is a BTC Dominance trigger order
+ */
+declare function isBtcDomOrder(order: OpenLimitOrderDto): boolean;
+/**
+ * Get trailing info from TP/SL order parameters
+ */
+declare function getOrderTrailingInfo(order: OpenLimitOrderDto): {
+    isTrailing: boolean;
+    trailingDeltaValue?: number;
+    trailingActivationValue?: number;
+} | undefined;
+
+interface MarketDataState {
+    marketData: ActiveAssetsResponse | null;
+    marketDataAll: ActiveAssetsAllResponse | null;
+    setMarketData: (value: ActiveAssetsResponse | null) => void;
+    setMarketDataAll: (value: ActiveAssetsAllResponse | null) => void;
+    clean: () => void;
+}
+declare const useMarketData: zustand.UseBoundStore<zustand.StoreApi<MarketDataState>>;
 
-export { AccountSummaryCalculator, ConflictDetector, MAX_ASSETS_PER_LEG, MINIMUM_ASSET_USD_VALUE, MaxAssetsPerLegError, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, getPortfolio, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toggleWatchlist, updateLeverage, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePortfolio, usePosition, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMaxAssetsPerLeg, 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, CreatePositionRequestInput, CreatePositionResponseDto, CrossMarginSummaryDto, CumFundingDto, ExecutionType, ExtraAgent, HLWebSocketResponse, HistoricalRange, LadderConfigInput, MarginSummaryDto, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetDto, PairAssetInput, PerformanceOverlay, PlatformAccountSummaryResponseDto, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, ToggleWatchlistResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, TwapSliceFillResponseItem, UniverseAsset, UpdateLeverageRequestInput, UpdateLeverageResponseDto, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };
+export { AccountSummaryCalculator, ConflictDetector, MAX_ASSETS_PER_LEG, MINIMUM_ASSET_USD_VALUE, MaxAssetsPerLegError, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getAvailableMarkets, getCompleteTimestamps, getMarketPrefix, getOrderDirection, getOrderLadderConfig, getOrderLeverage, getOrderReduceOnly, getOrderTpSlTriggerType, getOrderTrailingInfo, getOrderTriggerType, getOrderTriggerValue, getOrderTwapDuration, getOrderUsdValue, getPortfolio, isBtcDomOrder, isHip3Market, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toBackendSymbol, toBackendSymbolWithMarket, toDisplaySymbol, toggleWatchlist, updateLeverage, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAllUserBalances, useAuth, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidUserFills, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePerpMetaAssets, usePortfolio, usePosition, useSpotOrder, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMaxAssetsPerLeg, validateMinimumAssetSize, validatePositionSize };
+export type { AccountSummaryResponseDto, ActiveAssetGroupItem, ActiveAssetsResponse, AdjustAdvanceAssetInput, AdjustAdvanceItemInput, AdjustAdvanceResponseDto, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, 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, RealtimeBar, RealtimeBarsCallback, SpotBalance, SpotOrderFilledStatus, SpotOrderHyperliquidData, SpotOrderHyperliquidResult, SpotOrderRequestInput, SpotOrderResponseDto, SpotState, ToggleWatchlistResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlOrderParameters, TpSlThresholdInput, TpSlThresholdType, TpSlTriggerType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TriggerOrderParameters, TriggerType, TwapChunkStatusDto, TwapMonitoringDto, TwapSliceFillResponseItem, UniverseAsset, UpdateLeverageRequestInput, UpdateLeverageResponseDto, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseHyperliquidUserFillsOptions, UseHyperliquidUserFillsState, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseSpotOrderResult, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };