@agg-build/hooks 2.4.6 → 2.5.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, QuoteManagedResponse, QuoteManagedParams, ExecuteManagedResponse, ExecuteManagedParams, GetPositionsParams, WsOrderSubmitted, WsBalanceUpdate, RedeemResponse, RedeemRequest, WsRedeemEvent, AggWebSocket, WsOrderEvent, WsWithdrawalLifecycleEvent, WsCandleInterval, WsTrade, AggregatedOrderbookResponse, AggLinkAccountBody, AggLinkAccountResult, AggLinkAccountConfirmResult, Category, UserActivityQuery, UserActivityItem, PaginatedResponse, CandleInterval, OrderbookState, OrderbookQuoteResponse, OrderListQuery, TradeExecutorOrder, SmartRouteSide, ExecutionMode, SmartRouteResponse, RecurrenceFilter, MidpointRow, BatchMidpointsResponse, AppClientConfigResponse } from '@agg-build/sdk';
+import { CandleBuilder, AggAuthStartBody, AggAuthStartResult, AggClientSessionInput, AggClient, RampQuote, RampQuoteRequest, RampWidgetSession, RampSessionRequest, QuoteManagedResponse, QuoteManagedParams, ExecuteManagedResponse, ExecuteManagedParams, PlaceLimitOrderResponse, PlaceLimitOrderParams, CancelManagedExecutionResponse, GetPositionsParams, WsOrderSubmitted, WsBalanceUpdate, RedeemResponse, RedeemRequest, WsRedeemEvent, AggWebSocket, WsOrderEvent, WsWithdrawalLifecycleEvent, WsCandleInterval, WsTrade, AggregatedOrderbookResponse, AggLinkAccountBody, AggLinkAccountResult, AggLinkAccountConfirmResult, Category, UserActivityQuery, UserActivityItem, PaginatedResponse, CandleInterval, OrderbookState, OrderbookQuoteResponse, OrderListQuery, TradeExecutorOrder, SmartRouteSide, ExecutionMode, SmartRouteResponse, RecurrenceFilter, MidpointRow, BatchMidpointsResponse, AppClientConfigResponse } from '@agg-build/sdk';
 export { 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';
@@ -78,6 +78,14 @@ declare enum OrderStatus {
     expired = "expired",
     cancelled = "cancelled"
 }
+declare enum TimeInForce {
+    GTC = "GTC",
+    GTD = "GTD",
+    FOK = "FOK",
+    FAK = "FAK",
+    IOC = "IOC",
+    ALO = "ALO"
+}
 
 /**
  * Standalone type definitions — no Zod dependency.
@@ -108,6 +116,17 @@ type UserProfile = {
     }[] | null;
 };
 type PriceSource = "orderbook" | "cached" | "entry" | "settled";
+/**
+ * Health of the orderbook a position was marked against — passthrough of
+ * the engine's `BookQuality` verdict. `priceSource` says where a mark came
+ * from; this says whether that source was trustworthy. Anything other than
+ * `healthy` is a low-confidence mark.
+ *
+ * Read `priceSource` first — this only qualifies book-derived marks. A
+ * `settled` position is exact (1/0) and consults no book, so it reports
+ * `empty`; that is not a confidence signal.
+ */
+type BookQuality = "healthy" | "wide_spread" | "bid_only" | "ask_only" | "endpoint_stub" | "crossed" | "empty";
 type UnifiedBalanceResponse = {
     cash: {
         tokenSymbol: string;
@@ -161,6 +180,20 @@ type OrderListItem = {
     venue: Venue;
     side: string;
     amountRaw: string;
+    orderType?: "market" | "limit" | undefined;
+    limitPriceRaw: string | null;
+    limitSizeRaw?: string | null | undefined;
+    timeInForce: TimeInForce | null;
+    postOnly?: boolean | undefined;
+    expiresAt: Date | string | null;
+    reservedCostRaw?: string | null | undefined;
+    filledSizeRaw?: string | null | undefined;
+    filledCostRaw?: string | null | undefined;
+    remainingSizeRaw?: string | null | undefined;
+    averageFillPriceRaw?: string | null | undefined;
+    venueOrderId?: string | null | undefined;
+    cancelRequestedAt?: Date | string | null | undefined;
+    cancelledAt?: Date | string | null | undefined;
     slippageBps: number | null;
     quotedPriceRaw: string | null;
     quotedCostRaw: string | null;
@@ -223,6 +256,7 @@ type PositionGroup = {
             totalValue: number;
             unrealizedPnlPercent: number;
             priceSource: PriceSource;
+            bookQuality: BookQuality;
         }[];
     };
     targetMarketId: string;
@@ -721,8 +755,14 @@ interface AggUiLabels {
         categoryTabsAria: string;
     };
     userProfile: {
+        tabs: {
+            positions: string;
+            openOrders: string;
+            activity: string;
+        };
         balance: {
             availableBalance: string;
+            reservedForOpenOrders: (amount: string) => string;
             balanceByNetwork: string;
             paperModeNetwork: string;
             paperModeWarning: string;
@@ -809,6 +849,25 @@ interface AggUiLabels {
             nowPrefix: string;
             finalPrefix: string;
         };
+        openOrders: {
+            marketHeader: string;
+            limitPriceHeader: string;
+            filledHeader: string;
+            totalHeader: string;
+            filledShort: string;
+            totalShort: string;
+            expirationHeader: string;
+            goodTilCanceled: string;
+            expired: string;
+            cancel: string;
+            cancelOrderAria: (orderId: string) => string;
+            loading: string;
+            loadingMore: string;
+            errorTitle: string;
+            errorDescription: string;
+            emptyTitle: string;
+            emptyDescription: string;
+        };
     };
     eventList: {
         matchedTab: string;
@@ -1089,6 +1148,29 @@ interface AggUiLabels {
         kycSuccessDone: string;
         outcome: (label: string) => string;
         smartRouting: string;
+        orderTypeMarket: string;
+        orderTypeLimit: string;
+        orderTypeAria: string;
+        limitPrice: string;
+        limitPriceInputAria: string;
+        limitPriceInvalid: string;
+        limitPriceDecreaseAria: string;
+        limitPriceIncreaseAria: string;
+        expiration: string;
+        expirationGoodTilCanceled: string;
+        expirationFiveMinutes: string;
+        expirationOneHour: string;
+        expirationEndOfDay: string;
+        expirationCustom: string;
+        expirationMenuAria: string;
+        expirationOptions: string;
+        expirationDateAria: string;
+        expirationStartTime: string;
+        expirationStartTimeHint: string;
+        expirationCancel: string;
+        expirationApply: string;
+        limitOrderPlacedTitle: string;
+        limitOrderPlacedDescription: string;
         orderSplitting: string;
         splitOrderDescription: string;
         viewAllRoutes: (count: number) => string;
@@ -1344,6 +1426,12 @@ interface AggUiLabels {
                 amountLabel?: string;
                 priceLabel?: string;
             }) => string;
+            cancelledTitle: string;
+            cancelledMessage: string;
+            cancelPendingTitle: string;
+            cancelPendingMessage: string;
+            cancelFailedTitle: string;
+            cancelFailedMessage: (errorReason?: string) => string;
             failedTitle: string;
             failedMessage: (errorReason?: string) => string;
         };
@@ -1431,6 +1519,8 @@ interface AggUiFeatureFlagsConfig {
      * for ad-hoc partner-fired toasts).
      */
     enableNotifications: boolean;
+    /** Enable creating limit orders in trading surfaces. Defaults to `false`. */
+    showLimitOrders: boolean;
     /**
      * Enable the experimental sports event-details view. When `true` and the
      * event's `structureType === "sport"`, the event page renders the sports
@@ -1635,9 +1725,16 @@ interface AggAuthContextValue {
 }
 interface AggBalanceContextValue {
     balanceBreakdown: AggBalanceBreakdownItem[];
+    /** Per-chain spendable cash after active execution reservations. */
+    availableBalanceBreakdown: AggBalanceBreakdownItem[];
     /** Raw response from GET /execution/balances for direct consumer use. */
     managedBalances: UnifiedBalanceResponse;
+    /** Total cash, including funds reserved for open orders. */
     totalBalance: number;
+    /** Cash immediately available for a new trade or withdrawal. */
+    availableBalance: number;
+    /** Cash currently reserved for pending and open orders. */
+    reservedBalance: number;
     positionsBalanceTotal: number;
     connectedVenues: Venue[];
     isLoading: boolean;
@@ -1925,6 +2022,18 @@ interface UseExecuteManagedOptions {
  */
 declare function useExecuteManaged(options?: UseExecuteManagedOptions): _tanstack_react_query.UseMutationResult<ExecuteManagedResponse, Error, ExecuteManagedParams, unknown>;
 
+interface UsePlaceLimitOrderOptions {
+    onSuccess?: (data: PlaceLimitOrderResponse) => void;
+    onError?: (error: Error) => void;
+}
+declare function usePlaceLimitOrder(options?: UsePlaceLimitOrderOptions): _tanstack_react_query.UseMutationResult<PlaceLimitOrderResponse, Error, PlaceLimitOrderParams, unknown>;
+
+interface UseCancelManagedOrderOptions {
+    onSuccess?: (data: CancelManagedExecutionResponse, orderId: string) => void;
+    onError?: (error: Error, orderId: string) => void;
+}
+declare function useCancelManagedOrder(options?: UseCancelManagedOrderOptions): _tanstack_react_query.UseMutationResult<CancelManagedExecutionResponse, Error, string, unknown>;
+
 interface UsePositionsOptions extends GetPositionsParams {
     enabled?: boolean;
 }
@@ -2652,7 +2761,9 @@ declare function useCategoryChildren(options?: UseCategoryChildrenOptions): {
 
 declare function useDebouncedValue<T>(value: T, delay: number): T;
 
-interface UseExecutionOrdersOptions extends Omit<GetOrdersQuery, "cursor"> {
+type ExecutionOrderStatusInput = NonNullable<GetOrdersQuery["status"]> | `${NonNullable<GetOrdersQuery["status"]>}`;
+interface UseExecutionOrdersOptions extends Omit<GetOrdersQuery, "cursor" | "status"> {
+    status?: ExecutionOrderStatusInput;
     enabled?: boolean;
     mode?: "live" | "paper";
     refetchIntervalMs?: number | false;
@@ -5728,4 +5839,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 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 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 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 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, 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 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 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 UsePlaceLimitOrderOptions, type UsePositionsOptions, type UseQuoteManagedOptions, type UseRedeemLifecycleInput, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSmartRouteOptions, type UseSmartRouteResult, 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, useCancelManagedOrder, 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, usePlaceLimitOrder, usePositions, useQuoteManaged, useRampQuotes, useRampSession, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSmartRoute, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueMarketMidpoints, useVenueMarkets, useViewportMidpoints, useVisibleIds, userActivityQueryKeys };

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, QuoteManagedResponse, QuoteManagedParams, ExecuteManagedResponse, ExecuteManagedParams, GetPositionsParams, WsOrderSubmitted, WsBalanceUpdate, RedeemResponse, RedeemRequest, WsRedeemEvent, AggWebSocket, WsOrderEvent, WsWithdrawalLifecycleEvent, WsCandleInterval, WsTrade, AggregatedOrderbookResponse, AggLinkAccountBody, AggLinkAccountResult, AggLinkAccountConfirmResult, Category, UserActivityQuery, UserActivityItem, PaginatedResponse, CandleInterval, OrderbookState, OrderbookQuoteResponse, OrderListQuery, TradeExecutorOrder, SmartRouteSide, ExecutionMode, SmartRouteResponse, RecurrenceFilter, MidpointRow, BatchMidpointsResponse, AppClientConfigResponse } from '@agg-build/sdk';
+import { CandleBuilder, AggAuthStartBody, AggAuthStartResult, AggClientSessionInput, AggClient, RampQuote, RampQuoteRequest, RampWidgetSession, RampSessionRequest, QuoteManagedResponse, QuoteManagedParams, ExecuteManagedResponse, ExecuteManagedParams, PlaceLimitOrderResponse, PlaceLimitOrderParams, CancelManagedExecutionResponse, GetPositionsParams, WsOrderSubmitted, WsBalanceUpdate, RedeemResponse, RedeemRequest, WsRedeemEvent, AggWebSocket, WsOrderEvent, WsWithdrawalLifecycleEvent, WsCandleInterval, WsTrade, AggregatedOrderbookResponse, AggLinkAccountBody, AggLinkAccountResult, AggLinkAccountConfirmResult, Category, UserActivityQuery, UserActivityItem, PaginatedResponse, CandleInterval, OrderbookState, OrderbookQuoteResponse, OrderListQuery, TradeExecutorOrder, SmartRouteSide, ExecutionMode, SmartRouteResponse, RecurrenceFilter, MidpointRow, BatchMidpointsResponse, AppClientConfigResponse } from '@agg-build/sdk';
 export { 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';
@@ -78,6 +78,14 @@ declare enum OrderStatus {
     expired = "expired",
     cancelled = "cancelled"
 }
+declare enum TimeInForce {
+    GTC = "GTC",
+    GTD = "GTD",
+    FOK = "FOK",
+    FAK = "FAK",
+    IOC = "IOC",
+    ALO = "ALO"
+}
 
 /**
  * Standalone type definitions — no Zod dependency.
@@ -108,6 +116,17 @@ type UserProfile = {
     }[] | null;
 };
 type PriceSource = "orderbook" | "cached" | "entry" | "settled";
+/**
+ * Health of the orderbook a position was marked against — passthrough of
+ * the engine's `BookQuality` verdict. `priceSource` says where a mark came
+ * from; this says whether that source was trustworthy. Anything other than
+ * `healthy` is a low-confidence mark.
+ *
+ * Read `priceSource` first — this only qualifies book-derived marks. A
+ * `settled` position is exact (1/0) and consults no book, so it reports
+ * `empty`; that is not a confidence signal.
+ */
+type BookQuality = "healthy" | "wide_spread" | "bid_only" | "ask_only" | "endpoint_stub" | "crossed" | "empty";
 type UnifiedBalanceResponse = {
     cash: {
         tokenSymbol: string;
@@ -161,6 +180,20 @@ type OrderListItem = {
     venue: Venue;
     side: string;
     amountRaw: string;
+    orderType?: "market" | "limit" | undefined;
+    limitPriceRaw: string | null;
+    limitSizeRaw?: string | null | undefined;
+    timeInForce: TimeInForce | null;
+    postOnly?: boolean | undefined;
+    expiresAt: Date | string | null;
+    reservedCostRaw?: string | null | undefined;
+    filledSizeRaw?: string | null | undefined;
+    filledCostRaw?: string | null | undefined;
+    remainingSizeRaw?: string | null | undefined;
+    averageFillPriceRaw?: string | null | undefined;
+    venueOrderId?: string | null | undefined;
+    cancelRequestedAt?: Date | string | null | undefined;
+    cancelledAt?: Date | string | null | undefined;
     slippageBps: number | null;
     quotedPriceRaw: string | null;
     quotedCostRaw: string | null;
@@ -223,6 +256,7 @@ type PositionGroup = {
             totalValue: number;
             unrealizedPnlPercent: number;
             priceSource: PriceSource;
+            bookQuality: BookQuality;
         }[];
     };
     targetMarketId: string;
@@ -721,8 +755,14 @@ interface AggUiLabels {
         categoryTabsAria: string;
     };
     userProfile: {
+        tabs: {
+            positions: string;
+            openOrders: string;
+            activity: string;
+        };
         balance: {
             availableBalance: string;
+            reservedForOpenOrders: (amount: string) => string;
             balanceByNetwork: string;
             paperModeNetwork: string;
             paperModeWarning: string;
@@ -809,6 +849,25 @@ interface AggUiLabels {
             nowPrefix: string;
             finalPrefix: string;
         };
+        openOrders: {
+            marketHeader: string;
+            limitPriceHeader: string;
+            filledHeader: string;
+            totalHeader: string;
+            filledShort: string;
+            totalShort: string;
+            expirationHeader: string;
+            goodTilCanceled: string;
+            expired: string;
+            cancel: string;
+            cancelOrderAria: (orderId: string) => string;
+            loading: string;
+            loadingMore: string;
+            errorTitle: string;
+            errorDescription: string;
+            emptyTitle: string;
+            emptyDescription: string;
+        };
     };
     eventList: {
         matchedTab: string;
@@ -1089,6 +1148,29 @@ interface AggUiLabels {
         kycSuccessDone: string;
         outcome: (label: string) => string;
         smartRouting: string;
+        orderTypeMarket: string;
+        orderTypeLimit: string;
+        orderTypeAria: string;
+        limitPrice: string;
+        limitPriceInputAria: string;
+        limitPriceInvalid: string;
+        limitPriceDecreaseAria: string;
+        limitPriceIncreaseAria: string;
+        expiration: string;
+        expirationGoodTilCanceled: string;
+        expirationFiveMinutes: string;
+        expirationOneHour: string;
+        expirationEndOfDay: string;
+        expirationCustom: string;
+        expirationMenuAria: string;
+        expirationOptions: string;
+        expirationDateAria: string;
+        expirationStartTime: string;
+        expirationStartTimeHint: string;
+        expirationCancel: string;
+        expirationApply: string;
+        limitOrderPlacedTitle: string;
+        limitOrderPlacedDescription: string;
         orderSplitting: string;
         splitOrderDescription: string;
         viewAllRoutes: (count: number) => string;
@@ -1344,6 +1426,12 @@ interface AggUiLabels {
                 amountLabel?: string;
                 priceLabel?: string;
             }) => string;
+            cancelledTitle: string;
+            cancelledMessage: string;
+            cancelPendingTitle: string;
+            cancelPendingMessage: string;
+            cancelFailedTitle: string;
+            cancelFailedMessage: (errorReason?: string) => string;
             failedTitle: string;
             failedMessage: (errorReason?: string) => string;
         };
@@ -1431,6 +1519,8 @@ interface AggUiFeatureFlagsConfig {
      * for ad-hoc partner-fired toasts).
      */
     enableNotifications: boolean;
+    /** Enable creating limit orders in trading surfaces. Defaults to `false`. */
+    showLimitOrders: boolean;
     /**
      * Enable the experimental sports event-details view. When `true` and the
      * event's `structureType === "sport"`, the event page renders the sports
@@ -1635,9 +1725,16 @@ interface AggAuthContextValue {
 }
 interface AggBalanceContextValue {
     balanceBreakdown: AggBalanceBreakdownItem[];
+    /** Per-chain spendable cash after active execution reservations. */
+    availableBalanceBreakdown: AggBalanceBreakdownItem[];
     /** Raw response from GET /execution/balances for direct consumer use. */
     managedBalances: UnifiedBalanceResponse;
+    /** Total cash, including funds reserved for open orders. */
     totalBalance: number;
+    /** Cash immediately available for a new trade or withdrawal. */
+    availableBalance: number;
+    /** Cash currently reserved for pending and open orders. */
+    reservedBalance: number;
     positionsBalanceTotal: number;
     connectedVenues: Venue[];
     isLoading: boolean;
@@ -1925,6 +2022,18 @@ interface UseExecuteManagedOptions {
  */
 declare function useExecuteManaged(options?: UseExecuteManagedOptions): _tanstack_react_query.UseMutationResult<ExecuteManagedResponse, Error, ExecuteManagedParams, unknown>;
 
+interface UsePlaceLimitOrderOptions {
+    onSuccess?: (data: PlaceLimitOrderResponse) => void;
+    onError?: (error: Error) => void;
+}
+declare function usePlaceLimitOrder(options?: UsePlaceLimitOrderOptions): _tanstack_react_query.UseMutationResult<PlaceLimitOrderResponse, Error, PlaceLimitOrderParams, unknown>;
+
+interface UseCancelManagedOrderOptions {
+    onSuccess?: (data: CancelManagedExecutionResponse, orderId: string) => void;
+    onError?: (error: Error, orderId: string) => void;
+}
+declare function useCancelManagedOrder(options?: UseCancelManagedOrderOptions): _tanstack_react_query.UseMutationResult<CancelManagedExecutionResponse, Error, string, unknown>;
+
 interface UsePositionsOptions extends GetPositionsParams {
     enabled?: boolean;
 }
@@ -2652,7 +2761,9 @@ declare function useCategoryChildren(options?: UseCategoryChildrenOptions): {
 
 declare function useDebouncedValue<T>(value: T, delay: number): T;
 
-interface UseExecutionOrdersOptions extends Omit<GetOrdersQuery, "cursor"> {
+type ExecutionOrderStatusInput = NonNullable<GetOrdersQuery["status"]> | `${NonNullable<GetOrdersQuery["status"]>}`;
+interface UseExecutionOrdersOptions extends Omit<GetOrdersQuery, "cursor" | "status"> {
+    status?: ExecutionOrderStatusInput;
     enabled?: boolean;
     mode?: "live" | "paper";
     refetchIntervalMs?: number | false;
@@ -5728,4 +5839,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 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 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 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 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, 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 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 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 UsePlaceLimitOrderOptions, type UsePositionsOptions, type UseQuoteManagedOptions, type UseRedeemLifecycleInput, type UseRollingChartWindowOptions, type UseSearchOptions, type UseSmartRouteOptions, type UseSmartRouteResult, 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, useCancelManagedOrder, 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, usePlaceLimitOrder, usePositions, useQuoteManaged, useRampQuotes, useRampSession, useRedeem, useRedeemEligibleCount, useRedeemLifecycle, useRedeemLifecycles, useRollingChartWindow, useSdkLabels, useSdkUiConfig, useSearch, useSmartRoute, useUserActivity, useUserHoldings, useVenueEvent, useVenueEvents, useVenueMarketMidpoints, useVenueMarkets, useViewportMidpoints, useVisibleIds, userActivityQueryKeys };