@agg-build/sdk 2.1.3 → 2.2.1

package/dist/index.d.mts

@@ -586,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;
@@ -640,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;
@@ -812,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;
@@ -864,6 +871,7 @@ type MidpointItem = {
     timestamp: number | null;
     outcomes: OutcomeMidpoint[];
     matched: MatchedMidpoint[];
+    arbReturn?: number | null | undefined;
 };
 type ComputeSplitsRequest = {
     side: TradeSide$1;
@@ -1321,13 +1329,21 @@ interface WsTrade {
 type WsCandleInterval = "1m" | "5m" | "1h" | "1d";
 interface WsSubscribed {
     type: "subscribed";
+    /** Confirmed ids. For `orderbook`/`trades` these are venueMarketOutcomeIds.
+     *  For `arb` this historically mirrors the marketIds — prefer `marketIds`. */
     outcomeIds: string[];
-    channel: "orderbook" | "trades";
+    /** Confirmed marketIds — only set on `arb` confirmations, whose
+     *  subscriptions are keyed by marketIds, not outcomeIds. */
+    marketIds?: string[];
+    channel: "orderbook" | "trades" | "arb" | "arb-feed";
 }
 interface WsUnsubscribed {
     type: "unsubscribed";
+    /** See {@link WsSubscribed.outcomeIds}. */
     outcomeIds: string[];
-    channel: "orderbook" | "trades";
+    /** Confirmed marketIds — only set on `arb` confirmations. */
+    marketIds?: string[];
+    channel: "orderbook" | "trades" | "arb" | "arb-feed";
 }
 interface WsConnected {
     type: "connected";
@@ -1615,8 +1631,10 @@ declare function applyOrderbookDelta(state: OrderbookState, delta: WsOrderbookDe
 /**
  * Agg platform WebSocket client.
  *
- * Single connection, refcounted subscriptions by ID (venueMarketId or
- * venueMarketOutcomeId). Maintains in-memory orderbook state per subscribed ID.
+ * Single connection, refcounted subscriptions. Orderbook/trades subscriptions
+ * are keyed by venueMarketOutcomeId (the `outcomes[].id` on REST market
+ * responses — NOT a venueMarketId); arb subscriptions are keyed by marketId.
+ * Maintains in-memory orderbook state per subscribed outcome id.
  * All timestamps converted from server ms to seconds before invoking callbacks.
  *
  * Recovery: seq gap or checksum mismatch → resnapshot request.
@@ -1625,8 +1643,10 @@ declare function applyOrderbookDelta(state: OrderbookState, delta: WsOrderbookDe
  */
 
 interface AggWebSocketCallbacks {
-    onSnapshot?: (marketId: string, book: OrderbookState) => void;
-    onDelta?: (marketId: string, book: OrderbookState) => void;
+    /** Invoked with the venueMarketOutcomeId the snapshot belongs to. */
+    onSnapshot?: (outcomeId: string, book: OrderbookState) => void;
+    /** Invoked with the venueMarketOutcomeId the delta belongs to. */
+    onDelta?: (outcomeId: string, book: OrderbookState) => void;
     onTrade?: (trade: WsTrade) => void;
     onHeartbeat?: (hb: WsHeartbeat) => void;
     onSubscribed?: (msg: WsSubscribed) => void;
@@ -2295,6 +2315,7 @@ interface MidpointRow {
     midpoint: number | null;
     spread: number | null;
     timestamp: number | null;
+    arbReturn?: number | null;
     /** Provenance of `midpoint`. */
     markSource?: MarkSource;
     /**
@@ -2303,6 +2324,10 @@ interface MidpointRow {
      * without re-running the matching logic.
      */
     siblingVenueMarketId?: string;
+    /** Top-of-book buy-side price. Only present when `bestPrice=true`. */
+    bestBid?: number | null;
+    /** Top-of-book sell-side price. Only present when `bestPrice=true`. */
+    bestAsk?: number | null;
 }
 /** Per-outcome midpoint from a live orderbook. */
 interface OutcomeMidpointRow {
@@ -2311,12 +2336,39 @@ interface OutcomeMidpointRow {
     midpoint: number | null;
     /** Provenance of `midpoint`. */
     markSource?: MarkSource;
+    /** Top-of-book buy-side price. Only present when `bestPrice=true`. */
+    bestBid?: number | null;
+    /** Top-of-book sell-side price. Only present when `bestPrice=true`. */
+    bestAsk?: number | null;
 }
 /** Response from GET /midpoints (batch). */
 interface BatchMidpointsResponse {
     data: Array<MidpointRow & {
         outcomes: OutcomeMidpointRow[];
         matched: MidpointRow[];
+        /**
+         * Live, quality-gated cross-venue arbitrage return for this market's
+         * cluster as a decimal fraction (`0.0085` = 0.85%), computed fresh by
+         * the engine on this request. Prefer it over the `arbReturn` embedded
+         * in venue-event listings, which a background sync can leave stale.
+         * Only present when the request set `bestPrice=true`.
+         */
+        arbReturn?: number | null;
+        /**
+         * DB status of the requested market. Present whenever the id resolves
+         * to a known market. Resolved markets never serve a price (see `error`).
+         */
+        marketStatus?: MarketStatus;
+        /**
+         * Structured refusal, mirroring GET /orderbooks per-item errors:
+         * `market_resolved` for settled markets (prices are nulled instead of
+         * serving a stale mark), `market_not_found` for unknown ids.
+         */
+        error?: {
+            code: "market_resolved" | "market_not_found";
+            message: string;
+            retryable: boolean;
+        };
     }>;
 }
 /** Response from GET /orderbook/outcome/:id (single outcome). */
@@ -2471,6 +2523,8 @@ interface ExecuteManagedResponse {
     quoteId: string;
     orderIds: string[];
     status: "pending";
+    redeemId?: string;
+    message?: string;
 }
 interface ValidateManagedParams {
     venueMarketOutcomeIds: string[];
@@ -3175,6 +3229,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;
@@ -3199,6 +3271,7 @@ interface SmartRouteResponse {
     }>;
     error?: string;
     message?: string;
+    settlementPlan?: SmartRouteSettlementPlan;
     warnings?: Array<{
         venue: string;
         venueMarketOutcomeId: string;
@@ -3999,4 +4072,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 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 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 };
+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

@@ -586,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;
@@ -640,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;
@@ -812,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;
@@ -864,6 +871,7 @@ type MidpointItem = {
     timestamp: number | null;
     outcomes: OutcomeMidpoint[];
     matched: MatchedMidpoint[];
+    arbReturn?: number | null | undefined;
 };
 type ComputeSplitsRequest = {
     side: TradeSide$1;
@@ -1321,13 +1329,21 @@ interface WsTrade {
 type WsCandleInterval = "1m" | "5m" | "1h" | "1d";
 interface WsSubscribed {
     type: "subscribed";
+    /** Confirmed ids. For `orderbook`/`trades` these are venueMarketOutcomeIds.
+     *  For `arb` this historically mirrors the marketIds — prefer `marketIds`. */
     outcomeIds: string[];
-    channel: "orderbook" | "trades";
+    /** Confirmed marketIds — only set on `arb` confirmations, whose
+     *  subscriptions are keyed by marketIds, not outcomeIds. */
+    marketIds?: string[];
+    channel: "orderbook" | "trades" | "arb" | "arb-feed";
 }
 interface WsUnsubscribed {
     type: "unsubscribed";
+    /** See {@link WsSubscribed.outcomeIds}. */
     outcomeIds: string[];
-    channel: "orderbook" | "trades";
+    /** Confirmed marketIds — only set on `arb` confirmations. */
+    marketIds?: string[];
+    channel: "orderbook" | "trades" | "arb" | "arb-feed";
 }
 interface WsConnected {
     type: "connected";
@@ -1615,8 +1631,10 @@ declare function applyOrderbookDelta(state: OrderbookState, delta: WsOrderbookDe
 /**
  * Agg platform WebSocket client.
  *
- * Single connection, refcounted subscriptions by ID (venueMarketId or
- * venueMarketOutcomeId). Maintains in-memory orderbook state per subscribed ID.
+ * Single connection, refcounted subscriptions. Orderbook/trades subscriptions
+ * are keyed by venueMarketOutcomeId (the `outcomes[].id` on REST market
+ * responses — NOT a venueMarketId); arb subscriptions are keyed by marketId.
+ * Maintains in-memory orderbook state per subscribed outcome id.
  * All timestamps converted from server ms to seconds before invoking callbacks.
  *
  * Recovery: seq gap or checksum mismatch → resnapshot request.
@@ -1625,8 +1643,10 @@ declare function applyOrderbookDelta(state: OrderbookState, delta: WsOrderbookDe
  */
 
 interface AggWebSocketCallbacks {
-    onSnapshot?: (marketId: string, book: OrderbookState) => void;
-    onDelta?: (marketId: string, book: OrderbookState) => void;
+    /** Invoked with the venueMarketOutcomeId the snapshot belongs to. */
+    onSnapshot?: (outcomeId: string, book: OrderbookState) => void;
+    /** Invoked with the venueMarketOutcomeId the delta belongs to. */
+    onDelta?: (outcomeId: string, book: OrderbookState) => void;
     onTrade?: (trade: WsTrade) => void;
     onHeartbeat?: (hb: WsHeartbeat) => void;
     onSubscribed?: (msg: WsSubscribed) => void;
@@ -2295,6 +2315,7 @@ interface MidpointRow {
     midpoint: number | null;
     spread: number | null;
     timestamp: number | null;
+    arbReturn?: number | null;
     /** Provenance of `midpoint`. */
     markSource?: MarkSource;
     /**
@@ -2303,6 +2324,10 @@ interface MidpointRow {
      * without re-running the matching logic.
      */
     siblingVenueMarketId?: string;
+    /** Top-of-book buy-side price. Only present when `bestPrice=true`. */
+    bestBid?: number | null;
+    /** Top-of-book sell-side price. Only present when `bestPrice=true`. */
+    bestAsk?: number | null;
 }
 /** Per-outcome midpoint from a live orderbook. */
 interface OutcomeMidpointRow {
@@ -2311,12 +2336,39 @@ interface OutcomeMidpointRow {
     midpoint: number | null;
     /** Provenance of `midpoint`. */
     markSource?: MarkSource;
+    /** Top-of-book buy-side price. Only present when `bestPrice=true`. */
+    bestBid?: number | null;
+    /** Top-of-book sell-side price. Only present when `bestPrice=true`. */
+    bestAsk?: number | null;
 }
 /** Response from GET /midpoints (batch). */
 interface BatchMidpointsResponse {
     data: Array<MidpointRow & {
         outcomes: OutcomeMidpointRow[];
         matched: MidpointRow[];
+        /**
+         * Live, quality-gated cross-venue arbitrage return for this market's
+         * cluster as a decimal fraction (`0.0085` = 0.85%), computed fresh by
+         * the engine on this request. Prefer it over the `arbReturn` embedded
+         * in venue-event listings, which a background sync can leave stale.
+         * Only present when the request set `bestPrice=true`.
+         */
+        arbReturn?: number | null;
+        /**
+         * DB status of the requested market. Present whenever the id resolves
+         * to a known market. Resolved markets never serve a price (see `error`).
+         */
+        marketStatus?: MarketStatus;
+        /**
+         * Structured refusal, mirroring GET /orderbooks per-item errors:
+         * `market_resolved` for settled markets (prices are nulled instead of
+         * serving a stale mark), `market_not_found` for unknown ids.
+         */
+        error?: {
+            code: "market_resolved" | "market_not_found";
+            message: string;
+            retryable: boolean;
+        };
     }>;
 }
 /** Response from GET /orderbook/outcome/:id (single outcome). */
@@ -2471,6 +2523,8 @@ interface ExecuteManagedResponse {
     quoteId: string;
     orderIds: string[];
     status: "pending";
+    redeemId?: string;
+    message?: string;
 }
 interface ValidateManagedParams {
     venueMarketOutcomeIds: string[];
@@ -3175,6 +3229,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;
@@ -3199,6 +3271,7 @@ interface SmartRouteResponse {
     }>;
     error?: string;
     message?: string;
+    settlementPlan?: SmartRouteSettlementPlan;
     warnings?: Array<{
         venue: string;
         venueMarketOutcomeId: string;
@@ -3999,4 +4072,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 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 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 };
+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

@@ -1593,7 +1593,7 @@ var AggWebSocket = class {
 // src/client.ts
 var COOKIE_REFRESH_DELIVERY = "cookie-refresh";
 var DEFAULT_MIDPOINT_IDS_PER_REQUEST = 75;
-var MAX_MIDPOINT_IDS_PER_REQUEST = 200;
+var MAX_MIDPOINT_IDS_PER_REQUEST = 75;
 var isUserProfile = (user) => {
   return "accounts" in user && "wallets" in user && "avatarUrl" in user;
 };
@@ -1638,6 +1638,17 @@ var chunkArray = (items, size) => {
   }
   return chunks;
 };
+var normalizeRequestedVenueMarketIds = (venueMarketIds) => {
+  const normalizedIds = [];
+  const seenIds = /* @__PURE__ */ new Set();
+  for (const venueMarketId of venueMarketIds) {
+    const normalizedVenueMarketId = venueMarketId.trim();
+    if (!normalizedVenueMarketId || seenIds.has(normalizedVenueMarketId)) continue;
+    seenIds.add(normalizedVenueMarketId);
+    normalizedIds.push(normalizedVenueMarketId);
+  }
+  return normalizedIds;
+};
 var mapChartResolution = (resolution) => {
   switch (resolution) {
     case void 0:
@@ -2811,7 +2822,8 @@ Issued At: ${issuedAt}`;
   getMidpoints(paramsOrVenueMarketIds, options) {
     return __async(this, null, function* () {
       var _a;
-      const venueMarketIds = Array.isArray(paramsOrVenueMarketIds) ? paramsOrVenueMarketIds : paramsOrVenueMarketIds.venueMarketIds;
+      const requestedVenueMarketIds = Array.isArray(paramsOrVenueMarketIds) ? paramsOrVenueMarketIds : paramsOrVenueMarketIds.venueMarketIds;
+      const venueMarketIds = normalizeRequestedVenueMarketIds(requestedVenueMarketIds);
       const bestPrice = !Array.isArray(paramsOrVenueMarketIds) ? paramsOrVenueMarketIds.bestPrice : options == null ? void 0 : options.bestPrice;
       const maxMidpointIdsPerRequest = resolveMidpointIdsPerRequest(
         (_a = options == null ? void 0 : options.maxMidpointIdsPerRequest) != null ? _a : Array.isArray(paramsOrVenueMarketIds) ? void 0 : paramsOrVenueMarketIds.maxMidpointIdsPerRequest
@@ -2824,6 +2836,9 @@ Issued At: ${issuedAt}`;
           signal: options == null ? void 0 : options.signal
         });
       };
+      if (venueMarketIds.length === 0) {
+        return { data: [] };
+      }
       if (venueMarketIds.length <= maxMidpointIdsPerRequest) {
         return requestBatch(venueMarketIds);
       }

package/dist/index.mjs

@@ -1480,7 +1480,7 @@ var AggWebSocket = class {
 // src/client.ts
 var COOKIE_REFRESH_DELIVERY = "cookie-refresh";
 var DEFAULT_MIDPOINT_IDS_PER_REQUEST = 75;
-var MAX_MIDPOINT_IDS_PER_REQUEST = 200;
+var MAX_MIDPOINT_IDS_PER_REQUEST = 75;
 var isUserProfile = (user) => {
   return "accounts" in user && "wallets" in user && "avatarUrl" in user;
 };
@@ -1525,6 +1525,17 @@ var chunkArray = (items, size) => {
   }
   return chunks;
 };
+var normalizeRequestedVenueMarketIds = (venueMarketIds) => {
+  const normalizedIds = [];
+  const seenIds = /* @__PURE__ */ new Set();
+  for (const venueMarketId of venueMarketIds) {
+    const normalizedVenueMarketId = venueMarketId.trim();
+    if (!normalizedVenueMarketId || seenIds.has(normalizedVenueMarketId)) continue;
+    seenIds.add(normalizedVenueMarketId);
+    normalizedIds.push(normalizedVenueMarketId);
+  }
+  return normalizedIds;
+};
 var mapChartResolution = (resolution) => {
   switch (resolution) {
     case void 0:
@@ -2698,7 +2709,8 @@ Issued At: ${issuedAt}`;
   getMidpoints(paramsOrVenueMarketIds, options) {
     return __async(this, null, function* () {
       var _a;
-      const venueMarketIds = Array.isArray(paramsOrVenueMarketIds) ? paramsOrVenueMarketIds : paramsOrVenueMarketIds.venueMarketIds;
+      const requestedVenueMarketIds = Array.isArray(paramsOrVenueMarketIds) ? paramsOrVenueMarketIds : paramsOrVenueMarketIds.venueMarketIds;
+      const venueMarketIds = normalizeRequestedVenueMarketIds(requestedVenueMarketIds);
       const bestPrice = !Array.isArray(paramsOrVenueMarketIds) ? paramsOrVenueMarketIds.bestPrice : options == null ? void 0 : options.bestPrice;
       const maxMidpointIdsPerRequest = resolveMidpointIdsPerRequest(
         (_a = options == null ? void 0 : options.maxMidpointIdsPerRequest) != null ? _a : Array.isArray(paramsOrVenueMarketIds) ? void 0 : paramsOrVenueMarketIds.maxMidpointIdsPerRequest
@@ -2711,6 +2723,9 @@ Issued At: ${issuedAt}`;
           signal: options == null ? void 0 : options.signal
         });
       };
+      if (venueMarketIds.length === 0) {
+        return { data: [] };
+      }
       if (venueMarketIds.length <= maxMidpointIdsPerRequest) {
         return requestBatch(venueMarketIds);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agg-build/sdk",
-  "version": "2.1.3",
+  "version": "2.2.1",
   "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"
   },