@agg-build/sdk 2.0.0 → 2.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -17,6 +17,18 @@ var __spreadValues = (a, b) => {
17
17
  return a;
18
18
  };
19
19
  var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
20
+ var __objRest = (source, exclude) => {
21
+ var target = {};
22
+ for (var prop in source)
23
+ if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
24
+ target[prop] = source[prop];
25
+ if (source != null && __getOwnPropSymbols)
26
+ for (var prop of __getOwnPropSymbols(source)) {
27
+ if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
28
+ target[prop] = source[prop];
29
+ }
30
+ return target;
31
+ };
20
32
  var __async = (__this, __arguments, generator) => {
21
33
  return new Promise((resolve, reject) => {
22
34
  var fulfilled = (value) => {
@@ -41,5 +53,6 @@ var __async = (__this, __arguments, generator) => {
41
53
  export {
42
54
  __spreadValues,
43
55
  __spreadProps,
56
+ __objRest,
44
57
  __async
45
58
  };
package/dist/index.d.mts CHANGED
@@ -619,6 +619,12 @@ type VenueMarket = {
619
619
  sportsMarketType?: string | null | undefined;
620
620
  /** Sort rank within a sports section (0=moneyline, 1=spread, 2=total, 3+=other). */
621
621
  sectionRank?: number | null | undefined;
622
+ /** Period identifier for sports markets (e.g., "1H", "2H", "Q1", etc.). */
623
+ period?: string | null | undefined;
624
+ /** Normalized subject category for prop-tab grouping (e.g., game_lines, exact_score, etc.). */
625
+ marketCategory?: string | null | undefined;
626
+ /** Line value for spread/total markets (e.g., 2.5 for totals, 3 for spreads). */
627
+ lineValue?: number | null | undefined;
622
628
  matchedVenueMarkets?: {
623
629
  id: string;
624
630
  venue: Venue;
@@ -661,6 +667,8 @@ type VenueEvent = {
661
667
  displayName: string | null;
662
668
  parentId: string | null;
663
669
  eventCount: number;
670
+ volume24hr: number;
671
+ volume: number;
664
672
  };
665
673
  }[];
666
674
  status?: MarketStatus | undefined;
@@ -670,10 +678,18 @@ type VenueEvent = {
670
678
  startDate?: string | null | undefined;
671
679
  endDate?: string | null | undefined;
672
680
  creationDate?: string | null | undefined;
681
+ /**
682
+ * Scheduled kickoff/start of the underlying game (sports events only).
683
+ * Distinct from `endDate` (market close/expiration), which can sit well
684
+ * after the game. The FE prefers this over `endDate` for the game-date
685
+ * title suffix. Null for non-sports events.
686
+ */
687
+ gameStartTime?: string | null | undefined;
673
688
  slug?: string | null | undefined;
674
689
  subtitle?: string | null | undefined;
675
690
  venues?: Venue[];
676
691
  venueCount?: number | undefined;
692
+ groupMarketCount?: number | undefined;
677
693
  marketCount?: number | undefined;
678
694
  /**
679
695
  * ISO-8601 duration denormalized from Series.recurrence. `null` means
@@ -867,6 +883,8 @@ type Category = {
867
883
  displayName: string | null;
868
884
  parentId: string | null;
869
885
  eventCount: number;
886
+ volume24hr: number;
887
+ volume: number;
870
888
  };
871
889
  type SettlementSource = {
872
890
  name: string;
@@ -1439,6 +1457,8 @@ interface WsWithdrawalLifecycleEvent {
1439
1457
  requestedAmountRaw?: string;
1440
1458
  /** Terminal settled amount in destination-token native decimals. */
1441
1459
  completedAmountRaw?: string | null;
1460
+ /** Realized platform fee in destination-token native decimals. Only present on terminal events. */
1461
+ feeRaw?: string | null;
1442
1462
  /** True when `status` is terminal (`completed` / `partial` / `failed`). */
1443
1463
  terminal: boolean;
1444
1464
  /** Optional leg delta — present when this event was triggered by a leg flip. */
@@ -2425,6 +2445,12 @@ interface WithdrawManagedParams {
2425
2445
  destinationAddress: string;
2426
2446
  /** EVM chain ID where the recipient should receive funds. Required as of v2026.04. */
2427
2447
  destinationChainId: number;
2448
+ /**
2449
+ * When `true`, the server caps the withdrawal to the maximum deliverable amount
2450
+ * instead of rejecting an over-balance request. Use only when the user explicitly
2451
+ * clicked Max — manual over-typed amounts must still surface the unviable state.
2452
+ */
2453
+ max?: boolean;
2428
2454
  }
2429
2455
  type WithdrawalLifecycleStatus = "pending" | "bridging" | "transferring" | "completed" | "partial" | "failed";
2430
2456
  type WithdrawalSourceStatus = "pending" | "submitted" | "confirmed" | "failed";
@@ -2467,6 +2493,19 @@ interface WithdrawalExpected {
2467
2493
  feeRaw: string | null;
2468
2494
  etaSeconds: number | null;
2469
2495
  }
2496
+ /** Body for POST /execution/withdraw/preview — identical to a withdraw request. */
2497
+ type WithdrawPreviewParams = WithdrawManagedParams;
2498
+ /** Response from POST /execution/withdraw/preview. All amounts are raw strings in destination-token native decimals. */
2499
+ interface WithdrawPreviewResponse {
2500
+ receiveAmountRaw: string | null;
2501
+ feeRaw: string | null;
2502
+ relayFeeRaw: string | null;
2503
+ networkFeeRaw: string | null;
2504
+ pricingStatus: "quoted" | "unviable";
2505
+ quoteExpiresAt: string | null;
2506
+ unviableReason: string | null;
2507
+ maxDeliverableRaw: string | null;
2508
+ }
2470
2509
  interface WithdrawManagedResponse {
2471
2510
  withdrawalId: string;
2472
2511
  status: WithdrawalLifecycleStatus;
@@ -2559,6 +2598,170 @@ type ExecutionPositionGroup = PositionGroup;
2559
2598
  type ManagedBalancesParams = {
2560
2599
  mode?: ExecutionMode;
2561
2600
  };
2601
+ interface PaperTradingAppOptions {
2602
+ /** App ID for the paper account namespace. Defaults to AggClient appId. */
2603
+ appId?: string;
2604
+ }
2605
+ interface PaperTradingListParams {
2606
+ limit?: number;
2607
+ cursor?: string;
2608
+ }
2609
+ interface CreatePaperTradingAccountParams {
2610
+ name?: string;
2611
+ externalId?: string;
2612
+ initialBalanceRaw?: string;
2613
+ initialBalance?: number;
2614
+ }
2615
+ interface SetPaperTradingBalanceParams {
2616
+ balanceRaw?: string;
2617
+ balance?: number;
2618
+ reason?: string;
2619
+ }
2620
+ interface ResetPaperTradingAccountParams {
2621
+ balanceRaw?: string;
2622
+ balance?: number;
2623
+ reason?: string;
2624
+ }
2625
+ interface PlacePaperTradingOrderParams {
2626
+ venueMarketOutcomeId: string;
2627
+ side: "buy" | "sell";
2628
+ spendRaw?: string;
2629
+ spend?: number;
2630
+ shares?: number;
2631
+ slippageBps?: number;
2632
+ clientOrderId?: string;
2633
+ }
2634
+ type PaperTradingMarkSource = "orderbook_midpoint" | "orderbook_best_bid" | "catalog_price";
2635
+ type PaperTradingLiquidityStatus = "full" | "partial" | "none";
2636
+ interface PaperTradingAccount {
2637
+ id: string;
2638
+ appId: string;
2639
+ name: string | null;
2640
+ externalId: string | null;
2641
+ currency: string;
2642
+ startingBalanceRaw: string;
2643
+ startingBalance: number;
2644
+ cashBalanceRaw: string;
2645
+ cashBalance: number;
2646
+ realizedPnlRaw: string;
2647
+ realizedPnl: number;
2648
+ kycStatus: "verified";
2649
+ kycVerified: true;
2650
+ status: "active" | "archived";
2651
+ createdAt: string;
2652
+ updatedAt: string;
2653
+ }
2654
+ interface PaperTradingPosition {
2655
+ id: string;
2656
+ accountId: string;
2657
+ venue: string;
2658
+ venueMarketId: string;
2659
+ venueMarketOutcomeId: string;
2660
+ marketQuestion: string;
2661
+ outcomeLabel: string;
2662
+ size: number;
2663
+ avgEntryPrice: number;
2664
+ markPrice: number;
2665
+ markSource: PaperTradingMarkSource;
2666
+ markTimestamp: number | null;
2667
+ bestBidPrice: number | null;
2668
+ bestAskPrice: number | null;
2669
+ midpoint: number | null;
2670
+ spread: number | null;
2671
+ marketValueRaw: string;
2672
+ marketValue: number;
2673
+ unrealizedPnlRaw: string;
2674
+ unrealizedPnl: number;
2675
+ liquidationPrice: number | null;
2676
+ liquidationValueRaw: string;
2677
+ liquidationValue: number;
2678
+ liquidationPnlRaw: string;
2679
+ liquidationPnl: number;
2680
+ liquidityShares: number;
2681
+ liquidityStatus: PaperTradingLiquidityStatus;
2682
+ realizedPnlRaw: string;
2683
+ realizedPnl: number;
2684
+ createdAt: string;
2685
+ updatedAt: string;
2686
+ }
2687
+ interface PaperTradingOrder {
2688
+ id: string;
2689
+ accountId: string;
2690
+ venue: string;
2691
+ venueMarketId: string;
2692
+ venueMarketOutcomeId: string;
2693
+ marketQuestion: string;
2694
+ outcomeLabel: string;
2695
+ side: "buy" | "sell";
2696
+ status: "filled" | "rejected";
2697
+ clientOrderId: string | null;
2698
+ requestedSpendRaw: string | null;
2699
+ requestedSpend: number | null;
2700
+ requestedShares: number | null;
2701
+ filledShares: number;
2702
+ avgPrice: number | null;
2703
+ slippageBps: number | null;
2704
+ notionalRaw: string;
2705
+ notional: number;
2706
+ cashDeltaRaw: string;
2707
+ cashDelta: number;
2708
+ realizedPnlRaw: string;
2709
+ realizedPnl: number;
2710
+ rejectionReason: string | null;
2711
+ createdAt: string;
2712
+ }
2713
+ interface PaperTradingBalanceAdjustment {
2714
+ id: string;
2715
+ accountId: string;
2716
+ type: "set_balance" | "reset";
2717
+ amountRaw: string;
2718
+ amount: number;
2719
+ previousCashBalanceRaw: string;
2720
+ previousCashBalance: number;
2721
+ newCashBalanceRaw: string;
2722
+ newCashBalance: number;
2723
+ reason: string | null;
2724
+ createdAt: string;
2725
+ }
2726
+ interface PaperTradingPortfolio {
2727
+ account: PaperTradingAccount;
2728
+ cashBalanceRaw: string;
2729
+ cashBalance: number;
2730
+ marketValueRaw: string;
2731
+ marketValue: number;
2732
+ equityRaw: string;
2733
+ equity: number;
2734
+ realizedPnlRaw: string;
2735
+ realizedPnl: number;
2736
+ unrealizedPnlRaw: string;
2737
+ unrealizedPnl: number;
2738
+ liquidationValueRaw: string;
2739
+ liquidationValue: number;
2740
+ liquidationEquityRaw: string;
2741
+ liquidationEquity: number;
2742
+ liquidationPnlRaw: string;
2743
+ liquidationPnl: number;
2744
+ positions: PaperTradingPosition[];
2745
+ }
2746
+ interface PaperTradingAccountsPage {
2747
+ data: PaperTradingAccount[];
2748
+ nextCursor: string | null;
2749
+ hasMore: boolean;
2750
+ }
2751
+ interface PaperTradingPositionsPage {
2752
+ data: PaperTradingPosition[];
2753
+ nextCursor: string | null;
2754
+ hasMore: boolean;
2755
+ }
2756
+ interface PaperTradingOrdersPage {
2757
+ data: PaperTradingOrder[];
2758
+ nextCursor: string | null;
2759
+ hasMore: boolean;
2760
+ }
2761
+ interface PaperTradingBalanceResponse {
2762
+ account: PaperTradingAccount;
2763
+ adjustment: PaperTradingBalanceAdjustment;
2764
+ }
2562
2765
  type UserActivityType = "trade" | "withdrawal" | "bridge" | "deposit" | "user_op" | "redeem";
2563
2766
  interface UserActivityBase {
2564
2767
  id: string;
@@ -2601,6 +2804,8 @@ interface UserActivityWithdrawal extends UserActivityBase {
2601
2804
  destinationAddress: string;
2602
2805
  destinationChainId: string;
2603
2806
  completedAmountRaw: string | null;
2807
+ chainId?: string | null;
2808
+ txHash?: string | null;
2604
2809
  errorMessage: string | null;
2605
2810
  }
2606
2811
  interface UserActivityBridge extends UserActivityBase {
@@ -2619,6 +2824,7 @@ interface UserActivityDeposit extends UserActivityBase {
2619
2824
  chainId: string;
2620
2825
  fromAddress: string;
2621
2826
  txHash: string;
2827
+ source: "connected_wallet" | "external_wallet";
2622
2828
  }
2623
2829
  interface UserActivityUserOp extends UserActivityBase {
2624
2830
  type: "user_op";
@@ -2961,6 +3167,129 @@ type SearchResponse<T> = {
2961
3167
  nextCursor: string | null;
2962
3168
  hasMore: boolean;
2963
3169
  };
3170
+ interface NewsFeedPageOptions {
3171
+ cursor?: string;
3172
+ since?: string;
3173
+ before?: string;
3174
+ limit?: number;
3175
+ }
3176
+ interface NewsFeedMarketNewsParams {
3177
+ venueMarketIds?: string[];
3178
+ venueEventIds?: string[];
3179
+ customQuery?: string;
3180
+ tbs?: string;
3181
+ limit?: number;
3182
+ }
3183
+ interface NewsFeedArticleWithSummary {
3184
+ title: string;
3185
+ url: string;
3186
+ snippet: string;
3187
+ source: string;
3188
+ imageUrl: string | null;
3189
+ publishedAt: string | null;
3190
+ summary: string;
3191
+ relevanceScore: number;
3192
+ }
3193
+ interface NewsFeedMarketNewsResult {
3194
+ venueMarketId: string;
3195
+ venueEventId: string;
3196
+ question: string;
3197
+ eventTitle: string;
3198
+ category: string;
3199
+ searchQuery: string;
3200
+ timeRange: string;
3201
+ timeRangeLabel: string;
3202
+ articles: NewsFeedArticleWithSummary[];
3203
+ }
3204
+ interface NewsFeedMarketNewsResponse {
3205
+ results: NewsFeedMarketNewsResult[];
3206
+ }
3207
+ interface NewsFeedLinkedMarket {
3208
+ venueMarketId: string;
3209
+ question: string;
3210
+ venue: string;
3211
+ yesPrice: number;
3212
+ eventTitle: string;
3213
+ eventId: string;
3214
+ summary: string;
3215
+ relevanceScore: number;
3216
+ }
3217
+ interface NewsFeedArticleFeedItem {
3218
+ article: {
3219
+ id: string;
3220
+ title: string;
3221
+ url: string;
3222
+ snippet: string;
3223
+ source: string;
3224
+ imageUrl: string | null;
3225
+ publishedAt: string | null;
3226
+ };
3227
+ markets: NewsFeedLinkedMarket[];
3228
+ category: string;
3229
+ id: string;
3230
+ seq: number;
3231
+ timestamp: string;
3232
+ }
3233
+ interface NewsFeedMarketFeedArticle {
3234
+ title: string;
3235
+ url: string;
3236
+ source: string;
3237
+ imageUrl: string | null;
3238
+ publishedAt: string | null;
3239
+ summary: string;
3240
+ relevanceScore: number;
3241
+ seq: number;
3242
+ addedAt: string;
3243
+ }
3244
+ interface NewsFeedMarketFeedItem {
3245
+ venueMarketId: string;
3246
+ question: string;
3247
+ venue: string;
3248
+ yesPrice: number;
3249
+ eventTitle: string;
3250
+ eventId: string;
3251
+ category: string;
3252
+ articleCount: number;
3253
+ articles: NewsFeedMarketFeedArticle[];
3254
+ }
3255
+ interface NewsFeedArticleFeedResponse {
3256
+ data: NewsFeedArticleFeedItem[];
3257
+ nextCursor: string | null;
3258
+ hasMore: boolean;
3259
+ }
3260
+ interface NewsFeedMarketFeedResponse {
3261
+ data: NewsFeedMarketFeedItem[];
3262
+ nextCursor: string | null;
3263
+ hasMore: boolean;
3264
+ }
3265
+ interface NewsFeedListResponse {
3266
+ feeds: Array<{
3267
+ id: string;
3268
+ name: string;
3269
+ itemCount: number;
3270
+ }>;
3271
+ }
3272
+ interface NewsFeedStatusResponse {
3273
+ articles: {
3274
+ total: number;
3275
+ today: number;
3276
+ };
3277
+ feedItems: {
3278
+ total: number;
3279
+ today: number;
3280
+ };
3281
+ perCategory: Array<{
3282
+ category: string;
3283
+ todayCount: number;
3284
+ dailyLimit: number;
3285
+ }>;
3286
+ config: {
3287
+ cronEnabled: boolean;
3288
+ itemsPerDay: number;
3289
+ batchSize: number;
3290
+ categories: string[];
3291
+ };
3292
+ }
2964
3293
  type CorrelatedMarketSide = "yes" | "no";
2965
3294
  type CorrelatedMarketSignalDirection = "more_likely" | "less_likely";
2966
3295
  interface CorrelatedMarketSignal {
@@ -3080,6 +3409,10 @@ declare class AggClient {
3080
3409
  /** In-flight refresh promise — serializes concurrent 401 retries so only one refresh runs. */
3081
3410
  private pendingRefresh;
3082
3411
  constructor(options: AggClientOptions);
3412
+ private resolvePaperTradingAppId;
3413
+ private paperTradingAccountsPath;
3414
+ private paperTradingAccountPath;
3415
+ private paperTradingListQuery;
3083
3416
  private withAuthPayload;
3084
3417
  private restoreSession;
3085
3418
  private persistSession;
@@ -3205,6 +3538,24 @@ declare class AggClient {
3205
3538
  getExecutionPositions(params?: ExecutionPositionsQuery): Promise<PaginatedResponse<ExecutionPositionGroup>>;
3206
3539
  /** Get managed wallet balances, including per-chain cash balances and per-venue position balances. */
3207
3540
  getManagedBalances(params?: ManagedBalancesParams): Promise<UnifiedBalanceResponse>;
3541
+ /** Create a server-managed paper trading account for an app. Requires adminKey or apiKey. */
3542
+ createPaperTradingAccount(params: CreatePaperTradingAccountParams, options?: PaperTradingAppOptions): Promise<PaperTradingAccount>;
3543
+ /** List server-managed paper trading accounts for an app. Requires adminKey or apiKey. */
3544
+ listPaperTradingAccounts(params?: PaperTradingListParams & PaperTradingAppOptions): Promise<PaperTradingAccountsPage>;
3545
+ /** Fetch a server-managed paper trading account. Requires adminKey or apiKey. */
3546
+ getPaperTradingAccount(accountId: string, options?: PaperTradingAppOptions): Promise<PaperTradingAccount>;
3547
+ /** Set a paper trading account cash balance. Requires adminKey or apiKey. */
3548
+ setPaperTradingBalance(accountId: string, params: SetPaperTradingBalanceParams, options?: PaperTradingAppOptions): Promise<PaperTradingBalanceResponse>;
3549
+ /** Clear positions and reset cash for a paper trading account. Requires adminKey or apiKey. */
3550
+ resetPaperTradingAccount(accountId: string, params?: ResetPaperTradingAccountParams, options?: PaperTradingAppOptions): Promise<PaperTradingBalanceResponse>;
3551
+ /** Place a direct simulated order in a paper trading account. Requires adminKey or apiKey. */
3552
+ placePaperTradingOrder(accountId: string, params: PlacePaperTradingOrderParams, options?: PaperTradingAppOptions): Promise<PaperTradingOrder>;
3553
+ /** List positions for a server-managed paper trading account. Requires adminKey or apiKey. */
3554
+ listPaperTradingPositions(accountId: string, params?: PaperTradingListParams & PaperTradingAppOptions): Promise<PaperTradingPositionsPage>;
3555
+ /** List orders for a server-managed paper trading account. Requires adminKey or apiKey. */
3556
+ listPaperTradingOrders(accountId: string, params?: PaperTradingListParams & PaperTradingAppOptions): Promise<PaperTradingOrdersPage>;
3557
+ /** Fetch account-level paper trading equity, P&L, and marked positions. Requires adminKey or apiKey. */
3558
+ getPaperTradingPortfolio(accountId: string, options?: PaperTradingAppOptions): Promise<PaperTradingPortfolio>;
3208
3559
  /** Cancel a pending managed execution by order id. */
3209
3560
  cancelManagedOrder(orderId: string, options?: {
3210
3561
  signal?: AbortSignal;
@@ -3257,6 +3608,27 @@ declare class AggClient {
3257
3608
  }): Promise<PaginatedResponse<Category>>;
3258
3609
  /** Get per-app UI config (disabled venues + category presets). Requires appId. */
3259
3610
  getAppConfig(init?: RequestInit): Promise<AppClientConfigResponse>;
3611
+ private buildNewsFeedQuery;
3612
+ /** List available market news feeds and item counts. */
3613
+ getNewsFeeds(options?: {
3614
+ signal?: AbortSignal;
3615
+ }): Promise<NewsFeedListResponse>;
3616
+ /** Get the article-centric market news feed for a category. */
3617
+ getNewsFeed(category: string, options?: NewsFeedPageOptions & {
3618
+ signal?: AbortSignal;
3619
+ }): Promise<NewsFeedArticleFeedResponse>;
3620
+ /** Get the market-centric market news feed for a category. */
3621
+ getNewsFeedMarkets(category: string, options?: NewsFeedPageOptions & {
3622
+ signal?: AbortSignal;
3623
+ }): Promise<NewsFeedMarketFeedResponse>;
3624
+ /** Get news feed coverage and per-category counts. */
3625
+ getNewsFeedStatus(options?: {
3626
+ signal?: AbortSignal;
3627
+ }): Promise<NewsFeedStatusResponse>;
3628
+ /** Search recent news for specific markets and return market impact summaries. */
3629
+ getMarketNews(params: NewsFeedMarketNewsParams, options?: {
3630
+ signal?: AbortSignal;
3631
+ }): Promise<NewsFeedMarketNewsResponse>;
3260
3632
  /**
3261
3633
  * Search events or markets by query string. Supports cursor-based pagination.
3262
3634
  *
@@ -3321,12 +3693,15 @@ declare class AggClient {
3321
3693
  getMidpoints(params: {
3322
3694
  venueMarketIds: string[];
3323
3695
  bestPrice?: boolean;
3696
+ maxMidpointIdsPerRequest?: number;
3324
3697
  }, options?: {
3325
3698
  signal?: AbortSignal;
3699
+ maxMidpointIdsPerRequest?: number;
3326
3700
  }): Promise<BatchMidpointsResponse>;
3327
3701
  getMidpoints(venueMarketIds: string[], options?: {
3328
3702
  signal?: AbortSignal;
3329
3703
  bestPrice?: boolean;
3704
+ maxMidpointIdsPerRequest?: number;
3330
3705
  }): Promise<BatchMidpointsResponse>;
3331
3706
  /** Get a single outcome-level orderbook from the engine. */
3332
3707
  getOutcomeOrderbook(outcomeId: string, options?: {
@@ -3357,6 +3732,12 @@ declare class AggClient {
3357
3732
  redeem(body: RedeemRequest): Promise<RedeemResponse>;
3358
3733
  /** Withdraw funds from managed wallets to an external address. */
3359
3734
  withdrawManaged(params: WithdrawManagedParams): Promise<WithdrawManagedResponse>;
3735
+ /**
3736
+ * Preview a withdrawal — real fee + receive estimate without creating one.
3737
+ * Optional: `withdrawManaged` does NOT require a prior preview, so partners
3738
+ * integrating against the SDK can ignore this entirely.
3739
+ */
3740
+ withdrawPreview(params: WithdrawPreviewParams): Promise<WithdrawPreviewResponse>;
3360
3741
  /**
3361
3742
  * Read the current persisted state of a withdrawal. Used as a backfill for
3362
3743
  * the WS lifecycle channel: the client polls this on hook mount and on WS
@@ -3369,6 +3750,15 @@ declare class AggClient {
3369
3750
  syncManagedBalances(): Promise<SyncBalancesResponse>;
3370
3751
  /** Get managed wallet deposit addresses (EVM + Solana). Returns 202 shape while provisioning. */
3371
3752
  getDepositAddresses(): Promise<DepositAddressesResponse>;
3753
+ /**
3754
+ * Internal: record that a deposit tx was initiated via the in-app
3755
+ * connected-wallet flow, so the activity feed can label it correctly.
3756
+ * Best-effort — callers should not block the UX on this.
3757
+ */
3758
+ recordDepositIntent(body: {
3759
+ chainId: number;
3760
+ txHash: string;
3761
+ }): Promise<void>;
3372
3762
  /** Get open positions grouped by matched market with per-venue breakdown. */
3373
3763
  getPositions(params?: GetPositionsParams): Promise<PaginatedResponse<PositionGroup>>;
3374
3764
  /** Get crypto purchase quotes. */
@@ -3460,4 +3850,4 @@ declare function aggregateMidpoint(midpoints: (number | null | undefined)[]): nu
3460
3850
 
3461
3851
  declare function createAggClient(options: AggClientOptions): AggClient;
3462
3852
 
3463
- 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 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 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 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, 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 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, 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 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 };
3853
+ 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 };