@pear-protocol/hyperliquid-sdk 0.1.20 → 0.1.21

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/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>>;
@@ -1673,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
@@ -1707,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
@@ -1772,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, usePortfolio, usePosition, useSpotOrder, useTokenSelectionMetadata, useTradeHistories, useTwap, useUserSelection, useWatchlist, validateMaxAssetsPerLeg, validateMinimumAssetSize, validatePositionSize };
-export type { AccountSummaryResponseDto, ActiveAssetData, ActiveAssetGroupItem, ActiveAssetsAllResponse, ActiveAssetsResponse, AddressState, AdjustAdvanceAssetInput, AdjustAdvanceItemInput, AdjustAdvanceResponseDto, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, AgentWalletStatus, AllDexsAssetCtxsData, AllDexsClearinghouseStateData, AllPerpMetasItem, AllPerpMetasResponse, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, AuthenticateRequest, AuthenticateResponse, AvailableToTrades, BalanceSummaryDto, BaseTriggerOrderNotificationParams, BtcDomTriggerParams, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ChunkFillDto, ClearinghouseState, CloseAllPositionsResponseDto, CloseAllPositionsResultDto, CloseExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CollateralToken, CreateAgentWalletResponseDto, CreatePositionRequestInput, CreatePositionResponseDto, CrossAssetPriceTriggerParams, CrossMarginSummaryDto, CumFundingDto, EIP712AuthDetails, ExecutionType, ExternalFillDto, ExternalLiquidationDto, ExtraAgent, GetAgentWalletResponseDto, GetEIP712MessageResponse, GetKalshiMarketsParams, HLChannel, HLChannelDataMap, HLWebSocketResponse, HistoricalRange, KalshiMarket, KalshiMarketsResponse, KalshiMveLeg, KalshiPriceRange, LadderConfigInput, LadderOrderParameters, LeverageInfo, LogoutRequest, LogoutResponse, MarginRequiredPerCollateral, MarginRequiredResult, MarginSummaryDto, MarginTableDef, MarginTablesEntry, MarginTier, MarketOrderParameters, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderDirection, OrderParameters, OrderStatus, OrderType, PairAssetDto, PairAssetInput, PerformanceOverlay, PerpDex, PerpDexsResponse, PerpMetaAsset, PlatformAccountSummaryResponseDto, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PredictionMarketOutcomeTriggerParams, PriceRatioTriggerParams, PriceTriggerParams, PrivyAuthDetails, RawAssetDto, RawPositionDto, RealtimeBar, RealtimeBarsCallback, 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 };
+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: [
@@ -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",
             },
@@ -8773,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, 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",
+  "version": "0.1.21",
   "description": "React SDK for Pear Protocol Hyperliquid API integration",
   "type": "module",
   "main": "dist/index.js",
@@ -28,8 +28,8 @@
     "zustand": "^5.0.9"
   },
   "peerDependencies": {
-    "react": "^18.0.0",
-    "react-dom": "^18.0.0"
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
   },
   "devDependencies": {
     "@rollup/plugin-commonjs": "^25.0.0",