@agg-build/hooks 2.1.1 → 2.1.2

package/dist/{chunk-AFZD3GIQ.mjs → chunk-5VDUIUJB.mjs}

@@ -1,7 +1,7 @@
 import {
   __async,
   useAggClient
-} from "./chunk-FYEPQHKO.mjs";
+} from "./chunk-7UDYSDKQ.mjs";
 
 // src/use-ramp-quotes.ts
 import { useMutation } from "@tanstack/react-query";

package/dist/{chunk-FYEPQHKO.mjs → chunk-7UDYSDKQ.mjs}

@@ -835,6 +835,7 @@ var enUsLabels = {
     orderSkip: "Skip",
     orderRetryRemaining: "Retry remaining",
     resolvedEarningsTitle: "Your Earnings",
+    resolvedResolutionDateLabel: "Resolution date",
     resolvedSharesLabel: "Shares",
     resolvedTotalPayoutLabel: "Total payout",
     claimWinnings: "Claim Winnings",
@@ -2007,6 +2008,98 @@ var applyOrderbookDepth = (data, depth) => {
   });
 };
 
+// src/market-data/market-resolution-cache.ts
+var isRecord = (value) => {
+  return typeof value === "object" && value !== null;
+};
+var NESTED_COLLECTION_FIELDS = ["pages", "data", "markets", "events", "venueMarkets"];
+var marketContainsOutcomeId = (market, outcomeId) => {
+  if (!isRecord(market)) return false;
+  const outcomes = market.venueMarketOutcomes;
+  if (!Array.isArray(outcomes)) return false;
+  return outcomes.some((outcome) => isRecord(outcome) && outcome.id === outcomeId);
+};
+var cachedDataContainsOutcomeId = (data, outcomeId) => {
+  if (Array.isArray(data)) {
+    return data.some((entry) => cachedDataContainsOutcomeId(entry, outcomeId));
+  }
+  if (!isRecord(data)) return false;
+  if (marketContainsOutcomeId(data, outcomeId)) return true;
+  return NESTED_COLLECTION_FIELDS.some((field) => {
+    const value = data[field];
+    return Array.isArray(value) && value.some((entry) => cachedDataContainsOutcomeId(entry, outcomeId));
+  });
+};
+var normalizeLabel = (label) => {
+  return typeof label === "string" ? label.trim().toLowerCase() : "";
+};
+var findResolvedOutcome = (resolvedOutcomes, outcome) => {
+  var _a;
+  const externalIdentifier = outcome.externalIdentifier;
+  if (typeof externalIdentifier === "string" && externalIdentifier.length > 0) {
+    const matchedByExternalId = resolvedOutcomes.find(
+      (resolved) => resolved.externalIdentifier === externalIdentifier
+    );
+    if (matchedByExternalId) return matchedByExternalId;
+  }
+  const label = normalizeLabel(outcome.label);
+  if (label) {
+    return (_a = resolvedOutcomes.find((resolved) => normalizeLabel(resolved.label) === label)) != null ? _a : null;
+  }
+  return null;
+};
+var applyWinnersToOutcomes = (outcomes, resolution) => {
+  let changed = false;
+  const next = outcomes.map((outcome) => {
+    if (!isRecord(outcome)) return outcome;
+    const resolved = findResolvedOutcome(resolution.outcomes, outcome);
+    if (!resolved) return outcome;
+    const nextWinner = resolved.winner === true;
+    if (outcome.winner === nextWinner) return outcome;
+    changed = true;
+    return __spreadProps(__spreadValues({}, outcome), { winner: nextWinner });
+  });
+  return changed ? next : outcomes;
+};
+var applyResolutionToMarket = (market, resolution) => {
+  const outcomes = market.venueMarketOutcomes;
+  if (!Array.isArray(outcomes)) return market;
+  if (!outcomes.some((outcome) => isRecord(outcome) && outcome.id === resolution.outcomeId)) {
+    return market;
+  }
+  const nextOutcomes = applyWinnersToOutcomes(outcomes, resolution);
+  const statusChanged = market.status !== resolution.status;
+  if (!statusChanged && nextOutcomes === outcomes) return market;
+  return __spreadProps(__spreadValues({}, market), { status: resolution.status, venueMarketOutcomes: nextOutcomes });
+};
+var applyResolutionToCachedData = (data, resolution) => {
+  if (Array.isArray(data)) {
+    let changed2 = false;
+    const next2 = data.map((entry) => {
+      const updated = applyResolutionToCachedData(entry, resolution);
+      if (updated !== entry) changed2 = true;
+      return updated;
+    });
+    return changed2 ? next2 : data;
+  }
+  if (!isRecord(data)) return data;
+  if (Array.isArray(data.venueMarketOutcomes)) {
+    return applyResolutionToMarket(data, resolution);
+  }
+  let changed = false;
+  const next = __spreadValues({}, data);
+  for (const field of NESTED_COLLECTION_FIELDS) {
+    const value = data[field];
+    if (!Array.isArray(value)) continue;
+    const updated = applyResolutionToCachedData(value, resolution);
+    if (updated !== value) {
+      next[field] = updated;
+      changed = true;
+    }
+  }
+  return changed ? next : data;
+};
+
 // src/market-data/query-keys.ts
 var marketDataKeys = {
   all: () => ["market-data"],
@@ -2235,6 +2328,62 @@ function AggWebSocketProvider({ children }) {
   const invalidateActivityCaches = useCallback3(() => {
     invalidateUserActivityQueries(queryClient);
   }, [queryClient]);
+  const invalidateResolutionCaches = useCallback3(
+    (resolution) => {
+      const { outcomeId } = resolution;
+      syncLiveQuery(outcomeId, (previous) => {
+        if (!previous) return previous;
+        if (previous.orderbook == null && previous.orderbookError == null) return previous;
+        return __spreadProps(__spreadValues({}, previous), {
+          orderbook: null,
+          orderbookError: null,
+          integrity: "ok"
+        });
+      });
+      const affectedQueries = queryClient.getQueryCache().findAll({
+        predicate: (query) => cachedDataContainsOutcomeId(query.state.data, outcomeId)
+      });
+      for (const query of affectedQueries) {
+        queryClient.setQueryData(
+          query.queryKey,
+          (previous) => applyResolutionToCachedData(previous, resolution)
+        );
+      }
+      queryClient.invalidateQueries({
+        queryKey: ["midpoints"],
+        refetchType: "all"
+      });
+      queryClient.invalidateQueries({
+        queryKey: ["venue-market-midpoints"],
+        refetchType: "all"
+      });
+      queryClient.invalidateQueries({
+        queryKey: ["venue-event"],
+        refetchType: "all"
+      });
+      queryClient.invalidateQueries({
+        queryKey: ["venue-markets"],
+        refetchType: "all"
+      });
+      queryClient.invalidateQueries({
+        queryKey: ["events"],
+        refetchType: "all"
+      });
+      queryClient.invalidateQueries({
+        queryKey: ["event-list"],
+        refetchType: "all"
+      });
+      queryClient.invalidateQueries({
+        queryKey: ["search"],
+        refetchType: "all"
+      });
+      queryClient.invalidateQueries({
+        predicate: (query) => cachedDataContainsOutcomeId(query.state.data, outcomeId),
+        refetchType: "all"
+      });
+    },
+    [queryClient, syncLiveQuery]
+  );
   const callbacks = useMemo2(
     () => ({
       onSnapshot: (marketId, book) => {
@@ -2383,6 +2532,14 @@ function AggWebSocketProvider({ children }) {
           listener(msg);
         }
       },
+      onMarketResolved: (msg) => {
+        invalidateResolutionCaches(msg);
+        if (isClientAuthenticated) {
+          invalidateBalanceCaches();
+          invalidatePositionCaches();
+          invalidateActivityCaches();
+        }
+      },
       onError: (msg) => {
         const outcomeId = resolveSnapshotUnavailableOutcomeId(msg.message);
         if (!outcomeId) return;
@@ -2420,6 +2577,7 @@ function AggWebSocketProvider({ children }) {
       invalidateActivityCaches,
       invalidateBalanceCaches,
       invalidatePositionCaches,
+      invalidateResolutionCaches,
       isClientAuthenticated,
       queryClient,
       syncChartQueries,

package/dist/{chunk-5P53A3NQ.mjs → chunk-FBYQBFFR.mjs}

@@ -11,7 +11,7 @@ import {
   useOnWithdrawalLifecycle,
   useSyncBalances,
   useWithdrawManaged
-} from "./chunk-FYEPQHKO.mjs";
+} from "./chunk-7UDYSDKQ.mjs";
 
 // src/withdraw/use-withdraw-flow.ts
 import { useCallback, useEffect, useMemo, useState } from "react";

package/dist/deposit.js

@@ -98,8 +98,9 @@ var import_wagmi = require("wagmi");
 
 // src/deposit/constants.ts
 var DEFAULT_SOLANA_RPC_ENDPOINTS = [
+  "https://solana-rpc.publicnode.com",
   "https://api.mainnet.solana.com",
-  "https://solana-rpc.publicnode.com"
+  "https://rpc.ankr.com/solana"
 ];
 var DEFAULT_SOLANA_RPC_ENDPOINT = DEFAULT_SOLANA_RPC_ENDPOINTS[0];
 var SVM_CHAIN_IDS = /* @__PURE__ */ new Set([792703809]);
@@ -769,6 +770,7 @@ var enUsLabels = {
     orderSkip: "Skip",
     orderRetryRemaining: "Retry remaining",
     resolvedEarningsTitle: "Your Earnings",
+    resolvedResolutionDateLabel: "Resolution date",
     resolvedSharesLabel: "Shares",
     resolvedTotalPayoutLabel: "Total payout",
     claimWinnings: "Claim Winnings",

package/dist/deposit.mjs

@@ -1,7 +1,7 @@
 import {
   useRampQuotes,
   useRampSession
-} from "./chunk-AFZD3GIQ.mjs";
+} from "./chunk-5VDUIUJB.mjs";
 import {
   __async,
   useAggAuthState,
@@ -10,7 +10,7 @@ import {
   useAggUiConfig,
   useDepositAddresses,
   useSyncBalances
-} from "./chunk-FYEPQHKO.mjs";
+} from "./chunk-7UDYSDKQ.mjs";
 
 // src/deposit/normalize-wallet-error.ts
 function normalizeWalletError(error, supportedChains) {
@@ -41,8 +41,9 @@ import { useAccount, useReadContract } from "wagmi";
 
 // src/deposit/constants.ts
 var DEFAULT_SOLANA_RPC_ENDPOINTS = [
+  "https://solana-rpc.publicnode.com",
   "https://api.mainnet.solana.com",
-  "https://solana-rpc.publicnode.com"
+  "https://rpc.ankr.com/solana"
 ];
 var DEFAULT_SOLANA_RPC_ENDPOINT = DEFAULT_SOLANA_RPC_ENDPOINTS[0];
 var SVM_CHAIN_IDS = /* @__PURE__ */ new Set([792703809]);

package/dist/index.d.mts

@@ -271,6 +271,12 @@ type VenueMarket = {
     sportsMarketType?: string | null | undefined;
     /** Sort rank within a sports section (0=moneyline, 1=spread, 2=total, 3+=other). */
     sectionRank?: number | null | undefined;
+    /** Period identifier for sports markets (e.g., "1H", "2H", "Q1", etc.). */
+    period?: string | null | undefined;
+    /** Normalized subject category for prop-tab grouping (e.g., game_lines, exact_score, etc.). */
+    marketCategory?: string | null | undefined;
+    /** Line value for spread/total markets (e.g., 2.5 for totals, 3 for spreads). */
+    lineValue?: number | null | undefined;
     matchedVenueMarkets?: {
         id: string;
         venue: Venue;
@@ -324,10 +330,18 @@ type VenueEvent = {
     startDate?: string | null | undefined;
     endDate?: string | null | undefined;
     creationDate?: string | null | undefined;
+    /**
+     * Scheduled kickoff/start of the underlying game (sports events only).
+     * Distinct from `endDate` (market close/expiration), which can sit well
+     * after the game. The FE prefers this over `endDate` for the game-date
+     * title suffix. Null for non-sports events.
+     */
+    gameStartTime?: string | null | undefined;
     slug?: string | null | undefined;
     subtitle?: string | null | undefined;
     venues?: Venue[];
     venueCount?: number | undefined;
+    groupMarketCount?: number | undefined;
     marketCount?: number | undefined;
     /**
      * ISO-8601 duration denormalized from Series.recurrence. `null` means
@@ -1087,6 +1101,7 @@ interface AggUiLabels {
         orderSkip: string;
         orderRetryRemaining: string;
         resolvedEarningsTitle: string;
+        resolvedResolutionDateLabel: string;
         resolvedSharesLabel: string;
         resolvedTotalPayoutLabel: string;
         claimWinnings: string;
@@ -3350,10 +3365,42 @@ declare function useLiveOutcomePrices(venueMarkets: VenueMarket[] | null | undef
  */
 declare function findLivePriceById(livePrices: Map<string, number>, id: string): number | undefined;
 
+interface MarketLiveState {
+    marketId: string;
+    orderbook: OrderbookState | null;
+    orderbookSnapshotVersion: number;
+    orderbookError: string | null;
+    trades: WsTrade[];
+    isConnected: boolean;
+    integrity: "ok" | "resyncing";
+}
+
 type LiveBestPrices = ReadonlyMap<string, {
     bestBid?: number;
     bestAsk?: number;
 }>;
+/**
+ * A WS-derived best-price candidate for one outcome, carrying the venue that
+ * produced each side *and* a freshness stamp. This is the richer companion to
+ * {@link LiveBestPrices}: it keeps the venue attribution that the bare
+ * `{ bestBid, bestAsk }` map throws away, so display surfaces can switch the
+ * venue logo to whichever venue currently owns the best live price — keeping
+ * the logo paired with the price instead of pinned to the REST snapshot.
+ */
+interface LiveBestPriceCandidate {
+    bestBid?: number;
+    bestAsk?: number;
+    /** Venue that owns the cross-venue best bid (best place to sell). */
+    bestBidVenue?: string;
+    /** Venue that owns the cross-venue best ask (cheapest place to buy). */
+    bestAskVenue?: string;
+    midpoint?: number;
+    /** Venue the midpoint is attributed to (cheapest-ask side, then best-bid). */
+    midpointVenue?: string;
+    /** Orderbook timestamp (seconds) of the freshest book backing this candidate. */
+    updatedAt?: number;
+}
+type LiveBestPriceCandidates = ReadonlyMap<string, LiveBestPriceCandidate>;
 /**
  * WS-derived cross-venue + cross-outcome best bid/ask per outcome.
  *
@@ -3381,6 +3428,35 @@ declare function mergeBestPricesPreferringLive(rest: ReadonlyMap<string, {
     bestBid?: number;
     bestAsk?: number;
 }>;
+/**
+ * Pull the per-outcome best bid/ask, attributed venues, midpoint and freshness
+ * out of a single live orderbook state. Pure — exported for unit tests.
+ */
+declare const extractOutcomeBestCandidate: (state: MarketLiveState | undefined) => LiveBestPriceCandidate;
+/**
+ * Cross-venue + cross-outcome venue-attributed best-price candidates.
+ *
+ * Pure (no React) so the cross-venue fold can be unit-tested directly:
+ *   - Pass 1: per-outcome candidate from each outcome's own aggregated book.
+ *   - Pass 2: fold across MVMO groups. Lowest ask wins (cheapest to buy),
+ *     highest bid wins (best to sell), and the *winning venue* + freshest
+ *     timestamp travel with the chosen price to every member of the group.
+ *     This is what lets a different venue's live book switch both the price
+ *     and the venue logo on every WS update.
+ *
+ * Mirrors the price fold in {@link useLiveBestPrices} and the REST fold in
+ * `useMidpoints.extractBestPrices`, but additionally tracks venue + freshness.
+ */
+declare function buildLiveBestPriceCandidates(outcomeIds: string[], states: Array<MarketLiveState | undefined>, venueMarkets: VenueMarket[] | null | undefined): Map<string, LiveBestPriceCandidate>;
+/**
+ * React hook companion to {@link useLiveBestPrices} that additionally carries
+ * venue attribution + freshness per outcome. Recomputes on every WS update
+ * (snapshot/delta) that moves price, venue ownership, or timestamp.
+ *
+ * Empty until WS books land for the subscribed outcomes. Designed to feed a
+ * unified price+venue selector so the venue logo always follows the live price.
+ */
+declare function useLiveBestPriceCandidates(venueMarkets: VenueMarket[] | null | undefined): LiveBestPriceCandidates;
 
 /**
  * Subscribe to real-time trade feed for a canonical market.
@@ -5504,4 +5580,4 @@ declare function useAppConfig(): UseAppConfigResult;
  */
 declare function useCachedAppConfig(): UseAppConfigResult;
 
-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 ExecutionTerminalOrderEvent, type GeoBlockState, type GetOrdersQuery, type GetPositionsQuery, type InvalidateUserActivityOptions, type InvalidateUserMoneyStateOptions, type LiveBestPrices, type LiveCandle, MAX_PRICE_GAP_PCT, MIN_PRICE_GAP_PCT, 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 RedeemEvent, type RedeemLegLifecycle, type RedeemLifecycleState, RedeemRejectedError, type RollingChartWindow, type ScaledCandlePoint, type SdkUiConfig, type SdkUiConfigInput, type SdkUiProviderProps, type SmartRouteLoadingReason, type ThemeMode, TradeSide, type TradingAction, type TradingState, type TradingStateBase, type TradingStateKind, type UseAggAuthOptions, type UseAggAuthReturn, type UseAppConfigResult, type UseArbFeedResult, type UseCategoriesOptions, type UseCategoryChildrenOptions, type UseEnrichedVenueEventOptions, type UseExecuteManagedOptions, type UseExecutionOrdersOptions, type UseExecutionPositionsOptions, type UseExecutionProgressOptions, type UseExecutionProgressResult, type UseExternalIdOptions, type UseExternalIdReturn, type UseLinkAccountReturn, type UseLiveCandleOverlayOptions, type UseLiveCandleOverlayResult, type UseLiveCandlesOptions, type UseLiveCandlesResult, type UseLiveMarketResult, type UseMarketArbResult, type UseMarketChartOptions, type UseMarketChartResult, type UseMarketOrderbookOptions, type UseMarketOrderbookResult, type UseMarketOrderbookVenueOutcome, type UseMarketSearchOptions, type UseMidpointsOptions, type UseMidpointsResult, type UseOrderBookOptions, type UseOrderbookQuoteOptions, type UseOrderbookQuoteResult, type UseOrdersOptions, type UsePositionsOptions, type UseQuoteManagedOptions, type UseRedeemLifecycleInput, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSmartRouteOptions, type UseSmartRouteResult, type UseTradableVenuesResult, type UseUserActivityOptions, type UseUserHoldingsOptions, type UseVenueEventOptions, type UseVenueEventsOptions, type UseVenueMarketMidpointsOptions, type UseVenueMarketsOptions, type UseViewportMidpointsOptions, type UseVisibleIdsOptions, type UseVisibleIdsResult, type UserActivityInvalidationStrategy, Venue, type VenueAvailabilityState, type VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type WalletActionSendTokenParams, type WalletActions, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, findLivePriceById, getBuilder, getOrCreateBuilder, getVenueAvailabilityState, getVisibleVenueIdsByConfig, getVisibleVenuesByConfig, getWalletAddressFromUserProfile, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserClaimState, invalidateUserMoneyState, isVenueDisabledByConfig, mergeBestPricesPreferringLive, normalizeVenueId, optimizedImageUrl, parseEmail, parseEmailStrict, rangeToSeconds, requestAggAuthChooserOpen, resolveAggUiLabels, resolveDefaultMarket as resolveDefaultTradingMarket, resolveEventTradingState, resolveMarketTradingState, resolveMarketWinningOutcome, resolveOrderEligibility, resolveRollingWindow, resolveTradingStateKind, sortVenues, timeRangeToInterval, tradingReducer, useAggAuth, useAggAuthContext, useAggAuthState, useAggBalance, useAggBalanceContext, useAggBalanceState, useAggClient, useAggLabels, useAggUiConfig, useAggWebSocket, useAppConfig, useArbFeed, useCachedAppConfig, useCategories, useCategoryChildren, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useLabels, useLinkAccount, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, useMarketArb, useMarketChart, useMarketOrderbook, useMarketSearch, useMidpoints, useOnBalanceUpdate, useOnOrderEvent, useOnOrderSubmitted, useOnRedeemEvent, useOnWithdrawalLifecycle, useOptionalAggClient, useOrderBook, useOrderbookQuote, useOrders, usePositions, useQuoteManaged, useRampQuotes, useRampSession, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSmartRoute, useTradableVenues, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueMarketMidpoints, useVenueMarkets, useViewportMidpoints, useVisibleIds, userActivityQueryKeys };
+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 ExecutionTerminalOrderEvent, type GeoBlockState, type GetOrdersQuery, type GetPositionsQuery, type InvalidateUserActivityOptions, type InvalidateUserMoneyStateOptions, type LiveBestPriceCandidate, type LiveBestPriceCandidates, type LiveBestPrices, type LiveCandle, MAX_PRICE_GAP_PCT, MIN_PRICE_GAP_PCT, 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 RedeemEvent, type RedeemLegLifecycle, type RedeemLifecycleState, RedeemRejectedError, type RollingChartWindow, type ScaledCandlePoint, type SdkUiConfig, type SdkUiConfigInput, type SdkUiProviderProps, type SmartRouteLoadingReason, type ThemeMode, TradeSide, type TradingAction, type TradingState, type TradingStateBase, type TradingStateKind, type UseAggAuthOptions, type UseAggAuthReturn, type UseAppConfigResult, type UseArbFeedResult, type UseCategoriesOptions, type UseCategoryChildrenOptions, type UseEnrichedVenueEventOptions, type UseExecuteManagedOptions, type UseExecutionOrdersOptions, type UseExecutionPositionsOptions, type UseExecutionProgressOptions, type UseExecutionProgressResult, type UseExternalIdOptions, type UseExternalIdReturn, type UseLinkAccountReturn, type UseLiveCandleOverlayOptions, type UseLiveCandleOverlayResult, type UseLiveCandlesOptions, type UseLiveCandlesResult, type UseLiveMarketResult, type UseMarketArbResult, type UseMarketChartOptions, type UseMarketChartResult, type UseMarketOrderbookOptions, type UseMarketOrderbookResult, type UseMarketOrderbookVenueOutcome, type UseMarketSearchOptions, type UseMidpointsOptions, type UseMidpointsResult, type UseOrderBookOptions, type UseOrderbookQuoteOptions, type UseOrderbookQuoteResult, type UseOrdersOptions, type UsePositionsOptions, type UseQuoteManagedOptions, type UseRedeemLifecycleInput, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSmartRouteOptions, type UseSmartRouteResult, type UseTradableVenuesResult, type UseUserActivityOptions, type UseUserHoldingsOptions, type UseVenueEventOptions, type UseVenueEventsOptions, type UseVenueMarketMidpointsOptions, type UseVenueMarketsOptions, type UseViewportMidpointsOptions, type UseVisibleIdsOptions, type UseVisibleIdsResult, type UserActivityInvalidationStrategy, Venue, type VenueAvailabilityState, type VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type WalletActionSendTokenParams, type WalletActions, buildLiveBestPriceCandidates, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, extractOutcomeBestCandidate, findLivePriceById, getBuilder, getOrCreateBuilder, getVenueAvailabilityState, getVisibleVenueIdsByConfig, getVisibleVenuesByConfig, getWalletAddressFromUserProfile, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserClaimState, invalidateUserMoneyState, isVenueDisabledByConfig, mergeBestPricesPreferringLive, normalizeVenueId, optimizedImageUrl, parseEmail, parseEmailStrict, rangeToSeconds, requestAggAuthChooserOpen, resolveAggUiLabels, resolveDefaultMarket as resolveDefaultTradingMarket, resolveEventTradingState, resolveMarketTradingState, resolveMarketWinningOutcome, resolveOrderEligibility, resolveRollingWindow, resolveTradingStateKind, sortVenues, timeRangeToInterval, tradingReducer, useAggAuth, useAggAuthContext, useAggAuthState, useAggBalance, useAggBalanceContext, useAggBalanceState, useAggClient, useAggLabels, useAggUiConfig, useAggWebSocket, useAppConfig, useArbFeed, useCachedAppConfig, useCategories, useCategoryChildren, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useLabels, useLinkAccount, useLiveBestPriceCandidates, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, useMarketArb, useMarketChart, useMarketOrderbook, useMarketSearch, useMidpoints, useOnBalanceUpdate, useOnOrderEvent, useOnOrderSubmitted, useOnRedeemEvent, useOnWithdrawalLifecycle, useOptionalAggClient, useOrderBook, useOrderbookQuote, useOrders, usePositions, useQuoteManaged, useRampQuotes, useRampSession, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSmartRoute, useTradableVenues, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueMarketMidpoints, useVenueMarkets, useViewportMidpoints, useVisibleIds, userActivityQueryKeys };

package/dist/index.d.ts

@@ -271,6 +271,12 @@ type VenueMarket = {
     sportsMarketType?: string | null | undefined;
     /** Sort rank within a sports section (0=moneyline, 1=spread, 2=total, 3+=other). */
     sectionRank?: number | null | undefined;
+    /** Period identifier for sports markets (e.g., "1H", "2H", "Q1", etc.). */
+    period?: string | null | undefined;
+    /** Normalized subject category for prop-tab grouping (e.g., game_lines, exact_score, etc.). */
+    marketCategory?: string | null | undefined;
+    /** Line value for spread/total markets (e.g., 2.5 for totals, 3 for spreads). */
+    lineValue?: number | null | undefined;
     matchedVenueMarkets?: {
         id: string;
         venue: Venue;
@@ -324,10 +330,18 @@ type VenueEvent = {
     startDate?: string | null | undefined;
     endDate?: string | null | undefined;
     creationDate?: string | null | undefined;
+    /**
+     * Scheduled kickoff/start of the underlying game (sports events only).
+     * Distinct from `endDate` (market close/expiration), which can sit well
+     * after the game. The FE prefers this over `endDate` for the game-date
+     * title suffix. Null for non-sports events.
+     */
+    gameStartTime?: string | null | undefined;
     slug?: string | null | undefined;
     subtitle?: string | null | undefined;
     venues?: Venue[];
     venueCount?: number | undefined;
+    groupMarketCount?: number | undefined;
     marketCount?: number | undefined;
     /**
      * ISO-8601 duration denormalized from Series.recurrence. `null` means
@@ -1087,6 +1101,7 @@ interface AggUiLabels {
         orderSkip: string;
         orderRetryRemaining: string;
         resolvedEarningsTitle: string;
+        resolvedResolutionDateLabel: string;
         resolvedSharesLabel: string;
         resolvedTotalPayoutLabel: string;
         claimWinnings: string;
@@ -3350,10 +3365,42 @@ declare function useLiveOutcomePrices(venueMarkets: VenueMarket[] | null | undef
  */
 declare function findLivePriceById(livePrices: Map<string, number>, id: string): number | undefined;
 
+interface MarketLiveState {
+    marketId: string;
+    orderbook: OrderbookState | null;
+    orderbookSnapshotVersion: number;
+    orderbookError: string | null;
+    trades: WsTrade[];
+    isConnected: boolean;
+    integrity: "ok" | "resyncing";
+}
+
 type LiveBestPrices = ReadonlyMap<string, {
     bestBid?: number;
     bestAsk?: number;
 }>;
+/**
+ * A WS-derived best-price candidate for one outcome, carrying the venue that
+ * produced each side *and* a freshness stamp. This is the richer companion to
+ * {@link LiveBestPrices}: it keeps the venue attribution that the bare
+ * `{ bestBid, bestAsk }` map throws away, so display surfaces can switch the
+ * venue logo to whichever venue currently owns the best live price — keeping
+ * the logo paired with the price instead of pinned to the REST snapshot.
+ */
+interface LiveBestPriceCandidate {
+    bestBid?: number;
+    bestAsk?: number;
+    /** Venue that owns the cross-venue best bid (best place to sell). */
+    bestBidVenue?: string;
+    /** Venue that owns the cross-venue best ask (cheapest place to buy). */
+    bestAskVenue?: string;
+    midpoint?: number;
+    /** Venue the midpoint is attributed to (cheapest-ask side, then best-bid). */
+    midpointVenue?: string;
+    /** Orderbook timestamp (seconds) of the freshest book backing this candidate. */
+    updatedAt?: number;
+}
+type LiveBestPriceCandidates = ReadonlyMap<string, LiveBestPriceCandidate>;
 /**
  * WS-derived cross-venue + cross-outcome best bid/ask per outcome.
  *
@@ -3381,6 +3428,35 @@ declare function mergeBestPricesPreferringLive(rest: ReadonlyMap<string, {
     bestBid?: number;
     bestAsk?: number;
 }>;
+/**
+ * Pull the per-outcome best bid/ask, attributed venues, midpoint and freshness
+ * out of a single live orderbook state. Pure — exported for unit tests.
+ */
+declare const extractOutcomeBestCandidate: (state: MarketLiveState | undefined) => LiveBestPriceCandidate;
+/**
+ * Cross-venue + cross-outcome venue-attributed best-price candidates.
+ *
+ * Pure (no React) so the cross-venue fold can be unit-tested directly:
+ *   - Pass 1: per-outcome candidate from each outcome's own aggregated book.
+ *   - Pass 2: fold across MVMO groups. Lowest ask wins (cheapest to buy),
+ *     highest bid wins (best to sell), and the *winning venue* + freshest
+ *     timestamp travel with the chosen price to every member of the group.
+ *     This is what lets a different venue's live book switch both the price
+ *     and the venue logo on every WS update.
+ *
+ * Mirrors the price fold in {@link useLiveBestPrices} and the REST fold in
+ * `useMidpoints.extractBestPrices`, but additionally tracks venue + freshness.
+ */
+declare function buildLiveBestPriceCandidates(outcomeIds: string[], states: Array<MarketLiveState | undefined>, venueMarkets: VenueMarket[] | null | undefined): Map<string, LiveBestPriceCandidate>;
+/**
+ * React hook companion to {@link useLiveBestPrices} that additionally carries
+ * venue attribution + freshness per outcome. Recomputes on every WS update
+ * (snapshot/delta) that moves price, venue ownership, or timestamp.
+ *
+ * Empty until WS books land for the subscribed outcomes. Designed to feed a
+ * unified price+venue selector so the venue logo always follows the live price.
+ */
+declare function useLiveBestPriceCandidates(venueMarkets: VenueMarket[] | null | undefined): LiveBestPriceCandidates;
 
 /**
  * Subscribe to real-time trade feed for a canonical market.
@@ -5504,4 +5580,4 @@ declare function useAppConfig(): UseAppConfigResult;
  */
 declare function useCachedAppConfig(): UseAppConfigResult;
 
-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 ExecutionTerminalOrderEvent, type GeoBlockState, type GetOrdersQuery, type GetPositionsQuery, type InvalidateUserActivityOptions, type InvalidateUserMoneyStateOptions, type LiveBestPrices, type LiveCandle, MAX_PRICE_GAP_PCT, MIN_PRICE_GAP_PCT, 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 RedeemEvent, type RedeemLegLifecycle, type RedeemLifecycleState, RedeemRejectedError, type RollingChartWindow, type ScaledCandlePoint, type SdkUiConfig, type SdkUiConfigInput, type SdkUiProviderProps, type SmartRouteLoadingReason, type ThemeMode, TradeSide, type TradingAction, type TradingState, type TradingStateBase, type TradingStateKind, type UseAggAuthOptions, type UseAggAuthReturn, type UseAppConfigResult, type UseArbFeedResult, type UseCategoriesOptions, type UseCategoryChildrenOptions, type UseEnrichedVenueEventOptions, type UseExecuteManagedOptions, type UseExecutionOrdersOptions, type UseExecutionPositionsOptions, type UseExecutionProgressOptions, type UseExecutionProgressResult, type UseExternalIdOptions, type UseExternalIdReturn, type UseLinkAccountReturn, type UseLiveCandleOverlayOptions, type UseLiveCandleOverlayResult, type UseLiveCandlesOptions, type UseLiveCandlesResult, type UseLiveMarketResult, type UseMarketArbResult, type UseMarketChartOptions, type UseMarketChartResult, type UseMarketOrderbookOptions, type UseMarketOrderbookResult, type UseMarketOrderbookVenueOutcome, type UseMarketSearchOptions, type UseMidpointsOptions, type UseMidpointsResult, type UseOrderBookOptions, type UseOrderbookQuoteOptions, type UseOrderbookQuoteResult, type UseOrdersOptions, type UsePositionsOptions, type UseQuoteManagedOptions, type UseRedeemLifecycleInput, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSmartRouteOptions, type UseSmartRouteResult, type UseTradableVenuesResult, type UseUserActivityOptions, type UseUserHoldingsOptions, type UseVenueEventOptions, type UseVenueEventsOptions, type UseVenueMarketMidpointsOptions, type UseVenueMarketsOptions, type UseViewportMidpointsOptions, type UseVisibleIdsOptions, type UseVisibleIdsResult, type UserActivityInvalidationStrategy, Venue, type VenueAvailabilityState, type VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type WalletActionSendTokenParams, type WalletActions, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, findLivePriceById, getBuilder, getOrCreateBuilder, getVenueAvailabilityState, getVisibleVenueIdsByConfig, getVisibleVenuesByConfig, getWalletAddressFromUserProfile, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserClaimState, invalidateUserMoneyState, isVenueDisabledByConfig, mergeBestPricesPreferringLive, normalizeVenueId, optimizedImageUrl, parseEmail, parseEmailStrict, rangeToSeconds, requestAggAuthChooserOpen, resolveAggUiLabels, resolveDefaultMarket as resolveDefaultTradingMarket, resolveEventTradingState, resolveMarketTradingState, resolveMarketWinningOutcome, resolveOrderEligibility, resolveRollingWindow, resolveTradingStateKind, sortVenues, timeRangeToInterval, tradingReducer, useAggAuth, useAggAuthContext, useAggAuthState, useAggBalance, useAggBalanceContext, useAggBalanceState, useAggClient, useAggLabels, useAggUiConfig, useAggWebSocket, useAppConfig, useArbFeed, useCachedAppConfig, useCategories, useCategoryChildren, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useLabels, useLinkAccount, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, useMarketArb, useMarketChart, useMarketOrderbook, useMarketSearch, useMidpoints, useOnBalanceUpdate, useOnOrderEvent, useOnOrderSubmitted, useOnRedeemEvent, useOnWithdrawalLifecycle, useOptionalAggClient, useOrderBook, useOrderbookQuote, useOrders, usePositions, useQuoteManaged, useRampQuotes, useRampSession, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSmartRoute, useTradableVenues, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueMarketMidpoints, useVenueMarkets, useViewportMidpoints, useVisibleIds, userActivityQueryKeys };
+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 ExecutionTerminalOrderEvent, type GeoBlockState, type GetOrdersQuery, type GetPositionsQuery, type InvalidateUserActivityOptions, type InvalidateUserMoneyStateOptions, type LiveBestPriceCandidate, type LiveBestPriceCandidates, type LiveBestPrices, type LiveCandle, MAX_PRICE_GAP_PCT, MIN_PRICE_GAP_PCT, 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 RedeemEvent, type RedeemLegLifecycle, type RedeemLifecycleState, RedeemRejectedError, type RollingChartWindow, type ScaledCandlePoint, type SdkUiConfig, type SdkUiConfigInput, type SdkUiProviderProps, type SmartRouteLoadingReason, type ThemeMode, TradeSide, type TradingAction, type TradingState, type TradingStateBase, type TradingStateKind, type UseAggAuthOptions, type UseAggAuthReturn, type UseAppConfigResult, type UseArbFeedResult, type UseCategoriesOptions, type UseCategoryChildrenOptions, type UseEnrichedVenueEventOptions, type UseExecuteManagedOptions, type UseExecutionOrdersOptions, type UseExecutionPositionsOptions, type UseExecutionProgressOptions, type UseExecutionProgressResult, type UseExternalIdOptions, type UseExternalIdReturn, type UseLinkAccountReturn, type UseLiveCandleOverlayOptions, type UseLiveCandleOverlayResult, type UseLiveCandlesOptions, type UseLiveCandlesResult, type UseLiveMarketResult, type UseMarketArbResult, type UseMarketChartOptions, type UseMarketChartResult, type UseMarketOrderbookOptions, type UseMarketOrderbookResult, type UseMarketOrderbookVenueOutcome, type UseMarketSearchOptions, type UseMidpointsOptions, type UseMidpointsResult, type UseOrderBookOptions, type UseOrderbookQuoteOptions, type UseOrderbookQuoteResult, type UseOrdersOptions, type UsePositionsOptions, type UseQuoteManagedOptions, type UseRedeemLifecycleInput, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSmartRouteOptions, type UseSmartRouteResult, type UseTradableVenuesResult, type UseUserActivityOptions, type UseUserHoldingsOptions, type UseVenueEventOptions, type UseVenueEventsOptions, type UseVenueMarketMidpointsOptions, type UseVenueMarketsOptions, type UseViewportMidpointsOptions, type UseVisibleIdsOptions, type UseVisibleIdsResult, type UserActivityInvalidationStrategy, Venue, type VenueAvailabilityState, type VenueEvent, type VenueEventWithMarkets, type VenueMarket, type VenueMarketOutcome, type WalletActionSendTokenParams, type WalletActions, buildLiveBestPriceCandidates, computeClosedPositionTotals, computePriceGaps, defaultAggUiConfig, defaultAggUiConfig as defaultSdkUiConfig, executionKeys, extractOutcomeBestCandidate, findLivePriceById, getBuilder, getOrCreateBuilder, getVenueAvailabilityState, getVisibleVenueIdsByConfig, getVisibleVenuesByConfig, getWalletAddressFromUserProfile, invalidateBalanceQueries, invalidatePositionQueries, invalidateUserActivityQueries, invalidateUserClaimState, invalidateUserMoneyState, isVenueDisabledByConfig, mergeBestPricesPreferringLive, normalizeVenueId, optimizedImageUrl, parseEmail, parseEmailStrict, rangeToSeconds, requestAggAuthChooserOpen, resolveAggUiLabels, resolveDefaultMarket as resolveDefaultTradingMarket, resolveEventTradingState, resolveMarketTradingState, resolveMarketWinningOutcome, resolveOrderEligibility, resolveRollingWindow, resolveTradingStateKind, sortVenues, timeRangeToInterval, tradingReducer, useAggAuth, useAggAuthContext, useAggAuthState, useAggBalance, useAggBalanceContext, useAggBalanceState, useAggClient, useAggLabels, useAggUiConfig, useAggWebSocket, useAppConfig, useArbFeed, useCachedAppConfig, useCategories, useCategoryChildren, useDebouncedValue, useEnrichedVenueEvent, useEventListState, useEventOrderbookData, useEventTradingContext, useExecuteManaged, useExecutionOrders, useExecutionPositions, useExecutionProgress, useExternalId, useGeoBlock, useLabels, useLinkAccount, useLiveBestPriceCandidates, useLiveBestPrices, useLiveCandleOverlay, useLiveCandles, useLiveMarket, useLiveMarketStores, useLiveOutcomePrices, useLiveTrades, useMarketArb, useMarketChart, useMarketOrderbook, useMarketSearch, useMidpoints, useOnBalanceUpdate, useOnOrderEvent, useOnOrderSubmitted, useOnRedeemEvent, useOnWithdrawalLifecycle, useOptionalAggClient, useOrderBook, useOrderbookQuote, useOrders, usePositions, useQuoteManaged, useRampQuotes, useRampSession, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSmartRoute, useTradableVenues, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueMarketMidpoints, useVenueMarkets, useViewportMidpoints, useVisibleIds, userActivityQueryKeys };

package/dist/index.js

@@ -90,11 +90,13 @@ __export(src_exports, {
   TradeSide: () => TradeSide,
   TurnstileChallengeError: () => import_sdk4.TurnstileChallengeError,
   Venue: () => Venue,
+  buildLiveBestPriceCandidates: () => buildLiveBestPriceCandidates,
   computeClosedPositionTotals: () => computeClosedPositionTotals,
   computePriceGaps: () => computePriceGaps,
   defaultAggUiConfig: () => defaultAggUiConfig,
   defaultSdkUiConfig: () => defaultAggUiConfig,
   executionKeys: () => executionKeys,
+  extractOutcomeBestCandidate: () => extractOutcomeBestCandidate,
   findLivePriceById: () => findLivePriceById,
   getBuilder: () => getBuilder,
   getDepositAddress: () => getDepositAddress,
@@ -156,6 +158,7 @@ __export(src_exports, {
   useGeoBlock: () => useGeoBlock,
   useLabels: () => useLabels,
   useLinkAccount: () => useLinkAccount,
+  useLiveBestPriceCandidates: () => useLiveBestPriceCandidates,
   useLiveBestPrices: () => useLiveBestPrices,
   useLiveCandleOverlay: () => useLiveCandleOverlay,
   useLiveCandles: () => useLiveCandles,
@@ -1155,6 +1158,7 @@ var enUsLabels = {
     orderSkip: "Skip",
     orderRetryRemaining: "Retry remaining",
     resolvedEarningsTitle: "Your Earnings",
+    resolvedResolutionDateLabel: "Resolution date",
     resolvedSharesLabel: "Shares",
     resolvedTotalPayoutLabel: "Total payout",
     claimWinnings: "Claim Winnings",
@@ -2519,6 +2523,98 @@ var applyOrderbookDepth = (data, depth) => {
   });
 };
 
+// src/market-data/market-resolution-cache.ts
+var isRecord = (value) => {
+  return typeof value === "object" && value !== null;
+};
+var NESTED_COLLECTION_FIELDS = ["pages", "data", "markets", "events", "venueMarkets"];
+var marketContainsOutcomeId = (market, outcomeId) => {
+  if (!isRecord(market)) return false;
+  const outcomes = market.venueMarketOutcomes;
+  if (!Array.isArray(outcomes)) return false;
+  return outcomes.some((outcome) => isRecord(outcome) && outcome.id === outcomeId);
+};
+var cachedDataContainsOutcomeId = (data, outcomeId) => {
+  if (Array.isArray(data)) {
+    return data.some((entry) => cachedDataContainsOutcomeId(entry, outcomeId));
+  }
+  if (!isRecord(data)) return false;
+  if (marketContainsOutcomeId(data, outcomeId)) return true;
+  return NESTED_COLLECTION_FIELDS.some((field) => {
+    const value = data[field];
+    return Array.isArray(value) && value.some((entry) => cachedDataContainsOutcomeId(entry, outcomeId));
+  });
+};
+var normalizeLabel = (label) => {
+  return typeof label === "string" ? label.trim().toLowerCase() : "";
+};
+var findResolvedOutcome = (resolvedOutcomes, outcome) => {
+  var _a;
+  const externalIdentifier = outcome.externalIdentifier;
+  if (typeof externalIdentifier === "string" && externalIdentifier.length > 0) {
+    const matchedByExternalId = resolvedOutcomes.find(
+      (resolved) => resolved.externalIdentifier === externalIdentifier
+    );
+    if (matchedByExternalId) return matchedByExternalId;
+  }
+  const label = normalizeLabel(outcome.label);
+  if (label) {
+    return (_a = resolvedOutcomes.find((resolved) => normalizeLabel(resolved.label) === label)) != null ? _a : null;
+  }
+  return null;
+};
+var applyWinnersToOutcomes = (outcomes, resolution) => {
+  let changed = false;
+  const next = outcomes.map((outcome) => {
+    if (!isRecord(outcome)) return outcome;
+    const resolved = findResolvedOutcome(resolution.outcomes, outcome);
+    if (!resolved) return outcome;
+    const nextWinner = resolved.winner === true;
+    if (outcome.winner === nextWinner) return outcome;
+    changed = true;
+    return __spreadProps(__spreadValues({}, outcome), { winner: nextWinner });
+  });
+  return changed ? next : outcomes;
+};
+var applyResolutionToMarket = (market, resolution) => {
+  const outcomes = market.venueMarketOutcomes;
+  if (!Array.isArray(outcomes)) return market;
+  if (!outcomes.some((outcome) => isRecord(outcome) && outcome.id === resolution.outcomeId)) {
+    return market;
+  }
+  const nextOutcomes = applyWinnersToOutcomes(outcomes, resolution);
+  const statusChanged = market.status !== resolution.status;
+  if (!statusChanged && nextOutcomes === outcomes) return market;
+  return __spreadProps(__spreadValues({}, market), { status: resolution.status, venueMarketOutcomes: nextOutcomes });
+};
+var applyResolutionToCachedData = (data, resolution) => {
+  if (Array.isArray(data)) {
+    let changed2 = false;
+    const next2 = data.map((entry) => {
+      const updated = applyResolutionToCachedData(entry, resolution);
+      if (updated !== entry) changed2 = true;
+      return updated;
+    });
+    return changed2 ? next2 : data;
+  }
+  if (!isRecord(data)) return data;
+  if (Array.isArray(data.venueMarketOutcomes)) {
+    return applyResolutionToMarket(data, resolution);
+  }
+  let changed = false;
+  const next = __spreadValues({}, data);
+  for (const field of NESTED_COLLECTION_FIELDS) {
+    const value = data[field];
+    if (!Array.isArray(value)) continue;
+    const updated = applyResolutionToCachedData(value, resolution);
+    if (updated !== value) {
+      next[field] = updated;
+      changed = true;
+    }
+  }
+  return changed ? next : data;
+};
+
 // src/market-data/query-keys.ts
 var marketDataKeys = {
   all: () => ["market-data"],
@@ -2786,6 +2882,62 @@ function AggWebSocketProvider({ children }) {
   const invalidateActivityCaches = (0, import_react6.useCallback)(() => {
     invalidateUserActivityQueries(queryClient);
   }, [queryClient]);
+  const invalidateResolutionCaches = (0, import_react6.useCallback)(
+    (resolution) => {
+      const { outcomeId } = resolution;
+      syncLiveQuery(outcomeId, (previous) => {
+        if (!previous) return previous;
+        if (previous.orderbook == null && previous.orderbookError == null) return previous;
+        return __spreadProps(__spreadValues({}, previous), {
+          orderbook: null,
+          orderbookError: null,
+          integrity: "ok"
+        });
+      });
+      const affectedQueries = queryClient.getQueryCache().findAll({
+        predicate: (query) => cachedDataContainsOutcomeId(query.state.data, outcomeId)
+      });
+      for (const query of affectedQueries) {
+        queryClient.setQueryData(
+          query.queryKey,
+          (previous) => applyResolutionToCachedData(previous, resolution)
+        );
+      }
+      queryClient.invalidateQueries({
+        queryKey: ["midpoints"],
+        refetchType: "all"
+      });
+      queryClient.invalidateQueries({
+        queryKey: ["venue-market-midpoints"],
+        refetchType: "all"
+      });
+      queryClient.invalidateQueries({
+        queryKey: ["venue-event"],
+        refetchType: "all"
+      });
+      queryClient.invalidateQueries({
+        queryKey: ["venue-markets"],
+        refetchType: "all"
+      });
+      queryClient.invalidateQueries({
+        queryKey: ["events"],
+        refetchType: "all"
+      });
+      queryClient.invalidateQueries({
+        queryKey: ["event-list"],
+        refetchType: "all"
+      });
+      queryClient.invalidateQueries({
+        queryKey: ["search"],
+        refetchType: "all"
+      });
+      queryClient.invalidateQueries({
+        predicate: (query) => cachedDataContainsOutcomeId(query.state.data, outcomeId),
+        refetchType: "all"
+      });
+    },
+    [queryClient, syncLiveQuery]
+  );
   const callbacks = (0, import_react6.useMemo)(
     () => ({
       onSnapshot: (marketId, book) => {
@@ -2934,6 +3086,14 @@ function AggWebSocketProvider({ children }) {
           listener(msg);
         }
       },
+      onMarketResolved: (msg) => {
+        invalidateResolutionCaches(msg);
+        if (isClientAuthenticated) {
+          invalidateBalanceCaches();
+          invalidatePositionCaches();
+          invalidateActivityCaches();
+        }
+      },
       onError: (msg) => {
         const outcomeId = resolveSnapshotUnavailableOutcomeId(msg.message);
         if (!outcomeId) return;
@@ -2971,6 +3131,7 @@ function AggWebSocketProvider({ children }) {
       invalidateActivityCaches,
       invalidateBalanceCaches,
       invalidatePositionCaches,
+      invalidateResolutionCaches,
       isClientAuthenticated,
       queryClient,
       syncChartQueries,
@@ -5806,6 +5967,7 @@ function findLivePriceById(livePrices, id) {
 var import_react27 = require("react");
 var import_react_query25 = require("@tanstack/react-query");
 var EMPTY = /* @__PURE__ */ new Map();
+var EMPTY_CANDIDATES = /* @__PURE__ */ new Map();
 var extractOutcomeBestPrices = (state) => {
   var _a, _b;
   const ob = state == null ? void 0 : state.orderbook;
@@ -5923,6 +6085,175 @@ function mergeBestPricesPreferringLive(rest, live) {
   }
   return merged;
 }
+var pickSideVenue = (venues, level, side) => {
+  if (venues) {
+    let bestVenue;
+    let bestValue;
+    for (const [venue, info] of Object.entries(venues)) {
+      const value = side === "bid" ? info.bestBid : info.bestAsk;
+      if (value == null) continue;
+      const wins = bestValue == null || (side === "bid" ? value > bestValue : value < bestValue);
+      if (wins) {
+        bestValue = value;
+        bestVenue = venue;
+      }
+    }
+    if (bestVenue != null) return bestVenue;
+  }
+  if (level == null ? void 0 : level.venues) {
+    let bestVenue;
+    let bestSize = -Infinity;
+    for (const [venue, size] of Object.entries(level.venues)) {
+      if (size > bestSize) {
+        bestSize = size;
+        bestVenue = venue;
+      }
+    }
+    if (bestVenue != null) return bestVenue;
+  }
+  return void 0;
+};
+var extractOutcomeBestCandidate = (state) => {
+  var _a;
+  const ob = state == null ? void 0 : state.orderbook;
+  if (!ob) return {};
+  const candidate = {};
+  const bidLevel = ob.bids[0];
+  const askLevel = ob.asks[0];
+  if ((bidLevel == null ? void 0 : bidLevel.price) != null) {
+    candidate.bestBid = bidLevel.price;
+    const venue = pickSideVenue(ob.venues, bidLevel, "bid");
+    if (venue) candidate.bestBidVenue = venue;
+  }
+  if ((askLevel == null ? void 0 : askLevel.price) != null) {
+    candidate.bestAsk = askLevel.price;
+    const venue = pickSideVenue(ob.venues, askLevel, "ask");
+    if (venue) candidate.bestAskVenue = venue;
+  }
+  if (ob.midpoint != null) {
+    candidate.midpoint = ob.midpoint;
+    const midVenue = (_a = candidate.bestAskVenue) != null ? _a : candidate.bestBidVenue;
+    if (midVenue) candidate.midpointVenue = midVenue;
+  }
+  if (ob.timestamp != null) candidate.updatedAt = ob.timestamp;
+  return candidate;
+};
+function buildLiveBestPriceCandidates(outcomeIds, states, venueMarkets) {
+  var _a, _b, _c;
+  const perOutcome = /* @__PURE__ */ new Map();
+  for (let i = 0; i < outcomeIds.length; i++) {
+    const candidate = extractOutcomeBestCandidate(states[i]);
+    if (candidate.bestBid != null || candidate.bestAsk != null || candidate.midpoint != null) {
+      perOutcome.set(outcomeIds[i], candidate);
+    }
+  }
+  if (perOutcome.size === 0 || !(venueMarkets == null ? void 0 : venueMarkets.length)) {
+    return perOutcome;
+  }
+  const result = new Map(perOutcome);
+  for (const vm of venueMarkets) {
+    for (const outcome of (_a = vm.venueMarketOutcomes) != null ? _a : []) {
+      const refs = (_b = outcome.matchedVenueMarketOutcomes) != null ? _b : [];
+      if (!refs.length) continue;
+      const group = [outcome.id, ...refs.map((ref) => ref.venueMarketOutcomeId)];
+      let groupBestAsk;
+      let groupBestAskVenue;
+      let groupBestBid;
+      let groupBestBidVenue;
+      let groupUpdatedAt;
+      for (const id of group) {
+        const entry = perOutcome.get(id);
+        if (!entry) continue;
+        if (entry.bestAsk != null && (groupBestAsk == null || entry.bestAsk < groupBestAsk)) {
+          groupBestAsk = entry.bestAsk;
+          groupBestAskVenue = entry.bestAskVenue;
+        }
+        if (entry.bestBid != null && (groupBestBid == null || entry.bestBid > groupBestBid)) {
+          groupBestBid = entry.bestBid;
+          groupBestBidVenue = entry.bestBidVenue;
+        }
+        if (entry.updatedAt != null && (groupUpdatedAt == null || entry.updatedAt > groupUpdatedAt)) {
+          groupUpdatedAt = entry.updatedAt;
+        }
+      }
+      if (groupBestAsk == null && groupBestBid == null) continue;
+      for (const id of group) {
+        const prev = (_c = result.get(id)) != null ? _c : {};
+        const next = __spreadValues({}, prev);
+        if (groupBestBid != null) {
+          next.bestBid = groupBestBid;
+          if (groupBestBidVenue) next.bestBidVenue = groupBestBidVenue;
+        }
+        if (groupBestAsk != null) {
+          next.bestAsk = groupBestAsk;
+          if (groupBestAskVenue) next.bestAskVenue = groupBestAskVenue;
+        }
+        if (groupUpdatedAt != null) next.updatedAt = groupUpdatedAt;
+        result.set(id, next);
+      }
+    }
+  }
+  return result;
+}
+var buildCandidateFingerprint = (outcomeIds, queries) => {
+  var _a, _b, _c, _d;
+  const parts = [];
+  for (let i = 0; i < outcomeIds.length; i++) {
+    const ob = (_b = (_a = queries[i]) == null ? void 0 : _a.data) == null ? void 0 : _b.orderbook;
+    const bid = (_c = ob == null ? void 0 : ob.bids[0]) == null ? void 0 : _c.price;
+    const ask = (_d = ob == null ? void 0 : ob.asks[0]) == null ? void 0 : _d.price;
+    const mid = ob == null ? void 0 : ob.midpoint;
+    const ts = ob == null ? void 0 : ob.timestamp;
+    const venues = (ob == null ? void 0 : ob.venues) ? Object.keys(ob.venues).sort().join(",") : "";
+    parts.push(`${outcomeIds[i]}:${bid != null ? bid : "_"}:${ask != null ? ask : "_"}:${mid != null ? mid : "_"}:${ts != null ? ts : "_"}:${venues}`);
+  }
+  return parts.join("|");
+};
+function useLiveBestPriceCandidates(venueMarkets) {
+  const {
+    features: { enableLiveUpdates }
+  } = useAggUiConfig();
+  const outcomeIds = (0, import_react27.useMemo)(() => {
+    var _a, _b;
+    if (!(venueMarkets == null ? void 0 : venueMarkets.length)) return [];
+    const ids = /* @__PURE__ */ new Set();
+    for (const vm of venueMarkets) {
+      for (const outcome of (_a = vm.venueMarketOutcomes) != null ? _a : []) {
+        if (outcome.id) ids.add(outcome.id);
+        for (const ref of (_b = outcome.matchedVenueMarketOutcomes) != null ? _b : []) {
+          if (ref.venueMarketOutcomeId) ids.add(ref.venueMarketOutcomeId);
+        }
+      }
+    }
+    return [...ids].sort();
+  }, [venueMarkets]);
+  const queries = (0, import_react_query25.useQueries)({
+    queries: outcomeIds.map((id) => ({
+      queryKey: marketDataKeys.live(id),
+      queryFn: () => createMarketLiveState(id),
+      enabled: false,
+      staleTime: Infinity,
+      gcTime: 5 * 6e4,
+      initialData: () => createMarketLiveState(id)
+    }))
+  });
+  const fingerprint = buildCandidateFingerprint(outcomeIds, queries);
+  const prevRef = (0, import_react27.useRef)({
+    fingerprint: "",
+    result: EMPTY_CANDIDATES
+  });
+  return (0, import_react27.useMemo)(() => {
+    if (!(venueMarkets == null ? void 0 : venueMarkets.length) || !enableLiveUpdates) return EMPTY_CANDIDATES;
+    if (fingerprint === prevRef.current.fingerprint) return prevRef.current.result;
+    const states = outcomeIds.map((_, i) => {
+      var _a;
+      return (_a = queries[i]) == null ? void 0 : _a.data;
+    });
+    const result = buildLiveBestPriceCandidates(outcomeIds, states, venueMarkets);
+    prevRef.current = { fingerprint, result };
+    return result;
+  }, [venueMarkets, enableLiveUpdates, fingerprint, outcomeIds, queries]);
+}
 
 // src/use-live-trades.ts
 function useLiveTrades(canonicalMarketId) {
@@ -7461,11 +7792,13 @@ var toAppConfigResult = (query) => {
   TradeSide,
   TurnstileChallengeError,
   Venue,
+  buildLiveBestPriceCandidates,
   computeClosedPositionTotals,
   computePriceGaps,
   defaultAggUiConfig,
   defaultSdkUiConfig,
   executionKeys,
+  extractOutcomeBestCandidate,
   findLivePriceById,
   getBuilder,
   getDepositAddress,
@@ -7527,6 +7860,7 @@ var toAppConfigResult = (query) => {
   useGeoBlock,
   useLabels,
   useLinkAccount,
+  useLiveBestPriceCandidates,
   useLiveBestPrices,
   useLiveCandleOverlay,
   useLiveCandles,

package/dist/index.mjs

@@ -1,13 +1,13 @@
 import {
   useRampQuotes,
   useRampSession
-} from "./chunk-AFZD3GIQ.mjs";
+} from "./chunk-5VDUIUJB.mjs";
 import {
   useWithdrawEstimate,
   useWithdrawFlow,
   useWithdrawPreview,
   useWithdrawalLifecycle
-} from "./chunk-5P53A3NQ.mjs";
+} from "./chunk-FBYQBFFR.mjs";
 import {
   AggAuthContext,
   AggBalanceProvider,
@@ -95,7 +95,7 @@ import {
   useSyncBalances,
   useWithdrawManaged,
   userActivityQueryKeys
-} from "./chunk-FYEPQHKO.mjs";
+} from "./chunk-7UDYSDKQ.mjs";
 
 // src/index.ts
 import { QueryClient as QueryClient4, QueryClientProvider, useQueryClient as useQueryClient3 } from "@tanstack/react-query";
@@ -1003,6 +1003,7 @@ function findLivePriceById(livePrices, id) {
 import { useMemo as useMemo7, useRef as useRef3 } from "react";
 import { useQueries as useQueries4 } from "@tanstack/react-query";
 var EMPTY = /* @__PURE__ */ new Map();
+var EMPTY_CANDIDATES = /* @__PURE__ */ new Map();
 var extractOutcomeBestPrices = (state) => {
   var _a, _b;
   const ob = state == null ? void 0 : state.orderbook;
@@ -1120,6 +1121,175 @@ function mergeBestPricesPreferringLive(rest, live) {
   }
   return merged;
 }
+var pickSideVenue = (venues, level, side) => {
+  if (venues) {
+    let bestVenue;
+    let bestValue;
+    for (const [venue, info] of Object.entries(venues)) {
+      const value = side === "bid" ? info.bestBid : info.bestAsk;
+      if (value == null) continue;
+      const wins = bestValue == null || (side === "bid" ? value > bestValue : value < bestValue);
+      if (wins) {
+        bestValue = value;
+        bestVenue = venue;
+      }
+    }
+    if (bestVenue != null) return bestVenue;
+  }
+  if (level == null ? void 0 : level.venues) {
+    let bestVenue;
+    let bestSize = -Infinity;
+    for (const [venue, size] of Object.entries(level.venues)) {
+      if (size > bestSize) {
+        bestSize = size;
+        bestVenue = venue;
+      }
+    }
+    if (bestVenue != null) return bestVenue;
+  }
+  return void 0;
+};
+var extractOutcomeBestCandidate = (state) => {
+  var _a;
+  const ob = state == null ? void 0 : state.orderbook;
+  if (!ob) return {};
+  const candidate = {};
+  const bidLevel = ob.bids[0];
+  const askLevel = ob.asks[0];
+  if ((bidLevel == null ? void 0 : bidLevel.price) != null) {
+    candidate.bestBid = bidLevel.price;
+    const venue = pickSideVenue(ob.venues, bidLevel, "bid");
+    if (venue) candidate.bestBidVenue = venue;
+  }
+  if ((askLevel == null ? void 0 : askLevel.price) != null) {
+    candidate.bestAsk = askLevel.price;
+    const venue = pickSideVenue(ob.venues, askLevel, "ask");
+    if (venue) candidate.bestAskVenue = venue;
+  }
+  if (ob.midpoint != null) {
+    candidate.midpoint = ob.midpoint;
+    const midVenue = (_a = candidate.bestAskVenue) != null ? _a : candidate.bestBidVenue;
+    if (midVenue) candidate.midpointVenue = midVenue;
+  }
+  if (ob.timestamp != null) candidate.updatedAt = ob.timestamp;
+  return candidate;
+};
+function buildLiveBestPriceCandidates(outcomeIds, states, venueMarkets) {
+  var _a, _b, _c;
+  const perOutcome = /* @__PURE__ */ new Map();
+  for (let i = 0; i < outcomeIds.length; i++) {
+    const candidate = extractOutcomeBestCandidate(states[i]);
+    if (candidate.bestBid != null || candidate.bestAsk != null || candidate.midpoint != null) {
+      perOutcome.set(outcomeIds[i], candidate);
+    }
+  }
+  if (perOutcome.size === 0 || !(venueMarkets == null ? void 0 : venueMarkets.length)) {
+    return perOutcome;
+  }
+  const result = new Map(perOutcome);
+  for (const vm of venueMarkets) {
+    for (const outcome of (_a = vm.venueMarketOutcomes) != null ? _a : []) {
+      const refs = (_b = outcome.matchedVenueMarketOutcomes) != null ? _b : [];
+      if (!refs.length) continue;
+      const group = [outcome.id, ...refs.map((ref) => ref.venueMarketOutcomeId)];
+      let groupBestAsk;
+      let groupBestAskVenue;
+      let groupBestBid;
+      let groupBestBidVenue;
+      let groupUpdatedAt;
+      for (const id of group) {
+        const entry = perOutcome.get(id);
+        if (!entry) continue;
+        if (entry.bestAsk != null && (groupBestAsk == null || entry.bestAsk < groupBestAsk)) {
+          groupBestAsk = entry.bestAsk;
+          groupBestAskVenue = entry.bestAskVenue;
+        }
+        if (entry.bestBid != null && (groupBestBid == null || entry.bestBid > groupBestBid)) {
+          groupBestBid = entry.bestBid;
+          groupBestBidVenue = entry.bestBidVenue;
+        }
+        if (entry.updatedAt != null && (groupUpdatedAt == null || entry.updatedAt > groupUpdatedAt)) {
+          groupUpdatedAt = entry.updatedAt;
+        }
+      }
+      if (groupBestAsk == null && groupBestBid == null) continue;
+      for (const id of group) {
+        const prev = (_c = result.get(id)) != null ? _c : {};
+        const next = __spreadValues({}, prev);
+        if (groupBestBid != null) {
+          next.bestBid = groupBestBid;
+          if (groupBestBidVenue) next.bestBidVenue = groupBestBidVenue;
+        }
+        if (groupBestAsk != null) {
+          next.bestAsk = groupBestAsk;
+          if (groupBestAskVenue) next.bestAskVenue = groupBestAskVenue;
+        }
+        if (groupUpdatedAt != null) next.updatedAt = groupUpdatedAt;
+        result.set(id, next);
+      }
+    }
+  }
+  return result;
+}
+var buildCandidateFingerprint = (outcomeIds, queries) => {
+  var _a, _b, _c, _d;
+  const parts = [];
+  for (let i = 0; i < outcomeIds.length; i++) {
+    const ob = (_b = (_a = queries[i]) == null ? void 0 : _a.data) == null ? void 0 : _b.orderbook;
+    const bid = (_c = ob == null ? void 0 : ob.bids[0]) == null ? void 0 : _c.price;
+    const ask = (_d = ob == null ? void 0 : ob.asks[0]) == null ? void 0 : _d.price;
+    const mid = ob == null ? void 0 : ob.midpoint;
+    const ts = ob == null ? void 0 : ob.timestamp;
+    const venues = (ob == null ? void 0 : ob.venues) ? Object.keys(ob.venues).sort().join(",") : "";
+    parts.push(`${outcomeIds[i]}:${bid != null ? bid : "_"}:${ask != null ? ask : "_"}:${mid != null ? mid : "_"}:${ts != null ? ts : "_"}:${venues}`);
+  }
+  return parts.join("|");
+};
+function useLiveBestPriceCandidates(venueMarkets) {
+  const {
+    features: { enableLiveUpdates }
+  } = useAggUiConfig();
+  const outcomeIds = useMemo7(() => {
+    var _a, _b;
+    if (!(venueMarkets == null ? void 0 : venueMarkets.length)) return [];
+    const ids = /* @__PURE__ */ new Set();
+    for (const vm of venueMarkets) {
+      for (const outcome of (_a = vm.venueMarketOutcomes) != null ? _a : []) {
+        if (outcome.id) ids.add(outcome.id);
+        for (const ref of (_b = outcome.matchedVenueMarketOutcomes) != null ? _b : []) {
+          if (ref.venueMarketOutcomeId) ids.add(ref.venueMarketOutcomeId);
+        }
+      }
+    }
+    return [...ids].sort();
+  }, [venueMarkets]);
+  const queries = useQueries4({
+    queries: outcomeIds.map((id) => ({
+      queryKey: marketDataKeys.live(id),
+      queryFn: () => createMarketLiveState(id),
+      enabled: false,
+      staleTime: Infinity,
+      gcTime: 5 * 6e4,
+      initialData: () => createMarketLiveState(id)
+    }))
+  });
+  const fingerprint = buildCandidateFingerprint(outcomeIds, queries);
+  const prevRef = useRef3({
+    fingerprint: "",
+    result: EMPTY_CANDIDATES
+  });
+  return useMemo7(() => {
+    if (!(venueMarkets == null ? void 0 : venueMarkets.length) || !enableLiveUpdates) return EMPTY_CANDIDATES;
+    if (fingerprint === prevRef.current.fingerprint) return prevRef.current.result;
+    const states = outcomeIds.map((_, i) => {
+      var _a;
+      return (_a = queries[i]) == null ? void 0 : _a.data;
+    });
+    const result = buildLiveBestPriceCandidates(outcomeIds, states, venueMarkets);
+    prevRef.current = { fingerprint, result };
+    return result;
+  }, [venueMarkets, enableLiveUpdates, fingerprint, outcomeIds, queries]);
+}
 
 // src/use-live-trades.ts
 function useLiveTrades(canonicalMarketId) {
@@ -2667,11 +2837,13 @@ export {
   TradeSide,
   TurnstileChallengeError,
   Venue,
+  buildLiveBestPriceCandidates,
   computeClosedPositionTotals,
   computePriceGaps,
   defaultAggUiConfig,
   defaultAggUiConfig as defaultSdkUiConfig,
   executionKeys,
+  extractOutcomeBestCandidate,
   findLivePriceById,
   getBuilder,
   getDepositAddress,
@@ -2733,6 +2905,7 @@ export {
   useGeoBlock,
   useLabels,
   useLinkAccount,
+  useLiveBestPriceCandidates,
   useLiveBestPrices,
   useLiveCandleOverlay,
   useLiveCandles,

package/dist/withdraw.js

@@ -702,6 +702,7 @@ var enUsLabels = {
     orderSkip: "Skip",
     orderRetryRemaining: "Retry remaining",
     resolvedEarningsTitle: "Your Earnings",
+    resolvedResolutionDateLabel: "Resolution date",
     resolvedSharesLabel: "Shares",
     resolvedTotalPayoutLabel: "Total payout",
     claimWinnings: "Claim Winnings",

package/dist/withdraw.mjs

@@ -3,12 +3,12 @@ import {
   useWithdrawFlow,
   useWithdrawPreview,
   useWithdrawalLifecycle
-} from "./chunk-5P53A3NQ.mjs";
+} from "./chunk-FBYQBFFR.mjs";
 import {
   useDepositAddresses,
   useManagedBalances,
   useWithdrawManaged
-} from "./chunk-FYEPQHKO.mjs";
+} from "./chunk-7UDYSDKQ.mjs";
 export {
   useDepositAddresses,
   useManagedBalances,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/hooks",
-  "version": "2.1.1",
+  "version": "2.1.2",
   "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": "^2.1.0"
+    "@agg-build/sdk": "^2.1.2"
   },
   "peerDependenciesMeta": {
     "@solana/wallet-adapter-react": {