@pear-protocol/hyperliquid-sdk 0.0.54 → 0.0.55

package/dist/clients/hyperliquid.d.ts

@@ -1,4 +1,4 @@
-import type { ApiResponse, CandleInterval, CandleData, ExternalFillDto, AllPerpMetasResponse, ExtraAgent } from '../types';
+import type { ApiResponse, CandleInterval, CandleData, ExternalFillDto, AllPerpMetasResponse, ExtraAgent, TwapSliceFillResponseItem } from '../types';
 /**
  * Fetch historical candle data from HyperLiquid API
  */
@@ -7,6 +7,10 @@ export declare const fetchHistoricalCandles: (coin: string, startTime: number, e
  * Retrieve recent user fills from HyperLiquid and map to ExternalFillDto[]
  */
 export declare const fetchUserFillsFromHyperliquid: (user: string, startTime: number, aggregateByTime?: boolean) => Promise<ApiResponse<ExternalFillDto[]>>;
+/**
+ * Retrieve user TWAP slice fills from HyperLiquid and map to ExternalFillDto within items
+ */
+export declare const fetchUserTwapSliceFillsByTime: (user: string, startTime: number, aggregateByTime?: boolean) => Promise<ApiResponse<TwapSliceFillResponseItem[]>>;
 /**
  * Fetch all perp metas from HyperLiquid API
  * Endpoint: https://api.hyperliquid.xyz/info

package/dist/index.d.ts

@@ -13,6 +13,27 @@ interface ApiResponse<T> {
     status: number;
     headers: Record<string, string>;
 }
+interface ExternalLiquidationDto {
+    liquidatedUser: string;
+    markPx: string;
+    method: string;
+}
+interface ExternalFillDto {
+    coin: string;
+    px: string;
+    sz: string;
+    side: 'B' | 'A';
+    time: number;
+    dir: string;
+    fee: string;
+    builderFee?: string;
+    oid?: string | number;
+    tid?: string | number;
+    cloid?: string | null;
+    hash?: string | null;
+    feeToken?: string | null;
+    liquidation?: ExternalLiquidationDto | null;
+}
 interface SyncFillsResponseDto {
     insertedFills: number;
     skippedDuplicates: number;
@@ -21,6 +42,10 @@ interface SyncFillsResponseDto {
     createdPositions: number;
     closedPositions: number;
 }
+interface TwapSliceFillResponseItem {
+    fill: ExternalFillDto;
+    twapId: number;
+}
 /**
  * WebSocket connection states
  */
@@ -1248,4 +1273,4 @@ declare function validatePositionSize(usdValue: number, longAssets?: PairAssetIn
 declare const useMarketData: any;
 
 export { AccountSummaryCalculator, AuthStatus, ConflictDetector, MINIMUM_ASSET_USD_VALUE, MinimumPositionSizeError, PearHyperliquidProvider, TokenMetadataExtractor, adjustOrder, adjustPosition, calculateMinimumPositionValue, calculateWeightedRatio, cancelOrder, cancelTwap, cancelTwapOrder, closeAllPositions, closePosition, computeBasketCandles, createCandleLookups, createPosition, getCompleteTimestamps, getPortfolio, mapCandleIntervalToTradingViewInterval, mapTradingViewIntervalToCandleInterval, markNotificationReadById, markNotificationsRead, toggleWatchlist, updateRiskParameters, useAccountSummary, useActiveBaskets, useAgentWallet, useAllBaskets, useAutoSyncFills, useBasketCandles, useFindBasket, useHighlightedBaskets, useHistoricalPriceData, useHistoricalPriceDataStore, useHyperliquidNativeWebSocket, useHyperliquidWebSocket, useMarketData, useMarketDataAllPayload, useMarketDataPayload, useNotifications, useOpenOrders, useOrders, usePearAuth, usePearHyperliquid, usePerformanceOverlays, usePortfolio, usePosition, useTokenSelectionMetadata, useTopGainers, useTopLosers, useTradeHistories, useTwap, useUserSelection, useWatchlist, useWatchlistBaskets, useWebData, validateMinimumAssetSize, validatePositionSize };
-export type { AccountSummaryResponseDto, ActiveAssetGroupItem, ActiveAssetsResponse, AdjustExecutionType, AdjustOrderRequestInput, AdjustOrderResponseDto, AdjustPositionRequestInput, AdjustPositionResponseDto, AgentWalletDto, AgentWalletState, ApiErrorResponse, ApiResponse, AssetCtx, AssetInformationDetail, AssetMarketData, AssetPosition, AutoSyncFillsOptions, AutoSyncFillsState, BalanceSummaryDto, CancelOrderResponseDto, CancelTwapResponseDto, CandleChartData, CandleData, CandleInterval, CandleSnapshotRequest, ClearinghouseState, CloseAllPositionsResponseDto, CloseAllPositionsResultDto, CloseExecutionType, ClosePositionRequestInput, ClosePositionResponseDto, CreatePositionRequestInput, CreatePositionResponseDto, CrossMarginSummaryDto, CumFundingDto, ExecutionType, ExtraAgent, HLWebSocketResponse, HistoricalRange, LadderConfigInput, MarginSummaryDto, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetDto, PairAssetInput, PerformanceOverlay, PlatformAccountSummaryResponseDto, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, ToggleWatchlistResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, UniverseAsset, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };
+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, ExtraAgent, HLWebSocketResponse, HistoricalRange, LadderConfigInput, MarginSummaryDto, NotificationCategory, NotificationDto, OpenLimitOrderDto, OpenPositionDto, OrderAssetDto, OrderStatus, PairAssetDto, PairAssetInput, PerformanceOverlay, PlatformAccountSummaryResponseDto, PortfolioBucketDto, PortfolioInterval, PortfolioIntervalsDto, PortfolioOverallDto, PortfolioResponseDto, PositionAdjustmentType, PositionAssetDetailDto, PositionAssetSummaryDto, PositionResponseStatus, RealtimeBar, RealtimeBarsCallback, ToggleWatchlistResponseDto, TokenConflict, TokenHistoricalPriceData, TokenMetadata, TokenSelection, TpSlThresholdInput, TpSlThresholdType, TradeHistoryAssetDataDto, TradeHistoryDataDto, TwapChunkStatusDto, TwapMonitoringDto, TwapSliceFillResponseItem, UniverseAsset, UpdateRiskParametersRequestInput, UpdateRiskParametersResponseDto, UseAuthOptions, UseBasketCandlesReturn, UseHistoricalPriceDataReturn, UseNotificationsResult, UsePerformanceOverlaysReturn, UsePortfolioResult, UseTokenSelectionMetadataReturn, UserProfile, UserSelectionState, WatchlistItemDto, WebSocketAckResponse, WebSocketChannel, WebSocketConnectionState, WebSocketDataMessage, WebSocketMessage, WebSocketSubscribeMessage, WsAllMidsData };

package/dist/index.js

@@ -5341,6 +5341,21 @@ const fetchUserFillsFromHyperliquid = async (user, startTime, aggregateByTime =
         throw toApiError(error);
     }
 };
