@pear-protocol/hyperliquid-sdk 0.0.60-beta-usdh-1 → 0.0.60-beta-usdh-2

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/hooks/index.d.ts

@@ -10,6 +10,7 @@ export * from './useAgentWallet';
 export * from './useAutoSyncFills';
 export * from './usePosition';
 export * from './useOrders';
+export * from './useSpotOrder';
 export * from './useTwap';
 export * from './useNotifications';
 export * from './useMarketData';

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/index.d.ts

@@ -922,6 +922,47 @@ 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";
@@ -1068,6 +1109,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>>;
@@ -1392,5 +1445,5 @@ declare function isHip3Market(symbol: string): boolean;
 
 declare const useMarketData: any;
 
-export { AccountSummaryCalculator, ConflictDetector, MINIMUM_ASSET_USD_VALUE, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, getAvailableMarkets, getCompleteTimestamps, getMarketPrefix, getPortfolio, isHip3Market, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toBackendSymbol, toBackendSymbolWithMarket, toDisplaySymbol, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePerpMetaAssets, usePortfolio, usePosition, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMinimumAssetSize, validatePositionSize };
-export type { AccountSummaryResponseDto, ActiveAssetGroupItem, ActiveAssetsResponse, AdjustAdvanceAssetInput, AdjustAdvanceItemInput, AdjustAdvanceResponseDto, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, AutoSyncFillsOptions, AutoSyncFillsState, BalanceSummaryDto, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ClearinghouseState, CloseAllPositionsResponseDto, CloseAllPositionsResultDto, CloseExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CollateralFilter, CollateralToken, CreatePositionRequestInput, CreatePositionResponseDto, CrossMarginSummaryDto, CumFundingDto, ExecutionType, ExtraAgent, HLWebSocketResponse, HistoricalRange, LadderConfigInput, MarginSummaryDto, MarketDataBySymbol, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetDto, PairAssetInput, PerformanceOverlay, PlatformAccountSummaryResponseDto, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, ToggleWatchlistResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, TwapSliceFillResponseItem, UniverseAsset, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };
+export { AccountSummaryCalculator, ConflictDetector, MINIMUM_ASSET_USD_VALUE, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getAvailableMarkets, getCompleteTimestamps, getMarketPrefix, getPortfolio, isHip3Market, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toBackendSymbol, toBackendSymbolWithMarket, toDisplaySymbol, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePerpMetaAssets, usePortfolio, usePosition, useSpotOrder, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMinimumAssetSize, validatePositionSize };
+export type { AccountSummaryResponseDto, ActiveAssetGroupItem, ActiveAssetsResponse, AdjustAdvanceAssetInput, AdjustAdvanceItemInput, AdjustAdvanceResponseDto, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, AutoSyncFillsOptions, AutoSyncFillsState, BalanceSummaryDto, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ClearinghouseState, CloseAllPositionsResponseDto, CloseAllPositionsResultDto, CloseExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CollateralFilter, CollateralToken, CreatePositionRequestInput, CreatePositionResponseDto, CrossMarginSummaryDto, CumFundingDto, ExecutionType, ExtraAgent, HLWebSocketResponse, HistoricalRange, LadderConfigInput, MarginSummaryDto, MarketDataBySymbol, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetDto, PairAssetInput, PerformanceOverlay, PlatformAccountSummaryResponseDto, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, SpotOrderFilledStatus, SpotOrderHyperliquidData, SpotOrderHyperliquidResult, SpotOrderRequestInput, SpotOrderResponseDto, ToggleWatchlistResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, TwapSliceFillResponseItem, UniverseAsset, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseSpotOrderResult, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };

package/dist/index.js

