@pear-protocol/hyperliquid-sdk 0.0.43 → 0.0.44

package/dist/clients/watchlist.d.ts

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

package/dist/hooks/index.d.ts

@@ -14,3 +14,4 @@ export * from './useOrders';
 export * from './useTwap';
 export * from './useNotifications';
 export * from './useMarketData';
+export * from './useWatchlist';

package/dist/hooks/useMarketData.d.ts

@@ -4,4 +4,5 @@ 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 useFindBasket: (longs: string[], shorts: string[]) => ActiveAssetGroupItem | undefined;

package/dist/hooks/useWatchlist.d.ts

@@ -0,0 +1,6 @@
+import type { ApiResponse, ToggleWatchlistResponseDto, WatchlistAssetDto, ActiveAssetGroupItem } from '../types';
+export declare function useWatchlist(): {
+    readonly watchlists: ActiveAssetGroupItem[] | null;
+    readonly isLoading: boolean;
+    readonly toggle: (longAssets: WatchlistAssetDto[], shortAssets: WatchlistAssetDto[]) => Promise<ApiResponse<ToggleWatchlistResponseDto>>;
+};

package/dist/index.d.ts

@@ -53,6 +53,18 @@ interface WebSocketDataMessage<T = unknown> {
     channel: WebSocketChannel;
     data: T;
 }
+interface WatchlistAssetDto {
+    asset: string;
+    weight: number;
+}
+interface WatchlistItemDto {
+    id: string;
+    longAssets: WatchlistAssetDto[];
+    shortAssets: WatchlistAssetDto[];
+}
+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';
 interface NotificationDto {
     id: string;
@@ -532,6 +544,7 @@ interface ActiveAssetsResponse {
     topGainers: ActiveAssetGroupItem[];
     topLosers: ActiveAssetGroupItem[];
     highlighted: ActiveAssetGroupItem[];
+    watchlist: ActiveAssetGroupItem[];
 }
 /**
  * Candle interval options
@@ -1011,8 +1024,15 @@ 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 useFindBasket: (longs: string[], shorts: string[]) => ActiveAssetGroupItem | undefined;
 
+declare function useWatchlist(): {
+    readonly watchlists: ActiveAssetGroupItem[] | null;
+    readonly isLoading: boolean;
+    readonly toggle: (longAssets: WatchlistAssetDto[], shortAssets: WatchlistAssetDto[]) => Promise<ApiResponse<ToggleWatchlistResponseDto>>;
+};
+
 interface UseHyperliquidWebSocketProps {
     wsUrl: string;
     address: string | null;
@@ -1047,6 +1067,8 @@ declare function markNotificationReadById(baseUrl: string, accessToken: string,
     updated: number;
 }>>;
 
+declare function toggleWatchlist(baseUrl: string, accessToken: string, longAssets: WatchlistAssetDto[], shortAssets: WatchlistAssetDto[]): Promise<ApiResponse<ToggleWatchlistResponseDto>>;
+
 /**
  * Account summary calculation utility class
  */
@@ -1151,5 +1173,5 @@ declare function mapCandleIntervalToTradingViewInterval(interval: CandleInterval
 
 declare const useMarketData: any;
 
-export { AccountSummaryCalculator, AuthStatus, ConflictDetector, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, updateRiskParameters, useAccountSummary, useActiveBaskets, useAddress, useAgentWallet, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePosition, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWebData };
-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, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, UniverseAsset, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAgentWalletOptions, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WebData2Response, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };
+export { AccountSummaryCalculator, AuthStatus, ConflictDetector, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAddress, useAgentWallet, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePosition, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData };
+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, 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, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebData2Response, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };

package/dist/index.js

