@agg-build/sdk 2.1.2 → 2.2.0

package/README.md

@@ -255,6 +255,8 @@ Call `client.destroy()` when you no longer need the client to release internal r
 | `quoteManaged(params)`        | Request a 2-min TTL quote with execution steps       |
 | `executeManaged(params)`      | Execute a previously quoted trade                    |
 | `withdrawManaged(params)`     | Withdraw from managed wallets to an external address |
+| `withdrawPreview(params)`     | Preview withdrawal receive amount and route fees     |
+| `getWithdrawalQuote(params)`  | Quote the maximum deliverable withdrawal amount      |
 | `syncManagedBalances()`       | Trigger on-chain balance sync                        |
 | `cancelManagedOrder(orderId)` | Cancel a pending managed execution order             |
 | `getVenueBalances(venues)`    | Get balances across venues                           |

package/dist/index.d.mts

@@ -408,6 +408,7 @@ type WalletTokenBalance = {
     chains: {
         chainId: number;
         tokenAddress: string;
+        tokenSymbol?: string | undefined;
         balanceRaw: string;
         heldRaw?: string | undefined;
         availableRaw?: string | undefined;
@@ -434,6 +435,7 @@ type UnifiedBalanceResponse = {
         chains: {
             chainId: number;
             tokenAddress: string;
+            tokenSymbol?: string | undefined;
             balanceRaw: string;
             heldRaw?: string | undefined;
             availableRaw?: string | undefined;
@@ -584,7 +586,8 @@ type VenueMarket = {
     question: string;
     venueMarketOutcomes: {
         id: string;
-        price: number;
+        /** REMOVED — no longer returned; use GET /midpoints for live prices. */
+        price?: number | undefined;
         venueMarketId: string;
         label: string;
         title?: string | null | undefined;
@@ -623,6 +626,10 @@ type VenueMarket = {
     period?: string | null | undefined;
     /** Normalized subject category for prop-tab grouping (e.g., game_lines, exact_score, etc.). */
     marketCategory?: string | null | undefined;
+    /** Section/tab grouping key for sports markets (e.g. "player_props", "totals"). */
+    marketGroup?: string | null | undefined;
+    /** Fine-grained sub-classification within a marketGroup (e.g. "moneyline", "rushing_yards"). */
+    marketSubtype?: string | null | undefined;
     /** Line value for spread/total markets (e.g., 2.5 for totals, 3 for spreads). */
     lineValue?: number | null | undefined;
     matchedVenueMarkets?: {
@@ -634,7 +641,8 @@ type VenueMarket = {
         conditionId?: string | null | undefined;
         venueMarketOutcomes?: {
             id: string;
-            price: number;
+            /** REMOVED — no longer returned; use GET /midpoints for live prices. */
+            price?: number | undefined;
             venueMarketId: string;
             label: string;
             winner?: boolean | null | undefined;
@@ -698,8 +706,12 @@ type VenueEvent = {
      * enum values.
      */
     recurrence?: string | null | undefined;
+    /** Deterministic game-level canonical key for cross-venue sports detail loading. */
+    aggKey?: string | null | undefined;
     /** Type-aware structure classification used to sort markets under this event. */
     structureType?: "candidate" | "sport" | "axis" | "dates" | null | undefined;
+    /** Canonical sport slug for sports events (e.g. "basketball", "soccer"); null for non-sports. */
+    sport?: string | null | undefined;
 };
 type Orderbook = {
     bids: {
@@ -802,7 +814,12 @@ type MatchedVenueMarketOutcomeRef = {
 };
 type VenueMarketOutcome = {
     id: string;
-    price: number;
+    /**
+     * REMOVED — /venue-events and /venue-markets no longer return outcome
+     * prices. Fetch live prices from GET /midpoints (or the live-price hooks),
+     * keyed by this outcome's `id`.
+     */
+    price?: number | undefined;
     venueMarketId: string;
     label: string;
     title?: string | null | undefined;
@@ -1477,12 +1494,16 @@ interface WsArbMarketUpdate {
     venueEventId: string | null;
     arbReturn: number;
     ts: number;
+    liquidityUsd?: number;
+    liquidityTier?: "deep" | "shallow";
 }
 interface WsArbFeedEntry {
     marketId: string;
     venueEventId: string | null;
     arbReturn: number;
     ts: number;
+    liquidityUsd?: number;
+    liquidityTier?: "deep" | "shallow";
 }
 interface WsArbFeedBatch {
     type: "arb_feed_batch";
@@ -1765,6 +1786,10 @@ interface AppClientConfigResponse {
     earlyAccessEnabled: boolean;
     authOptions: AppClientAuthOption[];
 }
+interface RpcTokenResponse {
+    token: string;
+    expiresAt: number;
+}
 type AggAuthProviderType = "siwe" | "siws" | "google" | "twitter" | "apple" | "email";
 interface AppClientAuthOption {
     provider: AggAuthProviderType;
@@ -2025,6 +2050,36 @@ interface ListRecurringCryptoMarketsOptions {
     includeOrderbookPrices?: boolean;
     includeReferencePrices?: boolean;
     includeDirectVenueMarkets?: boolean;
+    includeOrderbookDepth?: boolean;
+    orderbookDepth?: number;
+    orderbookDepthAmountUsd?: number;
+}
+interface RecurringCryptoOrderbookDepthLevel {
+    price: number;
+    size: number;
+    notionalUsd: number;
+    cumulativeSize: number;
+    cumulativeNotionalUsd: number;
+    fillSize: number | null;
+    fillNotionalUsd: number | null;
+}
+interface RecurringCryptoOrderbookDepthSide {
+    levels: RecurringCryptoOrderbookDepthLevel[];
+    totalSize: number;
+    totalNotionalUsd: number;
+    requestedNotionalUsd: number | null;
+    filledSize: number | null;
+    filledNotionalUsd: number | null;
+    unfilledNotionalUsd: number | null;
+    avgPrice: number | null;
+    worstPrice: number | null;
+    fillsComplete: boolean | null;
+}
+interface RecurringCryptoOutcomeOrderbookDepth {
+    currency: "USD";
+    amountUsd: number | null;
+    buy: RecurringCryptoOrderbookDepthSide;
+    sell: RecurringCryptoOrderbookDepthSide;
 }
 interface RecurringCryptoOutcome {
     /**
@@ -2045,6 +2100,7 @@ interface RecurringCryptoOutcome {
     bestAsk: number | null;
     markSource: MarkSource | string | null;
     lastKnownPrice: number | null;
+    orderbookDepth: RecurringCryptoOutcomeOrderbookDepth | null;
 }
 interface RecurringCryptoMarketMetrics {
     volume: number | null;
@@ -2422,6 +2478,8 @@ interface ExecuteManagedResponse {
     quoteId: string;
     orderIds: string[];
     status: "pending";
+    redeemId?: string;
+    message?: string;
 }
 interface ValidateManagedParams {
     venueMarketOutcomeIds: string[];
@@ -2441,9 +2499,9 @@ interface WithdrawManagedParams {
     /** Positive integer string in the token's native decimals (e.g. "100000" = 0.1 USDC). */
     amountRaw: string;
     tokenSymbol: WithdrawTokenSymbol;
-    /** EVM 0x-prefixed 20-byte recipient address. */
+    /** Recipient address. EVM destinations use 0x-prefixed 20-byte hex; Solana uses base58. */
     destinationAddress: string;
-    /** EVM chain ID where the recipient should receive funds. Required as of v2026.04. */
+    /** Chain ID where the recipient should receive funds. Required as of v2026.04. */
     destinationChainId: number;
     /**
      * When `true`, the server caps the withdrawal to the maximum deliverable amount
@@ -2495,6 +2553,17 @@ interface WithdrawalExpected {
 }
 /** Body for POST /execution/withdraw/preview — identical to a withdraw request. */
 type WithdrawPreviewParams = WithdrawManagedParams;
+interface WithdrawalQuoteParams {
+    tokenSymbol: WithdrawTokenSymbol;
+    destinationChainId: number;
+}
+interface WithdrawalQuoteResponse {
+    tokenSymbol: WithdrawTokenSymbol;
+    destinationChainId: number;
+    maxDeliverableRaw: string;
+    rawBalanceRaw: string;
+    decimals: number;
+}
 /** Response from POST /execution/withdraw/preview. All amounts are raw strings in destination-token native decimals. */
 interface WithdrawPreviewResponse {
     receiveAmountRaw: string | null;
@@ -2591,6 +2660,60 @@ type ExecutionOrdersQuery = GetOrdersQuery & {
     mode?: ExecutionMode;
 };
 type ExecutionOrderItem = OrderListItem;
+type ExecutionStatusQuery = {
+    quoteId: string;
+    mode?: ExecutionMode;
+};
+type ExecutionOverallState = "created" | "routing" | "quoting" | "placing" | "confirming" | "filled" | "partially_filled" | "failed" | "cancelled" | "expired";
+interface ExecutionDagProgress {
+    dagRunId: string;
+    totalSteps: number;
+    currentSequence: number;
+    currentStepType: string | null;
+    completedSequences: number[];
+    stepTypes: Record<number, string>;
+    status: "running" | "completed" | "failed";
+    errorReason: string | null;
+}
+interface ExecutionStatusStep {
+    sequence: number;
+    stepType: string;
+    status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+    attempt: number;
+    startedAt: string | null;
+    completedAt: string | null;
+    errorReason: string | null;
+}
+interface ExecutionStatusOrder {
+    orderId: string;
+    venue: string;
+    status: string;
+    event: "filled" | "partial_fill" | "failed" | null;
+    filledAmountRaw?: string;
+    remainingAmountRaw?: string;
+    quotedSharesRaw?: string;
+    actualSharesRaw?: string;
+    quotedToWinRaw?: string;
+    actualToWinRaw?: string;
+    quotedPriceRaw?: string;
+    executionPriceRaw?: string;
+    partialFillReason?: string;
+    errorReason?: string;
+    txHash?: string;
+    updatedAt: string;
+}
+interface ExecutionStatusResponse {
+    executionId: string | null;
+    quoteId: string;
+    orderIds: string[];
+    overallState: ExecutionOverallState;
+    terminal: boolean;
+    errorReason: string | null;
+    pollAfterMs: number | null;
+    dagProgress: ExecutionDagProgress | null;
+    steps: ExecutionStatusStep[];
+    orders: ExecutionStatusOrder[];
+}
 type ExecutionPositionsQuery = GetPositionsQuery & {
     mode?: ExecutionMode;
 };
@@ -2606,6 +2729,9 @@ interface PaperTradingListParams {
     limit?: number;
     cursor?: string;
 }
+interface PaperTradingAccountListParams extends PaperTradingListParams {
+    externalId?: string;
+}
 interface CreatePaperTradingAccountParams {
     name?: string;
     externalId?: string;
@@ -3058,6 +3184,24 @@ interface SmartRouteFeeBreakdown {
     appFeeCategory?: string;
 }
 /** Response from GET /orderbook/:venueMarketOutcomeId/route. */
+interface SmartRouteSettlementLeg {
+    action: "redeem";
+    venue: string;
+    venueMarketId: string;
+    venueMarketOutcomeId: string;
+    positionId: string;
+    size: string;
+    redeemPath: "evm" | "svm";
+}
+interface SmartRouteSettlementPlan {
+    redeemId: string;
+    status: "redeem_only" | "partial_redeem";
+    message: string;
+    totalRedeemableShares: number;
+    totalRedeemShares: number;
+    totalSellShares: number;
+    redeemLegs: SmartRouteSettlementLeg[];
+}
 interface SmartRouteResponse {
     quoteId: string;
     venueMarketOutcomeId: string;
@@ -3082,6 +3226,7 @@ interface SmartRouteResponse {
     }>;
     error?: string;
     message?: string;
+    settlementPlan?: SmartRouteSettlementPlan;
     warnings?: Array<{
         venue: string;
         venueMarketOutcomeId: string;
@@ -3334,14 +3479,24 @@ interface CorrelatedMarketsStatus {
 interface CorrelatedMarketQueryResult {
     venueMarketId: string;
     marketQuestion: string;
+    marketStatus: MarketStatus;
+    marketStartDate: string;
+    marketEndDate: string | null;
     eventTitle: string;
+    eventStatus: MarketStatus;
+    eventStartDate: string;
+    eventEndDate: string | null;
     score: number;
     matchedSignal: CorrelatedMarketSignal;
+    matchSource: "signal" | "title_fallback";
     venue: string;
 }
 interface CorrelatedMarketCascadeItem {
     venueEventId: string;
     eventTitle: string;
+    eventStatus: MarketStatus;
+    eventStartDate: string;
+    eventEndDate: string | null;
     score: number;
     action: string;
     reason: string;
@@ -3413,6 +3568,7 @@ declare class AggClient {
     private paperTradingAccountsPath;
     private paperTradingAccountPath;
     private paperTradingListQuery;
+    private paperTradingAccountListQuery;
     private withAuthPayload;
     private restoreSession;
     private persistSession;
@@ -3532,6 +3688,8 @@ declare class AggClient {
      * rollup (total cost, share-weighted avg price, to-win).
      */
     getExecutionOrders(params?: ExecutionOrdersQuery): Promise<PaginatedResponse<ExecutionOrderItem>>;
+    /** Get quote-scoped execution progress, DAG step state, and order leg terminal status. */
+    getExecutionStatus(params: ExecutionStatusQuery): Promise<ExecutionStatusResponse>;
     /** Unified user activity feed (trades, deposits, withdrawals, bridges, wallet ops). */
     getUserActivity(params?: UserActivityQuery): Promise<PaginatedResponse<UserActivityItem>>;
     /** List execution positions for the authenticated user (cursor pagination). */
@@ -3541,7 +3699,7 @@ declare class AggClient {
     /** Create a server-managed paper trading account for an app. Requires adminKey or apiKey. */
     createPaperTradingAccount(params: CreatePaperTradingAccountParams, options?: PaperTradingAppOptions): Promise<PaperTradingAccount>;
     /** List server-managed paper trading accounts for an app. Requires adminKey or apiKey. */
-    listPaperTradingAccounts(params?: PaperTradingListParams & PaperTradingAppOptions): Promise<PaperTradingAccountsPage>;
+    listPaperTradingAccounts(params?: PaperTradingAccountListParams & PaperTradingAppOptions): Promise<PaperTradingAccountsPage>;
     /** Fetch a server-managed paper trading account. Requires adminKey or apiKey. */
     getPaperTradingAccount(accountId: string, options?: PaperTradingAppOptions): Promise<PaperTradingAccount>;
     /** Set a paper trading account cash balance. Requires adminKey or apiKey. */
@@ -3576,6 +3734,13 @@ declare class AggClient {
         maxYesPrice?: number;
         /** ISO-8601 timestamp. Hides events with endDate <= this value. NULL-endDate events are kept. */
         endDateFrom?: string;
+        /**
+         * When true, fold same-venue companion events into one tile per game
+         * (`groupParentId IS NULL`). Sent as `grouped=true`; omitted when false/absent
+         * (default = ungrouped). Consumers showing one tile per game need a detail
+         * view that loads the folded companions via aggKey.
+         */
+        grouped?: boolean;
     }): Promise<PaginatedResponse<VenueEvent>>;
     /** Get a single venue event by ID. Requires appId or admin auth. */
     getVenueEventById(id: string, options?: {
@@ -3595,10 +3760,16 @@ declare class AggClient {
         matchStatus?: MatchStatus;
         status?: MarketStatus;
         categoryIds?: string[];
+        aggKey?: string[];
+        sportsMarketType?: string[];
+        period?: string[];
+        marketCategory?: string[];
+        marketGroup?: string[];
         limit?: number;
         cursor?: string;
         sortBy?: "volume" | "volume24hr" | "createdAt" | "yesPrice" | "updatedAt";
         sortDir?: "asc" | "desc";
+        context?: "list" | "detail";
     }): Promise<PaginatedResponse<VenueMarket>>;
     /** Get categories with cursor-based pagination. Requires appId. */
     getCategories(options?: {
@@ -3608,6 +3779,8 @@ declare class AggClient {
     }): Promise<PaginatedResponse<Category>>;
     /** Get per-app UI config (disabled venues + category presets). Requires appId. */
     getAppConfig(init?: RequestInit): Promise<AppClientConfigResponse>;
+    /** Get a temporary Alchemy JWT token for RPC connections. */
+    getRpcToken(init?: RequestInit): Promise<RpcTokenResponse>;
     private buildNewsFeedQuery;
     /** List available market news feeds and item counts. */
     getNewsFeeds(options?: {
@@ -3652,6 +3825,8 @@ declare class AggClient {
         text: string;
         limit?: number;
         includeResolved?: boolean;
+        direction?: "more_likely" | "less_likely";
+        balanced?: boolean;
     }, options?: {
         signal?: AbortSignal;
     }): Promise<{
@@ -3738,6 +3913,8 @@ declare class AggClient {
      * integrating against the SDK can ignore this entirely.
      */
     withdrawPreview(params: WithdrawPreviewParams): Promise<WithdrawPreviewResponse>;
+    /** Quote maximum deliverable withdrawal amount for a token and destination chain. */
+    getWithdrawalQuote(params: WithdrawalQuoteParams): Promise<WithdrawalQuoteResponse>;
     /**
      * Read the current persisted state of a withdrawal. Used as a backfill for
      * the WS lifecycle channel: the client polls this on hook mount and on WS
@@ -3850,4 +4027,4 @@ declare function aggregateMidpoint(midpoints: (number | null | undefined)[]): nu
 
 declare function createAggClient(options: AggClientOptions): AggClient;
 
-export { type Account, AccountProvider, AccountType, type AggAuthDeliveryMode, type AggAuthProviderType, type AggAuthStartBody, type AggAuthStartResult, type AggAuthVerifyBody, AggClient, type AggClientAuthOptions, type AggClientSessionInput, type AggLinkAccountBody, type AggLinkAccountConfirmResult, type AggLinkAccountResult, type AggSessionUser, AggWebSocket, type AggWebSocketCallbacks, type AggWebSocketOptions, type AggregatedOrderbookLevel, type AggregatedOrderbookResponse, type App, type AppClientConfigResponse, type AttributedOrderbook, type AttributedOrderbookLevel, type AuthCodeResponse, type AuthStatus, type AuthTokenResponse, type AuthUser, type BatchMidpointsResponse, type BatchOrderbooksResponse, type BuildVenueUrlOpts, CONFIRMED_MATCH_STATUSES, type CancelManagedExecutionResponse, type Candle, CandleBuilder, type CandleInterval, type Category, Chain, type ChartBarsResponse, type ChartCandle, type ChartResolution, type ChartVenueCandles, type ComputeSplitsRequest, type ComputeSplitsResponse, type ComputeSplitsSelection, type CorrelatedMarketCascadeItem, type CorrelatedMarketCascadeResponse, type CorrelatedMarketQueryResult, type CorrelatedMarketSide, type CorrelatedMarketSignal, type CorrelatedMarketSignalBatch, type CorrelatedMarketSignalDirection, type CorrelatedMarketsStatus, type CreateApp, type CreatePaperTradingAccountParams, type CryptoReferencePriceError, type CryptoReferencePriceExternalMarketInput, type CryptoReferencePriceMarketInput, type CryptoReferencePriceResult, type CryptoReferencePriceSource, type CryptoReferencePriceTarget, type CryptoReferencePricesResponse, type DepositAddressesPendingResponse, type DepositAddressesReadyResponse, type DepositAddressesResponse, type DepositAddressesSupportedChain, type DepositAddressesToken, type DepositStep, type DiagnosticCallback, type DiagnosticEvent, type ExecuteManagedParams, type ExecuteManagedRequest, type ExecuteManagedResponse, type ExecuteTradeRequest, type ExecuteTradeResponse, type ExecutionMode, type ExecutionOrderItem, type ExecutionOrdersQuery, type ExecutionPositionGroup, type ExecutionPositionsQuery, type GetBalanceQuery, type GetBalanceResponse, type GetCryptoReferencePricesOptions, type GetHoldingsQuery, type GetHoldingsResponse, type GetOrdersParams, type GetOrdersQuery, type GetPositionsParams, type GetPositionsQuery, type HelloResponse, IMAGE_SIZES, ImageSize, type ListRecurringCryptoMarketsOptions, type ManagedBalancesParams, type MarkSource, type MarketPriceHistory, MarketStatus, MatchStatus, MatchType, type MatchedMidpoint, type MatchedMidpointOutcome, type MatchedOrderbookMarket, type MatchedVenueMarketOutcomeRef, type MatchingReport, type MidpointItem, type MidpointRow, type NewsFeedArticleFeedItem, type NewsFeedArticleFeedResponse, type NewsFeedArticleWithSummary, type NewsFeedLinkedMarket, type NewsFeedListResponse, type NewsFeedMarketFeedArticle, type NewsFeedMarketFeedItem, type NewsFeedMarketFeedResponse, type NewsFeedMarketNewsParams, type NewsFeedMarketNewsResponse, type NewsFeedMarketNewsResult, type NewsFeedPageOptions, type NewsFeedStatusResponse, type NonceResponse, type OrderListItem, type OrderListQuery, OrderStatus, OrderType, type Orderbook, type OrderbookBatchItemError, type OrderbookBatchItemErrorCode, type OrderbookBatchItemStatus, type OrderbookHistoryPoint, type OrderbookHistoryResponse, type OrderbookLevel, type OrderbookQuoteFill, type OrderbookQuoteParams, type OrderbookQuoteResponse, type OrderbookServiceUnavailableError, type OrderbookState, type OrderbooksOnlyError, type OutcomeMidpoint, type OutcomeMidpointRow, type OutcomeOrderbookResponse, type PaginatedResponse, type PaperTradingAccount, type PaperTradingAccountsPage, type PaperTradingAppOptions, type PaperTradingBalanceAdjustment, type PaperTradingBalanceResponse, type PaperTradingLiquidityStatus, type PaperTradingListParams, type PaperTradingMarkSource, type PaperTradingOrder, type PaperTradingOrdersPage, type PaperTradingPortfolio, type PaperTradingPosition, type PaperTradingPositionsPage, type PersistedAuthSnapshot, type PlacePaperTradingOrderParams, type PositionGroup, type PositionRedeemStatus, type PricePoint, type PriceSource, type PricesHistoryResponse, type QuoteManagedParams, type QuoteManagedRequest, type QuoteManagedResponse, type QuoteManagedSplit, type QuoteManagedStep, type QuoteSplit, type QuoteStep, RECURRENCE_CADENCES, type RampQuote, type RampQuoteRequest, type RampSessionRequest, type RampWidgetSession, type RecurrenceCadence, type RecurrenceFilter, type RecurringCryptoComparisonPoint, type RecurringCryptoComparisonPriceSource, type RecurringCryptoDuration, type RecurringCryptoDurationInput, type RecurringCryptoMarketMetrics, type RecurringCryptoMarketsResponse, type RecurringCryptoOutcome, type RecurringCryptoPriceComparison, type RecurringCryptoReferencePrice, type RecurringCryptoResolution, type RecurringCryptoSourceConfidence, type RecurringCryptoVenueMarket, type RecurringCryptoWindowComparisons, type RecurringCryptoWindowMarket, type RedeemLegResult, type RedeemLegStatus, type RedeemRequest, type RedeemResponse, type RequestedOrderbookMarket, type ResetPaperTradingAccountParams, type ResolveCorrelatedMarketsParams, type ResolveCorrelatedMarketsResponse, type ResolvedCorrelatedMarketsResponse, type SafeParseFailure, type SafeParseResult, type SafeParseSuccess, type ServerWallet, type SetPaperTradingBalanceParams, type SettlementSource, type SetupDepositAddressStep, type SetupVenueKeyStep, type SimpleOrderbookLevel, type SmartRouteAllocation, type SmartRouteBridgeStep, type SmartRouteFeeBreakdown, type SmartRouteFill, type SmartRouteParams, type SmartRouteResponse, type SmartRouteSetupCostLine, type SmartRouteSide, type SmartRouteStatus, type SmartRouteVenueFill, type SplitsByAmountResult, type SyncBalancesResponse, TimeInForce, type TradeExecutorOrder, type TradeExecutorOrderListResponse, TradeSide$1 as TradeSide, type TradeSplit, type TradeStep, TurnstileChallengeError, type UnifiedBalanceResponse, type UpdateUserBody, type UpsertVenueKey, type UserActivityBridge, type UserActivityDeposit, type UserActivityItem, type UserActivityQuery, type UserActivityRedeem, type UserActivityRedeemLeg, type UserActivityTrade, type UserActivityType, type UserActivityUserOp, type UserActivityWithdrawal, type UserHolding, type UserProfile, VENUES, type ValidateBalanceOnClientStep, type ValidateManagedParams, type ValidateManagedRequest, type ValidateManagedResponse, type ValidateTradeRequest, type ValidateTradeResponse, Venue, type VenueEvent, type VenueEventListItem, type VenueEventWithMarkets, type VenueKeySummary, type VenueMarket, type VenueMarketClusterNode, type VenueMarketListItem, type VenueMarketOutcome, type VenueMarketRef, type VenueOrderbookEntry, type VenueOrderbookLevel, type VenuePositionBalance, type VenuePriceInfo, type VenueSoloQuote, type VerifyBody, type VerifyResponse, type WalletChainBalance, type WalletTokenBalance, type WithdrawManagedParams, type WithdrawManagedRequest, type WithdrawManagedResponse, type WithdrawManagedSourceItem, type WithdrawPreviewParams, type WithdrawPreviewResponse, type WithdrawTokenSymbol, type WithdrawalExpected, type WithdrawalLeg, type WithdrawalLegStatus, type WithdrawalLegType, type WithdrawalLifecycleStatus, type WithdrawalSource, type WithdrawalSourceItem, type WithdrawalSourceStatus, type WithdrawalSourceTokenSymbol, type WsArbFeedBatch, type WsArbFeedEntry, type WsArbMarketUpdate, type WsAttributedLevel, type WsAuthenticated, type WsBalanceUpdate, type WsCandleInterval, type WsClientMessage, type WsConnected, type WsError, type WsHeartbeat, type WsMarkSource, type WsMarketResolved, type WsOrderEvent, type WsOrderEventType, type WsOrderSubmitted, type WsOrderbookDelta, type WsOrderbookSnapshot, type WsRedeemEvent, type WsServerMessage, type WsSubscribed, type WsTrade, type WsUnsubscribed, type WsVenueBook, type WsVenueInfo, type WsVenueLevel, type WsWithdrawalLegStatus, type WsWithdrawalLifecycleEvent, type WsWithdrawalLifecycleLeg, type WsWithdrawalLifecycleStatus, aggregateMidpoint, applyOrderbookDelta, buildVenueUrl, computeBestSplitsByAmount, computeChecksum, createAggClient, enumGuard, formatMarketQuestion, formatOutcomeLabel, formatOutcomeTitle, getWalletAddressFromUserProfile, hasShape, isEmail, isEnum, isFiniteNonNeg, isNonEmptyString, mergeCandles, mergeClosedCandles, normalizeVenueMarketCluster, optimizedImageUrl, parse, parseEmail, parseEmailStrict, safeParse, snapshotToOrderbook, sortVenues };
+export { type Account, AccountProvider, AccountType, type AggAuthDeliveryMode, type AggAuthProviderType, type AggAuthStartBody, type AggAuthStartResult, type AggAuthVerifyBody, AggClient, type AggClientAuthOptions, type AggClientSessionInput, type AggLinkAccountBody, type AggLinkAccountConfirmResult, type AggLinkAccountResult, type AggSessionUser, AggWebSocket, type AggWebSocketCallbacks, type AggWebSocketOptions, type AggregatedOrderbookLevel, type AggregatedOrderbookResponse, type App, type AppClientConfigResponse, type AttributedOrderbook, type AttributedOrderbookLevel, type AuthCodeResponse, type AuthStatus, type AuthTokenResponse, type AuthUser, type BatchMidpointsResponse, type BatchOrderbooksResponse, type BuildVenueUrlOpts, CONFIRMED_MATCH_STATUSES, type CancelManagedExecutionResponse, type Candle, CandleBuilder, type CandleInterval, type Category, Chain, type ChartBarsResponse, type ChartCandle, type ChartResolution, type ChartVenueCandles, type ComputeSplitsRequest, type ComputeSplitsResponse, type ComputeSplitsSelection, type CorrelatedMarketCascadeItem, type CorrelatedMarketCascadeResponse, type CorrelatedMarketQueryResult, type CorrelatedMarketSide, type CorrelatedMarketSignal, type CorrelatedMarketSignalBatch, type CorrelatedMarketSignalDirection, type CorrelatedMarketsStatus, type CreateApp, type CreatePaperTradingAccountParams, type CryptoReferencePriceError, type CryptoReferencePriceExternalMarketInput, type CryptoReferencePriceMarketInput, type CryptoReferencePriceResult, type CryptoReferencePriceSource, type CryptoReferencePriceTarget, type CryptoReferencePricesResponse, type DepositAddressesPendingResponse, type DepositAddressesReadyResponse, type DepositAddressesResponse, type DepositAddressesSupportedChain, type DepositAddressesToken, type DepositStep, type DiagnosticCallback, type DiagnosticEvent, type ExecuteManagedParams, type ExecuteManagedRequest, type ExecuteManagedResponse, type ExecuteTradeRequest, type ExecuteTradeResponse, type ExecutionDagProgress, type ExecutionMode, type ExecutionOrderItem, type ExecutionOrdersQuery, type ExecutionOverallState, type ExecutionPositionGroup, type ExecutionPositionsQuery, type ExecutionStatusOrder, type ExecutionStatusQuery, type ExecutionStatusResponse, type ExecutionStatusStep, type GetBalanceQuery, type GetBalanceResponse, type GetCryptoReferencePricesOptions, type GetHoldingsQuery, type GetHoldingsResponse, type GetOrdersParams, type GetOrdersQuery, type GetPositionsParams, type GetPositionsQuery, type HelloResponse, IMAGE_SIZES, ImageSize, type ListRecurringCryptoMarketsOptions, type ManagedBalancesParams, type MarkSource, type MarketPriceHistory, MarketStatus, MatchStatus, MatchType, type MatchedMidpoint, type MatchedMidpointOutcome, type MatchedOrderbookMarket, type MatchedVenueMarketOutcomeRef, type MatchingReport, type MidpointItem, type MidpointRow, type NewsFeedArticleFeedItem, type NewsFeedArticleFeedResponse, type NewsFeedArticleWithSummary, type NewsFeedLinkedMarket, type NewsFeedListResponse, type NewsFeedMarketFeedArticle, type NewsFeedMarketFeedItem, type NewsFeedMarketFeedResponse, type NewsFeedMarketNewsParams, type NewsFeedMarketNewsResponse, type NewsFeedMarketNewsResult, type NewsFeedPageOptions, type NewsFeedStatusResponse, type NonceResponse, type OrderListItem, type OrderListQuery, OrderStatus, OrderType, type Orderbook, type OrderbookBatchItemError, type OrderbookBatchItemErrorCode, type OrderbookBatchItemStatus, type OrderbookHistoryPoint, type OrderbookHistoryResponse, type OrderbookLevel, type OrderbookQuoteFill, type OrderbookQuoteParams, type OrderbookQuoteResponse, type OrderbookServiceUnavailableError, type OrderbookState, type OrderbooksOnlyError, type OutcomeMidpoint, type OutcomeMidpointRow, type OutcomeOrderbookResponse, type PaginatedResponse, type PaperTradingAccount, type PaperTradingAccountsPage, type PaperTradingAppOptions, type PaperTradingBalanceAdjustment, type PaperTradingBalanceResponse, type PaperTradingLiquidityStatus, type PaperTradingListParams, type PaperTradingMarkSource, type PaperTradingOrder, type PaperTradingOrdersPage, type PaperTradingPortfolio, type PaperTradingPosition, type PaperTradingPositionsPage, type PersistedAuthSnapshot, type PlacePaperTradingOrderParams, type PositionGroup, type PositionRedeemStatus, type PricePoint, type PriceSource, type PricesHistoryResponse, type QuoteManagedParams, type QuoteManagedRequest, type QuoteManagedResponse, type QuoteManagedSplit, type QuoteManagedStep, type QuoteSplit, type QuoteStep, RECURRENCE_CADENCES, type RampQuote, type RampQuoteRequest, type RampSessionRequest, type RampWidgetSession, type RecurrenceCadence, type RecurrenceFilter, type RecurringCryptoComparisonPoint, type RecurringCryptoComparisonPriceSource, type RecurringCryptoDuration, type RecurringCryptoDurationInput, type RecurringCryptoMarketMetrics, type RecurringCryptoMarketsResponse, type RecurringCryptoOrderbookDepthLevel, type RecurringCryptoOrderbookDepthSide, type RecurringCryptoOutcome, type RecurringCryptoOutcomeOrderbookDepth, type RecurringCryptoPriceComparison, type RecurringCryptoReferencePrice, type RecurringCryptoResolution, type RecurringCryptoSourceConfidence, type RecurringCryptoVenueMarket, type RecurringCryptoWindowComparisons, type RecurringCryptoWindowMarket, type RedeemLegResult, type RedeemLegStatus, type RedeemRequest, type RedeemResponse, type RequestedOrderbookMarket, type ResetPaperTradingAccountParams, type ResolveCorrelatedMarketsParams, type ResolveCorrelatedMarketsResponse, type ResolvedCorrelatedMarketsResponse, type RpcTokenResponse, type SafeParseFailure, type SafeParseResult, type SafeParseSuccess, type ServerWallet, type SetPaperTradingBalanceParams, type SettlementSource, type SetupDepositAddressStep, type SetupVenueKeyStep, type SimpleOrderbookLevel, type SmartRouteAllocation, type SmartRouteBridgeStep, type SmartRouteFeeBreakdown, type SmartRouteFill, type SmartRouteParams, type SmartRouteResponse, type SmartRouteSettlementLeg, type SmartRouteSettlementPlan, type SmartRouteSetupCostLine, type SmartRouteSide, type SmartRouteStatus, type SmartRouteVenueFill, type SplitsByAmountResult, type SyncBalancesResponse, TimeInForce, type TradeExecutorOrder, type TradeExecutorOrderListResponse, TradeSide$1 as TradeSide, type TradeSplit, type TradeStep, TurnstileChallengeError, type UnifiedBalanceResponse, type UpdateUserBody, type UpsertVenueKey, type UserActivityBridge, type UserActivityDeposit, type UserActivityItem, type UserActivityQuery, type UserActivityRedeem, type UserActivityRedeemLeg, type UserActivityTrade, type UserActivityType, type UserActivityUserOp, type UserActivityWithdrawal, type UserHolding, type UserProfile, VENUES, type ValidateBalanceOnClientStep, type ValidateManagedParams, type ValidateManagedRequest, type ValidateManagedResponse, type ValidateTradeRequest, type ValidateTradeResponse, Venue, type VenueEvent, type VenueEventListItem, type VenueEventWithMarkets, type VenueKeySummary, type VenueMarket, type VenueMarketClusterNode, type VenueMarketListItem, type VenueMarketOutcome, type VenueMarketRef, type VenueOrderbookEntry, type VenueOrderbookLevel, type VenuePositionBalance, type VenuePriceInfo, type VenueSoloQuote, type VerifyBody, type VerifyResponse, type WalletChainBalance, type WalletTokenBalance, type WithdrawManagedParams, type WithdrawManagedRequest, type WithdrawManagedResponse, type WithdrawManagedSourceItem, type WithdrawPreviewParams, type WithdrawPreviewResponse, type WithdrawTokenSymbol, type WithdrawalExpected, type WithdrawalLeg, type WithdrawalLegStatus, type WithdrawalLegType, type WithdrawalLifecycleStatus, type WithdrawalQuoteParams, type WithdrawalQuoteResponse, type WithdrawalSource, type WithdrawalSourceItem, type WithdrawalSourceStatus, type WithdrawalSourceTokenSymbol, type WsArbFeedBatch, type WsArbFeedEntry, type WsArbMarketUpdate, type WsAttributedLevel, type WsAuthenticated, type WsBalanceUpdate, type WsCandleInterval, type WsClientMessage, type WsConnected, type WsError, type WsHeartbeat, type WsMarkSource, type WsMarketResolved, type WsOrderEvent, type WsOrderEventType, type WsOrderSubmitted, type WsOrderbookDelta, type WsOrderbookSnapshot, type WsRedeemEvent, type WsServerMessage, type WsSubscribed, type WsTrade, type WsUnsubscribed, type WsVenueBook, type WsVenueInfo, type WsVenueLevel, type WsWithdrawalLegStatus, type WsWithdrawalLifecycleEvent, type WsWithdrawalLifecycleLeg, type WsWithdrawalLifecycleStatus, aggregateMidpoint, applyOrderbookDelta, buildVenueUrl, computeBestSplitsByAmount, computeChecksum, createAggClient, enumGuard, formatMarketQuestion, formatOutcomeLabel, formatOutcomeTitle, getWalletAddressFromUserProfile, hasShape, isEmail, isEnum, isFiniteNonNeg, isNonEmptyString, mergeCandles, mergeClosedCandles, normalizeVenueMarketCluster, optimizedImageUrl, parse, parseEmail, parseEmailStrict, safeParse, snapshotToOrderbook, sortVenues };

package/dist/index.d.ts

@@ -408,6 +408,7 @@ type WalletTokenBalance = {
     chains: {
         chainId: number;
         tokenAddress: string;
+        tokenSymbol?: string | undefined;
         balanceRaw: string;
         heldRaw?: string | undefined;
         availableRaw?: string | undefined;
@@ -434,6 +435,7 @@ type UnifiedBalanceResponse = {
         chains: {
             chainId: number;
             tokenAddress: string;
+            tokenSymbol?: string | undefined;
             balanceRaw: string;
             heldRaw?: string | undefined;
             availableRaw?: string | undefined;
@@ -584,7 +586,8 @@ type VenueMarket = {
     question: string;
     venueMarketOutcomes: {
         id: string;
-        price: number;
+        /** REMOVED — no longer returned; use GET /midpoints for live prices. */
+        price?: number | undefined;
         venueMarketId: string;
         label: string;
         title?: string | null | undefined;
@@ -623,6 +626,10 @@ type VenueMarket = {
     period?: string | null | undefined;
     /** Normalized subject category for prop-tab grouping (e.g., game_lines, exact_score, etc.). */
     marketCategory?: string | null | undefined;
+    /** Section/tab grouping key for sports markets (e.g. "player_props", "totals"). */
+    marketGroup?: string | null | undefined;
+    /** Fine-grained sub-classification within a marketGroup (e.g. "moneyline", "rushing_yards"). */
+    marketSubtype?: string | null | undefined;
     /** Line value for spread/total markets (e.g., 2.5 for totals, 3 for spreads). */
     lineValue?: number | null | undefined;
     matchedVenueMarkets?: {
@@ -634,7 +641,8 @@ type VenueMarket = {
         conditionId?: string | null | undefined;
         venueMarketOutcomes?: {
             id: string;
-            price: number;
+            /** REMOVED — no longer returned; use GET /midpoints for live prices. */
+            price?: number | undefined;
             venueMarketId: string;
             label: string;
             winner?: boolean | null | undefined;
@@ -698,8 +706,12 @@ type VenueEvent = {
      * enum values.
      */
     recurrence?: string | null | undefined;
+    /** Deterministic game-level canonical key for cross-venue sports detail loading. */
+    aggKey?: string | null | undefined;
     /** Type-aware structure classification used to sort markets under this event. */
     structureType?: "candidate" | "sport" | "axis" | "dates" | null | undefined;
+    /** Canonical sport slug for sports events (e.g. "basketball", "soccer"); null for non-sports. */
+    sport?: string | null | undefined;
 };
 type Orderbook = {
     bids: {
@@ -802,7 +814,12 @@ type MatchedVenueMarketOutcomeRef = {
 };
 type VenueMarketOutcome = {
     id: string;
-    price: number;
+    /**
+     * REMOVED — /venue-events and /venue-markets no longer return outcome
+     * prices. Fetch live prices from GET /midpoints (or the live-price hooks),
+     * keyed by this outcome's `id`.
+     */
+    price?: number | undefined;
     venueMarketId: string;
     label: string;
     title?: string | null | undefined;
@@ -1477,12 +1494,16 @@ interface WsArbMarketUpdate {
     venueEventId: string | null;
     arbReturn: number;
     ts: number;
+    liquidityUsd?: number;
+    liquidityTier?: "deep" | "shallow";
 }
 interface WsArbFeedEntry {
     marketId: string;
     venueEventId: string | null;
     arbReturn: number;
     ts: number;
+    liquidityUsd?: number;
+    liquidityTier?: "deep" | "shallow";
 }
 interface WsArbFeedBatch {
     type: "arb_feed_batch";
@@ -1765,6 +1786,10 @@ interface AppClientConfigResponse {
     earlyAccessEnabled: boolean;
     authOptions: AppClientAuthOption[];
 }
+interface RpcTokenResponse {
+    token: string;
+    expiresAt: number;
+}
 type AggAuthProviderType = "siwe" | "siws" | "google" | "twitter" | "apple" | "email";
 interface AppClientAuthOption {
     provider: AggAuthProviderType;
@@ -2025,6 +2050,36 @@ interface ListRecurringCryptoMarketsOptions {
     includeOrderbookPrices?: boolean;
     includeReferencePrices?: boolean;
     includeDirectVenueMarkets?: boolean;
+    includeOrderbookDepth?: boolean;
+    orderbookDepth?: number;
+    orderbookDepthAmountUsd?: number;
+}
+interface RecurringCryptoOrderbookDepthLevel {
+    price: number;
+    size: number;
+    notionalUsd: number;
+    cumulativeSize: number;
+    cumulativeNotionalUsd: number;
+    fillSize: number | null;
+    fillNotionalUsd: number | null;
+}
+interface RecurringCryptoOrderbookDepthSide {
+    levels: RecurringCryptoOrderbookDepthLevel[];
+    totalSize: number;
+    totalNotionalUsd: number;
+    requestedNotionalUsd: number | null;
+    filledSize: number | null;
+    filledNotionalUsd: number | null;
+    unfilledNotionalUsd: number | null;
+    avgPrice: number | null;
+    worstPrice: number | null;
+    fillsComplete: boolean | null;
+}
+interface RecurringCryptoOutcomeOrderbookDepth {
+    currency: "USD";
+    amountUsd: number | null;
+    buy: RecurringCryptoOrderbookDepthSide;
+    sell: RecurringCryptoOrderbookDepthSide;
 }
 interface RecurringCryptoOutcome {
     /**
@@ -2045,6 +2100,7 @@ interface RecurringCryptoOutcome {
     bestAsk: number | null;
     markSource: MarkSource | string | null;
     lastKnownPrice: number | null;
+    orderbookDepth: RecurringCryptoOutcomeOrderbookDepth | null;
 }
 interface RecurringCryptoMarketMetrics {
     volume: number | null;
@@ -2422,6 +2478,8 @@ interface ExecuteManagedResponse {
     quoteId: string;
     orderIds: string[];
     status: "pending";
+    redeemId?: string;
+    message?: string;
 }
 interface ValidateManagedParams {
     venueMarketOutcomeIds: string[];
@@ -2441,9 +2499,9 @@ interface WithdrawManagedParams {
     /** Positive integer string in the token's native decimals (e.g. "100000" = 0.1 USDC). */
     amountRaw: string;
     tokenSymbol: WithdrawTokenSymbol;
-    /** EVM 0x-prefixed 20-byte recipient address. */
+    /** Recipient address. EVM destinations use 0x-prefixed 20-byte hex; Solana uses base58. */
     destinationAddress: string;
-    /** EVM chain ID where the recipient should receive funds. Required as of v2026.04. */
+    /** Chain ID where the recipient should receive funds. Required as of v2026.04. */
     destinationChainId: number;
     /**
      * When `true`, the server caps the withdrawal to the maximum deliverable amount
@@ -2495,6 +2553,17 @@ interface WithdrawalExpected {
 }
 /** Body for POST /execution/withdraw/preview — identical to a withdraw request. */
 type WithdrawPreviewParams = WithdrawManagedParams;
+interface WithdrawalQuoteParams {
+    tokenSymbol: WithdrawTokenSymbol;
+    destinationChainId: number;
+}
+interface WithdrawalQuoteResponse {
+    tokenSymbol: WithdrawTokenSymbol;
+    destinationChainId: number;
+    maxDeliverableRaw: string;
+    rawBalanceRaw: string;
+    decimals: number;
+}
 /** Response from POST /execution/withdraw/preview. All amounts are raw strings in destination-token native decimals. */
 interface WithdrawPreviewResponse {
     receiveAmountRaw: string | null;
@@ -2591,6 +2660,60 @@ type ExecutionOrdersQuery = GetOrdersQuery & {
     mode?: ExecutionMode;
 };
 type ExecutionOrderItem = OrderListItem;
+type ExecutionStatusQuery = {
+    quoteId: string;
+    mode?: ExecutionMode;
+};
+type ExecutionOverallState = "created" | "routing" | "quoting" | "placing" | "confirming" | "filled" | "partially_filled" | "failed" | "cancelled" | "expired";
+interface ExecutionDagProgress {
+    dagRunId: string;
+    totalSteps: number;
+    currentSequence: number;
+    currentStepType: string | null;
+    completedSequences: number[];
+    stepTypes: Record<number, string>;
+    status: "running" | "completed" | "failed";
+    errorReason: string | null;
+}
+interface ExecutionStatusStep {
+    sequence: number;
+    stepType: string;
+    status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+    attempt: number;
+    startedAt: string | null;
+    completedAt: string | null;
+    errorReason: string | null;
+}
+interface ExecutionStatusOrder {
+    orderId: string;
+    venue: string;
+    status: string;
+    event: "filled" | "partial_fill" | "failed" | null;
+    filledAmountRaw?: string;
+    remainingAmountRaw?: string;
+    quotedSharesRaw?: string;
+    actualSharesRaw?: string;
+    quotedToWinRaw?: string;
+    actualToWinRaw?: string;
+    quotedPriceRaw?: string;
+    executionPriceRaw?: string;
+    partialFillReason?: string;
+    errorReason?: string;
+    txHash?: string;
+    updatedAt: string;
+}
+interface ExecutionStatusResponse {
+    executionId: string | null;
+    quoteId: string;
+    orderIds: string[];
+    overallState: ExecutionOverallState;
+    terminal: boolean;
+    errorReason: string | null;
+    pollAfterMs: number | null;
+    dagProgress: ExecutionDagProgress | null;
+    steps: ExecutionStatusStep[];
+    orders: ExecutionStatusOrder[];
+}
 type ExecutionPositionsQuery = GetPositionsQuery & {
     mode?: ExecutionMode;
 };
@@ -2606,6 +2729,9 @@ interface PaperTradingListParams {
     limit?: number;
     cursor?: string;
 }
+interface PaperTradingAccountListParams extends PaperTradingListParams {
+    externalId?: string;
+}
 interface CreatePaperTradingAccountParams {
     name?: string;
     externalId?: string;
@@ -3058,6 +3184,24 @@ interface SmartRouteFeeBreakdown {
     appFeeCategory?: string;
 }
 /** Response from GET /orderbook/:venueMarketOutcomeId/route. */
+interface SmartRouteSettlementLeg {
+    action: "redeem";
+    venue: string;
+    venueMarketId: string;
+    venueMarketOutcomeId: string;
+    positionId: string;
+    size: string;
+    redeemPath: "evm" | "svm";
+}
+interface SmartRouteSettlementPlan {
+    redeemId: string;
+    status: "redeem_only" | "partial_redeem";
+    message: string;
+    totalRedeemableShares: number;
+    totalRedeemShares: number;
+    totalSellShares: number;
+    redeemLegs: SmartRouteSettlementLeg[];
+}
 interface SmartRouteResponse {
     quoteId: string;
     venueMarketOutcomeId: string;
@@ -3082,6 +3226,7 @@ interface SmartRouteResponse {
     }>;
     error?: string;
     message?: string;
+    settlementPlan?: SmartRouteSettlementPlan;
     warnings?: Array<{
         venue: string;
         venueMarketOutcomeId: string;
@@ -3334,14 +3479,24 @@ interface CorrelatedMarketsStatus {
 interface CorrelatedMarketQueryResult {
     venueMarketId: string;
     marketQuestion: string;
+    marketStatus: MarketStatus;
+    marketStartDate: string;
+    marketEndDate: string | null;
     eventTitle: string;
+    eventStatus: MarketStatus;
+    eventStartDate: string;
+    eventEndDate: string | null;
     score: number;
     matchedSignal: CorrelatedMarketSignal;
+    matchSource: "signal" | "title_fallback";
     venue: string;
 }
 interface CorrelatedMarketCascadeItem {
     venueEventId: string;
     eventTitle: string;
+    eventStatus: MarketStatus;
+    eventStartDate: string;
+    eventEndDate: string | null;
     score: number;
     action: string;
     reason: string;
@@ -3413,6 +3568,7 @@ declare class AggClient {
     private paperTradingAccountsPath;
     private paperTradingAccountPath;
     private paperTradingListQuery;
+    private paperTradingAccountListQuery;
     private withAuthPayload;
     private restoreSession;
     private persistSession;
@@ -3532,6 +3688,8 @@ declare class AggClient {
      * rollup (total cost, share-weighted avg price, to-win).
      */
     getExecutionOrders(params?: ExecutionOrdersQuery): Promise<PaginatedResponse<ExecutionOrderItem>>;
+    /** Get quote-scoped execution progress, DAG step state, and order leg terminal status. */
+    getExecutionStatus(params: ExecutionStatusQuery): Promise<ExecutionStatusResponse>;
     /** Unified user activity feed (trades, deposits, withdrawals, bridges, wallet ops). */
     getUserActivity(params?: UserActivityQuery): Promise<PaginatedResponse<UserActivityItem>>;
     /** List execution positions for the authenticated user (cursor pagination). */
@@ -3541,7 +3699,7 @@ declare class AggClient {
     /** Create a server-managed paper trading account for an app. Requires adminKey or apiKey. */
     createPaperTradingAccount(params: CreatePaperTradingAccountParams, options?: PaperTradingAppOptions): Promise<PaperTradingAccount>;
     /** List server-managed paper trading accounts for an app. Requires adminKey or apiKey. */
-    listPaperTradingAccounts(params?: PaperTradingListParams & PaperTradingAppOptions): Promise<PaperTradingAccountsPage>;
+    listPaperTradingAccounts(params?: PaperTradingAccountListParams & PaperTradingAppOptions): Promise<PaperTradingAccountsPage>;
     /** Fetch a server-managed paper trading account. Requires adminKey or apiKey. */
     getPaperTradingAccount(accountId: string, options?: PaperTradingAppOptions): Promise<PaperTradingAccount>;
     /** Set a paper trading account cash balance. Requires adminKey or apiKey. */
@@ -3576,6 +3734,13 @@ declare class AggClient {
         maxYesPrice?: number;
         /** ISO-8601 timestamp. Hides events with endDate <= this value. NULL-endDate events are kept. */
         endDateFrom?: string;
+        /**
+         * When true, fold same-venue companion events into one tile per game
+         * (`groupParentId IS NULL`). Sent as `grouped=true`; omitted when false/absent
+         * (default = ungrouped). Consumers showing one tile per game need a detail
+         * view that loads the folded companions via aggKey.
+         */
+        grouped?: boolean;
     }): Promise<PaginatedResponse<VenueEvent>>;
     /** Get a single venue event by ID. Requires appId or admin auth. */
     getVenueEventById(id: string, options?: {
@@ -3595,10 +3760,16 @@ declare class AggClient {
         matchStatus?: MatchStatus;
         status?: MarketStatus;
         categoryIds?: string[];
+        aggKey?: string[];
+        sportsMarketType?: string[];
+        period?: string[];
+        marketCategory?: string[];
+        marketGroup?: string[];
         limit?: number;
         cursor?: string;
         sortBy?: "volume" | "volume24hr" | "createdAt" | "yesPrice" | "updatedAt";
         sortDir?: "asc" | "desc";
+        context?: "list" | "detail";
     }): Promise<PaginatedResponse<VenueMarket>>;
     /** Get categories with cursor-based pagination. Requires appId. */
     getCategories(options?: {
@@ -3608,6 +3779,8 @@ declare class AggClient {
     }): Promise<PaginatedResponse<Category>>;
     /** Get per-app UI config (disabled venues + category presets). Requires appId. */
     getAppConfig(init?: RequestInit): Promise<AppClientConfigResponse>;
+    /** Get a temporary Alchemy JWT token for RPC connections. */
+    getRpcToken(init?: RequestInit): Promise<RpcTokenResponse>;
     private buildNewsFeedQuery;
     /** List available market news feeds and item counts. */
     getNewsFeeds(options?: {
@@ -3652,6 +3825,8 @@ declare class AggClient {
         text: string;
         limit?: number;
         includeResolved?: boolean;
+        direction?: "more_likely" | "less_likely";
+        balanced?: boolean;
     }, options?: {
         signal?: AbortSignal;
     }): Promise<{
@@ -3738,6 +3913,8 @@ declare class AggClient {
      * integrating against the SDK can ignore this entirely.
      */
     withdrawPreview(params: WithdrawPreviewParams): Promise<WithdrawPreviewResponse>;
+    /** Quote maximum deliverable withdrawal amount for a token and destination chain. */
+    getWithdrawalQuote(params: WithdrawalQuoteParams): Promise<WithdrawalQuoteResponse>;
     /**
      * Read the current persisted state of a withdrawal. Used as a backfill for
      * the WS lifecycle channel: the client polls this on hook mount and on WS
@@ -3850,4 +4027,4 @@ declare function aggregateMidpoint(midpoints: (number | null | undefined)[]): nu
 
 declare function createAggClient(options: AggClientOptions): AggClient;
 
-export { type Account, AccountProvider, AccountType, type AggAuthDeliveryMode, type AggAuthProviderType, type AggAuthStartBody, type AggAuthStartResult, type AggAuthVerifyBody, AggClient, type AggClientAuthOptions, type AggClientSessionInput, type AggLinkAccountBody, type AggLinkAccountConfirmResult, type AggLinkAccountResult, type AggSessionUser, AggWebSocket, type AggWebSocketCallbacks, type AggWebSocketOptions, type AggregatedOrderbookLevel, type AggregatedOrderbookResponse, type App, type AppClientConfigResponse, type AttributedOrderbook, type AttributedOrderbookLevel, type AuthCodeResponse, type AuthStatus, type AuthTokenResponse, type AuthUser, type BatchMidpointsResponse, type BatchOrderbooksResponse, type BuildVenueUrlOpts, CONFIRMED_MATCH_STATUSES, type CancelManagedExecutionResponse, type Candle, CandleBuilder, type CandleInterval, type Category, Chain, type ChartBarsResponse, type ChartCandle, type ChartResolution, type ChartVenueCandles, type ComputeSplitsRequest, type ComputeSplitsResponse, type ComputeSplitsSelection, type CorrelatedMarketCascadeItem, type CorrelatedMarketCascadeResponse, type CorrelatedMarketQueryResult, type CorrelatedMarketSide, type CorrelatedMarketSignal, type CorrelatedMarketSignalBatch, type CorrelatedMarketSignalDirection, type CorrelatedMarketsStatus, type CreateApp, type CreatePaperTradingAccountParams, type CryptoReferencePriceError, type CryptoReferencePriceExternalMarketInput, type CryptoReferencePriceMarketInput, type CryptoReferencePriceResult, type CryptoReferencePriceSource, type CryptoReferencePriceTarget, type CryptoReferencePricesResponse, type DepositAddressesPendingResponse, type DepositAddressesReadyResponse, type DepositAddressesResponse, type DepositAddressesSupportedChain, type DepositAddressesToken, type DepositStep, type DiagnosticCallback, type DiagnosticEvent, type ExecuteManagedParams, type ExecuteManagedRequest, type ExecuteManagedResponse, type ExecuteTradeRequest, type ExecuteTradeResponse, type ExecutionMode, type ExecutionOrderItem, type ExecutionOrdersQuery, type ExecutionPositionGroup, type ExecutionPositionsQuery, type GetBalanceQuery, type GetBalanceResponse, type GetCryptoReferencePricesOptions, type GetHoldingsQuery, type GetHoldingsResponse, type GetOrdersParams, type GetOrdersQuery, type GetPositionsParams, type GetPositionsQuery, type HelloResponse, IMAGE_SIZES, ImageSize, type ListRecurringCryptoMarketsOptions, type ManagedBalancesParams, type MarkSource, type MarketPriceHistory, MarketStatus, MatchStatus, MatchType, type MatchedMidpoint, type MatchedMidpointOutcome, type MatchedOrderbookMarket, type MatchedVenueMarketOutcomeRef, type MatchingReport, type MidpointItem, type MidpointRow, type NewsFeedArticleFeedItem, type NewsFeedArticleFeedResponse, type NewsFeedArticleWithSummary, type NewsFeedLinkedMarket, type NewsFeedListResponse, type NewsFeedMarketFeedArticle, type NewsFeedMarketFeedItem, type NewsFeedMarketFeedResponse, type NewsFeedMarketNewsParams, type NewsFeedMarketNewsResponse, type NewsFeedMarketNewsResult, type NewsFeedPageOptions, type NewsFeedStatusResponse, type NonceResponse, type OrderListItem, type OrderListQuery, OrderStatus, OrderType, type Orderbook, type OrderbookBatchItemError, type OrderbookBatchItemErrorCode, type OrderbookBatchItemStatus, type OrderbookHistoryPoint, type OrderbookHistoryResponse, type OrderbookLevel, type OrderbookQuoteFill, type OrderbookQuoteParams, type OrderbookQuoteResponse, type OrderbookServiceUnavailableError, type OrderbookState, type OrderbooksOnlyError, type OutcomeMidpoint, type OutcomeMidpointRow, type OutcomeOrderbookResponse, type PaginatedResponse, type PaperTradingAccount, type PaperTradingAccountsPage, type PaperTradingAppOptions, type PaperTradingBalanceAdjustment, type PaperTradingBalanceResponse, type PaperTradingLiquidityStatus, type PaperTradingListParams, type PaperTradingMarkSource, type PaperTradingOrder, type PaperTradingOrdersPage, type PaperTradingPortfolio, type PaperTradingPosition, type PaperTradingPositionsPage, type PersistedAuthSnapshot, type PlacePaperTradingOrderParams, type PositionGroup, type PositionRedeemStatus, type PricePoint, type PriceSource, type PricesHistoryResponse, type QuoteManagedParams, type QuoteManagedRequest, type QuoteManagedResponse, type QuoteManagedSplit, type QuoteManagedStep, type QuoteSplit, type QuoteStep, RECURRENCE_CADENCES, type RampQuote, type RampQuoteRequest, type RampSessionRequest, type RampWidgetSession, type RecurrenceCadence, type RecurrenceFilter, type RecurringCryptoComparisonPoint, type RecurringCryptoComparisonPriceSource, type RecurringCryptoDuration, type RecurringCryptoDurationInput, type RecurringCryptoMarketMetrics, type RecurringCryptoMarketsResponse, type RecurringCryptoOutcome, type RecurringCryptoPriceComparison, type RecurringCryptoReferencePrice, type RecurringCryptoResolution, type RecurringCryptoSourceConfidence, type RecurringCryptoVenueMarket, type RecurringCryptoWindowComparisons, type RecurringCryptoWindowMarket, type RedeemLegResult, type RedeemLegStatus, type RedeemRequest, type RedeemResponse, type RequestedOrderbookMarket, type ResetPaperTradingAccountParams, type ResolveCorrelatedMarketsParams, type ResolveCorrelatedMarketsResponse, type ResolvedCorrelatedMarketsResponse, type SafeParseFailure, type SafeParseResult, type SafeParseSuccess, type ServerWallet, type SetPaperTradingBalanceParams, type SettlementSource, type SetupDepositAddressStep, type SetupVenueKeyStep, type SimpleOrderbookLevel, type SmartRouteAllocation, type SmartRouteBridgeStep, type SmartRouteFeeBreakdown, type SmartRouteFill, type SmartRouteParams, type SmartRouteResponse, type SmartRouteSetupCostLine, type SmartRouteSide, type SmartRouteStatus, type SmartRouteVenueFill, type SplitsByAmountResult, type SyncBalancesResponse, TimeInForce, type TradeExecutorOrder, type TradeExecutorOrderListResponse, TradeSide$1 as TradeSide, type TradeSplit, type TradeStep, TurnstileChallengeError, type UnifiedBalanceResponse, type UpdateUserBody, type UpsertVenueKey, type UserActivityBridge, type UserActivityDeposit, type UserActivityItem, type UserActivityQuery, type UserActivityRedeem, type UserActivityRedeemLeg, type UserActivityTrade, type UserActivityType, type UserActivityUserOp, type UserActivityWithdrawal, type UserHolding, type UserProfile, VENUES, type ValidateBalanceOnClientStep, type ValidateManagedParams, type ValidateManagedRequest, type ValidateManagedResponse, type ValidateTradeRequest, type ValidateTradeResponse, Venue, type VenueEvent, type VenueEventListItem, type VenueEventWithMarkets, type VenueKeySummary, type VenueMarket, type VenueMarketClusterNode, type VenueMarketListItem, type VenueMarketOutcome, type VenueMarketRef, type VenueOrderbookEntry, type VenueOrderbookLevel, type VenuePositionBalance, type VenuePriceInfo, type VenueSoloQuote, type VerifyBody, type VerifyResponse, type WalletChainBalance, type WalletTokenBalance, type WithdrawManagedParams, type WithdrawManagedRequest, type WithdrawManagedResponse, type WithdrawManagedSourceItem, type WithdrawPreviewParams, type WithdrawPreviewResponse, type WithdrawTokenSymbol, type WithdrawalExpected, type WithdrawalLeg, type WithdrawalLegStatus, type WithdrawalLegType, type WithdrawalLifecycleStatus, type WithdrawalSource, type WithdrawalSourceItem, type WithdrawalSourceStatus, type WithdrawalSourceTokenSymbol, type WsArbFeedBatch, type WsArbFeedEntry, type WsArbMarketUpdate, type WsAttributedLevel, type WsAuthenticated, type WsBalanceUpdate, type WsCandleInterval, type WsClientMessage, type WsConnected, type WsError, type WsHeartbeat, type WsMarkSource, type WsMarketResolved, type WsOrderEvent, type WsOrderEventType, type WsOrderSubmitted, type WsOrderbookDelta, type WsOrderbookSnapshot, type WsRedeemEvent, type WsServerMessage, type WsSubscribed, type WsTrade, type WsUnsubscribed, type WsVenueBook, type WsVenueInfo, type WsVenueLevel, type WsWithdrawalLegStatus, type WsWithdrawalLifecycleEvent, type WsWithdrawalLifecycleLeg, type WsWithdrawalLifecycleStatus, aggregateMidpoint, applyOrderbookDelta, buildVenueUrl, computeBestSplitsByAmount, computeChecksum, createAggClient, enumGuard, formatMarketQuestion, formatOutcomeLabel, formatOutcomeTitle, getWalletAddressFromUserProfile, hasShape, isEmail, isEnum, isFiniteNonNeg, isNonEmptyString, mergeCandles, mergeClosedCandles, normalizeVenueMarketCluster, optimizedImageUrl, parse, parseEmail, parseEmailStrict, safeParse, snapshotToOrderbook, sortVenues };
+export { type Account, AccountProvider, AccountType, type AggAuthDeliveryMode, type AggAuthProviderType, type AggAuthStartBody, type AggAuthStartResult, type AggAuthVerifyBody, AggClient, type AggClientAuthOptions, type AggClientSessionInput, type AggLinkAccountBody, type AggLinkAccountConfirmResult, type AggLinkAccountResult, type AggSessionUser, AggWebSocket, type AggWebSocketCallbacks, type AggWebSocketOptions, type AggregatedOrderbookLevel, type AggregatedOrderbookResponse, type App, type AppClientConfigResponse, type AttributedOrderbook, type AttributedOrderbookLevel, type AuthCodeResponse, type AuthStatus, type AuthTokenResponse, type AuthUser, type BatchMidpointsResponse, type BatchOrderbooksResponse, type BuildVenueUrlOpts, CONFIRMED_MATCH_STATUSES, type CancelManagedExecutionResponse, type Candle, CandleBuilder, type CandleInterval, type Category, Chain, type ChartBarsResponse, type ChartCandle, type ChartResolution, type ChartVenueCandles, type ComputeSplitsRequest, type ComputeSplitsResponse, type ComputeSplitsSelection, type CorrelatedMarketCascadeItem, type CorrelatedMarketCascadeResponse, type CorrelatedMarketQueryResult, type CorrelatedMarketSide, type CorrelatedMarketSignal, type CorrelatedMarketSignalBatch, type CorrelatedMarketSignalDirection, type CorrelatedMarketsStatus, type CreateApp, type CreatePaperTradingAccountParams, type CryptoReferencePriceError, type CryptoReferencePriceExternalMarketInput, type CryptoReferencePriceMarketInput, type CryptoReferencePriceResult, type CryptoReferencePriceSource, type CryptoReferencePriceTarget, type CryptoReferencePricesResponse, type DepositAddressesPendingResponse, type DepositAddressesReadyResponse, type DepositAddressesResponse, type DepositAddressesSupportedChain, type DepositAddressesToken, type DepositStep, type DiagnosticCallback, type DiagnosticEvent, type ExecuteManagedParams, type ExecuteManagedRequest, type ExecuteManagedResponse, type ExecuteTradeRequest, type ExecuteTradeResponse, type ExecutionDagProgress, type ExecutionMode, type ExecutionOrderItem, type ExecutionOrdersQuery, type ExecutionOverallState, type ExecutionPositionGroup, type ExecutionPositionsQuery, type ExecutionStatusOrder, type ExecutionStatusQuery, type ExecutionStatusResponse, type ExecutionStatusStep, type GetBalanceQuery, type GetBalanceResponse, type GetCryptoReferencePricesOptions, type GetHoldingsQuery, type GetHoldingsResponse, type GetOrdersParams, type GetOrdersQuery, type GetPositionsParams, type GetPositionsQuery, type HelloResponse, IMAGE_SIZES, ImageSize, type ListRecurringCryptoMarketsOptions, type ManagedBalancesParams, type MarkSource, type MarketPriceHistory, MarketStatus, MatchStatus, MatchType, type MatchedMidpoint, type MatchedMidpointOutcome, type MatchedOrderbookMarket, type MatchedVenueMarketOutcomeRef, type MatchingReport, type MidpointItem, type MidpointRow, type NewsFeedArticleFeedItem, type NewsFeedArticleFeedResponse, type NewsFeedArticleWithSummary, type NewsFeedLinkedMarket, type NewsFeedListResponse, type NewsFeedMarketFeedArticle, type NewsFeedMarketFeedItem, type NewsFeedMarketFeedResponse, type NewsFeedMarketNewsParams, type NewsFeedMarketNewsResponse, type NewsFeedMarketNewsResult, type NewsFeedPageOptions, type NewsFeedStatusResponse, type NonceResponse, type OrderListItem, type OrderListQuery, OrderStatus, OrderType, type Orderbook, type OrderbookBatchItemError, type OrderbookBatchItemErrorCode, type OrderbookBatchItemStatus, type OrderbookHistoryPoint, type OrderbookHistoryResponse, type OrderbookLevel, type OrderbookQuoteFill, type OrderbookQuoteParams, type OrderbookQuoteResponse, type OrderbookServiceUnavailableError, type OrderbookState, type OrderbooksOnlyError, type OutcomeMidpoint, type OutcomeMidpointRow, type OutcomeOrderbookResponse, type PaginatedResponse, type PaperTradingAccount, type PaperTradingAccountsPage, type PaperTradingAppOptions, type PaperTradingBalanceAdjustment, type PaperTradingBalanceResponse, type PaperTradingLiquidityStatus, type PaperTradingListParams, type PaperTradingMarkSource, type PaperTradingOrder, type PaperTradingOrdersPage, type PaperTradingPortfolio, type PaperTradingPosition, type PaperTradingPositionsPage, type PersistedAuthSnapshot, type PlacePaperTradingOrderParams, type PositionGroup, type PositionRedeemStatus, type PricePoint, type PriceSource, type PricesHistoryResponse, type QuoteManagedParams, type QuoteManagedRequest, type QuoteManagedResponse, type QuoteManagedSplit, type QuoteManagedStep, type QuoteSplit, type QuoteStep, RECURRENCE_CADENCES, type RampQuote, type RampQuoteRequest, type RampSessionRequest, type RampWidgetSession, type RecurrenceCadence, type RecurrenceFilter, type RecurringCryptoComparisonPoint, type RecurringCryptoComparisonPriceSource, type RecurringCryptoDuration, type RecurringCryptoDurationInput, type RecurringCryptoMarketMetrics, type RecurringCryptoMarketsResponse, type RecurringCryptoOrderbookDepthLevel, type RecurringCryptoOrderbookDepthSide, type RecurringCryptoOutcome, type RecurringCryptoOutcomeOrderbookDepth, type RecurringCryptoPriceComparison, type RecurringCryptoReferencePrice, type RecurringCryptoResolution, type RecurringCryptoSourceConfidence, type RecurringCryptoVenueMarket, type RecurringCryptoWindowComparisons, type RecurringCryptoWindowMarket, type RedeemLegResult, type RedeemLegStatus, type RedeemRequest, type RedeemResponse, type RequestedOrderbookMarket, type ResetPaperTradingAccountParams, type ResolveCorrelatedMarketsParams, type ResolveCorrelatedMarketsResponse, type ResolvedCorrelatedMarketsResponse, type RpcTokenResponse, type SafeParseFailure, type SafeParseResult, type SafeParseSuccess, type ServerWallet, type SetPaperTradingBalanceParams, type SettlementSource, type SetupDepositAddressStep, type SetupVenueKeyStep, type SimpleOrderbookLevel, type SmartRouteAllocation, type SmartRouteBridgeStep, type SmartRouteFeeBreakdown, type SmartRouteFill, type SmartRouteParams, type SmartRouteResponse, type SmartRouteSettlementLeg, type SmartRouteSettlementPlan, type SmartRouteSetupCostLine, type SmartRouteSide, type SmartRouteStatus, type SmartRouteVenueFill, type SplitsByAmountResult, type SyncBalancesResponse, TimeInForce, type TradeExecutorOrder, type TradeExecutorOrderListResponse, TradeSide$1 as TradeSide, type TradeSplit, type TradeStep, TurnstileChallengeError, type UnifiedBalanceResponse, type UpdateUserBody, type UpsertVenueKey, type UserActivityBridge, type UserActivityDeposit, type UserActivityItem, type UserActivityQuery, type UserActivityRedeem, type UserActivityRedeemLeg, type UserActivityTrade, type UserActivityType, type UserActivityUserOp, type UserActivityWithdrawal, type UserHolding, type UserProfile, VENUES, type ValidateBalanceOnClientStep, type ValidateManagedParams, type ValidateManagedRequest, type ValidateManagedResponse, type ValidateTradeRequest, type ValidateTradeResponse, Venue, type VenueEvent, type VenueEventListItem, type VenueEventWithMarkets, type VenueKeySummary, type VenueMarket, type VenueMarketClusterNode, type VenueMarketListItem, type VenueMarketOutcome, type VenueMarketRef, type VenueOrderbookEntry, type VenueOrderbookLevel, type VenuePositionBalance, type VenuePriceInfo, type VenueSoloQuote, type VerifyBody, type VerifyResponse, type WalletChainBalance, type WalletTokenBalance, type WithdrawManagedParams, type WithdrawManagedRequest, type WithdrawManagedResponse, type WithdrawManagedSourceItem, type WithdrawPreviewParams, type WithdrawPreviewResponse, type WithdrawTokenSymbol, type WithdrawalExpected, type WithdrawalLeg, type WithdrawalLegStatus, type WithdrawalLegType, type WithdrawalLifecycleStatus, type WithdrawalQuoteParams, type WithdrawalQuoteResponse, type WithdrawalSource, type WithdrawalSourceItem, type WithdrawalSourceStatus, type WithdrawalSourceTokenSymbol, type WsArbFeedBatch, type WsArbFeedEntry, type WsArbMarketUpdate, type WsAttributedLevel, type WsAuthenticated, type WsBalanceUpdate, type WsCandleInterval, type WsClientMessage, type WsConnected, type WsError, type WsHeartbeat, type WsMarkSource, type WsMarketResolved, type WsOrderEvent, type WsOrderEventType, type WsOrderSubmitted, type WsOrderbookDelta, type WsOrderbookSnapshot, type WsRedeemEvent, type WsServerMessage, type WsSubscribed, type WsTrade, type WsUnsubscribed, type WsVenueBook, type WsVenueInfo, type WsVenueLevel, type WsWithdrawalLegStatus, type WsWithdrawalLifecycleEvent, type WsWithdrawalLifecycleLeg, type WsWithdrawalLifecycleStatus, aggregateMidpoint, applyOrderbookDelta, buildVenueUrl, computeBestSplitsByAmount, computeChecksum, createAggClient, enumGuard, formatMarketQuestion, formatOutcomeLabel, formatOutcomeTitle, getWalletAddressFromUserProfile, hasShape, isEmail, isEnum, isFiniteNonNeg, isNonEmptyString, mergeCandles, mergeClosedCandles, normalizeVenueMarketCluster, optimizedImageUrl, parse, parseEmail, parseEmailStrict, safeParse, snapshotToOrderbook, sortVenues };

package/dist/index.js

@@ -1703,6 +1703,12 @@ var AggClient = class {
     if (params.cursor) query.cursor = params.cursor;
     return Object.keys(query).length ? query : void 0;
   }
+  paperTradingAccountListQuery(params = {}) {
+    var _a;
+    const query = (_a = this.paperTradingListQuery(params)) != null ? _a : {};
+    if (params.externalId) query.externalId = params.externalId;
+    return Object.keys(query).length ? query : void 0;
+  }
   withAuthPayload(payload) {
     var _a, _b, _c;
     if (typeof payload.earlyAccessCode === "string" && payload.earlyAccessCode.trim().length > 0) {
@@ -2297,6 +2303,14 @@ Issued At: ${issuedAt}`;
       });
     });
   }
+  /** Get quote-scoped execution progress, DAG step state, and order leg terminal status. */
+  getExecutionStatus(params) {
+    return __async(this, null, function* () {
+      const query = { quoteId: params.quoteId };
+      if (params.mode) query.mode = params.mode;
+      return this.request("/execution/status", { query });
+    });
+  }
   /** Unified user activity feed (trades, deposits, withdrawals, bridges, wallet ops). */
   getUserActivity() {
     return __async(this, arguments, function* (params = {}) {
@@ -2346,7 +2360,7 @@ Issued At: ${issuedAt}`;
     return __async(this, arguments, function* (params = {}) {
       const _a = params, { appId } = _a, listParams = __objRest(_a, ["appId"]);
       return this.request(this.paperTradingAccountsPath(appId), {
-        query: this.paperTradingListQuery(listParams)
+        query: this.paperTradingAccountListQuery(listParams)
       });
     });
   }
@@ -2460,6 +2474,7 @@ Issued At: ${issuedAt}`;
       if ((options == null ? void 0 : options.minYesPrice) != null) query.minYesPrice = String(options.minYesPrice);
       if ((options == null ? void 0 : options.maxYesPrice) != null) query.maxYesPrice = String(options.maxYesPrice);
       if (options == null ? void 0 : options.endDateFrom) query.endDateFrom = options.endDateFrom;
+      if (options == null ? void 0 : options.grouped) query.grouped = "true";
       return this.request("/venue-events", {
         query: Object.keys(query).length > 0 ? query : void 0
       });
@@ -2469,6 +2484,10 @@ Issued At: ${issuedAt}`;
   getVenueEventById(id, options) {
     return __async(this, null, function* () {
       return this.request(`/venue-events/${encodeURIComponent(id)}`, {
+        // Opt into the lean response (no embedded `venueMarkets`) — markets are
+        // fetched separately via GET /venue-markets. Empty `expand` (no `markets`
+        // token) tells the API to omit the deprecated embedded array.
+        query: { expand: "" },
         signal: options == null ? void 0 : options.signal
       });
     });
@@ -2496,6 +2515,15 @@ Issued At: ${issuedAt}`;
       if ((options == null ? void 0 : options.includeDirectVenueMarkets) != null) {
         query.includeDirectVenueMarkets = String(options.includeDirectVenueMarkets);
       }
+      if ((options == null ? void 0 : options.includeOrderbookDepth) != null) {
+        query.includeOrderbookDepth = String(options.includeOrderbookDepth);
+      }
+      if ((options == null ? void 0 : options.orderbookDepth) != null) {
+        query.orderbookDepth = String(options.orderbookDepth);
+      }
+      if ((options == null ? void 0 : options.orderbookDepthAmountUsd) != null) {
+        query.orderbookDepthAmountUsd = String(options.orderbookDepthAmountUsd);
+      }
       return this.request("/crypto/recurring-markets", {
         query: Object.keys(query).length > 0 ? query : void 0,
         signal: options == null ? void 0 : options.signal
@@ -2571,10 +2599,22 @@ Issued At: ${issuedAt}`;
       if (options == null ? void 0 : options.status) query.status = options.status;
       if ((options == null ? void 0 : options.categoryIds) && options.categoryIds.length > 0)
         query.categoryIds = options.categoryIds;
+      if ((options == null ? void 0 : options.aggKey) && options.aggKey.length > 0) query.aggKey = options.aggKey;
+      if ((options == null ? void 0 : options.sportsMarketType) && options.sportsMarketType.length > 0) {
+        query.sportsMarketType = options.sportsMarketType;
+      }
+      if ((options == null ? void 0 : options.period) && options.period.length > 0) query.period = options.period;
+      if ((options == null ? void 0 : options.marketCategory) && options.marketCategory.length > 0) {
+        query.marketCategory = options.marketCategory;
+      }
+      if ((options == null ? void 0 : options.marketGroup) && options.marketGroup.length > 0) {
+        query.marketGroup = options.marketGroup;
+      }
       if ((options == null ? void 0 : options.limit) != null) query.limit = String(options.limit);
       if (options == null ? void 0 : options.cursor) query.cursor = options.cursor;
       if (options == null ? void 0 : options.sortBy) query.sortBy = options.sortBy;
       if (options == null ? void 0 : options.sortDir) query.sortDir = options.sortDir;
+      if (options == null ? void 0 : options.context) query.context = options.context;
       return this.request("/venue-markets", {
         query: Object.keys(query).length > 0 ? query : void 0
       });
@@ -2598,6 +2638,12 @@ Issued At: ${issuedAt}`;
       return this.request("/app/config", init);
     });
   }
+  /** Get a temporary Alchemy JWT token for RPC connections. */
+  getRpcToken(init) {
+    return __async(this, null, function* () {
+      return this.request("/app/rpc-tokens/alchemy", init);
+    });
+  }
   buildNewsFeedQuery(options) {
     const query = {};
     if (options == null ? void 0 : options.cursor) query.cursor = options.cursor;
@@ -2901,6 +2947,15 @@ Issued At: ${issuedAt}`;
       });
     });
   }
+  /** Quote maximum deliverable withdrawal amount for a token and destination chain. */
+  getWithdrawalQuote(params) {
+    return __async(this, null, function* () {
+      return this.request("/execution/withdrawable/quote", {
+        method: "POST",
+        body: JSON.stringify(params)
+      });
+    });
+  }
   /**
    * Read the current persisted state of a withdrawal. Used as a backfill for
    * the WS lifecycle channel: the client polls this on hook mount and on WS

package/dist/index.mjs

@@ -1590,6 +1590,12 @@ var AggClient = class {
     if (params.cursor) query.cursor = params.cursor;
     return Object.keys(query).length ? query : void 0;
   }
+  paperTradingAccountListQuery(params = {}) {
+    var _a;
+    const query = (_a = this.paperTradingListQuery(params)) != null ? _a : {};
+    if (params.externalId) query.externalId = params.externalId;
+    return Object.keys(query).length ? query : void 0;
+  }
   withAuthPayload(payload) {
     var _a, _b, _c;
     if (typeof payload.earlyAccessCode === "string" && payload.earlyAccessCode.trim().length > 0) {
@@ -2184,6 +2190,14 @@ Issued At: ${issuedAt}`;
       });
     });
   }
+  /** Get quote-scoped execution progress, DAG step state, and order leg terminal status. */
+  getExecutionStatus(params) {
+    return __async(this, null, function* () {
+      const query = { quoteId: params.quoteId };
+      if (params.mode) query.mode = params.mode;
+      return this.request("/execution/status", { query });
+    });
+  }
   /** Unified user activity feed (trades, deposits, withdrawals, bridges, wallet ops). */
   getUserActivity() {
     return __async(this, arguments, function* (params = {}) {
@@ -2233,7 +2247,7 @@ Issued At: ${issuedAt}`;
     return __async(this, arguments, function* (params = {}) {
       const _a = params, { appId } = _a, listParams = __objRest(_a, ["appId"]);
       return this.request(this.paperTradingAccountsPath(appId), {
-        query: this.paperTradingListQuery(listParams)
+        query: this.paperTradingAccountListQuery(listParams)
       });
     });
   }
@@ -2347,6 +2361,7 @@ Issued At: ${issuedAt}`;
       if ((options == null ? void 0 : options.minYesPrice) != null) query.minYesPrice = String(options.minYesPrice);
       if ((options == null ? void 0 : options.maxYesPrice) != null) query.maxYesPrice = String(options.maxYesPrice);
       if (options == null ? void 0 : options.endDateFrom) query.endDateFrom = options.endDateFrom;
+      if (options == null ? void 0 : options.grouped) query.grouped = "true";
       return this.request("/venue-events", {
         query: Object.keys(query).length > 0 ? query : void 0
       });
@@ -2356,6 +2371,10 @@ Issued At: ${issuedAt}`;
   getVenueEventById(id, options) {
     return __async(this, null, function* () {
       return this.request(`/venue-events/${encodeURIComponent(id)}`, {
+        // Opt into the lean response (no embedded `venueMarkets`) — markets are
+        // fetched separately via GET /venue-markets. Empty `expand` (no `markets`
+        // token) tells the API to omit the deprecated embedded array.
+        query: { expand: "" },
         signal: options == null ? void 0 : options.signal
       });
     });
@@ -2383,6 +2402,15 @@ Issued At: ${issuedAt}`;
       if ((options == null ? void 0 : options.includeDirectVenueMarkets) != null) {
         query.includeDirectVenueMarkets = String(options.includeDirectVenueMarkets);
       }
+      if ((options == null ? void 0 : options.includeOrderbookDepth) != null) {
+        query.includeOrderbookDepth = String(options.includeOrderbookDepth);
+      }
+      if ((options == null ? void 0 : options.orderbookDepth) != null) {
+        query.orderbookDepth = String(options.orderbookDepth);
+      }
+      if ((options == null ? void 0 : options.orderbookDepthAmountUsd) != null) {
+        query.orderbookDepthAmountUsd = String(options.orderbookDepthAmountUsd);
+      }
       return this.request("/crypto/recurring-markets", {
         query: Object.keys(query).length > 0 ? query : void 0,
         signal: options == null ? void 0 : options.signal
@@ -2458,10 +2486,22 @@ Issued At: ${issuedAt}`;
       if (options == null ? void 0 : options.status) query.status = options.status;
       if ((options == null ? void 0 : options.categoryIds) && options.categoryIds.length > 0)
         query.categoryIds = options.categoryIds;
+      if ((options == null ? void 0 : options.aggKey) && options.aggKey.length > 0) query.aggKey = options.aggKey;
+      if ((options == null ? void 0 : options.sportsMarketType) && options.sportsMarketType.length > 0) {
+        query.sportsMarketType = options.sportsMarketType;
+      }
+      if ((options == null ? void 0 : options.period) && options.period.length > 0) query.period = options.period;
+      if ((options == null ? void 0 : options.marketCategory) && options.marketCategory.length > 0) {
+        query.marketCategory = options.marketCategory;
+      }
+      if ((options == null ? void 0 : options.marketGroup) && options.marketGroup.length > 0) {
+        query.marketGroup = options.marketGroup;
+      }
       if ((options == null ? void 0 : options.limit) != null) query.limit = String(options.limit);
       if (options == null ? void 0 : options.cursor) query.cursor = options.cursor;
       if (options == null ? void 0 : options.sortBy) query.sortBy = options.sortBy;
       if (options == null ? void 0 : options.sortDir) query.sortDir = options.sortDir;
+      if (options == null ? void 0 : options.context) query.context = options.context;
       return this.request("/venue-markets", {
         query: Object.keys(query).length > 0 ? query : void 0
       });
@@ -2485,6 +2525,12 @@ Issued At: ${issuedAt}`;
       return this.request("/app/config", init);
     });
   }
+  /** Get a temporary Alchemy JWT token for RPC connections. */
+  getRpcToken(init) {
+    return __async(this, null, function* () {
+      return this.request("/app/rpc-tokens/alchemy", init);
+    });
+  }
   buildNewsFeedQuery(options) {
     const query = {};
     if (options == null ? void 0 : options.cursor) query.cursor = options.cursor;
@@ -2788,6 +2834,15 @@ Issued At: ${issuedAt}`;
       });
     });
   }
+  /** Quote maximum deliverable withdrawal amount for a token and destination chain. */
+  getWithdrawalQuote(params) {
+    return __async(this, null, function* () {
+      return this.request("/execution/withdrawable/quote", {
+        method: "POST",
+        body: JSON.stringify(params)
+      });
+    });
+  }
   /**
    * Read the current persisted state of a withdrawal. Used as a backfill for
    * the WS lifecycle channel: the client polls this on hook mount and on WS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/sdk",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "description": "Vanilla TypeScript client for the AGG prediction market aggregator (auth, markets, orderbooks, charts, trading, managed execution, WebSockets). Works in browsers, Node.js, and React Native.",
   "sideEffects": false,
   "license": "MIT",
@@ -62,8 +62,8 @@
     }
   },
   "dependencies": {
-    "@polymarket/builder-signing-sdk": "^0.0.8",
-    "@polymarket/clob-client": "^5.2.3",
+    "@polymarket/builder-signing-sdk": "^1.0.0",
+    "@polymarket/clob-client": "^5.8.1",
     "ethers": "^5.7.2",
     "viem": "^2.46.2"
   },