@pear-protocol/hyperliquid-sdk 0.0.44 → 0.0.46

package/README.md

@@ -37,7 +37,7 @@ yarn add react react-dom
 ### 1. Wrap your application with the Provider
 
 ```tsx
-import { PearHyperliquidProvider } from '@pear-protocol/hyperliquid-sdk';
+import { PearHyperliquidProvider } from "@pear-protocol/hyperliquid-sdk";
 
 function App() {
   return (
@@ -59,8 +59,8 @@ import {
   usePearAuth,
   usePearHyperliquid,
   usePosition,
-  useOrders
-} from '@pear-protocol/hyperliquid-sdk';
+  useOrders,
+} from "@pear-protocol/hyperliquid-sdk";
 
 function TradingComponent() {
   const { address, setAddress } = usePearHyperliquid();
@@ -78,11 +78,11 @@ function TradingComponent() {
 
 The `PearHyperliquidProvider` accepts the following props:
 
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `apiBaseUrl` | `string` | `https://hl-v2.pearprotocol.io` | Pear API base URL |
-| `wsUrl` | `string` | `wss://hl-v2.pearprotocol.io/ws` | Pear WebSocket URL |
-| `clientId` | `string` | `PEARPROTOCOLUI` | Client identifier for authentication |
+| Prop         | Type     | Default                          | Description                          |
+| ------------ | -------- | -------------------------------- | ------------------------------------ |
+| `apiBaseUrl` | `string` | `https://hl-v2.pearprotocol.io`  | Pear API base URL                    |
+| `wsUrl`      | `string` | `wss://hl-v2.pearprotocol.io/ws` | Pear WebSocket URL                   |
+| `clientId`   | `string` | `PEARPROTOCOLUI`                 | Client identifier for authentication |
 
 ### Authentication
 
@@ -91,7 +91,7 @@ The SDK supports two authentication methods:
 #### EIP-712 Signature Authentication
 
 ```tsx
-import { usePearAuth } from '@pear-protocol/hyperliquid-sdk';
+import { usePearAuth } from "@pear-protocol/hyperliquid-sdk";
 
 function LoginComponent() {
   const { getEip712, loginWithSignedMessage, isAuthenticated } = usePearAuth();
@@ -111,23 +111,23 @@ function LoginComponent() {
     await loginWithSignedMessage(address, signature, eip712Data.timestamp);
   };
 
-  return (
-    <div>
-      {isAuthenticated ? 'Logged In' : 'Logged Out'}
-    </div>
-  );
+  return <div>{isAuthenticated ? "Logged In" : "Logged Out"}</div>;
 }
 ```
 
 #### Privy Token Authentication
 
 ```tsx
-import { usePearAuth } from '@pear-protocol/hyperliquid-sdk';
+import { usePearAuth } from "@pear-protocol/hyperliquid-sdk";
 
 function PrivyLoginComponent() {
   const { loginWithPrivyToken, isAuthenticated } = usePearAuth();
 
-  const handlePrivyLogin = async (address: string, appId: string, accessToken: string) => {
+  const handlePrivyLogin = async (
+    address: string,
+    appId: string,
+    accessToken: string
+  ) => {
     await loginWithPrivyToken(address, appId, accessToken);
   };
 }
@@ -167,15 +167,15 @@ Authentication state and actions.
 
 ```tsx
 const {
-  status,           // AuthStatus enum
-  isAuthenticated,  // boolean
-  user,             // UserProfile | null
-  error,            // string | null
-  getEip712,        // (address: string) => Promise<EIP712MessageResponse>
+  status, // AuthStatus enum
+  isAuthenticated, // boolean
+  user, // UserProfile | null
+  error, // string | null
+  getEip712, // (address: string) => Promise<EIP712MessageResponse>
   loginWithSignedMessage, // (address, signature, timestamp) => Promise<void>
-  loginWithPrivyToken,    // (address, appId, accessToken) => Promise<void>
-  refreshTokens,    // () => Promise<any>
-  logout,           // () => Promise<void>
+  loginWithPrivyToken, // (address, appId, accessToken) => Promise<void>
+  refreshTokens, // () => Promise<any>
+  logout, // () => Promise<void>
 } = usePearAuth();
 ```
 
@@ -185,12 +185,12 @@ Agent wallet management.
 
 ```tsx
 const {
-  agentWallet,              // AgentWalletState
-  isReady,                  // boolean
-  loading,                  // boolean
-  error,                    // string | null
+  agentWallet, // AgentWalletState
+  isReady, // boolean
+  loading, // boolean
+  error, // string | null
   refreshAgentWalletStatus, // () => Promise<any>
-  createAgentWallet,        // () => Promise<any>
+  createAgentWallet, // () => Promise<any>
   notifyAgentWalletApproved, // () => Promise<any>
 } = usePearAgentWallet();
 ```
@@ -203,13 +203,13 @@ Manage trading positions.
 
 ```tsx
 const {
-  createPosition,        // (payload) => Promise<ApiResponse<CreatePositionResponseDto>>
-  updateRiskParameters,  // (positionId, payload) => Promise<ApiResponse<UpdateRiskParametersResponseDto>>
-  closePosition,         // (positionId, payload) => Promise<ApiResponse<ClosePositionResponseDto>>
-  closeAllPositions,     // (payload) => Promise<ApiResponse<CloseAllPositionsResponseDto>>
-  adjustPosition,        // (positionId, payload) => Promise<ApiResponse<AdjustPositionResponseDto>>
-  openPositions,         // OpenPositionDto[] | null
-  isLoading,             // boolean
+  createPosition, // (payload) => Promise<ApiResponse<CreatePositionResponseDto>>
+  updateRiskParameters, // (positionId, payload) => Promise<ApiResponse<UpdateRiskParametersResponseDto>>
+  closePosition, // (positionId, payload) => Promise<ApiResponse<ClosePositionResponseDto>>
+  closeAllPositions, // (payload) => Promise<ApiResponse<CloseAllPositionsResponseDto>>
+  adjustPosition, // (positionId, payload) => Promise<ApiResponse<AdjustPositionResponseDto>>
+  openPositions, // OpenPositionDto[] | null
+  isLoading, // boolean
 } = usePosition();
 ```
 
@@ -223,13 +223,13 @@ const handleCreatePosition = async () => {
     const response = await createPosition({
       leverage: 5,
       usdValue: 1000,
-      longAssets: [{ asset: 'ETH', weight: 1 }],
-      shortAssets: [{ asset: 'BTC', weight: 1 }],
-      orderType: 'MARKET',
+      longAssets: [{ asset: "ETH", weight: 1 }],
+      shortAssets: [{ asset: "BTC", weight: 1 }],
+      orderType: "MARKET",
     });
-    console.log('Position created:', response.data);
+    console.log("Position created:", response.data);
   } catch (error) {
-    console.error('Failed to create position:', error);
+    console.error("Failed to create position:", error);
   }
 };
 ```
