@pear-protocol/hyperliquid-sdk 0.0.73-beta.2 → 0.0.73-beta.4

package/dist/clients/hyperliquid.d.ts

@@ -2,7 +2,7 @@ import type { ApiResponse, CandleInterval, CandleData, ExternalFillDto, AllPerpM
 /**
  * Fetch historical candle data from HyperLiquid API
  */
-export declare const fetchHistoricalCandles: (coin: string, startTime: number, endTime: number, interval: CandleInterval, displayToFull: Map<string, string>) => Promise<ApiResponse<CandleData[]>>;
+export declare const fetchHistoricalCandles: (coin: string, startTime: number, endTime: number, interval: CandleInterval, hip3Assets: Map<string, string[]>) => Promise<ApiResponse<CandleData[]>>;
 /**
  * Retrieve recent user fills from HyperLiquid and map to ExternalFillDto[]
  */

package/dist/clients/orders.d.ts

@@ -22,3 +22,44 @@ export interface CancelTwapResponseDto {
     cancelledAt: string;
 }
 export declare function cancelTwapOrder(baseUrl: string, orderId: string): Promise<ApiResponse<CancelTwapResponseDto>>;
+export 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 */
+export interface SpotOrderFilledStatus {
+    filled: {
+        totalSz: string;
+        avgPx: string;
+        oid: number;
+        cloid: string;
+    };
+}
+/** Hyperliquid order response data */
+export interface SpotOrderHyperliquidData {
+    statuses: SpotOrderFilledStatus[];
+}
+/** Hyperliquid result from spot order execution */
+export interface SpotOrderHyperliquidResult {
+    status: 'ok' | 'error';
+    response: {
+        type: 'order';
+        data: SpotOrderHyperliquidData;
+    };
+}
+export 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
+ */
+export declare function executeSpotOrder(baseUrl: string, payload: SpotOrderRequestInput): Promise<ApiResponse<SpotOrderResponseDto>>;

package/dist/clients/positions.d.ts

@@ -57,7 +57,7 @@ export interface CreatePositionResponseDto {
  * @throws MinimumPositionSizeError if any asset has less than $11 USD value
  * @throws MaxAssetsPerLegError if any leg exceeds the maximum allowed assets (15)
  */
-export declare function createPosition(baseUrl: string, payload: CreatePositionRequestInput, displayToFull: Map<string, string>): Promise<ApiResponse<CreatePositionResponseDto>>;
+export declare function createPosition(baseUrl: string, payload: CreatePositionRequestInput, hip3Assets: Map<string, string[]>): Promise<ApiResponse<CreatePositionResponseDto>>;
 export interface UpdateRiskParametersRequestInput {
     stopLoss?: TpSlThresholdInput | null;
     takeProfit?: TpSlThresholdInput | null;
@@ -124,7 +124,7 @@ export interface AdjustAdvanceResponseDto {
     status: string;
     executedAt: string;
 }
-export declare function adjustAdvancePosition(baseUrl: string, positionId: string, payload: AdjustAdvanceItemInput[], displayToFull: Map<string, string>): Promise<ApiResponse<AdjustAdvanceResponseDto>>;
+export declare function adjustAdvancePosition(baseUrl: string, positionId: string, payload: AdjustAdvanceItemInput[], hip3Assets: Map<string, string[]>): Promise<ApiResponse<AdjustAdvanceResponseDto>>;
 export declare function cancelTwap(baseUrl: string, orderId: string): Promise<ApiResponse<CancelTwapResponseDto>>;
 export interface UpdateLeverageRequestInput {
     leverage: number;

package/dist/clients/watchlist.d.ts

@@ -1,2 +1,2 @@
 import type { ApiResponse, ToggleWatchlistResponseDto, WatchlistAssetDto } from '../types';
-export declare function toggleWatchlist(baseUrl: string, longAssets: WatchlistAssetDto[], shortAssets: WatchlistAssetDto[], displayToFull: Map<string, string>): Promise<ApiResponse<ToggleWatchlistResponseDto>>;
+export declare function toggleWatchlist(baseUrl: string, longAssets: WatchlistAssetDto[], shortAssets: WatchlistAssetDto[], hip3Assets: Map<string, string[]>): Promise<ApiResponse<ToggleWatchlistResponseDto>>;

package/dist/hooks/index.d.ts

@@ -10,9 +10,11 @@ export * from './useAgentWallet';
 export * from './useAutoSyncFills';
 export * from './usePosition';
 export * from './useOrders';
+export * from './useSpotOrder';
 export * from './useTwap';
 export * from './useNotifications';
 export * from './useMarketData';
 export * from './useWatchlist';
 export * from './usePortfolio';
 export * from './useAuth';
+export * from './useAllUserBalances';

package/dist/hooks/useAllUserBalances.d.ts

@@ -0,0 +1,9 @@
+interface AllUserBalances {
+    spotUsdcBalance: number | undefined;
+    availableToTradeUsdc: number | undefined;
+    spotUsdhBalance: number | undefined;
+    availableToTradeUsdh: number | undefined;
+    isLoading: boolean;
+}
+export declare const useAllUserBalances: () => AllUserBalances;
+export {};

package/dist/hooks/useMarketData.d.ts

@@ -1,10 +1,12 @@
-import type { ActiveAssetGroupItem, ActiveAssetsResponse, ActiveAssetsAllResponse } from '../types';
+import type { ActiveAssetGroupItem, ActiveAssetsResponse, ActiveAssetsAllResponse, UniverseAsset } from '../types';
+export type CollateralFilter = 'USDC' | 'USDH' | 'ALL';
 export declare const useMarketDataPayload: () => ActiveAssetsResponse | null;
 export declare const useMarketDataAllPayload: () => ActiveAssetsAllResponse | null;
-export declare const useActiveBaskets: () => ActiveAssetGroupItem[];
-export declare const useTopGainers: (limit?: number) => ActiveAssetGroupItem[];
-export declare const useTopLosers: (limit?: number) => ActiveAssetGroupItem[];
-export declare const useHighlightedBaskets: () => ActiveAssetGroupItem[];
-export declare const useWatchlistBaskets: () => ActiveAssetGroupItem[];
-export declare const useAllBaskets: () => ActiveAssetGroupItem[];
+export declare const usePerpMetaAssets: () => UniverseAsset[] | null;
+export declare const useActiveBaskets: (collateralFilter?: CollateralFilter) => ActiveAssetGroupItem[];
+export declare const useTopGainers: (limit?: number, collateralFilter?: CollateralFilter) => ActiveAssetGroupItem[];
+export declare const useTopLosers: (limit?: number, collateralFilter?: CollateralFilter) => ActiveAssetGroupItem[];
+export declare const useHighlightedBaskets: (collateralFilter?: CollateralFilter) => ActiveAssetGroupItem[];
+export declare const useWatchlistBaskets: (collateralFilter?: CollateralFilter) => ActiveAssetGroupItem[];
+export declare const useAllBaskets: (collateralFilter?: CollateralFilter) => ActiveAssetGroupItem[];
 export declare const useFindBasket: (longs: string[], shorts: string[]) => ActiveAssetGroupItem | undefined;

package/dist/hooks/useSpotOrder.d.ts

@@ -0,0 +1,13 @@
+import type { ApiResponse, ApiErrorResponse } from '../types';
+import { type SpotOrderRequestInput, type SpotOrderResponseDto } from '../clients/orders';
+export 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
+ */
+export declare function useSpotOrder(): UseSpotOrderResult;

package/dist/hooks/useTrading.d.ts

@@ -4,9 +4,6 @@ export declare const useTradeHistories: () => {
     data: TradeHistoryDataDto[] | null;
     isLoading: boolean;
 };
-/**
- * Hook to access open orders with loading state
- */
 export declare const useOpenOrders: () => {
     data: OpenLimitOrderDto[] | null;
     isLoading: boolean;

package/dist/hooks/useWebData.d.ts

@@ -1,12 +1,30 @@
-import type { AssetMarketData, ClearinghouseState } from '../types';
+import type { ClearinghouseState, MarketDataBySymbol } from '../types';
 /**
  * Hook to access webData and native WebSocket state
  */
 export 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;
 };