@@ -6981,8 +6981,15 @@ function usePosition() {
 async function adjustOrder(baseUrl, orderId, payload) {
     const url = joinUrl(baseUrl, `/orders/${orderId}/adjust`);
     try {
-        const resp = await apiClient.put(url, payload, { headers: { 'Content-Type': 'application/json' }, timeout: 60000 });
-        return { data: resp.data, status: resp.status, headers: resp.headers };
+        const resp = await apiClient.put(url, payload, {
+            headers: { 'Content-Type': 'application/json' },
+            timeout: 60000,
+        });
+        return {
+            data: resp.data,
+            status: resp.status,
+            headers: resp.headers,
+        };
     }
     catch (error) {
         throw toApiError(error);
@@ -6991,8 +6998,14 @@ async function adjustOrder(baseUrl, orderId, payload) {
 async function cancelOrder(baseUrl, orderId) {
     const url = joinUrl(baseUrl, `/orders/${orderId}/cancel`);
     try {
-        const resp = await apiClient.delete(url, { timeout: 60000 });
-        return { data: resp.data, status: resp.status, headers: resp.headers };
+        const resp = await apiClient.delete(url, {
+            timeout: 60000,
+        });
+        return {
+            data: resp.data,
+            status: resp.status,
+            headers: resp.headers,
+        };
     }
     catch (error) {
         throw toApiError(error);
@@ -7002,7 +7015,32 @@ async function cancelTwapOrder(baseUrl, orderId) {
     const url = joinUrl(baseUrl, `/orders/${orderId}/twap/cancel`);
     try {
         const resp = await apiClient.post(url, {}, { headers: { 'Content-Type': 'application/json' }, timeout: 60000 });
-        return { data: resp.data, status: resp.status, headers: resp.headers };
+        return {
+            data: resp.data,
+            status: resp.status,
+            headers: resp.headers,
+        };
+    }
+    catch (error) {
+        throw toApiError(error);
+    }
+}
+/**
+ * Execute a spot order (swap) using Pear Hyperliquid service
+ * POST /orders/spot
+ */
+async function executeSpotOrder(baseUrl, payload) {
+    const url = joinUrl(baseUrl, '/orders/spot');
+    try {
+        const resp = await apiClient.post(url, payload, {
+            headers: { 'Content-Type': 'application/json' },
+            timeout: 60000,
+        });
+        return {
+            data: resp.data,
+            status: resp.status,
+            headers: resp.headers,
+        };
     }
     catch (error) {
         throw toApiError(error);
@@ -7058,6 +7096,45 @@ function useOrders() {
     return { adjustOrder: adjustOrder$1, cancelOrder: cancelOrder$1, cancelTwapOrder: cancelTwapOrder$1, openOrders: enrichedOpenOrders, isLoading };
 }
 
+/**
+ * Hook for executing spot orders (swaps) on Hyperliquid
+ * Use this to swap between USDC and USDH or other spot assets
+ */
+function useSpotOrder() {
+    const context = useContext(PearHyperliquidContext);
+    if (!context) {
+        throw new Error('useSpotOrder must be used within a PearHyperliquidProvider');
+    }
+    const { apiBaseUrl } = context;
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const resetError = useCallback(() => {
+        setError(null);
+    }, []);
+    const executeSpotOrder$1 = useCallback(async (payload) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const response = await executeSpotOrder(apiBaseUrl, payload);
+            return response;
+        }
+        catch (err) {
+            const apiError = err;
+            setError(apiError);
+            throw apiError;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [apiBaseUrl]);
+    return {
+        executeSpotOrder: executeSpotOrder$1,
+        isLoading,
+        error,
+        resetError,
+    };
+}
+
 function useTwap() {
     const twapDetails = useUserData(state => state.twapDetails);
     const context = useContext(PearHyperliquidContext);
@@ -7816,4 +7893,4 @@ function mapCandleIntervalToTradingViewInterval(interval) {
     }
 }
 
-export { AccountSummaryCalculator, ConflictDetector, MINIMUM_ASSET_USD_VALUE, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, getAvailableMarkets, getCompleteTimestamps, getMarketPrefix, getPortfolio, isHip3Market, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toBackendSymbol, toBackendSymbolWithMarket, toDisplaySymbol, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePerpMetaAssets, usePortfolio, usePosition, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMinimumAssetSize, validatePositionSize };
+export { AccountSummaryCalculator, ConflictDetector, MINIMUM_ASSET_USD_VALUE, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getAvailableMarkets, getCompleteTimestamps, getMarketPrefix, getPortfolio, isHip3Market, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toBackendSymbol, toBackendSymbolWithMarket, toDisplaySymbol, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAuth, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePerpMetaAssets, usePortfolio, usePosition, useSpotOrder, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMinimumAssetSize, validatePositionSize };

package/package.json

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