@@ -2459,7 +2459,7 @@ const useMarketData = create((set) => ({
 
 const useHyperliquidWebSocket = ({ wsUrl, address }) => {
     const { setTradeHistories, setRawOpenPositions, setOpenOrders, setAccountSummary, setTwapDetails, setNotifications, clean, } = useUserData();
-    const { setMarketData, clean: cleanMarketData } = useMarketData();
+    const { setMarketData } = useMarketData();
     const [lastError, setLastError] = useState(null);
     const [lastSubscribedAddress, setLastSubscribedAddress] = useState(null);
     // WebSocket connection
@@ -8771,6 +8771,12 @@ const useHighlightedBaskets = () => {
     const data = useMarketDataPayload();
     return (_a = data === null || data === void 0 ? void 0 : data.highlighted) !== null && _a !== void 0 ? _a : [];
 };
+// Watchlist baskets (from market-data payload when subscribed with address)
+const useWatchlistBaskets = () => {
+    var _a;
+    const data = useMarketDataPayload();
+    return (_a = data === null || data === void 0 ? void 0 : data.watchlist) !== null && _a !== void 0 ? _a : [];
+};
 // Find a basket by its exact asset composition (order-insensitive)
 const useFindBasket = (longs, shorts) => {
     const data = useMarketDataPayload();
@@ -8792,6 +8798,35 @@ const useFindBasket = (longs, shorts) => {
     }, [data, longs, shorts]);
 };
 
+async function toggleWatchlist(baseUrl, accessToken, longAssets, shortAssets) {
+    const url = joinUrl(baseUrl, '/watchlist');
+    try {
+        const response = await axios$1.post(url, { longAssets, shortAssets }, { headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${accessToken}` } });
+        return { data: response.data, status: response.status, headers: response.headers };
+    }
+    catch (error) {
+        throw toApiError(error);
+    }
+}
+
+function useWatchlist() {
+    const context = useContext(PearHyperliquidContext);
+    if (!context)
+        throw new Error('useWatchlist must be used within a PearHyperliquidProvider');
+    const { apiBaseUrl, accessToken, isConnected } = context;
+    const marketData = useMarketDataPayload();
+    const isLoading = useMemo(() => !marketData && isConnected, [marketData, isConnected]);
+    const toggle = async (longAssets, shortAssets) => {
+        if (!accessToken)
+            throw new Error('Not authenticated');
+        const resp = await toggleWatchlist(apiBaseUrl, accessToken, longAssets, shortAssets);
+        // Server will push updated market-data over WS; nothing to set here
+        return resp;
+    };
+    const watchlists = marketData === null || marketData === void 0 ? void 0 : marketData.watchlist;
+    return { watchlists: watchlists !== null && watchlists !== void 0 ? watchlists : null, isLoading, toggle };
+}
+
 const PearHyperliquidContext = createContext(undefined);
 /**
  * React Provider for PearHyperliquidClient
@@ -9090,4 +9125,4 @@ function mapCandleIntervalToTradingViewInterval(interval) {
     }
 }
 
-export { AccountSummaryCalculator, AuthStatus, ConflictDetector, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, updateRiskParameters, useAccountSummary, useActiveBaskets, useAddress, useAgentWallet, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePosition, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWebData };
+export { AccountSummaryCalculator, AuthStatus, ConflictDetector, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAddress, useAgentWallet, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePosition, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData };

package/dist/types.d.ts

@@ -74,6 +74,18 @@ export interface WebSocketDataMessage<T = unknown> {
     channel: WebSocketChannel;
     data: T;
 }
+export interface WatchlistAssetDto {
+    asset: string;
+    weight: number;
+}
+export interface WatchlistItemDto {
+    id: string;
+    longAssets: WatchlistAssetDto[];
+    shortAssets: WatchlistAssetDto[];
+}
+export interface ToggleWatchlistResponseDto {
+    items: WatchlistItemDto[];
+}
 export type NotificationCategory = 'TRADE_OPENED_OUTSIDE_PEAR' | 'TRADE_CLOSED_OUTSIDE_PEAR' | 'POSITION_LIQUIDATED' | 'LIMIT_ORDER_FILLED' | 'LIMIT_ORDER_FAILED' | 'TP_ORDER_FILLED' | 'TP_ORDER_FAILED' | 'SL_ORDER_FILLED' | 'SL_ORDER_FAILED';
 export interface NotificationDto {
     id: string;
@@ -617,6 +629,7 @@ export interface ActiveAssetsResponse {
     topGainers: ActiveAssetGroupItem[];
     topLosers: ActiveAssetGroupItem[];
     highlighted: ActiveAssetGroupItem[];
+    watchlist: ActiveAssetGroupItem[];
 }
 /**
  * Candle interval options

package/package.json

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