@agg-build/hooks 4.24.0 → 4.26.1

package/dist/index.d.mts

@@ -2,7 +2,7 @@ import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
 export { QueryClient, QueryClientProvider, useQueryClient } from '@tanstack/react-query';
 import * as _agg_build_sdk from '@agg-build/sdk';
-import { CandleBuilder, AggAuthStartBody, AggAuthStartResult, AggClientSessionInput, AggClient, RampQuote, RampQuoteRequest, RampWidgetSession, RampSessionRequest, ExecuteManagedResponse, ExecuteManagedParams, PlaceLimitOrderResponse, PlaceLimitOrderParams, CancelManagedExecutionResponse, GetPositionsParams, ExecutionStatusStep, WsOrderSubmitted, WsBalanceUpdate, ExecutionStatusOrder, CreateBalanceRefillPolicyParams, UpdateBalanceRefillPolicyParams, RedeemResponse, RedeemRequest, WsRedeemEvent, AggWebSocket, WsOrderEvent, WsWithdrawalLifecycleEvent, ChartBarsMeta, WsCandleInterval, WsTrade, AggregatedOrderbookResponse, Venue as Venue$1, VenueKeyStatus, AggLinkAccountBody, AggLinkAccountResult, AggLinkAccountWalletConfirmBody, AggLinkAccountConfirmResult, Category, UserActivityQuery, UserActivityItem, PaginatedResponse, LeaderboardMetric, LeaderboardRow, CandleInterval, OrderbookState, OrderbookQuoteResponse, OrderListQuery, TradeExecutorOrder, SmartRouteSide, ExecutionMode, SmartRouteResponse, RecurringCryptoDuration, RecurringCryptoVenueMarket, RecurringCryptoWindowMarket, RecurrenceFilter, SportsLiveResponse, SportsLiveState, MidpointRow, BatchMidpointsResponse, AppClientConfigResponse, AppTradingMode, VenueMarket as VenueMarket$1, HostedVenueWithdrawalRequest } from '@agg-build/sdk';
+import { CandleBuilder, AggAuthStartBody, AggAuthStartResult, AggClientSessionInput, AggClient, RampQuote, RampQuoteRequest, RampWidgetSession, RampSessionRequest, ExecuteManagedResponse, ExecuteManagedParams, PlaceLimitOrderResponse, PlaceLimitOrderParams, CancelManagedExecutionResponse, GetPositionsParams, ExecutionStatusStep, WsOrderSubmitted, WsBalanceUpdate, ExecutionStatusOrder, CreateBalanceRefillPolicyParams, UpdateBalanceRefillPolicyParams, RedeemResponse, RedeemRequest, WsRedeemEvent, AggWebSocket, WsOrderEvent, WsWithdrawalLifecycleEvent, ChartBarsMeta, WsCandleInterval, WsTrade, AggregatedOrderbookResponse, Venue as Venue$1, VenueKeyStatus, AggLinkAccountBody, AggLinkAccountResult, AggLinkAccountWalletConfirmBody, AggLinkAccountConfirmResult, Category, UserActivityQuery, UserActivityItem, PaginatedResponse, LeaderboardMetric, LeaderboardRow, CandleInterval, OrderbookState, OrderbookQuoteResponse, OrderListQuery, TradeExecutorOrder, SmartRouteSide, ExecutionMode, SmartRouteResponse, BatchOrderbooksResponse, RecurringCryptoDuration, RecurringCryptoVenueMarket, RecurringCryptoWindowMarket, RecurrenceFilter, SportsLiveResponse, SportsLiveState, MidpointRow, BatchMidpointsResponse, AppClientConfigResponse, AppTradingMode, VenueMarket as VenueMarket$1, HostedVenueWithdrawalRequest } from '@agg-build/sdk';
 export { SportsGameStatus, SportsLiveParticipant, SportsLiveResponse, SportsLiveState, TurnstileChallengeError } from '@agg-build/sdk';
 import React, { ReactNode } from 'react';
 export { UseManagedBalancesOptions, UseWithdrawEstimateParams, UseWithdrawFlowOptions, UseWithdrawFlowResult, UseWithdrawManagedOptions, UseWithdrawPreviewParams, UseWithdrawalLifecycleResult, WithdrawFeeEstimate, WithdrawalLifecycleState, useManagedBalances, useWithdrawEstimate, useWithdrawFlow, useWithdrawManaged, useWithdrawPreview, useWithdrawalLifecycle } from './withdraw.mjs';
