@agg-build/sdk 1.3.0 → 2.1.0

package/dist/index.d.ts

@@ -68,13 +68,31 @@ declare enum OrderStatus {
     pending_bridge = "pending_bridge",
     submitting = "submitting",
     submitted = "submitted",
+    open = "open",
+    partially_filled_open = "partially_filled_open",
+    cancel_pending = "cancel_pending",
     filled = "filled",
-    partial_fill = "partial_fill"
+    partial_fill = "partial_fill",
+    failed = "failed",
+    expired = "expired",
+    cancelled = "cancelled"
 }
 declare enum TradeSide$1 {
     Buy = "buy",
     Sell = "sell"
 }
+declare enum OrderType {
+    Market = "market",
+    Limit = "limit"
+}
+declare enum TimeInForce {
+    GTC = "GTC",
+    GTD = "GTD",
+    FOK = "FOK",
+    FAK = "FAK",
+    IOC = "IOC",
+    ALO = "ALO"
+}
 
 /**
  * Standalone type definitions — no Zod dependency.
@@ -375,6 +393,8 @@ type WalletChainBalance = {
     chainId: number;
     tokenAddress: string;
     balanceRaw: string;
+    heldRaw?: string | undefined;
+    availableRaw?: string | undefined;
     decimals: number;
     lastSyncedAt: string;
     tokenSymbol?: string | undefined;
@@ -382,11 +402,15 @@ type WalletChainBalance = {
 type WalletTokenBalance = {
     tokenSymbol: string;
     totalRaw: string;
+    availableRaw?: string | undefined;
+    reservedRaw?: string | undefined;
     decimals: number;
     chains: {
         chainId: number;
         tokenAddress: string;
         balanceRaw: string;
+        heldRaw?: string | undefined;
+        availableRaw?: string | undefined;
         decimals: number;
         lastSyncedAt: string;
     }[];
@@ -404,11 +428,15 @@ type UnifiedBalanceResponse = {
     cash: {
         tokenSymbol: string;
         totalRaw: string;
+        availableRaw?: string | undefined;
+        reservedRaw?: string | undefined;
         decimals: number;
         chains: {
             chainId: number;
             tokenAddress: string;
             balanceRaw: string;
+            heldRaw?: string | undefined;
+            availableRaw?: string | undefined;
             decimals: number;
             lastSyncedAt: string;
         }[];
@@ -587,6 +615,10 @@ type VenueMarket = {
     endDate?: string | null | undefined;
     creationDate?: string | null | undefined;
     resolutionDate?: string | null | undefined;
+    /** Sports market classification for type-aware sorting (moneyline, spread, total, etc.). */
+    sportsMarketType?: string | null | undefined;
+    /** Sort rank within a sports section (0=moneyline, 1=spread, 2=total, 3+=other). */
+    sectionRank?: number | null | undefined;
     matchedVenueMarkets?: {
         id: string;
         venue: Venue;
@@ -629,6 +661,8 @@ type VenueEvent = {
             displayName: string | null;
             parentId: string | null;
             eventCount: number;
+            volume24hr: number;
+            volume: number;
         };
     }[];
     status?: MarketStatus | undefined;