+/**
+ * Retrieve user TWAP slice fills from HyperLiquid and map to ExternalFillDto within items
+ */
+const fetchUserTwapSliceFillsByTime = async (user, startTime, aggregateByTime = true) => {
+    const request = { type: 'userTwapSliceFillsByTime', user, startTime, aggregateByTime };
+    try {
+        const response = await axios$1.post('https://api.hyperliquid.xyz/info', request, {
+            headers: { 'Content-Type': 'application/json' },
+        });
+        return { data: response.data, status: response.status, headers: response.headers };
+    }
+    catch (error) {
+        throw toApiError(error);
+    }
+};
 /**
  * Fetch all perp metas from HyperLiquid API
  * Endpoint: https://api.hyperliquid.xyz/info
@@ -6010,7 +6025,7 @@ const syncFills = async (baseUrl, accessToken, payload) => {
  * Convenience: fetch user fills from HyperLiquid, then sync them to Pear backend
  */
 const syncUserFillsFromHyperliquid = async (baseUrl, accessToken, user, aggregateByTime = true, lastSyncAt = null, assetPositions) => {
-    const firstStartTime = lastSyncAt ? Number(lastSyncAt) : 1735660800000;
+    const firstStartTime = lastSyncAt ? Number(lastSyncAt) : 0;
     const allFills = [];
     const seenTids = new Set();
     let startTime = firstStartTime;
@@ -6032,7 +6047,28 @@ const syncUserFillsFromHyperliquid = async (baseUrl, accessToken, user, aggregat
             startTime = last.time;
         }
     } while (batchSize === 2000);
-    return syncFills(baseUrl, accessToken, { user, fills: allFills, assetPositions });
+    startTime = firstStartTime;
+    batchSize = 0;
+    do {
+        const { data: twapBatch } = await fetchUserTwapSliceFillsByTime(user, startTime, aggregateByTime);
+        batchSize = twapBatch.length;
+        for (const item of twapBatch) {
+            const fill = item.fill;
+            const tid = fill.tid;
+            if (tid === undefined)
+                continue;
+            if (!seenTids.has(tid)) {
+                seenTids.add(tid);
+                allFills.push(fill);
+            }
+        }
+        if (batchSize === 2000) {
+            const last = twapBatch[twapBatch.length - 1];
+            startTime = last.fill.time;
+        }
+    } while (batchSize === 2000);
+    const sortedFills = [...allFills].sort((a, b) => Number(a.time) - Number(b.time));
+    return syncFills(baseUrl, accessToken, { user, fills: sortedFills, assetPositions });
 };
 
 /**

package/dist/types.d.ts

@@ -45,6 +45,10 @@ export interface SyncFillsResponseDto {
     createdPositions: number;
     closedPositions: number;
 }
+export interface TwapSliceFillResponseItem {
+    fill: ExternalFillDto;
+    twapId: number;
+}
 /**
  * WebSocket connection states
  */

package/package.json

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