@pear-protocol/hyperliquid-sdk 0.1.18 → 0.1.19

package/dist/hooks/usePosition.d.ts

@@ -1,5 +1,24 @@
 import { type UpdateRiskParametersRequestInput, type UpdateRiskParametersResponseDto, type ClosePositionRequestInput, type ClosePositionResponseDto, type CloseAllPositionsResponseDto, type AdjustPositionRequestInput, type AdjustPositionResponseDto, type AdjustAdvanceItemInput, type AdjustAdvanceResponseDto, type UpdateLeverageResponseDto } from '../clients/positions';
 import type { ApiResponse, CreatePositionRequestInput, CreatePositionResponseDto, OpenPositionDto } from '../types';
+export interface RebalanceAssetPlan {
+    coin: string;
+    side: 'long' | 'short';
+    currentWeight: number;
+    targetWeight: number;
+    currentValue: number;
+    targetValue: number;
+    deltaValue: number;
+    currentSize: number;
+    newSize: number;
+    deltaSize: number;
+    skipped: boolean;
+    skipReason?: string;
+}
+export interface RebalancePlan {
+    positionId: string;
+    assets: RebalanceAssetPlan[];
+    canExecute: boolean;
+}
 export declare function usePosition(): {
     readonly createPosition: (payload: CreatePositionRequestInput) => Promise<ApiResponse<CreatePositionResponseDto>>;
     readonly updateRiskParameters: (positionId: string, payload: UpdateRiskParametersRequestInput) => Promise<ApiResponse<UpdateRiskParametersResponseDto>>;
@@ -10,4 +29,6 @@ export declare function usePosition(): {
     readonly updateLeverage: (positionId: string, leverage: number) => Promise<ApiResponse<UpdateLeverageResponseDto | null>>;
     readonly openPositions: OpenPositionDto[] | null;
     readonly isLoading: boolean;
+    readonly planRebalance: (positionId: string, targetWeights?: Record<string, number>) => RebalancePlan;
+    readonly executeRebalance: (positionId: string, targetWeights?: Record<string, number>) => Promise<ApiResponse<AdjustAdvanceResponseDto>>;
 };

package/dist/index.d.ts

@@ -286,6 +286,7 @@ interface PositionAssetDetailDto {
     initialWeight: number;
     currentWeight: number;
     fundingPaid?: number;
+    targetWeight?: number;
     metadata?: TokenMetadata | null;
 }
 interface TpSlThreshold {
@@ -763,6 +764,7 @@ interface RawAssetDto {
     side: string;
     fundingPaid?: number;
     leverage: number;
+    targetWeight?: number;
 }
 /**
  * Raw position data from open-positions channel
@@ -1295,6 +1297,25 @@ interface UpdateLeverageResponseDto {
 }
 declare function updateLeverage(baseUrl: string, positionId: string, payload: UpdateLeverageRequestInput): Promise<ApiResponse<UpdateLeverageResponseDto | null>>;
 
+interface RebalanceAssetPlan {
+    coin: string;
+    side: 'long' | 'short';
+    currentWeight: number;
+    targetWeight: number;
+    currentValue: number;
+    targetValue: number;
+    deltaValue: number;
+    currentSize: number;
+    newSize: number;
+    deltaSize: number;
+    skipped: boolean;
+    skipReason?: string;
+}
+interface RebalancePlan {
+    positionId: string;
+    assets: RebalanceAssetPlan[];
+    canExecute: boolean;
+}
 declare function usePosition(): {
     readonly createPosition: (payload: CreatePositionRequestInput) => Promise<ApiResponse<CreatePositionResponseDto>>;
     readonly updateRiskParameters: (positionId: string, payload: UpdateRiskParametersRequestInput) => Promise<ApiResponse<UpdateRiskParametersResponseDto>>;
@@ -1305,6 +1326,8 @@ declare function usePosition(): {
     readonly updateLeverage: (positionId: string, leverage: number) => Promise<ApiResponse<UpdateLeverageResponseDto | null>>;
     readonly openPositions: OpenPositionDto[] | null;
     readonly isLoading: boolean;
+    readonly planRebalance: (positionId: string, targetWeights?: Record<string, number>) => RebalancePlan;
+    readonly executeRebalance: (positionId: string, targetWeights?: Record<string, number>) => Promise<ApiResponse<AdjustAdvanceResponseDto>>;
 };
 
 declare function useOrders(): {
@@ -1750,4 +1773,4 @@ interface MarketDataState {
 declare const useMarketData: zustand.UseBoundStore<zustand.StoreApi<MarketDataState>>;
 
 export { ConflictDetector, MAX_ASSETS_PER_LEG, MINIMUM_ASSET_USD_VALUE, MaxAssetsPerLegError, MinimumPositionSizeError, PearHyperliquidProvider, ReadyState, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getCompleteTimestamps, getKalshiMarkets, getOrderDirection, getOrderLadderConfig, getOrderLeverage, getOrderReduceOnly, getOrderTpSlTriggerType, getOrderTrailingInfo, getOrderTriggerType, getOrderTriggerValue, getOrderTwapDuration, getOrderUsdValue, getPortfolio, isBtcDomOrder, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toggleWatchlist, updateLeverage, updateRiskParameters, useAccountSummary, useAgentWallet, useAllUserBalances, useAuth, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidUserFills, useMarket, useMarketData, useMarketDataHook, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePortfolio, usePosition, useSpotOrder, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWatchlist, validateMaxAssetsPerLeg, validateMinimumAssetSize, validatePositionSize };
-export type { AccountSummaryResponseDto, ActiveAssetData, ActiveAssetGroupItem, ActiveAssetsAllResponse, ActiveAssetsResponse, AddressState, AdjustAdvanceAssetInput, AdjustAdvanceItemInput, AdjustAdvanceResponseDto, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, AgentWalletStatus, AllDexsAssetCtxsData, AllDexsClearinghouseStateData, AllPerpMetasItem, AllPerpMetasResponse, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, AuthenticateRequest, AuthenticateResponse, AvailableToTrades, BalanceSummaryDto, BaseTriggerOrderNotificationParams, BtcDomTriggerParams, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ChunkFillDto, ClearinghouseState, CloseAllPositionsResponseDto, CloseAllPositionsResultDto, CloseExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CollateralToken, CreateAgentWalletResponseDto, CreatePositionRequestInput, CreatePositionResponseDto, CrossAssetPriceTriggerParams, CrossMarginSummaryDto, CumFundingDto, EIP712AuthDetails, ExecutionType, ExternalFillDto, ExternalLiquidationDto, ExtraAgent, GetAgentWalletResponseDto, GetEIP712MessageResponse, GetKalshiMarketsParams, HLChannel, HLChannelDataMap, HLWebSocketResponse, HistoricalRange, KalshiMarket, KalshiMarketsResponse, KalshiMveLeg, KalshiPriceRange, LadderConfigInput, LadderOrderParameters, LeverageInfo, LogoutRequest, LogoutResponse, MarginRequiredPerCollateral, MarginRequiredResult, MarginSummaryDto, MarginTableDef, MarginTablesEntry, MarginTier, MarketOrderParameters, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderDirection, OrderParameters, OrderStatus, OrderType, PairAssetDto, PairAssetInput, PerformanceOverlay, PerpDex, PerpDexsResponse, PerpMetaAsset, PlatformAccountSummaryResponseDto, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PredictionMarketOutcomeTriggerParams, PriceRatioTriggerParams, PriceTriggerParams, PrivyAuthDetails, RawAssetDto, RawPositionDto, RealtimeBar, RealtimeBarsCallback, RefreshTokenRequest, RefreshTokenResponse, SpotBalance, SpotBalances, SpotOrderFilledStatus, SpotOrderHyperliquidData, SpotOrderHyperliquidResult, SpotOrderRequestInput, SpotOrderResponseDto, SpotState, SyncFillsRequestDto, SyncFillsResponseDto, ToggleWatchlistResponseDto, TokenConflict, TokenEntry, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TokenSelectorConfig, TpSlOrderParameters, TpSlThreshold, TpSlThresholdInput, TpSlThresholdType, TpSlTriggerType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TriggerOrderNotificationAsset, TriggerOrderNotificationParams, TriggerOrderNotificationType, TriggerOrderParameters, TriggerType, TwapChunkStatus, TwapChunkStatusDto, TwapMonitoringDto, TwapOrderOverallStatus, TwapOrderParameters, TwapSliceFillResponseItem, UniverseAsset, UpdateLeverageRequestInput, UpdateLeverageResponseDto, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseHyperliquidUserFillsOptions, UseHyperliquidUserFillsState, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseSpotOrderResult, UseTokenSelectionMetadataReturn, UserAbstraction, UserProfile, UserSelectionState, WatchlistAssetDto, WatchlistItemDto, WebData3AssetCtx, WebData3PerpDexState, WebData3Response, WebData3UserState, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };
+export type { AccountSummaryResponseDto, ActiveAssetData, ActiveAssetGroupItem, ActiveAssetsAllResponse, ActiveAssetsResponse, AddressState, AdjustAdvanceAssetInput, AdjustAdvanceItemInput, AdjustAdvanceResponseDto, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, AgentWalletStatus, AllDexsAssetCtxsData, AllDexsClearinghouseStateData, AllPerpMetasItem, AllPerpMetasResponse, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, AuthenticateRequest, AuthenticateResponse, AvailableToTrades, BalanceSummaryDto, BaseTriggerOrderNotificationParams, BtcDomTriggerParams, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ChunkFillDto, ClearinghouseState, CloseAllPositionsResponseDto, CloseAllPositionsResultDto, CloseExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CollateralToken, CreateAgentWalletResponseDto, CreatePositionRequestInput, CreatePositionResponseDto, CrossAssetPriceTriggerParams, CrossMarginSummaryDto, CumFundingDto, EIP712AuthDetails, ExecutionType, ExternalFillDto, ExternalLiquidationDto, ExtraAgent, GetAgentWalletResponseDto, GetEIP712MessageResponse, GetKalshiMarketsParams, HLChannel, HLChannelDataMap, HLWebSocketResponse, HistoricalRange, KalshiMarket, KalshiMarketsResponse, KalshiMveLeg, KalshiPriceRange, LadderConfigInput, LadderOrderParameters, LeverageInfo, LogoutRequest, LogoutResponse, MarginRequiredPerCollateral, MarginRequiredResult, MarginSummaryDto, MarginTableDef, MarginTablesEntry, MarginTier, MarketOrderParameters, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderDirection, OrderParameters, OrderStatus, OrderType, PairAssetDto, PairAssetInput, PerformanceOverlay, PerpDex, PerpDexsResponse, PerpMetaAsset, PlatformAccountSummaryResponseDto, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PredictionMarketOutcomeTriggerParams, PriceRatioTriggerParams, PriceTriggerParams, PrivyAuthDetails, RawAssetDto, RawPositionDto, RealtimeBar, RealtimeBarsCallback, RebalanceAssetPlan, RebalancePlan, RefreshTokenRequest, RefreshTokenResponse, SpotBalance, SpotBalances, SpotOrderFilledStatus, SpotOrderHyperliquidData, SpotOrderHyperliquidResult, SpotOrderRequestInput, SpotOrderResponseDto, SpotState, SyncFillsRequestDto, SyncFillsResponseDto, ToggleWatchlistResponseDto, TokenConflict, TokenEntry, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TokenSelectorConfig, TpSlOrderParameters, TpSlThreshold, TpSlThresholdInput, TpSlThresholdType, TpSlTriggerType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TriggerOrderNotificationAsset, TriggerOrderNotificationParams, TriggerOrderNotificationType, TriggerOrderParameters, TriggerType, TwapChunkStatus, TwapChunkStatusDto, TwapMonitoringDto, TwapOrderOverallStatus, TwapOrderParameters, TwapSliceFillResponseItem, UniverseAsset, UpdateLeverageRequestInput, UpdateLeverageResponseDto, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseHyperliquidUserFillsOptions, UseHyperliquidUserFillsState, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseSpotOrderResult, UseTokenSelectionMetadataReturn, UserAbstraction, UserProfile, UserSelectionState, WatchlistAssetDto, WatchlistItemDto, WebData3AssetCtx, WebData3PerpDexState, WebData3Response, WebData3UserState, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };

package/dist/index.js

@@ -1576,11 +1576,6 @@ const useAccountSummary = () => {
     const aggregatedClearingHouseState = useHyperliquidData((state) => state.aggregatedClearingHouseState);
     const registeredAgentWallets = useUserData((state) => state.userExtraAgents);
     const isLoading = useMemo(() => {
-        console.log('[USE ACCOUNT SUMMARY DEBUG] Loading check:', {
-            platformAccountSummary,
-            registeredAgentWallets,
-            aggregatedClearingHouseState,
-        });
         return !platformAccountSummary || !registeredAgentWallets || !aggregatedClearingHouseState;
     }, [platformAccountSummary, registeredAgentWallets, aggregatedClearingHouseState]);
     // Create calculator and compute account summary
@@ -7098,6 +7093,7 @@ const calculatePositionAsset = (asset, currentPrice, totalInitialPositionSize, t
         initialWeight: totalInitialPositionSize > 0 ? entryNotional / totalInitialPositionSize : 0,
         currentWeight: totalCurrentPositionSize > 0 ? currentNotional / totalCurrentPositionSize : 0,
         fundingPaid: (_a = asset.fundingPaid) !== null && _a !== void 0 ? _a : 0,
+        targetWeight: asset.targetWeight,
         metadata,
     };
 };
@@ -7203,6 +7199,7 @@ const buildPositionValue = (rawPositions, clearinghouseState, getAssetByName) =>
     });
 };
 
+const MIN_TRADE_SIZE_USD = 11;
 function usePosition() {
     const context = useContext(PearHyperliquidContext);
     if (!context) {
@@ -7245,6 +7242,85 @@ function usePosition() {
             return null;
         return buildPositionValue(userOpenPositions, aggregatedClearingHouseState, getAssetByName);
     }, [userOpenPositions, aggregatedClearingHouseState, tokenMetadata, getAssetByName]);
+    const planRebalance = (positionId, targetWeights) => {
+        var _a;
+        if (!openPositions) {
+            throw new Error('Open positions not loaded');
+        }
+        const position = openPositions.find((p) => p.positionId === positionId);
+        if (!position) {
+            throw new Error(`Position ${positionId} not found`);
+        }
+        const assets = [];
+        const allAssets = [
+            ...position.longAssets.map((a) => ({ asset: a, side: 'long' })),
+            ...position.shortAssets.map((a) => ({ asset: a, side: 'short' })),
+        ];
+        const totalValue = allAssets.reduce((sum, { asset }) => sum + asset.positionValue, 0);
+        for (const { asset, side } of allAssets) {
+            const tw = (_a = targetWeights === null || targetWeights === void 0 ? void 0 : targetWeights[asset.coin]) !== null && _a !== void 0 ? _a : asset.targetWeight;
+            if (tw === undefined) {
+                assets.push({
+                    coin: asset.coin,
+                    side,
+                    currentWeight: totalValue > 0 ? (asset.positionValue / totalValue) * 100 : 0,
+                    targetWeight: 0,
+                    currentValue: asset.positionValue,
+                    targetValue: asset.positionValue,
+                    deltaValue: 0,
+                    currentSize: asset.actualSize,
+                    newSize: asset.actualSize,
+                    deltaSize: 0,
+                    skipped: true,
+                    skipReason: 'No target weight defined',
+                });
+                continue;
+            }
+            const currentWeight = totalValue > 0 ? (asset.positionValue / totalValue) * 100 : 0;
+            const targetValue = totalValue * (tw / 100);
+            const deltaValue = targetValue - asset.positionValue;
+            const currentPrice = asset.actualSize > 0 ? asset.positionValue / asset.actualSize : 0;
+            const deltaSize = currentPrice > 0 ? deltaValue / currentPrice : 0;
+            const newSize = asset.actualSize + deltaSize;
+            const belowMinimum = Math.abs(deltaValue) > 0 && Math.abs(deltaValue) < MIN_TRADE_SIZE_USD;
+            assets.push({
+                coin: asset.coin,
+                side,
+                currentWeight,
+                targetWeight: tw,
+                currentValue: asset.positionValue,
+                targetValue,
+                deltaValue,
+                currentSize: asset.actualSize,
+                newSize,
+                deltaSize,
+                skipped: belowMinimum,
+                skipReason: belowMinimum
+                    ? `Trade size $${Math.abs(deltaValue).toFixed(2)} is below minimum $${MIN_TRADE_SIZE_USD}`
+                    : undefined,
+            });
+        }
+        const canExecute = assets.some((a) => !a.skipped && Math.abs(a.deltaValue) > 0);
+        return { positionId, assets, canExecute };
+    };
+    const executeRebalance = async (positionId, targetWeights) => {
+        const plan = planRebalance(positionId, targetWeights);
+        if (!plan.canExecute) {
+            throw new Error('No executable rebalance changes — all below minimum trade size or no changes needed');
+        }
+        const executable = plan.assets.filter((a) => !a.skipped && Math.abs(a.deltaValue) > 0);
+        const payload = [
+            {
+                longAssets: executable
+                    .filter((a) => a.side === 'long')
+                    .map((a) => ({ asset: a.coin, size: a.newSize })),
+                shortAssets: executable
+                    .filter((a) => a.side === 'short')
+                    .map((a) => ({ asset: a.coin, size: a.newSize })),
+            },
+        ];
+        return adjustAdvancePosition$1(positionId, payload);
+    };
     return {
         createPosition: createPosition$1,
         updateRiskParameters: updateRiskParameters$1,
@@ -7255,6 +7331,8 @@ function usePosition() {
         updateLeverage: updateLeverage$1,
         openPositions,
         isLoading,
+        planRebalance,
+        executeRebalance,
     };
 }
 
@@ -8070,14 +8148,20 @@ const useAllUserBalances = () => {
             }
         }
         if (!availableToTrades['USDC']) {
-            availableToTrades['USDC'] = parseFloat((aggregatedClearingHouseState === null || aggregatedClearingHouseState === void 0 ? void 0 : aggregatedClearingHouseState.marginSummary.accountValue) || '0') - parseFloat((aggregatedClearingHouseState === null || aggregatedClearingHouseState === void 0 ? void 0 : aggregatedClearingHouseState.marginSummary.totalMarginUsed) || '0');
+            availableToTrades['USDC'] = Math.max(0, parseFloat((aggregatedClearingHouseState === null || aggregatedClearingHouseState === void 0 ? void 0 : aggregatedClearingHouseState.marginSummary.accountValue) || '0') -
+                parseFloat((aggregatedClearingHouseState === null || aggregatedClearingHouseState === void 0 ? void 0 : aggregatedClearingHouseState.marginSummary.totalMarginUsed) || '0'));
         }
         return {
             spotBalances,
             availableToTrades,
             isLoading,
         };
-    }, [spotState, longTokensMetadata, shortTokensMetadata, aggregatedClearingHouseState]);
+    }, [
+        spotState,
+        longTokensMetadata,
+        shortTokensMetadata,
+        aggregatedClearingHouseState,
+    ]);
     /**
      * Calculate margin required for every collateral token based on asset leverages and size.
      * Returns margin required per collateral and whether there's sufficient margin.

package/dist/types.d.ts

@@ -258,6 +258,7 @@ export interface PositionAssetDetailDto {
     initialWeight: number;
     currentWeight: number;
     fundingPaid?: number;
+    targetWeight?: number;
     metadata?: TokenMetadata | null;
 }
 export interface TpSlThreshold {
@@ -735,6 +736,7 @@ export interface RawAssetDto {
     side: string;
     fundingPaid?: number;
     leverage: number;
+    targetWeight?: number;
 }
 /**
  * Raw position data from open-positions channel

package/package.json

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