@@ -242,11 +242,11 @@ const { closePosition } = usePosition();
 const handleClosePosition = async (positionId: string) => {
   try {
     const response = await closePosition(positionId, {
-      orderType: 'MARKET',
+      orderType: "MARKET",
     });
-    console.log('Position closed:', response.data);
+    console.log("Position closed:", response.data);
   } catch (error) {
-    console.error('Failed to close position:', error);
+    console.error("Failed to close position:", error);
   }
 };
 ```
@@ -259,11 +259,11 @@ Manage orders (LIMIT, TP/SL, TWAP).
 
 ```tsx
 const {
-  adjustOrder,      // (orderId, payload) => Promise<ApiResponse<AdjustOrderResponseDto>>
-  cancelOrder,      // (orderId) => Promise<ApiResponse<CancelOrderResponseDto>>
-  cancelTwapOrder,  // (orderId) => Promise<ApiResponse<CancelTwapResponseDto>>
-  openOrders,       // OpenLimitOrderDto[] | null
-  isLoading,        // boolean
+  adjustOrder, // (orderId, payload) => Promise<ApiResponse<AdjustOrderResponseDto>>
+  cancelOrder, // (orderId) => Promise<ApiResponse<CancelOrderResponseDto>>
+  cancelTwapOrder, // (orderId) => Promise<ApiResponse<CancelTwapResponseDto>>
+  openOrders, // OpenLimitOrderDto[] | null
+  isLoading, // boolean
 } = useOrders();
 ```
 
@@ -275,9 +275,9 @@ const { cancelOrder } = useOrders();
 const handleCancelOrder = async (orderId: string) => {
   try {
     await cancelOrder(orderId);
-    console.log('Order cancelled successfully');
+    console.log("Order cancelled successfully");
   } catch (error) {
-    console.error('Failed to cancel order:', error);
+    console.error("Failed to cancel order:", error);
   }
 };
 ```