@@ -219,6 +219,12 @@ type GetPositionsQuery = {
     cursor?: string | undefined;
     limit?: number | undefined;
     status?: "active" | "closed" | undefined;
+    venueEventId?: string | undefined;
+    venueMarketId?: string | undefined;
+    /** Only positions on events in any of these categories (a league is a category). At most 20. */
+    categoryIds?: string[] | undefined;
+    /** `realizedPnl`: highest realized P&L first. Live positions only. */
+    sort?: "realizedPnl" | undefined;
 };
 type OrderListItem = {
     status: string;
@@ -370,6 +376,8 @@ type PositionGroup = {
             currentPrice: number;
             totalValue: number;
             unrealizedPnlPercent: number;
+            /** Realized P&L across the legs (sells + settlement), before fees. USD. */
+            realizedPnl: number;
             priceSource: PriceSource;
             bookQuality: BookQuality;
         }[];
@@ -5701,6 +5709,8 @@ declare function useSmartRoute(options: UseSmartRouteOptions): UseSmartRouteResu
 interface LimitOrderVenueQuoteRequest {
     venue: Venue$1;
     venueMarketOutcomeId: string;
+    /** The venue's own market; its tick and size rules are fetched with the selected market's. */
+    venueMarketId?: string;
 }
 interface UseLimitOrderVenueQuotesOptions {
     requests: LimitOrderVenueQuoteRequest[];
@@ -5719,6 +5729,10 @@ interface LimitOrderVenueQuoteResult {
     request: LimitOrderVenueQuoteRequest;
     data: SmartRouteResponse | null;
     tickSize?: number | null;
+    /** Limit size step, raw 6-dec shares, from orderbook metadata. Null = 1-raw step. */
+    sizeStepRaw?: string | null;
+    /** Limit size minimum, raw 6-dec shares, from orderbook metadata. Null = none known. */
+    minSizeRaw?: string | null;
     isLoading: boolean;
     isFetching: boolean;
     error: Error | null;
@@ -5726,11 +5740,19 @@ interface LimitOrderVenueQuoteResult {
 }
 interface UseLimitOrderVenueQuotesResult {
     quotes: LimitOrderVenueQuoteResult[];
+    /** The market's orderbook metadata (ticks, size rules) has not loaded yet. */
+    isMetadataPending: boolean;
     isLoading: boolean;
     isFetching: boolean;
     error: Error | null;
     refetch: () => Promise<unknown>;
 }
+interface LimitOrderSizeRules {
+    sizeStepRaw?: string;
+    minSizeRaw?: string;
+}
+/** Per-venue limit size rules from the same batch orderbook metadata as ticks. */
+declare const resolveLimitOrderSizeRulesByVenue: (response: BatchOrderbooksResponse | null | undefined) => Map<Venue$1, LimitOrderSizeRules>;
 /**
  * Fetches informational single-venue quotes for limit-order routing cards.
  * Quote IDs are intentionally not consumed by the limit-order execution flow.
@@ -7763,7 +7785,8 @@ override?: AppTradingMode): UseResolvedExecutionModeResult;
 
 interface UseSettlementDetailsDataOptions {
     eventId: string;
-    market: Pick<VenueMarket$1, "id" | "venue" | "externalIdentifier">;
+    /** Omit when only the event's details (description, settlementDiff) are needed. */
+    market?: Pick<VenueMarket$1, "id" | "venue" | "externalIdentifier">;
     enabled: boolean;
     needsEvent: boolean;
     needsMarket: boolean;
@@ -8270,4 +8293,4 @@ declare function useHostedVenueTransfers(accountId: string, environment: Environ
     clear: () => void;
 };
 
-export { AUTH_CHOOSER_OPEN_EVENT, type AggAuthContextValue, type AggAuthSignInOptions, type AggBalanceContextValue, AggBalanceProvider, AggProvider, type AggProviderProps, AggProvider as AggSdkProvider, type AggProviderProps as AggSdkProviderProps, type AggUiConfig, type AggUiConfigInput, type AggUiLabels, type AggUiLabelsInput, AggUiProvider, type AggUiTradingExecutionMode, CHART_TIME_RANGES, CONFIRMED_MATCH_STATUSES, type ChartTimeRange, type ClosedPositionTotals, type ComputePriceGapsOptions, DEFAULT_AGG_ROOT_CLASS_NAME, type DagStepProgress, type EventListStateContextValue, EventListStateProvider, type EventListStateSnapshot, type EventTradingContextValue, type EventTradingState, type ExecutionProgressPhase, type ExecutionRawStepProgress, type ExecutionStepProgress, type ExecutionTerminalOrderEvent, type GeoBlockState, type GetOrdersQuery, type GetPositionsQuery, type InvalidateUserActivityOptions, type InvalidateUserMoneyStateOptions, LEADERBOARD_PERIODS, type LeaderboardPeriod, type LimitOrderVenueQuoteRequest, type LimitOrderVenueQuoteResult, type LiveBestPriceCandidate, type LiveBestPriceCandidates, type LiveBestPrices, type LiveCandle, MAX_ORDER_VENUE_MARKET_IDS_PER_REQUEST, MAX_PRICE_GAP_PCT, MIN_PRICE_GAP_PCT, type MarketChartAvailability, type MarketChartCandle, type MarketChartData, type MarketChartVenueData, type MarketOrderbookData, type MarketOrderbookIntegrity, MarketStatus, type MarketTradingState, MatchStatus, MatchType, type OrderEligibility, type OrderEligibilityReason, type OrderListItem, type OrderbookResult, type PositionGroup, type PriceGapValue, type RecurringCryptoIdentity, type RecurringCryptoMarketInstance, type RecurringCryptoTimeline, type RedeemEvent, type RedeemLegLifecycle, type RedeemLifecycleState, RedeemRejectedError, type RollingChartWindow, SPORTS_LIVE_POLL_INTERVAL_MS, SPORTS_SCHEDULED_POLL_INTERVAL_MS, type ScaledCandlePoint, type SdkUiConfig, type SdkUiConfigInput, type SdkUiProviderProps, type SettlementDiff, type SettlementDifference, type SmartRouteLoadingReason, type ThemeMode, TradeSide, type TradingAction, type TradingState, type TradingStateBase, type TradingStateKind, type UseAggAuthOptions, type UseAggAuthReturn, type UseAppConfigResult, type UseArbFeedResult, type UseCancelManagedOrderOptions, type UseCategoriesOptions, type UseCategoryChildrenOptions, type UseEnrichedVenueEventOptions, type UseExecuteManagedOptions, type UseExecutionOrdersForMarketsOptions, type UseExecutionOrdersForMarketsResult, type UseExecutionOrdersOptions, type UseExecutionPositionsOptions, type UseExecutionProgressOptions, type UseExecutionProgressResult, type UseExternalIdOptions, type UseExternalIdReturn, type UseLeaderboardOptions, type UseLimitOrderVenueQuotesOptions, type UseLimitOrderVenueQuotesResult, type UseLinkAccountReturn, type UseLiveCandleOverlayOptions, type UseLiveCandleOverlayResult, type UseLiveCandlesOptions, type UseLiveCandlesResult, type UseLiveMarketResult, type UseMarketArbResult, type UseMarketChartOptions, type UseMarketChartResult, type UseMarketChartsResult, type UseMarketOrderbookOptions, type UseMarketOrderbookResult, type UseMarketOrderbookVenueOutcome, type UseMarketSearchOptions, type UseMidpointsOptions, type UseMidpointsResult, type UseOrderBookOptions, type UseOrderbookQuoteOptions, type UseOrderbookQuoteResult, type UseOrdersOptions, type UsePaperOnboardingResult, type UsePlaceLimitOrderOptions, type UsePositionsOptions, type UseRecurringCryptoMarketsOptions, type UseRedeemLifecycleInput, type UseResolvedExecutionModeResult, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSettlementDetailsDataOptions, type UseSmartRouteOptions, type UseSmartRouteResult, type UseUserActivityOptions, type UseUserHoldingsOptions, type UseVenueEventOptions, type UseVenueEventsOptions, type UseVenueMarketMidpointsOptions, type UseVenueMarketsOptions, type UseVenueSellQuotesOptions, type UseVenueSellQuotesResult, type UseViewportMidpointsOptions, type UseVisibleIdsOptions, type UseVisibleIdsResult, type UserActivityInvalidationStrategy, Venue, type VenueAvailabilityState, type VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type VenueSellQuoteRequest, type VenueSellQuoteResult, type WalletActionSendTokenParams, type WalletActions, appConfigQueryKey, buildLiveBestPriceCandidates, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, extractOutcomeBestCandidate, fetchRecurringCryptoMarkets, findLivePriceById, getBuilder, getOrCreateBuilder, getVenueAvailabilityState, getVisibleVenueIdsByConfig, getVisibleVenuesByConfig, getWalletAddressFromUserProfile, hostedVenueAccountQueryKeys, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserClaimState, invalidateUserMoneyState, isVenueDisabledByConfig, leaderboardQueryKeys, leaderboardRange, mergeBestPricesPreferringLive, mergeRecurringCryptoWindows, normalizeVenueId, optimizedImageUrl, parseEmail, parseEmailStrict, rangeToSeconds, recurringCryptoTransitionPollInterval, requestAggAuthChooserOpen, resolveAggUiLabels, resolveDefaultMarket as resolveDefaultTradingMarket, resolveEventTradingState, resolveMarketTradingState, resolveMarketWinningOutcome, resolveOrderEligibility, resolveRecurringCryptoIdentity, resolveRecurringCryptoTimeline, resolveRollingWindow, resolveTradingStateKind, retinaImageUrl, sharedKycQueryKeys, sortVenues, sportsLiveQueryKey, sportsLiveRefetchInterval, timeRangeToInterval, tradingReducer, useAggAuth, useAggAuthContext, useAggAuthState, useAggBalance, useAggBalanceContext, useAggBalanceState, useAggClient, useAggLabels, useAggUiConfig, useAggWebSocket, useAppConfig, useArbFeed, useBalanceRefillPolicies, useCachedAppConfig, useCancelManagedOrder, useCategories, useCategoryChildren, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionOrdersForMarkets, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useHostedVenueAccount, useHostedVenueActivity, useHostedVenueTransfers, useLabels, useLeaderboard, useLimitOrderVenueQuotes, useLinkAccount, useLiveBestPriceCandidates, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, useMarketArb, useMarketChart, useMarketCharts, useMarketOrderbook, useMarketSearch, useMidpoints, useOnBalanceUpdate, useOnOrderEvent, useOnOrderSubmitted, useOnRedeemEvent, useOnWithdrawalLifecycle, useOptionalAggClient, useOrderBook, useOrderbookQuote, useOrders, usePaperOnboarding, usePlaceLimitOrder, usePositions, useRampQuotes, useRampSession, useRecurringCryptoMarkets, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useResolvedExecutionMode, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSettlementDetailsData, useSharedKyc, useSmartRoute, useSportsLive, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueKeyStatus, useVenueMarketMidpoints, useVenueMarkets, useVenueSellQuotes, useViewportMidpoints, useVisibleIds, userActivityQueryKeys, venueKeyQueryKeys };
+export { AUTH_CHOOSER_OPEN_EVENT, type AggAuthContextValue, type AggAuthSignInOptions, type AggBalanceContextValue, AggBalanceProvider, AggProvider, type AggProviderProps, AggProvider as AggSdkProvider, type AggProviderProps as AggSdkProviderProps, type AggUiConfig, type AggUiConfigInput, type AggUiLabels, type AggUiLabelsInput, AggUiProvider, type AggUiTradingExecutionMode, CHART_TIME_RANGES, CONFIRMED_MATCH_STATUSES, type ChartTimeRange, type ClosedPositionTotals, type ComputePriceGapsOptions, DEFAULT_AGG_ROOT_CLASS_NAME, type DagStepProgress, type EventListStateContextValue, EventListStateProvider, type EventListStateSnapshot, type EventTradingContextValue, type EventTradingState, type ExecutionProgressPhase, type ExecutionRawStepProgress, type ExecutionStepProgress, type ExecutionTerminalOrderEvent, type GeoBlockState, type GetOrdersQuery, type GetPositionsQuery, type InvalidateUserActivityOptions, type InvalidateUserMoneyStateOptions, LEADERBOARD_PERIODS, type LeaderboardPeriod, type LimitOrderSizeRules, type LimitOrderVenueQuoteRequest, type LimitOrderVenueQuoteResult, type LiveBestPriceCandidate, type LiveBestPriceCandidates, type LiveBestPrices, type LiveCandle, MAX_ORDER_VENUE_MARKET_IDS_PER_REQUEST, MAX_PRICE_GAP_PCT, MIN_PRICE_GAP_PCT, type MarketChartAvailability, type MarketChartCandle, type MarketChartData, type MarketChartVenueData, type MarketOrderbookData, type MarketOrderbookIntegrity, MarketStatus, type MarketTradingState, MatchStatus, MatchType, type OrderEligibility, type OrderEligibilityReason, type OrderListItem, type OrderbookResult, type PositionGroup, type PriceGapValue, type RecurringCryptoIdentity, type RecurringCryptoMarketInstance, type RecurringCryptoTimeline, type RedeemEvent, type RedeemLegLifecycle, type RedeemLifecycleState, RedeemRejectedError, type RollingChartWindow, SPORTS_LIVE_POLL_INTERVAL_MS, SPORTS_SCHEDULED_POLL_INTERVAL_MS, type ScaledCandlePoint, type SdkUiConfig, type SdkUiConfigInput, type SdkUiProviderProps, type SettlementDiff, type SettlementDifference, type SmartRouteLoadingReason, type ThemeMode, TradeSide, type TradingAction, type TradingState, type TradingStateBase, type TradingStateKind, type UseAggAuthOptions, type UseAggAuthReturn, type UseAppConfigResult, type UseArbFeedResult, type UseCancelManagedOrderOptions, type UseCategoriesOptions, type UseCategoryChildrenOptions, type UseEnrichedVenueEventOptions, type UseExecuteManagedOptions, type UseExecutionOrdersForMarketsOptions, type UseExecutionOrdersForMarketsResult, type UseExecutionOrdersOptions, type UseExecutionPositionsOptions, type UseExecutionProgressOptions, type UseExecutionProgressResult, type UseExternalIdOptions, type UseExternalIdReturn, type UseLeaderboardOptions, type UseLimitOrderVenueQuotesOptions, type UseLimitOrderVenueQuotesResult, type UseLinkAccountReturn, type UseLiveCandleOverlayOptions, type UseLiveCandleOverlayResult, type UseLiveCandlesOptions, type UseLiveCandlesResult, type UseLiveMarketResult, type UseMarketArbResult, type UseMarketChartOptions, type UseMarketChartResult, type UseMarketChartsResult, type UseMarketOrderbookOptions, type UseMarketOrderbookResult, type UseMarketOrderbookVenueOutcome, type UseMarketSearchOptions, type UseMidpointsOptions, type UseMidpointsResult, type UseOrderBookOptions, type UseOrderbookQuoteOptions, type UseOrderbookQuoteResult, type UseOrdersOptions, type UsePaperOnboardingResult, type UsePlaceLimitOrderOptions, type UsePositionsOptions, type UseRecurringCryptoMarketsOptions, type UseRedeemLifecycleInput, type UseResolvedExecutionModeResult, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSettlementDetailsDataOptions, type UseSmartRouteOptions, type UseSmartRouteResult, type UseUserActivityOptions, type UseUserHoldingsOptions, type UseVenueEventOptions, type UseVenueEventsOptions, type UseVenueMarketMidpointsOptions, type UseVenueMarketsOptions, type UseVenueSellQuotesOptions, type UseVenueSellQuotesResult, type UseViewportMidpointsOptions, type UseVisibleIdsOptions, type UseVisibleIdsResult, type UserActivityInvalidationStrategy, Venue, type VenueAvailabilityState, type VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type VenueSellQuoteRequest, type VenueSellQuoteResult, type WalletActionSendTokenParams, type WalletActions, appConfigQueryKey, buildLiveBestPriceCandidates, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, extractOutcomeBestCandidate, fetchRecurringCryptoMarkets, findLivePriceById, getBuilder, getOrCreateBuilder, getVenueAvailabilityState, getVisibleVenueIdsByConfig, getVisibleVenuesByConfig, getWalletAddressFromUserProfile, hostedVenueAccountQueryKeys, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserClaimState, invalidateUserMoneyState, isVenueDisabledByConfig, leaderboardQueryKeys, leaderboardRange, mergeBestPricesPreferringLive, mergeRecurringCryptoWindows, normalizeVenueId, optimizedImageUrl, parseEmail, parseEmailStrict, rangeToSeconds, recurringCryptoTransitionPollInterval, requestAggAuthChooserOpen, resolveAggUiLabels, resolveDefaultMarket as resolveDefaultTradingMarket, resolveEventTradingState, resolveLimitOrderSizeRulesByVenue, resolveMarketTradingState, resolveMarketWinningOutcome, resolveOrderEligibility, resolveRecurringCryptoIdentity, resolveRecurringCryptoTimeline, resolveRollingWindow, resolveTradingStateKind, retinaImageUrl, sharedKycQueryKeys, sortVenues, sportsLiveQueryKey, sportsLiveRefetchInterval, timeRangeToInterval, tradingReducer, useAggAuth, useAggAuthContext, useAggAuthState, useAggBalance, useAggBalanceContext, useAggBalanceState, useAggClient, useAggLabels, useAggUiConfig, useAggWebSocket, useAppConfig, useArbFeed, useBalanceRefillPolicies, useCachedAppConfig, useCancelManagedOrder, useCategories, useCategoryChildren, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionOrdersForMarkets, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useHostedVenueAccount, useHostedVenueActivity, useHostedVenueTransfers, useLabels, useLeaderboard, useLimitOrderVenueQuotes, useLinkAccount, useLiveBestPriceCandidates, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, useMarketArb, useMarketChart, useMarketCharts, useMarketOrderbook, useMarketSearch, useMidpoints, useOnBalanceUpdate, useOnOrderEvent, useOnOrderSubmitted, useOnRedeemEvent, useOnWithdrawalLifecycle, useOptionalAggClient, useOrderBook, useOrderbookQuote, useOrders, usePaperOnboarding, usePlaceLimitOrder, usePositions, useRampQuotes, useRampSession, useRecurringCryptoMarkets, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useResolvedExecutionMode, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSettlementDetailsData, useSharedKyc, useSmartRoute, useSportsLive, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueKeyStatus, useVenueMarketMidpoints, useVenueMarkets, useVenueSellQuotes, useViewportMidpoints, useVisibleIds, userActivityQueryKeys, venueKeyQueryKeys };

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
 export { QueryClient, QueryClientProvider, useQueryClient } from '@tanstack/react-query';
 import * as _agg_build_sdk from '@agg-build/sdk';
-import { CandleBuilder, AggAuthStartBody, AggAuthStartResult, AggClientSessionInput, AggClient, RampQuote, RampQuoteRequest, RampWidgetSession, RampSessionRequest, ExecuteManagedResponse, ExecuteManagedParams, PlaceLimitOrderResponse, PlaceLimitOrderParams, CancelManagedExecutionResponse, GetPositionsParams, ExecutionStatusStep, WsOrderSubmitted, WsBalanceUpdate, ExecutionStatusOrder, CreateBalanceRefillPolicyParams, UpdateBalanceRefillPolicyParams, RedeemResponse, RedeemRequest, WsRedeemEvent, AggWebSocket, WsOrderEvent, WsWithdrawalLifecycleEvent, ChartBarsMeta, WsCandleInterval, WsTrade, AggregatedOrderbookResponse, Venue as Venue$1, VenueKeyStatus, AggLinkAccountBody, AggLinkAccountResult, AggLinkAccountWalletConfirmBody, AggLinkAccountConfirmResult, Category, UserActivityQuery, UserActivityItem, PaginatedResponse, LeaderboardMetric, LeaderboardRow, CandleInterval, OrderbookState, OrderbookQuoteResponse, OrderListQuery, TradeExecutorOrder, SmartRouteSide, ExecutionMode, SmartRouteResponse, RecurringCryptoDuration, RecurringCryptoVenueMarket, RecurringCryptoWindowMarket, RecurrenceFilter, SportsLiveResponse, SportsLiveState, MidpointRow, BatchMidpointsResponse, AppClientConfigResponse, AppTradingMode, VenueMarket as VenueMarket$1, HostedVenueWithdrawalRequest } from '@agg-build/sdk';
+import { CandleBuilder, AggAuthStartBody, AggAuthStartResult, AggClientSessionInput, AggClient, RampQuote, RampQuoteRequest, RampWidgetSession, RampSessionRequest, ExecuteManagedResponse, ExecuteManagedParams, PlaceLimitOrderResponse, PlaceLimitOrderParams, CancelManagedExecutionResponse, GetPositionsParams, ExecutionStatusStep, WsOrderSubmitted, WsBalanceUpdate, ExecutionStatusOrder, CreateBalanceRefillPolicyParams, UpdateBalanceRefillPolicyParams, RedeemResponse, RedeemRequest, WsRedeemEvent, AggWebSocket, WsOrderEvent, WsWithdrawalLifecycleEvent, ChartBarsMeta, WsCandleInterval, WsTrade, AggregatedOrderbookResponse, Venue as Venue$1, VenueKeyStatus, AggLinkAccountBody, AggLinkAccountResult, AggLinkAccountWalletConfirmBody, AggLinkAccountConfirmResult, Category, UserActivityQuery, UserActivityItem, PaginatedResponse, LeaderboardMetric, LeaderboardRow, CandleInterval, OrderbookState, OrderbookQuoteResponse, OrderListQuery, TradeExecutorOrder, SmartRouteSide, ExecutionMode, SmartRouteResponse, BatchOrderbooksResponse, RecurringCryptoDuration, RecurringCryptoVenueMarket, RecurringCryptoWindowMarket, RecurrenceFilter, SportsLiveResponse, SportsLiveState, MidpointRow, BatchMidpointsResponse, AppClientConfigResponse, AppTradingMode, VenueMarket as VenueMarket$1, HostedVenueWithdrawalRequest } from '@agg-build/sdk';
 export { SportsGameStatus, SportsLiveParticipant, SportsLiveResponse, SportsLiveState, TurnstileChallengeError } from '@agg-build/sdk';
 import React, { ReactNode } from 'react';
 export { UseManagedBalancesOptions, UseWithdrawEstimateParams, UseWithdrawFlowOptions, UseWithdrawFlowResult, UseWithdrawManagedOptions, UseWithdrawPreviewParams, UseWithdrawalLifecycleResult, WithdrawFeeEstimate, WithdrawalLifecycleState, useManagedBalances, useWithdrawEstimate, useWithdrawFlow, useWithdrawManaged, useWithdrawPreview, useWithdrawalLifecycle } from './withdraw.js';
@@ -219,6 +219,12 @@ type GetPositionsQuery = {
     cursor?: string | undefined;
     limit?: number | undefined;
     status?: "active" | "closed" | undefined;
+    venueEventId?: string | undefined;
+    venueMarketId?: string | undefined;
+    /** Only positions on events in any of these categories (a league is a category). At most 20. */
+    categoryIds?: string[] | undefined;
+    /** `realizedPnl`: highest realized P&L first. Live positions only. */
+    sort?: "realizedPnl" | undefined;
 };
 type OrderListItem = {
     status: string;
@@ -370,6 +376,8 @@ type PositionGroup = {
             currentPrice: number;
             totalValue: number;
             unrealizedPnlPercent: number;
+            /** Realized P&L across the legs (sells + settlement), before fees. USD. */
+            realizedPnl: number;
             priceSource: PriceSource;
             bookQuality: BookQuality;
         }[];
@@ -5701,6 +5709,8 @@ declare function useSmartRoute(options: UseSmartRouteOptions): UseSmartRouteResu
 interface LimitOrderVenueQuoteRequest {
     venue: Venue$1;
     venueMarketOutcomeId: string;
+    /** The venue's own market; its tick and size rules are fetched with the selected market's. */
+    venueMarketId?: string;
 }
 interface UseLimitOrderVenueQuotesOptions {
     requests: LimitOrderVenueQuoteRequest[];
@@ -5719,6 +5729,10 @@ interface LimitOrderVenueQuoteResult {
     request: LimitOrderVenueQuoteRequest;
     data: SmartRouteResponse | null;
     tickSize?: number | null;
+    /** Limit size step, raw 6-dec shares, from orderbook metadata. Null = 1-raw step. */
+    sizeStepRaw?: string | null;
+    /** Limit size minimum, raw 6-dec shares, from orderbook metadata. Null = none known. */
+    minSizeRaw?: string | null;
     isLoading: boolean;
     isFetching: boolean;
     error: Error | null;
@@ -5726,11 +5740,19 @@ interface LimitOrderVenueQuoteResult {
 }
 interface UseLimitOrderVenueQuotesResult {
     quotes: LimitOrderVenueQuoteResult[];
+    /** The market's orderbook metadata (ticks, size rules) has not loaded yet. */
+    isMetadataPending: boolean;
     isLoading: boolean;
     isFetching: boolean;
     error: Error | null;
     refetch: () => Promise<unknown>;
 }
+interface LimitOrderSizeRules {
+    sizeStepRaw?: string;
+    minSizeRaw?: string;
+}
+/** Per-venue limit size rules from the same batch orderbook metadata as ticks. */
+declare const resolveLimitOrderSizeRulesByVenue: (response: BatchOrderbooksResponse | null | undefined) => Map<Venue$1, LimitOrderSizeRules>;
 /**
  * Fetches informational single-venue quotes for limit-order routing cards.
  * Quote IDs are intentionally not consumed by the limit-order execution flow.
@@ -7763,7 +7785,8 @@ override?: AppTradingMode): UseResolvedExecutionModeResult;
 
 interface UseSettlementDetailsDataOptions {
     eventId: string;
-    market: Pick<VenueMarket$1, "id" | "venue" | "externalIdentifier">;
+    /** Omit when only the event's details (description, settlementDiff) are needed. */
+    market?: Pick<VenueMarket$1, "id" | "venue" | "externalIdentifier">;
     enabled: boolean;
     needsEvent: boolean;
     needsMarket: boolean;
@@ -8270,4 +8293,4 @@ declare function useHostedVenueTransfers(accountId: string, environment: Environ
     clear: () => void;
 };
 
-export { AUTH_CHOOSER_OPEN_EVENT, type AggAuthContextValue, type AggAuthSignInOptions, type AggBalanceContextValue, AggBalanceProvider, AggProvider, type AggProviderProps, AggProvider as AggSdkProvider, type AggProviderProps as AggSdkProviderProps, type AggUiConfig, type AggUiConfigInput, type AggUiLabels, type AggUiLabelsInput, AggUiProvider, type AggUiTradingExecutionMode, CHART_TIME_RANGES, CONFIRMED_MATCH_STATUSES, type ChartTimeRange, type ClosedPositionTotals, type ComputePriceGapsOptions, DEFAULT_AGG_ROOT_CLASS_NAME, type DagStepProgress, type EventListStateContextValue, EventListStateProvider, type EventListStateSnapshot, type EventTradingContextValue, type EventTradingState, type ExecutionProgressPhase, type ExecutionRawStepProgress, type ExecutionStepProgress, type ExecutionTerminalOrderEvent, type GeoBlockState, type GetOrdersQuery, type GetPositionsQuery, type InvalidateUserActivityOptions, type InvalidateUserMoneyStateOptions, LEADERBOARD_PERIODS, type LeaderboardPeriod, type LimitOrderVenueQuoteRequest, type LimitOrderVenueQuoteResult, type LiveBestPriceCandidate, type LiveBestPriceCandidates, type LiveBestPrices, type LiveCandle, MAX_ORDER_VENUE_MARKET_IDS_PER_REQUEST, MAX_PRICE_GAP_PCT, MIN_PRICE_GAP_PCT, type MarketChartAvailability, type MarketChartCandle, type MarketChartData, type MarketChartVenueData, type MarketOrderbookData, type MarketOrderbookIntegrity, MarketStatus, type MarketTradingState, MatchStatus, MatchType, type OrderEligibility, type OrderEligibilityReason, type OrderListItem, type OrderbookResult, type PositionGroup, type PriceGapValue, type RecurringCryptoIdentity, type RecurringCryptoMarketInstance, type RecurringCryptoTimeline, type RedeemEvent, type RedeemLegLifecycle, type RedeemLifecycleState, RedeemRejectedError, type RollingChartWindow, SPORTS_LIVE_POLL_INTERVAL_MS, SPORTS_SCHEDULED_POLL_INTERVAL_MS, type ScaledCandlePoint, type SdkUiConfig, type SdkUiConfigInput, type SdkUiProviderProps, type SettlementDiff, type SettlementDifference, type SmartRouteLoadingReason, type ThemeMode, TradeSide, type TradingAction, type TradingState, type TradingStateBase, type TradingStateKind, type UseAggAuthOptions, type UseAggAuthReturn, type UseAppConfigResult, type UseArbFeedResult, type UseCancelManagedOrderOptions, type UseCategoriesOptions, type UseCategoryChildrenOptions, type UseEnrichedVenueEventOptions, type UseExecuteManagedOptions, type UseExecutionOrdersForMarketsOptions, type UseExecutionOrdersForMarketsResult, type UseExecutionOrdersOptions, type UseExecutionPositionsOptions, type UseExecutionProgressOptions, type UseExecutionProgressResult, type UseExternalIdOptions, type UseExternalIdReturn, type UseLeaderboardOptions, type UseLimitOrderVenueQuotesOptions, type UseLimitOrderVenueQuotesResult, type UseLinkAccountReturn, type UseLiveCandleOverlayOptions, type UseLiveCandleOverlayResult, type UseLiveCandlesOptions, type UseLiveCandlesResult, type UseLiveMarketResult, type UseMarketArbResult, type UseMarketChartOptions, type UseMarketChartResult, type UseMarketChartsResult, type UseMarketOrderbookOptions, type UseMarketOrderbookResult, type UseMarketOrderbookVenueOutcome, type UseMarketSearchOptions, type UseMidpointsOptions, type UseMidpointsResult, type UseOrderBookOptions, type UseOrderbookQuoteOptions, type UseOrderbookQuoteResult, type UseOrdersOptions, type UsePaperOnboardingResult, type UsePlaceLimitOrderOptions, type UsePositionsOptions, type UseRecurringCryptoMarketsOptions, type UseRedeemLifecycleInput, type UseResolvedExecutionModeResult, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSettlementDetailsDataOptions, type UseSmartRouteOptions, type UseSmartRouteResult, type UseUserActivityOptions, type UseUserHoldingsOptions, type UseVenueEventOptions, type UseVenueEventsOptions, type UseVenueMarketMidpointsOptions, type UseVenueMarketsOptions, type UseVenueSellQuotesOptions, type UseVenueSellQuotesResult, type UseViewportMidpointsOptions, type UseVisibleIdsOptions, type UseVisibleIdsResult, type UserActivityInvalidationStrategy, Venue, type VenueAvailabilityState, type VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type VenueSellQuoteRequest, type VenueSellQuoteResult, type WalletActionSendTokenParams, type WalletActions, appConfigQueryKey, buildLiveBestPriceCandidates, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, extractOutcomeBestCandidate, fetchRecurringCryptoMarkets, findLivePriceById, getBuilder, getOrCreateBuilder, getVenueAvailabilityState, getVisibleVenueIdsByConfig, getVisibleVenuesByConfig, getWalletAddressFromUserProfile, hostedVenueAccountQueryKeys, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserClaimState, invalidateUserMoneyState, isVenueDisabledByConfig, leaderboardQueryKeys, leaderboardRange, mergeBestPricesPreferringLive, mergeRecurringCryptoWindows, normalizeVenueId, optimizedImageUrl, parseEmail, parseEmailStrict, rangeToSeconds, recurringCryptoTransitionPollInterval, requestAggAuthChooserOpen, resolveAggUiLabels, resolveDefaultMarket as resolveDefaultTradingMarket, resolveEventTradingState, resolveMarketTradingState, resolveMarketWinningOutcome, resolveOrderEligibility, resolveRecurringCryptoIdentity, resolveRecurringCryptoTimeline, resolveRollingWindow, resolveTradingStateKind, retinaImageUrl, sharedKycQueryKeys, sortVenues, sportsLiveQueryKey, sportsLiveRefetchInterval, timeRangeToInterval, tradingReducer, useAggAuth, useAggAuthContext, useAggAuthState, useAggBalance, useAggBalanceContext, useAggBalanceState, useAggClient, useAggLabels, useAggUiConfig, useAggWebSocket, useAppConfig, useArbFeed, useBalanceRefillPolicies, useCachedAppConfig, useCancelManagedOrder, useCategories, useCategoryChildren, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionOrdersForMarkets, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useHostedVenueAccount, useHostedVenueActivity, useHostedVenueTransfers, useLabels, useLeaderboard, useLimitOrderVenueQuotes, useLinkAccount, useLiveBestPriceCandidates, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, useMarketArb, useMarketChart, useMarketCharts, useMarketOrderbook, useMarketSearch, useMidpoints, useOnBalanceUpdate, useOnOrderEvent, useOnOrderSubmitted, useOnRedeemEvent, useOnWithdrawalLifecycle, useOptionalAggClient, useOrderBook, useOrderbookQuote, useOrders, usePaperOnboarding, usePlaceLimitOrder, usePositions, useRampQuotes, useRampSession, useRecurringCryptoMarkets, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useResolvedExecutionMode, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSettlementDetailsData, useSharedKyc, useSmartRoute, useSportsLive, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueKeyStatus, useVenueMarketMidpoints, useVenueMarkets, useVenueSellQuotes, useViewportMidpoints, useVisibleIds, userActivityQueryKeys, venueKeyQueryKeys };
+export { AUTH_CHOOSER_OPEN_EVENT, type AggAuthContextValue, type AggAuthSignInOptions, type AggBalanceContextValue, AggBalanceProvider, AggProvider, type AggProviderProps, AggProvider as AggSdkProvider, type AggProviderProps as AggSdkProviderProps, type AggUiConfig, type AggUiConfigInput, type AggUiLabels, type AggUiLabelsInput, AggUiProvider, type AggUiTradingExecutionMode, CHART_TIME_RANGES, CONFIRMED_MATCH_STATUSES, type ChartTimeRange, type ClosedPositionTotals, type ComputePriceGapsOptions, DEFAULT_AGG_ROOT_CLASS_NAME, type DagStepProgress, type EventListStateContextValue, EventListStateProvider, type EventListStateSnapshot, type EventTradingContextValue, type EventTradingState, type ExecutionProgressPhase, type ExecutionRawStepProgress, type ExecutionStepProgress, type ExecutionTerminalOrderEvent, type GeoBlockState, type GetOrdersQuery, type GetPositionsQuery, type InvalidateUserActivityOptions, type InvalidateUserMoneyStateOptions, LEADERBOARD_PERIODS, type LeaderboardPeriod, type LimitOrderSizeRules, type LimitOrderVenueQuoteRequest, type LimitOrderVenueQuoteResult, type LiveBestPriceCandidate, type LiveBestPriceCandidates, type LiveBestPrices, type LiveCandle, MAX_ORDER_VENUE_MARKET_IDS_PER_REQUEST, MAX_PRICE_GAP_PCT, MIN_PRICE_GAP_PCT, type MarketChartAvailability, type MarketChartCandle, type MarketChartData, type MarketChartVenueData, type MarketOrderbookData, type MarketOrderbookIntegrity, MarketStatus, type MarketTradingState, MatchStatus, MatchType, type OrderEligibility, type OrderEligibilityReason, type OrderListItem, type OrderbookResult, type PositionGroup, type PriceGapValue, type RecurringCryptoIdentity, type RecurringCryptoMarketInstance, type RecurringCryptoTimeline, type RedeemEvent, type RedeemLegLifecycle, type RedeemLifecycleState, RedeemRejectedError, type RollingChartWindow, SPORTS_LIVE_POLL_INTERVAL_MS, SPORTS_SCHEDULED_POLL_INTERVAL_MS, type ScaledCandlePoint, type SdkUiConfig, type SdkUiConfigInput, type SdkUiProviderProps, type SettlementDiff, type SettlementDifference, type SmartRouteLoadingReason, type ThemeMode, TradeSide, type TradingAction, type TradingState, type TradingStateBase, type TradingStateKind, type UseAggAuthOptions, type UseAggAuthReturn, type UseAppConfigResult, type UseArbFeedResult, type UseCancelManagedOrderOptions, type UseCategoriesOptions, type UseCategoryChildrenOptions, type UseEnrichedVenueEventOptions, type UseExecuteManagedOptions, type UseExecutionOrdersForMarketsOptions, type UseExecutionOrdersForMarketsResult, type UseExecutionOrdersOptions, type UseExecutionPositionsOptions, type UseExecutionProgressOptions, type UseExecutionProgressResult, type UseExternalIdOptions, type UseExternalIdReturn, type UseLeaderboardOptions, type UseLimitOrderVenueQuotesOptions, type UseLimitOrderVenueQuotesResult, type UseLinkAccountReturn, type UseLiveCandleOverlayOptions, type UseLiveCandleOverlayResult, type UseLiveCandlesOptions, type UseLiveCandlesResult, type UseLiveMarketResult, type UseMarketArbResult, type UseMarketChartOptions, type UseMarketChartResult, type UseMarketChartsResult, type UseMarketOrderbookOptions, type UseMarketOrderbookResult, type UseMarketOrderbookVenueOutcome, type UseMarketSearchOptions, type UseMidpointsOptions, type UseMidpointsResult, type UseOrderBookOptions, type UseOrderbookQuoteOptions, type UseOrderbookQuoteResult, type UseOrdersOptions, type UsePaperOnboardingResult, type UsePlaceLimitOrderOptions, type UsePositionsOptions, type UseRecurringCryptoMarketsOptions, type UseRedeemLifecycleInput, type UseResolvedExecutionModeResult, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSettlementDetailsDataOptions, type UseSmartRouteOptions, type UseSmartRouteResult, type UseUserActivityOptions, type UseUserHoldingsOptions, type UseVenueEventOptions, type UseVenueEventsOptions, type UseVenueMarketMidpointsOptions, type UseVenueMarketsOptions, type UseVenueSellQuotesOptions, type UseVenueSellQuotesResult, type UseViewportMidpointsOptions, type UseVisibleIdsOptions, type UseVisibleIdsResult, type UserActivityInvalidationStrategy, Venue, type VenueAvailabilityState, type VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type VenueSellQuoteRequest, type VenueSellQuoteResult, type WalletActionSendTokenParams, type WalletActions, appConfigQueryKey, buildLiveBestPriceCandidates, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, extractOutcomeBestCandidate, fetchRecurringCryptoMarkets, findLivePriceById, getBuilder, getOrCreateBuilder, getVenueAvailabilityState, getVisibleVenueIdsByConfig, getVisibleVenuesByConfig, getWalletAddressFromUserProfile, hostedVenueAccountQueryKeys, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserClaimState, invalidateUserMoneyState, isVenueDisabledByConfig, leaderboardQueryKeys, leaderboardRange, mergeBestPricesPreferringLive, mergeRecurringCryptoWindows, normalizeVenueId, optimizedImageUrl, parseEmail, parseEmailStrict, rangeToSeconds, recurringCryptoTransitionPollInterval, requestAggAuthChooserOpen, resolveAggUiLabels, resolveDefaultMarket as resolveDefaultTradingMarket, resolveEventTradingState, resolveLimitOrderSizeRulesByVenue, resolveMarketTradingState, resolveMarketWinningOutcome, resolveOrderEligibility, resolveRecurringCryptoIdentity, resolveRecurringCryptoTimeline, resolveRollingWindow, resolveTradingStateKind, retinaImageUrl, sharedKycQueryKeys, sortVenues, sportsLiveQueryKey, sportsLiveRefetchInterval, timeRangeToInterval, tradingReducer, useAggAuth, useAggAuthContext, useAggAuthState, useAggBalance, useAggBalanceContext, useAggBalanceState, useAggClient, useAggLabels, useAggUiConfig, useAggWebSocket, useAppConfig, useArbFeed, useBalanceRefillPolicies, useCachedAppConfig, useCancelManagedOrder, useCategories, useCategoryChildren, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionOrdersForMarkets, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useHostedVenueAccount, useHostedVenueActivity, useHostedVenueTransfers, useLabels, useLeaderboard, useLimitOrderVenueQuotes, useLinkAccount, useLiveBestPriceCandidates, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, useMarketArb, useMarketChart, useMarketCharts, useMarketOrderbook, useMarketSearch, useMidpoints, useOnBalanceUpdate, useOnOrderEvent, useOnOrderSubmitted, useOnRedeemEvent, useOnWithdrawalLifecycle, useOptionalAggClient, useOrderBook, useOrderbookQuote, useOrders, usePaperOnboarding, usePlaceLimitOrder, usePositions, useRampQuotes, useRampSession, useRecurringCryptoMarkets, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useResolvedExecutionMode, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSettlementDetailsData, useSharedKyc, useSmartRoute, useSportsLive, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueKeyStatus, useVenueMarketMidpoints, useVenueMarkets, useVenueSellQuotes, useViewportMidpoints, useVisibleIds, userActivityQueryKeys, venueKeyQueryKeys };

package/dist/index.js

@@ -132,6 +132,7 @@ __export(src_exports, {
   resolveAggUiLabels: () => resolveAggUiLabels,
   resolveDefaultTradingMarket: () => resolveDefaultMarket,
   resolveEventTradingState: () => resolveEventTradingState,
+  resolveLimitOrderSizeRulesByVenue: () => resolveLimitOrderSizeRulesByVenue,
   resolveMarketTradingState: () => resolveMarketTradingState,
   resolveMarketWinningOutcome: () => resolveMarketWinningOutcome,
   resolveOrderEligibility: () => resolveOrderEligibility,
@@ -9557,6 +9558,7 @@ var getIsDocumentVisible2 = () => {
   if (typeof document === "undefined") return true;
   return document.visibilityState !== "hidden";
 };
+var MAX_ORDERBOOK_METADATA_MARKET_IDS = 20;
 var getUniqueVenueRequests = (requests) => {
   const requestsByVenue = /* @__PURE__ */ new Map();
   for (const request of requests) {
@@ -9586,6 +9588,21 @@ var resolveLimitOrderTickSizesByVenue = (response) => {
   }
   return tickSizes;
 };
+var resolveLimitOrderSizeRulesByVenue = (response) => {
+  var _a;
+  const rulesByVenue = /* @__PURE__ */ new Map();
+  const setRules = (venue, entry) => {
+    if (rulesByVenue.has(venue)) return;
+    if (!entry.sizeStepRaw && !entry.minSizeRaw) return;
+    rulesByVenue.set(venue, __spreadValues(__spreadValues({}, entry.sizeStepRaw ? { sizeStepRaw: entry.sizeStepRaw } : {}), entry.minSizeRaw ? { minSizeRaw: entry.minSizeRaw } : {}));
+  };
+  for (const item of (_a = response == null ? void 0 : response.data) != null ? _a : []) {
+    for (const [venue, entry] of Object.entries(item.venueOrderbooks)) setRules(venue, entry);
+    for (const market of item.matchedMarkets) setRules(market.venue, market);
+    if (item.requestedMarket) setRules(item.requestedMarket.venue, item.requestedMarket);
+  }
+  return rulesByVenue;
+};
 var useLimitOrderVenueQuotes = (options) => {
   var _a, _b;
   const client = useAggClient();
@@ -9607,9 +9624,22 @@ var useLimitOrderVenueQuotes = (options) => {
   const hasRequiredAccount = tradeSide === "buy" || Boolean(accountId);
   const queryEnabled = enabled && hasValidInput && hasRequiredAccount;
   const serializedChainBalances = chainBalances ? JSON.stringify(chainBalances) : null;
+  const metadataMarketIds = marketId ? [
+    .../* @__PURE__ */ new Set([
+      marketId,
+      ...uniqueRequests.flatMap(
+        (request) => request.venueMarketId ? [request.venueMarketId] : []
+      )
+    ])
+  ].slice(0, MAX_ORDERBOOK_METADATA_MARKET_IDS) : [];
   const tickMetadataQuery = (0, import_react_query41.useQuery)({
-    queryKey: ["orderbooks", marketId != null ? marketId : "__disabled__", "limit-order-ticks"],
-    queryFn: ({ signal }) => client.getOrderbooks({ venueMarketIds: [marketId] }, { signal }),
+    queryKey: [
+      "orderbooks",
+      marketId != null ? marketId : "__disabled__",
+      "limit-order-ticks",
+      metadataMarketIds
+    ],
+    queryFn: ({ signal }) => client.getOrderbooks({ venueMarketIds: metadataMarketIds }, { signal }),
     enabled: enabled && Boolean(marketId),
     staleTime: 6e4,
     gcTime: 5 * 6e4,
@@ -9671,14 +9701,17 @@ var useLimitOrderVenueQuotes = (options) => {
     }))
   });
   const tickSizesByVenue = resolveLimitOrderTickSizesByVenue(tickMetadataQuery.data);
+  const sizeRulesByVenue = resolveLimitOrderSizeRulesByVenue(tickMetadataQuery.data);
   const quotes = queries.map((query, index) => {
-    var _a2, _b2;
+    var _a2, _b2, _c, _d, _e, _f;
     const queryError = query.error;
     const request = uniqueRequests[index];
     return {
       request,
       data: (_a2 = query.data) != null ? _a2 : null,
       tickSize: (_b2 = tickSizesByVenue.get(request.venue)) != null ? _b2 : null,
+      sizeStepRaw: (_d = (_c = sizeRulesByVenue.get(request.venue)) == null ? void 0 : _c.sizeStepRaw) != null ? _d : null,
+      minSizeRaw: (_f = (_e = sizeRulesByVenue.get(request.venue)) == null ? void 0 : _e.minSizeRaw) != null ? _f : null,
       isLoading: query.isLoading,
       isFetching: query.isFetching,
       error: queryError instanceof Error ? queryError : queryError ? new Error(String(queryError)) : null,
@@ -9687,6 +9720,8 @@ var useLimitOrderVenueQuotes = (options) => {
   });
   return {
     quotes,
+    // A failed metadata read is not pending: callers fall back to 1-raw sizing.
+    isMetadataPending: Boolean(marketId) && tickMetadataQuery.isPending === true,
     isLoading: quotes.some((quote) => quote.isLoading),
     isFetching: quotes.some((quote) => quote.isFetching),
     error: (_b = (_a = quotes.find((quote) => quote.error)) == null ? void 0 : _a.error) != null ? _b : null,
@@ -11138,8 +11173,9 @@ function useSettlementDetailsData(options) {
     retry: false
   });
   const marketQuery = (0, import_react_query50.useQuery)({
-    queryKey: ["settlement-details", "market", client.appId, market.id],
+    queryKey: ["settlement-details", "market", client.appId, market == null ? void 0 : market.id],
     queryFn: (_0) => __async(null, [_0], function* ({ signal }) {
+      if (!market) throw new Error("Selected market details unavailable");
       const response = yield client.getVenueMarkets(
         { venue: market.venue, externalIdentifier: [market.externalIdentifier], limit: 1 },
         { signal }
@@ -11148,7 +11184,7 @@ function useSettlementDetailsData(options) {
       if (!selected) throw new Error("Selected market details unavailable");
       return { selected, markets: response.data };
     }),
-    enabled: enabled && needsMarket,
+    enabled: enabled && needsMarket && market != null,
     staleTime: 5 * 6e4,
     gcTime: 10 * 6e4,
     retry: false
@@ -11387,6 +11423,7 @@ function useHostedVenueTransfers(accountId, environment) {
   resolveAggUiLabels,
   resolveDefaultTradingMarket,
   resolveEventTradingState,
+  resolveLimitOrderSizeRulesByVenue,
   resolveMarketTradingState,
   resolveMarketWinningOutcome,
   resolveOrderEligibility,

package/dist/index.mjs

@@ -3406,6 +3406,7 @@ var getIsDocumentVisible2 = () => {
   if (typeof document === "undefined") return true;
   return document.visibilityState !== "hidden";
 };
+var MAX_ORDERBOOK_METADATA_MARKET_IDS = 20;
 var getUniqueVenueRequests = (requests) => {
   const requestsByVenue = /* @__PURE__ */ new Map();
   for (const request of requests) {
@@ -3435,6 +3436,21 @@ var resolveLimitOrderTickSizesByVenue = (response) => {
   }
   return tickSizes;
 };
+var resolveLimitOrderSizeRulesByVenue = (response) => {
+  var _a;
+  const rulesByVenue = /* @__PURE__ */ new Map();
+  const setRules = (venue, entry) => {
+    if (rulesByVenue.has(venue)) return;
+    if (!entry.sizeStepRaw && !entry.minSizeRaw) return;
+    rulesByVenue.set(venue, __spreadValues(__spreadValues({}, entry.sizeStepRaw ? { sizeStepRaw: entry.sizeStepRaw } : {}), entry.minSizeRaw ? { minSizeRaw: entry.minSizeRaw } : {}));
+  };
+  for (const item of (_a = response == null ? void 0 : response.data) != null ? _a : []) {
+    for (const [venue, entry] of Object.entries(item.venueOrderbooks)) setRules(venue, entry);
+    for (const market of item.matchedMarkets) setRules(market.venue, market);
+    if (item.requestedMarket) setRules(item.requestedMarket.venue, item.requestedMarket);
+  }
+  return rulesByVenue;
+};
 var useLimitOrderVenueQuotes = (options) => {
   var _a, _b;
   const client = useAggClient();
@@ -3456,9 +3472,22 @@ var useLimitOrderVenueQuotes = (options) => {
   const hasRequiredAccount = tradeSide === "buy" || Boolean(accountId);
   const queryEnabled = enabled && hasValidInput && hasRequiredAccount;
   const serializedChainBalances = chainBalances ? JSON.stringify(chainBalances) : null;
+  const metadataMarketIds = marketId ? [
+    .../* @__PURE__ */ new Set([
+      marketId,
+      ...uniqueRequests.flatMap(
+        (request) => request.venueMarketId ? [request.venueMarketId] : []
+      )
+    ])
+  ].slice(0, MAX_ORDERBOOK_METADATA_MARKET_IDS) : [];
   const tickMetadataQuery = useQuery11({
-    queryKey: ["orderbooks", marketId != null ? marketId : "__disabled__", "limit-order-ticks"],
-    queryFn: ({ signal }) => client.getOrderbooks({ venueMarketIds: [marketId] }, { signal }),
+    queryKey: [
+      "orderbooks",
+      marketId != null ? marketId : "__disabled__",
+      "limit-order-ticks",
+      metadataMarketIds
+    ],
+    queryFn: ({ signal }) => client.getOrderbooks({ venueMarketIds: metadataMarketIds }, { signal }),
     enabled: enabled && Boolean(marketId),
     staleTime: 6e4,
     gcTime: 5 * 6e4,
@@ -3520,14 +3549,17 @@ var useLimitOrderVenueQuotes = (options) => {
     }))
   });
   const tickSizesByVenue = resolveLimitOrderTickSizesByVenue(tickMetadataQuery.data);
+  const sizeRulesByVenue = resolveLimitOrderSizeRulesByVenue(tickMetadataQuery.data);
   const quotes = queries.map((query, index) => {
-    var _a2, _b2;
+    var _a2, _b2, _c, _d, _e, _f;
     const queryError = query.error;
     const request = uniqueRequests[index];
     return {
       request,
       data: (_a2 = query.data) != null ? _a2 : null,
       tickSize: (_b2 = tickSizesByVenue.get(request.venue)) != null ? _b2 : null,
+      sizeStepRaw: (_d = (_c = sizeRulesByVenue.get(request.venue)) == null ? void 0 : _c.sizeStepRaw) != null ? _d : null,
+      minSizeRaw: (_f = (_e = sizeRulesByVenue.get(request.venue)) == null ? void 0 : _e.minSizeRaw) != null ? _f : null,
       isLoading: query.isLoading,
       isFetching: query.isFetching,
       error: queryError instanceof Error ? queryError : queryError ? new Error(String(queryError)) : null,
@@ -3536,6 +3568,8 @@ var useLimitOrderVenueQuotes = (options) => {
   });
   return {
     quotes,
+    // A failed metadata read is not pending: callers fall back to 1-raw sizing.
+    isMetadataPending: Boolean(marketId) && tickMetadataQuery.isPending === true,
     isLoading: quotes.some((quote) => quote.isLoading),
     isFetching: quotes.some((quote) => quote.isFetching),
     error: (_b = (_a = quotes.find((quote) => quote.error)) == null ? void 0 : _a.error) != null ? _b : null,
@@ -4992,8 +5026,9 @@ function useSettlementDetailsData(options) {
     retry: false
   });
   const marketQuery = useQuery16({
-    queryKey: ["settlement-details", "market", client.appId, market.id],
+    queryKey: ["settlement-details", "market", client.appId, market == null ? void 0 : market.id],
     queryFn: (_0) => __async(null, [_0], function* ({ signal }) {
+      if (!market) throw new Error("Selected market details unavailable");
       const response = yield client.getVenueMarkets(
         { venue: market.venue, externalIdentifier: [market.externalIdentifier], limit: 1 },
         { signal }
@@ -5002,7 +5037,7 @@ function useSettlementDetailsData(options) {
       if (!selected) throw new Error("Selected market details unavailable");
       return { selected, markets: response.data };
     }),
-    enabled: enabled && needsMarket,
+    enabled: enabled && needsMarket && market != null,
     staleTime: 5 * 6e4,
     gcTime: 10 * 6e4,
     retry: false
@@ -5240,6 +5275,7 @@ export {
   resolveAggUiLabels,
   resolveDefaultMarket as resolveDefaultTradingMarket,
   resolveEventTradingState,
+  resolveLimitOrderSizeRulesByVenue,
   resolveMarketTradingState,
   resolveMarketWinningOutcome,
   resolveOrderEligibility,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/hooks",
-  "version": "4.24.0",
+  "version": "4.26.1",
   "description": "React hooks and providers for the AGG prediction market aggregator. Wraps @agg-build/sdk with TanStack Query, shared session state, and live WebSocket data.",
   "sideEffects": false,
   "license": "MIT",
@@ -83,7 +83,7 @@
     "react": "^18.0.0 || ^19.0.0",
     "viem": "^2.0.0",
     "wagmi": "^3.0.0 || ^2.0.0",
-    "@agg-build/sdk": "^4.24.0"
+    "@agg-build/sdk": "^4.26.0"
   },
   "peerDependenciesMeta": {
     "@solana/wallet-adapter-react": {