@agg-build/sdk 4.32.0 → 4.33.0

package/dist/{agg-websocket-DsEtBkLk.d.mts → agg-websocket-CvYdVJPc.d.mts}

@@ -527,6 +527,8 @@ type UnifiedBalanceResponse = {
       lastSyncedAt: string;
       /** Chain wallet address; native venue collateral uses account IDs instead. */
       address?: string | undefined;
+      /** `custody=self`: the linked wallet this balance belongs to (owner of a deposit/legacy wallet). */
+      walletAddress?: string | undefined;
       custodyKind?: "EOA" | "DEPOSIT_WALLET" | "POLYMARKET_LEGACY" | "VENUE_ACCOUNT" | undefined;
       /** Native cash is venue-scoped, not fungible EOA inventory. */
       venue?: Venue | undefined;
@@ -1649,1646 +1651,2352 @@ declare function projectedOrderbookChecksum(book: {
   }>;
 }): number;
 //#endregion
-//#region src/types.d.ts
-/** App-level paper/live mode. An app is one or the other, never both. */
-type AppTradingMode = "live" | "paper";
-interface AppClientConfigResponse {
-  prophetxExecutionMode?: "clearinghouse" | "direct";
-  novigExecutionMode?: "clearinghouse" | "direct";
-  disabledVenues: Venue[];
-  disabledCategoryPresets: string[];
-  earlyAccessEnabled: boolean;
-  authOptions: AppClientAuthOption[];
-  /**
-   * Server-owned execution mode. Prefer this over any locally-configured
-   * `trading.executionMode` — the API enforces it regardless of what the
-   * client sends, and end users cannot change it.
-   */
-  tradingMode: AppTradingMode;
-  /**
-   * One-time simulated balance granted on first paper use, in dollars.
-   * Interpolate this into paper copy rather than hardcoding a figure.
-   */
-  paperStartingBalance: number;
+//#region src/ws-types.d.ts
+/**
+ * WebSocket protocol types for the Agg platform.
+ * All callback timestamps are in **seconds** (converted from server ms at SDK dispatch).
+ * These are plain TS interfaces — no Zod dependency for partner-side usage.
+ */
+/** Aggregated level wire format: [price, totalSize, {venue: sizeAtPrice}] */
+type WsAttributedLevel = [number, number, Record<string, number>];
+/** Per-venue level wire format: [price, size] */
+type WsVenueLevel = [number, number];
+interface WsVenueInfo {
+  bestBid: number | null;
+  bestAsk: number | null;
 }
-interface VenueGeoPolicyEntry {
-  venue: Venue;
-  /** ISO 3166-1 alpha-2, upper-case. Empty means no country restriction. */
-  blockedCountries: string[];
+interface WsVenueBook {
+  bids: WsVenueLevel[];
+  asks: WsVenueLevel[];
+}
+interface WsOrderbookSnapshot {
+  type: "orderbook_snapshot";
+  outcomeId: string;
+  channel?: "orderbook" | "trades";
+  seq: number;
+  checksum: number;
+  bids: WsAttributedLevel[];
+  asks: WsAttributedLevel[];
+  venueOrderbooks: Record<string, WsVenueBook>;
+  venues: Record<string, WsVenueInfo>;
+  midpoint: number | null;
+  spread: number | null;
+  /** @unit seconds (converted from server ms) */
+  timestamp: number;
   /**
-   * ISO 3166-1 alpha-2, upper-case. When present, this venue is ALLOWLIST
-   * mode: ONLY these countries are permitted (`blockedCountries` is always
-   * `[]` alongside this and must be ignored). Absent/undefined ⇒ ordinary
-   * denylist mode, use `blockedCountries` as before. Only Novig uses this
-   * today — a client that reads only `blockedCountries` sees an allowlisted
-   * venue as unrestricted, which is exactly the misread this field closes.
+   * Sticky tick of this outcome's book, inferred at runtime by the engine.
+   * `null` until inferred. Optional — older snapshot producers (REST fallback)
+   * may omit this field entirely.
    */
-  allowedCountries?: string[];
+  tick?: number | null;
+  /** Provenance of the published `midpoint`. See {@link MarkSource}. */
+  markSource?: MarkSource$1;
 }
-interface VenueGeoPolicyResponse {
-  venues: VenueGeoPolicyEntry[];
+/**
+ * Provenance tag for a published midpoint. Mirrors the Rust engine
+ * `MarkSource::as_str()` output.
+ */
+type WsMarkSource = "local" | "local_merged" | "local_one_sided" | "sibling" | "local_boundary" | "none";
+type MarkSource$1 = WsMarkSource;
+interface WsOrderbookDelta {
+  type: "orderbook_delta";
+  outcomeId: string;
+  channel?: "orderbook" | "trades";
+  seq: number;
+  checksum: number;
+  bidChanges: WsAttributedLevel[];
+  askChanges: WsAttributedLevel[];
+  venueDeltaBooks: Record<string, {
+    bidChanges: WsVenueLevel[];
+    askChanges: WsVenueLevel[];
+  }>;
+  venues: Record<string, WsVenueInfo>;
+  midpoint: number | null;
+  spread: number | null;
+  /** @unit seconds (converted from server ms) */
+  timestamp: number;
 }
-interface RpcTokenResponse {
-  token: string;
-  expiresAt: number;
+interface WsTrade {
+  type: "trade";
+  outcomeId: string;
+  channel?: "orderbook" | "trades";
+  venue: string;
+  side: "buy" | "sell";
+  price: number;
+  size: number;
+  /** @unit seconds (converted from server ms) */
+  timestamp: number;
+  /** Venue-unique trade id, when the venue supplies one (Hyperliquid today). */
+  tradeId?: string;
 }
-type AggAuthProviderType = "siwe" | "siws" | "google" | "twitter" | "apple" | "email";
-interface AppClientAuthOption {
-  provider: AggAuthProviderType;
-  type: "oauth" | "email" | "wallet";
-  enabled: boolean;
-  callbackUrl?: string;
-  statement?: string;
+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[];
+  /** Confirmed marketIds — only set on `arb` confirmations, whose
+   *  subscriptions are keyed by marketIds, not outcomeIds. */
+  marketIds?: string[];
+  channel: "orderbook" | "trades" | "arb" | "arb-feed" | "app-events" | "catalog";
+  /** Echo of the request's `id`, when one was sent. */
+  id?: string | number;
 }
-type AggAuthDeliveryMode = "body" | "cookie-refresh";
-interface AggClientAuthOptions {
-  getEarlyAccessCode?: () => string | null;
+interface WsUnsubscribed {
+  type: "unsubscribed";
+  /** See {@link WsSubscribed.outcomeIds}. */
+  outcomeIds: string[];
+  /** Confirmed marketIds — only set on `arb` confirmations. */
+  marketIds?: string[];
+  channel: "orderbook" | "trades" | "arb" | "arb-feed" | "app-events" | "catalog";
+  id?: string | number;
 }
-type AggAuthStartBody = {
-  provider: Exclude<AggAuthProviderType, "email">;
-  redirectUrl?: string;
-  /** Cloudflare Turnstile token — required when a prior authStart returned `challenge_required`. */
-  turnstileToken?: string;
-  earlyAccessCode?: string;
-} | {
-  provider: "email";
-  email: string;
-  redirectUrl?: string;
-  /** Cloudflare Turnstile token — required when a prior authStart returned `challenge_required`. */
-  turnstileToken?: string;
-  earlyAccessCode?: string;
-};
-/** SIWE / SIWS sign-in. `kind` is optional so callers that predate the discriminator still compile. */
-interface AggAuthWalletVerifyBody {
-  kind?: "wallet";
-  message: string;
-  signature: string;
-  earlyAccessCode?: string;
+interface WsConnected {
+  type: "connected";
+  appId: string;
+  userId?: string;
+  /** Protocol revision. 2 adds error codes, request ids, event ids and resume. */
+  protocolVersion?: number;
+  /** `key` when admitted by `x-app-api-key`, `browser` when admitted by Origin. */
+  auth?: "browser" | "key";
 }
-/** Privy sign-in. Requires the app's wallet provider to be Privy; the token must come from that Privy app. */
-interface AggAuthPrivyVerifyBody {
-  kind: "privy";
-  privyToken: string;
-  earlyAccessCode?: string;
+interface WsAuthenticated {
+  type: "authenticated";
+  userId: string;
+  /** Token expiry (Unix ms). Re-authenticate before it, or user events stop. */
+  expiresAt?: number;
+  id?: string | number;
+}
+/** Sent about a minute before the user token expires. */
+interface WsAuthExpiring {
+  type: "auth_expiring";
+  userId: string;
+  /** @unit milliseconds */
+  expiresAt: number;
 }
-/** Body for `POST /auth/verify` — mirrors the API's union on `kind`. */
-type AggAuthVerifyBody = AggAuthWalletVerifyBody | AggAuthPrivyVerifyBody;
-type AggAuthStartResult = {
-  type: "nonce";
-  nonce: string;
-  statement?: string;
-} | {
-  type: "redirect";
-  url: string;
-} | {
-  type: "magic_link";
-  success: true;
-} | {
-  type: "challenge_required";
-  siteKey: string;
-};
 /**
- * Body for `POST /users/me/link-account/start` — authenticated account linking.
- *
- * `redirectUrl` is required for OAuth/email providers: the callback / magic-link
- * verify hands the partner a `link_confirm_token` by redirecting to `redirectUrl`,
- * and the partner app completes the flow by calling `/confirm` from that page.
- *
- * Wallet providers (`siwe`/`siws`) instead return a `wallet_challenge` with a
- * `message` the user signs VERBATIM; the signature is then confirmed with
- * `{ kind: "wallet_signature", message, signature }`.
+ * The user session ended and the connection continues at app level: market
+ * data keeps flowing, user events stop until you `authenticate` again.
  */
-type AggLinkAccountBody = {
-  provider: "google" | "twitter" | "apple";
-  redirectUrl: string;
-} | {
-  provider: "email";
-  email: string;
-  redirectUrl: string;
-} | {
-  provider: "siwe" | "siws";
-  address: string;
-};
-type AggLinkAccountResult = {
-  type: "redirect";
-  url: string;
-} | {
-  type: "magic_link";
-  success: true;
-} | {
-  type: "wallet_challenge";
-  message: string;
-};
+interface WsAuthExpired {
+  type: "auth_expired";
+  userId: string;
+  reason: "expired" | "revoked" | "suspended";
+}
 /**
- * Wallet branch of `POST /users/me/link-account/confirm`. Requires `kind` so it
- * can never be confused with the `token` branch. `message` MUST be the exact
- * `message` returned by `/start`'s `wallet_challenge` — the server compares it
- * byte-for-byte, so do not reconstruct or edit it client-side.
+ * End of a resume replay. When `complete` is false, events may have been
+ * missed (outside the retention window, or the log was unavailable):
+ * reconcile orders, balances and withdrawals over REST.
  */
-type AggLinkAccountWalletConfirmBody = {
-  kind: "wallet_signature";
-  message: string;
-  signature: string;
-};
+interface WsResumed {
+  type: "resumed";
+  stream: "user" | "app";
+  fromEventId: string;
+  replayed: number;
+  complete: boolean;
+  id?: string | number;
+}
 /**
- * Success result of /users/me/link-account/confirm.
- * - `linked` — new Account row written.
- * - `already_linked_same` — identity was already attached to the caller's Principal
- *   (idempotent; safe to retry).
- *
- * Collisions with a different Principal surface as HTTP 409 and are thrown by the
- * SDK's request layer — catch them at the call site, don't expect them here.
+ * Upstream delivery was interrupted; frames on `channels` may be missing.
+ * Orderbooks are resnapshotted automatically; trades and arb updates in the
+ * gap are not recoverable. Catalog changes are: catch up over
+ * `GET /catalog/changes` (`AggClient.watchCatalog` does this).
  */
-type AggLinkAccountConfirmResult = {
-  status: "linked" | "already_linked_same";
-  provider: string;
-};
-type AggSessionUser = AuthUser | UserProfile;
-interface AggClientSessionInput {
-  accessToken: string;
-  refreshToken?: string;
-  user?: AggSessionUser;
+interface WsStreamInterrupted {
+  type: "stream_interrupted";
+  channels: string[];
+  timestamp: number;
 }
-/** Non-sensitive auth snapshot persisted to localStorage for UI bootstrapping.
- *  Tokens are NEVER included — they exist only in process memory. */
-interface PersistedAuthSnapshot {
-  user: {
-    id: string;
-    username: string | null;
-    avatarUrl: string | null;
-    walletAddress?: string | null;
-  } | null;
-  authHint: {
-    wasAuthenticated: boolean;
-  };
+interface WsHeartbeat {
+  type: "heartbeat";
+  /** @unit seconds (converted from server ms) */
+  ts: number;
 }
-/** Auth lifecycle status for UI state machines. */
-type AuthStatus = "unknown" | "authenticated" | "unauthenticated";
-type SignatureRequestType = "eip712" | "personal_sign" |
-/** EVM transaction — bridge legs and approvals. secp256k1. */
-"transaction" |
-/** Solana transaction — bridge legs on SVM. ed25519, NOT secp256k1. */
-"solana_transaction" | "hl_l1_action" |
-/**
- * EIP-7702 authorization over `{ contractAddress, chainId, nonce }`.
- *
- * A signature over a RAW digest — `keccak(0x05 ‖ rlp([chainId, delegate,
- * nonce]))` — not EIP-191 and not EIP-712. Many wallets do not expose this,
- * and that is expected: reject it and the server falls back to asking the
- * user to broadcast a plain approve instead.
- */
-"eip7702_authorization" |
-/**
- * A Gnosis Safe transaction relayed through Polymarket — a legacy Polymarket
- * wallet funding a fill. The payload is the SafeTx as EIP-712 typed data,
- * but the wallet must `personal_sign` the RAW 32 bytes of
- * `hashTypedData(payload)` (`signMessage({ message: { raw: hash } })`):
- * Polymarket's relayer only accepts that shape. `payload.safeTxHash` carries
- * the digest for convenience; the server recomputes it from the typed data.
- */
-"safe_tx";
-/** One payload the client must sign before a fill can proceed. */
-interface SignatureRequest {
-  /** Echo this back with the signature. */
-  stepId: string;
-  /** Payload shape. Discriminates how to sign — not which venue. */
-  type: SignatureRequestType;
-  venue: string;
-  /** The address that must produce this signature. Sign with this key, not another. */
-  signerAddress: string;
-  /** Absent for non-EVM payloads (e.g. Hyperliquid L1 actions). */
-  chainId?: number;
-  /** Sign verbatim. */
-  payload: unknown;
-  expiresAt: string;
-  /** Why this signature is being asked for, when the server knows (e.g. `"fee"`, `"funding_and_fee"`). Display only. */
-  purpose?: string;
+interface WsResolvedOutcome {
+  label: string;
+  winner?: boolean;
+  externalIdentifier?: string;
   /**
-   * The fill proceeds without this one (e.g. `purpose: "hl_referral"`, a
-   * partner referral parked beside a Hyperliquid order). `fillSelfCustody`
-   * skips it if your signer throws or it has expired, instead of failing the
-   * fill.
+   * Per-share USDC payout in [0, 1] once settled. A void or split pays less
+   * than 1 on every side (e.g. 0.5), so `winner` alone can't tell it from a
+   * win. Absent when unknown.
    */
-  optional?: boolean;
-}
-/**
- * Supplied by the partner. Receives a payload, returns a signature. The SDK
- * never sees the key.
- *
- * Return a 0x-prefixed hex string for anything the wallet SIGNS:
- *
- * - `eip712` — `signTypedData` over `payload`.
- * - `personal_sign` — EIP-191 over `payload`: a UTF-8 string or `{ raw: "0x…" }
- *   bytes (Polymarket proxy batches). Pass it directly as viem `message`.
- * - `safe_tx` — `personal_sign` over the RAW 32 bytes of
- *   `hashTypedData(payload)` (viem: `signMessage({ message: { raw: hash } })`,
- *   MetaMask: `personal_sign` with the hex hash). The wallet shows a hash, not
- *   a structured prompt — that is what Polymarket's own relayer requires.
- * - `hl_l1_action` — Hyperliquid L1 action, EIP-712 in phantom-agent form.
- * - `eip7702_authorization` — an EIP-7702 authorization over
- *   `{ contractAddress, chainId, nonce }`. This is a signature over a RAW
- *   digest, not EIP-191 and not EIP-712, and many wallets do not expose it.
- *   **Throwing here does not help**: there is no reject verb, so a thrown
- *   signer is indistinguishable from a slow user — the request simply expires
- *   and the fill dies. If your wallet cannot produce this signature, declare
- *   `approveMode: "user_broadcast"` on the fill instead and the approve is
- *   requested as a `transaction` the user sends themselves. Handling this
- *   request is what makes funding gasless.
- * - `solana_transaction` — `payload.messageBase64` is the serialized Solana
- *   transaction MESSAGE; `payload.transactionBase64` is the full unsigned
- *   `VersionedTransaction` for wallets that need one to display/simulate.
- *   Return `0x` + 128 hex chars: the 64-byte ed25519 signature over the
- *   decoded message. With a wallet adapter: `const signed = await
- *   wallet.signTransaction(VersionedTransaction.deserialize(base64decode(transactionBase64)))`
- *   then return the signature at the index of `signerAddress` in
- *   `signed.message.staticAccountKeys`, hex-encoded. Do NOT send it — the
- *   server co-signs as fee payer and broadcasts. The user needs no SOL.
- *   The signature MUST be over the UNMODIFIED message: the server verifies
- *   it against the bytes it persisted, so a wallet that inserts
- *   instructions before signing (priority fee, guards, Lighthouse) gets a
- *   400 — disable such features for this request or sign the raw message.
- *
- * Return `{ txHash }` for anything the wallet BROADCASTS:
- *
- * - `transaction` — send it, then return the hash **immediately, without
- *   awaiting the receipt**. The server watches for the mined receipt itself
- *   and will not resume until it matches the request byte-for-byte.
- */
-type SignerFn = (req: SignatureRequest) => Promise<string | {
-  txHash: string;
-}>;
-/**
- * How long `fillSelfCustody` will keep waiting before giving up.
- *
- * Covers a first-time user: sign the wallet-setup batch, wait for it on-chain,
- * then sign the order. Generous because the wait is a relayer transaction
- * confirming, not a human deciding.
- */
-declare const SELF_CUSTODY_FILL_TIMEOUT_MS: number;
-/** Gap between re-reads while an on-chain step is in flight. */
-declare const SELF_CUSTODY_POLL_INTERVAL_MS = 2000;
-/**
- * How long `fillSelfCustody` waits on the `signer` for ONE optional request
- * signed by a wallet other than the user's — e.g. a partner's activation
- * sponsor. Such a request can delay the batch's submission by at most this long,
- * after which it is declined and the required signatures go out without it.
- * Required requests, and optional ones the user's own wallet signs (the fill's
- * `signingAddress` or any required request's `signerAddress`, e.g. a referral
- * code), are never bounded by this.
- */
-declare const OPTIONAL_SIGNATURE_TIMEOUT_MS = 15000;
-/**
- * How long `fillSelfCustody` waits on an optional Polymarket buy fee pre-sign
- * (`purpose: "app_fee"`). It never holds the order (that round is already
- * posted), so it can wait for a slow wallet: just under the server's 60s grace,
- * after which the request is expired and a post-fill signature asked instead.
- */
-declare const OPTIONAL_FEE_SIGNATURE_TIMEOUT_MS = 55000;
-/**
- * States a run never leaves. Everything else means "still working".
- *
- * Typed against `ExecutionOverallState` so a typo'd or renamed literal (e.g.
- * `cancelled` drifting to `canceled`) is a compile error instead of a state
- * that silently stops being treated as terminal. Mirrors
- * `ExecutionOverallStateTB` in the contract; keep the two in step.
- */
-declare const TERMINAL_EXECUTION_STATES: ReadonlySet<ExecutionOverallState>;
-type SportsGameStatus = "scheduled" | "live" | "paused" | "finished" | "cancelled" | "postponed" | "unknown";
-interface SportsLiveParticipant {
-  position: "first" | "second";
-  name: string;
-  shortName: string | null;
-  imageUrl: string | null;
-  score: string | null;
+  payoutPerShare?: number;
+  /** Venue refunded every holder their stake (valued at entry price). */
+  refundAtCost?: boolean;
+  /** Who decided `winner`: the venue itself, or inferred from matched markets. */
+  winnerSource?: "venue" | "matched";
 }
-interface SportsLiveState {
-  eventId: string;
-  sport: string;
-  status: SportsGameStatus;
-  participants: [SportsLiveParticipant, SportsLiveParticipant];
-  period: string | null;
-  clock: string | null;
-  updatedAt: string | null;
+interface WsMarketResolved {
+  type: "market_resolved";
+  outcomeId: string;
+  status: "resolved" | "closed";
+  /** Winning outcome label, or null if unknown. */
+  result: string | null;
+  /** Per-outcome resolution data. */
+  outcomes: WsResolvedOutcome[];
+  /** @unit seconds (converted from server ms) */
+  timestamp: number;
 }
-interface SportsLiveResponse {
-  data: SportsLiveState[];
-  missingEventIds: string[];
+/** Machine-readable error codes. Branch on `code`, not on `message`. */
+type WsErrorCode = "missing_app_id" | "invalid_app" | "origin_not_allowed" | "api_key_required" | "invalid_api_key" | "invalid_token" | "token_app_mismatch" | "admin_token_not_allowed" | "too_many_connections" | "rate_limited" | "invalid_message" | "too_many_ids" | "subscription_limit" | "outcomes_blocked" | "not_subscribed" | "snapshot_unavailable" | "app_events_forbidden" | "internal_error";
+interface WsError {
+  type: "error";
+  /** Absent only on servers older than protocol version 2. */
+  code?: WsErrorCode;
+  message: string;
+  /** Echo of the `id` of the request that caused the error. */
+  id?: string | number;
+  /** Outcome ids the error applies to. */
+  outcomeIds?: string[];
+  /** Market ids the error applies to (arb). */
+  marketIds?: string[];
 }
-interface AggClientOptions {
-  /** Browser adapters can inject a Worker transport; other runtimes keep the native client. */
-  webSocketFactory?: (options: AggWebSocketOptions) => AggWebSocket;
-  baseUrl: string;
-  /** Public App ID — sent as x-app-id header. For client-side partner usage. */
-  appId?: string;
-  /** Secret admin key — sent as x-admin-key header. Server-side only. */
-  adminKey?: string;
-  /**
-   * Partner API key for server-side use. Sent as `x-app-api-key`. NEVER embed
-   * in browser bundles, source maps, or logs. Keys start with `agg_<appId>_`.
-   */
-  apiKey?: string;
-  /** WebSocket URL for real-time feeds. Must be set explicitly to use createWebSocket(). */
-  wsUrl?: string;
-  /** Opt in after immutable history publication/CDN rollout. Defaults false. */
-  preferImmutableHistory?: boolean;
+interface WsOrderSubmitted {
+  type: "order_submitted";
+  venue: string;
+  orderId: string;
+  side: string;
+  price: number;
+  size: number;
+  outcomeId?: string;
+  marketId?: string;
+  /** @unit seconds (converted from server ms) */
+  timestamp: number;
+  /** Owner of the event. */
+  userId?: string;
   /**
-   * @deprecated Kalshi live discovery and trading are retired. This ignored
-   * compatibility option remains to avoid breaking existing SDK consumers.
+   * Position in the stream named by `stream` (`user` or `app`). Increasing
+   * per stream; the SDK resumes from the last one after a reconnect and
+   * drops duplicates. Absent if the server's event log was unavailable.
    */
-  kalshiDemo?: boolean;
-  /** Optional auth request hooks used to enrich auth payloads. */
-  auth?: AggClientAuthOptions;
-  /** Move refresh delivery to an HttpOnly cookie on auth endpoints. Defaults to "body". */
-  authDelivery?: AggAuthDeliveryMode;
-  /** Persist a non-sensitive auth hint to localStorage for UI bootstrapping.
-   *  Tokens are NEVER persisted — they exist only in process memory.
-   *  When authDelivery is "body", refresh tokens are lost on page reload.
-   *  When authDelivery is "cookie-refresh", refresh tokens survive via HttpOnly cookies
-   *  and the SDK attempts a silent refresh on cold start. Defaults to true. */
-  persistSession?: boolean;
+  eventId?: string;
+  stream?: "user" | "app";
+  /** True when re-delivered by a resume. */
+  replayed?: boolean;
+}
+interface WsBalanceUpdate {
+  type: "balance_update";
+  venue: string;
+  tradingBalanceCents: number;
+  walletBalanceCents?: number;
+  /** @unit seconds (converted from server ms) */
+  timestamp: number;
+  /** Owner of the event. */
+  userId?: string;
   /**
-   * Supplies signatures for self-custodial fills. Required whenever
-   * `fillSelfCustody()` is called with `signingAddress` — the SDK never
-   * holds a key itself, so without this option a fill that needs a
-   * client-side signature cannot proceed. The signature requests never
-   * come back on `POST /execution/fill` itself: `fillSelfCustody()` polls
-   * `GET /execution/status` for them (`pendingSignatures`), signs each one
-   * with this function, and posts the result to
-   * `POST /execution/fill/:quoteId/signatures`.
+   * Position in the stream named by `stream` (`user` or `app`). Increasing
+   * per stream; the SDK resumes from the last one after a reconnect and
+   * drops duplicates. Absent if the server's event log was unavailable.
    */
-  signer?: SignerFn;
-}
-interface SiweMessageParams {
-  domain: string;
-  address: string;
-  uri: string;
-  nonce: string;
-  chainId?: number;
-  statement?: string;
-  issuedAt?: string;
+  eventId?: string;
+  stream?: "user" | "app";
+  /** True when re-delivered by a resume. */
+  replayed?: boolean;
 }
-interface SiwsMessageParams {
-  domain: string;
-  /** Base58-encoded Solana public key. */
-  address: string;
-  uri: string;
-  nonce: string;
-  /** Solana chain ID: "mainnet", "devnet", "testnet", or "localnet". Defaults to "mainnet". */
-  chainId?: string;
-  statement?: string;
-  issuedAt?: string;
+type WsOrderEventType = "cancelled" | "created" | "signed" | "pending_bridge" | "bridge_complete" | "submitting" | "submitted" | "expired" | "dag_started" | "dag_completed" | "dag_failed" | "dag_cancelled" | "step_started" | "step_completed" | "step_waiting" | "step_failed" | "step_retrying" | "filled" | "partial_fill" | "failed" | "bridge_ws_subscribed" | "bridge_ws_subscribe_failed" | "bridge_polling_fallback";
+interface WsOrderEvent {
+  type: "order_event";
+  event: WsOrderEventType;
+  userId: string;
+  orderId: string;
+  /** Partner trade id from `placeOrder()`, when the order carried one. */
+  externalId?: string;
+  venue: string;
+  dagRunId?: string;
+  stepId?: string;
+  stepType?: string;
+  /** Authenticated notification that a wait is parked; fetch status for its payload. */
+  waitingFor?: {
+    topic: string;
+    filterValue: string;
+  };
+  /** 1-based step index. Pair with `totalSteps` to render "Step 3 of 7". */
+  sequence?: number;
+  totalSteps?: number;
+  templateName?: string;
+  /** Maps sequence → stepType for all steps — sent on dag_started so labels are available upfront. */
+  stepTypes?: Record<number, string>;
+  filledAmountRaw?: string;
+  remainingAmountRaw?: string;
+  /**
+   * Quote-time and actual shares + payout. All 6-decimal atomic units
+   * (so 1.234567 shares = "1234567", "$50 to win" = "50000000"). Set
+   * on `filled` / `partial_fill` so the UI can render "Quoted X / Got Y"
+   * without re-deriving from cost ÷ price (which loses precision on
+   * fractional fills and divides by zero before `executionPrice` exists).
+   */
+  quotedSharesRaw?: string;
+  actualSharesRaw?: string;
+  quotedToWinRaw?: string;
+  actualToWinRaw?: string;
+  /** Quote-time price (decimal string, e.g. "0.5"). Pair with `executionPriceRaw`
+   * to render the slippage diff inline. */
+  quotedPriceRaw?: string;
+  /**
+   * Actual avg fill price (decimal string): `filledAmountRaw / actualSharesRaw`.
+   * A sell's is net of fee; most venues report a buy's fee separately in
+   * `actualVenueFeeRaw`. On Hyperliquid this event carries the quote; the realized
+   * price lands on the order shortly after (`GET /execution/orders`).
+   */
+  executionPriceRaw?: string;
+  /**
+   * Set on `partial_fill` events only. One of `"venue_capacity"`,
+   * `"price_slipped"`, `"user_cancelled"`, `"timeout"`, `"bridge_short"`,
+   * or a venue-specific tag.
+   */
+  partialFillReason?: string;
+  errorReason?: string;
+  attempt?: number;
+  correlationId?: string;
+  /** @unit milliseconds (raw from server — NOT converted like other WS types) */
+  timestamp: number;
+  /**
+   * Position in the stream named by `stream` (`user` or `app`). Increasing
+   * per stream; the SDK resumes from the last one after a reconnect and
+   * drops duplicates. Absent if the server's event log was unavailable.
+   */
+  eventId?: string;
+  stream?: "user" | "app";
+  /** True when re-delivered by a resume. */
+  replayed?: boolean;
 }
-/** OHLCV bar point for chart rendering. */
-interface ChartCandle {
-  /** Venue average; distinct from OHLC close. */
-  mean?: number;
-  /** Open time in Unix milliseconds. */
-  t: number;
-  /** Open price (0-1). */
-  o: number;
-  /** High price (0-1). */
-  h: number;
-  /** Low price (0-1). */
-  l: number;
-  /** Close price (0-1). */
-  c: number;
-  /** Volume (null if unavailable). */
-  v: number | null;
+interface WsRedeemEvent {
+  type: "redeem_event";
+  redeemId: string;
+  venueMarketOutcomeId: string;
+  status: "submitted" | "confirmed" | "failed";
+  callsId: string | null;
+  pendingUserOpId: string | null;
+  txHash: string | null;
+  errorMessage: string | null;
+  /** @unit seconds (converted from server ms) */
+  timestamp: number;
+  /** Owner of the event. */
+  userId?: string;
+  /**
+   * Position in the stream named by `stream` (`user` or `app`). Increasing
+   * per stream; the SDK resumes from the last one after a reconnect and
+   * drops duplicates. Absent if the server's event log was unavailable.
+   */
+  eventId?: string;
+  stream?: "user" | "app";
+  /** True when re-delivered by a resume. */
+  replayed?: boolean;
 }
-/** @deprecated Historical chart bars are canonical per outcome. Use ChartBarsResponse instead. */
-interface ChartVenueCandles {
-  venue: string;
-  candles: ChartCandle[];
+/** Top-level withdrawal lifecycle states surfaced to partner clients. */
+type WsWithdrawalLifecycleStatus = "pending" | "bridging" | "transferring" | "completed" | "partial" | "failed";
+type WsWithdrawalLegStatus = "planned" | "submitted" | "confirmed" | "failed";
+interface WsWithdrawalLifecycleLeg {
+  sourceChainId: number;
+  destChainId: number;
+  type: "transfer" | "bridge";
+  status: WsWithdrawalLegStatus;
+  amountRaw: string;
+  txHash: string | null;
+  bridgeOperationId: string | null;
+  /** Human-readable failure reason when `status === "failed"`. Null/absent when succeeded or in-flight. */
+  errorMessage?: string | null;
 }
-type ChartResolution = "1m" | "5m" | "1h" | "1d";
 /**
- * Freshness signal embedded in every chart response. Compare
- * `staleSeconds` against the resolution to decide whether to show a
- * "delayed" badge on the chart.
+ * Per-withdrawal lifecycle event. Wire shape is intentionally additive:
+ * consumers should pass through unknown enum values rather than failing.
  */
-interface ChartBarsMeta {
-  state?: "ready" | "warming" | "unsupported" | "failed" | "empty";
-  complete?: boolean;
-  retryAfterMs?: number;
-  /** Agg fetch/publication time. Does not measure upstream delivery latency. */
-  fetchedAtMs?: number;
-  /** Server-side wall clock when the response was assembled, in milliseconds. */
-  serverTime: number;
-  /** `open_time` of the most-recent bar in `data`, in milliseconds. Null if `data` is empty. */
-  lastBarOpenTime: number | null;
-  /** `serverTime - lastBarOpenTime` in seconds. Null if `data` is empty. */
-  staleSeconds: number | null;
+interface WsWithdrawalLifecycleEvent {
+  type: "withdrawal_lifecycle";
+  withdrawalId: string;
+  userId: string;
+  status: WsWithdrawalLifecycleStatus;
+  /** Requested withdrawal amount in destination-token native decimals. */
+  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. */
+  leg?: WsWithdrawalLifecycleLeg;
+  /** All legs at the moment of emission (snapshot). */
+  legs?: WsWithdrawalLifecycleLeg[];
+  /** Failure reason for terminal `failed` / `partial`. */
+  errorMessage?: string;
+  correlationId?: string;
+  /** @unit milliseconds (raw from server — NOT converted like other WS types) */
+  timestamp: number;
+  /**
+   * Position in the stream named by `stream` (`user` or `app`). Increasing
+   * per stream; the SDK resumes from the last one after a reconnect and
+   * drops duplicates. Absent if the server's event log was unavailable.
+   */
+  eventId?: string;
+  stream?: "user" | "app";
+  /** True when re-delivered by a resume. */
+  replayed?: boolean;
 }
-/** Response from GET /charts/bars. */
-interface ChartBarsResponse {
-  /** VenueMarketOutcome.id requested by the caller. */
-  venueMarketOutcomeId: string;
-  /** Venue of the canonical historical series. */
-  venue: string;
-  /** Resolution returned by the backend. */
-  resolution: ChartResolution;
-  /** Bars sorted in ascending open time. */
-  data: ChartCandle[];
-  /** Freshness signal — see {@link ChartBarsMeta}. */
-  meta: ChartBarsMeta;
+interface WsArbMarketUpdate {
+  type: "arb_market_update";
+  marketId: string;
+  /** Producer assertion that globally inactive venues were excluded. */
+  activeVenuesOnly: true;
+  venueEventId: string | null;
+  arbReturn: number;
+  ts: number;
+  liquidityUsd?: number;
+  liquidityTier?: "deep" | "shallow";
 }
-interface ChartHistoryManifest {
-  version: 1;
-  revision: string | null;
-  venueMarketOutcomeId: string;
-  venue: string;
-  resolution: ChartResolution;
-  semantics: "venue-ohlcv-v1" | "polymarket-price-samples-v1" | "kalshi-ohlcv-quote-fallback-v2";
-  from: number;
-  to: number;
-  finalizedThrough: number;
-  chunks: Array<{
-    key: string;
-    url: string;
-    sha256: string;
-    from: number;
-    to: number;
-    points: number;
-  }>;
-  meta: ChartBarsMeta;
+interface WsArbFeedEntry {
+  marketId: string;
+  venueEventId: string | null;
+  arbReturn: number;
+  ts: number;
+  liquidityUsd?: number;
+  liquidityTier?: "deep" | "shallow";
 }
-/** Matched market reference returned by batch/aggregate endpoints. */
-interface VenueMarketRef {
-  venue: string;
-  venueMarketId: string;
+interface WsArbFeedBatch {
+  type: "arb_feed_batch";
+  feed: "arb";
+  /** Producer assertion that globally inactive venues were excluded. */
+  activeVenuesOnly: true;
+  entries: WsArbFeedEntry[];
+  flushTs: number;
+  chunk: number;
+  chunkCount: number;
 }
-type OrderbookBatchItemStatus = "ok" | "market_not_found" | "market_resolved" | "market_closed" | "market_paused" | "market_unopened" | "book_not_loaded";
-type OrderbookBatchItemErrorCode = "market_not_found" | "market_resolved" | "market_closed" | "market_paused" | "market_unopened" | "book_not_loaded";
-interface OrderbookBatchItemError {
-  code: OrderbookBatchItemErrorCode;
-  message: string;
-  retryable: boolean;
+/**
+ * Catalog feed item: one event or market with its current state. The same
+ * shape is served by `GET /catalog/changes` and pushed as a `catalog_change`
+ * frame on the `catalog` channel.
+ *
+ * Items are state, not history: apply one when its (version, changedAt) is
+ * newer than what you hold for (entity, id). `AggClient.watchCatalog` does
+ * this for you.
+ */
+type CatalogEntity = "event" | "market";
+type CatalogChangeOp = "created" | "updated" | "deleted";
+interface CatalogCategoryRef {
+  id: string;
+  name: string;
 }
-interface OrderbooksOnlyError {
-  code: "use_orderbooks_endpoint";
-  message: string;
-  retryable: boolean;
+interface CatalogOutcomeRef {
+  /** venueMarketOutcomeId — subscribe to `orderbook`/`trades` with it. */
+  id: string;
+  label: string;
+  title: string | null;
 }
-interface OrderbookServiceUnavailableError {
-  code: "orderbook_service_unavailable";
-  message: string;
-  retryable: boolean;
+/** Where an entity sits in its cross-venue matched cluster. */
+interface CatalogClusterFields {
+  /** Matched or verified to at least one other venue. */
+  matched: boolean;
+  /**
+   * The cluster's anchor id (event id for events, market id for markets).
+   * Equals `id` for the anchor, null when unmatched. Anchors can change —
+   * key your storage on `id`.
+   */
+  clusterAnchorId: string | null;
+  /** Venues in the matched cluster; just this entity's venue when unmatched. */
+  clusterVenues: string[];
 }
-interface RequestedOrderbookMarket {
-  venueMarketId: string;
+interface CatalogEventSnapshot extends CatalogClusterFields {
+  id: string;
   venue: string;
-  marketStatus: "open" | "closed" | "resolved" | "unopened" | "paused";
-  tickSize: number | null;
-  /** Limit-order size step on this venue, raw 6-dec shares ("10000" = 0.01).
-   *  Absent means a 1-unit step. */
-  sizeStepRaw?: string;
-  /** Smallest limit-order size on this market, raw 6-dec shares.
-   *  Absent means no known minimum. */
-  minSizeRaw?: string;
+  externalIdentifier: string;
+  title: string;
+  slug: string | null;
+  status: string;
+  startDate: string;
   endDate: string | null;
-  resolutionDate: string | null;
+  createdAt: string;
+  categories: CatalogCategoryRef[];
 }
-interface MatchedOrderbookMarket extends VenueMarketRef {
-  marketStatus: "open" | "closed" | "resolved" | "unopened" | "paused";
-  tickSize: number | null;
-  /** Limit-order size step on this venue, raw 6-dec shares ("10000" = 0.01).
-   *  Absent means a 1-unit step. */
-  sizeStepRaw?: string;
-  /** Smallest limit-order size on this market, raw 6-dec shares.
-   *  Absent means no known minimum. */
-  minSizeRaw?: string;
-  hasOrderbook: boolean;
-  /**
-   * Hyperliquid HIP-4 deployer namespace this member belongs to (e.g. "ap").
-   * `null` for every other venue and for Hyperliquid members without one.
-   * Names which deployer this cluster member is — distinct from whether its
-   * book was published (see `hasOrderbook`).
-   */
-  deployerVenue?: string | null;
+interface CatalogMarketSnapshot extends CatalogClusterFields {
+  id: string;
+  venueEventId: string;
+  venue: string;
+  externalIdentifier: string;
+  question: string;
+  shortTitle: string | null;
+  status: string;
+  startDate: string;
+  endDate: string | null;
+  createdAt: string;
+  outcomes: CatalogOutcomeRef[];
+  /** The parent event's categories. */
+  categories: CatalogCategoryRef[];
 }
+interface CatalogChange {
+  entity: CatalogEntity;
+  id: string;
+  op: CatalogChangeOp;
+  /** Structural version of this entity; increases on every structural write. */
+  version: number;
+  /** When the latest structural change touching this entity was recorded (ISO). */
+  changedAt: string;
+  /** Null only on `deleted`, when the row is already gone. */
+  venue: string | null;
+  /** Set when `entity` is "event" and `op` is not "deleted". */
+  event?: CatalogEventSnapshot;
+  /** Set when `entity` is "market" and `op` is not "deleted". */
+  market?: CatalogMarketSnapshot;
+}
+/** Narrowing for the catalog feed. Deletes pass the venue filter (they carry no venue). */
+interface CatalogFilter {
+  venues?: string[];
+  entities?: CatalogEntity[];
+}
+/** A `catalog` channel frame. Live only — catch up with `GET /catalog/changes`. */
+type WsCatalogChange = CatalogChange & {
+  type: "catalog_change";
+};
+type WsServerMessage = WsOrderbookSnapshot | WsOrderbookDelta | WsTrade | WsSubscribed | WsUnsubscribed | WsConnected | WsAuthenticated | WsHeartbeat | WsMarketResolved | WsError | WsOrderSubmitted | WsBalanceUpdate | WsOrderEvent | WsRedeemEvent | WsWithdrawalLifecycleEvent | WsArbMarketUpdate | WsArbFeedBatch | WsAuthExpiring | WsAuthExpired | WsResumed | WsStreamInterrupted | WsCatalogChange;
 /**
- * Provenance of a published `midpoint`. Mirrors the engine's `MarkSource`.
- *
- *  - `local`            — true two-sided midpoint from the venue's own book
- *  - `local_merged`     — midpoint from the cross-venue merged book
- *  - `local_one_sided`  — only one side present; mark is the live side, NOT a midpoint
- *  - `sibling`          — derived from the complementary outcome (e.g. NO from YES)
- *  - `local_boundary`   — clamped to the [tick, 1-tick] boundary
- *  - `none`             — no mark available
+ * A user event as delivered on the `app-events` channel: the raw server
+ * frame (timestamps in milliseconds, not converted), always with `userId`,
+ * `stream: "app"` and normally an `eventId`.
  */
-type MarkSource$1 = "local" | "local_merged" | "local_one_sided" | "sibling" | "local_boundary" | "none";
-declare const RECURRENCE_CADENCES: readonly ["PT5M", "PT10M", "PT15M", "PT30M", "PT1H", "PT4H", "P1D", "P1W", "P1M", "P1Y"];
-type RecurrenceCadence = (typeof RECURRENCE_CADENCES)[number];
-type RecurrenceFilter = RecurrenceCadence | "null";
-type RecurringCryptoDuration = "PT5M" | "PT15M" | "PT30M" | "PT1H" | "PT4H" | "P1D";
-type RecurringCryptoDurationInput = RecurringCryptoDuration | "5m" | "15m" | "30m" | "1h" | "4h" | "1d";
-type RecurringCryptoSourceConfidence = "verified" | "inferred" | "missing";
-interface ListRecurringCryptoMarketsOptions {
-  assets?: string[];
-  durations?: RecurringCryptoDurationInput[];
-  interval?: RecurringCryptoDurationInput;
-  window?: "current";
-  venues?: Venue[];
-  status?: MarketStatus[];
-  windowStartFrom?: string;
-  windowStartTo?: string;
+type WsAppEvent = ((Omit<WsOrderSubmitted, "timestamp"> & {
+  timestamp: number;
+}) | (Omit<WsBalanceUpdate, "timestamp"> & {
+  timestamp: number;
+}) | WsOrderEvent | (Omit<WsRedeemEvent, "timestamp"> & {
+  timestamp: number | string;
+}) | WsWithdrawalLifecycleEvent) & {
+  userId: string;
+  stream: "app";
+};
+type WsClientMessage = {
+  action: "subscribe";
+  channel: "orderbook" | "trades";
+  outcomeIds: string[];
+} | {
+  action: "unsubscribe";
+  channel: "orderbook" | "trades";
+  outcomeIds: string[];
+} | {
+  action: "resnapshot";
+  channel: "orderbook";
+  outcomeIds: string[];
+} | {
+  action: "subscribe";
+  channel: "arb";
+  marketIds: string[];
+} | {
+  action: "unsubscribe";
+  channel: "arb";
+  marketIds: string[];
+} | {
+  action: "subscribe";
+  channel: "arb-feed";
+} | {
+  action: "unsubscribe";
+  channel: "arb-feed";
+} | {
+  action: "authenticate";
+  token: string;
+  resumeFrom?: string;
+} | {
+  action: "subscribe";
+  channel: "app-events";
+  resumeFrom?: string;
+} | {
+  action: "unsubscribe";
+  channel: "app-events";
+} | {
+  action: "subscribe";
+  channel: "catalog";
+  venues?: string[];
+  entities?: CatalogEntity[];
+  id?: string | number;
+} | {
+  action: "unsubscribe";
+  channel: "catalog";
+  id?: string | number;
+};
+type DiagnosticEvent = {
+  type: "seq_gap";
+  marketId: string;
+  outcomeId: string;
+  expected: number;
+  received: number;
+} | {
+  type: "checksum_mismatch";
+  marketId: string;
+  outcomeId: string;
+  expected: number;
+  computed: number;
+} | {
+  type: "reconnect";
+  attempt: number;
+  delayMs: number;
+} |
+/** The server closed with a configuration error (4001/4003); the SDK does not retry. */
+{
+  type: "connection_rejected";
+  code: number;
+  reason: string;
+} | {
+  type: "stream_interrupted";
+  channels: string[];
+} | {
+  type: "stale_connection";
+  lastMessageAge: number;
+} | {
+  type: "book_watchdog_resync";
+  outcomeId: string;
+  /** null when there is no local book (its snapshot never arrived). */
+  localSeq: number | null;
+  serverSeq: number;
+  action: "resnapshot" | "resubscribe";
+} |
+/** `status` is null when the REST check failed before a response (network error or timeout). */
+{
+  type: "book_watchdog_error";
+  status: number | null;
+};
+type DiagnosticCallback = (event: DiagnosticEvent) => void;
+//#endregion
+//#region src/catalog-feed.d.ts
+/** Recommended REST/WS overlap: re-read this much before the resume point. */
+declare const CATALOG_DEFAULT_OVERLAP_MS = 60000;
+interface GetCatalogChangesParams {
+  /** Start of the walk. Required unless `cursor` is sent; at most 24 hours ago. */
+  since?: string | Date;
+  /** `nextCursor` from the previous page. Takes precedence over `since`. */
   cursor?: string;
+  /** 1–500, default 200. */
   limit?: number;
-  includeOrderbookPrices?: boolean;
-  includeReferencePrices?: boolean;
+  venues?: string[];
+  entities?: CatalogEntity[];
+}
+interface CatalogChangesPage {
+  data: CatalogChange[];
+  /** Always set — pass it back to continue, including after `hasMore` is false. */
+  nextCursor: string;
+  /** More changes are already available. A page may hold fewer than `limit` items while true. */
+  hasMore: boolean;
+}
+/**
+ * `GET /catalog/changes` answers 410 `resync_required` when the position is
+ * older than the 24h retention window: re-list with the list endpoints, then
+ * resume from the time that re-list started.
+ */
+declare function isCatalogResyncRequired(err: unknown): boolean;
+interface WatchCatalogOptions {
+  /** Where to start: changes after this time are delivered (minus `overlapMs`). At most 24h ago. */
+  since: string | Date;
+  venues?: string[];
+  entities?: CatalogEntity[];
   /**
-   * @deprecated Ignored by the API. Recurring windows are listed from AGG's own
-   * market data before they open, so the response is the same either way.
+   * Only deliver matched (cross-venue) entities. An entity already delivered
+   * is still delivered when it leaves its cluster (`matched: false`) or is
+   * deleted, so you can drop it.
    */
-  includeDirectVenueMarkets?: boolean;
-  includeOrderbookDepth?: boolean;
-  orderbookDepth?: number;
-  orderbookDepthAmountUsd?: number;
-}
-interface RecurringCryptoOrderbookDepthLevel {
-  price: number;
-  size: number;
-  notionalUsd: number;
-  cumulativeSize: number;
-  cumulativeNotionalUsd: number;
-  fillSize: number | null;
-  fillNotionalUsd: number | null;
+  matchedOnly?: boolean;
+  /** Re-read this much before the resume point on every catch-up. Default 60s. */
+  overlapMs?: number;
+  /** REST page size (1–500). Server default when omitted. */
+  pageLimit?: number;
+  /** Called once per newer state of an entity, in apply order. */
+  onChange: (change: CatalogChange) => void;
+  /** A catch-up finished and live frames flow directly. */
+  onSynced?: (info: {
+    lastChangedAt: string | undefined;
+  }) => void;
+  /** REST or socket errors (catch-up retries on its own), and throws from `onChange`. */
+  onError?: (err: unknown) => void;
+  /**
+   * The resume point fell out of the 24h window. Catch-up stops until you
+   * re-list and call `handle.resync(startOfReList)`. Falls back to `onError`.
+   */
+  onResyncRequired?: () => void;
+  /**
+   * Share an existing socket. When omitted a dedicated connection is opened
+   * (requires `wsUrl`) and closed by `stop()`.
+   */
+  socket?: AggWebSocket;
+}
+interface CatalogWatchHandle {
+  /** Unsubscribe; closes the socket if the watcher opened it. */
+  stop(): void;
+  /** Latest applied `changedAt` — persist it and pass it as `since` to resume later. */
+  readonly lastChangedAt: string | undefined;
+  /** Resume from `since` after `onResyncRequired`, once you have re-listed. */
+  resync(since: string | Date): void;
+  /** Resolves after the first catch-up completes. */
+  readonly ready: Promise<void>;
 }
-interface RecurringCryptoOrderbookDepthSide {
-  levels: RecurringCryptoOrderbookDepthLevel[];
-  totalSize: number;
-  totalNotionalUsd: number;
-  requestedNotionalUsd: number | null;
-  filledSize: number | null;
-  filledNotionalUsd: number | null;
-  unfilledNotionalUsd: number | null;
-  avgPrice: number | null;
-  worstPrice: number | null;
-  fillsComplete: boolean | null;
-}
-interface RecurringCryptoOutcomeOrderbookDepth {
-  currency: "USD";
-  amountUsd: number | null;
-  buy: RecurringCryptoOrderbookDepthSide;
-  sell: RecurringCryptoOrderbookDepthSide;
+//#endregion
+//#region src/types.d.ts
+/** App-level paper/live mode. An app is one or the other, never both. */
+type AppTradingMode = "live" | "paper";
+interface AppClientConfigResponse {
+  prophetxExecutionMode?: "clearinghouse" | "direct";
+  novigExecutionMode?: "clearinghouse" | "direct";
+  disabledVenues: Venue[];
+  disabledCategoryPresets: string[];
+  earlyAccessEnabled: boolean;
+  authOptions: AppClientAuthOption[];
+  /**
+   * Server-owned execution mode. Prefer this over any locally-configured
+   * `trading.executionMode` — the API enforces it regardless of what the
+   * client sends, and end users cannot change it.
+   */
+  tradingMode: AppTradingMode;
+  /**
+   * One-time simulated balance granted on first paper use, in dollars.
+   * Interpolate this into paper copy rather than hardcoding a figure.
+   */
+  paperStartingBalance: number;
 }
-interface RecurringCryptoOutcome {
+interface VenueGeoPolicyEntry {
+  venue: Venue;
+  /** ISO 3166-1 alpha-2, upper-case. Empty means no country restriction. */
+  blockedCountries: string[];
   /**
-   * Canonical Agg outcome id. Null for direct live venue rows because those
-   * rows are discovery data and cannot be passed to smart order routing.
+   * ISO 3166-1 alpha-2, upper-case. When present, this venue is ALLOWLIST
+   * mode: ONLY these countries are permitted (`blockedCountries` is always
+   * `[]` alongside this and must be ignored). Absent/undefined ⇒ ordinary
+   * denylist mode, use `blockedCountries` as before. Only Novig uses this
+   * today — a client that reads only `blockedCountries` sees an allowlisted
+   * venue as unrestricted, which is exactly the misread this field closes.
    */
-  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$1 | string | null;
-  lastKnownPrice: number | null;
-  orderbookDepth: RecurringCryptoOutcomeOrderbookDepth | null;
+  allowedCountries?: string[];
 }
-interface RecurringCryptoMarketMetrics {
-  volume: number | null;
-  volume24h: number | null;
-  openInterest: number | null;
-  liquidity: number | null;
-  spread: number | null;
+interface VenueGeoPolicyResponse {
+  venues: VenueGeoPolicyEntry[];
 }
-interface RecurringCryptoResolution {
-  sourceName: string | null;
-  sourceUrl: string | null;
-  sourceDomain: string | null;
-  rawCriteria: unknown;
-  confidence: RecurringCryptoSourceConfidence;
+interface RpcTokenResponse {
+  token: string;
+  expiresAt: number;
 }
-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 AggAuthProviderType = "siwe" | "siws" | "google" | "twitter" | "apple" | "email";
+interface AppClientAuthOption {
+  provider: AggAuthProviderType;
+  type: "oauth" | "email" | "wallet";
+  enabled: boolean;
+  callbackUrl?: string;
+  statement?: string;
 }
-type CryptoReferencePriceTarget = {
-  type: "venueMarket";
-  venueMarketId: string;
-} | {
-  type: "venueEvent";
-  venueEventId: string;
-} | {
-  type: "externalVenueMarket";
-  venue: Venue;
-  externalMarketId: string;
+type AggAuthDeliveryMode = "body" | "cookie-refresh";
+interface AggClientAuthOptions {
+  getEarlyAccessCode?: () => string | null;
+}
+type AggAuthStartBody = {
+  provider: Exclude<AggAuthProviderType, "email">;
+  redirectUrl?: string;
+  /** Cloudflare Turnstile token — required when a prior authStart returned `challenge_required`. */
+  turnstileToken?: string;
+  earlyAccessCode?: string;
 } | {
-  type: "market";
-  venue: Venue;
-  venueEventId?: string;
-  venueMarketId: string;
-  externalEventId?: string | null;
-  externalMarketId?: string;
-  asset: string;
-  quoteAsset?: "USD";
-  resolution: RecurringCryptoResolution;
+  provider: "email";
+  email: string;
+  redirectUrl?: string;
+  /** Cloudflare Turnstile token — required when a prior authStart returned `challenge_required`. */
+  turnstileToken?: string;
+  earlyAccessCode?: string;
 };
-interface CryptoReferencePriceExternalMarketInput {
-  venue: Venue;
-  externalMarketId: string;
-}
-interface CryptoReferencePriceMarketInput extends RecurringCryptoVenueMarket {
-  asset: string;
-  quoteAsset?: "USD";
+/** SIWE / SIWS sign-in. `kind` is optional so callers that predate the discriminator still compile. */
+interface AggAuthWalletVerifyBody {
+  kind?: "wallet";
+  message: string;
+  signature: string;
+  earlyAccessCode?: string;
 }
-interface GetCryptoReferencePricesOptions {
-  targets?: CryptoReferencePriceTarget[];
-  venueMarketIds?: string[];
-  venueEventIds?: string[];
-  externalMarkets?: CryptoReferencePriceExternalMarketInput[];
-  markets?: CryptoReferencePriceMarketInput[];
-  windowMarkets?: RecurringCryptoWindowMarket[];
-  signal?: AbortSignal;
+/** Privy sign-in. Requires the app's wallet provider to be Privy; the token must come from that Privy app. */
+interface AggAuthPrivyVerifyBody {
+  kind: "privy";
+  privyToken: string;
+  earlyAccessCode?: string;
 }
-interface CryptoReferencePriceError {
-  code: "not_found" | "not_recurring_crypto" | "reference_feed_missing" | "price_unavailable" | "stale_price";
+/** Body for `POST /auth/verify` — mirrors the API's union on `kind`. */
+type AggAuthVerifyBody = AggAuthWalletVerifyBody | AggAuthPrivyVerifyBody;
+type AggAuthStartResult = {
+  type: "nonce";
+  nonce: string;
+  statement?: string;
+} | {
+  type: "redirect";
+  url: string;
+} | {
+  type: "magic_link";
+  success: true;
+} | {
+  type: "challenge_required";
+  siteKey: string;
+};
+/**
+ * Body for `POST /users/me/link-account/start` — authenticated account linking.
+ *
+ * `redirectUrl` is required for OAuth/email providers: the callback / magic-link
+ * verify hands the partner a `link_confirm_token` by redirecting to `redirectUrl`,
+ * and the partner app completes the flow by calling `/confirm` from that page.
+ *
+ * Wallet providers (`siwe`/`siws`) instead return a `wallet_challenge` with a
+ * `message` the user signs VERBATIM; the signature is then confirmed with
+ * `{ kind: "wallet_signature", message, signature }`.
+ */
+type AggLinkAccountBody = {
+  provider: "google" | "twitter" | "apple";
+  redirectUrl: string;
+} | {
+  provider: "email";
+  email: string;
+  redirectUrl: string;
+} | {
+  provider: "siwe" | "siws";
+  address: string;
+};
+type AggLinkAccountResult = {
+  type: "redirect";
+  url: string;
+} | {
+  type: "magic_link";
+  success: true;
+} | {
+  type: "wallet_challenge";
+  message: string;
+};
+/**
+ * Wallet branch of `POST /users/me/link-account/confirm`. Requires `kind` so it
+ * can never be confused with the `token` branch. `message` MUST be the exact
+ * `message` returned by `/start`'s `wallet_challenge` — the server compares it
+ * byte-for-byte, so do not reconstruct or edit it client-side.
+ */
+type AggLinkAccountWalletConfirmBody = {
+  kind: "wallet_signature";
   message: string;
+  signature: string;
+};
+/**
+ * Success result of /users/me/link-account/confirm.
+ * - `linked` — new Account row written.
+ * - `already_linked_same` — identity was already attached to the caller's Principal
+ *   (idempotent; safe to retry).
+ *
+ * Collisions with a different Principal surface as HTTP 409 and are thrown by the
+ * SDK's request layer — catch them at the call site, don't expect them here.
+ */
+type AggLinkAccountConfirmResult = {
+  status: "linked" | "already_linked_same";
+  provider: string;
+};
+type AggSessionUser = AuthUser | UserProfile;
+interface AggClientSessionInput {
+  accessToken: string;
+  refreshToken?: string;
+  user?: AggSessionUser;
 }
-interface CryptoReferencePriceSource {
-  provider: string | null;
-  providerMarketId: string | null;
-  confidence: RecurringCryptoSourceConfidence;
+/** Non-sensitive auth snapshot persisted to localStorage for UI bootstrapping.
+ *  Tokens are NEVER included — they exist only in process memory. */
+interface PersistedAuthSnapshot {
+  user: {
+    id: string;
+    username: string | null;
+    avatarUrl: string | null;
+    walletAddress?: string | null;
+  } | null;
+  authHint: {
+    wasAuthenticated: boolean;
+  };
 }
-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;
-  };
+/** Auth lifecycle status for UI state machines. */
+type AuthStatus = "unknown" | "authenticated" | "unauthenticated";
+type SignatureRequestType = "eip712" | "personal_sign" |
+/** EVM transaction — bridge legs and approvals. secp256k1. */
+"transaction" |
+/** Solana transaction — bridge legs on SVM. ed25519, NOT secp256k1. */
+"solana_transaction" | "hl_l1_action" |
+/**
+ * EIP-7702 authorization over `{ contractAddress, chainId, nonce }`.
+ *
+ * A signature over a RAW digest — `keccak(0x05 ‖ rlp([chainId, delegate,
+ * nonce]))` — not EIP-191 and not EIP-712. Many wallets do not expose this,
+ * and that is expected: reject it and the server falls back to asking the
+ * user to broadcast a plain approve instead.
+ */
+"eip7702_authorization" |
+/**
+ * A Gnosis Safe transaction relayed through Polymarket — a legacy Polymarket
+ * wallet funding a fill. The payload is the SafeTx as EIP-712 typed data,
+ * but the wallet must `personal_sign` the RAW 32 bytes of
+ * `hashTypedData(payload)` (`signMessage({ message: { raw: hash } })`):
+ * Polymarket's relayer only accepts that shape. `payload.safeTxHash` carries
+ * the digest for convenience; the server recomputes it from the typed data.
+ */
+"safe_tx";
+/** One payload the client must sign before a fill can proceed. */
+interface SignatureRequest {
+  /** Echo this back with the signature. */
+  stepId: string;
+  /** Payload shape. Discriminates how to sign — not which venue. */
+  type: SignatureRequestType;
+  venue: string;
+  /** The address that must produce this signature. Sign with this key, not another. */
+  signerAddress: string;
+  /** Absent for non-EVM payloads (e.g. Hyperliquid L1 actions). */
+  chainId?: number;
+  /** Sign verbatim. */
+  payload: unknown;
+  expiresAt: string;
+  /** Why this signature is being asked for, when the server knows (e.g. `"fee"`, `"funding_and_fee"`). Display only. */
+  purpose?: string;
+  /**
+   * The fill proceeds without this one (e.g. `purpose: "hl_referral"`, a
+   * partner referral parked beside a Hyperliquid order). `fillSelfCustody`
+   * skips it if your signer throws or it has expired, instead of failing the
+   * fill.
+   */
+  optional?: boolean;
 }
-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;
+/**
+ * Supplied by the partner. Receives a payload, returns a signature. The SDK
+ * never sees the key.
+ *
+ * Return a 0x-prefixed hex string for anything the wallet SIGNS:
+ *
+ * - `eip712` — `signTypedData` over `payload`.
+ * - `personal_sign` — EIP-191 over `payload`: a UTF-8 string or `{ raw: "0x…" }
+ *   bytes (Polymarket proxy batches). Pass it directly as viem `message`.
+ * - `safe_tx` — `personal_sign` over the RAW 32 bytes of
+ *   `hashTypedData(payload)` (viem: `signMessage({ message: { raw: hash } })`,
+ *   MetaMask: `personal_sign` with the hex hash). The wallet shows a hash, not
+ *   a structured prompt — that is what Polymarket's own relayer requires.
+ * - `hl_l1_action` — Hyperliquid L1 action, EIP-712 in phantom-agent form.
+ * - `eip7702_authorization` — an EIP-7702 authorization over
+ *   `{ contractAddress, chainId, nonce }`. This is a signature over a RAW
+ *   digest, not EIP-191 and not EIP-712, and many wallets do not expose it.
+ *   **Throwing here does not help**: there is no reject verb, so a thrown
+ *   signer is indistinguishable from a slow user — the request simply expires
+ *   and the fill dies. If your wallet cannot produce this signature, declare
+ *   `approveMode: "user_broadcast"` on the fill instead and the approve is
+ *   requested as a `transaction` the user sends themselves. Handling this
+ *   request is what makes funding gasless.
+ * - `solana_transaction` — `payload.messageBase64` is the serialized Solana
+ *   transaction MESSAGE; `payload.transactionBase64` is the full unsigned
+ *   `VersionedTransaction` for wallets that need one to display/simulate.
+ *   Return `0x` + 128 hex chars: the 64-byte ed25519 signature over the
+ *   decoded message. With a wallet adapter: `const signed = await
+ *   wallet.signTransaction(VersionedTransaction.deserialize(base64decode(transactionBase64)))`
+ *   then return the signature at the index of `signerAddress` in
+ *   `signed.message.staticAccountKeys`, hex-encoded. Do NOT send it — the
+ *   server co-signs as fee payer and broadcasts. The user needs no SOL.
+ *   The signature MUST be over the UNMODIFIED message: the server verifies
+ *   it against the bytes it persisted, so a wallet that inserts
+ *   instructions before signing (priority fee, guards, Lighthouse) gets a
+ *   400 — disable such features for this request or sign the raw message.
+ *
+ * Return `{ txHash }` for anything the wallet BROADCASTS:
+ *
+ * - `transaction` — send it, then return the hash **immediately, without
+ *   awaiting the receipt**. The server watches for the mined receipt itself
+ *   and will not resume until it matches the request byte-for-byte.
+ */
+type SignerFn = (req: SignatureRequest) => Promise<string | {
+  txHash: string;
+}>;
+/**
+ * How long `fillSelfCustody` will keep waiting before giving up.
+ *
+ * Covers a first-time user: sign the wallet-setup batch, wait for it on-chain,
+ * then sign the order. Generous because the wait is a relayer transaction
+ * confirming, not a human deciding.
+ */
+declare const SELF_CUSTODY_FILL_TIMEOUT_MS: number;
+/** Gap between re-reads while an on-chain step is in flight. */
+declare const SELF_CUSTODY_POLL_INTERVAL_MS = 2000;
+/**
+ * How long `fillSelfCustody` waits on the `signer` for ONE optional request
+ * signed by a wallet other than the user's — e.g. a partner's activation
+ * sponsor. Such a request can delay the batch's submission by at most this long,
+ * after which it is declined and the required signatures go out without it.
+ * Required requests, and optional ones the user's own wallet signs (the fill's
+ * `signingAddress` or any required request's `signerAddress`, e.g. a referral
+ * code), are never bounded by this.
+ */
+declare const OPTIONAL_SIGNATURE_TIMEOUT_MS = 15000;
+/**
+ * How long `fillSelfCustody` waits on an optional Polymarket buy fee pre-sign
+ * (`purpose: "app_fee"`). It never holds the order (that round is already
+ * posted), so it can wait for a slow wallet: just under the server's 60s grace,
+ * after which the request is expired and a post-fill signature asked instead.
+ */
+declare const OPTIONAL_FEE_SIGNATURE_TIMEOUT_MS = 55000;
+/**
+ * States a run never leaves. Everything else means "still working".
+ *
+ * Typed against `ExecutionOverallState` so a typo'd or renamed literal (e.g.
+ * `cancelled` drifting to `canceled`) is a compile error instead of a state
+ * that silently stops being treated as terminal. Mirrors
+ * `ExecutionOverallStateTB` in the contract; keep the two in step.
+ */
+declare const TERMINAL_EXECUTION_STATES: ReadonlySet<ExecutionOverallState>;
+type SportsGameStatus = "scheduled" | "live" | "paused" | "finished" | "cancelled" | "postponed" | "unknown";
+interface SportsLiveParticipant {
+  position: "first" | "second";
+  name: string;
+  shortName: string | null;
+  imageUrl: string | null;
+  score: string | null;
 }
-interface RecurringCryptoWindowMarket {
-  id: string;
-  asset: string;
-  quoteAsset: "USD";
-  duration: RecurringCryptoDuration;
-  windowStart: string;
-  windowEnd: string;
-  status: MarketStatus;
-  markets: RecurringCryptoVenueMarket[];
-  comparisons: RecurringCryptoWindowComparisons;
+interface SportsLiveState {
+  eventId: string;
+  sport: string;
+  status: SportsGameStatus;
+  participants: [SportsLiveParticipant, SportsLiveParticipant];
+  period: string | null;
+  clock: string | null;
+  updatedAt: string | null;
 }
-interface RecurringCryptoMarketsResponse {
-  data: RecurringCryptoWindowMarket[];
-  nextCursor: string | null;
-  hasMore: boolean;
+interface SportsLiveResponse {
+  data: SportsLiveState[];
+  missingEventIds: string[];
 }
-/** Per-venue orderbook entry with native tick spacing. */
-interface VenueOrderbookEntry {
-  venueMarketId: string;
-  tickSize: number | null;
-  /** Limit-order size step on this venue, raw 6-dec shares ("10000" = 0.01).
-   *  Absent means a 1-unit step. */
-  sizeStepRaw?: string;
-  /** Smallest limit-order size on this market, raw 6-dec shares.
-   *  Absent means no known minimum. */
-  minSizeRaw?: string;
-  orderbook: Orderbook;
+interface AggClientOptions {
+  /** Browser adapters can inject a Worker transport; other runtimes keep the native client. */
+  webSocketFactory?: (options: AggWebSocketOptions) => AggWebSocket;
+  baseUrl: string;
+  /** Public App ID — sent as x-app-id header. For client-side partner usage. */
+  appId?: string;
+  /** Secret admin key — sent as x-admin-key header. Server-side only. */
+  adminKey?: string;
   /**
-   * Sticky tick of this venue's book inferred at runtime by the engine. May
-   * differ from the seed `tickSize` when the live grid is finer than the DB
-   * metadata. Optional — only populated when the engine has emitted runtime
-   * metadata for this entry.
+   * Partner API key for server-side use. Sent as `x-app-api-key`. NEVER embed
+   * in browser bundles, source maps, or logs. Keys start with `agg_<appId>_`.
    */
-  tick?: number | null;
-  /** Provenance of this venue book's published midpoint. See {@link MarkSource}. */
-  markSource?: MarkSource$1;
+  apiKey?: string;
+  /** WebSocket URL for real-time feeds. Must be set explicitly to use createWebSocket(). */
+  wsUrl?: string;
+  /** Opt in after immutable history publication/CDN rollout. Defaults false. */
+  preferImmutableHistory?: boolean;
   /**
-   * Hyperliquid HIP-4 deployer namespace whose book this entry publishes
-   * (e.g. "ap"). `null` for every other venue. When a cluster has more than
-   * one Hyperliquid deployer member, only one member's book is published per
-   * request — this names which one, so a caller never pairs this entry's depth
-   * with a different member's `venueMarketId`.
+   * @deprecated Kalshi live discovery and trading are retired. This ignored
+   * compatibility option remains to avoid breaking existing SDK consumers.
    */
-  deployerVenue?: string | null;
+  kalshiDemo?: boolean;
+  /** Optional auth request hooks used to enrich auth payloads. */
+  auth?: AggClientAuthOptions;
+  /** Move refresh delivery to an HttpOnly cookie on auth endpoints. Defaults to "body". */
+  authDelivery?: AggAuthDeliveryMode;
+  /** Persist a non-sensitive auth hint to localStorage for UI bootstrapping.
+   *  Tokens are NEVER persisted — they exist only in process memory.
+   *  When authDelivery is "body", refresh tokens are lost on page reload.
+   *  When authDelivery is "cookie-refresh", refresh tokens survive via HttpOnly cookies
+   *  and the SDK attempts a silent refresh on cold start. Defaults to true. */
+  persistSession?: boolean;
+  /**
+   * Supplies signatures for self-custodial fills. Required whenever
+   * `fillSelfCustody()` is called with `signingAddress` — the SDK never
+   * holds a key itself, so without this option a fill that needs a
+   * client-side signature cannot proceed. The signature requests never
+   * come back on `POST /execution/fill` itself: `fillSelfCustody()` polls
+   * `GET /execution/status` for them (`pendingSignatures`), signs each one
+   * with this function, and posts the result to
+   * `POST /execution/fill/:quoteId/signatures`.
+   */
+  signer?: SignerFn;
 }
-/** Response from GET /orderbooks (batch). */
-interface BatchOrderbooksResponse {
-  data: Array<{
-    venueMarketId: string;
-    status: OrderbookBatchItemStatus;
-    error: OrderbookBatchItemError | null;
-    requestedMarket: RequestedOrderbookMarket | null;
-    venueOrderbooks: Record<string, VenueOrderbookEntry>;
-    matchedMarkets: MatchedOrderbookMarket[];
-  }>;
-  meta: {
-    requestedCount: number;
-    okCount: number;
-    errorCount: number;
-  };
+interface SiweMessageParams {
+  domain: string;
+  address: string;
+  uri: string;
+  nonce: string;
+  chainId?: number;
+  statement?: string;
+  issuedAt?: string;
 }
-/** A single market midpoint row returned by GET /midpoints. */
-interface MidpointRow {
-  venueMarketId: string;
+interface SiwsMessageParams {
+  domain: string;
+  /** Base58-encoded Solana public key. */
+  address: string;
+  uri: string;
+  nonce: string;
+  /** Solana chain ID: "mainnet", "devnet", "testnet", or "localnet". Defaults to "mainnet". */
+  chainId?: string;
+  statement?: string;
+  issuedAt?: string;
+}
+/** OHLCV bar point for chart rendering. */
+interface ChartCandle {
+  /** Venue average; distinct from OHLC close. */
+  mean?: number;
+  /** Open time in Unix milliseconds. */
+  t: number;
+  /** Open price (0-1). */
+  o: number;
+  /** High price (0-1). */
+  h: number;
+  /** Low price (0-1). */
+  l: number;
+  /** Close price (0-1). */
+  c: number;
+  /** Volume (null if unavailable). */
+  v: number | null;
+}
+/** @deprecated Historical chart bars are canonical per outcome. Use ChartBarsResponse instead. */
+interface ChartVenueCandles {
   venue: string;
-  midpoint: number | null;
-  spread: number | null;
-  timestamp: number | null;
-  arbReturn?: number | null;
-  /** Provenance of `midpoint`. */
-  markSource?: MarkSource$1;
-  /**
-   * When `markSource === "sibling"`, the matched venueMarketId whose book
-   * supplied the headline mark. Allows the FE to label "sourced from venue X"
-   * 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;
+  candles: ChartCandle[];
 }
-/** Per-outcome midpoint from a live orderbook. */
-interface OutcomeMidpointRow {
+type ChartResolution = "1m" | "5m" | "1h" | "1d";
+/**
+ * Freshness signal embedded in every chart response. Compare
+ * `staleSeconds` against the resolution to decide whether to show a
+ * "delayed" badge on the chart.
+ */
+interface ChartBarsMeta {
+  state?: "ready" | "warming" | "unsupported" | "failed" | "empty";
+  complete?: boolean;
+  retryAfterMs?: number;
+  /** Agg fetch/publication time. Does not measure upstream delivery latency. */
+  fetchedAtMs?: number;
+  /** Server-side wall clock when the response was assembled, in milliseconds. */
+  serverTime: number;
+  /** `open_time` of the most-recent bar in `data`, in milliseconds. Null if `data` is empty. */
+  lastBarOpenTime: number | null;
+  /** `serverTime - lastBarOpenTime` in seconds. Null if `data` is empty. */
+  staleSeconds: number | null;
+}
+/** Response from GET /charts/bars. */
+interface ChartBarsResponse {
+  /** VenueMarketOutcome.id requested by the caller. */
   venueMarketOutcomeId: string;
-  label: string;
-  midpoint: number | null;
-  /** Provenance of `midpoint`. */
-  markSource?: MarkSource$1;
-  /** 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;
+  /** Venue of the canonical historical series. */
+  venue: string;
+  /** Resolution returned by the backend. */
+  resolution: ChartResolution;
+  /** Bars sorted in ascending open time. */
+  data: ChartCandle[];
+  /** Freshness signal — see {@link ChartBarsMeta}. */
+  meta: ChartBarsMeta;
 }
-/** 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;
-    };
+interface ChartHistoryManifest {
+  version: 1;
+  revision: string | null;
+  venueMarketOutcomeId: string;
+  venue: string;
+  resolution: ChartResolution;
+  semantics: "venue-ohlcv-v1" | "polymarket-price-samples-v1" | "kalshi-ohlcv-quote-fallback-v2";
+  from: number;
+  to: number;
+  finalizedThrough: number;
+  chunks: Array<{
+    key: string;
+    url: string;
+    sha256: string;
+    from: number;
+    to: number;
+    points: number;
   }>;
+  meta: ChartBarsMeta;
 }
-/** Response from GET /orderbook/outcome/:id (single outcome). */
-interface OutcomeOrderbookResponse {
-  /** CRC of returned depth-limited levels; full engine checksum remains unchanged. */
-  snapshotChecksum?: number;
-  venueMarketOutcomeId: string;
-  venueMarketId: string;
+/** Matched market reference returned by batch/aggregate endpoints. */
+interface VenueMarketRef {
   venue: string;
-  orderbook: {
-    bids: Array<{
-      price: number;
-      size: number;
-    }>;
-    asks: Array<{
-      price: number;
-      size: number;
-    }>;
-  };
-  midpoint: number | null;
-  spread: number | null;
-  seq: number;
-  checksum: number;
-  timestamp: number;
-  /** Sticky tick of this outcome's book, inferred at runtime. `null` until inferred. */
-  tick: number | null;
-  /** Provenance of `midpoint`. See {@link MarkSource}. */
-  markSource: MarkSource$1;
+  venueMarketId: string;
 }
-/** Standard paginated list response from the API. */
-interface PaginatedResponse<T> {
-  data: T[];
-  nextCursor: string | null;
-  hasMore: boolean;
+type OrderbookBatchItemStatus = "ok" | "market_not_found" | "market_resolved" | "market_closed" | "market_paused" | "market_unopened" | "book_not_loaded";
+type OrderbookBatchItemErrorCode = "market_not_found" | "market_resolved" | "market_closed" | "market_paused" | "market_unopened" | "book_not_loaded";
+interface OrderbookBatchItemError {
+  code: OrderbookBatchItemErrorCode;
+  message: string;
+  retryable: boolean;
 }
-interface OrderListQuery {
-  userId?: string;
-  status?: string;
-  limit?: number;
-  offset?: number;
+interface OrderbooksOnlyError {
+  code: "use_orderbooks_endpoint";
+  message: string;
+  retryable: boolean;
 }
-interface TradeExecutorOrder {
-  id: string;
-  userId: string;
+interface OrderbookServiceUnavailableError {
+  code: "orderbook_service_unavailable";
+  message: string;
+  retryable: boolean;
+}
+interface RequestedOrderbookMarket {
+  venueMarketId: string;
   venue: string;
-  status: string;
-  marketId: string;
-  tokenId: string;
-  side: string;
-  amountRaw: string;
-  quoteId: string | null;
-  externalId: string | null;
-  clientOrderId: string | null;
-  dagRunId: string | null;
-  filledAmountRaw: string | null;
-  executionPrice: string | null;
-  txHash: string | null;
-  errorMessage: string | null;
-  createdAt: string;
-  updatedAt: string;
+  marketStatus: "open" | "closed" | "resolved" | "unopened" | "paused";
+  tickSize: number | null;
+  /** Limit-order size step on this venue, raw 6-dec shares ("10000" = 0.01).
+   *  Absent means a 1-unit step. */
+  sizeStepRaw?: string;
+  /** Smallest limit-order size on this market, raw 6-dec shares.
+   *  Absent means no known minimum. */
+  minSizeRaw?: string;
+  endDate: string | null;
+  resolutionDate: string | null;
 }
-interface TradeExecutorOrderListResponse {
-  orders: TradeExecutorOrder[];
-  total: number;
+interface MatchedOrderbookMarket extends VenueMarketRef {
+  marketStatus: "open" | "closed" | "resolved" | "unopened" | "paused";
+  tickSize: number | null;
+  /** Limit-order size step on this venue, raw 6-dec shares ("10000" = 0.01).
+   *  Absent means a 1-unit step. */
+  sizeStepRaw?: string;
+  /** Smallest limit-order size on this market, raw 6-dec shares.
+   *  Absent means no known minimum. */
+  minSizeRaw?: string;
+  hasOrderbook: boolean;
+  /**
+   * Hyperliquid HIP-4 deployer namespace this member belongs to (e.g. "ap").
+   * `null` for every other venue and for Hyperliquid members without one.
+   * Names which deployer this cluster member is — distinct from whether its
+   * book was published (see `hasOrderbook`).
+   */
+  deployerVenue?: string | null;
 }
-/** A single level in the aggregated orderbook with per-venue attribution. */
-interface AggregatedOrderbookLevel {
-  price: number;
-  size: number;
-  venues: Record<string, number>;
+/**
+ * Provenance of a published `midpoint`. Mirrors the engine's `MarkSource`.
+ *
+ *  - `local`            — true two-sided midpoint from the venue's own book
+ *  - `local_merged`     — midpoint from the cross-venue merged book
+ *  - `local_one_sided`  — only one side present; mark is the live side, NOT a midpoint
+ *  - `sibling`          — derived from the complementary outcome (e.g. NO from YES)
+ *  - `local_boundary`   — clamped to the [tick, 1-tick] boundary
+ *  - `none`             — no mark available
+ */
+type MarkSource = "local" | "local_merged" | "local_one_sided" | "sibling" | "local_boundary" | "none";
+declare const RECURRENCE_CADENCES: readonly ["PT5M", "PT10M", "PT15M", "PT30M", "PT1H", "PT4H", "P1D", "P1W", "P1M", "P1Y"];
+type RecurrenceCadence = (typeof RECURRENCE_CADENCES)[number];
+type RecurrenceFilter = RecurrenceCadence | "null";
+type RecurringCryptoDuration = "PT5M" | "PT15M" | "PT30M" | "PT1H" | "PT4H" | "P1D";
+type RecurringCryptoDurationInput = RecurringCryptoDuration | "5m" | "15m" | "30m" | "1h" | "4h" | "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;
+  /**
+   * @deprecated Ignored by the API. Recurring windows are listed from AGG's own
+   * market data before they open, so the response is the same either way.
+   */
+  includeDirectVenueMarkets?: boolean;
+  includeOrderbookDepth?: boolean;
+  orderbookDepth?: number;
+  orderbookDepthAmountUsd?: number;
 }
-/** A simple orderbook level without venue attribution. */
-interface SimpleOrderbookLevel {
+interface RecurringCryptoOrderbookDepthLevel {
   price: number;
   size: number;
+  notionalUsd: number;
+  cumulativeSize: number;
+  cumulativeNotionalUsd: number;
+  fillSize: number | null;
+  fillNotionalUsd: number | null;
 }
-/** Per-venue best-bid/ask info. */
-interface VenuePriceInfo {
+interface RecurringCryptoOrderbookDepthSide {
+  levels: RecurringCryptoOrderbookDepthLevel[];
+  totalSize: number;
+  totalNotionalUsd: number;
+  requestedNotionalUsd: number | null;
+  filledSize: number | null;
+  filledNotionalUsd: number | null;
+  unfilledNotionalUsd: number | null;
+  avgPrice: number | null;
+  worstPrice: number | null;
+  fillsComplete: boolean | null;
+}
+interface RecurringCryptoOutcomeOrderbookDepth {
+  currency: "USD";
+  amountUsd: number | null;
+  buy: RecurringCryptoOrderbookDepthSide;
+  sell: RecurringCryptoOrderbookDepthSide;
+}
+interface RecurringCryptoOutcome {
+  /**
+   * 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;
+  orderbookDepth: RecurringCryptoOutcomeOrderbookDepth | null;
 }
-/** Response from GET /orderbook/:venueMarketId — canonical aggregated orderbook. */
-interface AggregatedOrderbookResponse {
-  venueMarketId: string;
-  orderbook: {
-    bids: AggregatedOrderbookLevel[];
-    asks: AggregatedOrderbookLevel[];
-  };
-  venueOrderbooks: Record<string, {
-    bids: SimpleOrderbookLevel[];
-    asks: SimpleOrderbookLevel[];
-  }>;
-  venues: Record<string, VenuePriceInfo>;
-  midpoint: number | null;
+interface RecurringCryptoMarketMetrics {
+  volume: number | null;
+  volume24h: number | null;
+  openInterest: number | null;
+  liquidity: number | null;
   spread: number | null;
-  timestamp: number;
-  /** Sequence number (present in live responses). */
-  seq?: number;
-  /** CRC32 checksum (present in live responses). */
-  checksum?: number | null;
-  /** Markets matched across venues for this canonical market. */
-  matchedMarkets?: Array<{
-    venue: string;
-    venueMarketId: string;
-  }>;
 }
-interface ExecuteManagedParams {
-  quoteId: string;
-  /**
-   * Optional idempotency key: your own id for this trade, unique within your
-   * app. Saved on every order the quote splits into, so
-   * `getExecutionOrders({ externalId })` returns all legs and each
-   * `trades.filled` webhook carries it. Reusing it on a different quote is
-   * rejected with 409.
-   */
-  externalId?: string;
-  /** Trading mode. Defaults to live. */
-  mode?: ExecutionMode;
-  /**
-   * Optional intent fallback. When the supplied `quoteId` has expired in the
-   * cache (e.g. user clicked Buy after a tab was inactive), the server
-   * resolves the latest quote for this intent and refreshes/executes against
-   * that instead of returning 400 `quote_not_found`. Same intent = same buttons
-   * the user pressed in the UI; a different `maxSpend`, mode, or venue scope is
-   * a different intent and won't match.
-   */
-  fallbackToLatest?: {
-    outcomeId: string;
-    side: "buy" | "sell";
-    maxSpend?: number;
-    sellShares?: number;
-    allowedVenues?: Venue[];
-  };
-  /**
-   * Self-custody: the wallet that will sign this fill. Must be a wallet
-   * already linked to this account. Omit for managed custody (the default).
-   */
-  signingAddress?: string;
-  /**
-   * Self-custody buys only: other wallets linked to this account whose balances
-   * may fund the fill. Must match the set the quote was priced with.
-   */
-  fundingAddresses?: string[];
-  /**
-   * Self-custody only: which approve shape a cross-chain fill uses when the
-   * bridge needs an ERC20 approve. Omit (the default) for "sponsored" — the
-   * approve costs the wallet no gas, but the wallet must sign a one-time
-   * EIP-7702 authorization over a RAW DIGEST, which many wallets cannot
-   * produce. Send "user_broadcast" when yours cannot: the user sends the
-   * approve from their own wallet and pays its gas. Only your client can know
-   * which applies — it is a property of the wallet software, not of the
-   * address or the chain.
-   *
-   * Worth surfacing in your UI: "user_broadcast" never establishes the
-   * delegation, so an approve is needed on EVERY bridge. "sponsored" costs one
-   * signature once per chain.
-   *
-   * Neither mode makes bridging free — the approve is only one of the costs.
-   * Relay's fee comes out of the amount delivered on every bridge, and one-time
-   * costs apply per route. Quote with `deepEstimate` and read
-   * `feeBreakdown.bridgeFees` and `feeBreakdown.setupCosts` rather than
-   * inferring cost from the approve mode.
-   */
-  approveMode?: "sponsored" | "user_broadcast";
+interface RecurringCryptoResolution {
+  sourceName: string | null;
+  sourceUrl: string | null;
+  sourceDomain: string | null;
+  rawCriteria: unknown;
+  confidence: RecurringCryptoSourceConfidence;
 }
-interface ExecuteManagedResponse {
-  alreadyAccepted?: boolean;
-  quoteId: string;
-  orderIds: string[];
-  status: "pending";
-  redeemId?: string;
-  message?: string;
-  /**
-   * What this fill is waiting to be signed, if anything. On the immediate
-   * `POST /execution/fill` response this is always absent or empty — even
-   * for a self-custody fill, the DAG parks asynchronously, after this
-   * response has already been sent. Real entries only ever come back from
-   * polling `GET /execution/status` or from the next
-   * `POST /execution/fill/:quoteId/signatures` response (this same shape,
-   * reused). Drive the whole round trip through `fillSelfCustody()` rather
-   * than reading this field on the fill response by hand.
-   */
-  pendingSignatures?: SignatureRequest[];
+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 LimitOrderTimeInForce = "GTC" | "GTD" | "FOK" | "FAK" | "IOC" | "ALO";
-type CancelOrderSignature = {
-  signature: string;
-  timestamp: number;
+type CryptoReferencePriceTarget = {
+  type: "venueMarket";
+  venueMarketId: string;
 } | {
-  venue: "hyperliquid";
-  action: {
-    type: "cancel";
-    cancels: Array<{
-      a: number;
-      o: number;
-    }>;
-  };
-  nonce: number;
-  signature: {
-    r: string;
-    s: string;
-    v: 27 | 28;
-  };
+  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 CancelVenueOrderParams {
-  venue: "polymarket" | "hyperliquid";
-  venueOrderId: string;
-  signerAddress: string;
-  cancelSignature: CancelOrderSignature;
-}
-interface PlaceLimitOrderParams {
-  /** BETDEX uses hosted cash: GTC/IOC only, no signer, post-only or expiry.
-   * Native odds are rounded conservatively and stake is rounded down. GTC
-   * unmatched liquidity is cancelled at the in-play transition. SELL closes
-   * the same For outcome and requires collateral as well as owned inventory.
-   */
+interface CryptoReferencePriceExternalMarketInput {
   venue: Venue;
-  venueMarketOutcomeId: string;
-  side: "buy" | "sell";
-  limitPriceRaw: string;
-  sizeRaw: string;
-  timeInForce: LimitOrderTimeInForce;
-  postOnly?: boolean;
-  expiresAt?: string;
-  clientOrderId?: string;
-  /** Linked account EOA. Polymarket supports GTC/GTD buys; Hyperliquid supports GTC/ALO buys and sells. Agent keys stay on the client. Omit for managed custody. */
-  signingAddress?: string;
-  /** Same bridge approval mode as market fills; defaults to sponsored. */
-  approveMode?: ExecuteManagedParams["approveMode"];
-  /** Self-custody buys only: other wallets linked to this account whose balances may bridge in to fund the order. Requires signingAddress. */
-  fundingAddresses?: string[];
+  externalMarketId: string;
 }
-interface PlaceLimitOrderResponse {
-  orderId: string;
-  /** Poll getExecutionStatus and answer submitFillSignatures using this ID. */
-  quoteId?: string;
-  status: "pending" | "submitting" | "submitted" | "cancel_pending" | "partial_fill" | "open" | "partially_filled_open" | "filled" | "cancelled" | "expired" | "failed";
+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;
-  venueOrderId?: string | null;
-  reservedCostRaw?: string | null;
-  limitPriceRaw: string;
-  limitSizeRaw: string;
-  filledSizeRaw: string;
-  remainingSizeRaw: string;
+  venueMarketId: string;
+  value: number;
+  label: string | null;
+  source: RecurringCryptoComparisonPriceSource;
+  provider: string | null;
+  providerMarketId: string | null;
+  timestamp: string | null;
+  confidence: RecurringCryptoSourceConfidence | null;
 }
-interface PlaceOrderParams {
+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;
-  venueMarketOutcomeId: string;
-  side: "buy" | "sell";
-  /** Buy only. Maximum all-in USD spend, inclusive of app fee. */
-  maxSpend?: number;
-  /** Sell only. Number of contracts to sell. */
-  sellShares?: number;
-  /**
-   * Your trade id. Required, unique within your app — two different users of
-   * the same app cannot share one. A repeat returns 409 instead of trading twice.
-   */
-  externalId: string;
-  /** Slippage cap in bps. Defaults to 500 (5%). Set explicitly on sells. */
-  slipCapBps?: number;
-  /** Restrict funding to these chain IDs. Omit to allow every funded chain. */
-  allowedSourceChainIds?: number[];
-  /** USD budgets capped by refreshed wallet balances; omitted chains cannot fund. */
-  chainBalances?: Record<string, number>;
-  /** Per-trade app fee in bips (0..10000), replacing the app's configured rate. Needs an app API key. Buy only. */
-  appFeeBips?: number;
-  /** Per-venue app fee in bips (each 0..10000), e.g. `{ polymarket: 20, hyperliquid: 10 }`. Wins over `appFeeBips` on the venues it names; `appFeeBips` still covers the rest. Needs an app API key. Buy only. */
-  appFeeBipsByVenue?: Record<string, number>;
-  /** Referral: EVM address that receives the referral fee. Needs an app API key. */
-  referrer?: string;
-  /** Referral fee in bips of routed notional (1..10000). Snag-free. */
-  referrerFeeBips?: number;
-  /** Per-venue referral fee in bips (each 0..10000; 0 = none on that venue). Wins over `referrerFeeBips` on the venues it names. Needs `referrer` and an app API key. Not for `skipQuote`. */
-  referrerFeeBipsByVenue?: Record<string, number>;
-  /** Who funds the referral: "user" (default) reserves it from maxSpend; "app" pays from `referralPayerAddress` after the fill. */
-  referralPayer?: "user" | "app";
-  /** Required with `referralPayer: "app"`: the wallet that signs the parked payout transaction. */
-  referralPayerAddress?: string;
-  /**
-   * User-paid referral only: a wallet that pays Hyperliquid's one-time 1 USDC
-   * activation fee for a referrer with no HyperCore account (self-custody
-   * Hyperliquid buys). Before the fill a pending signature with this
-   * `signerAddress` and `purpose: "hl_activation_sponsor"` is passed to your
-   * `signer`; it is `optional`, so declining it — or not answering within
-   * `OPTIONAL_SIGNATURE_TIMEOUT_MS` — never costs the trade.
-   */
-  referralActivationSponsorAddress?: string;
-  /**
-   * Skip the smart-route solver and send one order straight to `venue` (predict,
-   * hyperliquid, novig and prophetx only; others return 400). Requires a `read_write` `x-app-api-key`. No
-   * bridging: funds must already sit on the venue's own chain, and `allowedSourceChainIds` /
-   * `chainBalances` are ignored alongside it. You own price and minimum
-   * checks — an order the venue refuses fails after acceptance and uses up its `externalId`.
-   */
-  skipQuote?: boolean;
+  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;
+  tickSize: number | null;
+  /** Limit-order size step on this venue, raw 6-dec shares ("10000" = 0.01).
+   *  Absent means a 1-unit step. */
+  sizeStepRaw?: string;
+  /** Smallest limit-order size on this market, raw 6-dec shares.
+   *  Absent means no known minimum. */
+  minSizeRaw?: string;
+  orderbook: Orderbook;
   /**
-   * With `skipQuote`, skip the balance check and fund hold on a buy: nothing checks the
-   * balance and an underfunded order fails at the venue. Sells still check the position.
-   * Without `skipQuote`, skip only the quote-time balance refresh: the route uses the last
-   * stored balances, and the fund hold and balance check still run. Faster, but a stale
-   * balance can fail the order after it was accepted. Requires a `read_write` `x-app-api-key`.
+   * Sticky tick of this venue's book inferred at runtime by the engine. May
+   * differ from the seed `tickSize` when the live grid is finer than the DB
+   * metadata. Optional — only populated when the engine has emitted runtime
+   * metadata for this entry.
    */
-  skipBalance?: boolean;
+  tick?: number | null;
+  /** Provenance of this venue book's published midpoint. See {@link MarkSource}. */
+  markSource?: MarkSource;
   /**
-   * With `skipQuote`, the price to trade at (e.g. `0.52`). Optional: if omitted, the best
-   * available price at submission is used (best ask to buy, bid to sell). Ignored on
-   * prophetx, which prices the order itself within `slipCapBps`.
+   * Hyperliquid HIP-4 deployer namespace whose book this entry publishes
+   * (e.g. "ap"). `null` for every other venue. When a cluster has more than
+   * one Hyperliquid deployer member, only one member's book is published per
+   * request — this names which one, so a caller never pairs this entry's depth
+   * with a different member's `venueMarketId`.
    */
-  price?: number;
+  deployerVenue?: string | null;
 }
-interface PlaceOrderResponse {
-  orderId: string;
-  externalId: string;
-  venue: Venue;
-  status: "pending";
-  quoteId: string;
-  /** `null` if the order row doesn't carry a quoted price. Not zero. */
-  quotedPriceRaw: string | null;
-  /** `null` under the same conditions as `quotedPriceRaw`. Not zero. */
-  quotedCostRaw: string | null;
-  /** `null` under the same conditions as `quotedPriceRaw`. Not zero. */
-  quotedSharesRaw: string | null;
+/** Response from GET /orderbooks (batch). */
+interface BatchOrderbooksResponse {
+  data: Array<{
+    venueMarketId: string;
+    status: OrderbookBatchItemStatus;
+    error: OrderbookBatchItemError | null;
+    requestedMarket: RequestedOrderbookMarket | null;
+    venueOrderbooks: Record<string, VenueOrderbookEntry>;
+    matchedMarkets: MatchedOrderbookMarket[];
+  }>;
+  meta: {
+    requestedCount: number;
+    okCount: number;
+    errorCount: number;
+  };
 }
-interface ValidateManagedParams {
-  venueMarketOutcomeIds: string[];
-  side: "buy" | "sell";
-  amount: number;
+/** A single market midpoint row returned by GET /midpoints. */
+interface MidpointRow {
+  venueMarketId: string;
+  venue: string;
+  midpoint: number | null;
+  spread: number | null;
+  timestamp: number | null;
+  arbReturn?: number | null;
+  /** Provenance of `midpoint`. */
+  markSource?: MarkSource;
+  /**
+   * When `markSource === "sibling"`, the matched venueMarketId whose book
+   * supplied the headline mark. Allows the FE to label "sourced from venue X"
+   * 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;
 }
-interface ValidateManagedResponse {
-  canExecute: boolean;
-  availableBalanceRaw: string;
-  requiredBalanceRaw: string;
-  bridgeSourceChainId?: number;
-  bridgeAmountRaw?: string;
+/** Per-outcome midpoint from a live orderbook. */
+interface OutcomeMidpointRow {
+  venueMarketOutcomeId: string;
+  label: string;
+  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;
 }
-type BalanceRefillPolicyStatus = "enabled" | "paused";
-type BalanceRefillAttemptStatus = "reserved" | "executing" | "completed" | "failed";
-interface BalanceRefillAttempt {
-  id: string;
-  policyId: string;
-  status: BalanceRefillAttemptStatus;
-  /** Target-chain balance when the threshold was crossed, in 6-decimal USD units. */
-  triggerBalanceRaw: string;
-  /** Minimum amount the refill must deliver, in 6-decimal USD units. */
-  requestedDeliveryRaw: string;
-  /** Reserved source amount, in 6-decimal USD units. */
-  sourceAmountRaw: string;
-  completedAmountRaw: string | null;
-  sourceChainId: number;
-  targetChainId: number;
-  feeRaw: string | null;
-  errorMessage: string | null;
-  startedAt: string | null;
-  completedAt: string | null;
-  createdAt: string;
+/** 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;
+    };
+  }>;
 }
-interface BalanceRefillPolicy {
+/** Response from GET /orderbook/outcome/:id (single outcome). */
+interface OutcomeOrderbookResponse {
+  /** CRC of returned depth-limited levels; full engine checksum remains unchanged. */
+  snapshotChecksum?: number;
+  venueMarketOutcomeId: string;
+  venueMarketId: string;
+  venue: string;
+  orderbook: {
+    bids: Array<{
+      price: number;
+      size: number;
+    }>;
+    asks: Array<{
+      price: number;
+      size: number;
+    }>;
+  };
+  midpoint: number | null;
+  spread: number | null;
+  seq: number;
+  checksum: number;
+  timestamp: number;
+  /** Sticky tick of this outcome's book, inferred at runtime. `null` until inferred. */
+  tick: number | null;
+  /** Provenance of `midpoint`. See {@link MarkSource}. */
+  markSource: MarkSource;
+}
+/** Standard paginated list response from the API. */
+interface PaginatedResponse<T> {
+  data: T[];
+  nextCursor: string | null;
+  hasMore: boolean;
+}
+interface OrderListQuery {
+  userId?: string;
+  status?: string;
+  limit?: number;
+  offset?: number;
+}
+interface TradeExecutorOrder {
   id: string;
-  targetChainId: number;
-  targetTokenAddress: string;
-  targetTokenSymbol: "USDC";
-  /** Balance floor, in 6-decimal USD units. */
-  minimumRaw: string;
-  /** Minimum delivered amount per refill, in 6-decimal USD units. */
-  refillAmountRaw: string;
-  dailyCapRaw: string;
-  maxFeeRaw: string;
-  status: BalanceRefillPolicyStatus;
-  cooldownSeconds: number;
-  lastObservedRaw: string | null;
-  lastEvaluatedAt: string | null;
-  nextEligibleAt: string | null;
-  consentedAt: string;
+  userId: string;
+  venue: string;
+  status: string;
+  marketId: string;
+  tokenId: string;
+  side: string;
+  amountRaw: string;
+  quoteId: string | null;
+  externalId: string | null;
+  clientOrderId: string | null;
+  dagRunId: string | null;
+  filledAmountRaw: string | null;
+  executionPrice: string | null;
+  txHash: string | null;
+  errorMessage: string | null;
   createdAt: string;
   updatedAt: string;
-  latestAttempt: BalanceRefillAttempt | null;
 }
-interface CreateBalanceRefillPolicyParams {
-  targetChainId: number;
-  targetTokenSymbol?: "USDC";
-  minimumRaw: string;
-  refillAmountRaw: string;
-  /** Optional daily refill limit. Defaults to $1,002 in 6-decimal USD units. */
-  dailyCapRaw?: string;
-  /** Optional per-refill fee limit. Defaults to $2 in 6-decimal USD units. */
-  maxFeeRaw?: string;
+interface TradeExecutorOrderListResponse {
+  orders: TradeExecutorOrder[];
+  total: number;
 }
-interface UpdateBalanceRefillPolicyParams {
-  minimumRaw?: string;
-  refillAmountRaw?: string;
-  dailyCapRaw?: string;
-  maxFeeRaw?: string;
-  status?: BalanceRefillPolicyStatus;
+/** A single level in the aggregated orderbook with per-venue attribution. */
+interface AggregatedOrderbookLevel {
+  price: number;
+  size: number;
+  venues: Record<string, number>;
 }
-type WithdrawTokenSymbol = "USDC" | "USDC.e" | "USDT";
-type WithdrawalSourceTokenSymbol = WithdrawTokenSymbol | "pUSD" | "USD1";
-interface WithdrawManagedParams {
-  /** Idempotency key for exact-amount transfers. Retry the same request, never a new key, after a lost response. Not combined with max. */
-  requestId?: string;
-  /** Positive integer string in the token's native decimals (e.g. "100000" = 0.1 USDC). */
-  amountRaw: string;
-  tokenSymbol: WithdrawTokenSymbol;
-  /** Recipient address. EVM destinations use 0x-prefixed 20-byte hex; Solana uses base58. */
-  destinationAddress: string;
-  /** 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;
+/** A simple orderbook level without venue attribution. */
+interface SimpleOrderbookLevel {
+  price: number;
+  size: number;
 }
-type WithdrawalLifecycleStatus = "pending" | "bridging" | "transferring" | "completed" | "partial" | "failed";
-type WithdrawalSourceStatus = "pending" | "submitted" | "confirmed" | "failed";
-type WithdrawalLegType = "transfer" | "bridge";
-type WithdrawalLegStatus = "planned" | "submitted" | "confirmed" | "failed";
-interface WithdrawalLeg {
-  type: WithdrawalLegType;
-  status: WithdrawalLegStatus;
-  sourceChainId: number;
-  destChainId: number;
-  amountRaw: string;
-  txHash: string | null;
-  bridgeOperationId: string | null;
-  /** Human-readable failure reason when `status === "failed"`. Null when succeeded or in-flight. */
-  errorMessage?: string | null;
+/** Per-venue best-bid/ask info. */
+interface VenuePriceInfo {
+  bestBid: number | null;
+  bestAsk: number | null;
 }
-interface WithdrawManagedSourceItem {
-  sourceId: string;
-  chainId: number;
-  tokenSymbol: WithdrawalSourceTokenSymbol;
-  /** On-chain token address on `chainId`. */
-  tokenAddress: string;
-  /**
-   * On-chain decimals for `(chainId, tokenAddress)`. Required to interpret
-   * `amountRaw`: BNB USDC is 18-dec, EVM USDC is 6-dec.
+/** Response from GET /orderbook/:venueMarketId — canonical aggregated orderbook. */
+interface AggregatedOrderbookResponse {
+  venueMarketId: string;
+  orderbook: {
+    bids: AggregatedOrderbookLevel[];
+    asks: AggregatedOrderbookLevel[];
+  };
+  venueOrderbooks: Record<string, {
+    bids: SimpleOrderbookLevel[];
+    asks: SimpleOrderbookLevel[];
+  }>;
+  venues: Record<string, VenuePriceInfo>;
+  midpoint: number | null;
+  spread: number | null;
+  timestamp: number;
+  /** Sequence number (present in live responses). */
+  seq?: number;
+  /** CRC32 checksum (present in live responses). */
+  checksum?: number | null;
+  /** Markets matched across venues for this canonical market. */
+  matchedMarkets?: Array<{
+    venue: string;
+    venueMarketId: string;
+  }>;
+}
+interface ExecuteManagedParams {
+  quoteId: string;
+  /**
+   * Optional idempotency key: your own id for this trade, unique within your
+   * app. Saved on every order the quote splits into, so
+   * `getExecutionOrders({ externalId })` returns all legs and each
+   * `trades.filled` webhook carries it. Reusing it on a different quote is
+   * rejected with 409.
    */
-  decimals: number;
-  amountRaw: string;
-  /** Smart-wallet or native-account custody; absent for ordinary EOA sources. */
-  custodyKind?: "DEPOSIT_WALLET" | "VENUE_ACCOUNT";
-  /** Venue that owns the source (for example, `pred` or `tiprun`). */
-  venue?: string;
-  sourceVenueAccountId?: string;
-  /** Lossless native account ID, not an EVM address. */
-  sourceExternalAccountId?: string;
-  status: WithdrawalSourceStatus;
-  txHash: string | null;
-  bridgeOperationId: string | null;
+  externalId?: string;
+  /** Trading mode. Defaults to live. */
+  mode?: ExecutionMode;
   /**
-   * Present only while a venue-account source is submitted but not confirmed:
-   * what it is waiting on (`awaiting_venue_approval` = the venue has not
-   * approved the withdrawal yet).
+   * Optional intent fallback. When the supplied `quoteId` has expired in the
+   * cache (e.g. user clicked Buy after a tab was inactive), the server
+   * resolves the latest quote for this intent and refreshes/executes against
+   * that instead of returning 400 `quote_not_found`. Same intent = same buttons
+   * the user pressed in the UI; a different `maxSpend`, mode, or venue scope is
+   * a different intent and won't match.
    */
-  pendingReason?: "awaiting_venue_submission" | "awaiting_venue_approval" | "awaiting_chain" | "awaiting_venue_balance" | "rechecking";
-}
-/**
- * `pricingStatus === "quoted"` means the response includes a fresh preflight
- * quote; other states may carry null `expected.*` fields. Do NOT treat null
- * fields as missing.
- */
-interface WithdrawalExpected {
-  outputRaw: string | null;
-  feeRaw: string | null;
-  etaSeconds: number | null;
-}
-/** Body for POST /execution/withdraw/preview — identical to a withdraw request. */
-type WithdrawPreviewParams = WithdrawManagedParams;
-interface WithdrawalQuoteParams {
-  tokenSymbol: WithdrawTokenSymbol;
-  destinationChainId: number;
-}
-interface WithdrawalQuoteResponse {
-  tokenSymbol: WithdrawTokenSymbol;
-  destinationChainId: number;
-  maxDeliverableRaw: string;
-  rawBalanceRaw: string;
-  decimals: number;
-}
-/** Response from POST /execution/withdraw/preview. All amounts are raw strings in destination-token native decimals. */
-interface WithdrawPreviewResponse {
-  receiveAmountRaw: string | null;
-  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;
-  requested: {
-    tokenSymbol: WithdrawTokenSymbol;
-    amountRaw: string;
+  fallbackToLatest?: {
+    outcomeId: string;
+    side: "buy" | "sell";
+    maxSpend?: number;
+    sellShares?: number;
+    allowedVenues?: Venue[];
   };
   /**
-   * Terminal settled amount in destination-token native decimals.
-   * Null until at least one source confirms.
+   * Self-custody: the wallet that will sign this fill. Must be a wallet
+   * already linked to this account. Omit for managed custody (the default).
    */
-  completedAmountRaw: string | null;
-  destination: {
-    chainId: number;
-    address: string;
-    tokenSymbol: WithdrawTokenSymbol;
-  };
-  legs: WithdrawalLeg[];
-  expected: WithdrawalExpected;
-  pricingStatus: "unquoted" | "quoting" | "quoted" | "unviable";
+  signingAddress?: string;
   /**
-   * Persisted terminal-state error reason. Always `null` until the
-   * withdrawal reaches `failed` / `partial`. The submit response always
-   * returns `null`; populated values arrive via the GET status endpoint or
-   * via a terminal `withdrawal_lifecycle` WS event.
+   * Self-custody buys only: other wallets linked to this account whose balances
+   * may fund the fill. Must match the set the quote was priced with.
    */
-  errorMessage: string | null;
-  sources: WithdrawManagedSourceItem[];
-}
-interface DepositAddressesToken {
-  symbol: string;
-  address: string;
-  decimals: number;
-}
-interface DepositAddressesSupportedChain {
-  chainId: number;
-  name: string;
-  tokens: DepositAddressesToken[];
-}
-interface DepositAddressesReadyResponse {
-  ready: true;
-  evmAddress: string;
-  svmAddress: string;
-  supportedChains: DepositAddressesSupportedChain[];
-}
-interface DepositAddressesPendingResponse {
-  ready: false;
+  fundingAddresses?: string[];
+  /**
+   * Self-custody only: which approve shape a cross-chain fill uses when the
+   * bridge needs an ERC20 approve. Omit (the default) for "sponsored" — the
+   * approve costs the wallet no gas, but the wallet must sign a one-time
+   * EIP-7702 authorization over a RAW DIGEST, which many wallets cannot
+   * produce. Send "user_broadcast" when yours cannot: the user sends the
+   * approve from their own wallet and pays its gas. Only your client can know
+   * which applies — it is a property of the wallet software, not of the
+   * address or the chain.
+   *
+   * Worth surfacing in your UI: "user_broadcast" never establishes the
+   * delegation, so an approve is needed on EVERY bridge. "sponsored" costs one
+   * signature once per chain.
+   *
+   * Neither mode makes bridging free — the approve is only one of the costs.
+   * Relay's fee comes out of the amount delivered on every bridge, and one-time
+   * costs apply per route. Quote with `deepEstimate` and read
+   * `feeBreakdown.bridgeFees` and `feeBreakdown.setupCosts` rather than
+   * inferring cost from the approve mode.
+   */
+  approveMode?: "sponsored" | "user_broadcast";
 }
-type DepositAddressesResponse = DepositAddressesReadyResponse | DepositAddressesPendingResponse;
-interface GetPositionsParams {
-  cursor?: string;
-  limit?: number;
-  status?: "active" | "closed";
-  mode?: ExecutionMode;
-  categoryIds?: string[];
-  sort?: "realizedPnl";
+interface ExecuteManagedResponse {
+  alreadyAccepted?: boolean;
+  quoteId: string;
+  orderIds: string[];
+  status: "pending";
+  redeemId?: string;
+  message?: string;
+  /**
+   * What this fill is waiting to be signed, if anything. On the immediate
+   * `POST /execution/fill` response this is always absent or empty — even
+   * for a self-custody fill, the DAG parks asynchronously, after this
+   * response has already been sent. Real entries only ever come back from
+   * polling `GET /execution/status` or from the next
+   * `POST /execution/fill/:quoteId/signatures` response (this same shape,
+   * reused). Drive the whole round trip through `fillSelfCustody()` rather
+   * than reading this field on the fill response by hand.
+   */
+  pendingSignatures?: SignatureRequest[];
 }
-interface GetOrdersParams {
-  status?: string;
-  cursor?: string;
-  limit?: number;
+type LimitOrderTimeInForce = "GTC" | "GTD" | "FOK" | "FAK" | "IOC" | "ALO";
+type CancelOrderSignature = {
+  signature: string;
+  timestamp: number;
+} | {
+  venue: "hyperliquid";
+  action: {
+    type: "cancel";
+    cancels: Array<{
+      a: number;
+      o: number;
+    }>;
+  };
+  nonce: number;
+  signature: {
+    r: string;
+    s: string;
+    v: 27 | 28;
+  };
+};
+interface CancelVenueOrderParams {
+  venue: "polymarket" | "hyperliquid";
+  venueOrderId: string;
+  signerAddress: string;
+  cancelSignature: CancelOrderSignature;
 }
-interface OrderbookQuoteParams {
-  marketId: string;
+interface PlaceLimitOrderParams {
+  /** BETDEX uses hosted cash: GTC/IOC only, no signer, post-only or expiry.
+   * Native odds are rounded conservatively and stake is rounded down. GTC
+   * unmatched liquidity is cancelled at the in-play transition. SELL closes
+   * the same For outcome and requires collateral as well as owned inventory.
+   */
+  venue: Venue;
+  venueMarketOutcomeId: string;
   side: "buy" | "sell";
-  size: number;
-}
-interface OrderbookQuoteFill {
-  venue: string;
-  size: number;
-  avgPrice: number;
-  cost: number;
+  limitPriceRaw: string;
+  sizeRaw: string;
+  timeInForce: LimitOrderTimeInForce;
+  postOnly?: boolean;
+  expiresAt?: string;
+  clientOrderId?: string;
+  /** Linked account EOA. Polymarket supports GTC/GTD buys; Hyperliquid supports GTC/ALO buys and sells. Agent keys stay on the client. Omit for managed custody. */
+  signingAddress?: string;
+  /** Same bridge approval mode as market fills; defaults to sponsored. */
+  approveMode?: ExecuteManagedParams["approveMode"];
+  /** Self-custody buys only: other wallets linked to this account whose balances may bridge in to fund the order. Requires signingAddress. */
+  fundingAddresses?: string[];
 }
-interface OrderbookQuoteResponse {
-  marketId: string;
+interface PlaceLimitOrderResponse {
+  orderId: string;
+  /** Poll getExecutionStatus and answer submitFillSignatures using this ID. */
+  quoteId?: string;
+  status: "pending" | "submitting" | "submitted" | "cancel_pending" | "partial_fill" | "open" | "partially_filled_open" | "filled" | "cancelled" | "expired" | "failed";
+  venue: Venue;
+  venueOrderId?: string | null;
+  reservedCostRaw?: string | null;
+  limitPriceRaw: string;
+  limitSizeRaw: string;
+  filledSizeRaw: string;
+  remainingSizeRaw: string;
+}
+interface PlaceOrderParams {
+  venue: Venue;
+  venueMarketOutcomeId: string;
   side: "buy" | "sell";
-  requestedSize: number;
-  filledSize: number;
-  avgPrice: number | null;
-  totalCost: number;
-  slippage: number | null;
-  fills: OrderbookQuoteFill[];
+  /** Buy only. Maximum all-in USD spend, inclusive of app fee. */
+  maxSpend?: number;
+  /** Sell only. Number of contracts to sell. */
+  sellShares?: number;
+  /**
+   * Your trade id. Required, unique within your app — two different users of
+   * the same app cannot share one. A repeat returns 409 instead of trading twice.
+   */
+  externalId: string;
+  /** Slippage cap in bps. Defaults to 500 (5%). Set explicitly on sells. */
+  slipCapBps?: number;
+  /** Restrict funding to these chain IDs. Omit to allow every funded chain. */
+  allowedSourceChainIds?: number[];
+  /** USD budgets capped by refreshed wallet balances; omitted chains cannot fund. */
+  chainBalances?: Record<string, number>;
+  /** Per-trade app fee in bips (0..10000), replacing the app's configured rate. Needs an app API key. Buy only. */
+  appFeeBips?: number;
+  /** Per-venue app fee in bips (each 0..10000), e.g. `{ polymarket: 20, hyperliquid: 10 }`. Wins over `appFeeBips` on the venues it names; `appFeeBips` still covers the rest. Needs an app API key. Buy only. */
+  appFeeBipsByVenue?: Record<string, number>;
+  /** Referral: EVM address that receives the referral fee. Needs an app API key. */
+  referrer?: string;
+  /** Referral fee in bips of routed notional (1..10000). Snag-free. */
+  referrerFeeBips?: number;
+  /** Per-venue referral fee in bips (each 0..10000; 0 = none on that venue). Wins over `referrerFeeBips` on the venues it names. Needs `referrer` and an app API key. Not for `skipQuote`. */
+  referrerFeeBipsByVenue?: Record<string, number>;
+  /** Who funds the referral: "user" (default) reserves it from maxSpend; "app" pays from `referralPayerAddress` after the fill. */
+  referralPayer?: "user" | "app";
+  /** Required with `referralPayer: "app"`: the wallet that signs the parked payout transaction. */
+  referralPayerAddress?: string;
+  /**
+   * User-paid referral only: a wallet that pays Hyperliquid's one-time 1 USDC
+   * activation fee for a referrer with no HyperCore account (self-custody
+   * Hyperliquid buys). Before the fill a pending signature with this
+   * `signerAddress` and `purpose: "hl_activation_sponsor"` is passed to your
+   * `signer`; it is `optional`, so declining it — or not answering within
+   * `OPTIONAL_SIGNATURE_TIMEOUT_MS` — never costs the trade.
+   */
+  referralActivationSponsorAddress?: string;
+  /**
+   * Skip the smart-route solver and send one order straight to `venue` (predict,
+   * hyperliquid, novig and prophetx only; others return 400). Requires a `read_write` `x-app-api-key`. No
+   * bridging: funds must already sit on the venue's own chain, and `allowedSourceChainIds` /
+   * `chainBalances` are ignored alongside it. You own price and minimum
+   * checks — an order the venue refuses fails after acceptance and uses up its `externalId`.
+   */
+  skipQuote?: boolean;
+  /**
+   * With `skipQuote`, skip the balance check and fund hold on a buy: nothing checks the
+   * balance and an underfunded order fails at the venue. Sells still check the position.
+   * Without `skipQuote`, skip only the quote-time balance refresh: the route uses the last
+   * stored balances, and the fund hold and balance check still run. Faster, but a stale
+   * balance can fail the order after it was accepted. Requires a `read_write` `x-app-api-key`.
+   */
+  skipBalance?: boolean;
+  /**
+   * With `skipQuote`, the price to trade at (e.g. `0.52`). Optional: if omitted, the best
+   * available price at submission is used (best ask to buy, bid to sell). Ignored on
+   * prophetx, which prices the order itself within `slipCapBps`.
+   */
+  price?: number;
 }
-type ExecutionOrdersQuery = GetOrdersQuery & {
-  mode?: ExecutionMode;
-};
-type ExecutionOrderItem = OrderListItem;
-type ExecutionStatusQuery = {
+interface PlaceOrderResponse {
+  orderId: string;
+  externalId: string;
+  venue: Venue;
+  status: "pending";
   quoteId: string;
-  mode?: ExecutionMode;
-};
-type ExecutionOverallState = "created" | "routing" | "quoting" | "placing" | "confirming" | "filled" | "partially_filled" | "failed" | "cancelled" | "expired";
-interface ExecutionDagProgress {
-  dagRunId: string;
-  totalSteps: number;
-  currentSequence: number;
-  currentStepType: string | null;
-  completedSequences: number[];
-  stepTypes: Record<number, string>;
-  status: "running" | "completed" | "failed";
-  errorReason: string | null;
+  /** `null` if the order row doesn't carry a quoted price. Not zero. */
+  quotedPriceRaw: string | null;
+  /** `null` under the same conditions as `quotedPriceRaw`. Not zero. */
+  quotedCostRaw: string | null;
+  /** `null` under the same conditions as `quotedPriceRaw`. Not zero. */
+  quotedSharesRaw: string | null;
 }
-type ExecutionDisplayStepKind = "submit" | "setup" | "bridge" | "fill" | "internal";
-type ExecutionDisplayGroupStatus = "pending" | "in_progress" | "completed" | "failed" | "skipped";
-interface ExecutionStatusStep {
-  sequence: number;
-  stepType: string;
-  status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
-  attempt: number;
+interface ValidateManagedParams {
+  venueMarketOutcomeIds: string[];
+  side: "buy" | "sell";
+  amount: number;
+}
+interface ValidateManagedResponse {
+  canExecute: boolean;
+  availableBalanceRaw: string;
+  requiredBalanceRaw: string;
+  bridgeSourceChainId?: number;
+  bridgeAmountRaw?: string;
+}
+type BalanceRefillPolicyStatus = "enabled" | "paused";
+type BalanceRefillAttemptStatus = "reserved" | "executing" | "completed" | "failed";
+interface BalanceRefillAttempt {
+  id: string;
+  policyId: string;
+  status: BalanceRefillAttemptStatus;
+  /** Target-chain balance when the threshold was crossed, in 6-decimal USD units. */
+  triggerBalanceRaw: string;
+  /** Minimum amount the refill must deliver, in 6-decimal USD units. */
+  requestedDeliveryRaw: string;
+  /** Reserved source amount, in 6-decimal USD units. */
+  sourceAmountRaw: string;
+  completedAmountRaw: string | null;
+  sourceChainId: number;
+  targetChainId: number;
+  feeRaw: string | null;
+  errorMessage: string | null;
   startedAt: string | null;
   completedAt: string | null;
-  errorReason: string | null;
-  /** Venue legs this step funds or executes; join to `orders[].orderId`. */
-  orderIds: string[];
-  /** Display class. `internal` steps are not meant to be rendered. */
-  kind: ExecutionDisplayStepKind;
-  /** Steps sharing a groupId render as ONE row. */
-  groupId: string;
-  /** Rolled-up status for the group; identical on every member. */
-  groupStatus: ExecutionDisplayGroupStatus;
-  /** Row copy, phrased for the current `groupStatus`. */
-  label: string;
-  /** Set on `kind: "bridge"` only. */
-  bridge?: {
-    amount: string;
-    tokenSymbol: string;
-    fromChain: string;
-    toChain: string;
-  };
+  createdAt: string;
 }
-interface ExecutionStatusOrder {
-  orderId: string;
-  venue: string;
-  status: string;
-  event: "filled" | "partial_fill" | "failed" | null;
-  filledAmountRaw?: string;
-  remainingAmountRaw?: string;
-  quotedSharesRaw?: string;
-  actualSharesRaw?: string;
-  quotedToWinRaw?: string;
-  actualToWinRaw?: string;
-  quotedPriceRaw?: string;
-  executionPriceRaw?: string;
-  partialFillReason?: string;
-  errorReason?: string;
-  venueOrderId?: string;
-  txHash?: string;
+interface BalanceRefillPolicy {
+  id: string;
+  targetChainId: number;
+  targetTokenAddress: string;
+  targetTokenSymbol: "USDC";
+  /** Balance floor, in 6-decimal USD units. */
+  minimumRaw: string;
+  /** Minimum delivered amount per refill, in 6-decimal USD units. */
+  refillAmountRaw: string;
+  dailyCapRaw: string;
+  maxFeeRaw: string;
+  status: BalanceRefillPolicyStatus;
+  cooldownSeconds: number;
+  lastObservedRaw: string | null;
+  lastEvaluatedAt: string | null;
+  nextEligibleAt: string | null;
+  consentedAt: string;
+  createdAt: string;
   updatedAt: string;
+  latestAttempt: BalanceRefillAttempt | null;
 }
-interface ExecutionStatusResponse {
-  executionId: string | null;
-  quoteId: string;
-  orderIds: string[];
-  overallState: ExecutionOverallState;
-  terminal: boolean;
-  errorReason: string | null;
-  pollAfterMs: number | null;
-  dagProgress: ExecutionDagProgress | null;
-  steps: ExecutionStatusStep[];
-  orders: ExecutionStatusOrder[];
-  /**
-   * What this run is waiting to be signed, mirroring the fill response's
-   * field of the same name. This is the polling route `fillSelfCustody` reads
-   * while an on-chain step is in flight — a caller polling this route for
-   * progress learns about newly-parked steps here too, not just from the
-   * signatures endpoint.
-   */
-  pendingSignatures?: SignatureRequest[];
-}
-type ExecutionPositionsQuery = GetPositionsQuery & {
-  mode?: ExecutionMode;
-};
-type ExecutionPositionGroup = PositionGroup;
-/** Whose cash to return: the managed server wallet (default) or the account's linked wallets. */
-type BalanceCustody = "managed" | "self";
-type ManagedBalancesParams = {
-  mode?: ExecutionMode;
-  custody?: BalanceCustody;
-};
-type ManagedBalancesResponse = UnifiedBalanceResponse;
-interface PaperTradingAppOptions {
-  /** App ID for the paper account namespace. Defaults to AggClient appId. */
-  appId?: string;
-}
-interface PaperTradingListParams {
-  limit?: number;
-  cursor?: string;
+interface CreateBalanceRefillPolicyParams {
+  targetChainId: number;
+  targetTokenSymbol?: "USDC";
+  minimumRaw: string;
+  refillAmountRaw: string;
+  /** Optional daily refill limit. Defaults to $1,002 in 6-decimal USD units. */
+  dailyCapRaw?: string;
+  /** Optional per-refill fee limit. Defaults to $2 in 6-decimal USD units. */
+  maxFeeRaw?: string;
 }
-interface PaperTradingAccountListParams extends PaperTradingListParams {
-  externalId?: string;
+interface UpdateBalanceRefillPolicyParams {
+  minimumRaw?: string;
+  refillAmountRaw?: string;
+  dailyCapRaw?: string;
+  maxFeeRaw?: string;
+  status?: BalanceRefillPolicyStatus;
 }
-interface CreatePaperTradingAccountParams {
-  name?: string;
-  externalId?: string;
-  initialBalanceRaw?: string;
-  initialBalance?: number;
+type WithdrawTokenSymbol = "USDC" | "USDC.e" | "USDT";
+type WithdrawalSourceTokenSymbol = WithdrawTokenSymbol | "pUSD" | "USD1";
+interface WithdrawManagedParams {
+  /** Idempotency key for exact-amount transfers. Retry the same request, never a new key, after a lost response. Not combined with max. */
+  requestId?: string;
+  /** Positive integer string in the token's native decimals (e.g. "100000" = 0.1 USDC). */
+  amountRaw: string;
+  tokenSymbol: WithdrawTokenSymbol;
+  /** Recipient address. EVM destinations use 0x-prefixed 20-byte hex; Solana uses base58. */
+  destinationAddress: string;
+  /** 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;
+  /**
+   * Self-custody: the linked EVM wallet that owns and signs this withdrawal.
+   * `amountRaw` is then the amount debited (fees come out of it) and `max` is
+   * not supported. Omit for managed custody.
+   */
+  signingAddress?: string;
+  /**
+   * Self-custody only: what the signing wallet can sign. Send the same value to
+   * `getWithdrawalQuote`, `withdrawPreview` and `withdrawManaged`. `"sponsored"`
+   * (default): it can sign an EIP-7702 authorization and Calibur batch.
+   * `"user_broadcast"`: it cannot (e.g. MetaMask); the withdrawal still never
+   * asks for gas, and sources that would need a batch are left out.
+   */
+  approveMode?: "sponsored" | "user_broadcast";
 }
-interface SetPaperTradingBalanceParams {
-  balanceRaw?: string;
-  balance?: number;
-  reason?: string;
+type WithdrawalLifecycleStatus = "pending" | "bridging" | "transferring" | "completed" | "partial" | "failed";
+type WithdrawalSourceStatus = "pending" | "submitted" | "confirmed" | "failed";
+type WithdrawalLegType = "transfer" | "bridge";
+type WithdrawalLegStatus = "planned" | "submitted" | "confirmed" | "failed";
+interface WithdrawalLeg {
+  type: WithdrawalLegType;
+  status: WithdrawalLegStatus;
+  sourceChainId: number;
+  destChainId: number;
+  amountRaw: string;
+  txHash: string | null;
+  bridgeOperationId: string | null;
+  /** Human-readable failure reason when `status === "failed"`. Null when succeeded or in-flight. */
+  errorMessage?: string | null;
 }
-interface ResetPaperTradingAccountParams {
-  balanceRaw?: string;
-  balance?: number;
-  reason?: string;
+interface WithdrawManagedSourceItem {
+  sourceId: string;
+  chainId: number;
+  tokenSymbol: WithdrawalSourceTokenSymbol;
+  /** On-chain token address on `chainId`. */
+  tokenAddress: string;
+  /**
+   * On-chain decimals for `(chainId, tokenAddress)`. Required to interpret
+   * `amountRaw`: BNB USDC is 18-dec, EVM USDC is 6-dec.
+   */
+  decimals: number;
+  amountRaw: string;
+  /** Smart-wallet or native-account custody; absent for ordinary EOA sources. */
+  custodyKind?: "DEPOSIT_WALLET" | "VENUE_ACCOUNT";
+  /** Venue that owns the source (for example, `pred` or `tiprun`). */
+  venue?: string;
+  sourceVenueAccountId?: string;
+  /** Lossless native account ID, not an EVM address. */
+  sourceExternalAccountId?: string;
+  status: WithdrawalSourceStatus;
+  txHash: string | null;
+  bridgeOperationId: string | null;
+  /**
+   * Present only while a venue-account source is submitted but not confirmed:
+   * what it is waiting on (`awaiting_venue_approval` = the venue has not
+   * approved the withdrawal yet).
+   */
+  pendingReason?: "awaiting_venue_submission" | "awaiting_venue_approval" | "awaiting_chain" | "awaiting_venue_balance" | "rechecking";
 }
-interface PlacePaperTradingOrderParams {
-  venueMarketOutcomeId: string;
-  side: "buy" | "sell";
-  spendRaw?: string;
-  spend?: number;
-  shares?: number;
-  slippageBps?: number;
-  clientOrderId?: string;
+/**
+ * `pricingStatus === "quoted"` means the response includes a fresh preflight
+ * quote; other states may carry null `expected.*` fields. Do NOT treat null
+ * fields as missing.
+ */
+interface WithdrawalExpected {
+  outputRaw: string | null;
+  feeRaw: string | null;
+  etaSeconds: number | null;
 }
-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;
+/** Body for POST /execution/withdraw/preview — identical to a withdraw request. */
+type WithdrawPreviewParams = WithdrawManagedParams;
+interface WithdrawalQuoteParams {
+  tokenSymbol: WithdrawTokenSymbol;
+  destinationChainId: number;
+  /**
+   * Self-custody: quote the Max of this linked EVM wallet (the amount it can
+   * debit) instead of the managed wallet. Same field as `withdrawManaged`.
+   */
+  signingAddress?: string;
+  /** Self-custody only: same field as `withdrawManaged`. Max excludes what this mode cannot spend. */
+  approveMode?: "sponsored" | "user_broadcast";
 }
-interface PaperTradingPosition {
-  id: string;
-  accountId: string;
-  venue: string;
-  venueMarketId: string;
-  venueMarketOutcomeId: string;
-  marketQuestion: string;
-  outcomeLabel: string;
+interface WithdrawalQuoteResponse {
+  tokenSymbol: WithdrawTokenSymbol;
+  destinationChainId: number;
+  maxDeliverableRaw: string;
+  rawBalanceRaw: string;
+  decimals: number;
+}
+/** Response from POST /execution/withdraw/preview. All amounts are raw strings in destination-token native decimals. */
+interface WithdrawPreviewResponse {
+  receiveAmountRaw: string | null;
+  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;
+  requested: {
+    tokenSymbol: WithdrawTokenSymbol;
+    amountRaw: string;
+  };
+  /**
+   * Terminal settled amount in destination-token native decimals.
+   * Null until at least one source confirms.
+   */
+  completedAmountRaw: string | null;
+  destination: {
+    chainId: number;
+    address: string;
+    tokenSymbol: WithdrawTokenSymbol;
+  };
+  legs: WithdrawalLeg[];
+  expected: WithdrawalExpected;
+  pricingStatus: "unquoted" | "quoting" | "quoted" | "unviable";
+  /**
+   * Persisted terminal-state error reason. Always `null` until the
+   * withdrawal reaches `failed` / `partial`. The submit response always
+   * returns `null`; populated values arrive via the GET status endpoint or
+   * via a terminal `withdrawal_lifecycle` WS event.
+   */
+  errorMessage: string | null;
+  sources: WithdrawManagedSourceItem[];
+  /** Self-custody only: signatures to answer via `submitWithdrawalSignatures`. */
+  pendingSignatures?: SignatureRequest[];
+}
+/** One answer to a `pendingSignatures` entry (fill or withdrawal): a `signature`, or a `txHash` for broadcast steps. */
+interface SubmitSignature {
+  stepId: string;
+  signature?: string;
+  txHash?: string;
+}
+interface DepositAddressesToken {
+  symbol: string;
+  address: string;
+  decimals: number;
+}
+interface DepositAddressesSupportedChain {
+  chainId: number;
+  name: string;
+  tokens: DepositAddressesToken[];
+}
+interface DepositAddressesReadyResponse {
+  ready: true;
+  evmAddress: string;
+  svmAddress: string;
+  supportedChains: DepositAddressesSupportedChain[];
+}
+interface DepositAddressesPendingResponse {
+  ready: false;
+}
+type DepositAddressesResponse = DepositAddressesReadyResponse | DepositAddressesPendingResponse;
+interface GetPositionsParams {
+  cursor?: string;
+  limit?: number;
+  status?: "active" | "closed";
+  mode?: ExecutionMode;
+  categoryIds?: string[];
+  sort?: "realizedPnl";
+}
+interface GetOrdersParams {
+  status?: string;
+  cursor?: string;
+  limit?: number;
+}
+interface OrderbookQuoteParams {
+  marketId: string;
+  side: "buy" | "sell";
   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;
+interface OrderbookQuoteFill {
   venue: string;
-  venueMarketId: string;
-  venueMarketOutcomeId: string;
-  marketQuestion: string;
-  outcomeLabel: string;
+  size: number;
+  avgPrice: number;
+  cost: number;
+}
+interface OrderbookQuoteResponse {
+  marketId: string;
+  side: "buy" | "sell";
+  requestedSize: number;
+  filledSize: number;
+  avgPrice: number | null;
+  totalCost: number;
+  slippage: number | null;
+  fills: OrderbookQuoteFill[];
+}
+type ExecutionOrdersQuery = GetOrdersQuery & {
+  mode?: ExecutionMode;
+};
+type ExecutionOrderItem = OrderListItem;
+type ExecutionStatusQuery = {
+  quoteId: string;
+  mode?: ExecutionMode;
+};
+type ExecutionOverallState = "created" | "routing" | "quoting" | "placing" | "confirming" | "filled" | "partially_filled" | "failed" | "cancelled" | "expired";
+interface ExecutionDagProgress {
+  dagRunId: string;
+  totalSteps: number;
+  currentSequence: number;
+  currentStepType: string | null;
+  completedSequences: number[];
+  stepTypes: Record<number, string>;
+  status: "running" | "completed" | "failed";
+  errorReason: string | null;
+}
+type ExecutionDisplayStepKind = "submit" | "setup" | "bridge" | "fill" | "internal";
+type ExecutionDisplayGroupStatus = "pending" | "in_progress" | "completed" | "failed" | "skipped";
+interface ExecutionStatusStep {
+  sequence: number;
+  stepType: string;
+  status: "pending" | "in_progress" | "completed" | "failed" | "skipped";
+  attempt: number;
+  startedAt: string | null;
+  completedAt: string | null;
+  errorReason: string | null;
+  /** Venue legs this step funds or executes; join to `orders[].orderId`. */
+  orderIds: string[];
+  /** Display class. `internal` steps are not meant to be rendered. */
+  kind: ExecutionDisplayStepKind;
+  /** Steps sharing a groupId render as ONE row. */
+  groupId: string;
+  /** Rolled-up status for the group; identical on every member. */
+  groupStatus: ExecutionDisplayGroupStatus;
+  /** Row copy, phrased for the current `groupStatus`. */
+  label: string;
+  /** Set on `kind: "bridge"` only. */
+  bridge?: {
+    amount: string;
+    tokenSymbol: string;
+    fromChain: string;
+    toChain: string;
+  };
+}
+interface ExecutionStatusOrder {
+  orderId: string;
+  venue: string;
+  status: string;
+  event: "filled" | "partial_fill" | "failed" | null;
+  filledAmountRaw?: string;
+  remainingAmountRaw?: string;
+  quotedSharesRaw?: string;
+  actualSharesRaw?: string;
+  quotedToWinRaw?: string;
+  actualToWinRaw?: string;
+  quotedPriceRaw?: string;
+  executionPriceRaw?: string;
+  partialFillReason?: string;
+  errorReason?: string;
+  venueOrderId?: string;
+  txHash?: string;
+  /** The venue matched the order and its fill awaits venue confirmation. Not a fill. */
+  matchedAt?: string;
+  updatedAt: string;
+}
+interface ExecutionStatusResponse {
+  executionId: string | null;
+  quoteId: string;
+  orderIds: string[];
+  overallState: ExecutionOverallState;
+  terminal: boolean;
+  errorReason: string | null;
+  pollAfterMs: number | null;
+  dagProgress: ExecutionDagProgress | null;
+  steps: ExecutionStatusStep[];
+  orders: ExecutionStatusOrder[];
+  /**
+   * What this run is waiting to be signed, mirroring the fill response's
+   * field of the same name. This is the polling route `fillSelfCustody` reads
+   * while an on-chain step is in flight — a caller polling this route for
+   * progress learns about newly-parked steps here too, not just from the
+   * signatures endpoint.
+   */
+  pendingSignatures?: SignatureRequest[];
+}
+type ExecutionPositionsQuery = GetPositionsQuery & {
+  mode?: ExecutionMode;
+};
+type ExecutionPositionGroup = PositionGroup;
+/** Whose cash to return: the managed server wallet (default) or the account's linked wallets. */
+type BalanceCustody = "managed" | "self";
+type ManagedBalancesParams = {
+  mode?: ExecutionMode;
+  custody?: BalanceCustody;
+};
+type ManagedBalancesResponse = UnifiedBalanceResponse;
+interface PaperTradingAppOptions {
+  /** App ID for the paper account namespace. Defaults to AggClient appId. */
+  appId?: string;
+}
+interface PaperTradingListParams {
+  limit?: number;
+  cursor?: string;
+}
+interface PaperTradingAccountListParams extends PaperTradingListParams {
+  externalId?: 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;
@@ -4342,6 +5050,8 @@ type UserAuthResult = {
   user: UserProfile;
 };
 declare class AggClient {
+  private readonly venueEventReads;
+  private eventReadSession;
   private _appId?;
   private adminKey?;
   private apiKey?;
@@ -4355,6 +5065,7 @@ declare class AggClient {
   private readonly webSocketAuthCleanups;
   /** Sockets bound to this session. The browser provider keeps one. */
   private readonly tradeSockets;
+  private readonly signatureWaitListeners;
   /** Token already sent on the open trade socket. Submit must not send it again. */
   private tradeAuthSentForToken?;
   /** User id from the latest `{ type: "authenticated" }` on the trade socket. */
@@ -4408,8 +5119,10 @@ declare class AggClient {
   setAccessToken(token: string): void;
   /** Set the current auth session tokens and optionally seed the user profile. */
   setSession(session: AggClientSessionInput): void;
+  private applySession;
   /** Clear the user access token, refresh token, and user info. Broadcasts cross-tab logout. */
   clearAccessToken(): void;
+  private invalidateEventReadSession;
   private broadcastAuth;
   /**
    * The App this client speaks for, or `undefined` for an admin-key-only
@@ -4821,709 +5534,238 @@ declare class AggClient {
     to: number;
     countBack?: number;
   }, options?: {
-    signal?: AbortSignal;
-    decode?: (payload: string) => Promise<ChartBarsResponse>;
-  }): Promise<ChartBarsResponse>;
-  getChartHistoryManifest(params: {
-    venueMarketOutcomeId: string;
-    resolution?: ChartResolution;
-    from?: number;
-    to: number;
-    countBack?: number;
-  }, options?: {
-    signal?: AbortSignal;
-  }): Promise<ChartHistoryManifest>;
-  /** Get live per-venue orderbooks for the explicit venueMarketIds requested. */
-  getOrderbooks(params: {
-    venueMarketIds: string[];
-    depth?: number;
-  }, options?: {
-    signal?: AbortSignal;
-  }): Promise<BatchOrderbooksResponse>;
-  /** Get live midpoints for the explicit venueMarketIds requested. */
-  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?: {
-    depth?: number;
-    signal?: AbortSignal;
-  }): Promise<OutcomeOrderbookResponse | null>;
-  /**
-   * Compute optimal order routing across venues via the MILP solver.
-   * Returns a user-scoped quote with per-venue fills and verification timing.
-   * Deprecated aliases are accepted for source compatibility during the
-   * outcome-level migration window.
-   */
-  getSmartRoute(params: SmartRouteParams, options?: {
-    signal?: AbortSignal;
-  }): Promise<SmartRouteResponse>;
-  /** Seed subscribed outcomes with one bounded batch of compatible snapshots. */
-  getOutcomeOrderbooks(params: {
-    venueMarketOutcomeIds: string[];
-    depth?: number;
-  }, options?: {
-    signal?: AbortSignal;
-  }): Promise<{
-    data: (OutcomeOrderbookResponse | null)[];
-  }>;
-  /**
-   * Create an AggWebSocket instance configured with this client's appId and current auth session.
-   * Session changes update this socket until it or the client is destroyed.
-   * Requires `wsUrl` to be set in the client options.
-   */
-  createWebSocket(callbacks?: AggWebSocketCallbacks, options?: {
-    enableLogs?: boolean;
-    /**
-     * Checks books with no update for 5 minutes against
-     * `GET /orderbooks/outcomes` and heals any that drifted. On by default;
-     * pass `false` to disable or an object to tune the timings.
-     */
-    bookWatchdog?: false | Pick<BookWatchdogOptions, "silenceMs" | "checkIntervalMs">;
-    /**
-     * WebSocket implementation for runtimes without a global one (e.g. the
-     * `ws` package on Node < 22). Node 22+ and browsers need nothing here.
-     */
-    webSocketImpl?: AggWebSocketOptions["webSocketImpl"];
-  }): AggWebSocket;
-  private openTradeSockets;
-  /**
-   * User events are registered by `{ action: "authenticate" }`, not a channel
-   * subscribe. The confirmation is `{ type: "authenticated" }`. Send that
-   * frame only when the socket is already open and it has not been sent for
-   * this token. Opening a socket here would lose the fill to the handshake.
-   */
-  private confirmTradeSockets;
-  private bindWebSocketAuth;
-  /** Execute a previously quoted managed trade. Returns pending order IDs. */
-  executeManaged(params: ExecuteManagedParams): Promise<ExecuteManagedResponse>;
-  /** Submit signatures for a parked fill. Returns whatever is still outstanding. */
-  submitFillSignatures(quoteId: string, signatures: Array<{
-    stepId: string;
-    signature?: string;
-    txHash?: string;
-  }>): Promise<ExecuteManagedResponse & {
-    accepted?: number;
-  }>;
-  /**
-   * Execute a quote in self-custodial mode.
-   *
-   * Identical to `executeManaged` when the server can sign for the user. When
-   * it cannot, the DAG parks on a signature request instead — but that park
-   * always happens asynchronously, in the trade-executor process, so it can
-   * never show up on this `POST /execution/fill` response itself. This
-   * drives the round trip from there: poll `getExecutionStatus` while an
-   * on-chain step is in flight, sign whatever it hands back with the
-   * configured `signer`, post the signatures back, and repeat until the
-   * server reports nothing outstanding and the run reaches a terminal state.
-   *
-   * `options.signer` overrides the configured `signer` for this call, for an
-   * app whose wallet signer lives outside the client (a React provider).
-   */
-  fillSelfCustody(params: ExecuteManagedParams, options?: {
-    signer?: SignerFn;
-  }): Promise<ExecuteManagedResponse>;
-  /**
-   * Enqueue a limit order. For self-custody, poll getExecutionStatus with the
-   * returned quoteId and answer pending requests through submitFillSignatures.
-   * A pending response does not mean the order has reached the venue.
-   */
-  placeLimitOrder(params: PlaceLimitOrderParams): Promise<PlaceLimitOrderResponse>;
-  /**
-   * Place a market order directly on a named venue — no prior quote needed.
-   * Always produces exactly one order. `externalId` is required and unique
-   * within your app — two different users of the same app cannot share one —
-   * so retrying a timed-out call with the same value is safe.
-   */
-  placeOrder(params: PlaceOrderParams): Promise<PlaceOrderResponse>;
-  /** Redeem resolved winning positions by venue market outcome ids. */
-  redeem(body: RedeemRequest): Promise<RedeemResponse>;
-  /**
-   * Redeem a resolved position held in a self-custody wallet. The server runs
-   * it as a sell fill on the resolved market, so this quotes the sell and
-   * drives `fillSelfCustody`. The same call works for every venue; the
-   * configured `signer` sees a `transaction` (user pays gas) or one typed-data
-   * signature (Polymarket, gasless). `options.signer` overrides it for this
-   * call, as in `fillSelfCustody`.
-   */
-  redeemSelfCustody(params: RedeemSelfCustodyParams, options?: {
-    signer?: SignerFn;
-  }): Promise<ExecuteManagedResponse>;
-  /** List the authenticated user's managed balance refill policies. */
-  getBalanceRefillPolicies(): Promise<BalanceRefillPolicy[]>;
-  /** Create a managed-USDC refill policy for a target chain. */
-  createBalanceRefillPolicy(params: CreateBalanceRefillPolicyParams): Promise<BalanceRefillPolicy>;
-  /** Update thresholds or pause/resume an existing balance refill policy. */
-  updateBalanceRefillPolicy(policyId: string, params: UpdateBalanceRefillPolicyParams): Promise<BalanceRefillPolicy>;
-  /** Return the 25 most recent attempts for a refill policy. */
-  getBalanceRefillAttempts(policyId: string): Promise<BalanceRefillAttempt[]>;
-  /** 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>;
-  /** Quote maximum deliverable withdrawal amount for a token and destination chain. */
-  getWithdrawalQuote(params: WithdrawalQuoteParams): Promise<WithdrawalQuoteResponse>;
-  /**
-   * Read the current persisted state of a withdrawal. Used as a backfill for
-   * the WS lifecycle channel: the client polls this on hook mount and on WS
-   * reconnect to recover events that fired before the listener was attached
-   * or while the socket was disconnected. Same response shape as
-   * `withdrawManaged`.
-   */
-  getWithdrawalStatus(withdrawalId: string): Promise<WithdrawManagedResponse>;
-  /** Trigger an on-chain balance sync for all tracked tokens across all chains. */
-  syncManagedBalances(): Promise<SyncBalancesResponse>;
-  /** Get managed wallet deposit addresses (EVM + Solana). Returns 202 shape while provisioning. */
-  getDepositAddresses(options?: {
-    signal?: AbortSignal;
-  }): 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, options?: {
-    signal?: AbortSignal;
-  }): Promise<PaginatedResponse<PositionGroup>>;
-  /** Get crypto purchase quotes. */
-  getRampQuotes(params: RampQuoteRequest): Promise<RampQuote[]>;
-  /** Create a ramp widget session for checkout. */
-  createRampSession(params: RampSessionRequest): Promise<RampWidgetSession>;
-  /** Authoritative shared Novig/ProphetX KYC status for the current managed wallet. */
-  getSharedKycStatus(): Promise<{
-    verified: boolean;
-  }>;
-  /** Start shared KYC; already-verified wallets need no redirect. Kalshi v2 is not applicable. */
-  initiateKyc(venue: string, redirectUri: string): Promise<{
-    status: string;
-    kycUrl?: string;
-  }>;
-}
-//#endregion
-//#region src/best-split.d.ts
-declare const computeBestSplitsByAmount: typeof computeBestSplitsByAmount$1;
-//#endregion
-//#region src/ws-types.d.ts
-/**
- * WebSocket protocol types for the Agg platform.
- * All callback timestamps are in **seconds** (converted from server ms at SDK dispatch).
- * These are plain TS interfaces — no Zod dependency for partner-side usage.
- */
-/** Aggregated level wire format: [price, totalSize, {venue: sizeAtPrice}] */
-type WsAttributedLevel = [number, number, Record<string, number>];
-/** Per-venue level wire format: [price, size] */
-type WsVenueLevel = [number, number];
-interface WsVenueInfo {
-  bestBid: number | null;
-  bestAsk: number | null;
-}
-interface WsVenueBook {
-  bids: WsVenueLevel[];
-  asks: WsVenueLevel[];
-}
-interface WsOrderbookSnapshot {
-  type: "orderbook_snapshot";
-  outcomeId: string;
-  channel?: "orderbook" | "trades";
-  seq: number;
-  checksum: number;
-  bids: WsAttributedLevel[];
-  asks: WsAttributedLevel[];
-  venueOrderbooks: Record<string, WsVenueBook>;
-  venues: Record<string, WsVenueInfo>;
-  midpoint: number | null;
-  spread: number | null;
-  /** @unit seconds (converted from server ms) */
-  timestamp: number;
-  /**
-   * Sticky tick of this outcome's book, inferred at runtime by the engine.
-   * `null` until inferred. Optional — older snapshot producers (REST fallback)
-   * may omit this field entirely.
-   */
-  tick?: number | null;
-  /** Provenance of the published `midpoint`. See {@link MarkSource}. */
-  markSource?: MarkSource;
-}
-/**
- * Provenance tag for a published midpoint. Mirrors the Rust engine
- * `MarkSource::as_str()` output.
- */
-type WsMarkSource = "local" | "local_merged" | "local_one_sided" | "sibling" | "local_boundary" | "none";
-type MarkSource = WsMarkSource;
-interface WsOrderbookDelta {
-  type: "orderbook_delta";
-  outcomeId: string;
-  channel?: "orderbook" | "trades";
-  seq: number;
-  checksum: number;
-  bidChanges: WsAttributedLevel[];
-  askChanges: WsAttributedLevel[];
-  venueDeltaBooks: Record<string, {
-    bidChanges: WsVenueLevel[];
-    askChanges: WsVenueLevel[];
-  }>;
-  venues: Record<string, WsVenueInfo>;
-  midpoint: number | null;
-  spread: number | null;
-  /** @unit seconds (converted from server ms) */
-  timestamp: number;
-}
-interface WsTrade {
-  type: "trade";
-  outcomeId: string;
-  channel?: "orderbook" | "trades";
-  venue: string;
-  side: "buy" | "sell";
-  price: number;
-  size: number;
-  /** @unit seconds (converted from server ms) */
-  timestamp: number;
-  /** Venue-unique trade id, when the venue supplies one (Hyperliquid today). */
-  tradeId?: string;
-}
-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[];
-  /** Confirmed marketIds — only set on `arb` confirmations, whose
-   *  subscriptions are keyed by marketIds, not outcomeIds. */
-  marketIds?: string[];
-  channel: "orderbook" | "trades" | "arb" | "arb-feed" | "app-events";
-  /** Echo of the request's `id`, when one was sent. */
-  id?: string | number;
-}
-interface WsUnsubscribed {
-  type: "unsubscribed";
-  /** See {@link WsSubscribed.outcomeIds}. */
-  outcomeIds: string[];
-  /** Confirmed marketIds — only set on `arb` confirmations. */
-  marketIds?: string[];
-  channel: "orderbook" | "trades" | "arb" | "arb-feed" | "app-events";
-  id?: string | number;
-}
-interface WsConnected {
-  type: "connected";
-  appId: string;
-  userId?: string;
-  /** Protocol revision. 2 adds error codes, request ids, event ids and resume. */
-  protocolVersion?: number;
-  /** `key` when admitted by `x-app-api-key`, `browser` when admitted by Origin. */
-  auth?: "browser" | "key";
-}
-interface WsAuthenticated {
-  type: "authenticated";
-  userId: string;
-  /** Token expiry (Unix ms). Re-authenticate before it, or user events stop. */
-  expiresAt?: number;
-  id?: string | number;
-}
-/** Sent about a minute before the user token expires. */
-interface WsAuthExpiring {
-  type: "auth_expiring";
-  userId: string;
-  /** @unit milliseconds */
-  expiresAt: number;
-}
-/**
- * The user session ended and the connection continues at app level: market
- * data keeps flowing, user events stop until you `authenticate` again.
- */
-interface WsAuthExpired {
-  type: "auth_expired";
-  userId: string;
-  reason: "expired" | "revoked" | "suspended";
-}
-/**
- * End of a resume replay. When `complete` is false, events may have been
- * missed (outside the retention window, or the log was unavailable):
- * reconcile orders, balances and withdrawals over REST.
- */
-interface WsResumed {
-  type: "resumed";
-  stream: "user" | "app";
-  fromEventId: string;
-  replayed: number;
-  complete: boolean;
-  id?: string | number;
-}
-/**
- * Upstream delivery was interrupted; frames on `channels` may be missing.
- * Orderbooks are resnapshotted automatically; trades and arb updates in the
- * gap are not recoverable.
- */
-interface WsStreamInterrupted {
-  type: "stream_interrupted";
-  channels: string[];
-  timestamp: number;
-}
-interface WsHeartbeat {
-  type: "heartbeat";
-  /** @unit seconds (converted from server ms) */
-  ts: number;
-}
-interface WsResolvedOutcome {
-  label: string;
-  winner?: boolean;
-  externalIdentifier?: string;
+    signal?: AbortSignal;
+    decode?: (payload: string) => Promise<ChartBarsResponse>;
+  }): Promise<ChartBarsResponse>;
+  getChartHistoryManifest(params: {
+    venueMarketOutcomeId: string;
+    resolution?: ChartResolution;
+    from?: number;
+    to: number;
+    countBack?: number;
+  }, options?: {
+    signal?: AbortSignal;
+  }): Promise<ChartHistoryManifest>;
+  /** Get live per-venue orderbooks for the explicit venueMarketIds requested. */
+  getOrderbooks(params: {
+    venueMarketIds: string[];
+    depth?: number;
+  }, options?: {
+    signal?: AbortSignal;
+  }): Promise<BatchOrderbooksResponse>;
+  /** Get live midpoints for the explicit venueMarketIds requested. */
+  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?: {
+    depth?: number;
+    signal?: AbortSignal;
+  }): Promise<OutcomeOrderbookResponse | null>;
   /**
-   * Per-share USDC payout in [0, 1] once settled. A void or split pays less
-   * than 1 on every side (e.g. 0.5), so `winner` alone can't tell it from a
-   * win. Absent when unknown.
+   * Compute optimal order routing across venues via the MILP solver.
+   * Returns a user-scoped quote with per-venue fills and verification timing.
+   * Deprecated aliases are accepted for source compatibility during the
+   * outcome-level migration window.
    */
-  payoutPerShare?: number;
-  /** Venue refunded every holder their stake (valued at entry price). */
-  refundAtCost?: boolean;
-  /** Who decided `winner`: the venue itself, or inferred from matched markets. */
-  winnerSource?: "venue" | "matched";
-}
-interface WsMarketResolved {
-  type: "market_resolved";
-  outcomeId: string;
-  status: "resolved" | "closed";
-  /** Winning outcome label, or null if unknown. */
-  result: string | null;
-  /** Per-outcome resolution data. */
-  outcomes: WsResolvedOutcome[];
-  /** @unit seconds (converted from server ms) */
-  timestamp: number;
-}
-/** Machine-readable error codes. Branch on `code`, not on `message`. */
-type WsErrorCode = "missing_app_id" | "invalid_app" | "origin_not_allowed" | "api_key_required" | "invalid_api_key" | "invalid_token" | "token_app_mismatch" | "admin_token_not_allowed" | "too_many_connections" | "rate_limited" | "invalid_message" | "too_many_ids" | "subscription_limit" | "outcomes_blocked" | "not_subscribed" | "snapshot_unavailable" | "app_events_forbidden" | "internal_error";
-interface WsError {
-  type: "error";
-  /** Absent only on servers older than protocol version 2. */
-  code?: WsErrorCode;
-  message: string;
-  /** Echo of the `id` of the request that caused the error. */
-  id?: string | number;
-  /** Outcome ids the error applies to. */
-  outcomeIds?: string[];
-  /** Market ids the error applies to (arb). */
-  marketIds?: string[];
-}
-interface WsOrderSubmitted {
-  type: "order_submitted";
-  venue: string;
-  orderId: string;
-  side: string;
-  price: number;
-  size: number;
-  outcomeId?: string;
-  marketId?: string;
-  /** @unit seconds (converted from server ms) */
-  timestamp: number;
-  /** Owner of the event. */
-  userId?: string;
+  getSmartRoute(params: SmartRouteParams, options?: {
+    signal?: AbortSignal;
+  }): Promise<SmartRouteResponse>;
+  /** Seed subscribed outcomes with one bounded batch of compatible snapshots. */
+  getOutcomeOrderbooks(params: {
+    venueMarketOutcomeIds: string[];
+    depth?: number;
+  }, options?: {
+    signal?: AbortSignal;
+  }): Promise<{
+    data: (OutcomeOrderbookResponse | null)[];
+  }>;
   /**
-   * Position in the stream named by `stream` (`user` or `app`). Increasing
-   * per stream; the SDK resumes from the last one after a reconnect and
-   * drops duplicates. Absent if the server's event log was unavailable.
+   * Catalog changes (events and markets created, changed or deleted) after
+   * `since`, oldest first, one item per entity with its current state. Page
+   * with `nextCursor` until `hasMore` is false. Positions older than 24h
+   * throw an {@link AggApiError} with status 410 and code `resync_required`
+   * (see `isCatalogResyncRequired`). Most callers want {@link watchCatalog}.
    */
-  eventId?: string;
-  stream?: "user" | "app";
-  /** True when re-delivered by a resume. */
-  replayed?: boolean;
-}
-interface WsBalanceUpdate {
-  type: "balance_update";
-  venue: string;
-  tradingBalanceCents: number;
-  walletBalanceCents?: number;
-  /** @unit seconds (converted from server ms) */
-  timestamp: number;
-  /** Owner of the event. */
-  userId?: string;
+  getCatalogChanges(params: GetCatalogChangesParams, options?: {
+    signal?: AbortSignal;
+  }): Promise<CatalogChangesPage>;
   /**
-   * Position in the stream named by `stream` (`user` or `app`). Increasing
-   * per stream; the SDK resumes from the last one after a reconnect and
-   * drops duplicates. Absent if the server's event log was unavailable.
+   * Keep a copy of the catalog in sync from `since`: subscribes to the live
+   * `catalog` channel, catches up over `GET /catalog/changes` (from the last
+   * applied `changedAt` minus `overlapMs`) on every (re)subscribe and stream
+   * interruption, and delivers each entity's newer state once to `onChange`.
+   *
+   * Persist `handle.lastChangedAt` and pass it back as `since` to resume
+   * after a restart. When that is older than 24h, `onResyncRequired` fires:
+   * re-list with the list endpoints, then call `handle.resync(startOfReList)`.
+   *
+   * Without `socket`, opens a dedicated app-level connection (requires
+   * `wsUrl`) that `stop()` closes.
    */
-  eventId?: string;
-  stream?: "user" | "app";
-  /** True when re-delivered by a resume. */
-  replayed?: boolean;
-}
-type WsOrderEventType = "cancelled" | "created" | "signed" | "pending_bridge" | "bridge_complete" | "submitting" | "submitted" | "expired" | "dag_started" | "dag_completed" | "dag_failed" | "dag_cancelled" | "step_started" | "step_completed" | "step_waiting" | "step_failed" | "step_retrying" | "filled" | "partial_fill" | "failed" | "bridge_ws_subscribed" | "bridge_ws_subscribe_failed" | "bridge_polling_fallback";
-interface WsOrderEvent {
-  type: "order_event";
-  event: WsOrderEventType;
-  userId: string;
-  orderId: string;
-  /** Partner trade id from `placeOrder()`, when the order carried one. */
-  externalId?: string;
-  venue: string;
-  dagRunId?: string;
-  stepId?: string;
-  stepType?: string;
-  /** 1-based step index. Pair with `totalSteps` to render "Step 3 of 7". */
-  sequence?: number;
-  totalSteps?: number;
-  templateName?: string;
-  /** Maps sequence → stepType for all steps — sent on dag_started so labels are available upfront. */
-  stepTypes?: Record<number, string>;
-  filledAmountRaw?: string;
-  remainingAmountRaw?: string;
+  watchCatalog(options: WatchCatalogOptions & {
+    /** WebSocket implementation for the dedicated connection (e.g. `ws` on Node < 22). */
+    webSocketImpl?: AggWebSocketOptions["webSocketImpl"];
+  }): CatalogWatchHandle;
   /**
-   * Quote-time and actual shares + payout. All 6-decimal atomic units
-   * (so 1.234567 shares = "1234567", "$50 to win" = "50000000"). Set
-   * on `filled` / `partial_fill` so the UI can render "Quoted X / Got Y"
-   * without re-deriving from cost ÷ price (which loses precision on
-   * fractional fills and divides by zero before `executionPrice` exists).
+   * URL and handshake headers for this client's app. Server-side clients with
+   * an API key authenticate the handshake with it (the gateway then skips the
+   * browser Origin check). Never in a browser: browsers cannot set handshake
+   * headers, and keys must not ship there.
    */
-  quotedSharesRaw?: string;
-  actualSharesRaw?: string;
-  quotedToWinRaw?: string;
-  actualToWinRaw?: string;
-  /** Quote-time price (decimal string, e.g. "0.5"). Pair with `executionPriceRaw`
-   * to render the slippage diff inline. */
-  quotedPriceRaw?: string;
+  private webSocketOptions;
   /**
-   * Actual avg fill price (decimal string): `filledAmountRaw / actualSharesRaw`.
-   * A sell's is net of fee; most venues report a buy's fee separately in
-   * `actualVenueFeeRaw`. On Hyperliquid this event carries the quote; the realized
-   * price lands on the order shortly after (`GET /execution/orders`).
+   * Create an AggWebSocket instance configured with this client's appId and current auth session.
+   * Session changes update this socket until it or the client is destroyed.
+   * Requires `wsUrl` to be set in the client options.
    */
-  executionPriceRaw?: string;
+  createWebSocket(callbacks?: AggWebSocketCallbacks, options?: {
+    enableLogs?: boolean;
+    /**
+     * Checks books with no update for 5 minutes against
+     * `GET /orderbooks/outcomes` and heals any that drifted. On by default;
+     * pass `false` to disable or an object to tune the timings.
+     */
+    bookWatchdog?: false | Pick<BookWatchdogOptions, "silenceMs" | "checkIntervalMs">;
+    /**
+     * WebSocket implementation for runtimes without a global one (e.g. the
+     * `ws` package on Node < 22). Node 22+ and browsers need nothing here.
+     */
+    webSocketImpl?: AggWebSocketOptions["webSocketImpl"];
+  }): AggWebSocket;
+  private openTradeSockets;
   /**
-   * Set on `partial_fill` events only. One of `"venue_capacity"`,
-   * `"price_slipped"`, `"user_cancelled"`, `"timeout"`, `"bridge_short"`,
-   * or a venue-specific tag.
+   * User events are registered by `{ action: "authenticate" }`, not a channel
+   * subscribe. The confirmation is `{ type: "authenticated" }`. Send that
+   * frame only when the socket is already open and it has not been sent for
+   * this token. Opening a socket here would lose the fill to the handshake.
    */
-  partialFillReason?: string;
-  errorReason?: string;
-  attempt?: number;
-  correlationId?: string;
-  /** @unit milliseconds (raw from server — NOT converted like other WS types) */
-  timestamp: number;
+  private confirmTradeSockets;
+  private bindWebSocketAuth;
+  /** Execute a previously quoted managed trade. Returns pending order IDs. */
+  executeManaged(params: ExecuteManagedParams): Promise<ExecuteManagedResponse>;
+  /** Submit signatures for a parked fill. Returns whatever is still outstanding. */
+  submitFillSignatures(quoteId: string, signatures: SubmitSignature[]): Promise<ExecuteManagedResponse & {
+    accepted?: number;
+  }>;
+  /**
+   * Execute a quote in self-custodial mode.
+   *
+   * Identical to `executeManaged` when the server can sign for the user. When
+   * it cannot, the DAG parks on a signature request instead — but that park
+   * always happens asynchronously, in the trade-executor process, so it can
+   * never show up on this `POST /execution/fill` response itself. This
+   * drives the round trip from there: poll `getExecutionStatus` while an
+   * on-chain step is in flight, sign whatever it hands back with the
+   * configured `signer`, post the signatures back, and repeat until the
+   * server reports nothing outstanding and the run reaches a terminal state.
+   *
+   * `options.signer` overrides the configured `signer` for this call, for an
+   * app whose wallet signer lives outside the client (a React provider).
+   */
+  fillSelfCustody(params: ExecuteManagedParams, options?: {
+    signer?: SignerFn;
+  }): Promise<ExecuteManagedResponse>;
+  /**
+   * Enqueue a limit order. For self-custody, poll getExecutionStatus with the
+   * returned quoteId and answer pending requests through submitFillSignatures.
+   * A pending response does not mean the order has reached the venue.
+   */
+  placeLimitOrder(params: PlaceLimitOrderParams): Promise<PlaceLimitOrderResponse>;
+  /**
+   * Place a market order directly on a named venue — no prior quote needed.
+   * Always produces exactly one order. `externalId` is required and unique
+   * within your app — two different users of the same app cannot share one —
+   * so retrying a timed-out call with the same value is safe.
+   */
+  placeOrder(params: PlaceOrderParams): Promise<PlaceOrderResponse>;
+  /** Redeem resolved winning positions by venue market outcome ids. */
+  redeem(body: RedeemRequest): Promise<RedeemResponse>;
+  /**
+   * Redeem a resolved position held in a self-custody wallet. The server runs
+   * it as a sell fill on the resolved market, so this quotes the sell and
+   * drives `fillSelfCustody`. The same call works for every venue; the
+   * configured `signer` sees a `transaction` (user pays gas) or one typed-data
+   * signature (Polymarket, gasless). `options.signer` overrides it for this
+   * call, as in `fillSelfCustody`.
+   */
+  redeemSelfCustody(params: RedeemSelfCustodyParams, options?: {
+    signer?: SignerFn;
+  }): Promise<ExecuteManagedResponse>;
+  /** List the authenticated user's managed balance refill policies. */
+  getBalanceRefillPolicies(): Promise<BalanceRefillPolicy[]>;
+  /** Create a managed-USDC refill policy for a target chain. */
+  createBalanceRefillPolicy(params: CreateBalanceRefillPolicyParams): Promise<BalanceRefillPolicy>;
+  /** Update thresholds or pause/resume an existing balance refill policy. */
+  updateBalanceRefillPolicy(policyId: string, params: UpdateBalanceRefillPolicyParams): Promise<BalanceRefillPolicy>;
+  /** Return the 25 most recent attempts for a refill policy. */
+  getBalanceRefillAttempts(policyId: string): Promise<BalanceRefillAttempt[]>;
+  /** Withdraw funds from managed wallets to an external address. */
+  withdrawManaged(params: WithdrawManagedParams): Promise<WithdrawManagedResponse>;
+  /** Submit signatures for a parked self-custody withdrawal. Returns whatever is still outstanding. */
+  submitWithdrawalSignatures(withdrawalId: string, signatures: SubmitSignature[]): Promise<WithdrawManagedResponse>;
   /**
-   * Position in the stream named by `stream` (`user` or `app`). Increasing
-   * per stream; the SDK resumes from the last one after a reconnect and
-   * drops duplicates. Absent if the server's event log was unavailable.
+   * 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.
    */
-  eventId?: string;
-  stream?: "user" | "app";
-  /** True when re-delivered by a resume. */
-  replayed?: boolean;
-}
-interface WsRedeemEvent {
-  type: "redeem_event";
-  redeemId: string;
-  venueMarketOutcomeId: string;
-  status: "submitted" | "confirmed" | "failed";
-  callsId: string | null;
-  pendingUserOpId: string | null;
-  txHash: string | null;
-  errorMessage: string | null;
-  /** @unit seconds (converted from server ms) */
-  timestamp: number;
-  /** Owner of the event. */
-  userId?: string;
+  withdrawPreview(params: WithdrawPreviewParams): Promise<WithdrawPreviewResponse>;
+  /** Quote maximum deliverable withdrawal amount for a token and destination chain. */
+  getWithdrawalQuote(params: WithdrawalQuoteParams): Promise<WithdrawalQuoteResponse>;
   /**
-   * Position in the stream named by `stream` (`user` or `app`). Increasing
-   * per stream; the SDK resumes from the last one after a reconnect and
-   * drops duplicates. Absent if the server's event log was unavailable.
+   * 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
+   * reconnect to recover events that fired before the listener was attached
+   * or while the socket was disconnected. Same response shape as
+   * `withdrawManaged`.
    */
-  eventId?: string;
-  stream?: "user" | "app";
-  /** True when re-delivered by a resume. */
-  replayed?: boolean;
-}
-/** Top-level withdrawal lifecycle states surfaced to partner clients. */
-type WsWithdrawalLifecycleStatus = "pending" | "bridging" | "transferring" | "completed" | "partial" | "failed";
-type WsWithdrawalLegStatus = "planned" | "submitted" | "confirmed" | "failed";
-interface WsWithdrawalLifecycleLeg {
-  sourceChainId: number;
-  destChainId: number;
-  type: "transfer" | "bridge";
-  status: WsWithdrawalLegStatus;
-  amountRaw: string;
-  txHash: string | null;
-  bridgeOperationId: string | null;
-  /** Human-readable failure reason when `status === "failed"`. Null/absent when succeeded or in-flight. */
-  errorMessage?: string | null;
-}
-/**
- * Per-withdrawal lifecycle event. Wire shape is intentionally additive:
- * consumers should pass through unknown enum values rather than failing.
- */
-interface WsWithdrawalLifecycleEvent {
-  type: "withdrawal_lifecycle";
-  withdrawalId: string;
-  userId: string;
-  status: WsWithdrawalLifecycleStatus;
-  /** Requested withdrawal amount in destination-token native decimals. */
-  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. */
-  leg?: WsWithdrawalLifecycleLeg;
-  /** All legs at the moment of emission (snapshot). */
-  legs?: WsWithdrawalLifecycleLeg[];
-  /** Failure reason for terminal `failed` / `partial`. */
-  errorMessage?: string;
-  correlationId?: string;
-  /** @unit milliseconds (raw from server — NOT converted like other WS types) */
-  timestamp: number;
+  getWithdrawalStatus(withdrawalId: string): Promise<WithdrawManagedResponse>;
+  /** Trigger an on-chain balance sync for all tracked tokens across all chains. */
+  syncManagedBalances(): Promise<SyncBalancesResponse>;
+  /** Get managed wallet deposit addresses (EVM + Solana). Returns 202 shape while provisioning. */
+  getDepositAddresses(options?: {
+    signal?: AbortSignal;
+  }): Promise<DepositAddressesResponse>;
   /**
-   * Position in the stream named by `stream` (`user` or `app`). Increasing
-   * per stream; the SDK resumes from the last one after a reconnect and
-   * drops duplicates. Absent if the server's event log was unavailable.
+   * 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.
    */
-  eventId?: string;
-  stream?: "user" | "app";
-  /** True when re-delivered by a resume. */
-  replayed?: boolean;
-}
-interface WsArbMarketUpdate {
-  type: "arb_market_update";
-  marketId: string;
-  /** Producer assertion that globally inactive venues were excluded. */
-  activeVenuesOnly: true;
-  venueEventId: string | null;
-  arbReturn: number;
-  ts: number;
-  liquidityUsd?: number;
-  liquidityTier?: "deep" | "shallow";
-}
-interface WsArbFeedEntry {
-  marketId: string;
-  venueEventId: string | null;
-  arbReturn: number;
-  ts: number;
-  liquidityUsd?: number;
-  liquidityTier?: "deep" | "shallow";
-}
-interface WsArbFeedBatch {
-  type: "arb_feed_batch";
-  feed: "arb";
-  /** Producer assertion that globally inactive venues were excluded. */
-  activeVenuesOnly: true;
-  entries: WsArbFeedEntry[];
-  flushTs: number;
-  chunk: number;
-  chunkCount: number;
+  recordDepositIntent(body: {
+    chainId: number;
+    txHash: string;
+  }): Promise<void>;
+  /** Get open positions grouped by matched market with per-venue breakdown. */
+  getPositions(params?: GetPositionsParams, options?: {
+    signal?: AbortSignal;
+  }): Promise<PaginatedResponse<PositionGroup>>;
+  /** Get crypto purchase quotes. */
+  getRampQuotes(params: RampQuoteRequest): Promise<RampQuote[]>;
+  /** Create a ramp widget session for checkout. */
+  createRampSession(params: RampSessionRequest): Promise<RampWidgetSession>;
+  /** Authoritative shared Novig/ProphetX KYC status for the current managed wallet. */
+  getSharedKycStatus(): Promise<{
+    verified: boolean;
+  }>;
+  /** Start shared KYC; already-verified wallets need no redirect. Kalshi v2 is not applicable. */
+  initiateKyc(venue: string, redirectUri: string): Promise<{
+    status: string;
+    kycUrl?: string;
+  }>;
 }
-type WsServerMessage = WsOrderbookSnapshot | WsOrderbookDelta | WsTrade | WsSubscribed | WsUnsubscribed | WsConnected | WsAuthenticated | WsHeartbeat | WsMarketResolved | WsError | WsOrderSubmitted | WsBalanceUpdate | WsOrderEvent | WsRedeemEvent | WsWithdrawalLifecycleEvent | WsArbMarketUpdate | WsArbFeedBatch | WsAuthExpiring | WsAuthExpired | WsResumed | WsStreamInterrupted;
-/**
- * A user event as delivered on the `app-events` channel: the raw server
- * frame (timestamps in milliseconds, not converted), always with `userId`,
- * `stream: "app"` and normally an `eventId`.
- */
-type WsAppEvent = ((Omit<WsOrderSubmitted, "timestamp"> & {
-  timestamp: number;
-}) | (Omit<WsBalanceUpdate, "timestamp"> & {
-  timestamp: number;
-}) | WsOrderEvent | (Omit<WsRedeemEvent, "timestamp"> & {
-  timestamp: number | string;
-}) | WsWithdrawalLifecycleEvent) & {
-  userId: string;
-  stream: "app";
-};
-type WsClientMessage = {
-  action: "subscribe";
-  channel: "orderbook" | "trades";
-  outcomeIds: string[];
-} | {
-  action: "unsubscribe";
-  channel: "orderbook" | "trades";
-  outcomeIds: string[];
-} | {
-  action: "resnapshot";
-  channel: "orderbook";
-  outcomeIds: string[];
-} | {
-  action: "subscribe";
-  channel: "arb";
-  marketIds: string[];
-} | {
-  action: "unsubscribe";
-  channel: "arb";
-  marketIds: string[];
-} | {
-  action: "subscribe";
-  channel: "arb-feed";
-} | {
-  action: "unsubscribe";
-  channel: "arb-feed";
-} | {
-  action: "authenticate";
-  token: string;
-  resumeFrom?: string;
-} | {
-  action: "subscribe";
-  channel: "app-events";
-  resumeFrom?: string;
-} | {
-  action: "unsubscribe";
-  channel: "app-events";
-};
-type DiagnosticEvent = {
-  type: "seq_gap";
-  marketId: string;
-  outcomeId: string;
-  expected: number;
-  received: number;
-} | {
-  type: "checksum_mismatch";
-  marketId: string;
-  outcomeId: string;
-  expected: number;
-  computed: number;
-} | {
-  type: "reconnect";
-  attempt: number;
-  delayMs: number;
-} |
-/** The server closed with a configuration error (4001/4003); the SDK does not retry. */
-{
-  type: "connection_rejected";
-  code: number;
-  reason: string;
-} | {
-  type: "stream_interrupted";
-  channels: string[];
-} | {
-  type: "stale_connection";
-  lastMessageAge: number;
-} | {
-  type: "book_watchdog_resync";
-  outcomeId: string;
-  /** null when there is no local book (its snapshot never arrived). */
-  localSeq: number | null;
-  serverSeq: number;
-  action: "resnapshot" | "resubscribe";
-} |
-/** `status` is null when the REST check failed before a response (network error or timeout). */
-{
-  type: "book_watchdog_error";
-  status: number | null;
-};
-type DiagnosticCallback = (event: DiagnosticEvent) => void;
+//#endregion
+//#region src/best-split.d.ts
+declare const computeBestSplitsByAmount: typeof computeBestSplitsByAmount$1;
 //#endregion
 //#region src/orderbook-utils.d.ts
 interface OrderbookLevel {
@@ -5995,6 +6237,8 @@ interface AggWebSocketDiagnostics {
   tradeOutcomeIds: string[];
   arbMarketIds: string[];
   arbFeedSubscribers: number;
+  /** Active `subscribeCatalog` callers. Absent on transports without catalog support. */
+  catalogSubscribers?: number;
   cachedBooks: number;
   cachedArb: number;
   resyncingBooks: number;
@@ -6048,6 +6292,19 @@ interface AggWebSocketOptions {
   /** Check silent books against REST and heal any that drifted. Off when omitted. */
   bookWatchdog?: BookWatchdogOptions;
 }
+/** Lifecycle hooks for {@link AggWebSocket.subscribeCatalog}. */
+interface CatalogSubscribeOptions {
+  /**
+   * The server confirmed this caller's filter — after the first subscribe and
+   * again after every reconnect. Frames before this may be missing: catch up
+   * over `GET /catalog/changes` from here.
+   */
+  onSubscribed?: () => void;
+  /** Upstream delivery was interrupted; frames may be missing. Catch up over REST. */
+  onInterrupted?: () => void;
+  /** The server rejected this caller's subscribe frame. */
+  onError?: (error: WsError) => void;
+}
 /**
  * Agg WebSocket client. Single WS connection with refcounted market subscriptions.
  */
@@ -6108,6 +6365,11 @@ declare class AggWebSocket {
   /** Set once a connection has been established; later connects resume. */
   private hasConnected;
   private readonly appEventCbs;
+  private readonly catalogSubs;
+  /** Union filter last sent on this connection; null when not subscribed. */
+  private catalogSentKey;
+  private catalogFrameSeq;
+  private catalogAckedSeq;
   /** Last close was a configuration error; don't reconnect until connect() is called. */
   private rejected;
   constructor(options: AggWebSocketOptions);
@@ -6140,6 +6402,25 @@ declare class AggWebSocket {
    * Returns an unsubscribe function.
    */
   subscribeArbFeed(cb: (b: WsArbFeedBatch) => void): () => void;
+  /**
+   * Subscribe to the catalog feed: new, changed and deleted events and
+   * markets. Live only — pair it with `GET /catalog/changes` (or use
+   * `AggClient.watchCatalog`, which does both).
+   *
+   * One server subscription is shared by every caller. Its filter is the
+   * union of the callers' filters (no filter when any caller has none), and
+   * each caller only receives frames matching its own filter. The subscribe
+   * is re-sent on every reconnect; `onSubscribed` fires each time the server
+   * confirms it. Returns an unsubscribe function.
+   */
+  subscribeCatalog(filter: CatalogFilter, cb: (change: WsCatalogChange) => void, opts?: CatalogSubscribeOptions): () => void;
+  /**
+   * Send the union filter if it differs from what the server holds. Callers
+   * in `confirm` wait for this frame's ack. Returns whether a frame was sent.
+   */
+  private sendCatalogSubscribe;
+  private handleCatalogAck;
+  private handleCatalogChange;
   /**
    * Subscribe to a feed by outcome ID.
    * @param outcomeId  The venueMarketOutcomeId to subscribe to.
@@ -6233,5 +6514,5 @@ declare class AggWebSocket {
   private isOrderbookDebugEnabled;
 }
 //#endregion
-export { WsAttributedLevel as $, DEFAULT_BALANCE_REFILL_DAILY_CAP_RAW as $a, SmartRouteCustodyWarning as $i, GetCryptoReferencePricesOptions as $n, ComputeSplitsResponse as $o, PaperTradingPortfolio as $r, VenueMarket as $s, BalanceCustody as $t, isAggApiError as A, VenueGeoPolicyEntry as Aa, isVenueActive as Ac, RecurringCryptoWindowMarket as Ai, CryptoReferencePriceTarget as An, formatOutcomeLabel as Ao, OPTIONAL_SIGNATURE_TIMEOUT_MS as Ar, ServerWallet as As, WsWithdrawalLifecycleStatus as At, withTimeout as B, WithdrawPreviewResponse as Ba, ResolvedCorrelatedMarketsResponse as Bi, ExecutionDagProgress as Bn, ProvisionHostedVenueAccountBody as Bo, OutcomeMidpointRow as Br, UpdateUserBody as Bs, AggClientAuthOptions as Bt, CandleBuilder as C, UserActivityRedeemLeg as Ca, RETINA_IMAGE_SIZES as Cc, RecurringCryptoOutcomeOrderbookDepth as Ci, CreateBalanceRefillPolicyParams as Cn, isNonEmptyString as Co, NewsFeedMarketFeedResponse as Cr, OrderbookHistoryResponse as Cs, WsUnsubscribed as Ct, AggApiFieldError as D, UserActivityWithdrawal as Da, VENUE_CHAIN_IDS as Dc, RecurringCryptoSourceConfidence as Di, CryptoReferencePriceMarketInput as Dn, safeParse as Do, NewsFeedPageOptions as Dr, PriceSource as Ds, WsWithdrawalLegStatus as Dt, AggApiErrorInit as E, UserActivityUserOp as Ea, VENUES as Ec, RecurringCryptoResolution as Ei, CryptoReferencePriceExternalMarketInput as En, parseEmailStrict as Eo, NewsFeedMarketNewsResult as Er, PricePoint as Es, WsVenueLevel as Et, isPostFillFeeRequest as F, VenueSoloQuote as Fa, RedeemSelfCustodyParams as Fi, DepositAddressesSupportedChain as Fn, HostedVenueActivityQuery as Fo, OrderbookQuoteFill as Fr, SetupVenueKeyStep as Fs, AggAuthProviderType as Ft, computeChecksum as G, WithdrawalLegType as Ga, SearchResponse as Gi, ExecutionOrdersQuery as Gn, AttributedOrderbook as Go, PaperTradingAppOptions as Gr, ValidateManagedRequest as Gs, AggLinkAccountResult as Gt, OrderbookState as H, WithdrawalExpected as Ha, SELF_CUSTODY_FILL_TIMEOUT_MS as Hi, ExecutionDisplayStepKind as Hn, QuoteErrorCode as Ho, PaginatedResponse as Hr, UserHolding as Hs, AggClientSessionInput as Ht, isSameWalletAddress as I, WithdrawManagedParams as Ia, RequestedOrderbookMarket as Ii, DepositAddressesToken as In, HostedVenueBalance as Io, OrderbookQuoteParams as Ir, SyncBalancesResponse as Is, AggAuthStartBody as It, DiagnosticEvent as J, WithdrawalQuoteResponse as Ja, SignatureRequestType as Ji, ExecutionPositionsQuery as Jn, AuthTokenResponse as Jo, PaperTradingLiquidityStatus as Jr, VenueEvent as Js, AggregatedOrderbookLevel as Jt, snapshotToOrderbook as K, WithdrawalLifecycleStatus as Ka, SetPaperTradingBalanceParams as Ki, ExecutionOverallState as Kn, AttributedOrderbookLevel as Ko, PaperTradingBalanceAdjustment as Kr, ValidateTradeRequest as Ks, AggLinkAccountWalletConfirmBody as Kt, orderSignatureRound as L, WithdrawManagedResponse as La, ResetPaperTradingAccountParams as Li, EventBootstrapResponse as Ln, HostedVenueDepositAddress as Lo, OrderbookQuoteResponse as Lr, TradeSplit as Ls, AggAuthStartResult as Lt, isOptionalFeeRequest as M, VenueMarketRef as Ma, isVenueInactive as Mc, RedeemLegStatus as Mi, DepositAddressesPendingResponse as Mn, HostedVenueAccount as Mo, OrderbookBatchItemError as Mr, SettlementDifference as Ms, AggClient as Mt, isOrderSignatureStep as N, VenueOrderbookEntry as Na, RedeemRequest as Ni, DepositAddressesReadyResponse as Nn, HostedVenueActivity as No, OrderbookBatchItemErrorCode as Nr, SettlementSource as Ns, AggAuthDeliveryMode as Nt, AggRateLimitResponse as O, ValidateManagedParams as Oa, Venue as Oc, RecurringCryptoVenueMarket as Oi, CryptoReferencePriceResult as On, getWalletAddressFromUserProfile as Oo, NewsFeedStatusResponse as Or, PricesHistoryResponse as Os, WsWithdrawalLifecycleEvent as Ot, isPolymarketOrderSignatureStep as P, VenuePriceInfo as Pa, RedeemResponse as Pi, DepositAddressesResponse as Pn, HostedVenueActivityCode as Po, OrderbookBatchItemStatus as Pr, SetupDepositAddressStep as Ps, AggAuthPrivyVerifyBody as Pt, WsArbMarketUpdate as Q, projectedOrderbookChecksum as Qa, SmartRouteBridgeStep as Qi, ExecutionStatusStep as Qn, ComputeSplitsRequest as Qo, PaperTradingOrdersPage as Qr, VenueKeySummary as Qs, AuthStatus as Qt, signatureTimeoutMs as R, WithdrawManagedSourceItem as Ra, ResolveCorrelatedMarketsParams as Ri, ExecuteManagedParams as Rn, HostedVenueWithdrawal as Ro, OrderbookServiceUnavailableError as Rr, TradeStep as Rs, AggAuthVerifyBody as Rt, Candle as S, UserActivityRedeem as Sa, ImageSize as Sc, RecurringCryptoOutcome as Si, CorrelatedMarketsStatus as Sn, isFiniteNonNeg as So, NewsFeedMarketFeedItem as Sr, OrderbookHistoryPoint as Ss, WsTrade as St, AggApiError as T, UserActivityType as Ta, INACTIVE_VENUES as Tc, RecurringCryptoReferencePrice as Ti, CryptoReferencePriceError as Tn, parseEmail as To, NewsFeedMarketNewsResponse as Tr, PositionGroup as Ts, WsVenueInfo as Tt, VenueOrderbookLevel as U, WithdrawalLeg as Ua, SELF_CUSTODY_POLL_INTERVAL_MS as Ui, ExecutionMode as Un, Account as Uo, PaperTradingAccount as Ur, UserProfile as Us, AggLinkAccountBody as Ut, OrderbookLevel as V, WithdrawTokenSymbol as Va, RpcTokenResponse as Vi, ExecutionDisplayGroupStatus as Vn, QuoteError as Vo, OutcomeOrderbookResponse as Vr, UpsertVenueKey as Vs, AggClientOptions as Vt, applyOrderbookDelta as W, WithdrawalLegStatus as Wa, SearchParams as Wi, ExecutionOrderItem as Wn, App as Wo, PaperTradingAccountsPage as Wr, ValidateBalanceOnClientStep as Ws, AggLinkAccountConfirmResult as Wt, WsArbFeedBatch as X, WithdrawalSourceTokenSymbol as Xa, SimpleOrderbookLevel as Xi, ExecutionStatusQuery as Xn, BookQuality as Xo, PaperTradingMarkSource as Xr, VenueEventWithMarkets as Xs, AppClientConfigResponse as Xt, WsAppEvent as Y, WithdrawalSourceStatus as Ya, SignerFn as Yi, ExecutionStatusOrder as Yn, AuthUser as Yo, PaperTradingListParams as Yr, VenueEventListItem as Ys, AggregatedOrderbookResponse as Yt, WsArbFeedEntry as Z, orderbookCrc32 as Za, SmartRouteAllocation as Zi, ExecutionStatusResponse as Zn, Category as Zo, PaperTradingOrder as Zr, VenueKeyStatus as Zs, AppTradingMode as Zt, loadImmutableHistory as _, UpdateBalanceRefillPolicyParams as _a, MatchType as _c, RecurringCryptoDurationInput as _i, CorrelatedMarketQueryResult as _n, SafeParseSuccess as _o, NewsFeedArticleFeedResponse as _r, MidpointItem as _s, WsRedeemEvent as _t, BookWatchdogOptions as a, SmartRouteSettlementPlan as aa, WalletChainBalance as ac, PlacePaperTradingOrderParams as ai, BatchOrderbooksResponse as an, LimitPriceTickAdjustment as ao, LeaderboardSeries as ar, ExecuteTradeResponse as as, WsClientMessage as at, mergeClosedCandles as b, UserActivityItem as ba, AccountType as bc, RecurringCryptoOrderbookDepthLevel as bi, CorrelatedMarketSignalBatch as bn, isEmail as bo, NewsFeedListResponse as br, OrderListItem as bs, WsStreamInterrupted as bt, MarketDataEngine as c, SmartRouteStatus as ca, WithdrawalSource as cc, RampQuote as ci, CancelVenueOrderParams as cn, buildVenueUrl as co, LeaderboardStats as cr, GetHoldingsQuery as cs, WsErrorCode as ct, createAggClient as d, SportsLiveParticipant as da, OrderType as dc, RampWidgetSession as di, ChartCandle as dn, normalizeVenueMarketCluster as do, ManagedBalancesParams as dr, GetPositionsQuery as ds, WsMarketResolved as dt, SmartRouteFeeBreakdown as ea, VenueMarketListItem as ec, PaperTradingPosition as ei, BalanceRefillAttempt as en, DEFAULT_BALANCE_REFILL_MAX_FEE_RAW as eo, GetOrdersParams as er, ComputeSplitsSelection as es, WsAuthExpired as et, HostedVenueFundingIntent as f, SportsLiveResponse as fa, TimeInForce as fc, RecurrenceCadence as fi, ChartHistoryManifest as fn, optimizedImageUrl as fo, ManagedBalancesResponse as fr, HelloResponse as fs, WsOrderEvent as ft, LoadImmutableHistoryOptions as g, TradeExecutorOrderListResponse as ga, MatchStatus as gc, RecurringCryptoDuration as gi, CorrelatedMarketCascadeResponse as gn, SafeParseResult as go, NewsFeedArticleFeedItem as gr, MatchedVenueMarketOutcomeRef as gs, WsOrderbookSnapshot as gt, prepareHostedVenueRoute as h, TradeExecutorOrder as ha, MarketStatus as hc, RecurringCryptoComparisonPriceSource as hi, CorrelatedMarketCascadeItem as hn, SafeParseFailure as ho, MidpointRow as hr, MatchedMidpointOutcome as hs, WsOrderbookDelta as ht, AggWebSocketOptions as i, SmartRouteSettlementLeg as ia, VerifyResponse as ic, PlaceLimitOrderResponse as ii, BatchMidpointsResponse as in, LimitPriceSide as io, LeaderboardRow as ir, ExecuteTradeRequest as is, WsCandleInterval as it, areOrdersFilled as j, VenueGeoPolicyResponse as ja, isVenueDataVisible as jc, RedeemLegResult as ji, CryptoReferencePricesResponse as jn, formatOutcomeTitle as jo, OrderListQuery as jr, SettlementDiff as js, computeBestSplitsByAmount as jt, TurnstileChallengeError as k, ValidateManagedResponse as ka, getEffectiveDisabledVenues as kc, RecurringCryptoWindowComparisons as ki, CryptoReferencePriceSource as kn, formatMarketQuestion as ko, OPTIONAL_FEE_SIGNATURE_TIMEOUT_MS as kr, ProphetxExecutionMode as ks, WsWithdrawalLifecycleLeg as kt, MarketView as l, SmartRouteVenueFill as la, WithdrawalSourceItem as lc, RampQuoteRequest as li, ChartBarsMeta as ln, sortVenues as lo, LimitOrderTimeInForce as lr, GetHoldingsResponse as ls, WsHeartbeat as lt, prepareHostedVenueFunding as m, TERMINAL_EXECUTION_STATES as ma, CONFIRMED_MATCH_STATUSES as mc, RecurringCryptoComparisonPoint as mi, ChartVenueCandles as mn, SplitsByAmountResult as mo, MatchedOrderbookMarket as mr, MatchedMidpoint as ms, WsOrderSubmitted as mt, AggWebSocketCallbacks as n, SmartRouteParams as na, VenuePositionBalance as nc, PersistedAuthSnapshot as ni, BalanceRefillPolicy as nn, isBalanceRefillWithinDailyCap as no, LeaderboardMetric as nr, DepositStep as ns, WsAuthenticated as nt, CandleTail as o, SmartRouteSetupCostLine as oa, WalletTokenBalance as oc, PositionRedeemStatus as oi, CancelManagedExecutionResponse as on, adjustLimitPriceRawToTick as oo, LeaderboardSeriesPoint as or, GetBalanceQuery as os, WsConnected as ot, HostedVenueFundingOptions as p, SportsLiveState as pa, TradeSide$1 as pc, RecurrenceFilter as pi, ChartResolution as pn, retinaImageUrl as po, MarkSource$1 as pr, MarketPriceHistory as ps, WsOrderEventType as pt, DiagnosticCallback as q, WithdrawalQuoteParams as qa, SignatureRequest as qi, ExecutionPositionGroup as qn, AuthCodeResponse as qo, PaperTradingBalanceResponse as qr, ValidateTradeResponse as qs, AggSessionUser as qt, AggWebSocketDiagnostics as r, SmartRouteResponse as ra, VerifyBody as rc, PlaceLimitOrderParams as ri, BalanceRefillPolicyStatus as rn, LIMIT_PRICE_RAW_SCALE as ro, LeaderboardQuery as rr, ExecuteManagedRequest as rs, WsBalanceUpdate as rt, HistoryRangeRequest as s, SmartRouteSide as sa, WithdrawManagedRequest as sc, RECURRENCE_CADENCES as si, CancelOrderSignature as sn, BuildVenueUrlOpts as so, LeaderboardSeriesQuery as sr, GetBalanceResponse as ss, WsError as st, AggWebSocket as t, SmartRouteFill as ta, VenueMarketOutcome as tc, PaperTradingPositionsPage as ti, BalanceRefillAttemptStatus as tn, getBalanceRefillMaximumRaw as to, GetPositionsParams as tr, CreateApp as ts, WsAuthExpiring as tt, MarketViewBatch as u, SportsGameStatus as ua, OrderStatus as uc, RampSessionRequest as ui, ChartBarsResponse as un, VenueMarketClusterNode as uo, ListRecurringCryptoMarketsOptions as ur, GetOrdersQuery as us, WsMarkSource as ut, aggregateMidpoint as v, UserActivityBridge as va, Chain as vc, RecurringCryptoMarketMetrics as vi, CorrelatedMarketSide as vn, enumGuard as vo, NewsFeedArticleWithSummary as vr, NonceResponse as vs, WsResumed as vt, CandleInterval as w, UserActivityTrade as wa, ACTIVE_VENUES as wc, RecurringCryptoPriceComparison as wi, CreatePaperTradingAccountParams as wn, parse as wo, NewsFeedMarketNewsParams as wr, OutcomeMidpoint as ws, WsVenueBook as wt, toChecksumAddress as x, UserActivityQuery as xa, IMAGE_SIZES as xc, RecurringCryptoOrderbookDepthSide as xi, CorrelatedMarketSignalDirection as xn, isEnum as xo, NewsFeedMarketFeedArticle as xr, Orderbook as xs, WsSubscribed as xt, mergeCandles as y, UserActivityDeposit as ya, AccountProvider as yc, RecurringCryptoMarketsResponse as yi, CorrelatedMarketSignal as yn, hasShape as yo, NewsFeedLinkedMarket as yr, NovigExecutionMode as ys, WsServerMessage as yt, userSignerAddresses as z, WithdrawPreviewParams as za, ResolveCorrelatedMarketsResponse as zi, ExecuteManagedResponse as zn, HostedVenueWithdrawalRequest as zo, OrderbooksOnlyError as zr, UnifiedBalanceResponse as zs, AggAuthWalletVerifyBody as zt };
-//# sourceMappingURL=agg-websocket-DsEtBkLk.d.mts.map
+export { AggAuthStartBody as $, WsOrderbookDelta as $a, VenueSoloQuote as $i, OrderbookQuoteParams as $n, HostedVenueActivityQuery as $o, RequestedOrderbookMarket as $r, SetupVenueKeyStep as $s, DepositAddressesToken as $t, TurnstileChallengeError as A, DiagnosticCallback as Aa, TimeInForce as Ac, SportsLiveState as Ai, MarkSource as An, optimizedImageUrl as Ao, RecurrenceFilter as Ar, HelloResponse as As, ChartResolution as At, userSignerAddresses as B, WsBalanceUpdate as Ba, ImageSize as Bc, UserActivityRedeem as Bi, NewsFeedMarketFeedResponse as Bn, isFiniteNonNeg as Bo, RecurringCryptoOutcomeOrderbookDepth as Br, OrderbookHistoryPoint as Bs, CreateBalanceRefillPolicyParams as Bt, Candle as C, CatalogChangeOp as Ca, WalletChainBalance as Cc, SmartRouteSetupCostLine as Ci, LeaderboardSeriesPoint as Cn, LimitPriceTickAdjustment as Co, PositionRedeemStatus as Cr, ExecuteTradeResponse as Cs, CancelManagedExecutionResponse as Ct, AggApiErrorInit as D, CatalogFilter as Da, WithdrawalSourceItem as Dc, SportsGameStatus as Di, ListRecurringCryptoMarketsOptions as Dn, sortVenues as Do, RampSessionRequest as Dr, GetHoldingsResponse as Ds, ChartBarsResponse as Dt, AggApiError as E, CatalogEventSnapshot as Ea, WithdrawalSource as Ec, SmartRouteVenueFill as Ei, LimitOrderTimeInForce as En, buildVenueUrl as Eo, RampQuoteRequest as Er, GetHoldingsQuery as Es, ChartBarsMeta as Et, isPolymarketOrderSignatureStep as F, WsArbMarketUpdate as Fa, MatchType as Fc, UpdateBalanceRefillPolicyParams as Fi, NewsFeedArticleWithSummary as Fn, SafeParseSuccess as Fo, RecurringCryptoMarketMetrics as Fr, MidpointItem as Fs, CorrelatedMarketSide as Ft, applyOrderbookDelta as G, WsError as Ga, VENUE_CHAIN_IDS as Gc, UserActivityWithdrawal as Gi, NewsFeedStatusResponse as Gn, safeParse as Go, RecurringCryptoVenueMarket as Gr, PriceSource as Gs, CryptoReferencePriceResult as Gt, OrderbookLevel as H, WsCatalogChange as Ha, ACTIVE_VENUES as Hc, UserActivityTrade as Hi, NewsFeedMarketNewsResponse as Hn, parse as Ho, RecurringCryptoReferencePrice as Hr, OutcomeMidpoint as Hs, CryptoReferencePriceError as Ht, isPostFillFeeRequest as I, WsAttributedLevel as Ia, Chain as Ic, UserActivityBridge as Ii, NewsFeedLinkedMarket as In, enumGuard as Io, RecurringCryptoMarketsResponse as Ir, NonceResponse as Is, CorrelatedMarketSignal as It, computeBestSplitsByAmount as J, WsMarkSource as Ja, isVenueActive as Jc, VenueGeoPolicyEntry as Ji, OrderListQuery as Jn, formatOutcomeLabel as Jo, RedeemLegResult as Jr, ServerWallet as Js, CryptoReferencePricesResponse as Jt, computeChecksum as K, WsErrorCode as Ka, Venue as Kc, ValidateManagedParams as Ki, OPTIONAL_FEE_SIGNATURE_TIMEOUT_MS as Kn, getWalletAddressFromUserProfile as Ko, RecurringCryptoWindowComparisons as Kr, PricesHistoryResponse as Ks, CryptoReferencePriceSource as Kt, isSameWalletAddress as L, WsAuthExpired as La, AccountProvider as Lc, UserActivityDeposit as Li, NewsFeedListResponse as Ln, hasShape as Lo, RecurringCryptoOrderbookDepthLevel as Lr, NovigExecutionMode as Ls, CorrelatedMarketSignalBatch as Lt, areOrdersFilled as M, WsAppEvent as Ma, CONFIRMED_MATCH_STATUSES as Mc, TERMINAL_EXECUTION_STATES as Mi, MidpointRow as Mn, SplitsByAmountResult as Mo, RecurringCryptoComparisonPriceSource as Mr, MatchedMidpoint as Ms, CorrelatedMarketCascadeItem as Mt, isOptionalFeeRequest as N, WsArbFeedBatch as Na, MarketStatus as Nc, TradeExecutorOrder as Ni, NewsFeedArticleFeedItem as Nn, SafeParseFailure as No, RecurringCryptoDuration as Nr, MatchedMidpointOutcome as Ns, CorrelatedMarketCascadeResponse as Nt, AggApiFieldError as O, CatalogMarketSnapshot as Oa, OrderStatus as Oc, SportsLiveParticipant as Oi, ManagedBalancesParams as On, VenueMarketClusterNode as Oo, RampWidgetSession as Or, GetOrdersQuery as Os, ChartCandle as Ot, isOrderSignatureStep as P, WsArbFeedEntry as Pa, MatchStatus as Pc, TradeExecutorOrderListResponse as Pi, NewsFeedArticleFeedResponse as Pn, SafeParseResult as Po, RecurringCryptoDurationInput as Pr, MatchedVenueMarketOutcomeRef as Ps, CorrelatedMarketQueryResult as Pt, AggAuthProviderType as Q, WsOrderSubmitted as Qa, VenuePriceInfo as Qi, OrderbookQuoteFill as Qn, HostedVenueActivityCode as Qo, RedeemSelfCustodyParams as Qr, SetupDepositAddressStep as Qs, DepositAddressesSupportedChain as Qt, orderSignatureRound as R, WsAuthExpiring as Ra, AccountType as Rc, UserActivityItem as Ri, NewsFeedMarketFeedArticle as Rn, isEmail as Ro, RecurringCryptoOrderbookDepthSide as Rr, OrderListItem as Rs, CorrelatedMarketSignalDirection as Rt, toChecksumAddress as S, CatalogChange as Sa, VerifyResponse as Sc, SmartRouteSettlementPlan as Si, LeaderboardSeries as Sn, LimitPriceSide as So, PlacePaperTradingOrderParams as Sr, ExecuteTradeRequest as Ss, BatchOrderbooksResponse as St, CandleInterval as T, CatalogEntity as Ta, WithdrawManagedRequest as Tc, SmartRouteStatus as Ti, LeaderboardStats as Tn, BuildVenueUrlOpts as To, RampQuote as Tr, GetBalanceResponse as Ts, CancelVenueOrderParams as Tt, OrderbookState as U, WsClientMessage as Ua, INACTIVE_VENUES as Uc, UserActivityType as Ui, NewsFeedMarketNewsResult as Un, parseEmail as Uo, RecurringCryptoResolution as Ur, PositionGroup as Us, CryptoReferencePriceExternalMarketInput as Ut, withTimeout as V, WsCandleInterval as Va, RETINA_IMAGE_SIZES as Vc, UserActivityRedeemLeg as Vi, NewsFeedMarketNewsParams as Vn, isNonEmptyString as Vo, RecurringCryptoPriceComparison as Vr, OrderbookHistoryResponse as Vs, CreatePaperTradingAccountParams as Vt, VenueOrderbookLevel as W, WsConnected as Wa, VENUES as Wc, UserActivityUserOp as Wi, NewsFeedPageOptions as Wn, parseEmailStrict as Wo, RecurringCryptoSourceConfidence as Wr, PricePoint as Ws, CryptoReferencePriceMarketInput as Wt, AggAuthDeliveryMode as X, WsOrderEvent as Xa, isVenueInactive as Xc, VenueMarketRef as Xi, OrderbookBatchItemErrorCode as Xn, HostedVenueAccount as Xo, RedeemRequest as Xr, SettlementDifference as Xs, DepositAddressesReadyResponse as Xt, AggClient as Y, WsMarketResolved as Ya, isVenueDataVisible as Yc, VenueGeoPolicyResponse as Yi, OrderbookBatchItemError as Yn, formatOutcomeTitle as Yo, RedeemLegStatus as Yr, SettlementDiff as Ys, DepositAddressesPendingResponse as Yt, AggAuthPrivyVerifyBody as Z, WsOrderEventType as Za, VenueOrderbookEntry as Zi, OrderbookBatchItemStatus as Zn, HostedVenueActivity as Zo, RedeemResponse as Zr, SettlementSource as Zs, DepositAddressesResponse as Zt, LoadImmutableHistoryOptions as _, CatalogWatchHandle as _a, VenueMarket as _c, SmartRouteFeeBreakdown as _i, GetOrdersParams as _n, DEFAULT_BALANCE_REFILL_DAILY_CAP_RAW as _o, PaperTradingPosition as _r, ComputeSplitsResponse as _s, BalanceRefillAttempt as _t, BookWatchdogOptions as a, WithdrawTokenSymbol as aa, UpsertVenueKey as ac, SELF_CUSTODY_FILL_TIMEOUT_MS as ai, ExecutionDisplayStepKind as an, WsSubscribed as ao, PaginatedResponse as ar, QuoteError as as, AggClientSessionInput as at, mergeCandles as b, isCatalogResyncRequired as ba, VenuePositionBalance as bc, SmartRouteResponse as bi, LeaderboardQuery as bn, isBalanceRefillWithinDailyCap as bo, PlaceLimitOrderParams as br, DepositStep as bs, BalanceRefillPolicyStatus as bt, HistoryRangeRequest as c, WithdrawalLegStatus as ca, ValidateBalanceOnClientStep as cc, SearchResponse as ci, ExecutionOrdersQuery as cn, WsVenueBook as co, PaperTradingAppOptions as cr, App as cs, AggLinkAccountResult as ct, MarketViewBatch as d, WithdrawalQuoteParams as da, ValidateTradeResponse as dc, SignatureRequestType as di, ExecutionPositionsQuery as dn, WsWithdrawalLegStatus as do, PaperTradingLiquidityStatus as dr, AuthCodeResponse as ds, AggregatedOrderbookLevel as dt, WithdrawManagedParams as ea, SyncBalancesResponse as ec, ResetPaperTradingAccountParams as ei, EventBootstrapResponse as en, WsOrderbookSnapshot as eo, OrderbookQuoteResponse as er, HostedVenueBalance as es, AggAuthStartResult as et, createAggClient as f, WithdrawalQuoteResponse as fa, VenueEvent as fc, SignerFn as fi, ExecutionStatusOrder as fn, WsWithdrawalLifecycleEvent as fo, PaperTradingListParams as fr, AuthTokenResponse as fs, AggregatedOrderbookResponse as ft, prepareHostedVenueRoute as g, CatalogChangesPage as ga, VenueKeySummary as gc, SmartRouteCustodyWarning as gi, GetCryptoReferencePricesOptions as gn, projectedOrderbookChecksum as go, PaperTradingPortfolio as gr, ComputeSplitsRequest as gs, BalanceCustody as gt, prepareHostedVenueFunding as h, CATALOG_DEFAULT_OVERLAP_MS as ha, VenueKeyStatus as hc, SmartRouteBridgeStep as hi, ExecutionStatusStep as hn, orderbookCrc32 as ho, PaperTradingOrdersPage as hr, Category as hs, AuthStatus as ht, AggWebSocketOptions as i, WithdrawPreviewResponse as ia, UpdateUserBody as ic, RpcTokenResponse as ii, ExecutionDisplayGroupStatus as in, WsStreamInterrupted as io, OutcomeOrderbookResponse as ir, ProvisionHostedVenueAccountBody as is, AggClientOptions as it, isAggApiError as j, DiagnosticEvent as ja, TradeSide$1 as jc, SubmitSignature as ji, MatchedOrderbookMarket as jn, retinaImageUrl as jo, RecurringCryptoComparisonPoint as jr, MarketPriceHistory as js, ChartVenueCandles as jt, AggRateLimitResponse as k, CatalogOutcomeRef as ka, OrderType as kc, SportsLiveResponse as ki, ManagedBalancesResponse as kn, normalizeVenueMarketCluster as ko, RecurrenceCadence as kr, GetPositionsQuery as ks, ChartHistoryManifest as kt, MarketDataEngine as l, WithdrawalLegType as la, ValidateManagedRequest as lc, SetPaperTradingBalanceParams as li, ExecutionOverallState as ln, WsVenueInfo as lo, PaperTradingBalanceAdjustment as lr, AttributedOrderbook as ls, AggLinkAccountWalletConfirmBody as lt, HostedVenueFundingOptions as m, WithdrawalSourceTokenSymbol as ma, VenueEventWithMarkets as mc, SmartRouteAllocation as mi, ExecutionStatusResponse as mn, WsWithdrawalLifecycleStatus as mo, PaperTradingOrder as mr, BookQuality as ms, AppTradingMode as mt, AggWebSocketCallbacks as n, WithdrawManagedSourceItem as na, TradeStep as nc, ResolveCorrelatedMarketsResponse as ni, ExecuteManagedResponse as nn, WsResumed as no, OrderbooksOnlyError as nr, HostedVenueWithdrawal as ns, AggAuthWalletVerifyBody as nt, CatalogSubscribeOptions as o, WithdrawalExpected as oa, UserHolding as oc, SELF_CUSTODY_POLL_INTERVAL_MS as oi, ExecutionMode as on, WsTrade as oo, PaperTradingAccount as or, QuoteErrorCode as os, AggLinkAccountBody as ot, HostedVenueFundingIntent as p, WithdrawalSourceStatus as pa, VenueEventListItem as pc, SimpleOrderbookLevel as pi, ExecutionStatusQuery as pn, WsWithdrawalLifecycleLeg as po, PaperTradingMarkSource as pr, AuthUser as ps, AppClientConfigResponse as pt, snapshotToOrderbook as q, WsHeartbeat as qa, getEffectiveDisabledVenues as qc, ValidateManagedResponse as qi, OPTIONAL_SIGNATURE_TIMEOUT_MS as qn, formatMarketQuestion as qo, RecurringCryptoWindowMarket as qr, ProphetxExecutionMode as qs, CryptoReferencePriceTarget as qt, AggWebSocketDiagnostics as r, WithdrawPreviewParams as ra, UnifiedBalanceResponse as rc, ResolvedCorrelatedMarketsResponse as ri, ExecutionDagProgress as rn, WsServerMessage as ro, OutcomeMidpointRow as rr, HostedVenueWithdrawalRequest as rs, AggClientAuthOptions as rt, CandleTail as s, WithdrawalLeg as sa, UserProfile as sc, SearchParams as si, ExecutionOrderItem as sn, WsUnsubscribed as so, PaperTradingAccountsPage as sr, Account as ss, AggLinkAccountConfirmResult as st, AggWebSocket as t, WithdrawManagedResponse as ta, TradeSplit as tc, ResolveCorrelatedMarketsParams as ti, ExecuteManagedParams as tn, WsRedeemEvent as to, OrderbookServiceUnavailableError as tr, HostedVenueDepositAddress as ts, AggAuthVerifyBody as tt, MarketView as u, WithdrawalLifecycleStatus as ua, ValidateTradeRequest as uc, SignatureRequest as ui, ExecutionPositionGroup as un, WsVenueLevel as uo, PaperTradingBalanceResponse as ur, AttributedOrderbookLevel as us, AggSessionUser as ut, loadImmutableHistory as v, GetCatalogChangesParams as va, VenueMarketListItem as vc, SmartRouteFill as vi, GetPositionsParams as vn, DEFAULT_BALANCE_REFILL_MAX_FEE_RAW as vo, PaperTradingPositionsPage as vr, ComputeSplitsSelection as vs, BalanceRefillAttemptStatus as vt, CandleBuilder as w, CatalogClusterFields as wa, WalletTokenBalance as wc, SmartRouteSide as wi, LeaderboardSeriesQuery as wn, adjustLimitPriceRawToTick as wo, RECURRENCE_CADENCES as wr, GetBalanceQuery as ws, CancelOrderSignature as wt, mergeClosedCandles as x, CatalogCategoryRef as xa, VerifyBody as xc, SmartRouteSettlementLeg as xi, LeaderboardRow as xn, LIMIT_PRICE_RAW_SCALE as xo, PlaceLimitOrderResponse as xr, ExecuteManagedRequest as xs, BatchMidpointsResponse as xt, aggregateMidpoint as y, WatchCatalogOptions as ya, VenueMarketOutcome as yc, SmartRouteParams as yi, LeaderboardMetric as yn, getBalanceRefillMaximumRaw as yo, PersistedAuthSnapshot as yr, CreateApp as ys, BalanceRefillPolicy as yt, signatureTimeoutMs as z, WsAuthenticated as za, IMAGE_SIZES as zc, UserActivityQuery as zi, NewsFeedMarketFeedItem as zn, isEnum as zo, RecurringCryptoOutcome as zr, Orderbook as zs, CorrelatedMarketsStatus as zt };
+//# sourceMappingURL=agg-websocket-CvYdVJPc.d.mts.map