@@ -316,7 +316,7 @@ const { data, isLoading } = useAccountSummary();
 Access real-time market data from Zustand store.
 
 ```tsx
-import { useMarketData } from '@pear-protocol/hyperliquid-sdk';
+import { useMarketData } from "@pear-protocol/hyperliquid-sdk";
 
 function MarketDataComponent() {
   const activeAssets = useMarketData((state) => state.activeAssets);
@@ -325,8 +325,8 @@ function MarketDataComponent() {
     <div>
       {activeAssets?.active.map((asset, idx) => (
         <div key={idx}>
-          Long: {asset.longAssets.map(a => a.asset).join(', ')} vs
-          Short: {asset.shortAssets.map(a => a.asset).join(', ')}
+          Long: {asset.longAssets.map((a) => a.asset).join(", ")} vs Short:{" "}
+          {asset.shortAssets.map((a) => a.asset).join(", ")}
         </div>
       ))}
     </div>
@@ -339,16 +339,16 @@ function MarketDataComponent() {
 Fetch and manage historical price data for tokens.
 
 ```tsx
-import { useHistoricalPriceData } from '@pear-protocol/hyperliquid-sdk';
+import { useHistoricalPriceData } from "@pear-protocol/hyperliquid-sdk";
 
 function ChartComponent() {
   const { fetchHistoricalData, getTokenData } = useHistoricalPriceData();
 
   useEffect(() => {
-    fetchHistoricalData('ETH', '1d'); // 1 day range
+    fetchHistoricalData("ETH", "1d"); // 1 day range
   }, []);
 
-  const ethData = getTokenData('ETH');
+  const ethData = getTokenData("ETH");
 }
 ```
 
@@ -357,13 +357,16 @@ function ChartComponent() {
 Get candle data for basket (multi-asset) positions.
 
 ```tsx
-import { useBasketCandles } from '@pear-protocol/hyperliquid-sdk';
+import { useBasketCandles } from "@pear-protocol/hyperliquid-sdk";
 
 function BasketChartComponent() {
   const { candles, isLoading, error } = useBasketCandles({
-    longAssets: [{ symbol: 'ETH', weight: 0.5 }, { symbol: 'BTC', weight: 0.5 }],
-    shortAssets: [{ symbol: 'SOL', weight: 1 }],
-    interval: '1h',
+    longAssets: [
+      { symbol: "ETH", weight: 0.5 },
+      { symbol: "BTC", weight: 0.5 },
+    ],
+    shortAssets: [{ symbol: "SOL", weight: 1 }],
+    interval: "1h",
     lookbackHours: 24,
   });
 }
