@structbuild/sdk 0.6.1 → 0.6.3

package/dist/generated/ws.d.ts

@@ -88,6 +88,11 @@ export interface components {
         };
         /** @description Subscription filters for the `asset_price_tick` event. All fields are optional. */
         AssetPriceTickFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Restrict to these crypto assets. Empty = all assets. */
             asset_symbols?: components["schemas"]["WebhookAssetSymbol"][] | null;
         };
@@ -108,6 +113,11 @@ export interface components {
         };
         /** @description Subscription filters for the `asset_price_window_update` event. All fields are optional. */
         AssetPriceWindowUpdateFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Restrict to these crypto assets. Empty = all assets. */
             asset_symbols?: components["schemas"]["WebhookAssetSymbol"][] | null;
             /** @description Restrict to these candle sizes. Empty = all sizes. */
@@ -159,73 +169,170 @@ export interface components {
         AssetWindowFilterTimeframe: "5m" | "15m" | "1h" | "4h" | "1d" | "24h";
         /** @description Category PnL webhook payload. */
         CategoryPnlPayload: {
+            /** @description Trader wallet address. */
             trader?: string | null;
+            /** @description Category. */
             category?: string | null;
             /** @description Aggregation timeframe: "1d", "7d", "30d", or "lifetime" */
             timeframe: string;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Realized pnl in USD.
+             */
             realized_pnl_usd?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets in this category.
+             */
             markets_in_category?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets traded.
+             */
             markets_traded?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Number of outcomes traded.
+             */
             outcomes_traded?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total buy count.
+             */
             total_buys?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total sell count.
+             */
             total_sells?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total redemption count.
+             */
             total_redemptions?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total merge count.
+             */
             total_merges?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total split count.
+             */
             total_splits?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Total volume in USD.
+             */
             total_volume_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Buy in USD.
+             */
             buy_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Sell in USD.
+             */
             sell_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Redemption in USD.
+             */
             redemption_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Merge in USD.
+             */
             merge_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Convert collateral in USD.
+             */
             convert_collateral_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Split volume in USD.
+             */
             split_volume_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Total fees amount.
+             */
             total_fees?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Total shares bought.
+             */
             total_shares_bought?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets won.
+             */
             markets_won?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets lost.
+             */
             markets_lost?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Market win rate percent.
+             */
             market_win_rate_pct?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Average hold time seconds.
+             */
             avg_hold_time_seconds?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Best trade pnl in USD.
+             */
             best_trade_pnl_usd?: number | null;
+            /** @description Best trade condition id. */
             best_trade_condition_id?: string | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Worst trade pnl in USD.
+             */
             worst_trade_pnl_usd?: number | null;
+            /** @description Worst trade condition id. */
             worst_trade_condition_id?: string | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Total wins in USD.
+             */
             total_wins_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Total losses in USD.
+             */
             total_losses_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Average win in USD.
+             */
             avg_win_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Average loss in USD.
+             */
             avg_loss_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Profit factor.
+             */
             profit_factor?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description First trade timestamp.
+             */
             first_trade_at?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Last trade timestamp.
+             */
             last_trade_at?: number | null;
         };
         /**
@@ -233,6 +340,15 @@ export interface components {
          *     `min_probability` or `max_probability` is required (enforced at runtime).
          */
         CloseToBondFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
+            /** @description Restrict to markets carrying any of these tags or category names (case-insensitive). Empty = all. */
+            tags?: string[] | null;
+            /** @description Restrict to markets in any of these series (by slug, case-insensitive). Empty = all. */
+            series_slugs?: string[] | null;
             /**
              * Format: double
              * @description Trigger when the YES outcome price is ≥ this value (e.g. 0.95 for 95% certainty). At least one of `min_probability` or `max_probability` must be set.
@@ -329,15 +445,31 @@ export interface components {
             threshold: number;
         };
         ConditionHolderMetricsFilters: {
+            /** @description Market condition IDs to match. */
             condition_ids?: string[];
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
         };
         ConditionHolderMetricsPayload: {
-            /** Format: int32 */
+            /**
+             * Format: int32
+             * @description Unix timestamp in seconds.
+             */
             ts: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Block number.
+             */
             block: number;
+            /** @description Market condition ID. */
             condition_id: string;
-            /** Format: int32 */
+            /**
+             * Format: int32
+             * @description Number of holders.
+             */
             holder_count: number;
         };
         /** @description Payload delivered when a market's volume or transaction metrics cross a configured threshold */
@@ -444,6 +576,7 @@ export interface components {
         };
         /** @description Delete webhook response */
         DeleteWebhookResponse: {
+            /** @description Whether the webhook was deleted. */
             deleted: boolean;
         };
         /**
@@ -496,19 +629,91 @@ export interface components {
             event_slug?: string | null;
         };
         EventHolderMetricsFilters: {
+            /** @description Event slugs to match. */
             event_slugs?: string[];
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
         };
         EventHolderMetricsPayload: {
-            /** Format: int32 */
+            /**
+             * Format: int32
+             * @description Unix timestamp in seconds.
+             */
             ts: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Block number.
+             */
             block: number;
+            /** @description Event slug. */
             event_slug: string;
-            /** Format: int32 */
+            /**
+             * Format: int32
+             * @description Number of holders.
+             */
             holder_count: number;
         };
+        /**
+         * @description Subscription filters for the `event_liquidity` event.
+         *
+         *     At least one of `min_liquidity_usd`, `max_liquidity_usd`, or `one_shot` must be set.
+         *     Thresholds are edge-triggered: a callback fires when liquidity crosses the threshold,
+         *     then re-arms once it crosses back (unless `one_shot`).
+         */
+        EventLiquidityFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery.
+             */
+            one_shot?: boolean | null;
+            /**
+             * Format: double
+             * @description Fire when total liquidity crosses up through this USD value.
+             */
+            min_liquidity_usd?: number | null;
+            /**
+             * Format: double
+             * @description Fire when total liquidity crosses down through this USD value.
+             */
+            max_liquidity_usd?: number | null;
+            /** @description **Required.** Events to receive liquidity updates for. */
+            event_slugs: string[];
+        };
+        /** @description Event liquidity webhook payload. */
+        EventLiquidityPayload: {
+            /** @description Event slug. */
+            event_slug: string;
+            /**
+             * Format: double
+             * @description Total order-book liquidity in USD at the time of firing.
+             */
+            liquidity_usd: number;
+            /**
+             * Format: double
+             * @description The threshold (USD) that was crossed.
+             */
+            threshold_usd: number;
+            /**
+             * @description `"above"` when liquidity crossed up through `min_liquidity_usd`,
+             *     `"below"` when it crossed down through `max_liquidity_usd`.
+             */
+            direction: string;
+            /**
+             * Format: int64
+             * @description Update timestamp (Unix millis).
+             */
+            liquidity_updated_at: number;
+        };
         /** @description Subscription filters for the `event_metrics` event. All fields are optional. */
         EventMetricsFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Restrict to these events. Empty = all events. */
             event_slugs?: string[] | null;
             /** @description Restrict to these aggregation windows. */
