@pear-protocol/hyperliquid-sdk 0.0.44 → 0.0.46

package/dist/index.d.ts

@@ -804,19 +804,6 @@ interface UsePerformanceOverlaysReturn {
 }
 declare const usePerformanceOverlays: () => UsePerformanceOverlaysReturn;
 
-declare function useAuth(): {
-    readonly status: AuthStatus;
-    readonly isAuthenticated: boolean;
-    readonly accessToken: string | null;
-    readonly user: UserProfile | null;
-    readonly error: string | null;
-    readonly getEip712: (address: string) => Promise<any>;
-    readonly loginWithSignedMessage: (address: string, signature: string, timestamp: number) => Promise<void>;
-    readonly loginWithPrivyToken: (address: string, appId: string, accessToken: string) => Promise<void>;
-    readonly refreshTokens: () => Promise<any>;
-    readonly logout: () => Promise<void>;
-};
-
 declare function useAgentWallet({ baseUrl }: UseAgentWalletOptions): {
     readonly agentWallet: AgentWalletState;
     readonly isReady: boolean;
@@ -872,8 +859,8 @@ interface CancelTwapResponseDto {
 }
 declare function cancelTwapOrder(baseUrl: string, accessToken: string, orderId: string): Promise<ApiResponse<CancelTwapResponseDto>>;
 
-type ExecutionType = 'MARKET' | 'LIMIT' | 'TWAP' | 'LADDER' | 'LIMIT_BTCDOM';
-type TpSlThresholdType = 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE';
+type ExecutionType = "MARKET" | "LIMIT" | "TWAP" | "LADDER" | "LIMIT_BTCDOM";
+type TpSlThresholdType = "PERCENTAGE" | "DOLLAR" | "POSITION_VALUE";
 interface PairAssetInput {
     asset: string;
     weight?: number;
@@ -895,7 +882,7 @@ interface CreatePositionRequestInput {
     longAssets?: PairAssetInput[];
     shortAssets?: PairAssetInput[];
     triggerValue?: number;
-    direction?: 'MORE_THAN' | 'LESS_THAN';
+    direction?: "MORE_THAN" | "LESS_THAN";
     twapDuration?: number;
     twapIntervalSeconds?: number;
     randomizeExecution?: boolean;
@@ -903,10 +890,10 @@ interface CreatePositionRequestInput {
     takeProfit?: TpSlThresholdInput | null;
     stopLoss?: TpSlThresholdInput | null;
 }
-type PositionResponseStatus = 'SUCCESS' | 'FAILED' | 'PENDING' | 'PARTIALLY_FILLED' | 'OPEN';
+type PositionResponseStatus = "SUCCESS" | "FAILED" | "PENDING" | "PARTIALLY_FILLED" | "OPEN";
 interface PositionAssetSummaryDto {
     asset: string;
-    side: 'LONG' | 'SHORT';
+    side: "LONG" | "SHORT";
     size: number;
     entryRatio: number;
     usdValue: number;
@@ -925,6 +912,7 @@ interface CreatePositionResponseDto {
 /**
  * Create a position (MARKET/LIMIT/TWAP) using Pear Hyperliquid service
  * Caller should supply an accessToken from localStorage.getItem('accessToken')
+ * @throws MinimumPositionSizeError if any asset has less than $11 USD value
  */
 declare function createPosition(baseUrl: string, accessToken: string, payload: CreatePositionRequestInput): Promise<ApiResponse<CreatePositionResponseDto>>;
 interface UpdateRiskParametersRequestInput {
@@ -938,7 +926,7 @@ interface UpdateRiskParametersResponseDto {
     updatedAt: string;
 }
 declare function updateRiskParameters(baseUrl: string, accessToken: string, positionId: string, payload: UpdateRiskParametersRequestInput): Promise<ApiResponse<UpdateRiskParametersResponseDto>>;
-type CloseExecutionType = 'MARKET' | 'TWAP';
+type CloseExecutionType = "MARKET" | "TWAP";
 interface ClosePositionRequestInput {
     executionType: CloseExecutionType;
     twapDuration?: number;
@@ -961,8 +949,8 @@ interface CloseAllPositionsResponseDto {
     results: CloseAllPositionsResultDto[];
 }
 declare function closeAllPositions(baseUrl: string, accessToken: string, payload: ClosePositionRequestInput): Promise<ApiResponse<CloseAllPositionsResponseDto>>;
-type AdjustExecutionType = 'MARKET' | 'LIMIT';
-type PositionAdjustmentType = 'REDUCE' | 'INCREASE';
+type AdjustExecutionType = "MARKET" | "LIMIT";
+type PositionAdjustmentType = "REDUCE" | "INCREASE";
 interface AdjustPositionRequestInput {
     adjustmentType: PositionAdjustmentType;
     adjustmentSize: number;
@@ -1033,6 +1021,58 @@ declare function useWatchlist(): {
     readonly toggle: (longAssets: WatchlistAssetDto[], shortAssets: WatchlistAssetDto[]) => Promise<ApiResponse<ToggleWatchlistResponseDto>>;
 };
 
+type PortfolioInterval = '1d' | '1w' | '1m' | '1y' | 'all';
+interface PortfolioBucketDto {
+    periodStart: string;
+    periodEnd: string;
+    volume: number;
+    openInterest: number;
+    winningTradesCount: number;
+    winningTradesUsd: number;
+    losingTradesCount: number;
+    losingTradesUsd: number;
+}
+interface PortfolioOverallDto {
+    totalWinningTradesCount: number;
+    totalLosingTradesCount: number;
+    totalWinningUsd: number;
+    totalLosingUsd: number;
+    currentOpenInterest: number;
+    currentTotalVolume: number;
+    unrealizedPnl: number;
+    totalTrades: number;
+}
+interface PortfolioIntervalsDto {
+    oneDay: PortfolioBucketDto[];
+    oneWeek: PortfolioBucketDto[];
+    oneMonth: PortfolioBucketDto[];
+    oneYear: PortfolioBucketDto[];
+    all: PortfolioBucketDto[];
+}
+interface PortfolioResponseDto {
+    intervals: PortfolioIntervalsDto;
+    overall: PortfolioOverallDto;
+}
+/**
+ * Get portfolio summary buckets and overall metrics
+ * Returns bucketed volume, open interest snapshot, win/loss trade counts, and overall metrics filtered to PEAR fills (cloid LIKE 0x50454152%)
+ * Caller should supply an accessToken from localStorage.getItem('accessToken')
+ */
+declare function getPortfolio(baseUrl: string, accessToken: string): Promise<ApiResponse<PortfolioResponseDto>>;
+
+interface UsePortfolioResult {
+    data: PortfolioResponseDto | null;
+    isLoading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+}
+/**
+ * Hook to fetch and manage portfolio data
+ * Returns bucketed volume, open interest snapshot, win/loss trade counts,
+ * and overall metrics filtered to PEAR fills (cloid LIKE 0x50454152%)
+ */
+declare function usePortfolio(): UsePortfolioResult;
+
 interface UseHyperliquidWebSocketProps {
     wsUrl: string;
     address: string | null;
@@ -1171,7 +1211,48 @@ declare function mapTradingViewIntervalToCandleInterval(interval: string): Candl
  */
 declare function mapCandleIntervalToTradingViewInterval(interval: CandleInterval): string;
 
+/**
+ * Minimum USD value required per asset when creating a position
+ */
+declare const MINIMUM_ASSET_USD_VALUE = 11;
+/**
+ * Validation error for minimum position size
+ */
+declare class MinimumPositionSizeError extends Error {
+    assetName: string;
+    assetValue: number;
+    minimumRequired: number;
+    constructor(assetName: string, assetValue: number, minimumRequired: number);
+}
+/**
+ * Validates that each asset in a position has at least the minimum USD value
+ * @param usdValue Total USD value for the position
+ * @param longAssets Array of long assets with weights
+ * @param shortAssets Array of short assets with weights
+ * @throws MinimumPositionSizeError if any asset has less than the minimum USD value
+ */
+declare function validateMinimumAssetSize(usdValue: number, longAssets?: PairAssetInput[], shortAssets?: PairAssetInput[]): void;
+/**
+ * Calculates the minimum USD value required for a position based on the number of assets
+ * @param longAssets Array of long assets
+ * @param shortAssets Array of short assets
+ * @returns The minimum total USD value required
+ */
+declare function calculateMinimumPositionValue(longAssets?: PairAssetInput[], shortAssets?: PairAssetInput[]): number;
+/**
+ * Validates and provides a user-friendly error message with suggestions
+ * @param usdValue Total USD value for the position
+ * @param longAssets Array of long assets with weights
+ * @param shortAssets Array of short assets with weights
+ * @returns Validation result with success flag and optional error message
+ */
+declare function validatePositionSize(usdValue: number, longAssets?: PairAssetInput[], shortAssets?: PairAssetInput[]): {
+    valid: boolean;
+    error?: string;
+    minimumRequired?: number;
+};
+
 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, 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 };
+export { AccountSummaryCalculator, AuthStatus, ConflictDetector, MINIMUM_ASSET_USD_VALUE, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, getPortfolio, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAddress, useAgentWallet, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePortfolio, usePosition, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMinimumAssetSize, validatePositionSize };
+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, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, 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, UsePortfolioResult, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebData2Response, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };

package/dist/index.js

@@ -1,4 +1,4 @@
-import React, { useState, useEffect, useMemo, useRef, useCallback, useContext, createContext } from 'react';
+import require$$0, { useState, useEffect, useMemo, useRef, useCallback, useContext, createContext } from 'react';
 import require$$1 from 'react-dom';
 import { create } from 'zustand';
 
@@ -27,7 +27,7 @@ var hasRequiredReactJsxRuntime_production_min;
 function requireReactJsxRuntime_production_min () {
 	if (hasRequiredReactJsxRuntime_production_min) return reactJsxRuntime_production_min;
 	hasRequiredReactJsxRuntime_production_min = 1;
-var f=React,k=Symbol.for("react.element"),l=Symbol.for("react.fragment"),m=Object.prototype.hasOwnProperty,n=f.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentOwner,p={key:!0,ref:!0,__self:!0,__source:!0};
+var f=require$$0,k=Symbol.for("react.element"),l=Symbol.for("react.fragment"),m=Object.prototype.hasOwnProperty,n=f.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED.ReactCurrentOwner,p={key:!0,ref:!0,__self:!0,__source:!0};
 	function q(c,a,g){var b,d={},e=null,h=null;void 0!==g&&(e=""+g);void 0!==a.key&&(e=""+a.key);void 0!==a.ref&&(h=a.ref);for(b in a)m.call(a,b)&&!p.hasOwnProperty(b)&&(d[b]=a[b]);if(c&&c.defaultProps)for(b in a=c.defaultProps,a)void 0===d[b]&&(d[b]=a[b]);return {$$typeof:k,type:c,key:e,ref:h,props:d,_owner:n.current}}reactJsxRuntime_production_min.Fragment=l;reactJsxRuntime_production_min.jsx=q;reactJsxRuntime_production_min.jsxs=q;
 	return reactJsxRuntime_production_min;
 }
@@ -53,7 +53,7 @@ function requireReactJsxRuntime_development () {
 	if (process.env.NODE_ENV !== "production") {
 	  (function() {
 
-	var React$1 = React;
+	var React = require$$0;
 
 	// ATTENTION
 	// When adding new symbols to this file,
@@ -88,7 +88,7 @@ function requireReactJsxRuntime_development () {
 	  return null;
 	}
 
-	var ReactSharedInternals = React$1.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;
+	var ReactSharedInternals = React.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;
 
 	function error(format) {
 	  {
@@ -2142,7 +2142,7 @@ var __importDefault = (commonjsGlobal && commonjsGlobal.__importDefault) || func
 };
 Object.defineProperty(useWebsocket, "__esModule", { value: true });
 useWebsocket.useWebSocket = void 0;
-var react_1$2 = React;
+var react_1$2 = require$$0;
 var react_dom_1 = require$$1;
 var constants_1$2 = constants;
 var create_or_join_1 = createOrJoin;
@@ -2308,7 +2308,7 @@ var __assign$1 = (commonjsGlobal && commonjsGlobal.__assign) || function () {
 };
 Object.defineProperty(useSocketIo, "__esModule", { value: true });
 useSocketIo.useSocketIO = void 0;
-var react_1$1 = React;
+var react_1$1 = require$$0;
 var use_websocket_1$1 = useWebsocket;
 var constants_1$1 = constants;
 var emptyEvent = {
@@ -2377,7 +2377,7 @@ var __rest = (commonjsGlobal && commonjsGlobal.__rest) || function (s, e) {
 };
 Object.defineProperty(useEventSource$1, "__esModule", { value: true });
 useEventSource$1.useEventSource = void 0;
-var react_1 = React;
+var react_1 = require$$0;
 var use_websocket_1 = useWebsocket;
 var constants_1 = constants;
 var useEventSource = function (url, _a, connect) {
@@ -8234,23 +8234,6 @@ const usePerformanceOverlays = () => {
     };
 };
 
-// Refactored to read auth state/actions from Provider context
-function useAuth() {
-    const ctx = usePearHyperliquid();
-    return {
-        status: ctx.authStatus,
-        isAuthenticated: ctx.isAuthenticated,
-        accessToken: ctx.accessToken,
-        user: ctx.user,
-        error: ctx.authError,
-        getEip712: ctx.getEip712,
-        loginWithSignedMessage: ctx.loginWithSignedMessage,
-        loginWithPrivyToken: ctx.loginWithPrivyToken,
-        refreshTokens: ctx.refreshTokens,
-        logout: ctx.logout,
-    };
-}
-
 /**
  * Sync external fills into Pear Hyperliquid service (POST /sync/fills)
  */
@@ -8364,15 +8347,109 @@ function useAutoSyncFills(options) {
     };
 }
 
+/**
+ * Minimum USD value required per asset when creating a position
+ */
+const MINIMUM_ASSET_USD_VALUE = 11;
+/**
+ * Validation error for minimum position size
+ */
+class MinimumPositionSizeError extends Error {
+    constructor(assetName, assetValue, minimumRequired) {
+        super(`Asset "${assetName}" has a USD value of $${assetValue.toFixed(2)}, which is below the minimum required value of $${minimumRequired.toFixed(2)}`);
+        this.assetName = assetName;
+        this.assetValue = assetValue;
+        this.minimumRequired = minimumRequired;
+        this.name = "MinimumPositionSizeError";
+    }
+}
+/**
+ * Validates that each asset in a position has at least the minimum USD value
+ * @param usdValue Total USD value for the position
+ * @param longAssets Array of long assets with weights
+ * @param shortAssets Array of short assets with weights
+ * @throws MinimumPositionSizeError if any asset has less than the minimum USD value
+ */
+function validateMinimumAssetSize(usdValue, longAssets, shortAssets) {
+    var _a;
+    const allAssets = [...(longAssets || []), ...(shortAssets || [])];
+    if (allAssets.length === 0) {
+        return; // No assets to validate
+    }
+    // Calculate total weight
+    const totalWeight = allAssets.reduce((sum, asset) => { var _a; return sum + ((_a = asset.weight) !== null && _a !== void 0 ? _a : 0); }, 0);
+    // If weights are not provided or sum to 0, assume equal distribution
+    const hasWeights = totalWeight > 0;
+    const equalWeight = hasWeights ? 0 : 1 / allAssets.length;
+    // Validate each asset
+    for (const asset of allAssets) {
+        const weight = hasWeights ? (_a = asset.weight) !== null && _a !== void 0 ? _a : 0 : equalWeight;
+        const assetUsdValue = usdValue * weight;
+        if (assetUsdValue < MINIMUM_ASSET_USD_VALUE) {
+            throw new MinimumPositionSizeError(asset.asset, assetUsdValue, MINIMUM_ASSET_USD_VALUE);
+        }
+    }
+}
+/**
+ * Calculates the minimum USD value required for a position based on the number of assets
+ * @param longAssets Array of long assets
+ * @param shortAssets Array of short assets
+ * @returns The minimum total USD value required
+ */
+function calculateMinimumPositionValue(longAssets, shortAssets) {
+    const totalAssets = ((longAssets === null || longAssets === void 0 ? void 0 : longAssets.length) || 0) + ((shortAssets === null || shortAssets === void 0 ? void 0 : shortAssets.length) || 0);
+    if (totalAssets === 0) {
+        return 0;
+    }
+    return MINIMUM_ASSET_USD_VALUE * totalAssets;
+}
+/**
+ * Validates and provides a user-friendly error message with suggestions
+ * @param usdValue Total USD value for the position
+ * @param longAssets Array of long assets with weights
+ * @param shortAssets Array of short assets with weights
+ * @returns Validation result with success flag and optional error message
+ */
+function validatePositionSize(usdValue, longAssets, shortAssets) {
+    try {
+        validateMinimumAssetSize(usdValue, longAssets, shortAssets);
+        return { valid: true };
+    }
+    catch (error) {
+        if (error instanceof MinimumPositionSizeError) {
+            const minimumRequired = calculateMinimumPositionValue(longAssets, shortAssets);
+            return {
+                valid: false,
+                error: error.message,
+                minimumRequired,
+            };
+        }
+        throw error;
+    }
+}
+
 /**
  * Create a position (MARKET/LIMIT/TWAP) using Pear Hyperliquid service
  * Caller should supply an accessToken from localStorage.getItem('accessToken')
+ * @throws MinimumPositionSizeError if any asset has less than $11 USD value
  */
 async function createPosition(baseUrl, accessToken, payload) {
-    const url = joinUrl(baseUrl, '/positions');
+    // Validate minimum asset size before creating position
+    validateMinimumAssetSize(payload.usdValue, payload.longAssets, payload.shortAssets);
+    const url = joinUrl(baseUrl, "/positions");
     try {
-        const resp = await axios$1.post(url, payload, { headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${accessToken}` }, timeout: 60000 });
-        return { data: resp.data, status: resp.status, headers: resp.headers };
+        const resp = await axios$1.post(url, payload, {
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${accessToken}`,
+            },
+            timeout: 60000,
+        });
+        return {
+            data: resp.data,
+            status: resp.status,
+            headers: resp.headers,
+        };
     }
     catch (error) {
         throw toApiError(error);
@@ -8381,8 +8458,18 @@ async function createPosition(baseUrl, accessToken, payload) {
 async function updateRiskParameters(baseUrl, accessToken, positionId, payload) {
     const url = joinUrl(baseUrl, `/positions/${positionId}/riskParameters`);
     try {
-        const resp = await axios$1.put(url, payload, { headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${accessToken}` }, timeout: 60000 });
-        return { data: resp.data, status: resp.status, headers: resp.headers };
+        const resp = await axios$1.put(url, payload, {
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${accessToken}`,
+            },
+            timeout: 60000,
+        });
+        return {
+            data: resp.data,
+            status: resp.status,
+            headers: resp.headers,
+        };
     }
     catch (error) {
         throw toApiError(error);
@@ -8391,8 +8478,18 @@ async function updateRiskParameters(baseUrl, accessToken, positionId, payload) {
 async function closePosition(baseUrl, accessToken, positionId, payload) {
     const url = joinUrl(baseUrl, `/positions/${positionId}/close`);
     try {
-        const resp = await axios$1.post(url, payload, { headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${accessToken}` }, timeout: 60000 });
-        return { data: resp.data, status: resp.status, headers: resp.headers };
+        const resp = await axios$1.post(url, payload, {
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${accessToken}`,
+            },
+            timeout: 60000,
+        });
+        return {
+            data: resp.data,
+            status: resp.status,
+            headers: resp.headers,
+        };
     }
     catch (error) {
         throw toApiError(error);
@@ -8401,8 +8498,18 @@ async function closePosition(baseUrl, accessToken, positionId, payload) {
 async function closeAllPositions(baseUrl, accessToken, payload) {
     const url = joinUrl(baseUrl, `/positions/close-all`);
     try {
-        const resp = await axios$1.post(url, payload, { headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${accessToken}` }, timeout: 60000 });
-        return { data: resp.data, status: resp.status, headers: resp.headers };
+        const resp = await axios$1.post(url, payload, {
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${accessToken}`,
+            },
+            timeout: 60000,
+        });
+        return {
+            data: resp.data,
+            status: resp.status,
+            headers: resp.headers,
+        };
     }
     catch (error) {
         throw toApiError(error);
@@ -8411,8 +8518,18 @@ async function closeAllPositions(baseUrl, accessToken, payload) {
 async function adjustPosition(baseUrl, accessToken, positionId, payload) {
     const url = joinUrl(baseUrl, `/positions/${positionId}/adjust`);
     try {
-        const resp = await axios$1.post(url, payload, { headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${accessToken}` }, timeout: 60000 });
-        return { data: resp.data, status: resp.status, headers: resp.headers };
+        const resp = await axios$1.post(url, payload, {
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${accessToken}`,
+            },
+            timeout: 60000,
+        });
+        return {
+            data: resp.data,
+            status: resp.status,
+            headers: resp.headers,
+        };
     }
     catch (error) {
         throw toApiError(error);
@@ -8423,8 +8540,18 @@ async function adjustPosition(baseUrl, accessToken, positionId, payload) {
 async function cancelTwap(baseUrl, accessToken, orderId) {
     const url = joinUrl(baseUrl, `/orders/${orderId}/twap/cancel`);
     try {
-        const resp = await axios$1.post(url, {}, { headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${accessToken}` }, timeout: 60000 });
-        return { data: resp.data, status: resp.status, headers: resp.headers };
+        const resp = await axios$1.post(url, {}, {
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${accessToken}`,
+            },
+            timeout: 60000,
+        });
+        return {
+            data: resp.data,
+            status: resp.status,
+            headers: resp.headers,
+        };
     }
     catch (error) {
         throw toApiError(error);
@@ -8827,6 +8954,63 @@ function useWatchlist() {
     return { watchlists: watchlists !== null && watchlists !== void 0 ? watchlists : null, isLoading, toggle };
 }
 
+/**
+ * Get portfolio summary buckets and overall metrics
+ * Returns bucketed volume, open interest snapshot, win/loss trade counts, and overall metrics filtered to PEAR fills (cloid LIKE 0x50454152%)
+ * Caller should supply an accessToken from localStorage.getItem('accessToken')
+ */
+async function getPortfolio(baseUrl, accessToken) {
+    const url = joinUrl(baseUrl, '/portfolio');
+    try {
+        const resp = await axios$1.get(url, { headers: { Authorization: `Bearer ${accessToken}` }, timeout: 60000 });
+        return { data: resp.data, status: resp.status, headers: resp.headers };
+    }
+    catch (error) {
+        throw toApiError(error);
+    }
+}
+
+/**
+ * Hook to fetch and manage portfolio data
+ * Returns bucketed volume, open interest snapshot, win/loss trade counts,
+ * and overall metrics filtered to PEAR fills (cloid LIKE 0x50454152%)
+ */
+function usePortfolio() {
+    const context = useContext(PearHyperliquidContext);
+    if (!context) {
+        throw new Error('usePortfolio must be used within a PearHyperliquidProvider');
+    }
+    const { apiBaseUrl, accessToken, isAuthenticated } = context;
+    const [data, setData] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const fetchPortfolio = useCallback(async () => {
+        if (!isAuthenticated || !accessToken) {
+            setError(new Error('Not authenticated'));
+            return;
+        }
+        setIsLoading(true);
+        setError(null);
+        try {
+            const response = await getPortfolio(apiBaseUrl, accessToken);
+            setData(response.data);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error('Failed to fetch portfolio'));
+            setData(null);
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [apiBaseUrl, accessToken, isAuthenticated]);
+    return {
+        data,
+        isLoading,
+        error,
+        refetch: fetchPortfolio,
+    };
+}
+
 const PearHyperliquidContext = createContext(undefined);
 /**
  * React Provider for PearHyperliquidClient
@@ -8850,7 +9034,7 @@ const PearHyperliquidProvider = ({ children, apiBaseUrl = 'https://hl-v2.pearpro
     const [accessToken, setAccessToken] = useState(null);
     const isAuthenticated = useMemo(() => !!accessToken, [accessToken]);
     // Hydrate from existing token
-    React.useEffect(() => {
+    useEffect(() => {
         const access = localStorage.getItem('accessToken');
         if (access) {
             try {
@@ -8867,11 +9051,11 @@ const PearHyperliquidProvider = ({ children, apiBaseUrl = 'https://hl-v2.pearpro
             }
         }
     }, [clientId]);
-    const getEip712 = React.useCallback(async (address) => {
+    const getEip712 = useCallback(async (address) => {
         const { data } = await getEIP712Message(apiBaseUrl, address, clientId);
         return data;
     }, [apiBaseUrl, clientId]);
-    const loginWithSignedMessage = React.useCallback(async (address, signature, timestamp) => {
+    const loginWithSignedMessage = useCallback(async (address, signature, timestamp) => {
         setAuthError(null);
         setAuthStatus(AuthStatus.Authenticating);
         try {
@@ -8887,6 +9071,7 @@ const PearHyperliquidProvider = ({ children, apiBaseUrl = 'https://hl-v2.pearpro
             const lower = data.address.toLowerCase();
             setUser({ userId: lower, address: lower, appId: clientId });
             setAuthStatus(AuthStatus.Authenticated);
+            setAddress(lower);
         }
         catch (e) {
             setAuthError((e === null || e === void 0 ? void 0 : e.message) || 'Authentication failed');
@@ -8894,7 +9079,7 @@ const PearHyperliquidProvider = ({ children, apiBaseUrl = 'https://hl-v2.pearpro
             throw e;
         }
     }, [apiBaseUrl, clientId]);
-    const refreshTokens = React.useCallback(async () => {
+    const refreshTokens = useCallback(async () => {
         const refresh = localStorage.getItem('refreshToken');
         if (!refresh)
             throw new Error('No refresh token');
@@ -8904,7 +9089,7 @@ const PearHyperliquidProvider = ({ children, apiBaseUrl = 'https://hl-v2.pearpro
         setAccessToken(data.accessToken);
         return data;
     }, [apiBaseUrl]);
-    const loginWithPrivyToken = React.useCallback(async (address, appId, privyAccessToken) => {
+    const loginWithPrivyToken = useCallback(async (address, appId, privyAccessToken) => {
         setAuthError(null);
         setAuthStatus(AuthStatus.Authenticating);
         try {
@@ -8915,6 +9100,7 @@ const PearHyperliquidProvider = ({ children, apiBaseUrl = 'https://hl-v2.pearpro
             const lower = data.address.toLowerCase();
             setUser({ userId: lower, address: lower, appId: clientId });
             setAuthStatus(AuthStatus.Authenticated);
+            setAddress(lower);
         }
         catch (e) {
             setAuthError((e === null || e === void 0 ? void 0 : e.message) || 'Authentication failed');
@@ -8922,7 +9108,7 @@ const PearHyperliquidProvider = ({ children, apiBaseUrl = 'https://hl-v2.pearpro
             throw e;
         }
     }, [apiBaseUrl, clientId]);
-    const logout$1 = React.useCallback(async () => {
+    const logout$1 = useCallback(async () => {
         const refresh = localStorage.getItem('refreshToken');
         if (refresh) {
             try {
@@ -8936,6 +9122,7 @@ const PearHyperliquidProvider = ({ children, apiBaseUrl = 'https://hl-v2.pearpro
         setUser(null);
         setAuthStatus(AuthStatus.Idle);
         setAuthError(null);
+        setAddress(null);
     }, [apiBaseUrl]);
     // Agent wallet hook
     const { agentWallet, isReady: isAgentWalletReady, loading: agentWalletLoading, error: agentWalletError, refreshAgentWalletStatus, createAgentWallet, notifyAgentWalletApproved, } = useAgentWallet({ baseUrl: apiBaseUrl });
@@ -9125,4 +9312,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, 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 { AccountSummaryCalculator, AuthStatus, ConflictDetector, MINIMUM_ASSET_USD_VALUE, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, getPortfolio, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAddress, useAgentWallet, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearAgentWallet, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePortfolio, usePosition, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMinimumAssetSize, validatePositionSize };