@@ -374,12 +377,12 @@ function BasketChartComponent() {
 Get metadata for selected tokens including prices, funding, and leverage info.
 
 ```tsx
-import { useTokenSelectionMetadata } from '@pear-protocol/hyperliquid-sdk';
+import { useTokenSelectionMetadata } from "@pear-protocol/hyperliquid-sdk";
 
 function TokenSelector() {
   const { getMetadata, isLoading } = useTokenSelectionMetadata();
 
-  const ethMetadata = getMetadata('ETH');
+  const ethMetadata = getMetadata("ETH");
   // ethMetadata: { currentPrice, priceChange24hPercent, maxLeverage, ... }
 }
 ```
@@ -401,17 +404,17 @@ Access HyperLiquid native WebSocket connection (managed by provider).
 Access TWAP (Time-Weighted Average Price) order monitoring.
 
 ```tsx
-import { useTwap } from '@pear-protocol/hyperliquid-sdk';
+import { useTwap } from "@pear-protocol/hyperliquid-sdk";
 
 function TwapMonitor() {
   const { twapOrders, isLoading } = useTwap();
 
   return (
     <div>
-      {twapOrders?.map(order => (
+      {twapOrders?.map((order) => (
         <div key={order.orderId}>
           Status: {order.status}
-          Progress: {order.filledUsdValue / order.totalUsdValue * 100}%
+          Progress: {(order.filledUsdValue / order.totalUsdValue) * 100}%
         </div>
       ))}
     </div>
@@ -426,14 +429,15 @@ function TwapMonitor() {
 Access user notifications.
 
 ```tsx
-import { useNotifications } from '@pear-protocol/hyperliquid-sdk';
+import { useNotifications } from "@pear-protocol/hyperliquid-sdk";
 
 function NotificationCenter() {
-  const { notifications, isLoading, markAsRead, markAllAsRead } = useNotifications();
+  const { notifications, isLoading, markAsRead, markAllAsRead } =
+    useNotifications();
 
   return (
     <div>
-      {notifications?.map(notif => (
+      {notifications?.map((notif) => (
         <div key={notif.id} onClick={() => markAsRead(notif.id)}>
           {notif.category}: {JSON.stringify(notif.parameters)}
         </div>
@@ -450,7 +454,7 @@ function NotificationCenter() {
 Calculate account summary with real-time data.
 
 ```tsx
-import { AccountSummaryCalculator } from '@pear-protocol/hyperliquid-sdk';
+import { AccountSummaryCalculator } from "@pear-protocol/hyperliquid-sdk";
 
 const calculator = new AccountSummaryCalculator(webData2);
 const summary = calculator.calculateAccountSummary(
@@ -466,7 +470,7 @@ const summary = calculator.calculateAccountSummary(
 Detect position conflicts for new trades.
 
 ```tsx
-import { ConflictDetector } from '@pear-protocol/hyperliquid-sdk';
+import { ConflictDetector } from "@pear-protocol/hyperliquid-sdk";
 
 const conflicts = ConflictDetector.detectConflicts(
   longTokens,
@@ -480,10 +484,10 @@ const conflicts = ConflictDetector.detectConflicts(
 Extract token metadata from WebSocket data.
 
 ```tsx
-import { TokenMetadataExtractor } from '@pear-protocol/hyperliquid-sdk';
+import { TokenMetadataExtractor } from "@pear-protocol/hyperliquid-sdk";
 
 const metadata = TokenMetadataExtractor.extractMetadata(
-  'ETH',
+  "ETH",
   webData2,
   allMids,
   activeAssetData
@@ -501,15 +505,15 @@ import {
   closePosition,
   adjustOrder,
   cancelOrder,
-} from '@pear-protocol/hyperliquid-sdk';
+} from "@pear-protocol/hyperliquid-sdk";
 
 // All client functions require baseUrl and accessToken
 const response = await createPosition(baseUrl, accessToken, {
   leverage: 5,
   usdValue: 1000,
-  longAssets: [{ asset: 'ETH', weight: 1 }],
-  shortAssets: [{ asset: 'BTC', weight: 1 }],
-  orderType: 'MARKET',
+  longAssets: [{ asset: "ETH", weight: 1 }],
+  shortAssets: [{ asset: "BTC", weight: 1 }],
+  orderType: "MARKET",
 });
 ```
 
@@ -527,7 +531,7 @@ import type {
   CandleInterval,
   TokenMetadata,
   // ... and many more
-} from '@pear-protocol/hyperliquid-sdk';
+} from "@pear-protocol/hyperliquid-sdk";
 ```
 
 ## WebSocket Data Flow
@@ -553,7 +557,7 @@ try {
   await createPosition(payload);
 } catch (error) {
   if (error instanceof Error) {
-    console.error('Error:', error.message);
+    console.error("Error:", error.message);
   }
 }
 ```
@@ -581,14 +585,14 @@ When using the SDK, you may want to configure different environments:
 ### Complete Trading Component
 
 ```tsx
-import { useState } from 'react';
+import { useState } from "react";
 import {
   usePearAuth,
   usePearHyperliquid,
   usePosition,
   useOrders,
   useAccountSummary,
-} from '@pear-protocol/hyperliquid-sdk';
+} from "@pear-protocol/hyperliquid-sdk";
 
 function TradingDashboard() {
   const { address, setAddress, isConnected } = usePearHyperliquid();
@@ -602,12 +606,12 @@ function TradingDashboard() {
       await createPosition({
         leverage: 3,
         usdValue: 500,
-        longAssets: [{ asset: 'ETH', weight: 1 }],
-        shortAssets: [{ asset: 'BTC', weight: 1 }],
-        orderType: 'MARKET',
+        longAssets: [{ asset: "ETH", weight: 1 }],
+        shortAssets: [{ asset: "BTC", weight: 1 }],
+        orderType: "MARKET",
       });
     } catch (error) {
-      console.error('Failed to create position:', error);
+      console.error("Failed to create position:", error);
     }
   };
 
@@ -617,24 +621,31 @@ function TradingDashboard() {
 
       <div>
         <h2>Account</h2>
-        <p>Address: {address || 'Not connected'}</p>
-        <p>Status: {isAuthenticated ? 'Authenticated' : 'Not authenticated'}</p>
-        <p>WebSocket: {isConnected ? 'Connected' : 'Disconnected'}</p>
+        <p>Address: {address || "Not connected"}</p>
+        <p>Status: {isAuthenticated ? "Authenticated" : "Not authenticated"}</p>
+        <p>WebSocket: {isConnected ? "Connected" : "Disconnected"}</p>
       </div>
 
       <div>
         <h2>Account Summary</h2>
-        <p>Account Value: ${accountSummary?.balanceSummary.marginSummary.accountValue}</p>
+        <p>
+          Account Value: $
+          {accountSummary?.balanceSummary.marginSummary.accountValue}
+        </p>
         <p>Withdrawable: ${accountSummary?.balanceSummary.withdrawable}</p>
       </div>
 
       <div>
         <h2>Open Positions</h2>
-        {openPositions?.map(pos => (
+        {openPositions?.map((pos) => (
           <div key={pos.positionId}>
             <p>PNL: ${pos.unrealizedPnl.toFixed(2)}</p>
             <p>Value: ${pos.positionValue.toFixed(2)}</p>
-            <button onClick={() => closePosition(pos.positionId, { orderType: 'MARKET' })}>
+            <button
+              onClick={() =>
+                closePosition(pos.positionId, { orderType: "MARKET" })
+              }
+            >
               Close
             </button>
           </div>
@@ -643,7 +654,7 @@ function TradingDashboard() {
 
       <div>
         <h2>Open Orders</h2>
-        {openOrders?.map(order => (
+        {openOrders?.map((order) => (
           <div key={order.orderId}>
             <p>Type: {order.orderType}</p>
             <p>Value: ${order.usdValue}</p>
@@ -652,9 +663,7 @@ function TradingDashboard() {
         ))}
       </div>
 
-      <button onClick={handleCreatePosition}>
-        Create New Position
-      </button>
+      <button onClick={handleCreatePosition}>Create New Position</button>
     </div>
   );
 }
@@ -669,7 +678,7 @@ import {
   useMarketData,
   useTokenSelectionMetadata,
   useHyperliquidWebSocket,
-} from '@pear-protocol/hyperliquid-sdk';
+} from "@pear-protocol/hyperliquid-sdk";
 
 function MarketOverview() {
   const activeAssets = useMarketData((state) => state.activeAssets);
@@ -684,7 +693,9 @@ function MarketOverview() {
 
         return (
           <div key={idx}>
-            <p>{longAsset}: {metadata?.priceChange24hPercent.toFixed(2)}%</p>
+            <p>
+              {longAsset}: {metadata?.priceChange24hPercent.toFixed(2)}%
+            </p>
           </div>
         );
       })}
@@ -696,7 +707,9 @@ function MarketOverview() {
 
         return (
           <div key={idx}>
-            <p>{shortAsset}: {metadata?.priceChange24hPercent.toFixed(2)}%</p>
+            <p>
+              {shortAsset}: {metadata?.priceChange24hPercent.toFixed(2)}%
+            </p>
           </div>
         );
       })}

package/dist/clients/portfolio.d.ts

@@ -0,0 +1,39 @@
+import type { ApiResponse } from '../types';
+export type PortfolioInterval = '1d' | '1w' | '1m' | '1y' | 'all';
+export interface PortfolioBucketDto {
+    periodStart: string;
+    periodEnd: string;
+    volume: number;
+    openInterest: number;
+    winningTradesCount: number;
+    winningTradesUsd: number;
+    losingTradesCount: number;
+    losingTradesUsd: number;
+}
+export interface PortfolioOverallDto {
+    totalWinningTradesCount: number;
+    totalLosingTradesCount: number;
+    totalWinningUsd: number;
+    totalLosingUsd: number;
+    currentOpenInterest: number;
+    currentTotalVolume: number;
+    unrealizedPnl: number;
+    totalTrades: number;
+}
+export interface PortfolioIntervalsDto {
+    oneDay: PortfolioBucketDto[];
+    oneWeek: PortfolioBucketDto[];
+    oneMonth: PortfolioBucketDto[];
+    oneYear: PortfolioBucketDto[];
+    all: PortfolioBucketDto[];
+}
+export 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')
+ */
+export declare function getPortfolio(baseUrl: string, accessToken: string): Promise<ApiResponse<PortfolioResponseDto>>;

package/dist/clients/positions.d.ts

@@ -1,7 +1,7 @@
-import type { ApiResponse } from '../types';
-import type { CancelTwapResponseDto } from './orders';
-export type ExecutionType = 'MARKET' | 'LIMIT' | 'TWAP' | 'LADDER' | 'LIMIT_BTCDOM';
-export type TpSlThresholdType = 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE';
+import type { ApiResponse } from "../types";
+import type { CancelTwapResponseDto } from "./orders";
+export type ExecutionType = "MARKET" | "LIMIT" | "TWAP" | "LADDER" | "LIMIT_BTCDOM";
+export type TpSlThresholdType = "PERCENTAGE" | "DOLLAR" | "POSITION_VALUE";
 export interface PairAssetInput {
     asset: string;
     weight?: number;
@@ -23,7 +23,7 @@ export interface CreatePositionRequestInput {
     longAssets?: PairAssetInput[];
     shortAssets?: PairAssetInput[];
     triggerValue?: number;
-    direction?: 'MORE_THAN' | 'LESS_THAN';
+    direction?: "MORE_THAN" | "LESS_THAN";
     twapDuration?: number;
     twapIntervalSeconds?: number;
     randomizeExecution?: boolean;
@@ -31,10 +31,10 @@ export interface CreatePositionRequestInput {
     takeProfit?: TpSlThresholdInput | null;
     stopLoss?: TpSlThresholdInput | null;
 }
-export type PositionResponseStatus = 'SUCCESS' | 'FAILED' | 'PENDING' | 'PARTIALLY_FILLED' | 'OPEN';
+export type PositionResponseStatus = "SUCCESS" | "FAILED" | "PENDING" | "PARTIALLY_FILLED" | "OPEN";
 export interface PositionAssetSummaryDto {
     asset: string;
-    side: 'LONG' | 'SHORT';
+    side: "LONG" | "SHORT";
     size: number;
     entryRatio: number;
     usdValue: number;
@@ -53,6 +53,7 @@ export 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
  */
 export declare function createPosition(baseUrl: string, accessToken: string, payload: CreatePositionRequestInput): Promise<ApiResponse<CreatePositionResponseDto>>;
 export interface UpdateRiskParametersRequestInput {
@@ -66,7 +67,7 @@ export interface UpdateRiskParametersResponseDto {
     updatedAt: string;
 }
 export declare function updateRiskParameters(baseUrl: string, accessToken: string, positionId: string, payload: UpdateRiskParametersRequestInput): Promise<ApiResponse<UpdateRiskParametersResponseDto>>;
-export type CloseExecutionType = 'MARKET' | 'TWAP';
+export type CloseExecutionType = "MARKET" | "TWAP";
 export interface ClosePositionRequestInput {
     executionType: CloseExecutionType;
     twapDuration?: number;
@@ -89,8 +90,8 @@ export interface CloseAllPositionsResponseDto {
     results: CloseAllPositionsResultDto[];
 }
 export declare function closeAllPositions(baseUrl: string, accessToken: string, payload: ClosePositionRequestInput): Promise<ApiResponse<CloseAllPositionsResponseDto>>;
-export type AdjustExecutionType = 'MARKET' | 'LIMIT';
-export type PositionAdjustmentType = 'REDUCE' | 'INCREASE';
+export type AdjustExecutionType = "MARKET" | "LIMIT";
+export type PositionAdjustmentType = "REDUCE" | "INCREASE";
 export interface AdjustPositionRequestInput {
     adjustmentType: PositionAdjustmentType;
     adjustmentSize: number;

package/dist/hooks/index.d.ts

@@ -6,7 +6,6 @@ export * from './useTokenSelectionMetadata';
 export * from './useHistoricalPriceData';
 export * from './useBasketCandles';
 export * from './usePerformanceOverlays';
-export * from './useAuth';
 export * from './useAgentWallet';
 export * from './useAutoSyncFills';
 export * from './usePosition';
@@ -15,3 +14,4 @@ export * from './useTwap';
 export * from './useNotifications';
 export * from './useMarketData';
 export * from './useWatchlist';
+export * from './usePortfolio';

package/dist/hooks/usePortfolio.d.ts

@@ -0,0 +1,13 @@
+import { type PortfolioResponseDto } from '../clients/portfolio';
+export 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%)
+ */
+export declare function usePortfolio(): UsePortfolioResult;