@pear-protocol/hyperliquid-sdk 0.0.44 → 0.0.45

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

@@ -872,8 +872,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 +895,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 +903,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 +925,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 +939,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 +962,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;
@@ -1171,7 +1172,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 { AccountSummaryCalculator, AuthStatus, ConflictDetector, MINIMUM_ASSET_USD_VALUE, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateMinimumPositionValue, 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, 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, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, ToggleWatchlistResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, UniverseAsset, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAgentWalletOptions, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebData2Response, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };

package/dist/index.js

@@ -8364,15 +8364,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 +8475,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 +8495,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 +8515,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 +8535,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 +8557,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);
@@ -9125,4 +9269,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, 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, validateMinimumAssetSize, validatePositionSize };

package/dist/utils/position-validator.d.ts

@@ -0,0 +1,41 @@
+import type { PairAssetInput } from "../clients/positions";
+/**
+ * Minimum USD value required per asset when creating a position
+ */
+export declare const MINIMUM_ASSET_USD_VALUE = 11;
+/**
+ * Validation error for minimum position size
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export declare function validatePositionSize(usdValue: number, longAssets?: PairAssetInput[], shortAssets?: PairAssetInput[]): {
+    valid: boolean;
+    error?: string;
+    minimumRequired?: number;
+};

package/package.json

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