@@ -518,13 +723,25 @@ export interface components {
              * @description Only fire when aggregated event volume ≥ this value (USD).
              */
             min_volume_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Maximum volume USD.
+             */
             max_volume_usd?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Minimum transactions.
+             */
             min_txns?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Minimum unique traders.
+             */
             min_unique_traders?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Minimum fees.
+             */
             min_fees?: number | null;
             /** @description When `true`, suppress webhooks for short-term "updown" markets. Default: `false`. */
             exclude_shortterm_markets?: boolean | null;
@@ -598,6 +815,11 @@ export interface components {
         };
         /** @description Subscription filters for the `event_volume_milestone` event. */
         EventVolumeMilestoneFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description **Required.** Aggregation windows to monitor. */
             timeframes: components["schemas"]["MetricFilterTimeframe"][];
             /** @description Restrict to these events. */
@@ -609,7 +831,9 @@ export interface components {
         };
         /** @description Event volume milestone webhook payload */
         EventVolumeMilestonePayload: {
+            /** @description Event slug. */
             event_slug: string;
+            /** @description Metric timeframe. */
             timeframe: string;
             /**
              * Format: double
@@ -634,6 +858,11 @@ export interface components {
         };
         /** @description Subscription filters for the `event_volume_spike` event. `spike_ratio` is required. */
         EventVolumeSpikeFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /**
              * Format: double
              * @description **Required.** Multiplier threshold (must be > 1.0). Fires when current volume >= snapshot × ratio.
@@ -653,9 +882,13 @@ export interface components {
         };
         /** @description Event volume spike webhook payload */
         EventVolumeSpikePayload: {
+            /** @description Event slug. */
             event_slug: string;
+            /** @description Event title. */
             event_title?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Metric timeframe. */
             timeframe: string;
             /**
              * Format: double
@@ -690,26 +923,50 @@ export interface components {
         };
         /** @description Exit Markers webhook payload — one position open->closed transition. */
         ExitMarkersPayload: {
+            /** @description Trader wallet address. */
             trader: string;
+            /** @description Outcome token ID. */
             position_id: string;
+            /** @description Market condition ID. */
             condition_id: string;
+            /** @description Event slug. */
             event_slug: string;
+            /** @description Market slug. */
             market_slug: string;
+            /** @description Title. */
             title: string;
+            /** @description Market question. */
             question: string;
+            /** @description Image URL. */
             image_url: string;
+            /** @description Outcome name. */
             outcome: string;
-            /** Format: int32 */
+            /**
+             * Format: int32
+             * @description Outcome index.
+             */
             outcome_index?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Pnl in USD.
+             */
             pnl_usd: number;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Pnl percent.
+             */
             pnl_pct: number;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Cost basis in USD.
+             */
             cost_basis_usd: number;
             /** @description resolved_win | resolved_loss | sold_win | sold_loss */
             reason: string;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Block number.
+             */
             block: number;
             /**
              * Format: int32
@@ -785,6 +1042,7 @@ export interface components {
         };
         /** @description Global PnL webhook payload. */
         GlobalPnlPayload: {
+            /** @description Trader wallet address. */
             trader?: string | null;
             /** @description Aggregation timeframe: "1d", "7d", "30d", or "lifetime" */
             timeframe: string;
@@ -793,87 +1051,203 @@ export interface components {
              * @description Realized PnL for the timeframe (matches REST `/pnl/global`).
              */
             realized_pnl_usd?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Events traded.
+             */
             events_traded?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets traded.
+             */
             markets_traded?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total buy count.
+             */
             total_buys?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total sell count.
+             */
             total_sells?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total redemption count.
+             */
             total_redemptions?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total merge count.
+             */
             total_merges?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total split count.
+             */
             total_splits?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Total volume in USD.
+             */
             total_volume_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Buy volume in USD.
+             */
             buy_volume_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Sell volume in USD.
+             */
             sell_volume_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Redemption volume in USD.
+             */
             redemption_volume_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Merge volume in USD.
+             */
             merge_volume_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Convert collateral in USD.
+             */
             convert_collateral_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Split volume in USD.
+             */
             split_volume_usd?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Maker rebate count.
+             */
             maker_rebate_count?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Maker rebate in USD.
+             */
             maker_rebate_usd?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Reward count.
+             */
             reward_count?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Reward in USD.
+             */
             reward_usd?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Yield count.
+             */
             yield_count?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Yield in USD.
+             */
             yield_usd?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total credit count.
+             */
             total_credit_count?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Total credit in USD.
+             */
             total_credit_usd?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets won.
+             */
             markets_won?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets lost.
+             */
             markets_lost?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Market win rate percent.
+             */
             market_win_rate_pct?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Total wins in USD.
+             */
             total_wins_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Total losses in USD.
+             */
             total_losses_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Average win in USD.
+             */
             avg_win_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Average loss in USD.
+             */
             avg_loss_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Profit factor.
+             */
             profit_factor?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Average hold time seconds.
+             */
             avg_hold_time_seconds?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Total fees amount.
+             */
             total_fees?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Best trade pnl in USD.
+             */
             best_trade_pnl_usd?: number | null;
+            /** @description Best trade condition id. */
             best_trade_condition_id?: string | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Worst trade pnl in USD.
+             */
             worst_trade_pnl_usd?: number | null;
+            /** @description Worst trade condition id. */
             worst_trade_condition_id?: string | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description First trade timestamp.
+             */
             first_trade_at?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Last trade timestamp.
+             */
             last_trade_at?: number | null;
         };
         /** @description Response for GET /v1/webhook/events */
         ListEventsResponse: {
+            /** @description Supported webhook events. */
             events: components["schemas"]["WebhookEventInfo"][];
         };
         /** @description Subscription filters for the `market_created` event. All fields are optional. */
         MarketCreatedFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Restrict to markets with these tags or category names (case-insensitive match). */
             tags?: string[] | null;
             /** @description Restrict to markets belonging to these events. */
@@ -924,8 +1298,116 @@ export interface components {
             /** @description Whether this is a neg-risk market */
             neg_risk: boolean;
         };
+        /** @description Subscription filters for the `market_disputed` event. All fields are optional. */
+        MarketDisputedFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
+            /** @description Restrict to these markets. */
+            condition_ids?: string[] | null;
+            /** @description Restrict to markets in these events. */
+            event_slugs?: string[] | null;
+            /** @description When `true`, suppress webhooks for short-term "updown" markets. Default: `false`. */
+            exclude_shortterm_markets?: boolean | null;
+        };
+        /** @description Market-disputed webhook payload */
+        MarketDisputedPayload: {
+            /** @description Condition ID (the contested market), when resolvable */
+            condition_id?: string | null;
+            /** @description Which oracle event produced this dispute: `"dispute_price"` or `"assertion_disputed"`. */
+            dispute_kind: string;
+            /** @description Address that filed the dispute */
+            disputer: string;
+            /** @description Address that made the disputed proposal/assertion, when known */
+            proposer?: string | null;
+            /** @description The proposed outcome that was disputed, when known (e.g. "Yes", "No") */
+            proposed_outcome?: string | null;
+            /**
+             * Format: double
+             * @description The proposed price (0.0–1.0) that was disputed (`DisputePrice` only)
+             */
+            proposed_price?: number | null;
+            /** @description Market question */
+            question?: string | null;
+            /** @description Market slug */
+            market_slug?: string | null;
+            /** @description Event slug */
+            event_slug?: string | null;
+            /** @description Market image URL */
+            image_url?: string | null;
+            /** @description Transaction hash of the dispute event */
+            hash: string;
+            /**
+             * Format: int64
+             * @description Block number
+             */
+            block?: number | null;
+            /**
+             * Format: int64
+             * @description Confirmed timestamp (Unix seconds)
+             */
+            confirmed_at?: number | null;
+        };
+        /**
+         * @description Subscription filters for the `market_liquidity` event.
+         *
+         *     At least one of `min_liquidity_usd`, `max_liquidity_usd`, or `one_shot` must be set.
+         *     Thresholds are edge-triggered: a callback fires when liquidity crosses the threshold,
+         *     then re-arms once it crosses back (unless `one_shot`).
+         */
+        MarketLiquidityFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery.
+             */
+            one_shot?: boolean | null;
+            /**
+             * Format: double
+             * @description Fire when total liquidity crosses up through this USD value.
+             */
+            min_liquidity_usd?: number | null;
+            /**
+             * Format: double
+             * @description Fire when total liquidity crosses down through this USD value.
+             */
+            max_liquidity_usd?: number | null;
+            /** @description **Required.** Markets to receive liquidity updates for. */
+            condition_ids: string[];
+        };
+        /** @description Market liquidity webhook payload. */
+        MarketLiquidityPayload: {
+            /** @description Market condition ID. */
+            condition_id: string;
+            /**
+             * Format: double
+             * @description Total order-book liquidity in USD at the time of firing.
+             */
+            liquidity_usd: number;
+            /**
+             * Format: double
+             * @description The threshold (USD) that was crossed.
+             */
+            threshold_usd: number;
+            /**
+             * @description `"above"` when liquidity crossed up through `min_liquidity_usd`,
+             *     `"below"` when it crossed down through `max_liquidity_usd`.
+             */
+            direction: string;
+            /**
+             * Format: int64
+             * @description Update timestamp (Unix millis).
+             */
+            liquidity_updated_at: number;
+        };
         /** @description Subscription filters for the `condition_metrics` event. All fields are optional. */
         MarketMetricsFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Restrict to these markets. Empty = all markets. */
             condition_ids?: string[] | null;
             /** @description Restrict to these aggregation windows. Empty = all windows. */
@@ -958,51 +1440,168 @@ export interface components {
         };
         /** @description Market PnL webhook payload. */
         MarketPnlPayload: {
+            /** @description Trader wallet address. */
             trader?: string | null;
+            /** @description Market condition ID. */
             condition_id?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Category. */
             category?: string | null;
             /** @description Aggregation timeframe: "1d", "7d", "30d", or "lifetime" */
             timeframe: string;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Realized pnl in USD.
+             */
             realized_pnl_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Current shares balance.
+             */
             current_shares_balance?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Number of outcomes traded.
+             */
             outcomes_traded?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total buy count.
+             */
             total_buys?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total sell count.
+             */
             total_sells?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total redemption count.
+             */
             total_redemptions?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total merge count.
+             */
             total_merges?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total split count.
+             */
             total_splits?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Buy in USD.
+             */
             buy_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Sell in USD.
+             */
             sell_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Redemption in USD.
+             */
             redemption_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Merge in USD.
+             */
             merge_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Convert collateral in USD.
+             */
             convert_collateral_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Split volume in USD.
+             */
             split_volume_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Total fees amount.
+             */
             total_fees?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Total shares bought.
+             */
             total_shares_bought?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description First trade timestamp.
+             */
             first_trade_at?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Last trade timestamp.
+             */
             last_trade_at?: number | null;
         };
+        /** @description Subscription filters for the `market_resolved` event. All fields are optional. */
+        MarketResolvedFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
+            /** @description Restrict to these markets. */
+            condition_ids?: string[] | null;
+            /** @description Restrict to markets in these events. */
+            event_slugs?: string[] | null;
+            /** @description Only fire when the winning outcome matches one of these (e.g. \["Yes"\]). */
+            outcomes?: string[] | null;
+            /** @description When `true`, suppress webhooks for short-term "updown" markets. Default: `false`. */
+            exclude_shortterm_markets?: boolean | null;
+        };
+        /** @description Market-resolved webhook payload */
+        MarketResolvedPayload: {
+            /** @description Condition ID (the resolved market) */
+            condition_id: string;
+            /** @description Winning outcome name when known (e.g. "Yes", "No") */
+            winning_outcome?: string | null;
+            /**
+             * Format: double
+             * @description Settled price (0.0–1.0) when the resolution event carries one
+             *     (`QuestionResolved` only). 1.0 = full YES, 0.0 = full NO, 0.5 = split.
+             */
+            settled_price?: number | null;
+            /**
+             * @description Which oracle event produced this resolution: `"question_resolved"`,
+             *     `"question_emergency_resolved"`, `"condition_resolution"`, or `"neg_risk_outcome_reported"`.
+             */
+            resolution_kind: string;
+            /** @description Market question */
+            question?: string | null;
+            /** @description Market slug */
+            market_slug?: string | null;
+            /** @description Event slug */
+            event_slug?: string | null;
+            /** @description Market image URL */
+            image_url?: string | null;
+            /** @description Transaction hash of the resolution event */
+            hash: string;
+            /**
+             * Format: int64
+             * @description Block number
+             */
+            block?: number | null;
+            /**
+             * Format: int64
+             * @description Confirmed timestamp (Unix seconds)
+             */
+            confirmed_at?: number | null;
+        };
         /** @description Subscription filters for the `market_volume_milestone` event. */
         MarketVolumeMilestoneFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description **Required.** Aggregation windows to monitor (e.g. \["1h", "24h"\]). */
             timeframes: components["schemas"]["MetricFilterTimeframe"][];
             /** @description Restrict to these markets. Empty = all markets. */
@@ -1012,6 +1611,11 @@ export interface components {
         };
         /** @description Subscription filters for the `market_volume_spike` event. `spike_ratio` is required. */
         MarketVolumeSpikeFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /**
              * Format: double
              * @description **Required.** Multiplier threshold (must be > 1.0). Fires when current volume >= snapshot × ratio. The snapshot is set automatically on first data and resets after each fire.
@@ -1029,11 +1633,17 @@ export interface components {
         };
         /** @description Market volume spike webhook payload */
         MarketVolumeSpikePayload: {
+            /** @description Market condition ID. */
             condition_id: string;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Market slug. */
             market_slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Metric timeframe. */
             timeframe: string;
             /**
              * Format: double
@@ -1243,6 +1853,7 @@ export interface components {
             /**
              * @description CLOB V2 builder code (lower-cased `0x...` bytes32 hex). Absent on V1
              *     trades; may be `0x0000…` for V2 trades placed without a builder code.
+             *     CLOB builder code.
              */
             builder_code?: string | null;
             /**
@@ -1314,6 +1925,11 @@ export interface components {
         });
         /** @description Subscription filters for the `oracle_events` event. All fields are optional. */
         OracleEventsFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Restrict to these event types (case-insensitive). Empty = all. */
             oracle_event_types?: components["schemas"]["OracleEventFilterType"][] | null;
             /** @description Restrict to events for these condition IDs. */
@@ -1340,11 +1956,15 @@ export interface components {
          * @description Polymarket webhook event types
          * @enum {string}
          */
-        PolymarketWebhookEvent: "trader_first_trade" | "trader_new_market" | "trader_whale_trade" | "trader_new_trade" | "trader_trade_event" | "trader_global_pnl" | "trader_market_pnl" | "trader_category_pnl" | "trader_position_resolved" | "trader_exit_markers" | "position_holder_metrics" | "condition_holder_metrics" | "event_holder_metrics" | "condition_metrics" | "event_metrics" | "tag_metrics" | "position_metrics" | "market_volume_milestone" | "event_volume_milestone" | "position_volume_milestone" | "probability_spike" | "market_volume_spike" | "event_volume_spike" | "position_volume_spike" | "close_to_bond" | "market_created" | "asset_price_tick" | "asset_price_window_update" | "price_spike" | "oracle_events";
+        PolymarketWebhookEvent: "trader_first_trade" | "trader_new_market" | "trader_whale_trade" | "trader_new_trade" | "trader_trade_event" | "trader_global_pnl" | "trader_market_pnl" | "trader_category_pnl" | "trader_position_resolved" | "trader_exit_markers" | "position_holder_metrics" | "condition_holder_metrics" | "event_holder_metrics" | "condition_metrics" | "event_metrics" | "tag_metrics" | "position_metrics" | "position_liquidity" | "market_liquidity" | "event_liquidity" | "market_volume_milestone" | "event_volume_milestone" | "position_volume_milestone" | "probability_spike" | "market_volume_spike" | "event_volume_spike" | "position_volume_spike" | "close_to_bond" | "market_created" | "asset_price_tick" | "asset_price_window_update" | "price_spike" | "oracle_events" | "price_threshold" | "market_resolved" | "market_disputed";
         /**
          * @description Polymarket-specific webhook filters
          *
-         *     Different webhook handlers use different subsets of these fields:
+         *     Different webhook handlers use different subsets of these fields.
+         *     The trade-driven events `price_spike`, `probability_spike`, and
+         *     `close_to_bond` additionally accept `tags` (matches a market's tags OR its
+         *     category) and `series_slugs` (matches the market's parent series); these are
+         *     resolved from the tags/series the crawler enriches onto each trade.
          *     - first_trade: wallet_addresses, min_usd_value, min_probability, max_probability, condition_ids, event_slugs, tags
          *     - new_market: wallet_addresses, condition_ids, event_slugs, min_usd_value, min_probability, max_probability
          *     - whale_trade: min_usd_value (required), min_probability, max_probability, condition_ids, event_slugs
@@ -1356,10 +1976,10 @@ export interface components {
          *     - tag_metrics: tags, min_volume_usd, max_volume_usd, min_fees, min_txns, timeframes
          *     - position_metrics: position_ids, condition_ids, outcomes, min_volume_usd, max_volume_usd, min_buy_usd, min_sell_volume_usd, min_fees, min_txns, min_price_change_pct, min_probability_change_pct, timeframes
          *     - volume_milestone: condition_ids, timeframes, milestone_amounts
-         *     - close_to_bond: min_probability (high zone threshold), max_probability (low zone threshold), condition_ids, position_ids, outcomes, position_outcome_indices, event_slugs, exclude_shortterm_markets
+         *     - close_to_bond: min_probability (high zone threshold), max_probability (low zone threshold), condition_ids, tags, series_slugs, position_ids, outcomes, position_outcome_indices, event_slugs, exclude_shortterm_markets
          *     - market_created: event_slugs, tags, exclude_shortterm_markets
-         *     - probability_spike: condition_ids, event_slugs, outcomes, min_probability, max_probability, min_probability_change_pct, spike_direction, window_secs, exclude_shortterm_markets
-         *     - price_spike: condition_ids, event_slugs, outcomes, min_price_change_pct, spike_direction, window_secs, exclude_shortterm_markets
+         *     - probability_spike: condition_ids, event_slugs, tags, series_slugs, outcomes, min_probability, max_probability, min_probability_change_pct, spike_direction, window_secs, exclude_shortterm_markets
+         *     - price_spike: condition_ids, event_slugs, tags, series_slugs, outcomes, min_price_change_pct, spike_direction, window_secs, exclude_shortterm_markets
          *     - trader_new_trade: wallet_addresses, min_usd_value, min_probability, max_probability, condition_ids, event_slugs, trade_types, exclude_shortterm_markets
          *     - trader_trade_event: wallet_addresses, min_usd_value, min_probability, max_probability, condition_ids, event_slugs, trade_types, exclude_shortterm_markets
          *     - trader_first_trade: wallet_addresses, min_usd_value, min_probability, max_probability, exclude_shortterm_markets
@@ -1371,21 +1991,43 @@ export interface components {
          *     Implements Hash + Eq manually (f64 fields use bit representation)
          */
         PolymarketWebhookFilter: {
-            /** @description Filter by wallet addresses (for first_trade, normalized to lowercase). Max 500 entries. */
+            /**
+             * @description Filter by wallet addresses (for first_trade, normalized to lowercase). Max 500 entries.
+             *     Wallet addresses to match.
+             */
             wallet_addresses?: string[];
-            /** @description Filter by trader addresses (for PnL webhooks, normalized to lowercase). Max 500 entries. */
+            /**
+             * @description Filter by trader addresses (for PnL webhooks, normalized to lowercase). Max 500 entries.
+             *     Trader wallet addresses to match.
+             */
             traders?: string[];
-            /** @description Filter by market/condition IDs. Max 500 entries. */
+            /**
+             * @description Filter by market/condition IDs. Max 500 entries.
+             *     Market condition IDs to match.
+             */
             condition_ids?: string[];
             /**
              * Format: double
              * @description Filter by minimum USD value (for trades)
              */
             min_usd_value?: number | null;
-            /** @description Filter by event slugs. Max 500 entries. */
+            /**
+             * @description Filter by event slugs. Max 500 entries.
+             *     Event slugs to match.
+             */
             event_slugs?: string[];
-            /** @description Filter by tags. Max 500 entries. */
+            /**
+             * @description Filter by tags or category names (case-insensitive). Matches a market's
+             *     tags or its category label. Max 500 entries.
+             *     Tags to match.
+             */
             tags?: string[];
+            /**
+             * @description Filter by series slugs (case-insensitive). Matches a market's parent
+             *     series. Max 500 entries.
+             *     Series slugs to match.
+             */
+            series_slugs?: string[];
             /**
              * Format: double
              * @description Minimum probability threshold (0.0 - 1.0)
@@ -1416,6 +2058,18 @@ export interface components {
              * @description Maximum volume (USD) - for metrics webhooks
              */
             max_volume_usd?: number | null;
+            /**
+             * Format: double
+             * @description Minimum order-book liquidity (USD) - for liquidity webhooks.
+             *     Fires when liquidity crosses up through this value.
+             */
+            min_liquidity_usd?: number | null;
+            /**
+             * Format: double
+             * @description Maximum order-book liquidity (USD) - for liquidity webhooks.
+             *     Fires when liquidity crosses down through this value.
+             */
+            max_liquidity_usd?: number | null;
             /**
              * Format: double
              * @description Minimum buy volume (USD) - for PnL and metrics webhooks
@@ -1441,16 +2095,26 @@ export interface components {
              * @description Maximum net shares - for position PnL webhooks
              */
             max_net_shares?: number | null;
-            /** @description Filter by position IDs - for position PnL webhooks. Max 500 entries. */
+            /**
+             * @description Filter by position IDs - for position PnL webhooks. Max 500 entries.
+             *     Outcome token IDs to match.
+             */
             position_ids?: string[];
-            /** @description Filter by outcomes (e.g., "Yes", "No") - for position PnL webhooks. Max 500 entries. */
+            /**
+             * @description Filter by outcomes (e.g., "Yes", "No") - for position PnL webhooks. Max 500 entries.
+             *     Outcome names to match.
+             */
             outcomes?: string[];
             /**
              * @description Filter by position outcome index — for close_to_bond. Position 0 usually represents Yes/Up, 1 = No.
              *     When non-empty, only trades whose outcome_index is in this list will match. Max 500 entries.
+             *     Outcome indices to match.
              */
             position_outcome_indices?: number[];
-            /** @description Filter by trade type (e.g. "OrderFilled", "Redemption", "Merge", "Split"). Empty = default behavior per handler. */
+            /**
+             * @description Filter by trade type (e.g. "OrderFilled", "Redemption", "Merge", "Split"). Empty = default behavior per handler.
+             *     Trade types to match.
+             */
             trade_types?: string[];
             /**
              * Format: double
@@ -1482,9 +2146,15 @@ export interface components {
              * @description Minimum probability change percentage - for position metrics webhooks
              */
             min_probability_change_pct?: number | null;
-            /** @description Timeframes to track - for metrics webhooks (1m, 5m, 30m, 1h, 6h, 24h, 7d, 30d). */
+            /**
+             * @description Timeframes to track - for metrics webhooks (1m, 5m, 30m, 1h, 6h, 24h, 7d, 30d).
+             *     Metric timeframes to match.
+             */
             timeframes?: components["schemas"]["WebhookTimeframe"][];
-            /** @description Milestone amounts to track - for volume milestone webhooks (e.g., 10000, 100000, 1000000). Max 500 entries. */
+            /**
+             * @description Milestone amounts to track - for volume milestone webhooks (e.g., 10000, 100000, 1000000). Max 500 entries.
+             *     Milestone amounts to match.
+             */
             milestone_amounts?: number[];
             /**
              * Format: double
@@ -1503,6 +2173,7 @@ export interface components {
             /**
              * @description Filter by crypto asset symbol — for `asset_price_tick` and `asset_price_window_update` webhooks.
              *     Valid values: "BTC", "ETH", "SOL", "XRP", "DOGE", "BNB", "HYPE". Empty = all assets.
+             *     Asset symbols to match.
              */
             asset_symbols?: components["schemas"]["WebhookAssetSymbol"][];
             spike_direction?: null | components["schemas"]["SpikeDirection"];
@@ -1526,31 +2197,127 @@ export interface components {
              *     `QuestionInitialized`, `QuestionPaused`, `QuestionUnpaused`,
              *     `QuestionFlagged`, `QuestionUnflagged`, `ConditionResolution`,
              *     `NegRiskOutcomeReported`. Empty = all types.
+             *     Oracle event types to match.
              */
             oracle_event_types?: string[];
+            /**
+             * @description Fire-and-delete: when `true`, the subscription is deleted after its first
+             *     successful delivery. Works on any webhook event. (`price_threshold`
+             *     additionally requires `position_ids` or `condition_ids`.)
+             */
+            one_shot?: boolean;
+            /**
+             * @description For `price_threshold` — when `true`, fire immediately if the first observed
+             *     price is already past the target (no prior baseline). Default `false`.
+             */
+            fire_if_already_past?: boolean;
         };
         PositionHolderMetricsFilters: {
+            /** @description Outcome token IDs to match. */
             position_ids?: string[];
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
         };
         PositionHolderMetricsPayload: {
-            /** Format: int32 */
+            /**
+             * Format: int32
+             * @description Unix timestamp in seconds.
+             */
             ts: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Block number.
+             */
             block: number;
+            /** @description Outcome token ID. */
             position_id: string;
-            /** Format: int32 */
+            /**
+             * Format: int32
+             * @description Number of holders.
+             */
             holder_count: number;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Total shares held.
+             */
             total_balance: number;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Total holder cost basis in USD.
+             */
             total_cost_basis: number;
-            /** Format: int32 */
+            /**
+             * Format: int32
+             * @description Number of market-level holders.
+             */
             condition_holder_count?: number | null;
-            /** Format: int32 */
+            /**
+             * Format: int32
+             * @description Number of event-level holders.
+             */
             event_holder_count?: number | null;
         };
+        /**
+         * @description Subscription filters for the `position_liquidity` event.
+         *
+         *     At least one of `min_liquidity_usd`, `max_liquidity_usd`, or `one_shot` must be set.
+         *     Thresholds are edge-triggered: a callback fires when liquidity crosses the threshold,
+         *     then re-arms once it crosses back (unless `one_shot`).
+         */
+        PositionLiquidityFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery.
+             */
+            one_shot?: boolean | null;
+            /**
+             * Format: double
+             * @description Fire when liquidity crosses up through this USD value.
+             */
+            min_liquidity_usd?: number | null;
+            /**
+             * Format: double
+             * @description Fire when liquidity crosses down through this USD value.
+             */
+            max_liquidity_usd?: number | null;
+            /** @description **Required.** Outcome token IDs to receive liquidity updates for. */
+            position_ids: string[];
+        };
+        /** @description Position liquidity webhook payload. */
+        PositionLiquidityPayload: {
+            /** @description Outcome token (position) ID. */
+            position_id: string;
+            /**
+             * Format: double
+             * @description Order-book liquidity in USD at the time of firing.
+             */
+            liquidity_usd: number;
+            /**
+             * Format: double
+             * @description The threshold (USD) that was crossed.
+             */
+            threshold_usd: number;
+            /**
+             * @description `"above"` when liquidity crossed up through `min_liquidity_usd`,
+             *     `"below"` when it crossed down through `max_liquidity_usd`.
+             */
+            direction: string;
+            /**
+             * Format: int64
+             * @description Update timestamp (Unix millis).
+             */
+            liquidity_updated_at: number;
+        };
         /** @description Subscription filters for the `position_metrics` event. All fields are optional. */
         PositionMetricsFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Restrict to these outcome token IDs. */
             position_ids?: string[] | null;
             /** @description Restrict to positions within these markets. */
@@ -1564,15 +2331,30 @@ export interface components {
              * @description Only fire when position volume ≥ this value (USD).
              */
             min_volume_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Maximum volume USD.
+             */
             max_volume_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Minimum buy USD.
+             */
             min_buy_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Minimum sell volume USD.
+             */
             min_sell_volume_usd?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Minimum transactions.
+             */
             min_txns?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Minimum unique traders.
+             */
             min_unique_traders?: number | null;
             /**
              * Format: double
@@ -1584,7 +2366,10 @@ export interface components {
              * @description Only fire when probability change % ≥ this value.
              */
             min_probability_change_pct?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Minimum fees.
+             */
             min_fees?: number | null;
         };
         /** @description Payload delivered when a position's volume or transaction metrics cross a configured threshold */
@@ -1670,47 +2455,110 @@ export interface components {
              * @description Builder-attributed fees in USD
              */
             builder_fees?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Transaction count.
+             */
             txns?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Buy count.
+             */
             buys?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Sell count.
+             */
             sells?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Builder-attributed transaction count.
+             */
             builder_txns?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Builder-attributed buy count.
+             */
             builder_buys?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Builder-attributed sell count.
+             */
             builder_sells?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique traders.
+             */
             unique_traders?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique makers.
+             */
             unique_makers?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique takers.
+             */
             unique_takers?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique builder traders.
+             */
             unique_builder_traders?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Opening price.
+             */
             price_open?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Closing price.
+             */
             price_close?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Highest price.
+             */
             price_high?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Lowest price.
+             */
             price_low?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Opening implied probability.
+             */
             probability_open?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Closing implied probability.
+             */
             probability_close?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Highest implied probability.
+             */
             probability_high?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Lowest implied probability.
+             */
             probability_low?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Average shares per trade.
+             */
             avg_trade_shares?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Average shares per buy.
+             */
             avg_buy_shares?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Average shares per sell.
+             */
             avg_sell_shares?: number | null;
         };
         PositionResolvedPayload: {
@@ -1854,6 +2702,11 @@ export interface components {
         };
         /** @description Subscription filters for the `position_volume_milestone` event. */
         PositionVolumeMilestoneFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description **Required.** Aggregation windows to monitor. */
             timeframes: components["schemas"]["MetricFilterTimeframe"][];
             /** @description Restrict to these outcome token IDs. */
@@ -1867,11 +2720,18 @@ export interface components {
         };
         /** @description Position volume milestone webhook payload */
         PositionVolumeMilestonePayload: {
+            /** @description Market condition ID. */
             condition_id?: string | null;
+            /** @description Outcome token ID. */
             position_id: string;
+            /** @description Outcome name. */
             outcome?: string | null;
-            /** Format: int32 */
+            /**
+             * Format: int32
+             * @description Outcome index.
+             */
             outcome_index?: number | null;
+            /** @description Metric timeframe. */
             timeframe: string;
             /**
              * Format: double
@@ -1916,6 +2776,11 @@ export interface components {
         };
         /** @description Subscription filters for the `position_volume_spike` event. `spike_ratio` is required. */
         PositionVolumeSpikeFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /**
              * Format: double
              * @description **Required.** Multiplier threshold (must be > 1.0). Fires when current volume >= snapshot × ratio.
@@ -1937,15 +2802,26 @@ export interface components {
         };
         /** @description Position volume spike webhook payload */
         PositionVolumeSpikePayload: {
+            /** @description Outcome token ID. */
             position_id: string;
+            /** @description Market condition ID. */
             condition_id: string;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Market slug. */
             market_slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Outcome name. */
             outcome?: string | null;
-            /** Format: int32 */
+            /**
+             * Format: int32
+             * @description Outcome index.
+             */
             outcome_index?: number | null;
+            /** @description Metric timeframe. */
             timeframe: string;
             /**
              * Format: double
@@ -1980,6 +2856,11 @@ export interface components {
         };
         /** @description Subscription filters for the `price_spike` event. */
         PriceSpikeFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Restrict to specific outcome token IDs. Empty = all positions. */
             position_ids?: string[] | null;
             /** @description Restrict to specific market condition IDs. Empty = all markets. */
@@ -1988,6 +2869,10 @@ export interface components {
             event_slugs?: string[] | null;
             /** @description Restrict to these outcome names (e.g. \["Yes", "No"\]). */
             outcomes?: string[] | null;
+            /** @description Restrict to markets carrying any of these tags or category names (case-insensitive). Empty = all. */
+            tags?: string[] | null;
+            /** @description Restrict to markets in any of these series (by slug, case-insensitive). Empty = all. */
+            series_slugs?: string[] | null;
             /**
              * Format: double
              * @description Minimum price percentage move to trigger (e.g. `10` for a 10% move).
@@ -2024,14 +2909,24 @@ export interface components {
         };
         /** @description Position price spike webhook payload */
         PriceSpikePayload: {
+            /** @description Outcome token ID. */
             position_id: string;
+            /** @description Market condition ID. */
             condition_id?: string | null;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Market slug. */
             market_slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Outcome name. */
             outcome?: string | null;
-            /** Format: int32 */
+            /**
+             * Format: int32
+             * @description Outcome index.
+             */
             outcome_index?: number | null;
             /**
              * Format: double
@@ -2051,8 +2946,126 @@ export interface components {
              */
             spike_pct: number;
         };
+        /** @description Subscription filters for the `price_threshold` event. */
+        PriceThresholdFilters: {
+            /** @description Restrict to markets carrying any of these tags or category names (case-insensitive). Empty = all. */
+            tags?: string[] | null;
+            /** @description Restrict to markets in any of these series (by slug, case-insensitive). Empty = all. */
+            series_slugs?: string[] | null;
+            /**
+             * Format: double
+             * @description Upward target — fire when the YES price crosses up to ≥ this value (e.g. 0.75 for 75%). At least one of `min_probability` or `max_probability` must be set.
+             */
+            min_probability?: number | null;
+            /**
+             * Format: double
+             * @description Downward target — fire when the YES price crosses down to ≤ this value (e.g. 0.25).
+             */
+            max_probability?: number | null;
+            /** @description When `true`, delete the subscription after its first delivery (fire-and-delete). Requires `position_ids` or `condition_ids`. Default: `false`. */
+            one_shot?: boolean | null;
+            /** @description When `true`, fire immediately if the first observed price is already past the target (no prior baseline). Default: `false` (wait for an actual crossing). */
+            fire_if_already_past?: boolean | null;
+            /** @description Restrict to these markets. */
+            condition_ids?: string[] | null;
+            /** @description Restrict to these outcome token IDs. */
+            position_ids?: string[] | null;
+            /** @description Restrict to markets in these events. */
+            event_slugs?: string[] | null;
+            /** @description Restrict to these outcome names (e.g. \["Yes", "No"\]). */
+            outcomes?: string[] | null;
+            /** @description Restrict by outcome index. 0 = Yes/Up, 1 = No. Position 0 usually represents the Up/Yes side in binary markets. */
+            position_outcome_indices?: number[] | null;
+            /** @description When `true`, suppress webhooks for short-term "updown" markets. Default: `false`. */
+            exclude_shortterm_markets?: boolean | null;
+        };
+        /** @description Price-threshold crossing webhook payload */
+        PriceThresholdPayload: {
+            /** @description Trader address (the limit-order maker) */
+            trader: string;
+            /** @description Taker address (the order filler — often the exchange contract) */
+            taker: string;
+            /** @description Position ID (ERC1155 token ID) */
+            position_id: string;
+            /** @description Condition ID (parent market) */
+            condition_id?: string | null;
+            /** @description Outcome name (e.g. "Yes", "No") */
+            outcome?: string | null;
+            /**
+             * Format: int32
+             * @description Outcome index (0 = Yes/Up, 1 = No). Position 0 usually represents Yes/Up.
+             */
+            outcome_index?: number | null;
+            /** @description Market question */
+            question?: string | null;
+            /** @description Market slug */
+            market_slug?: string | null;
+            /** @description Event slug */
+            event_slug?: string | null;
+            /** @description Trade ID */
+            trade_id: string;
+            /** @description Transaction hash */
+            hash: string;
+            /**
+             * Format: int64
+             * @description Block number
+             */
+            block: number;
+            /**
+             * Format: int64
+             * @description Confirmed timestamp (Unix seconds)
+             */
+            confirmed_at: number;
+            /**
+             * Format: double
+             * @description USD size of the trade
+             */
+            amount_usd: number;
+            /**
+             * Format: double
+             * @description Outcome shares traded
+             */
+            shares_amount: number;
+            /**
+             * Format: double
+             * @description Fee paid (USD)
+             */
+            fee: number;
+            /** @description Trade side ("Buy" or "Sell") */
+            side: string;
+            /**
+             * Format: double
+             * @description Last observed price before this trade (the baseline the crossing is measured from)
+             */
+            previous_price: number;
+            /**
+             * Format: double
+             * @description Price per share (0.0–1.0) that crossed the threshold
+             */
+            price: number;
+            /**
+             * Format: double
+             * @description Implied probability of the outcome (0.0–1.0)
+             */
+            probability?: number | null;
+            /**
+             * @description Crossing direction: `"up"` (crossed up to the `min_probability` target) or
+             *     `"down"` (crossed down to the `max_probability` target)
+             */
+            direction: string;
+            /**
+             * Format: double
+             * @description The target threshold from the subscriber's filter that was crossed
+             */
+            threshold: number;
+        };
         /** @description Subscription filters for the `probability_spike` event. */
         ProbabilitySpikeFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Restrict to specific outcome token IDs. Empty = all positions. */
             position_ids?: string[] | null;
             /** @description Restrict to specific market condition IDs. Empty = all markets. */
@@ -2071,6 +3084,10 @@ export interface components {
              * @description Maximum YES probability (0-1).
              */
             max_probability?: number | null;
+            /** @description Restrict to markets carrying any of these tags or category names (case-insensitive). Empty = all. */
+            tags?: string[] | null;
+            /** @description Restrict to markets in any of these series (by slug, case-insensitive). Empty = all. */
+            series_slugs?: string[] | null;
             /**
              * Format: double
              * @description Minimum probability percentage move to trigger (e.g. `10` for a 10% move).
@@ -2097,14 +3114,24 @@ export interface components {
         };
         /** @description Position probability spike webhook payload */
         ProbabilitySpikePayload: {
+            /** @description Outcome token ID. */
             position_id: string;
+            /** @description Market condition ID. */
             condition_id?: string | null;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Market slug. */
             market_slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Outcome name. */
             outcome?: string | null;
-            /** Format: int32 */
+            /**
+             * Format: int32
+             * @description Outcome index.
+             */
             outcome_index?: number | null;
             /**
              * Format: double
@@ -2415,6 +3442,11 @@ export interface components {
         SpikeDirection: "up" | "down" | "both";
         /** @description Subscription filters for the `tag_metrics` event. All fields are optional. */
         TagMetricsFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Restrict to these tags. Empty = all tags. */
             tags?: string[] | null;
             /** @description Restrict to these aggregation windows. */
@@ -2424,13 +3456,25 @@ export interface components {
              * @description Only fire when aggregated tag volume >= this value (USD).
              */
             min_volume_usd?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Maximum volume USD.
+             */
             max_volume_usd?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Minimum transactions.
+             */
             min_txns?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Minimum unique traders.
+             */
             min_unique_traders?: number | null;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Minimum fees.
+             */
             min_fees?: number | null;
         };
         /** @description Payload delivered when a tag's aggregated volume or transaction metrics cross a configured threshold */
@@ -2508,6 +3552,11 @@ export interface components {
         TradeEventFilterType: "OrderFilled" | "OrdersMatched" | "MakerRebate" | "Reward" | "Yield" | "Redemption" | "Merge" | "Split" | "Cancelled" | "PositionsConverted" | "Initialization" | "Proposal" | "Dispute" | "Settled" | "Resolution" | "ConditionResolution" | "Reset" | "Flag" | "Unflag" | "Pause" | "Unpause" | "ManualResolution" | "NegRiskOutcomeReported" | "RegisterToken";
         /** @description Subscription filters for the `trader_category_pnl` event. All fields are optional. */
         TraderCategoryPnlFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Track only these trader wallet addresses. Empty = all traders. */
             traders?: string[] | null;
             /** @description Restrict to these market categories (e.g. `politics`, `sports`). */
@@ -2557,6 +3606,11 @@ export interface components {
         };
         /** @description Subscription filters for the `trader_pnl_exits` event. All fields are optional. */
         TraderExitMarkersFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Track only these trader wallet addresses. Empty = all traders. */
             traders?: string[] | null;
             /** @description Restrict to these markets. */
@@ -2566,6 +3620,11 @@ export interface components {
         };
         /** @description Subscription filters for the `trader_first_trade` event. All fields are optional. */
         TraderFirstTradeFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Only fire for trades by these wallet addresses (lowercase). Empty = all traders. */
             wallet_addresses?: string[] | null;
             /** @description Restrict to trades in these markets. Empty = all markets. */
@@ -2592,6 +3651,11 @@ export interface components {
         };
         /** @description Subscription filters for the `trader_global_pnl` event. All fields are optional. */
         TraderGlobalPnlFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Track only these trader wallet addresses. Empty = all traders. */
             traders?: string[] | null;
             /**
@@ -2639,6 +3703,11 @@ export interface components {
         };
         /** @description Subscription filters for the `trader_market_pnl` event. All fields are optional. */
         TraderMarketPnlFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Track only these trader wallet addresses. */
             traders?: string[] | null;
             /** @description Restrict to these markets. */
@@ -2682,6 +3751,11 @@ export interface components {
         };
         /** @description Subscription filters for the `trader_new_market` event. All fields are optional. */
         TraderNewMarketFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Only fire for these wallet addresses (lowercase). Empty = all traders. */
             wallet_addresses?: string[] | null;
             /** @description Restrict to these markets. */
@@ -2708,6 +3782,11 @@ export interface components {
         };
         /** @description Subscription filters for the `trader_new_trade` event. All fields are optional. */
         TraderNewTradeFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Only fire for trades by these wallet addresses. Empty = all traders. */
             wallet_addresses?: string[] | null;
             /** @description Restrict to these markets. */
@@ -2736,6 +3815,11 @@ export interface components {
         };
         /** @description Subscription filters for the `trader_position_resolved` event. All fields are optional. */
         TraderPositionResolvedFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Track only these trader wallet addresses. Empty = all traders. */
             traders?: string[] | null;
             /** @description Restrict to these markets. */
@@ -2754,6 +3838,11 @@ export interface components {
          *     `event_slug` in the typed webhook payload.
          */
         TraderTradeEventFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Only fire for events associated with these wallet addresses. Empty = all traders. */
             wallet_addresses?: string[] | null;
             /** @description Restrict to these markets. For `PositionsConverted`, this also matches the NegRisk `market_id`. */
@@ -2782,6 +3871,11 @@ export interface components {
         };
         /** @description Subscription filters for the `trader_whale_trade` event. All fields are optional. */
         TraderWhaleTradeFilters: {
+            /**
+             * @description Fire-and-delete: when `true`, delete the subscription after its first
+             *     successful delivery. Applies to any webhook event.
+             */
+            one_shot?: boolean | null;
             /** @description Only fire for trades by these wallet addresses. Empty = all traders. */
             wallet_addresses?: string[] | null;
             /** @description Restrict to these markets. */
@@ -2820,7 +3914,9 @@ export interface components {
         };
         /** @description Volume milestone webhook payload */
         VolumeMilestonePayload: {
+            /** @description Market condition ID. */
             condition_id: string;
+            /** @description Metric timeframe. */
             timeframe: string;
             /**
              * Format: double
@@ -2882,8 +3978,16 @@ export interface components {
             position_ids?: string[];
             /** @description Filter by event slugs. Max 500 entries. */
             event_slugs?: string[];
-            /** @description Filter by tags or category names (case-insensitive) — for market_created. Max 500 entries. */
+            /**
+             * @description Filter by tags or category names (case-insensitive). Matches a market's tags or its
+             *     category label — for market_created and all market-keyed events. Max 500 entries.
+             */
             tags?: string[];
+            /**
+             * @description Filter by series slugs (case-insensitive). Matches a market's parent series — for all
+             *     market-keyed events. Max 500 entries.
+             */
+            series_slugs?: string[];
             /** @description Filter by outcomes (e.g. "Yes", "No") — for position metrics / close_to_bond. Max 500 entries. */
             outcomes?: string[];
             /** @description Filter by position outcome index — for close_to_bond. Position 0 = Yes/Up, 1 = No. Max 500 entries. */
@@ -3006,6 +4110,17 @@ export interface components {
              *     Valid values: "BTC", "ETH", "SOL", "XRP", "DOGE", "BNB", "HYPE". Empty = all assets (send everything).
              */
             asset_symbols?: components["schemas"]["WebhookAssetSymbol"][];
+            /**
+             * @description Fire-and-delete: delete the subscription after its first successful
+             *     delivery. Works on any webhook event. (`price_threshold` additionally
+             *     requires `position_ids` or `condition_ids`.)
+             */
+            one_shot?: boolean;
+            /**
+             * @description For `price_threshold` — fire immediately if the first observed price is
+             *     already past the target. Default `false` (wait for an actual crossing).
+             */
+            fire_if_already_past?: boolean;
         };
         /** @description List webhooks response */
         WebhookListResponseBody: {
@@ -3189,6 +4304,7 @@ export interface components {
             /**
              * @description CLOB V2 builder code (lower-cased `0x...` bytes32 hex). Absent on V1
              *     trades; may be `0x0000…` for V2 trades placed without a builder code.
+             *     CLOB builder code.
              */
             builder_code?: string | null;
             /**
@@ -3199,19 +4315,30 @@ export interface components {
         };
         /** @description Server acknowledgement for an oracle events stream subscription */
         OracleEventsStreamSubscribeResponse: {
+            /** @description Accepted market condition IDs. */
             condition_ids?: string[];
+            /** @description Accepted market slugs. */
             market_slugs?: string[];
+            /** @description Accepted event slugs. */
             event_slugs?: string[];
+            /** @description Accepted oracle event types. */
             oracle_event_types?: string[];
-            /** @enum {string} */
+            /**
+             * @description Trade status filter.
+             * @enum {string}
+             */
             status?: "confirmed" | "pending" | "all";
+            /** @description Whether to subscribe to all matching events. */
             subscribe_all?: boolean;
             /** @description Filter values that were rejected (invalid format or unknown type) */
             rejected?: string[];
         };
         /** @description Subscribe to the oracle events stream. No filters = subscribe to all events. */
         OracleEventsStreamSubscribeMessage: {
-            /** @enum {string} */
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
             action: "subscribe" | "unsubscribe_all";
             /** @description 64-char hex condition IDs (with or without 0x prefix) */
             condition_ids?: string[];
@@ -3233,23 +4360,38 @@ export interface components {
         MarketsStreamUpdateEvent: {
             /** @enum {string} */
             type: "markets_stream_update";
-            /** @enum {string} */
+            /**
+             * @description WebSocket room ID.
+             * @enum {string}
+             */
             room_id: "polymarket_markets_stream";
-            /** @enum {string} */
+            /**
+             * @description Subscription mode.
+             * @enum {string}
+             */
             mode: "filter" | "ids";
-            /** @enum {integer} */
+            /**
+             * @description Flush interval in milliseconds.
+             * @enum {integer}
+             */
             interval_ms: 500 | 1000 | 3000 | 10000;
             /** @description Full market rows (same shape as `GET /polymarket/market`). Not a delta — each element is a complete row replacement. */
             data: Record<string, never>[];
         };
         /** @description Server acknowledgement for a markets_stream subscribe/unsubscribe. Envelope type: "markets_stream_subscribe_response". */
         MarketsStreamSubscribeResponse: {
-            /** @enum {string} */
+            /**
+             * @description Subscription mode.
+             * @enum {string}
+             */
             mode?: "filter" | "ids" | "";
+            /** @description Flush interval in milliseconds. */
             interval_ms?: number;
             /** @description Accepted condition_ids (ids mode). */
             condition_ids?: string[];
+            /** @description Accepted market slugs. */
             market_slugs?: string[];
+            /** @description Accepted event slugs. */
             event_slugs?: string[];
             /** @description Ids that failed normalization or exceeded the per-sub cap. */
             rejected?: string[];
@@ -3260,21 +4402,39 @@ export interface components {
         MarketsStreamFilter: {
             /** @description Case-insensitive substring match on `title`. 3–100 chars. */
             search?: string;
+            /** @description Categories to include. */
             categories?: string[];
+            /** @description Categories to exclude. */
             exclude_categories?: string[];
+            /** @description Accepted tag slugs. */
             tags?: string[];
+            /** @description Tags to exclude. */
             exclude_tags?: string[];
+            /** @description Minimum volume. */
             min_volume?: number;
+            /** @description Maximum volume. */
             max_volume?: number;
+            /** @description Minimum transaction count. */
             min_txns?: number;
+            /** @description Maximum transaction count. */
             max_txns?: number;
+            /** @description Minimum unique trader count. */
             min_unique_traders?: number;
+            /** @description Maximum unique trader count. */
             max_unique_traders?: number;
+            /** @description Minimum liquidity. */
             min_liquidity?: number;
+            /** @description Maximum liquidity. */
             max_liquidity?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Minimum holder count.
+             */
             min_holders?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Maximum holder count.
+             */
             max_holders?: number;
             /**
              * Format: int64
@@ -3296,7 +4456,10 @@ export interface components {
         };
         /** @description Subscribe to the trades stream. No filters = subscribe to all trades. */
         TradesStreamSubscribeMessage: {
-            /** @enum {string} */
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
             action: "subscribe" | "unsubscribe_all";
             /** @description 64-char hex condition IDs (with or without 0x prefix) */
             condition_ids?: string[];
@@ -3320,14 +4483,24 @@ export interface components {
         };
         /** @description Server acknowledgement for a trades stream subscription */
         TradesStreamSubscribeResponse: {
+            /** @description Accepted market condition IDs. */
             condition_ids?: string[];
+            /** @description Accepted market slugs. */
             market_slugs?: string[];
+            /** @description Accepted event slugs. */
             event_slugs?: string[];
+            /** @description Accepted outcome token IDs. */
             position_ids?: string[];
+            /** @description Accepted trader wallets. */
             traders?: string[];
+            /** @description Accepted trade types. */
             trade_types?: string[];
-            /** @enum {string} */
+            /**
+             * @description Trade status filter.
+             * @enum {string}
+             */
             status?: "confirmed" | "pending" | "all";
+            /** @description Whether to subscribe to all matching events. */
             subscribe_all?: boolean;
             /** @description Filter values that were rejected (invalid format or unknown type) */
             rejected?: string[];
@@ -3340,9 +4513,14 @@ export interface components {
          *     **Pending trades:** `block`, `confirmed_at`, `log_index`, `block_index` are absent. `received_at` (milliseconds) is included instead. For OrderFilled/OrdersMatched, `order_hash`, `taker`, `fee`, `fee_shares`, `fee_pct` are also absent.
          */
         TradeStreamEvent: {
-            /** @enum {string} */
+            /**
+             * @description Trade type.
+             * @enum {string}
+             */
             trade_type: "OrderFilled" | "OrdersMatched";
+            /** @description Event ID. */
             id: string;
+            /** @description Transaction hash. */
             hash: string;
             /** @description Absent for pending trades */
             block?: number;
@@ -3357,28 +4535,49 @@ export interface components {
             /** @description Absent for pending trades */
             order_hash?: string;
             trader: {
+                /** @description Wallet address. */
                 address?: string;
+                /** @description Display name. */
                 name?: string | null;
+                /** @description Pseudonym. */
                 pseudonym?: string | null;
+                /** @description Profile image URL. */
                 profile_image?: string | null;
+                /** @description X username. */
                 x_username?: string | null;
+                /** @description Whether the profile is verified. */
                 verified_badge?: boolean;
             };
             /** @description Absent for pending trades */
             taker?: string;
-            /** @enum {string} */
+            /**
+             * @description Trade side.
+             * @enum {string}
+             */
             side?: "Buy" | "Sell";
+            /** @description Market condition ID. */
             condition_id?: string | null;
+            /** @description Outcome token ID. */
             position_id?: string;
+            /** @description Outcome name. */
             outcome?: string | null;
+            /** @description Outcome index. */
             outcome_index?: number | null;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Market slug. */
             slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Trade amount in USD. */
             usd_amount?: number;
+            /** @description Trade size in shares. */
             shares_amount?: number;
+            /** @description Outcome price. */
             price?: number;
+            /** @description Implied probability. */
             probability?: number | null;
             /** @description Absent for pending trades */
             fee?: number;
@@ -3386,31 +4585,49 @@ export interface components {
             fee_shares?: number;
             /** @description Absent for pending trades */
             fee_pct?: number;
+            /** @description Exchange identifier. */
             exchange: number;
             /** @description CLOB V2 builder code (lower-cased `0x...` bytes32 hex). Absent on V1 trades; may be `0x0000…` for V2 trades placed without a builder code. */
             builder_code?: string;
             /** @description Builder fee in USDC. Absent when no builder code is attached. */
             builder_fee?: number;
         } | {
-            /** @enum {string} */
+            /**
+             * @description Trade type.
+             * @enum {string}
+             */
             trade_type: "MakerRebate" | "Reward" | "Yield";
+            /** @description Event ID. */
             id: string;
+            /** @description Transaction hash. */
             hash: string;
+            /** @description Block number. */
             block?: number;
+            /** @description Confirmation timestamp. */
             confirmed_at?: number;
+            /** @description Receive timestamp. */
             received_at?: number;
+            /** @description Log index. */
             log_index?: number;
+            /** @description Block index. */
             block_index?: number;
             trader: {
+                /** @description Wallet address. */
                 address?: string;
+                /** @description Display name. */
                 name?: string | null;
+                /** @description Pseudonym. */
                 pseudonym?: string | null;
+                /** @description Profile image URL. */
                 profile_image?: string | null;
+                /** @description X username. */
                 x_username?: string | null;
+                /** @description Whether the profile is verified. */
                 verified_badge?: boolean;
             };
             /** @description Payout distributor address */
             taker?: string;
+            /** @description Trade amount in USD. */
             usd_amount?: number;
             /** @description Always 0 for payout credits */
             shares_amount?: number;
@@ -3425,195 +4642,370 @@ export interface components {
             /** @description Unknown/non-exchange credit source */
             exchange: number;
         } | {
-            /** @enum {string} */
+            /**
+             * @description Trade type.
+             * @enum {string}
+             */
             trade_type: "Redemption";
+            /** @description Event ID. */
             id: string;
+            /** @description Transaction hash. */
             hash: string;
+            /** @description Block number. */
             block?: number;
+            /** @description Confirmation timestamp. */
             confirmed_at?: number;
+            /** @description Receive timestamp. */
             received_at?: number;
+            /** @description Log index. */
             log_index?: number;
+            /** @description Block index. */
             block_index?: number;
             trader: {
+                /** @description Wallet address. */
                 address?: string;
+                /** @description Display name. */
                 name?: string | null;
+                /** @description Pseudonym. */
                 pseudonym?: string | null;
+                /** @description Profile image URL. */
                 profile_image?: string | null;
+                /** @description X username. */
                 x_username?: string | null;
+                /** @description Whether the profile is verified. */
                 verified_badge?: boolean;
             };
+            /** @description Market condition ID. */
             condition_id?: string | null;
+            /** @description Outcome name. */
             outcome?: string | null;
+            /** @description Outcome index. */
             outcome_index?: number | null;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Market slug. */
             slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Trade amount in USD. */
             usd_amount?: number;
+            /** @description Winning outcome index. */
             winning_outcome_index?: number | null;
+            /** @description Position details. */
             position_details?: {
+                /** @description Outcome token ID. */
                 position_id?: string;
+                /** @description Outcome index. */
                 outcome_index?: number;
+                /** @description Amount as a decimal string. */
                 amount?: string;
             }[];
+            /** @description Exchange identifier. */
             exchange: number;
         } | {
-            /** @enum {string} */
+            /**
+             * @description Trade type.
+             * @enum {string}
+             */
             trade_type: "Merge";
+            /** @description Event ID. */
             id: string;
+            /** @description Transaction hash. */
             hash: string;
+            /** @description Block number. */
             block?: number;
+            /** @description Confirmation timestamp. */
             confirmed_at?: number;
+            /** @description Receive timestamp. */
             received_at?: number;
+            /** @description Log index. */
             log_index?: number;
+            /** @description Block index. */
             block_index?: number;
             trader: {
+                /** @description Wallet address. */
                 address?: string;
+                /** @description Display name. */
                 name?: string | null;
+                /** @description Pseudonym. */
                 pseudonym?: string | null;
+                /** @description Profile image URL. */
                 profile_image?: string | null;
+                /** @description X username. */
                 x_username?: string | null;
+                /** @description Whether the profile is verified. */
                 verified_badge?: boolean;
             };
+            /** @description Market condition ID. */
             condition_id?: string | null;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Market slug. */
             slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Trade amount in USD. */
             usd_amount?: number;
+            /** @description Position details. */
             position_details?: {
+                /** @description Outcome token ID. */
                 position_id?: string;
+                /** @description Outcome index. */
                 outcome_index?: number;
+                /** @description Amount as a decimal string. */
                 amount?: string;
             }[];
+            /** @description Exchange identifier. */
             exchange: number;
         } | {
-            /** @enum {string} */
+            /**
+             * @description Trade type.
+             * @enum {string}
+             */
             trade_type: "Split";
+            /** @description Event ID. */
             id: string;
+            /** @description Transaction hash. */
             hash: string;
+            /** @description Block number. */
             block?: number;
+            /** @description Confirmation timestamp. */
             confirmed_at?: number;
+            /** @description Receive timestamp. */
             received_at?: number;
+            /** @description Log index. */
             log_index?: number;
+            /** @description Block index. */
             block_index?: number;
             trader: {
+                /** @description Wallet address. */
                 address?: string;
+                /** @description Display name. */
                 name?: string | null;
+                /** @description Pseudonym. */
                 pseudonym?: string | null;
+                /** @description Profile image URL. */
                 profile_image?: string | null;
+                /** @description X username. */
                 x_username?: string | null;
+                /** @description Whether the profile is verified. */
                 verified_badge?: boolean;
             };
+            /** @description Market condition ID. */
             condition_id?: string | null;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Market slug. */
             slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Trade amount in USD. */
             usd_amount?: number;
+            /** @description Position details. */
             position_details?: {
+                /** @description Outcome token ID. */
                 position_id?: string;
+                /** @description Outcome index. */
                 outcome_index?: number;
+                /** @description Amount as a decimal string. */
                 amount?: string;
             }[];
+            /** @description Exchange identifier. */
             exchange: number;
         } | {
-            /** @enum {string} */
+            /**
+             * @description Trade type.
+             * @enum {string}
+             */
             trade_type: "PositionsConverted";
+            /** @description Event ID. */
             id: string;
+            /** @description Transaction hash. */
             hash: string;
+            /** @description Block number. */
             block?: number;
+            /** @description Confirmation timestamp. */
             confirmed_at?: number;
+            /** @description Receive timestamp. */
             received_at?: number;
+            /** @description Log index. */
             log_index?: number;
+            /** @description Block index. */
             block_index?: number;
             trader: {
+                /** @description Wallet address. */
                 address?: string;
+                /** @description Display name. */
                 name?: string | null;
+                /** @description Pseudonym. */
                 pseudonym?: string | null;
+                /** @description Profile image URL. */
                 profile_image?: string | null;
+                /** @description X username. */
                 x_username?: string | null;
+                /** @description Whether the profile is verified. */
                 verified_badge?: boolean;
             };
+            /** @description Market id. */
             market_id?: string;
+            /** @description Index set. */
             index_set?: string;
+            /** @description Trade size in shares. */
             shares_amount?: number;
+            /** @description Fee. */
             fee?: number;
+            /** @description Fee percent. */
             fee_pct?: number;
             /** @description Per-position conversion amounts */
             position_details?: {
+                /** @description Outcome token ID. */
                 position_id?: string;
+                /** @description Outcome index. */
                 outcome_index?: number;
+                /** @description Amount as a decimal string. */
                 amount?: string;
             }[];
+            /** @description Exchange identifier. */
             exchange: number;
         } | {
-            /** @enum {string} */
+            /**
+             * @description Trade type.
+             * @enum {string}
+             */
             trade_type: "Cancelled";
+            /** @description Event ID. */
             id: string;
+            /** @description Transaction hash. */
             hash: string;
+            /** @description Block number. */
             block?: number;
+            /** @description Confirmation timestamp. */
             confirmed_at?: number;
+            /** @description Receive timestamp. */
             received_at?: number;
+            /** @description Log index. */
             log_index?: number;
+            /** @description Block index. */
             block_index?: number;
+            /** @description Order hash. */
             order_hash?: string;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Market slug. */
             slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Exchange identifier. */
             exchange: number;
         } | {
-            /** @enum {string} */
+            /**
+             * @description Oracle lifecycle event type.
+             * @enum {string}
+             */
             trade_type: "Initialization" | "Proposal" | "Dispute" | "Settled" | "Resolution" | "ConditionResolution" | "Reset" | "Flag" | "Unflag" | "Pause" | "Unpause" | "ManualResolution" | "NegRiskOutcomeReported";
+            /** @description Event ID. */
             id: string;
+            /** @description Transaction hash. */
             hash: string;
+            /** @description Block number. */
             block?: number;
+            /** @description Confirmation timestamp. */
             confirmed_at?: number;
+            /** @description Receive timestamp. */
             received_at?: number;
+            /** @description Log index. */
             log_index?: number;
+            /** @description Block index. */
             block_index?: number;
+            /** @description Oracle contract. */
             oracle_contract: string;
+            /** @description Market condition ID. */
             condition_id: string;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Market slug. */
             slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Assertion id. */
             assertion_id?: string | null;
+            /** @description Proposer. */
             proposer?: string | null;
+            /** @description Disputer. */
             disputer?: string | null;
+            /** @description Proposed outcome. */
             proposed_outcome?: string | null;
+            /** @description Settled price. */
             settled_price?: number | null;
+            /** @description Disputed. */
             disputed?: boolean | null;
+            /** @description Settlement resolution. */
             settlement_resolution?: boolean | null;
+            /** @description Bond. */
             bond?: string | null;
+            /** @description Expiration time. */
             expiration_time?: number | null;
+            /** @description Creator. */
             creator?: string | null;
+            /** @description Reward token. */
             reward_token?: string | null;
+            /** @description Reward details. */
             reward?: string | null;
+            /** @description Proposal bond. */
             proposal_bond?: string | null;
         } | {
-            /** @enum {string} */
+            /**
+             * @description Trade type.
+             * @enum {string}
+             */
             trade_type: "RegisterToken";
+            /** @description Event ID. */
             id: string;
+            /** @description Transaction hash. */
             hash: string;
+            /** @description Block number. */
             block?: number;
+            /** @description Confirmation timestamp. */
             confirmed_at?: number;
+            /** @description Receive timestamp. */
             received_at?: number;
+            /** @description Log index. */
             log_index?: number;
+            /** @description Block index. */
             block_index?: number;
+            /** @description Market condition ID. */
             condition_id: string;
+            /** @description Token0. */
             token0?: string;
+            /** @description Token1. */
             token1?: string;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Market slug. */
             slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Exchange identifier. */
             exchange: number;
         };
         /** @description Subscribe to the asset prices stream. Empty asset_symbols = all assets. */
         AssetPricesSubscribeMessage: {
-            /** @enum {string} */
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
             action: "subscribe" | "unsubscribe_all";
             /** @description Uppercase asset symbols (BTC, ETH, SOL, XRP, DOGE, BNB, HYPE). Empty = subscribe to all. */
             asset_symbols?: string[];
@@ -3674,7 +5066,10 @@ export interface components {
         };
         /** @description Subscribe to the asset window updates stream. At least one of asset_symbols or timeframes must be non-empty. */
         AssetWindowUpdatesSubscribeMessage: {
-            /** @enum {string} */
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
             action: "subscribe" | "unsubscribe_all";
             /** @description Uppercase asset symbols (BTC, ETH, SOL, XRP, DOGE, BNB, HYPE) */
             asset_symbols?: string[];
@@ -3683,7 +5078,9 @@ export interface components {
         };
         /** @description Server acknowledgement for an asset window updates subscription */
         AssetWindowUpdatesSubscribeResponse: {
+            /** @description Accepted asset symbols. */
             asset_symbols?: string[];
+            /** @description Accepted metric timeframes. */
             timeframes?: string[];
             /** @description Set if the subscription was rejected (e.g. no filters provided) */
             error?: string | null;
@@ -3692,15 +5089,21 @@ export interface components {
         AssetWindowUpdateEvent: components["schemas"]["AssetPriceWindowUpdateEvent"];
         /** @description Subscribe to the market metrics stream. condition_ids is required and must be non-empty. */
         MarketMetricsSubscribeMessage: {
-            /** @enum {string} */
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
             action: "subscribe" | "unsubscribe_all";
             /** @description 64-char hex condition IDs (with or without 0x prefix) */
             condition_ids: string[];
+            /** @description Accepted metric timeframes. */
             timeframes?: ("1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d" | "lifetime")[];
         };
         /** @description Server acknowledgement for a market metrics subscription */
         MarketMetricsSubscribeResponse: {
+            /** @description Accepted market condition IDs. */
             condition_ids?: string[];
+            /** @description Accepted metric timeframes. */
             timeframes?: string[];
             /** @description Condition IDs that were rejected (invalid format) */
             rejected?: string[];
@@ -3711,7 +5114,10 @@ export interface components {
         MarketMetricsEvent: {
             /** @description 64-char hex condition ID */
             condition_id: string;
-            /** @enum {string} */
+            /**
+             * @description Metric timeframe.
+             * @enum {string}
+             */
             timeframe: "1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d" | "lifetime";
             /**
              * Format: int64
@@ -3740,34 +5146,58 @@ export interface components {
              * @description Builder-attributed transactions
              */
             builder_txns: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique trader count.
+             */
             unique_traders: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique maker count.
+             */
             unique_makers: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique taker count.
+             */
             unique_takers: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique builder-attributed trader count.
+             */
             unique_builder_traders: number;
         };
         /** @description Subscribe to the event metrics stream. event_slugs is required and must be non-empty. */
         EventMetricsSubscribeMessage: {
-            /** @enum {string} */
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
             action: "subscribe" | "unsubscribe_all";
             /** @description Event slugs (lowercase) */
             event_slugs: string[];
+            /** @description Accepted metric timeframes. */
             timeframes?: ("1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d" | "lifetime")[];
         };
         /** @description Server acknowledgement for an event metrics subscription */
         EventMetricsSubscribeResponse: {
+            /** @description Accepted event slugs. */
             event_slugs?: string[];
+            /** @description Accepted metric timeframes. */
             timeframes?: string[];
+            /** @description Rejected filter values. */
             rejected?: string[];
+            /** @description Subscription error message. */
             error?: string | null;
         };
         /** @description Server-pushed event: aggregated metrics update for one timeframe of an event. Envelope type: "event_metrics_update". One event is emitted per timeframe window on each update. */
         EventMetricsEvent: {
+            /** @description Event slug. */
             event_slug: string;
-            /** @enum {string} */
+            /**
+             * @description Metric timeframe.
+             * @enum {string}
+             */
             timeframe: "1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d" | "lifetime";
             /**
              * Format: int64
@@ -3782,40 +5212,72 @@ export interface components {
             builder_usd_volume: string;
             /** @description Builder-attributed shares/contracts volume in this timeframe window (decimal string) */
             builder_shares_volume: string;
+            /** @description Total fees. */
             fees: number;
+            /** @description Builder-attributed fees. */
             builder_fees: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Transaction count.
+             */
             txns: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Builder-attributed transaction count.
+             */
             builder_txns: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique trader count.
+             */
             unique_traders: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique maker count.
+             */
             unique_makers: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique taker count.
+             */
             unique_takers: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique builder-attributed trader count.
+             */
             unique_builder_traders: number;
         };
         /** @description Subscribe to the tag metrics stream. tags is required and must be non-empty. */
         TagMetricsSubscribeMessage: {
-            /** @enum {string} */
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
             action: "subscribe" | "unsubscribe_all";
             /** @description Tag labels or slugs, matched case-insensitively */
             tags: string[];
+            /** @description Accepted metric timeframes. */
             timeframes?: ("1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d" | "lifetime")[];
         };
         /** @description Server acknowledgement for a tag metrics subscription */
         TagMetricsSubscribeResponse: {
+            /** @description Accepted tag slugs. */
             tags?: string[];
+            /** @description Accepted metric timeframes. */
             timeframes?: string[];
+            /** @description Rejected filter values. */
             rejected?: string[];
+            /** @description Subscription error message. */
             error?: string | null;
         };
         /** @description Server-pushed event: aggregated metrics update for one timeframe of a tag. Envelope type: "tag_metrics_update". One event is emitted per timeframe window on each update. */
         TagMetricsEvent: {
+            /** @description Tag slug. */
             tag: string;
-            /** @enum {string} */
+            /**
+             * @description Metric timeframe.
+             * @enum {string}
+             */
             timeframe: "1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d" | "lifetime";
             /**
              * Format: int64
@@ -3830,34 +5292,62 @@ export interface components {
             builder_usd_volume: string;
             /** @description Builder-attributed shares/contracts volume in this timeframe window (decimal string) */
             builder_shares_volume: string;
+            /** @description Total fees. */
             fees: number;
+            /** @description Builder-attributed fees. */
             builder_fees: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Transaction count.
+             */
             txns: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Builder-attributed transaction count.
+             */
             builder_txns: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique trader count.
+             */
             unique_traders: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique maker count.
+             */
             unique_makers: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique taker count.
+             */
             unique_takers: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique builder-attributed trader count.
+             */
             unique_builder_traders: number;
         };
         /** @description Subscribe to the position metrics stream. position_ids is required and must be non-empty. */
         PositionMetricsSubscribeMessage: {
-            /** @enum {string} */
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
             action: "subscribe" | "unsubscribe_all";
             /** @description ERC-1155 outcome token IDs (decimal or hex strings) */
             position_ids: string[];
+            /** @description Accepted metric timeframes. */
             timeframes?: ("1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d" | "lifetime")[];
         };
         /** @description Server acknowledgement for a position metrics subscription */
         PositionMetricsSubscribeResponse: {
+            /** @description Accepted outcome token IDs. */
             position_ids?: string[];
+            /** @description Accepted metric timeframes. */
             timeframes?: string[];
+            /** @description Rejected filter values. */
             rejected?: string[];
+            /** @description Subscription error message. */
             error?: string | null;
         };
         /** @description Server-pushed event: metrics update for one timeframe of an outcome token. Envelope type: "position_metrics_update". One event is emitted per timeframe window on each update. */
@@ -3868,8 +5358,12 @@ export interface components {
             position_id: string;
             /** @description Outcome name (e.g. "Yes") */
             outcome?: string | null;
+            /** @description Outcome index. */
             outcome_index?: number | null;
-            /** @enum {string} */
+            /**
+             * @description Metric timeframe.
+             * @enum {string}
+             */
             timeframe: "1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d" | "lifetime";
             /**
              * Format: int64
@@ -3900,27 +5394,59 @@ export interface components {
             builder_shares_buy_volume: string;
             /** @description Builder-attributed sell shares/contracts volume (decimal string) */
             builder_shares_sell_volume: string;
+            /** @description Total fees. */
             fees: number;
+            /** @description Builder-attributed fees. */
             builder_fees: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Transaction count.
+             */
             txns: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Buy count.
+             */
             buys: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Sell count.
+             */
             sells: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Builder-attributed transaction count.
+             */
             builder_txns: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Builder-attributed buy count.
+             */
             builder_buys: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Builder-attributed sell count.
+             */
             builder_sells: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique trader count.
+             */
             unique_traders: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique maker count.
+             */
             unique_makers: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique taker count.
+             */
             unique_takers: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Unique builder-attributed trader count.
+             */
             unique_builder_traders: number;
             /** @description OHLC open price (0–1) */
             price_open: number;
@@ -3938,13 +5464,85 @@ export interface components {
             probability_high: number;
             /** @description Lowest implied probability in window (0–1) */
             probability_low: number;
+            /** @description Average shares per trade. */
             avg_trade_shares: number;
+            /** @description Average shares per buy. */
             avg_buy_shares: number;
+            /** @description Average shares per sell. */
             avg_sell_shares: number;
         };
+        /** @description Subscribe to the position liquidity stream. position_ids is optional — omit for firehose. */
+        PositionLiquiditySubscribeMessage: {
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
+            action: "subscribe" | "unsubscribe_all";
+            /** @description ERC-1155 outcome token IDs (decimal or hex). Empty/omitted = all positions. */
+            position_ids?: string[];
+        };
+        /** @description Server-pushed event: latest USD liquidity for an outcome token. Envelope type: "position_liquidity_update". */
+        PositionLiquidityEvent: {
+            /** @description ERC-1155 token ID (decimal string) */
+            position_id: string;
+            /** @description Order-book liquidity in USD */
+            liquidity_usd: number;
+            /**
+             * Format: int64
+             * @description Update timestamp (Unix millis)
+             */
+            liquidity_updated_at: number;
+        };
+        /** @description Subscribe to the market liquidity stream. condition_ids is optional — omit for firehose. */
+        MarketLiquiditySubscribeMessage: {
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
+            action: "subscribe" | "unsubscribe_all";
+            /** @description 64-char hex market IDs. Empty/omitted = all markets. */
+            condition_ids?: string[];
+        };
+        /** @description Server-pushed event: latest total USD liquidity for a market. Envelope type: "market_liquidity_update". */
+        MarketLiquidityEvent: {
+            /** @description 64-char hex condition ID */
+            condition_id: string;
+            /** @description Total order-book liquidity in USD */
+            liquidity_usd: number;
+            /**
+             * Format: int64
+             * @description Update timestamp (Unix millis)
+             */
+            liquidity_updated_at: number;
+        };
+        /** @description Subscribe to the event liquidity stream. event_slugs is optional — omit for firehose. */
+        EventLiquiditySubscribeMessage: {
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
+            action: "subscribe" | "unsubscribe_all";
+            /** @description Event slugs. Empty/omitted = all events. */
+            event_slugs?: string[];
+        };
+        /** @description Server-pushed event: latest total USD liquidity for an event. Envelope type: "event_liquidity_update". */
+        EventLiquidityEvent: {
+            /** @description Event slug */
+            event_slug: string;
+            /** @description Total order-book liquidity in USD */
+            liquidity_usd: number;
+            /**
+             * Format: int64
+             * @description Update timestamp (Unix millis)
+             */
+            liquidity_updated_at: number;
+        };
         /** @description Subscribe to the trader PnL stream. `traders` is required and must be non-empty. `update_types` and `timeframes` are optional narrowing filters — omit or leave empty to receive all update types / timeframes. */
         TraderPnlSubscribeMessage: {
-            /** @enum {string} */
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
             action: "subscribe" | "unsubscribe_all";
             /** @description EVM wallet addresses */
             traders: string[];
@@ -3957,6 +5555,7 @@ export interface components {
         };
         /** @description Server acknowledgement for a trader PnL subscription. Echoes the accepted (normalized) filter sets so clients can confirm the active subscription. */
         TraderPnlSubscribeResponse: {
+            /** @description Accepted trader wallets. */
             traders?: string[];
             /** @description Accepted update types. Empty = all. */
             update_types?: ("global" | "market" | "category")[];
@@ -3971,58 +5570,120 @@ export interface components {
         TraderGlobalPnlRow: {
             /** @description Trader EVM wallet address */
             trader: string;
+            /** @description Dirty update kinds included in this event. */
             dirty_kinds?: ("trade" | "price" | "window" | "market_resolved")[];
             /** @description "1d", "7d", "30d", or "lifetime" */
             timeframe?: string | null;
             /** @description Realized PnL for the timeframe */
             realized_pnl_usd: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Events traded.
+             */
             events_traded?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets traded.
+             */
             markets_traded?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total buy count.
+             */
             total_buys?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total sell count.
+             */
             total_sells?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total redemption count.
+             */
             total_redemptions?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total merge count.
+             */
             total_merges?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total split count.
+             */
             total_splits?: number;
+            /** @description Total volume in USD. */
             total_volume_usd?: number;
+            /** @description Buy volume in USD. */
             buy_volume_usd?: number;
+            /** @description Sell volume in USD. */
             sell_volume_usd?: number;
+            /** @description Redemption volume in USD. */
             redemption_volume_usd?: number;
+            /** @description Merge volume in USD. */
             merge_volume_usd?: number;
+            /** @description Split volume in USD. */
             split_volume_usd?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Maker rebate count.
+             */
             maker_rebate_count?: number;
+            /** @description Maker rebates in USD. */
             maker_rebate_usd?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Reward count.
+             */
             reward_count?: number;
+            /** @description Rewards in USD. */
             reward_usd?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Yield count.
+             */
             yield_count?: number;
+            /** @description Yield in USD. */
             yield_usd?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total credit count.
+             */
             total_credit_count?: number;
+            /** @description Total credits in USD. */
             total_credit_usd?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets won.
+             */
             markets_won?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets lost.
+             */
             markets_lost?: number;
+            /** @description Market win rate percent. */
             market_win_rate_pct?: number;
+            /** @description Total wins in USD. */
             total_wins_usd?: number;
+            /** @description Total losses in USD. */
             total_losses_usd?: number;
+            /** @description Average win in USD. */
             avg_win_usd?: number | null;
+            /** @description Average loss in USD. */
             avg_loss_usd?: number | null;
+            /** @description Profit factor. */
             profit_factor?: number | null;
+            /** @description Average hold time in seconds. */
             avg_hold_time_seconds?: number;
+            /** @description Total fees. */
             total_fees?: number;
+            /** @description Best trade PnL in USD. */
             best_trade_pnl_usd?: number | null;
+            /** @description Best trade condition ID. */
             best_trade_condition_id?: string | null;
+            /** @description Worst trade PnL in USD. */
             worst_trade_pnl_usd?: number | null;
+            /** @description Worst trade condition ID. */
             worst_trade_condition_id?: string | null;
             /**
              * Format: int64
@@ -4037,34 +5698,65 @@ export interface components {
         };
         /** @description One per-market PnL row inside a `trader_market_pnl_batch` envelope's `data` array. */
         TraderMarketPnlRow: {
+            /** @description Trader wallet address. */
             trader: string;
+            /** @description Dirty update kinds included in this event. */
             dirty_kinds?: ("trade" | "price" | "window" | "market_resolved")[];
             /** @description "1d", "7d", "30d", or "lifetime" */
             timeframe?: string | null;
             /** @description 64-char hex condition ID */
             condition_id: string;
+            /** @description Realized PnL in USD. */
             realized_pnl_usd?: number;
+            /** @description Current shares balance. */
             current_shares_balance?: number;
+            /** @description Category label. */
             category?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Outcomes traded.
+             */
             outcomes_traded?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total buy count.
+             */
             total_buys?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total sell count.
+             */
             total_sells?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total redemption count.
+             */
             total_redemptions?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total merge count.
+             */
             total_merges?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total split count.
+             */
             total_splits?: number;
+            /** @description Buy volume in USD. */
             buy_usd?: number;
+            /** @description Sell volume in USD. */
             sell_usd?: number;
+            /** @description Redemption volume in USD. */
             redemption_usd?: number;
+            /** @description Merge volume in USD. */
             merge_usd?: number;
+            /** @description Split volume in USD. */
             split_volume_usd?: number;
+            /** @description Total fees. */
             total_fees?: number;
+            /** @description Total shares bought. */
             total_shares_bought?: number;
             /**
              * Format: int64
@@ -4079,50 +5771,103 @@ export interface components {
         };
         /** @description One per-category PnL row inside a `trader_category_pnl_batch` envelope's `data` array. */
         TraderCategoryPnlRow: {
+            /** @description Trader wallet address. */
             trader: string;
+            /** @description Dirty update kinds included in this event. */
             dirty_kinds?: ("trade" | "price" | "window" | "market_resolved")[];
             /** @description "1d", "7d", "30d", or "lifetime" */
             timeframe?: string | null;
+            /** @description Category label. */
             category: string;
+            /** @description Realized PnL in USD. */
             realized_pnl_usd?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets in this category.
+             */
             markets_in_category?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets traded.
+             */
             markets_traded?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Outcomes traded.
+             */
             outcomes_traded?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total buy count.
+             */
             total_buys?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total sell count.
+             */
             total_sells?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total redemption count.
+             */
             total_redemptions?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total merge count.
+             */
             total_merges?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total split count.
+             */
             total_splits?: number;
+            /** @description Total volume in USD. */
             total_volume_usd?: number;
+            /** @description Buy volume in USD. */
             buy_usd?: number;
+            /** @description Sell volume in USD. */
             sell_usd?: number;
+            /** @description Redemption volume in USD. */
             redemption_usd?: number;
+            /** @description Merge volume in USD. */
             merge_usd?: number;
+            /** @description Split volume in USD. */
             split_volume_usd?: number;
+            /** @description Total fees. */
             total_fees?: number;
+            /** @description Total shares bought. */
             total_shares_bought?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets won.
+             */
             markets_won?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets lost.
+             */
             markets_lost?: number;
+            /** @description Market win rate percent. */
             market_win_rate_pct?: number;
+            /** @description Average hold time in seconds. */
             avg_hold_time_seconds?: number;
+            /** @description Best trade PnL in USD. */
             best_trade_pnl_usd?: number | null;
+            /** @description Best trade condition ID. */
             best_trade_condition_id?: string | null;
+            /** @description Worst trade PnL in USD. */
             worst_trade_pnl_usd?: number | null;
+            /** @description Worst trade condition ID. */
             worst_trade_condition_id?: string | null;
+            /** @description Total wins in USD. */
             total_wins_usd?: number;
+            /** @description Total losses in USD. */
             total_losses_usd?: number;
+            /** @description Average win in USD. */
             avg_win_usd?: number | null;
+            /** @description Average loss in USD. */
             avg_loss_usd?: number | null;
+            /** @description Profit factor. */
             profit_factor?: number | null;
             /**
              * Format: int64
@@ -4137,10 +5882,16 @@ export interface components {
         };
         /** @description Row carried by `trader_global_tick_batch` (price-only trader aggregate). */
         TraderGlobalTickRow: {
+            /** @description Trader wallet address. */
             trader: string;
+            /** @description Realized PnL in USD. */
             realized_pnl_usd?: number;
+            /** @description Open positions value. */
             open_positions_value?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Last block number.
+             */
             last_block?: number;
             /**
              * Format: int64
@@ -4151,10 +5902,16 @@ export interface components {
         };
         /** @description Row carried by `trader_market_tick_batch` (price-only per-market). */
         TraderMarketTickRow: {
+            /** @description Trader wallet address. */
             trader: string;
+            /** @description Market condition ID. */
             condition_id: string;
+            /** @description Realized PnL in USD. */
             realized_pnl_usd?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Last block number.
+             */
             last_block?: number;
             /**
              * Format: int64
@@ -4165,10 +5922,16 @@ export interface components {
         };
         /** @description Row carried by `trader_category_tick_batch` (price-only per-category). */
         TraderCategoryTickRow: {
+            /** @description Trader wallet address. */
             trader: string;
+            /** @description Category label. */
             category: string;
+            /** @description Realized PnL in USD. */
             realized_pnl_usd?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Last block number.
+             */
             last_block?: number;
             /**
              * Format: int64
@@ -4179,17 +5942,33 @@ export interface components {
         };
         /** @description Row carried by `trader_global_resolution_batch` (trader-aggregate resolution). */
         TraderGlobalResolutionRow: {
+            /** @description Trader wallet address. */
             trader: string;
+            /** @description Realized PnL in USD. */
             realized_pnl_usd?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets won.
+             */
             markets_won?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets lost.
+             */
             markets_lost?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets resolved.
+             */
             markets_resolved?: number;
+            /** @description Total wins usd lifetime. */
             total_wins_usd_lifetime?: number;
+            /** @description Total losses usd lifetime. */
             total_losses_usd_lifetime?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Last block number.
+             */
             last_block?: number;
             /**
              * Format: int64
@@ -4200,12 +5979,20 @@ export interface components {
         };
         /** @description Row carried by `trader_market_resolution_batch` (per-market resolution). */
         TraderMarketResolutionRow: {
+            /** @description Trader wallet address. */
             trader: string;
+            /** @description Market condition ID. */
             condition_id: string;
+            /** @description Whether the market is resolved. */
             resolved?: boolean;
+            /** @description Whether the position won. */
             won?: boolean | null;
+            /** @description Realized PnL in USD. */
             realized_pnl_usd?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Last block number.
+             */
             last_block?: number;
             /**
              * Format: int64
@@ -4216,16 +6003,30 @@ export interface components {
         };
         /** @description Row carried by `trader_category_resolution_batch` (per-category resolution). */
         TraderCategoryResolutionRow: {
+            /** @description Trader wallet address. */
             trader: string;
+            /** @description Category label. */
             category: string;
+            /** @description Realized PnL in USD. */
             realized_pnl_usd?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets won.
+             */
             markets_won?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Markets lost.
+             */
             markets_lost?: number;
+            /** @description Total wins usd lifetime. */
             total_wins_usd_lifetime?: number;
+            /** @description Total losses usd lifetime. */
             total_losses_usd_lifetime?: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Last block number.
+             */
             last_block?: number;
             /**
              * Format: int64
@@ -4332,7 +6133,10 @@ export interface components {
         };
         /** @description Subscribe to the trader positions stream. `traders` is required and must be non-empty. `dirty_kinds` is an optional narrowing filter — empty/omitted or `["all"]` = receive every kind of update. */
         TraderPositionsSubscribeMessage: {
-            /** @enum {string} */
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
             action: "subscribe" | "unsubscribe_all";
             /** @description EVM wallet addresses */
             traders: string[];
@@ -4341,49 +6145,80 @@ export interface components {
         };
         /** @description Server acknowledgement for a trader positions subscription. */
         TraderPositionsSubscribeResponse: {
+            /** @description Accepted trader wallets. */
             traders?: string[];
             /** @description Echoed accepted dirty_kinds filter. Empty = all. */
             dirty_kinds?: ("trade" | "price" | "position_resolved")[];
+            /** @description Rejected filter values. */
             rejected?: string[];
+            /** @description Subscription error message. */
             error?: string | null;
         };
         /** @description One position-update row inside a `trader_position_batch` envelope's `data` array. */
         TraderPositionRow: {
             /** @description ERC-1155 token ID (decimal string) */
             position_id?: string | null;
+            /** @description Market condition ID. */
             condition_id?: string | null;
+            /** @description Market slug. */
             market_slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
             title?: string | null;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
             /** @description Outcome name (e.g. "Yes") */
             outcome?: string | null;
+            /** @description Outcome index. */
             outcome_index?: number | null;
+            /** @description Whether the position is open. */
             open?: boolean | null;
             /** @description Resolution outcome — present once the market resolved */
             won?: boolean | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total buy count.
+             */
             total_buys?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Total sell count.
+             */
             total_sells?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Conversion count.
+             */
             converted_count?: number | null;
+            /** @description Converted shares gained. */
             converted_shares_gained?: number | null;
+            /** @description Converted shares lost. */
             converted_shares_lost?: number | null;
+            /** @description Total shares bought. */
             total_shares_bought?: number | null;
+            /** @description Total shares sold. */
             total_shares_sold?: number | null;
+            /** @description Total buys in USD. */
             total_buy_usd?: number | null;
+            /** @description Total sells in USD. */
             total_sell_usd?: number | null;
+            /** @description Redemption volume in USD. */
             redemption_usd?: number | null;
+            /** @description Merge volume in USD. */
             merge_usd?: number | null;
             /** @description 0–1 */
             avg_entry_price?: number | null;
+            /** @description Average exit price. */
             avg_exit_price?: number | null;
             /** @description Volume-weighted across buys + sells */
             avg_price?: number | null;
+            /** @description Realized PnL in USD. */
             realized_pnl_usd?: number | null;
+            /** @description Realized PnL percent. */
             realized_pnl_pct?: number | null;
+            /** @description Total fees. */
             total_fees?: number | null;
             /**
              * Format: int64
@@ -4397,9 +6232,11 @@ export interface components {
             last_trade_at?: number | null;
             /** @description Latest on-chain mark for the outcome token */
             current_price?: number | null;
+            /** @description Current shares balance. */
             current_shares_balance?: number | null;
             /** @description current_price × current_shares_balance */
             current_value?: number | null;
+            /** @description Last traded price. */
             last_traded_price?: number | null;
             /**
              * Format: int64
@@ -4419,7 +6256,10 @@ export interface components {
         TraderPositionBatchEvent: {
             /** @enum {string} */
             type: "trader_position_batch";
-            /** @enum {string} */
+            /**
+             * @description WebSocket room ID.
+             * @enum {string}
+             */
             room_id: "polymarket_trader_positions";
             /**
              * Format: int64
@@ -4430,66 +6270,100 @@ export interface components {
         };
         /** @description One price-tick row inside a `trader_position_price_batch` envelope's `data` array. */
         TraderPositionPriceRow: {
+            /** @description Trader wallet address. */
             trader?: string | null;
             /** @description ERC-1155 token ID (decimal string) */
             position_id?: string | null;
+            /** @description Market condition ID. */
             condition_id?: string | null;
             /** @description Latest on-chain mark for the outcome token */
             current_price?: number | null;
+            /** @description Current position value. */
             current_value?: number | null;
+            /** @description Realized PnL in USD. */
             realized_pnl_usd?: number | null;
+            /** @description Realized PnL percent. */
             realized_pnl_pct?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Last block number.
+             */
             last_block?: number | null;
             /**
              * Format: int64
              * @description Unix milliseconds
              */
             last_trade_at?: number | null;
+            /** @description Dirty update kinds included in this event. */
             dirty_kinds?: "price"[];
         };
         /** @description Server-pushed per-block batch of position price ticks (mark-to-market refreshes). Envelope type: `trader_position_price_batch`. */
         TraderPositionPriceBatchEvent: {
             /** @enum {string} */
             type: "trader_position_price_batch";
-            /** @enum {string} */
+            /**
+             * @description WebSocket room ID.
+             * @enum {string}
+             */
             room_id: "polymarket_trader_positions";
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Block number.
+             */
             block: number;
             data: components["schemas"]["TraderPositionPriceRow"][];
         };
         /** @description One resolution row inside a `trader_position_resolution_batch` envelope's `data` array. */
         TraderPositionResolutionRow: {
+            /** @description Trader wallet address. */
             trader?: string | null;
             /** @description ERC-1155 token ID (decimal string) */
             position_id?: string | null;
+            /** @description Market condition ID. */
             condition_id?: string | null;
+            /** @description Whether the market is resolved. */
             resolved?: boolean | null;
+            /** @description Whether the position won. */
             won?: boolean | null;
+            /** @description Realized PnL in USD. */
             realized_pnl_usd?: number | null;
+            /** @description Realized PnL percent. */
             realized_pnl_pct?: number | null;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Last block number.
+             */
             last_block?: number | null;
             /**
              * Format: int64
              * @description Unix milliseconds
              */
             last_trade_at?: number | null;
+            /** @description Dirty update kinds included in this event. */
             dirty_kinds?: "position_resolved"[];
         };
         /** @description Server-pushed per-block batch of position resolutions. Envelope type: `trader_position_resolution_batch`. */
         TraderPositionResolutionBatchEvent: {
             /** @enum {string} */
             type: "trader_position_resolution_batch";
-            /** @enum {string} */
+            /**
+             * @description WebSocket room ID.
+             * @enum {string}
+             */
             room_id: "polymarket_trader_positions";
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Block number.
+             */
             block: number;
             data: components["schemas"]["TraderPositionResolutionRow"][];
         };
         /** @description Subscribe to the trader exit markers stream. `traders` is required and must be non-empty. `reasons` is an optional narrowing filter — empty/omitted or `["all"]` = receive every exit reason. */
         TraderExitMarkersSubscribeMessage: {
-            /** @enum {string} */
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
             action: "subscribe" | "unsubscribe_all";
             /** @description EVM wallet addresses */
             traders: string[];
@@ -4498,10 +6372,13 @@ export interface components {
         };
         /** @description Server acknowledgement for a trader exit markers subscription. */
         TraderExitMarkersSubscribeResponse: {
+            /** @description Accepted trader wallets. */
             traders?: string[];
             /** @description Echoed accepted reasons filter. Empty = all. */
             reasons?: ("resolved_win" | "resolved_loss" | "sold_win" | "sold_loss")[];
+            /** @description Rejected filter values. */
             rejected?: string[];
+            /** @description Subscription error message. */
             error?: string | null;
         };
         /** @description One exit row inside a `trader_exit_marker_batch` envelope's `data` array. */
@@ -4510,20 +6387,26 @@ export interface components {
             trader?: string;
             /** @description ERC-1155 token ID (decimal string) */
             position_id?: string;
+            /** @description Market condition ID. */
             condition_id?: string;
+            /** @description Event slug. */
             event_slug?: string;
+            /** @description Market slug. */
             market_slug?: string;
             title?: string;
             /** @description Full market question text */
             question?: string;
+            /** @description Image URL. */
             image_url?: string;
             /** @description Outcome name (e.g. "Yes") */
             outcome?: string;
+            /** @description Outcome index. */
             outcome_index?: number | null;
             /** @description Realized PnL at exit, USD */
             pnl_usd?: number;
             /** @description Realized PnL at exit, percent */
             pnl_pct?: number;
+            /** @description Cost basis in USD. */
             cost_basis_usd?: number;
             /**
              * @description Why the position closed: `resolved_*` held to market resolution (win/loss by verdict); `sold_*` closed before resolution (win/loss by realized PnL sign).
@@ -4545,7 +6428,10 @@ export interface components {
         TraderExitMarkerBatchEvent: {
             /** @enum {string} */
             type: "trader_exit_marker_batch";
-            /** @enum {string} */
+            /**
+             * @description WebSocket room ID.
+             * @enum {string}
+             */
             room_id: "polymarket_trader_pnl_exits";
             /**
              * Format: int64
@@ -4556,7 +6442,10 @@ export interface components {
         };
         /** @description Subscribe to holder metrics for explicit positions, conditions, or events. At least one identifier array must be non-empty. Omitted arrays receive no updates for that metric family. Up to 500 total identifiers are accepted. */
         HolderMetricsSubscribeMessage: {
-            /** @enum {string} */
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
             action: "subscribe" | "unsubscribe_all";
             /** @description Position token IDs to receive position holder metrics for. */
             position_ids?: string[];
@@ -4566,54 +6455,85 @@ export interface components {
             event_slugs?: string[];
         };
         PositionHolderMetricsRow: {
+            /** @description Unix timestamp in seconds. */
             ts?: number;
+            /** @description Block number. */
             block?: number;
+            /** @description Outcome token ID. */
             position_id?: string;
+            /** @description Number of holders. */
             holder_count?: number;
+            /** @description Total shares held. */
             total_balance?: number;
+            /** @description Total holder cost basis in USD. */
             total_cost_basis?: number;
+            /** @description Number of market-level holders. */
             condition_holder_count?: number | null;
+            /** @description Number of event-level holders. */
             event_holder_count?: number | null;
         };
         ConditionHolderMetricsRow: {
+            /** @description Unix timestamp in seconds. */
             ts?: number;
+            /** @description Block number. */
             block?: number;
+            /** @description Market condition ID. */
             condition_id?: string;
+            /** @description Number of holders. */
             holder_count?: number;
         };
         EventHolderMetricsRow: {
+            /** @description Unix timestamp in seconds. */
             ts?: number;
+            /** @description Block number. */
             block?: number;
+            /** @description Event slug. */
             event_slug?: string;
+            /** @description Number of holders. */
             holder_count?: number;
         };
         HolderMetricsPositionBatchEvent: {
             /** @enum {string} */
             type: "holder_metrics_position_batch";
-            /** @enum {string} */
+            /**
+             * @description WebSocket room ID.
+             * @enum {string}
+             */
             room_id: "polymarket_holder_metrics";
+            /** @description Block number. */
             block: number;
             data: components["schemas"]["PositionHolderMetricsRow"][];
         };
         HolderMetricsConditionBatchEvent: {
             /** @enum {string} */
             type: "holder_metrics_condition_batch";
-            /** @enum {string} */
+            /**
+             * @description WebSocket room ID.
+             * @enum {string}
+             */
             room_id: "polymarket_holder_metrics";
+            /** @description Block number. */
             block: number;
             data: components["schemas"]["ConditionHolderMetricsRow"][];
         };
         HolderMetricsEventBatchEvent: {
             /** @enum {string} */
             type: "holder_metrics_event_batch";
-            /** @enum {string} */
+            /**
+             * @description WebSocket room ID.
+             * @enum {string}
+             */
             room_id: "polymarket_holder_metrics";
+            /** @description Block number. */
             block: number;
             data: components["schemas"]["EventHolderMetricsRow"][];
         };
         /** @description Subscribe to the accounts stream. `wallets` is required. Share balance updates (`accounts_update`) are always delivered. Set `include_usdce`, `include_pusd`, or `include_matic` to also receive those balance streams. */
         AccountsSubscribeMessage: {
-            /** @enum {string} */
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
             action: "subscribe" | "unsubscribe_all";
             /** @description EVM wallet addresses */
             wallets: string[];
@@ -4626,12 +6546,17 @@ export interface components {
         };
         /** @description Server acknowledgement for an accounts subscription */
         AccountsSubscribeResponse: {
+            /** @description Accepted wallet addresses. */
             wallets?: string[];
             /** @description Addresses rejected (invalid format) */
             rejected?: string[];
+            /** @description Whether to include USDC.e balances. */
             include_usdce?: boolean;
+            /** @description Whether to include pUSD balances. */
             include_pusd?: boolean;
+            /** @description Whether to include MATIC balances. */
             include_matic?: boolean;
+            /** @description Subscription error message. */
             error?: string | null;
         };
         /** @description Server-pushed event: ERC-1155 outcome token balance change for a wallet. Envelope type: "accounts_update". */
@@ -4642,7 +6567,10 @@ export interface components {
             position_id: string;
             /** @description Current token balance (decimal string) */
             balance: string;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Block number.
+             */
             block_number: number;
             /**
              * Format: int64
@@ -4662,7 +6590,10 @@ export interface components {
             token_address?: string;
             /** @description Current USDCe balance (decimal string) — omitted when not available */
             balance?: string;
-            /** Format: uint64 */
+            /**
+             * Format: uint64
+             * @description Block number.
+             */
             block_number: number;
             /**
              * Format: int64
@@ -4678,7 +6609,10 @@ export interface components {
             token_address?: string;
             /** @description Current pUSD balance (decimal string) — omitted when not available */
             balance?: string;
-            /** Format: uint64 */
+            /**
+             * Format: uint64
+             * @description Block number.
+             */
             block_number: number;
             /**
              * Format: int64
@@ -4694,7 +6628,10 @@ export interface components {
             token_address?: string;
             /** @description Current MATIC balance (decimal string) — omitted when not available */
             balance?: string;
-            /** Format: uint64 */
+            /**
+             * Format: uint64
+             * @description Block number.
+             */
             block_number: number;
             /**
              * Format: int64
@@ -4704,7 +6641,10 @@ export interface components {
         };
         /** @description Subscribe to the order book stream. At least one filter is required. Maximum 500 combined condition_ids + position_ids per client. No `type` field is needed — the server routes by room_id. */
         OrderBookSubscribeMessage: {
-            /** @enum {string} */
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
             action: "subscribe" | "unsubscribe_all";
             /** @description Condition IDs (markets). All positions within each market are delivered. */
             condition_ids?: string[];
@@ -4758,7 +6698,10 @@ export interface components {
         };
         /** @description Subscribe to CLOB reward changes. Either provide specific condition_ids or set subscribe_all to true. */
         ClobRewardsSubscribeMessage: {
-            /** @enum {string} */
+            /**
+             * @description Subscription action.
+             * @enum {string}
+             */
             action: "subscribe" | "unsubscribe_all";
             /** @description Condition IDs to watch for reward changes. */
             condition_ids?: string[];
@@ -4785,14 +6728,22 @@ export interface components {
             condition_id?: string;
             /** @description Full reward state (null for 'removed' events) */
             reward?: {
+                /** @description Market condition ID. */
                 condition_id?: string;
                 rewards_config?: {
+                    /** @description Event ID. */
                     id?: number;
                     /** @description Reward token address (e.g. USDC) */
                     asset_address?: string;
-                    /** Format: date */
+                    /**
+                     * Format: date
+                     * @description Reward start date.
+                     */
                     start_date?: string;
-                    /** Format: date */
+                    /**
+                     * Format: date
+                     * @description Reward end date.
+                     */
                     end_date?: string;
                     /** @description Daily reward rate in USDC */
                     rate_per_day?: number;
@@ -4843,16 +6794,25 @@ export interface components {
         EventsStreamFilter: {
             /** @description Case-insensitive substring match on `title`. 3–100 chars. */
             search?: string;
+            /** @description Categories to include. */
             categories?: string[];
+            /** @description Categories to exclude. */
             exclude_categories?: string[];
             /** @description Match by tag slug OR label (case-insensitive). */
             tags?: string[];
+            /** @description Tags to exclude. */
             exclude_tags?: string[];
+            /** @description Minimum volume. */
             min_volume?: number;
+            /** @description Maximum volume. */
             max_volume?: number;
+            /** @description Minimum transaction count. */
             min_txns?: number;
+            /** @description Maximum transaction count. */
             max_txns?: number;
+            /** @description Minimum unique trader count. */
             min_unique_traders?: number;
+            /** @description Maximum unique trader count. */
             max_unique_traders?: number;
             /**
              * @description Timeframe that `volume`/`txns`/`unique_traders` thresholds are evaluated against. Default `24h`.
@@ -4862,8 +6822,12 @@ export interface components {
         };
         /** @description Server acknowledgement for an events_stream subscribe/unsubscribe. Envelope type: "events_stream_subscribe_response". */
         EventsStreamSubscribeResponse: {
-            /** @enum {string} */
+            /**
+             * @description Subscription mode.
+             * @enum {string}
+             */
             mode?: "filter" | "ids" | "";
+            /** @description Flush interval in milliseconds. */
             interval_ms?: number;
             /** @description Accepted ids (ids mode only). Empty in filter mode. */
             event_slugs?: string[];
@@ -4876,11 +6840,20 @@ export interface components {
         EventsStreamUpdateEvent: {
             /** @enum {string} */
             type: "events_stream_update";
-            /** @enum {string} */
+            /**
+             * @description WebSocket room ID.
+             * @enum {string}
+             */
             room_id: "polymarket_events_stream";
-            /** @enum {string} */
+            /**
+             * @description Subscription mode.
+             * @enum {string}
+             */
             mode: "filter" | "ids";
-            /** @enum {integer} */
+            /**
+             * @description Flush interval in milliseconds.
+             * @enum {integer}
+             */
             interval_ms: 500 | 1000 | 3000 | 10000;
             /** @description Full `PolymarketEvent` rows (same shape as `GET /polymarket/events`). Not a delta — each array element is a complete row replacement. */
             data: Record<string, never>[];
@@ -4916,9 +6889,14 @@ export interface components {
          * @description A buy/sell trade was matched on the exchange.
          */
         TradeOrderFilledEvent: {
-            /** @enum {string} */
+            /**
+             * @description Trade type.
+             * @enum {string}
+             */
             trade_type: "OrderFilled" | "OrdersMatched";
+            /** @description Event ID. */
             id: string;
+            /** @description Transaction hash. */
             hash: string;
             /** @description Absent for pending trades */
             block?: number;
@@ -4933,28 +6911,49 @@ export interface components {
             /** @description Absent for pending trades */
             order_hash?: string;
             trader: {
+                /** @description Wallet address. */
                 address?: string;
+                /** @description Display name. */
                 name?: string | null;
+                /** @description Pseudonym. */
                 pseudonym?: string | null;
+                /** @description Profile image URL. */
                 profile_image?: string | null;
+                /** @description X username. */
                 x_username?: string | null;
+                /** @description Whether the profile is verified. */
                 verified_badge?: boolean;
             };
             /** @description Absent for pending trades */
             taker?: string;
-            /** @enum {string} */
+            /**
+             * @description Trade side.
+             * @enum {string}
+             */
             side?: "Buy" | "Sell";
+            /** @description Market condition ID. */
             condition_id?: string | null;
+            /** @description Outcome token ID. */
             position_id?: string;
+            /** @description Outcome name. */
             outcome?: string | null;
+            /** @description Outcome index. */
             outcome_index?: number | null;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Market slug. */
             slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Trade amount in USD. */
             usd_amount?: number;
+            /** @description Trade size in shares. */
             shares_amount?: number;
+            /** @description Outcome price. */
             price?: number;
+            /** @description Implied probability. */
             probability?: number | null;
             /** @description Absent for pending trades */
             fee?: number;
@@ -4962,6 +6961,7 @@ export interface components {
             fee_shares?: number;
             /** @description Absent for pending trades */
             fee_pct?: number;
+            /** @description Exchange identifier. */
             exchange: number;
             /** @description CLOB V2 builder code (lower-cased `0x...` bytes32 hex). Absent on V1 trades; may be `0x0000…` for V2 trades placed without a builder code. */
             builder_code?: string;
@@ -4973,25 +6973,42 @@ export interface components {
          * @description pUSD credit paid directly to the trader wallet.
          */
         TradeRedemptionEvent: {
-            /** @enum {string} */
+            /**
+             * @description Trade type.
+             * @enum {string}
+             */
             trade_type: "MakerRebate" | "Reward" | "Yield";
+            /** @description Event ID. */
             id: string;
+            /** @description Transaction hash. */
             hash: string;
+            /** @description Block number. */
             block?: number;
+            /** @description Confirmation timestamp. */
             confirmed_at?: number;
+            /** @description Receive timestamp. */
             received_at?: number;
+            /** @description Log index. */
             log_index?: number;
+            /** @description Block index. */
             block_index?: number;
             trader: {
+                /** @description Wallet address. */
                 address?: string;
+                /** @description Display name. */
                 name?: string | null;
+                /** @description Pseudonym. */
                 pseudonym?: string | null;
+                /** @description Profile image URL. */
                 profile_image?: string | null;
+                /** @description X username. */
                 x_username?: string | null;
+                /** @description Whether the profile is verified. */
                 verified_badge?: boolean;
             };
             /** @description Payout distributor address */
             taker?: string;
+            /** @description Trade amount in USD. */
             usd_amount?: number;
             /** @description Always 0 for payout credits */
             shares_amount?: number;
@@ -5011,37 +7028,67 @@ export interface components {
          * @description Positions redeemed after market resolution.
          */
         TradeMergeEvent: {
-            /** @enum {string} */
+            /**
+             * @description Trade type.
+             * @enum {string}
+             */
             trade_type: "Redemption";
+            /** @description Event ID. */
             id: string;
+            /** @description Transaction hash. */
             hash: string;
+            /** @description Block number. */
             block?: number;
+            /** @description Confirmation timestamp. */
             confirmed_at?: number;
+            /** @description Receive timestamp. */
             received_at?: number;
+            /** @description Log index. */
             log_index?: number;
+            /** @description Block index. */
             block_index?: number;
             trader: {
+                /** @description Wallet address. */
                 address?: string;
+                /** @description Display name. */
                 name?: string | null;
+                /** @description Pseudonym. */
                 pseudonym?: string | null;
+                /** @description Profile image URL. */
                 profile_image?: string | null;
+                /** @description X username. */
                 x_username?: string | null;
+                /** @description Whether the profile is verified. */
                 verified_badge?: boolean;
             };
+            /** @description Market condition ID. */
             condition_id?: string | null;
+            /** @description Outcome name. */
             outcome?: string | null;
+            /** @description Outcome index. */
             outcome_index?: number | null;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Market slug. */
             slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Trade amount in USD. */
             usd_amount?: number;
+            /** @description Winning outcome index. */
             winning_outcome_index?: number | null;
+            /** @description Position details. */
             position_details?: {
+                /** @description Outcome token ID. */
                 position_id?: string;
+                /** @description Outcome index. */
                 outcome_index?: number;
+                /** @description Amount as a decimal string. */
                 amount?: string;
             }[];
+            /** @description Exchange identifier. */
             exchange: number;
         };
         /**
@@ -5049,34 +7096,61 @@ export interface components {
          * @description Outcome tokens burned to receive collateral.
          */
         TradeSplitEvent: {
-            /** @enum {string} */
+            /**
+             * @description Trade type.
+             * @enum {string}
+             */
             trade_type: "Merge";
+            /** @description Event ID. */
             id: string;
+            /** @description Transaction hash. */
             hash: string;
+            /** @description Block number. */
             block?: number;
+            /** @description Confirmation timestamp. */
             confirmed_at?: number;
+            /** @description Receive timestamp. */
             received_at?: number;
+            /** @description Log index. */
             log_index?: number;
+            /** @description Block index. */
             block_index?: number;
             trader: {
+                /** @description Wallet address. */
                 address?: string;
+                /** @description Display name. */
                 name?: string | null;
+                /** @description Pseudonym. */
                 pseudonym?: string | null;
+                /** @description Profile image URL. */
                 profile_image?: string | null;
+                /** @description X username. */
                 x_username?: string | null;
+                /** @description Whether the profile is verified. */
                 verified_badge?: boolean;
             };
+            /** @description Market condition ID. */
             condition_id?: string | null;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Market slug. */
             slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Trade amount in USD. */
             usd_amount?: number;
+            /** @description Position details. */
             position_details?: {
+                /** @description Outcome token ID. */
                 position_id?: string;
+                /** @description Outcome index. */
                 outcome_index?: number;
+                /** @description Amount as a decimal string. */
                 amount?: string;
             }[];
+            /** @description Exchange identifier. */
             exchange: number;
         };
         /**
@@ -5084,34 +7158,61 @@ export interface components {
          * @description Collateral deposited to receive outcome tokens.
          */
         TradePositionsConvertedEvent: {
-            /** @enum {string} */
+            /**
+             * @description Trade type.
+             * @enum {string}
+             */
             trade_type: "Split";
+            /** @description Event ID. */
             id: string;
+            /** @description Transaction hash. */
             hash: string;
+            /** @description Block number. */
             block?: number;
+            /** @description Confirmation timestamp. */
             confirmed_at?: number;
+            /** @description Receive timestamp. */
             received_at?: number;
+            /** @description Log index. */
             log_index?: number;
+            /** @description Block index. */
             block_index?: number;
             trader: {
+                /** @description Wallet address. */
                 address?: string;
+                /** @description Display name. */
                 name?: string | null;
+                /** @description Pseudonym. */
                 pseudonym?: string | null;
+                /** @description Profile image URL. */
                 profile_image?: string | null;
+                /** @description X username. */
                 x_username?: string | null;
+                /** @description Whether the profile is verified. */
                 verified_badge?: boolean;
             };
+            /** @description Market condition ID. */
             condition_id?: string | null;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Market slug. */
             slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Trade amount in USD. */
             usd_amount?: number;
+            /** @description Position details. */
             position_details?: {
+                /** @description Outcome token ID. */
                 position_id?: string;
+                /** @description Outcome index. */
                 outcome_index?: number;
+                /** @description Amount as a decimal string. */
                 amount?: string;
             }[];
+            /** @description Exchange identifier. */
             exchange: number;
         };
         /**
@@ -5119,34 +7220,59 @@ export interface components {
          * @description NegRisk NO tokens converted to YES tokens + collateral.
          */
         TradeCancelledEvent: {
-            /** @enum {string} */
+            /**
+             * @description Trade type.
+             * @enum {string}
+             */
             trade_type: "PositionsConverted";
+            /** @description Event ID. */
             id: string;
+            /** @description Transaction hash. */
             hash: string;
+            /** @description Block number. */
             block?: number;
+            /** @description Confirmation timestamp. */
             confirmed_at?: number;
+            /** @description Receive timestamp. */
             received_at?: number;
+            /** @description Log index. */
             log_index?: number;
+            /** @description Block index. */
             block_index?: number;
             trader: {
+                /** @description Wallet address. */
                 address?: string;
+                /** @description Display name. */
                 name?: string | null;
+                /** @description Pseudonym. */
                 pseudonym?: string | null;
+                /** @description Profile image URL. */
                 profile_image?: string | null;
+                /** @description X username. */
                 x_username?: string | null;
+                /** @description Whether the profile is verified. */
                 verified_badge?: boolean;
             };
+            /** @description Market id. */
             market_id?: string;
+            /** @description Index set. */
             index_set?: string;
+            /** @description Trade size in shares. */
             shares_amount?: number;
+            /** @description Fee. */
             fee?: number;
+            /** @description Fee percent. */
             fee_pct?: number;
             /** @description Per-position conversion amounts */
             position_details?: {
+                /** @description Outcome token ID. */
                 position_id?: string;
+                /** @description Outcome index. */
                 outcome_index?: number;
+                /** @description Amount as a decimal string. */
                 amount?: string;
             }[];
+            /** @description Exchange identifier. */
             exchange: number;
         };
         /**
@@ -5154,20 +7280,36 @@ export interface components {
          * @description Order cancelled on-chain.
          */
         TradeOracleLifecycleEvent: {
-            /** @enum {string} */
+            /**
+             * @description Trade type.
+             * @enum {string}
+             */
             trade_type: "Cancelled";
+            /** @description Event ID. */
             id: string;
+            /** @description Transaction hash. */
             hash: string;
+            /** @description Block number. */
             block?: number;
+            /** @description Confirmation timestamp. */
             confirmed_at?: number;
+            /** @description Receive timestamp. */
             received_at?: number;
+            /** @description Log index. */
             log_index?: number;
+            /** @description Block index. */
             block_index?: number;
+            /** @description Order hash. */
             order_hash?: string;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Market slug. */
             slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Exchange identifier. */
             exchange: number;
         };
         /**
@@ -5175,33 +7317,62 @@ export interface components {
          * @description Market lifecycle events: Initialization, Proposal, Dispute, Settled, Resolution, ConditionResolution, Reset, Flag, Unflag, Pause, Unpause, ManualResolution, NegRiskOutcomeReported.
          */
         TradeRegisterTokenEvent: {
-            /** @enum {string} */
+            /**
+             * @description Oracle lifecycle event type.
+             * @enum {string}
+             */
             trade_type: "Initialization" | "Proposal" | "Dispute" | "Settled" | "Resolution" | "ConditionResolution" | "Reset" | "Flag" | "Unflag" | "Pause" | "Unpause" | "ManualResolution" | "NegRiskOutcomeReported";
+            /** @description Event ID. */
             id: string;
+            /** @description Transaction hash. */
             hash: string;
+            /** @description Block number. */
             block?: number;
+            /** @description Confirmation timestamp. */
             confirmed_at?: number;
+            /** @description Receive timestamp. */
             received_at?: number;
+            /** @description Log index. */
             log_index?: number;
+            /** @description Block index. */
             block_index?: number;
+            /** @description Oracle contract. */
             oracle_contract: string;
+            /** @description Market condition ID. */
             condition_id: string;
+            /** @description Market question. */
             question?: string | null;
+            /** @description Image URL. */
             image_url?: string | null;
+            /** @description Market slug. */
             slug?: string | null;
+            /** @description Event slug. */
             event_slug?: string | null;
+            /** @description Assertion id. */
             assertion_id?: string | null;
+            /** @description Proposer. */
             proposer?: string | null;
+            /** @description Disputer. */
             disputer?: string | null;
+            /** @description Proposed outcome. */
             proposed_outcome?: string | null;
+            /** @description Settled price. */
             settled_price?: number | null;
+            /** @description Disputed. */
             disputed?: boolean | null;
+            /** @description Settlement resolution. */
             settlement_resolution?: boolean | null;
+            /** @description Bond. */
             bond?: string | null;
+            /** @description Expiration time. */
             expiration_time?: number | null;
+            /** @description Creator. */
             creator?: string | null;
+            /** @description Reward token. */
             reward_token?: string | null;
+            /** @description Reward details. */
             reward?: string | null;
+            /** @description Proposal bond. */
             proposal_bond?: string | null;
         };
     };