@@ -646,10 +680,12 @@ type VenueEvent = {
     /**
      * ISO-8601 duration denormalized from Series.recurrence. `null` means
      * the event has no recurring schedule (one-off). Use this value with
-     * the `?recurrence=` filter on /venue-events; discover all available
-     * values via GET /recurrences.
+     * the `?recurrence=` filter on /venue-events using public recurrence
+     * enum values.
      */
     recurrence?: string | null | undefined;
+    /** Type-aware structure classification used to sort markets under this event. */
+    structureType?: "candidate" | "sport" | "axis" | "dates" | null | undefined;
 };
 type Orderbook = {
     bids: {
@@ -833,6 +869,8 @@ type Category = {
     displayName: string | null;
     parentId: string | null;
     eventCount: number;
+    volume24hr: number;
+    volume: number;
 };
 type SettlementSource = {
     name: string;
@@ -1405,6 +1443,8 @@ interface WsWithdrawalLifecycleEvent {
     requestedAmountRaw?: string;
     /** Terminal settled amount in destination-token native decimals. */
     completedAmountRaw?: string | null;
+    /** Realized platform fee in destination-token native decimals. Only present on terminal events. */
+    feeRaw?: string | null;
     /** True when `status` is terminal (`completed` / `partial` / `failed`). */
     terminal: boolean;
     /** Optional leg delta — present when this event was triggered by a leg flip. */
@@ -1951,6 +1991,209 @@ interface MatchedOrderbookMarket extends VenueMarketRef {
  *  - `none`             — no mark available
  */
 type MarkSource = "local" | "local_merged" | "local_one_sided" | "sibling" | "local_boundary" | "none";
+declare const RECURRENCE_CADENCES: readonly ["PT5M", "PT10M", "PT15M", "PT1H", "P1D", "P1W", "P1M", "P1Y"];
+type RecurrenceCadence = (typeof RECURRENCE_CADENCES)[number];
+type RecurrenceFilter = RecurrenceCadence | "null";
+type RecurringCryptoDuration = "PT5M" | "PT15M" | "PT1H" | "P1D";
+type RecurringCryptoDurationInput = RecurringCryptoDuration | "5m" | "15m" | "1h" | "1d";
+type RecurringCryptoSourceConfidence = "verified" | "inferred" | "missing";
+interface ListRecurringCryptoMarketsOptions {
+    assets?: string[];
+    durations?: RecurringCryptoDurationInput[];
+    interval?: RecurringCryptoDurationInput;
+    window?: "current";
+    venues?: Venue[];
+    status?: MarketStatus[];
+    windowStartFrom?: string;
+    windowStartTo?: string;
+    cursor?: string;
+    limit?: number;
+    includeOrderbookPrices?: boolean;
+    includeReferencePrices?: boolean;
+    includeDirectVenueMarkets?: boolean;
+}
+interface RecurringCryptoOutcome {
+    /**
+     * Canonical Agg outcome id. Null for direct live venue rows because those
+     * rows are discovery data and cannot be passed to smart order routing.
+     */
+    venueMarketOutcomeId: string | null;
+    /** Venue-native outcome id or synthetic external id for direct live rows. */
+    externalOutcomeId: string | null;
+    /** False for this endpoint; live crypto markets are not smart-route inputs. */
+    routeable: boolean;
+    /** False for this endpoint; split-order routing is not supported here. */
+    splitOrdersAllowed: boolean;
+    label: string;
+    title: string | null;
+    midpoint: number | null;
+    bestBid: number | null;
+    bestAsk: number | null;
+    markSource: MarkSource | string | null;
+    lastKnownPrice: number | null;
+}
+interface RecurringCryptoMarketMetrics {
+    volume: number | null;
+    volume24h: number | null;
+    openInterest: number | null;
+    liquidity: number | null;
+    spread: number | null;
+}
+interface RecurringCryptoResolution {
+    sourceName: string | null;
+    sourceUrl: string | null;
+    sourceDomain: string | null;
+    rawCriteria: unknown;
+    confidence: RecurringCryptoSourceConfidence;
+}
+interface RecurringCryptoReferencePrice {
+    asset: string;
+    quoteAsset: "USD";
+    raw: string | null;
+    decimals: number | null;
+    normalized: number | null;
+    timestamp: string | null;
+    provider: string | null;
+    providerMarketId: string | null;
+    confidence: RecurringCryptoSourceConfidence;
+    fetchedAt?: string | null;
+    ageMs?: number | null;
+    refreshing?: boolean;
+    stale?: boolean;
+}
+type CryptoReferencePriceTarget = {
+    type: "venueMarket";
+    venueMarketId: string;
+} | {
+    type: "venueEvent";
+    venueEventId: string;
+} | {
+    type: "externalVenueMarket";
+    venue: Venue;
+    externalMarketId: string;
+} | {
+    type: "market";
+    venue: Venue;
+    venueEventId?: string;
+    venueMarketId: string;
+    externalEventId?: string | null;
+    externalMarketId?: string;
+    asset: string;
+    quoteAsset?: "USD";
+    resolution: RecurringCryptoResolution;
+};
+interface CryptoReferencePriceExternalMarketInput {
+    venue: Venue;
+    externalMarketId: string;
+}
+interface CryptoReferencePriceMarketInput extends RecurringCryptoVenueMarket {
+    asset: string;
+    quoteAsset?: "USD";
+}
+interface GetCryptoReferencePricesOptions {
+    targets?: CryptoReferencePriceTarget[];
+    venueMarketIds?: string[];
+    venueEventIds?: string[];
+    externalMarkets?: CryptoReferencePriceExternalMarketInput[];
+    markets?: CryptoReferencePriceMarketInput[];
+    windowMarkets?: RecurringCryptoWindowMarket[];
+    signal?: AbortSignal;
+}
+interface CryptoReferencePriceError {
+    code: "not_found" | "not_recurring_crypto" | "reference_feed_missing" | "price_unavailable" | "stale_price";
+    message: string;
+}
+interface CryptoReferencePriceSource {
+    provider: string | null;
+    providerMarketId: string | null;
+    confidence: RecurringCryptoSourceConfidence;
+}
+interface CryptoReferencePriceResult {
+    target: CryptoReferencePriceTarget;
+    venue: Venue | null;
+    venueEventId: string | null;
+    venueMarketId: string | null;
+    externalEventId: string | null;
+    externalMarketId: string | null;
+    asset: string | null;
+    quoteAsset: "USD" | null;
+    raw: string | null;
+    decimals: number | null;
+    normalized: number | null;
+    providerTimestamp: string | null;
+    fetchedAt: string | null;
+    ageMs: number | null;
+    refreshing: boolean;
+    stale: boolean;
+    source: CryptoReferencePriceSource;
+    error: CryptoReferencePriceError | null;
+}
+interface CryptoReferencePricesResponse {
+    data: CryptoReferencePriceResult[];
+    softRefreshMs: number;
+    hardMaxAgeMs: number;
+}
+type RecurringCryptoComparisonPriceSource = "referencePrice" | "midpoint" | "lastKnownPrice";
+interface RecurringCryptoComparisonPoint {
+    venue: Venue;
+    venueMarketId: string;
+    value: number;
+    label: string | null;
+    source: RecurringCryptoComparisonPriceSource;
+    provider: string | null;
+    providerMarketId: string | null;
+    timestamp: string | null;
+    confidence: RecurringCryptoSourceConfidence | null;
+}
+interface RecurringCryptoPriceComparison {
+    count: number;
+    min: RecurringCryptoComparisonPoint | null;
+    max: RecurringCryptoComparisonPoint | null;
+    spread: number | null;
+    spreadBps: number | null;
+    byVenue: RecurringCryptoComparisonPoint[];
+}
+interface RecurringCryptoWindowComparisons {
+    referencePrice: RecurringCryptoPriceComparison;
+    outcomePrices: {
+        up: RecurringCryptoPriceComparison;
+        down: RecurringCryptoPriceComparison;
+    };
+}
+interface RecurringCryptoVenueMarket {
+    venue: Venue;
+    venueEventId: string;
+    venueMarketId: string;
+    externalEventId: string | null;
+    externalMarketId: string;
+    question: string;
+    status: MarketStatus;
+    priceSource: "snag" | "direct";
+    /** False for this endpoint; live crypto markets are not smart-route inputs. */
+    routeable: boolean;
+    /** False for this endpoint; split-order routing is not supported here. */
+    splitOrdersAllowed: boolean;
+    outcomes: RecurringCryptoOutcome[];
+    metrics: RecurringCryptoMarketMetrics;
+    resolution: RecurringCryptoResolution;
+    referencePrice: RecurringCryptoReferencePrice;
+}
+interface RecurringCryptoWindowMarket {
+    id: string;
+    asset: string;
+    quoteAsset: "USD";
+    duration: RecurringCryptoDuration;
+    windowStart: string;
+    windowEnd: string;
+    status: MarketStatus;
+    markets: RecurringCryptoVenueMarket[];
+    comparisons: RecurringCryptoWindowComparisons;
+}
+interface RecurringCryptoMarketsResponse {
+    data: RecurringCryptoWindowMarket[];
+    nextCursor: string | null;
+    hasMore: boolean;
+}
 /** Per-venue orderbook entry with native tick spacing. */
 interface VenueOrderbookEntry {
     venueMarketId: string;
@@ -2188,6 +2431,12 @@ interface WithdrawManagedParams {
     destinationAddress: string;
     /** EVM 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
+     * instead of rejecting an over-balance request. Use only when the user explicitly
+     * clicked Max — manual over-typed amounts must still surface the unviable state.
+     */
+    max?: boolean;
 }
 type WithdrawalLifecycleStatus = "pending" | "bridging" | "transferring" | "completed" | "partial" | "failed";
 type WithdrawalSourceStatus = "pending" | "submitted" | "confirmed" | "failed";
@@ -2230,6 +2479,19 @@ interface WithdrawalExpected {
     feeRaw: string | null;
     etaSeconds: number | null;
 }
+/** Body for POST /execution/withdraw/preview — identical to a withdraw request. */
+type WithdrawPreviewParams = WithdrawManagedParams;
+/** Response from POST /execution/withdraw/preview. All amounts are raw strings in destination-token native decimals. */
+interface WithdrawPreviewResponse {
+    receiveAmountRaw: string | null;
+    feeRaw: string | null;
+    relayFeeRaw: string | null;
+    networkFeeRaw: string | null;
+    pricingStatus: "quoted" | "unviable";
+    quoteExpiresAt: string | null;
+    unviableReason: string | null;
+    maxDeliverableRaw: string | null;
+}
 interface WithdrawManagedResponse {
     withdrawalId: string;
     status: WithdrawalLifecycleStatus;
@@ -2322,6 +2584,170 @@ type ExecutionPositionGroup = PositionGroup;
 type ManagedBalancesParams = {
     mode?: ExecutionMode;
 };
+interface PaperTradingAppOptions {
+    /** App ID for the paper account namespace. Defaults to AggClient appId. */
+    appId?: string;
+}
+interface PaperTradingListParams {
+    limit?: number;
+    cursor?: string;
+}
+interface CreatePaperTradingAccountParams {
+    name?: string;
+    externalId?: string;
+    initialBalanceRaw?: string;
+    initialBalance?: number;
+}
+interface SetPaperTradingBalanceParams {
+    balanceRaw?: string;
+    balance?: number;
+    reason?: string;
+}
+interface ResetPaperTradingAccountParams {
+    balanceRaw?: string;
+    balance?: number;
+    reason?: string;
+}
+interface PlacePaperTradingOrderParams {
+    venueMarketOutcomeId: string;
+    side: "buy" | "sell";
+    spendRaw?: string;
+    spend?: number;
+    shares?: number;
+    slippageBps?: number;
+    clientOrderId?: string;
+}
+type PaperTradingMarkSource = "orderbook_midpoint" | "orderbook_best_bid" | "catalog_price";
+type PaperTradingLiquidityStatus = "full" | "partial" | "none";
+interface PaperTradingAccount {
+    id: string;
+    appId: string;
+    name: string | null;
+    externalId: string | null;
+    currency: string;
+    startingBalanceRaw: string;
+    startingBalance: number;
+    cashBalanceRaw: string;
+    cashBalance: number;
+    realizedPnlRaw: string;
+    realizedPnl: number;
+    kycStatus: "verified";
+    kycVerified: true;
+    status: "active" | "archived";
+    createdAt: string;
+    updatedAt: string;
+}
+interface PaperTradingPosition {
+    id: string;
+    accountId: string;
+    venue: string;
+    venueMarketId: string;
+    venueMarketOutcomeId: string;
+    marketQuestion: string;
+    outcomeLabel: string;
+    size: number;
+    avgEntryPrice: number;
+    markPrice: number;
+    markSource: PaperTradingMarkSource;
+    markTimestamp: number | null;
+    bestBidPrice: number | null;
+    bestAskPrice: number | null;
+    midpoint: number | null;
+    spread: number | null;
+    marketValueRaw: string;
+    marketValue: number;
+    unrealizedPnlRaw: string;
+    unrealizedPnl: number;
+    liquidationPrice: number | null;
+    liquidationValueRaw: string;
+    liquidationValue: number;
+    liquidationPnlRaw: string;
+    liquidationPnl: number;
+    liquidityShares: number;
+    liquidityStatus: PaperTradingLiquidityStatus;
+    realizedPnlRaw: string;
+    realizedPnl: number;
+    createdAt: string;
+    updatedAt: string;
+}
+interface PaperTradingOrder {
+    id: string;
+    accountId: string;
+    venue: string;
+    venueMarketId: string;
+    venueMarketOutcomeId: string;
+    marketQuestion: string;
+    outcomeLabel: string;
+    side: "buy" | "sell";
+    status: "filled" | "rejected";
+    clientOrderId: string | null;
+    requestedSpendRaw: string | null;
+    requestedSpend: number | null;
+    requestedShares: number | null;
+    filledShares: number;
+    avgPrice: number | null;
+    slippageBps: number | null;
+    notionalRaw: string;
+    notional: number;
+    cashDeltaRaw: string;
+    cashDelta: number;
+    realizedPnlRaw: string;
+    realizedPnl: number;
+    rejectionReason: string | null;
+    createdAt: string;
+}
+interface PaperTradingBalanceAdjustment {
+    id: string;
+    accountId: string;
+    type: "set_balance" | "reset";
+    amountRaw: string;
+    amount: number;
+    previousCashBalanceRaw: string;
+    previousCashBalance: number;
+    newCashBalanceRaw: string;
+    newCashBalance: number;
+    reason: string | null;
+    createdAt: string;
+}
+interface PaperTradingPortfolio {
+    account: PaperTradingAccount;
+    cashBalanceRaw: string;
+    cashBalance: number;
+    marketValueRaw: string;
+    marketValue: number;
+    equityRaw: string;
+    equity: number;
+    realizedPnlRaw: string;
+    realizedPnl: number;
+    unrealizedPnlRaw: string;
+    unrealizedPnl: number;
+    liquidationValueRaw: string;
+    liquidationValue: number;
+    liquidationEquityRaw: string;
+    liquidationEquity: number;
+    liquidationPnlRaw: string;
+    liquidationPnl: number;
+    positions: PaperTradingPosition[];
+}
+interface PaperTradingAccountsPage {
+    data: PaperTradingAccount[];
+    nextCursor: string | null;
+    hasMore: boolean;
+}
+interface PaperTradingPositionsPage {
+    data: PaperTradingPosition[];
+    nextCursor: string | null;
+    hasMore: boolean;
+}
+interface PaperTradingOrdersPage {
+    data: PaperTradingOrder[];
+    nextCursor: string | null;
+    hasMore: boolean;
+}
+interface PaperTradingBalanceResponse {
+    account: PaperTradingAccount;
+    adjustment: PaperTradingBalanceAdjustment;
+}
 type UserActivityType = "trade" | "withdrawal" | "bridge" | "deposit" | "user_op" | "redeem";
 interface UserActivityBase {
     id: string;
@@ -2382,6 +2808,7 @@ interface UserActivityDeposit extends UserActivityBase {
     chainId: string;
     fromAddress: string;
     txHash: string;
+    source: "connected_wallet" | "external_wallet";
 }
 interface UserActivityUserOp extends UserActivityBase {
     type: "user_op";
@@ -2724,6 +3151,129 @@ type SearchResponse<T> = {
     nextCursor: string | null;
     hasMore: boolean;
 };
+interface NewsFeedPageOptions {
+    cursor?: string;
+    since?: string;
+    before?: string;
+    limit?: number;
+}
+interface NewsFeedMarketNewsParams {
+    venueMarketIds?: string[];
+    venueEventIds?: string[];
+    customQuery?: string;
+    tbs?: string;
+    limit?: number;
+}
+interface NewsFeedArticleWithSummary {
+    title: string;
+    url: string;
+    snippet: string;
+    source: string;
+    imageUrl: string | null;
+    publishedAt: string | null;
+    summary: string;
+    relevanceScore: number;
+}
+interface NewsFeedMarketNewsResult {
+    venueMarketId: string;
+    venueEventId: string;
+    question: string;
+    eventTitle: string;
+    category: string;
+    searchQuery: string;
+    timeRange: string;
+    timeRangeLabel: string;
+    articles: NewsFeedArticleWithSummary[];
+}
+interface NewsFeedMarketNewsResponse {
+    results: NewsFeedMarketNewsResult[];
+}
+interface NewsFeedLinkedMarket {
+    venueMarketId: string;
+    question: string;
+    venue: string;
+    yesPrice: number;
+    eventTitle: string;
+    eventId: string;
+    summary: string;
+    relevanceScore: number;
+}
+interface NewsFeedArticleFeedItem {
+    article: {
+        id: string;
+        title: string;
+        url: string;
+        snippet: string;
+        source: string;
+        imageUrl: string | null;
+        publishedAt: string | null;
+    };
+    markets: NewsFeedLinkedMarket[];
+    category: string;
+    id: string;
+    seq: number;
+    timestamp: string;
+}
+interface NewsFeedMarketFeedArticle {
+    title: string;
+    url: string;
+    source: string;
+    imageUrl: string | null;
+    publishedAt: string | null;
+    summary: string;
+    relevanceScore: number;
+    seq: number;
+    addedAt: string;
+}
+interface NewsFeedMarketFeedItem {
+    venueMarketId: string;
+    question: string;
+    venue: string;
+    yesPrice: number;
+    eventTitle: string;
+    eventId: string;
+    category: string;
+    articleCount: number;
+    articles: NewsFeedMarketFeedArticle[];
+}
+interface NewsFeedArticleFeedResponse {
+    data: NewsFeedArticleFeedItem[];
+    nextCursor: string | null;
+    hasMore: boolean;
+}
+interface NewsFeedMarketFeedResponse {
+    data: NewsFeedMarketFeedItem[];
+    nextCursor: string | null;
+    hasMore: boolean;
+}
+interface NewsFeedListResponse {
+    feeds: Array<{
+        id: string;
+        name: string;
+        itemCount: number;
+    }>;
+}
+interface NewsFeedStatusResponse {
+    articles: {
+        total: number;
+        today: number;
+    };
+    feedItems: {
+        total: number;
+        today: number;
+    };
+    perCategory: Array<{
+        category: string;
+        todayCount: number;
+        dailyLimit: number;
+    }>;
+    config: {
+        cronEnabled: boolean;
+        itemsPerDay: number;
+        batchSize: number;
+        categories: string[];
+    };
+}
 type CorrelatedMarketSide = "yes" | "no";
 type CorrelatedMarketSignalDirection = "more_likely" | "less_likely";
 interface CorrelatedMarketSignal {
@@ -2843,6 +3393,10 @@ declare class AggClient {
     /** In-flight refresh promise — serializes concurrent 401 retries so only one refresh runs. */
     private pendingRefresh;
     constructor(options: AggClientOptions);
+    private resolvePaperTradingAppId;
+    private paperTradingAccountsPath;
+    private paperTradingAccountPath;
+    private paperTradingListQuery;
     private withAuthPayload;
     private restoreSession;
     private persistSession;
@@ -2968,6 +3522,24 @@ declare class AggClient {
     getExecutionPositions(params?: ExecutionPositionsQuery): Promise<PaginatedResponse<ExecutionPositionGroup>>;
     /** Get managed wallet balances, including per-chain cash balances and per-venue position balances. */
     getManagedBalances(params?: ManagedBalancesParams): Promise<UnifiedBalanceResponse>;
+    /** 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>;
+    /** 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. */
+    setPaperTradingBalance(accountId: string, params: SetPaperTradingBalanceParams, options?: PaperTradingAppOptions): Promise<PaperTradingBalanceResponse>;
+    /** Clear positions and reset cash for a paper trading account. Requires adminKey or apiKey. */
+    resetPaperTradingAccount(accountId: string, params?: ResetPaperTradingAccountParams, options?: PaperTradingAppOptions): Promise<PaperTradingBalanceResponse>;
+    /** Place a direct simulated order in a paper trading account. Requires adminKey or apiKey. */
+    placePaperTradingOrder(accountId: string, params: PlacePaperTradingOrderParams, options?: PaperTradingAppOptions): Promise<PaperTradingOrder>;
+    /** List positions for a server-managed paper trading account. Requires adminKey or apiKey. */
+    listPaperTradingPositions(accountId: string, params?: PaperTradingListParams & PaperTradingAppOptions): Promise<PaperTradingPositionsPage>;
+    /** List orders for a server-managed paper trading account. Requires adminKey or apiKey. */
+    listPaperTradingOrders(accountId: string, params?: PaperTradingListParams & PaperTradingAppOptions): Promise<PaperTradingOrdersPage>;
+    /** Fetch account-level paper trading equity, P&L, and marked positions. Requires adminKey or apiKey. */
+    getPaperTradingPortfolio(accountId: string, options?: PaperTradingAppOptions): Promise<PaperTradingPortfolio>;
     /** Cancel a pending managed execution by order id. */
     cancelManagedOrder(orderId: string, options?: {
         signal?: AbortSignal;
@@ -2981,7 +3553,7 @@ declare class AggClient {
         status?: MarketStatus[];
         sortBy?: string;
         sortDir?: string;
-        recurrence?: string;
+        recurrence?: RecurrenceFilter | RecurrenceFilter[];
         limit?: number;
         cursor?: string;
         minYesPrice?: number;
@@ -2993,6 +3565,12 @@ declare class AggClient {
     getVenueEventById(id: string, options?: {
         signal?: AbortSignal;
     }): Promise<VenueEvent>;
+    /** List deterministic recurring crypto window markets across venues. Requires appId or admin auth. */
+    listRecurringCryptoMarkets(options?: ListRecurringCryptoMarketsOptions & {
+        signal?: AbortSignal;
+    }): Promise<RecurringCryptoMarketsResponse>;
+    /** Poll fresh reference prices for recurring crypto markets. Requires appId or admin auth. */
+    getCryptoReferencePrices(options: GetCryptoReferencePricesOptions): Promise<CryptoReferencePricesResponse>;
     /** List venue markets with optional filters. Requires appId or admin auth. Supports cursor-based pagination. */
     getVenueMarkets(options?: {
         venue?: Venue;
@@ -3014,6 +3592,27 @@ declare class AggClient {
     }): Promise<PaginatedResponse<Category>>;
     /** Get per-app UI config (disabled venues + category presets). Requires appId. */
     getAppConfig(init?: RequestInit): Promise<AppClientConfigResponse>;
+    private buildNewsFeedQuery;
+    /** List available market news feeds and item counts. */
+    getNewsFeeds(options?: {
+        signal?: AbortSignal;
+    }): Promise<NewsFeedListResponse>;
+    /** Get the article-centric market news feed for a category. */
+    getNewsFeed(category: string, options?: NewsFeedPageOptions & {
+        signal?: AbortSignal;
+    }): Promise<NewsFeedArticleFeedResponse>;
+    /** Get the market-centric market news feed for a category. */
+    getNewsFeedMarkets(category: string, options?: NewsFeedPageOptions & {
+        signal?: AbortSignal;
+    }): Promise<NewsFeedMarketFeedResponse>;
+    /** Get news feed coverage and per-category counts. */
+    getNewsFeedStatus(options?: {
+        signal?: AbortSignal;
+    }): Promise<NewsFeedStatusResponse>;
+    /** Search recent news for specific markets and return market impact summaries. */
+    getMarketNews(params: NewsFeedMarketNewsParams, options?: {
+        signal?: AbortSignal;
+    }): Promise<NewsFeedMarketNewsResponse>;
     /**
      * Search events or markets by query string. Supports cursor-based pagination.
      *
@@ -3078,12 +3677,15 @@ declare class AggClient {
     getMidpoints(params: {
         venueMarketIds: string[];
         bestPrice?: boolean;
+        maxMidpointIdsPerRequest?: number;
     }, options?: {
         signal?: AbortSignal;
+        maxMidpointIdsPerRequest?: number;
     }): Promise<BatchMidpointsResponse>;
     getMidpoints(venueMarketIds: string[], options?: {
         signal?: AbortSignal;
         bestPrice?: boolean;
+        maxMidpointIdsPerRequest?: number;
     }): Promise<BatchMidpointsResponse>;
     /** Get a single outcome-level orderbook from the engine. */
     getOutcomeOrderbook(outcomeId: string, options?: {
@@ -3114,6 +3716,12 @@ declare class AggClient {
     redeem(body: RedeemRequest): Promise<RedeemResponse>;
     /** Withdraw funds from managed wallets to an external address. */
     withdrawManaged(params: WithdrawManagedParams): Promise<WithdrawManagedResponse>;
+    /**
+     * Preview a withdrawal — real fee + receive estimate without creating one.
+     * Optional: `withdrawManaged` does NOT require a prior preview, so partners
+     * integrating against the SDK can ignore this entirely.
+     */
+    withdrawPreview(params: WithdrawPreviewParams): Promise<WithdrawPreviewResponse>;
     /**
      * 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
@@ -3126,6 +3734,15 @@ declare class AggClient {
     syncManagedBalances(): Promise<SyncBalancesResponse>;
     /** Get managed wallet deposit addresses (EVM + Solana). Returns 202 shape while provisioning. */
     getDepositAddresses(): Promise<DepositAddressesResponse>;
+    /**
+     * Internal: record that a deposit tx was initiated via the in-app
+     * connected-wallet flow, so the activity feed can label it correctly.
+     * Best-effort — callers should not block the UX on this.
+     */
+    recordDepositIntent(body: {
+        chainId: number;
+        txHash: string;
+    }): Promise<void>;
     /** Get open positions grouped by matched market with per-venue breakdown. */
     getPositions(params?: GetPositionsParams): Promise<PaginatedResponse<PositionGroup>>;
     /** Get crypto purchase quotes. */
@@ -3217,4 +3834,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 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 GetHoldingsQuery, type GetHoldingsResponse, type GetOrdersParams, type GetOrdersQuery, type GetPositionsParams, type GetPositionsQuery, type HelloResponse, IMAGE_SIZES, ImageSize, type ManagedBalancesParams, type MarkSource, type MarketPriceHistory, MarketStatus, MatchStatus, MatchType, type MatchedMidpoint, type MatchedMidpointOutcome, type MatchedOrderbookMarket, type MatchedVenueMarketOutcomeRef, type MatchingReport, type MidpointItem, type MidpointRow, type NonceResponse, type OrderListItem, type OrderListQuery, OrderStatus, 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 PersistedAuthSnapshot, type PositionGroup, type PositionRedeemStatus, type PricePoint, type PriceSource, type PricesHistoryResponse, type QuoteManagedParams, type QuoteManagedRequest, type QuoteManagedResponse, type QuoteManagedSplit, type QuoteManagedStep, type QuoteSplit, type QuoteStep, type RampQuote, type RampQuoteRequest, type RampSessionRequest, type RampWidgetSession, type RedeemLegResult, type RedeemLegStatus, type RedeemRequest, type RedeemResponse, type RequestedOrderbookMarket, type ResolveCorrelatedMarketsParams, type ResolveCorrelatedMarketsResponse, type ResolvedCorrelatedMarketsResponse, type SafeParseFailure, type SafeParseResult, type SafeParseSuccess, type ServerWallet, 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, 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 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 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 };