@pear-protocol/hyperliquid-sdk 0.1.20-pnl → 0.1.22-beta

package/README.md

@@ -557,8 +557,17 @@ const result = await createPosition(apiBaseUrl, {
   executionType: 'MARKET',
 });
 
-// Close position
-await closePosition(apiBaseUrl, positionId, { slippage: 0.5 });
+// Close position immediately
+await closePosition(apiBaseUrl, positionId, { executionType: 'MARKET' });
+
+// Close position conditionally
+// Example: close when the weighted price ratio rises above 1.08.
+await closePosition(apiBaseUrl, positionId, {
+  executionType: 'TRIGGER',
+  triggerType: 'WEIGHTED_RATIO',
+  triggerValue: '1.08',
+  direction: 'MORE_THAN',
+});
 
 // Update TP/SL
 await updateRiskParameters(apiBaseUrl, positionId, {
@@ -864,7 +873,7 @@ function TradingInterface() {
         {openPositions?.map(pos => (
           <div key={pos.positionId}>
             PnL: ${pos.unrealizedPnl.toFixed(2)}
-            <button onClick={() => closePosition(pos.positionId, { slippage: 0.5 })}>
+            <button onClick={() => closePosition(pos.positionId, { executionType: 'MARKET' })}>
               Close
             </button>
           </div>

package/dist/clients/positions.d.ts

@@ -1,4 +1,4 @@
-import type { ApiResponse, CreatePositionRequestInput, CreatePositionResponseDto, TpSlThresholdInput } from "../types";
+import type { ApiResponse, CloseExecutionType, CloseTriggerType, CreatePositionRequestInput, CreatePositionResponseDto, OrderDirection, TpSlThresholdInput } from "../types";
 import type { CancelTwapResponseDto } from "./orders";
 /**
  * Create a position (MARKET/LIMIT/TWAP) using Pear Hyperliquid service
@@ -18,17 +18,22 @@ export interface UpdateRiskParametersResponseDto {
     updatedAt: string;
 }
 export declare function updateRiskParameters(baseUrl: string, positionId: string, payload: UpdateRiskParametersRequestInput): Promise<ApiResponse<UpdateRiskParametersResponseDto>>;
-export type CloseExecutionType = "MARKET" | "TWAP";
+export type ClosePositionExecutionType = CloseExecutionType;
+export type CloseAllExecutionType = "MARKET" | "TWAP";
 export interface ClosePositionRequestInput {
     executionType: CloseExecutionType;
     twapDuration?: number;
     twapIntervalSeconds?: number;
     randomizeExecution?: boolean;
+    triggerType?: CloseTriggerType;
+    triggerValue?: string;
+    direction?: OrderDirection;
     referralCode?: string;
 }
 export interface ClosePositionResponseDto {
     orderId: string;
     executionTime?: string;
+    orderIds?: string[];
     chunksScheduled?: number;
 }
 export declare function closePosition(baseUrl: string, positionId: string, payload: ClosePositionRequestInput): Promise<ApiResponse<ClosePositionResponseDto>>;
@@ -41,7 +46,14 @@ export interface CloseAllPositionsResultDto {
 export interface CloseAllPositionsResponseDto {
     results: CloseAllPositionsResultDto[];
 }
-export declare function closeAllPositions(baseUrl: string, payload: ClosePositionRequestInput): Promise<ApiResponse<CloseAllPositionsResponseDto>>;
+export interface CloseAllPositionsRequestInput {
+    executionType: CloseAllExecutionType;
+    twapDuration?: number;
+    twapIntervalSeconds?: number;
+    randomizeExecution?: boolean;
+    referralCode?: string;
+}
+export declare function closeAllPositions(baseUrl: string, payload: CloseAllPositionsRequestInput): Promise<ApiResponse<CloseAllPositionsResponseDto>>;
 export type AdjustExecutionType = "MARKET" | "LIMIT";
 export type PositionAdjustmentType = "REDUCE" | "INCREASE";
 export interface AdjustPositionRequestInput {

package/dist/hooks/index.d.ts

@@ -18,5 +18,3 @@ export * from './usePortfolio';
 export * from './useAuth';
 export * from './useAllUserBalances';
 export * from './useHyperliquidUserFills';
-export * from './usePnlCalendar';
-export * from './usePnlHeatmap';

package/dist/hooks/usePosition.d.ts

@@ -1,4 +1,4 @@
-import { type UpdateRiskParametersRequestInput, type UpdateRiskParametersResponseDto, type ClosePositionRequestInput, type ClosePositionResponseDto, type CloseAllPositionsResponseDto, type AdjustPositionRequestInput, type AdjustPositionResponseDto, type AdjustAdvanceItemInput, type AdjustAdvanceResponseDto, type UpdateLeverageResponseDto } from '../clients/positions';
+import { type UpdateRiskParametersRequestInput, type UpdateRiskParametersResponseDto, type ClosePositionRequestInput, type ClosePositionResponseDto, type CloseAllPositionsRequestInput, type CloseAllPositionsResponseDto, type AdjustPositionRequestInput, type AdjustPositionResponseDto, type AdjustAdvanceItemInput, type AdjustAdvanceResponseDto, type UpdateLeverageResponseDto } from '../clients/positions';
 import type { ApiResponse, CreatePositionRequestInput, CreatePositionResponseDto, OpenPositionDto } from '../types';
 export interface RebalanceAssetPlan {
     coin: string;
@@ -23,7 +23,7 @@ export declare function usePosition(): {
     readonly createPosition: (payload: CreatePositionRequestInput) => Promise<ApiResponse<CreatePositionResponseDto>>;
     readonly updateRiskParameters: (positionId: string, payload: UpdateRiskParametersRequestInput) => Promise<ApiResponse<UpdateRiskParametersResponseDto>>;
     readonly closePosition: (positionId: string, payload: ClosePositionRequestInput) => Promise<ApiResponse<ClosePositionResponseDto>>;
-    readonly closeAllPositions: (payload: ClosePositionRequestInput) => Promise<ApiResponse<CloseAllPositionsResponseDto>>;
+    readonly closeAllPositions: (payload: CloseAllPositionsRequestInput) => Promise<ApiResponse<CloseAllPositionsResponseDto>>;
     readonly adjustPosition: (positionId: string, payload: AdjustPositionRequestInput) => Promise<ApiResponse<AdjustPositionResponseDto>>;
     readonly adjustAdvancePosition: (positionId: string, payload: AdjustAdvanceItemInput[]) => Promise<ApiResponse<AdjustAdvanceResponseDto>>;
     readonly updateLeverage: (positionId: string, leverage: number) => Promise<ApiResponse<UpdateLeverageResponseDto | null>>;

package/dist/index.d.ts

@@ -342,6 +342,8 @@ type TpSlTriggerType = 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE' | 'PRICE' | 'P
  * Trigger type for trigger orders
  */
 type TriggerType = 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO' | 'BTC_DOM' | 'CROSS_ASSET_PRICE' | 'PREDICTION_MARKET_OUTCOME';
+type CloseTriggerType = 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO' | 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE';
+type CloseExecutionType = 'MARKET' | 'TWAP' | 'TRIGGER';
 type OrderDirection = 'MORE_THAN' | 'LESS_THAN';
 /**
  * Market order parameters
@@ -1232,17 +1234,22 @@ interface UpdateRiskParametersResponseDto {
     updatedAt: string;
 }
 declare function updateRiskParameters(baseUrl: string, positionId: string, payload: UpdateRiskParametersRequestInput): Promise<ApiResponse<UpdateRiskParametersResponseDto>>;
-type CloseExecutionType = "MARKET" | "TWAP";
+type ClosePositionExecutionType = CloseExecutionType;
+type CloseAllExecutionType = "MARKET" | "TWAP";
 interface ClosePositionRequestInput {
     executionType: CloseExecutionType;
     twapDuration?: number;
     twapIntervalSeconds?: number;
     randomizeExecution?: boolean;
+    triggerType?: CloseTriggerType;
+    triggerValue?: string;
+    direction?: OrderDirection;
     referralCode?: string;
 }
 interface ClosePositionResponseDto {
     orderId: string;
     executionTime?: string;
+    orderIds?: string[];
     chunksScheduled?: number;
 }
 declare function closePosition(baseUrl: string, positionId: string, payload: ClosePositionRequestInput): Promise<ApiResponse<ClosePositionResponseDto>>;
@@ -1255,7 +1262,14 @@ interface CloseAllPositionsResultDto {
 interface CloseAllPositionsResponseDto {
     results: CloseAllPositionsResultDto[];
 }
-declare function closeAllPositions(baseUrl: string, payload: ClosePositionRequestInput): Promise<ApiResponse<CloseAllPositionsResponseDto>>;
+interface CloseAllPositionsRequestInput {
+    executionType: CloseAllExecutionType;
+    twapDuration?: number;
+    twapIntervalSeconds?: number;
+    randomizeExecution?: boolean;
+    referralCode?: string;
+}
+declare function closeAllPositions(baseUrl: string, payload: CloseAllPositionsRequestInput): Promise<ApiResponse<CloseAllPositionsResponseDto>>;
 type AdjustExecutionType = "MARKET" | "LIMIT";
 type PositionAdjustmentType = "REDUCE" | "INCREASE";
 interface AdjustPositionRequestInput {
@@ -1320,7 +1334,7 @@ declare function usePosition(): {
     readonly createPosition: (payload: CreatePositionRequestInput) => Promise<ApiResponse<CreatePositionResponseDto>>;
     readonly updateRiskParameters: (positionId: string, payload: UpdateRiskParametersRequestInput) => Promise<ApiResponse<UpdateRiskParametersResponseDto>>;
     readonly closePosition: (positionId: string, payload: ClosePositionRequestInput) => Promise<ApiResponse<ClosePositionResponseDto>>;
-    readonly closeAllPositions: (payload: ClosePositionRequestInput) => Promise<ApiResponse<CloseAllPositionsResponseDto>>;
+    readonly closeAllPositions: (payload: CloseAllPositionsRequestInput) => Promise<ApiResponse<CloseAllPositionsResponseDto>>;
     readonly adjustPosition: (positionId: string, payload: AdjustPositionRequestInput) => Promise<ApiResponse<AdjustPositionResponseDto>>;
     readonly adjustAdvancePosition: (positionId: string, payload: AdjustAdvanceItemInput[]) => Promise<ApiResponse<AdjustAdvanceResponseDto>>;
     readonly updateLeverage: (positionId: string, leverage: number) => Promise<ApiResponse<UpdateLeverageResponseDto | null>>;
@@ -1498,81 +1512,6 @@ interface UseHyperliquidUserFillsState {
  */
 declare function useHyperliquidUserFills(options: UseHyperliquidUserFillsOptions): UseHyperliquidUserFillsState;
 
-type PnlCalendarTimeframe = '2W' | '3W' | '2M' | '3M';
-interface PnlCalendarOptions {
-    timeframe?: PnlCalendarTimeframe;
-    startDate?: Date | string;
-    endDate?: Date | string;
-}
-interface PnlCalendarAsset {
-    coin: string;
-    symbol: string;
-    assetName: string;
-    marketPrefix: string;
-    percentage: number;
-    collateralToken: string;
-}
-interface PnlCalendarTrade {
-    tradeHistoryId: string;
-    realizedPnl: number;
-    result: 'profit' | 'loss' | 'breakeven';
-    collateralTypes: string[];
-    closedLongAssets: PnlCalendarAsset[];
-    closedShortAssets: PnlCalendarAsset[];
-}
-interface PnlCalendarDay {
-    date: string;
-    totalPnl: number;
-    volume: number;
-    positionsClosed: number;
-    result: 'profit' | 'loss' | 'breakeven';
-    trades: PnlCalendarTrade[];
-}
-interface PeriodSummary {
-    pnl: number;
-    volume: number;
-    winRate: number;
-    wins: number;
-    losses: number;
-    totalProfit: number;
-    totalLoss: number;
-}
-interface PnlCalendarWeek {
-    weekStart: string;
-    weekEnd: string;
-    days: PnlCalendarDay[];
-    summary: PeriodSummary;
-}
-interface PnlCalendarMonth {
-    month: string;
-    label: string;
-    days: PnlCalendarDay[];
-    summary: PeriodSummary;
-}
-interface UsePnlCalendarResult {
-    timeframe: PnlCalendarTimeframe;
-    weeks: PnlCalendarWeek[];
-    months: PnlCalendarMonth[];
-    overall: PeriodSummary;
-    isLoading: boolean;
-    error: string | null;
-    refetch: () => void;
-}
-declare function usePnlCalendar(options?: PnlCalendarTimeframe | PnlCalendarOptions): UsePnlCalendarResult;
-
-type PnlHeatmapTimeframe = 'allTime' | '100D' | '30D' | '7D';
-interface PnlHeatmapTrade extends PnlCalendarTrade {
-    percentage: number;
-}
-interface UsePnlHeatmapResult {
-    timeframe: PnlHeatmapTimeframe;
-    trades: PnlHeatmapTrade[];
-    isLoading: boolean;
-    error: string | null;
-    refetch: () => void;
-}
-declare function usePnlHeatmap(timeframe?: PnlHeatmapTimeframe): UsePnlHeatmapResult;
-
 /**
  * Mark notifications as read up to a given timestamp (ms)
  */
@@ -1748,6 +1687,9 @@ declare class MaxAssetsPerLegError extends Error {
     maxAllowed: number;
     constructor(leg: "long" | "short", assetCount: number, maxAllowed: number);
 }
+declare class ClosePositionValidationError extends Error {
+    constructor(message: string);
+}
 /**
  * Validates that each leg doesn't exceed the maximum number of assets
  * @param longAssets Array of long assets
@@ -1782,6 +1724,16 @@ declare function validatePositionSize(usdValue: number, longAssets?: PairAssetIn
     error?: string;
     minimumRequired?: number;
 };
+interface ClosePositionValidationInput {
+    executionType: CloseExecutionType;
+    twapDuration?: number;
+    twapIntervalSeconds?: number;
+    randomizeExecution?: boolean;
+    triggerType?: CloseTriggerType;
+    triggerValue?: string;
+    direction?: OrderDirection;
+}
+declare function validateClosePositionRequest(payload: ClosePositionValidationInput): void;
 
 /**
  * Helper functions to safely extract values from order parameters
@@ -1847,5 +1799,5 @@ interface MarketDataState {
 }
 declare const useMarketData: zustand.UseBoundStore<zustand.StoreApi<MarketDataState>>;
 
-export { ConflictDetector, MAX_ASSETS_PER_LEG, MINIMUM_ASSET_USD_VALUE, MaxAssetsPerLegError, MinimumPositionSizeError, PearHyperliquidProvider, ReadyState, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getCompleteTimestamps, getKalshiMarkets, getOrderDirection, getOrderLadderConfig, getOrderLeverage, getOrderReduceOnly, getOrderTpSlTriggerType, getOrderTrailingInfo, getOrderTriggerType, getOrderTriggerValue, getOrderTwapDuration, getOrderUsdValue, getPortfolio, isBtcDomOrder, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toggleWatchlist, updateLeverage, updateRiskParameters, useAccountSummary, useAgentWallet, useAllUserBalances, useAuth, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidUserFills, useMarket, useMarketData, useMarketDataHook, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePnlCalendar, usePnlHeatmap, usePortfolio, usePosition, useSpotOrder, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWatchlist, validateMaxAssetsPerLeg, validateMinimumAssetSize, validatePositionSize };
-export type { AccountSummaryResponseDto, ActiveAssetData, ActiveAssetGroupItem, ActiveAssetsAllResponse, ActiveAssetsResponse, AddressState, AdjustAdvanceAssetInput, AdjustAdvanceItemInput, AdjustAdvanceResponseDto, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, AgentWalletStatus, AllDexsAssetCtxsData, AllDexsClearinghouseStateData, AllPerpMetasItem, AllPerpMetasResponse, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, AuthenticateRequest, AuthenticateResponse, AvailableToTrades, BalanceSummaryDto, BaseTriggerOrderNotificationParams, BtcDomTriggerParams, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ChunkFillDto, ClearinghouseState, CloseAllPositionsResponseDto, CloseAllPositionsResultDto, CloseExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CollateralToken, CreateAgentWalletResponseDto, CreatePositionRequestInput, CreatePositionResponseDto, CrossAssetPriceTriggerParams, CrossMarginSummaryDto, CumFundingDto, EIP712AuthDetails, ExecutionType, ExternalFillDto, ExternalLiquidationDto, ExtraAgent, GetAgentWalletResponseDto, GetEIP712MessageResponse, GetKalshiMarketsParams, HLChannel, HLChannelDataMap, HLWebSocketResponse, HistoricalRange, KalshiMarket, KalshiMarketsResponse, KalshiMveLeg, KalshiPriceRange, LadderConfigInput, LadderOrderParameters, LeverageInfo, LogoutRequest, LogoutResponse, MarginRequiredPerCollateral, MarginRequiredResult, MarginSummaryDto, MarginTableDef, MarginTablesEntry, MarginTier, MarketOrderParameters, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderDirection, OrderParameters, OrderStatus, OrderType, PairAssetDto, PairAssetInput, PerformanceOverlay, PeriodSummary, PerpDex, PerpDexsResponse, PerpMetaAsset, PlatformAccountSummaryResponseDto, PnlCalendarAsset, PnlCalendarDay, PnlCalendarMonth, PnlCalendarOptions, PnlCalendarTimeframe, PnlCalendarTrade, PnlCalendarWeek, PnlHeatmapTimeframe, PnlHeatmapTrade, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PredictionMarketOutcomeTriggerParams, PriceRatioTriggerParams, PriceTriggerParams, PrivyAuthDetails, RawAssetDto, RawPositionDto, RealtimeBar, RealtimeBarsCallback, RebalanceAssetPlan, RebalancePlan, RefreshTokenRequest, RefreshTokenResponse, SpotBalance, SpotBalances, SpotOrderFilledStatus, SpotOrderHyperliquidData, SpotOrderHyperliquidResult, SpotOrderRequestInput, SpotOrderResponseDto, SpotState, SyncFillsRequestDto, SyncFillsResponseDto, ToggleWatchlistResponseDto, TokenConflict, TokenEntry, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TokenSelectorConfig, TpSlOrderParameters, TpSlThreshold, TpSlThresholdInput, TpSlThresholdType, TpSlTriggerType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TriggerOrderNotificationAsset, TriggerOrderNotificationParams, TriggerOrderNotificationType, TriggerOrderParameters, TriggerType, TwapChunkStatus, TwapChunkStatusDto, TwapMonitoringDto, TwapOrderOverallStatus, TwapOrderParameters, TwapSliceFillResponseItem, UniverseAsset, UpdateLeverageRequestInput, UpdateLeverageResponseDto, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseHyperliquidUserFillsOptions, UseHyperliquidUserFillsState, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePnlCalendarResult, UsePnlHeatmapResult, UsePortfolioResult, UseSpotOrderResult, UseTokenSelectionMetadataReturn, UserAbstraction, UserProfile, UserSelectionState, WatchlistAssetDto, WatchlistItemDto, WebData3AssetCtx, WebData3PerpDexState, WebData3Response, WebData3UserState, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };
+export { ClosePositionValidationError, ConflictDetector, MAX_ASSETS_PER_LEG, MINIMUM_ASSET_USD_VALUE, MaxAssetsPerLegError, MinimumPositionSizeError, PearHyperliquidProvider, ReadyState, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getCompleteTimestamps, getKalshiMarkets, getOrderDirection, getOrderLadderConfig, getOrderLeverage, getOrderReduceOnly, getOrderTpSlTriggerType, getOrderTrailingInfo, getOrderTriggerType, getOrderTriggerValue, getOrderTwapDuration, getOrderUsdValue, getPortfolio, isBtcDomOrder, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toggleWatchlist, updateLeverage, updateRiskParameters, useAccountSummary, useAgentWallet, useAllUserBalances, useAuth, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidUserFills, useMarket, useMarketData, useMarketDataHook, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePortfolio, usePosition, useSpotOrder, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWatchlist, validateClosePositionRequest, validateMaxAssetsPerLeg, validateMinimumAssetSize, validatePositionSize };
+export type { AccountSummaryResponseDto, ActiveAssetData, ActiveAssetGroupItem, ActiveAssetsAllResponse, ActiveAssetsResponse, AddressState, AdjustAdvanceAssetInput, AdjustAdvanceItemInput, AdjustAdvanceResponseDto, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, AgentWalletStatus, AllDexsAssetCtxsData, AllDexsClearinghouseStateData, AllPerpMetasItem, AllPerpMetasResponse, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, AuthenticateRequest, AuthenticateResponse, AvailableToTrades, BalanceSummaryDto, BaseTriggerOrderNotificationParams, BtcDomTriggerParams, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ChunkFillDto, ClearinghouseState, CloseAllExecutionType, CloseAllPositionsRequestInput, CloseAllPositionsResponseDto, CloseAllPositionsResultDto, CloseExecutionType, ClosePositionExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CloseTriggerType, CollateralToken, CreateAgentWalletResponseDto, CreatePositionRequestInput, CreatePositionResponseDto, CrossAssetPriceTriggerParams, CrossMarginSummaryDto, CumFundingDto, EIP712AuthDetails, ExecutionType, ExternalFillDto, ExternalLiquidationDto, ExtraAgent, GetAgentWalletResponseDto, GetEIP712MessageResponse, GetKalshiMarketsParams, HLChannel, HLChannelDataMap, HLWebSocketResponse, HistoricalRange, KalshiMarket, KalshiMarketsResponse, KalshiMveLeg, KalshiPriceRange, LadderConfigInput, LadderOrderParameters, LeverageInfo, LogoutRequest, LogoutResponse, MarginRequiredPerCollateral, MarginRequiredResult, MarginSummaryDto, MarginTableDef, MarginTablesEntry, MarginTier, MarketOrderParameters, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderDirection, OrderParameters, OrderStatus, OrderType, PairAssetDto, PairAssetInput, PerformanceOverlay, PerpDex, PerpDexsResponse, PerpMetaAsset, PlatformAccountSummaryResponseDto, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PredictionMarketOutcomeTriggerParams, PriceRatioTriggerParams, PriceTriggerParams, PrivyAuthDetails, RawAssetDto, RawPositionDto, RealtimeBar, RealtimeBarsCallback, RebalanceAssetPlan, RebalancePlan, RefreshTokenRequest, RefreshTokenResponse, SpotBalance, SpotBalances, SpotOrderFilledStatus, SpotOrderHyperliquidData, SpotOrderHyperliquidResult, SpotOrderRequestInput, SpotOrderResponseDto, SpotState, SyncFillsRequestDto, SyncFillsResponseDto, ToggleWatchlistResponseDto, TokenConflict, TokenEntry, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TokenSelectorConfig, TpSlOrderParameters, TpSlThreshold, TpSlThresholdInput, TpSlThresholdType, TpSlTriggerType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TriggerOrderNotificationAsset, TriggerOrderNotificationParams, TriggerOrderNotificationType, TriggerOrderParameters, TriggerType, TwapChunkStatus, TwapChunkStatusDto, TwapMonitoringDto, TwapOrderOverallStatus, TwapOrderParameters, TwapSliceFillResponseItem, UniverseAsset, UpdateLeverageRequestInput, UpdateLeverageResponseDto, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseHyperliquidUserFillsOptions, UseHyperliquidUserFillsState, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseSpotOrderResult, UseTokenSelectionMetadataReturn, UserAbstraction, UserProfile, UserSelectionState, WatchlistAssetDto, WatchlistItemDto, WebData3AssetCtx, WebData3PerpDexState, WebData3Response, WebData3UserState, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };

package/dist/index.js

@@ -696,6 +696,12 @@ class MaxAssetsPerLegError extends Error {
         this.name = "MaxAssetsPerLegError";
     }
 }
+class ClosePositionValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ClosePositionValidationError";
+    }
+}
 /**
  * Validates that each leg doesn't exceed the maximum number of assets
  * @param longAssets Array of long assets
@@ -776,6 +782,44 @@ function validatePositionSize(usdValue, longAssets, shortAssets) {
         throw error;
     }
 }
+function isNumberString(value) {
+    if (value.trim() === "") {
+        return false;
+    }
+    return Number.isFinite(Number(value));
+}
+function validateClosePositionRequest(payload) {
+    if (payload.executionType === "TWAP") {
+        if (payload.twapDuration === undefined || payload.twapDuration <= 0) {
+            throw new ClosePositionValidationError("twapDuration is required and must be greater than 0 when executionType is TWAP");
+        }
+        if (payload.twapIntervalSeconds !== undefined &&
+            payload.twapIntervalSeconds <= 0) {
+            throw new ClosePositionValidationError("twapIntervalSeconds must be greater than 0 when provided for TWAP closes");
+        }
+    }
+    else if (payload.twapDuration !== undefined ||
+        payload.twapIntervalSeconds !== undefined ||
+        payload.randomizeExecution !== undefined) {
+        throw new ClosePositionValidationError("twapDuration, twapIntervalSeconds, and randomizeExecution are only supported when executionType is TWAP");
+    }
+    if (payload.executionType === "TRIGGER") {
+        if (!payload.triggerType) {
+            throw new ClosePositionValidationError("triggerType is required when executionType is TRIGGER");
+        }
+        if (!payload.direction) {
+            throw new ClosePositionValidationError("direction is required when executionType is TRIGGER");
+        }
+        if (!payload.triggerValue || !isNumberString(payload.triggerValue)) {
+            throw new ClosePositionValidationError("triggerValue is required and must be a numeric string when executionType is TRIGGER");
+        }
+    }
+    else if (payload.triggerType !== undefined ||
+        payload.triggerValue !== undefined ||
+        payload.direction !== undefined) {
+        throw new ClosePositionValidationError("triggerType, triggerValue, and direction are only supported when executionType is TRIGGER");
+    }
+}
 
 const DEFAULT_STATE = {
     longTokens: [
@@ -981,7 +1025,7 @@ const useHyperliquidNativeWebSocket = ({ address, enabled = true, onUserFills, }
                         // finalAssetContexts now sourced from allDexsAssetCtxs channel
                         const finalAtOICaps = webData3.perpDexStates.flatMap((dex) => dex.perpsAtOpenInterestCap);
                         setFinalAtOICaps(finalAtOICaps);
-                        setUserAbstractionMode(webData3.userState.abstraction || null);
+                        setUserAbstractionMode(webData3.userState.abstraction || 'disabled');
                         break;
                     case "allDexsAssetCtxs":
                         {
@@ -6950,10 +6994,20 @@ async function updateRiskParameters(baseUrl, positionId, payload) {
         throw toApiError(error);
     }
 }
+function normalizeClosePositionPayload(payload) {
+    return {
+        ...payload,
+        triggerValue: payload.triggerValue === undefined
+            ? undefined
+            : String(payload.triggerValue),
+    };
+}
 async function closePosition(baseUrl, positionId, payload) {
     const url = joinUrl(baseUrl, `/positions/${positionId}/close`);
+    const normalizedPayload = normalizeClosePositionPayload(payload);
+    validateClosePositionRequest(normalizedPayload);
     try {
-        const resp = await apiClient.post(url, payload, {
+        const resp = await apiClient.post(url, normalizedPayload, {
             headers: {
                 "Content-Type": "application/json",
             },
@@ -8422,456 +8476,6 @@ function useHyperliquidUserFills(options) {
     };
 }
 
-async function getTradeHistory(baseUrl, params) {
-    const url = joinUrl(baseUrl, '/trade-history');
-    try {
-        const resp = await apiClient.get(url, {
-            params,
-            timeout: 60000,
-        });
-        return { data: resp.data, status: resp.status, headers: resp.headers };
-    }
-    catch (error) {
-        throw toApiError(error);
-    }
-}
-
-// ─── helpers ────────────────────────────────────────────────────
-const EMPTY_SUMMARY = {
-    pnl: 0,
-    volume: 0,
-    winRate: 0,
-    wins: 0,
-    losses: 0,
-    totalProfit: 0,
-    totalLoss: 0,
-};
-const getTimeframeDays$1 = (tf) => {
-    switch (tf) {
-        case '2W':
-            return 14;
-        case '3W':
-            return 21;
-        case '2M':
-            return 60;
-        case '3M':
-            return 90;
-    }
-};
-const isWeekTimeframe = (tf) => tf === '2W' || tf === '3W';
-const toDateKey = (date) => {
-    const y = date.getFullYear();
-    const m = String(date.getMonth() + 1).padStart(2, '0');
-    const d = String(date.getDate()).padStart(2, '0');
-    return `${y}-${m}-${d}`;
-};
-const toMonthKey = (date) => {
-    const y = date.getFullYear();
-    const m = String(date.getMonth() + 1).padStart(2, '0');
-    return `${y}-${m}`;
-};
-const formatMonthLabel = (date) => date.toLocaleDateString('en-US', { month: 'short', year: 'numeric' });
-const getMonday = (date) => {
-    const d = new Date(date);
-    const day = d.getDay(); // 0=Sun … 6=Sat
-    const diff = day === 0 ? -6 : 1 - day;
-    d.setDate(d.getDate() + diff);
-    d.setHours(0, 0, 0, 0);
-    return d;
-};
-const toLocalMidnight = (input) => {
-    const d = typeof input === 'string' ? new Date(input + 'T00:00:00') : new Date(input);
-    d.setHours(0, 0, 0, 0);
-    return d;
-};
-const diffDays = (start, end) => {
-    return Math.round((end.getTime() - start.getTime()) / (1000 * 60 * 60 * 24)) + 1;
-};
-const toISODateString$1 = (input) => {
-    const d = typeof input === 'string' ? new Date(input + 'T00:00:00') : new Date(input);
-    return d.toISOString();
-};
-const round2 = (n) => Math.round(n * 100) / 100;
-const mapAsset$1 = (asset, getAssetByName) => {
-    var _a, _b, _c, _d;
-    const metadata = getAssetByName(asset.coin);
-    const marketInfo = getMarketInfoFromSymbol(asset.coin);
-    return {
-        coin: asset.coin,
-        symbol: (_a = metadata === null || metadata === void 0 ? void 0 : metadata.symbolName) !== null && _a !== void 0 ? _a : marketInfo.symbolName,
-        assetName: (_b = metadata === null || metadata === void 0 ? void 0 : metadata.assetName) !== null && _b !== void 0 ? _b : asset.coin,
-        marketPrefix: (_c = metadata === null || metadata === void 0 ? void 0 : metadata.marketName) !== null && _c !== void 0 ? _c : marketInfo.marketName,
-        percentage: asset.closeWeight * 100,
-        collateralToken: (_d = metadata === null || metadata === void 0 ? void 0 : metadata.collateralToken) !== null && _d !== void 0 ? _d : 'USDC',
-    };
-};
-const getCollateralTypes$1 = (assets) => {
-    const set = new Set();
-    for (const a of assets)
-        set.add(a.collateralToken);
-    return set.size > 0 ? Array.from(set) : ['USDC'];
-};
-const buildSummary = (days) => {
-    let pnl = 0;
-    let volume = 0;
-    let wins = 0;
-    let losses = 0;
-    let totalProfit = 0;
-    let totalLoss = 0;
-    for (const day of days) {
-        pnl += day.totalPnl;
-        volume += day.volume;
-        if (day.positionsClosed === 0)
-            continue;
-        if (day.totalPnl > 0) {
-            wins++;
-            totalProfit += day.totalPnl;
-        }
-        else if (day.totalPnl < 0) {
-            losses++;
-            totalLoss += Math.abs(day.totalPnl);
-        }
-    }
-    const total = wins + losses;
-    const winRate = total > 0 ? Math.round((wins / total) * 100) : 0;
-    return {
-        pnl: round2(pnl),
-        volume: round2(volume),
-        winRate,
-        wins,
-        losses,
-        totalProfit: round2(totalProfit),
-        totalLoss: round2(totalLoss),
-    };
-};
-const buildCalendarData = (tradeHistories, timeframe, rangeStart, rangeEnd, totalDays, useCustomDates, getAssetByName) => {
-    const startKey = toDateKey(rangeStart);
-    const endKey = toDateKey(rangeEnd);
-    // Build day buckets for the full range
-    const buckets = new Map();
-    for (let i = 0; i < totalDays; i++) {
-        const d = new Date(rangeStart);
-        d.setDate(rangeStart.getDate() + i);
-        buckets.set(toDateKey(d), {
-            pnl: 0,
-            volume: 0,
-            positionsClosed: 0,
-            trades: [],
-        });
-    }
-    // Populate buckets from trade histories
-    for (const trade of tradeHistories) {
-        if (!trade.createdAt)
-            continue;
-        const date = new Date(trade.createdAt);
-        if (isNaN(date.getTime()))
-            continue;
-        const dateKey = toDateKey(date);
-        if (dateKey < startKey || dateKey > endKey)
-            continue;
-        const bucket = buckets.get(dateKey);
-        if (!bucket)
-            continue;
-        const pnl = trade.realizedPnl;
-        bucket.pnl += isFinite(pnl) ? pnl : 0;
-        const vol = trade.totalValue;
-        bucket.volume += isFinite(vol) ? vol : 0;
-        bucket.positionsClosed += 1;
-        const tradePnl = trade.realizedPnl;
-        const longAssets = trade.closedLongAssets.map((a) => mapAsset$1(a, getAssetByName));
-        const shortAssets = trade.closedShortAssets.map((a) => mapAsset$1(a, getAssetByName));
-        bucket.trades.push({
-            tradeHistoryId: trade.tradeHistoryId,
-            realizedPnl: tradePnl,
-            result: tradePnl > 0 ? 'profit' : tradePnl < 0 ? 'loss' : 'breakeven',
-            collateralTypes: getCollateralTypes$1([...longAssets, ...shortAssets]),
-            closedLongAssets: longAssets,
-            closedShortAssets: shortAssets,
-        });
-    }
-    // Build day objects
-    const allDays = [];
-    const sortedKeys = Array.from(buckets.keys()).sort();
-    for (const key of sortedKeys) {
-        const bucket = buckets.get(key);
-        const roundedPnl = round2(bucket.pnl);
-        const result = roundedPnl > 0 ? 'profit' : roundedPnl < 0 ? 'loss' : 'breakeven';
-        allDays.push({
-            date: key,
-            totalPnl: roundedPnl,
-            volume: round2(bucket.volume),
-            positionsClosed: bucket.positionsClosed,
-            result,
-            trades: bucket.trades,
-        });
-    }
-    // Group into periods
-    let weeks = [];
-    let months = [];
-    const useWeekGrouping = useCustomDates
-        ? totalDays <= 28
-        : isWeekTimeframe(timeframe);
-    if (useWeekGrouping) {
-        const weekMap = new Map();
-        for (const day of allDays) {
-            const date = new Date(day.date + 'T00:00:00');
-            const monday = getMonday(date);
-            const mondayKey = toDateKey(monday);
-            if (!weekMap.has(mondayKey)) {
-                weekMap.set(mondayKey, []);
-            }
-            weekMap.get(mondayKey).push(day);
-        }
-        const sortedWeekKeys = Array.from(weekMap.keys()).sort();
-        weeks = sortedWeekKeys.map((mondayKey) => {
-            const days = weekMap.get(mondayKey);
-            const monday = new Date(mondayKey + 'T00:00:00');
-            const sunday = new Date(monday);
-            sunday.setDate(monday.getDate() + 6);
-            return {
-                weekStart: mondayKey,
-                weekEnd: toDateKey(sunday),
-                days,
-                summary: buildSummary(days),
-            };
-        });
-    }
-    else {
-        const monthMap = new Map();
-        for (const day of allDays) {
-            const date = new Date(day.date + 'T00:00:00');
-            const mk = toMonthKey(date);
-            if (!monthMap.has(mk)) {
-                monthMap.set(mk, { days: [], label: formatMonthLabel(date) });
-            }
-            monthMap.get(mk).days.push(day);
-        }
-        const sortedMonthKeys = Array.from(monthMap.keys()).sort();
-        months = sortedMonthKeys.map((mk) => {
-            const { days, label } = monthMap.get(mk);
-            return {
-                month: mk,
-                label,
-                days,
-                summary: buildSummary(days),
-            };
-        });
-    }
-    return {
-        timeframe,
-        weeks,
-        months,
-        overall: buildSummary(allDays),
-        isLoading: false,
-    };
-};
-// ─── hook ───────────────────────────────────────────────────────
-function usePnlCalendar(options) {
-    var _a;
-    const opts = typeof options === 'string'
-        ? { timeframe: options }
-        : options !== null && options !== void 0 ? options : {};
-    const timeframe = (_a = opts.timeframe) !== null && _a !== void 0 ? _a : '2W';
-    const customStart = opts.startDate;
-    const customEnd = opts.endDate;
-    const context = useContext(PearHyperliquidContext);
-    if (!context) {
-        throw new Error('usePnlCalendar must be used within a PearHyperliquidProvider');
-    }
-    const { apiBaseUrl } = context;
-    const isAuthenticated = useUserData((state) => state.isAuthenticated);
-    const { getAssetByName } = useMarket();
-    const [trades, setTrades] = useState(null);
-    const [isLoading, setIsLoading] = useState(false);
-    const [error, setError] = useState(null);
-    const mountedRef = useRef(true);
-    useEffect(() => {
-        mountedRef.current = true;
-        return () => { mountedRef.current = false; };
-    }, []);
-    // Compute the date range
-    const useCustomDates = !!(customStart && customEnd);
-    let rangeStart;
-    let rangeEnd;
-    let totalDays;
-    if (useCustomDates) {
-        rangeStart = toLocalMidnight(customStart);
-        rangeEnd = toLocalMidnight(customEnd);
-        totalDays = diffDays(rangeStart, rangeEnd);
-    }
-    else {
-        totalDays = getTimeframeDays$1(timeframe);
-        rangeEnd = new Date();
-        rangeEnd.setHours(0, 0, 0, 0);
-        rangeStart = new Date(rangeEnd);
-        rangeStart.setDate(rangeEnd.getDate() - totalDays + 1);
-    }
-    const startIso = toISODateString$1(rangeStart);
-    const endIso = toISODateString$1(rangeEnd);
-    const fetchData = useCallback(async () => {
-        if (!isAuthenticated)
-            return;
-        setIsLoading(true);
-        setError(null);
-        try {
-            const response = await getTradeHistory(apiBaseUrl, {
-                startDate: startIso,
-                endDate: endIso,
-                limit: totalDays * 50,
-            });
-            if (!mountedRef.current)
-                return;
-            setTrades(response.data);
-        }
-        catch (err) {
-            if (!mountedRef.current)
-                return;
-            setError(err instanceof Error ? err.message : 'Failed to fetch trade history');
-            setTrades(null);
-        }
-        finally {
-            if (mountedRef.current)
-                setIsLoading(false);
-        }
-    }, [apiBaseUrl, isAuthenticated, startIso, endIso, totalDays]);
-    useEffect(() => {
-        fetchData();
-    }, [fetchData]);
-    const result = useMemo(() => {
-        const empty = {
-            timeframe,
-            weeks: [],
-            months: [],
-            overall: EMPTY_SUMMARY,
-            isLoading: true,
-        };
-        if (!trades)
-            return empty;
-        if (totalDays <= 0)
-            return empty;
-        return buildCalendarData(trades, timeframe, rangeStart, rangeEnd, totalDays, useCustomDates, getAssetByName);
-    }, [trades, timeframe, startIso, endIso, getAssetByName]);
-    return { ...result, isLoading, error, refetch: fetchData };
-}
-
-const HEATMAP_LIMIT = 50;
-// ─── helpers ────────────────────────────────────────────────────
-const getTimeframeDays = (tf) => {
-    switch (tf) {
-        case '7D':
-            return 7;
-        case '30D':
-            return 30;
-        case '100D':
-            return 100;
-        case 'allTime':
-            return null;
-    }
-};
-const toISODateString = (date) => date.toISOString();
-const mapAsset = (asset, getAssetByName) => {
-    var _a, _b, _c, _d;
-    const metadata = getAssetByName(asset.coin);
-    const marketInfo = getMarketInfoFromSymbol(asset.coin);
-    return {
-        coin: asset.coin,
-        symbol: (_a = metadata === null || metadata === void 0 ? void 0 : metadata.symbolName) !== null && _a !== void 0 ? _a : marketInfo.symbolName,
-        assetName: (_b = metadata === null || metadata === void 0 ? void 0 : metadata.assetName) !== null && _b !== void 0 ? _b : asset.coin,
-        marketPrefix: (_c = metadata === null || metadata === void 0 ? void 0 : metadata.marketName) !== null && _c !== void 0 ? _c : marketInfo.marketName,
-        percentage: asset.closeWeight * 100,
-        collateralToken: (_d = metadata === null || metadata === void 0 ? void 0 : metadata.collateralToken) !== null && _d !== void 0 ? _d : 'USDC',
-    };
-};
-const getCollateralTypes = (assets) => {
-    const set = new Set();
-    for (const a of assets)
-        set.add(a.collateralToken);
-    return set.size > 0 ? Array.from(set) : ['USDC'];
-};
-const toCalendarTrade = (trade, getAssetByName) => {
-    const pnl = trade.realizedPnl;
-    const longAssets = trade.closedLongAssets.map((a) => mapAsset(a, getAssetByName));
-    const shortAssets = trade.closedShortAssets.map((a) => mapAsset(a, getAssetByName));
-    return {
-        tradeHistoryId: trade.tradeHistoryId,
-        realizedPnl: pnl,
-        result: pnl > 0 ? 'profit' : pnl < 0 ? 'loss' : 'breakeven',
-        collateralTypes: getCollateralTypes([...longAssets, ...shortAssets]),
-        closedLongAssets: longAssets,
-        closedShortAssets: shortAssets,
-    };
-};
-// ─── hook ───────────────────────────────────────────────────────
-function usePnlHeatmap(timeframe = 'allTime') {
-    const context = useContext(PearHyperliquidContext);
-    if (!context) {
-        throw new Error('usePnlHeatmap must be used within a PearHyperliquidProvider');
-    }
-    const { apiBaseUrl } = context;
-    const isAuthenticated = useUserData((state) => state.isAuthenticated);
-    const { getAssetByName } = useMarket();
-    const [trades, setTrades] = useState(null);
-    const [isLoading, setIsLoading] = useState(false);
-    const [error, setError] = useState(null);
-    const mountedRef = useRef(true);
-    useEffect(() => {
-        mountedRef.current = true;
-        return () => { mountedRef.current = false; };
-    }, []);
-    const days = getTimeframeDays(timeframe);
-    let startIso;
-    if (days !== null) {
-        const start = new Date();
-        start.setHours(0, 0, 0, 0);
-        start.setDate(start.getDate() - days);
-        startIso = toISODateString(start);
-    }
-    const fetchData = useCallback(async () => {
-        if (!isAuthenticated)
-            return;
-        setIsLoading(true);
-        setError(null);
-        try {
-            const response = await getTradeHistory(apiBaseUrl, {
-                ...(startIso ? { startDate: startIso } : {}),
-                limit: 5000,
-            });
-            if (!mountedRef.current)
-                return;
-            setTrades(response.data);
-        }
-        catch (err) {
-            if (!mountedRef.current)
-                return;
-            setError(err instanceof Error ? err.message : 'Failed to fetch trade history');
-            setTrades(null);
-        }
-        finally {
-            if (mountedRef.current)
-                setIsLoading(false);
-        }
-    }, [apiBaseUrl, isAuthenticated, startIso]);
-    useEffect(() => {
-        fetchData();
-    }, [fetchData]);
-    const result = useMemo(() => {
-        if (!trades)
-            return [];
-        const top = trades
-            .slice()
-            .sort((a, b) => Math.abs(b.realizedPnl) - Math.abs(a.realizedPnl))
-            .slice(0, HEATMAP_LIMIT);
-        const totalAbsPnl = top.reduce((sum, t) => sum + Math.abs(t.realizedPnl), 0);
-        return top.map((t) => ({
-            ...toCalendarTrade(t, getAssetByName),
-            percentage: totalAbsPnl > 0
-                ? Math.round((Math.abs(t.realizedPnl) / totalAbsPnl) * 10000) / 100
-                : 0,
-        }));
-    }, [trades, getAssetByName]);
-    return { timeframe, trades: result, isLoading, error, refetch: fetchData };
-}
-
 const PearHyperliquidContext = createContext(undefined);
 /**
  * React Provider for PearHyperliquidClient
@@ -9223,4 +8827,4 @@ function getOrderTrailingInfo(order) {
     return undefined;
 }
 
-export { ConflictDetector, MAX_ASSETS_PER_LEG, MINIMUM_ASSET_USD_VALUE, MaxAssetsPerLegError, MinimumPositionSizeError, PearHyperliquidProvider, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getCompleteTimestamps, getKalshiMarkets, getOrderDirection, getOrderLadderConfig, getOrderLeverage, getOrderReduceOnly, getOrderTpSlTriggerType, getOrderTrailingInfo, getOrderTriggerType, getOrderTriggerValue, getOrderTwapDuration, getOrderUsdValue, getPortfolio, isBtcDomOrder, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toggleWatchlist, updateLeverage, updateRiskParameters, useAccountSummary, useAgentWallet, useAllUserBalances, useAuth, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidUserFills, useMarket, useMarketData, useMarketDataHook, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePnlCalendar, usePnlHeatmap, usePortfolio, usePosition, useSpotOrder, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWatchlist, validateMaxAssetsPerLeg, validateMinimumAssetSize, validatePositionSize };
+export { ClosePositionValidationError, ConflictDetector, MAX_ASSETS_PER_LEG, MINIMUM_ASSET_USD_VALUE, MaxAssetsPerLegError, MinimumPositionSizeError, PearHyperliquidProvider, adjustAdvancePosition, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, executeSpotOrder, getCompleteTimestamps, getKalshiMarkets, getOrderDirection, getOrderLadderConfig, getOrderLeverage, getOrderReduceOnly, getOrderTpSlTriggerType, getOrderTrailingInfo, getOrderTriggerType, getOrderTriggerValue, getOrderTwapDuration, getOrderUsdValue, getPortfolio, isBtcDomOrder, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toggleWatchlist, updateLeverage, updateRiskParameters, useAccountSummary, useAgentWallet, useAllUserBalances, useAuth, useBasketCandles, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidUserFills, useMarket, useMarketData, useMarketDataHook, useNotifications, useOpenOrders, useOrders, usePearHyperliquid, usePerformanceOverlays, usePortfolio, usePosition, useSpotOrder, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWatchlist, validateClosePositionRequest, validateMaxAssetsPerLeg, validateMinimumAssetSize, validatePositionSize };

package/dist/types.d.ts

@@ -314,6 +314,8 @@ export type TpSlTriggerType = 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE' | 'PRIC
  * Trigger type for trigger orders
  */
 export type TriggerType = 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO' | 'BTC_DOM' | 'CROSS_ASSET_PRICE' | 'PREDICTION_MARKET_OUTCOME';
+export type CloseTriggerType = 'PRICE' | 'PRICE_RATIO' | 'WEIGHTED_RATIO' | 'PERCENTAGE' | 'DOLLAR' | 'POSITION_VALUE';
+export type CloseExecutionType = 'MARKET' | 'TWAP' | 'TRIGGER';
 export type OrderDirection = 'MORE_THAN' | 'LESS_THAN';
 /**
  * Market order parameters

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

@@ -1,4 +1,4 @@
-import { PairAssetInput } from "../types";
+import type { CloseExecutionType, CloseTriggerType, OrderDirection, PairAssetInput } from "../types";
 /**
  * Minimum USD value required per asset when creating a position
  */
@@ -25,6 +25,9 @@ export declare class MaxAssetsPerLegError extends Error {
     maxAllowed: number;
     constructor(leg: "long" | "short", assetCount: number, maxAllowed: number);
 }
+export declare class ClosePositionValidationError extends Error {
+    constructor(message: string);
+}
 /**
  * Validates that each leg doesn't exceed the maximum number of assets
  * @param longAssets Array of long assets
@@ -59,3 +62,13 @@ export declare function validatePositionSize(usdValue: number, longAssets?: Pair
     error?: string;
     minimumRequired?: number;
 };
+export interface ClosePositionValidationInput {
+    executionType: CloseExecutionType;
+    twapDuration?: number;
+    twapIntervalSeconds?: number;
+    randomizeExecution?: boolean;
+    triggerType?: CloseTriggerType;
+    triggerValue?: string;
+    direction?: OrderDirection;
+}
+export declare function validateClosePositionRequest(payload: ClosePositionValidationInput): void;

package/package.json

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

package/dist/clients/tradeHistory.d.ts

@@ -1,7 +0,0 @@
-import type { ApiResponse, TradeHistoryDataDto } from '../types';
-export interface GetTradeHistoryParams {
-    startDate?: string;
-    endDate?: string;
-    limit?: number;
-}
-export declare function getTradeHistory(baseUrl: string, params?: GetTradeHistoryParams): Promise<ApiResponse<TradeHistoryDataDto[]>>;

package/dist/hooks/usePnlCalendar.d.ts

@@ -1,61 +0,0 @@
-export type PnlCalendarTimeframe = '2W' | '3W' | '2M' | '3M';
-export interface PnlCalendarOptions {
-    timeframe?: PnlCalendarTimeframe;
-    startDate?: Date | string;
-    endDate?: Date | string;
-}
-export interface PnlCalendarAsset {
-    coin: string;
-    symbol: string;
-    assetName: string;
-    marketPrefix: string;
-    percentage: number;
-    collateralToken: string;
-}
-export interface PnlCalendarTrade {
-    tradeHistoryId: string;
-    realizedPnl: number;
-    result: 'profit' | 'loss' | 'breakeven';
-    collateralTypes: string[];
-    closedLongAssets: PnlCalendarAsset[];
-    closedShortAssets: PnlCalendarAsset[];
-}
-export interface PnlCalendarDay {
-    date: string;
-    totalPnl: number;
-    volume: number;
-    positionsClosed: number;
-    result: 'profit' | 'loss' | 'breakeven';
-    trades: PnlCalendarTrade[];
-}
-export interface PeriodSummary {
-    pnl: number;
-    volume: number;
-    winRate: number;
-    wins: number;
-    losses: number;
-    totalProfit: number;
-    totalLoss: number;
-}
-export interface PnlCalendarWeek {
-    weekStart: string;
-    weekEnd: string;
-    days: PnlCalendarDay[];
-    summary: PeriodSummary;
-}
-export interface PnlCalendarMonth {
-    month: string;
-    label: string;
-    days: PnlCalendarDay[];
-    summary: PeriodSummary;
-}
-export interface UsePnlCalendarResult {
-    timeframe: PnlCalendarTimeframe;
-    weeks: PnlCalendarWeek[];
-    months: PnlCalendarMonth[];
-    overall: PeriodSummary;
-    isLoading: boolean;
-    error: string | null;
-    refetch: () => void;
-}
-export declare function usePnlCalendar(options?: PnlCalendarTimeframe | PnlCalendarOptions): UsePnlCalendarResult;

package/dist/hooks/usePnlHeatmap.d.ts

@@ -1,13 +0,0 @@
-import type { PnlCalendarTrade } from './usePnlCalendar';
-export type PnlHeatmapTimeframe = 'allTime' | '100D' | '30D' | '7D';
-export interface PnlHeatmapTrade extends PnlCalendarTrade {
-    percentage: number;
-}
-export interface UsePnlHeatmapResult {
-    timeframe: PnlHeatmapTimeframe;
-    trades: PnlHeatmapTrade[];
-    isLoading: boolean;
-    error: string | null;
-    refetch: () => void;
-}
-export declare function usePnlHeatmap(timeframe?: PnlHeatmapTimeframe): UsePnlHeatmapResult;