@structbuild/sdk 0.6.1 → 0.6.3

package/dist/generated/webhooks.d.ts

@@ -477,6 +477,66 @@ export interface webhooks {
         patch?: never;
         trace?: never;
     };
+    "position-liquidity": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Position liquidity threshold callback
+         * @description Fired when a position's USD order-book liquidity crosses a threshold. **`position_ids` is required**, plus at least one of `min_liquidity_usd` (fires when liquidity crosses **up** through the value) or `max_liquidity_usd` (fires when it crosses **down**). Thresholds are edge-triggered and re-arm once liquidity crosses back, unless `one_shot` is set (fire once, then delete).
+         */
+        post: operations["position-liquidity"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "market-liquidity": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Market liquidity threshold callback
+         * @description Fired when a market's total USD order-book liquidity crosses a threshold. **`condition_ids` is required**, plus at least one of `min_liquidity_usd` (fires when liquidity crosses **up** through the value) or `max_liquidity_usd` (fires when it crosses **down**). Thresholds are edge-triggered and re-arm once liquidity crosses back, unless `one_shot` is set (fire once, then delete).
+         */
+        post: operations["market-liquidity"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "event-liquidity": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Event liquidity threshold callback
+         * @description Fired when an event's total USD order-book liquidity (summed across its markets) crosses a threshold. **`event_slugs` is required**, plus at least one of `min_liquidity_usd` (fires when liquidity crosses **up** through the value) or `max_liquidity_usd` (fires when it crosses **down**). Thresholds are edge-triggered and re-arm once liquidity crosses back, unless `one_shot` is set (fire once, then delete).
+         */
+        post: operations["event-liquidity"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "market-volume-milestone": {
         parameters: {
             query?: never;
@@ -548,7 +608,7 @@ export interface webhooks {
         put?: never;
         /**
          * Probability spike callback
-         * @description Fired when a market's YES probability moves significantly. Use `min_probability_change_pct` to set the minimum move (e.g. `10` for 10%). Use `window_secs` to observe moves within a specific time window (e.g. `60` for 60 seconds). Use `spike_direction` (`"up"` | `"down"` | `"both"`) — defaults to `"up"` when not provided. Filter by `position_ids` or `outcomes` to narrow scope. Optional `min_probability`/`max_probability` gate the YES probability band, `min_txns`/`min_volume_usd` require a minimum number of trades or USD volume in the observation window.
+         * @description Fired when a market's YES probability moves significantly. Use `min_probability_change_pct` to set the minimum move (e.g. `10` for 10%). Use `window_secs` to observe moves within a specific time window (e.g. `60` for 60 seconds). Use `spike_direction` (`"up"` | `"down"` | `"both"`) — defaults to `"up"` when not provided. Filter by `position_ids` or `outcomes` to narrow scope. Scope by market taxonomy with `tags` (matches a market's tags or category) and `series_slugs` (matches its parent series). Optional `min_probability`/`max_probability` gate the YES probability band, `min_txns`/`min_volume_usd` require a minimum number of trades or USD volume in the observation window.
          */
         post: operations["probability-spike"];
         delete?: never;
@@ -568,7 +628,7 @@ export interface webhooks {
         put?: never;
         /**
          * Price spike callback
-         * @description Fired when a position's price moves significantly. Use `min_price_change_pct` to set the minimum move (e.g. `10` for 10%). Use `window_secs` to observe moves within a specific time window. Use `spike_direction` (`"up"` | `"down"` | `"both"`) — defaults to `"up"` when not provided. Filter by `position_ids` or `outcomes` to narrow scope. Optional `min_probability`/`max_probability` gate the price band, `min_txns`/`min_volume_usd` require a minimum number of trades or USD volume in the observation window.
+         * @description Fired when a position's price moves significantly. Use `min_price_change_pct` to set the minimum move (e.g. `10` for 10%). Use `window_secs` to observe moves within a specific time window. Use `spike_direction` (`"up"` | `"down"` | `"both"`) — defaults to `"up"` when not provided. Filter by `position_ids` or `outcomes` to narrow scope. Scope by market taxonomy with `tags` (matches a market's tags or category) and `series_slugs` (matches its parent series). Optional `min_probability`/`max_probability` gate the price band, `min_txns`/`min_volume_usd` require a minimum number of trades or USD volume in the observation window.
          */
         post: operations["price-spike"];
         delete?: never;
@@ -648,7 +708,7 @@ export interface webhooks {
         put?: never;
         /**
          * Close to bond callback
-         * @description Fired when a trade occurs at a near-certain-outcome price. **At least one of `min_probability` or `max_probability` is required.** Use `min_probability` (e.g. `0.95`) to trigger when YES is near-certain; use `max_probability` (e.g. `0.05`) for NO near-certain. Optional filters: `position_outcome_indices` — restrict by outcome index (`0` = Yes/Up, `1` = No); `condition_ids` — restrict to specific markets; `position_ids` — restrict to specific outcome tokens; `outcomes` — restrict by outcome name (e.g. `"Yes"`, `"No"`); `event_slugs` — restrict to specific events.
+         * @description Fired when a trade occurs at a near-certain-outcome price. **At least one of `min_probability` or `max_probability` is required.** Use `min_probability` (e.g. `0.95`) to trigger when YES is near-certain; use `max_probability` (e.g. `0.05`) for NO near-certain. Optional filters: `position_outcome_indices` — restrict by outcome index (`0` = Yes/Up, `1` = No); `condition_ids` — restrict to specific markets; `position_ids` — restrict to specific outcome tokens; `outcomes` — restrict by outcome name (e.g. `"Yes"`, `"No"`); `event_slugs` — restrict to specific events. Scope by market taxonomy with `tags` (matches a market's tags or category) and `series_slugs` (matches its parent series).
          */
         post: operations["close-to-bond"];
         delete?: never;
@@ -657,6 +717,66 @@ export interface webhooks {
         patch?: never;
         trace?: never;
     };
+    "price-threshold": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Price threshold crossing callback
+         * @description Fired when an outcome's price/probability crosses a target level (edge-triggered, fires once per crossing). **At least one of `min_probability` or `max_probability` is required.** Use `min_probability` (e.g. `0.75`) to fire when the price crosses *up* to ≥ that level; use `max_probability` (e.g. `0.25`) to fire when it crosses *down* to ≤ that level. Set `one_shot` to delete the subscription after the first delivery (requires `position_ids` or `condition_ids`). Set `fire_if_already_past` to fire immediately when the first observed price is already past the target. Optional scope filters: `condition_ids`, `position_ids`, `outcomes`, `position_outcome_indices` (`0` = Yes/Up, `1` = No), `event_slugs`, `tags` (a market's tags or category), `series_slugs` (parent series).
+         */
+        post: operations["price-threshold"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "market-resolved": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Market resolved callback
+         * @description Fired once when a market reaches a terminal resolution. Collapses the underlying oracle events (`QuestionResolved`, `QuestionEmergencyResolved`, `ConditionResolution`, `NegRiskOutcomeReported`) into a single notification carrying the winning outcome and, when available, the settled price. Optional filters: `condition_ids`, `event_slugs`, `outcomes` (only fire when the winning outcome matches, e.g. `"Yes"`), `exclude_shortterm_markets`.
+         */
+        post: operations["market-resolved"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "market-disputed": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Market disputed callback
+         * @description Fired when a proposed market resolution is challenged on-chain (`DisputePrice` or `AssertionDisputed`) — the resolution is now contested and delayed. Carries the disputer, the proposer, and the disputed/proposed outcome when available. Optional filters: `condition_ids`, `event_slugs`, `exclude_shortterm_markets`.
+         */
+        post: operations["market-disputed"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "market-created": {
         parameters: {
             query?: never;
@@ -826,6 +946,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;
         };
@@ -846,6 +971,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. */
@@ -897,73 +1027,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;
         };
         /**
@@ -971,6 +1198,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.
@@ -1067,15 +1303,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 */
@@ -1182,6 +1434,7 @@ export interface components {
         };
         /** @description Delete webhook response */
         DeleteWebhookResponse: {
+            /** @description Whether the webhook was deleted. */
             deleted: boolean;
         };
         /**
@@ -1234,19 +1487,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_metrics` event. All fields are optional. */
+        /**
+         * @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. */
@@ -1256,13 +1581,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;
@@ -1336,6 +1673,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. */
@@ -1347,7 +1689,9 @@ export interface components {
         };
         /** @description Event volume milestone webhook payload */
         EventVolumeMilestonePayload: {
+            /** @description Event slug. */
             event_slug: string;
+            /** @description Metric timeframe. */
             timeframe: string;
             /**
              * Format: double
@@ -1372,6 +1716,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.
@@ -1391,9 +1740,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
@@ -1428,26 +1781,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
@@ -1523,6 +1900,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;
@@ -1531,87 +1909,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. */
@@ -1662,8 +2156,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. */
@@ -1696,51 +2298,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. */
@@ -1750,6 +2469,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.
@@ -1767,11 +2491,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
@@ -1981,6 +2711,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;
             /**
@@ -2052,6 +2783,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. */
@@ -2078,11 +2814,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
@@ -2094,10 +2834,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
@@ -2109,21 +2849,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)
@@ -2154,6 +2916,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
@@ -2179,16 +2953,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
@@ -2220,9 +3004,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
@@ -2241,6 +3031,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"];
@@ -2264,31 +3055,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. */
@@ -2302,15 +3189,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
@@ -2322,7 +3224,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 */
@@ -2408,47 +3313,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: {
@@ -2592,6 +3560,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. */
@@ -2605,11 +3578,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
@@ -2654,6 +3634,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.
@@ -2675,15 +3660,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
@@ -2718,6 +3714,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. */
@@ -2726,6 +3727,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).
@@ -2762,14 +3767,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
@@ -2789,8 +3804,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. */
@@ -2809,6 +3942,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).
@@ -2835,14 +3972,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
@@ -3153,6 +4300,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. */
@@ -3162,13 +4314,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 */
@@ -3246,6 +4410,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`). */
@@ -3295,6 +4464,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. */
@@ -3304,6 +4478,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. */
@@ -3330,6 +4509,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;
             /**
@@ -3377,6 +4561,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. */
@@ -3420,6 +4609,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. */
@@ -3446,6 +4640,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. */
@@ -3475,6 +4674,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. */
@@ -3493,6 +4697,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`. */
@@ -3522,6 +4731,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. */
@@ -3561,7 +4775,9 @@ export interface components {
         };
         /** @description Volume milestone webhook payload */
         VolumeMilestonePayload: {
+            /** @description Market condition ID. */
             condition_id: string;
+            /** @description Metric timeframe. */
             timeframe: string;
             /**
              * Format: double
@@ -3626,8 +4842,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. */
@@ -3750,6 +4974,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: {
@@ -3936,6 +5171,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;
             /**
@@ -5571,6 +6807,135 @@ export interface operations {
             };
         };
     };
+    "position-liquidity": {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description UUID of the webhook subscription that fired */
+                "X-Webhook-ID": string;
+                /** @description UUID of this specific delivery attempt (matches envelope `id` field) */
+                "X-Delivery-ID": string;
+                /** @description Event name string (e.g. `trader_first_trade`) */
+                "X-Event-Type": string;
+                /** @description Delivery attempt number (1 = first attempt) */
+                "X-Attempt": number;
+                /** @description HMAC-SHA256 of the raw request body: `sha256=<hex>`. Present only when the webhook has a secret configured. Verify with: HMAC-SHA256(secret, raw_body_bytes) == hex_part. */
+                "X-Webhook-Signature"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Webhook delivery envelope. The `data` field contains the event-specific payload. */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WebhookDeliveryEnvelope"] & {
+                    data?: components["schemas"]["PositionLiquidityPayload"];
+                };
+            };
+        };
+        responses: {
+            /** @description Webhook delivery acknowledged */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error (will retry) */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    "market-liquidity": {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description UUID of the webhook subscription that fired */
+                "X-Webhook-ID": string;
+                /** @description UUID of this specific delivery attempt (matches envelope `id` field) */
+                "X-Delivery-ID": string;
+                /** @description Event name string (e.g. `trader_first_trade`) */
+                "X-Event-Type": string;
+                /** @description Delivery attempt number (1 = first attempt) */
+                "X-Attempt": number;
+                /** @description HMAC-SHA256 of the raw request body: `sha256=<hex>`. Present only when the webhook has a secret configured. Verify with: HMAC-SHA256(secret, raw_body_bytes) == hex_part. */
+                "X-Webhook-Signature"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Webhook delivery envelope. The `data` field contains the event-specific payload. */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WebhookDeliveryEnvelope"] & {
+                    data?: components["schemas"]["MarketLiquidityPayload"];
+                };
+            };
+        };
+        responses: {
+            /** @description Webhook delivery acknowledged */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error (will retry) */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    "event-liquidity": {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description UUID of the webhook subscription that fired */
+                "X-Webhook-ID": string;
+                /** @description UUID of this specific delivery attempt (matches envelope `id` field) */
+                "X-Delivery-ID": string;
+                /** @description Event name string (e.g. `trader_first_trade`) */
+                "X-Event-Type": string;
+                /** @description Delivery attempt number (1 = first attempt) */
+                "X-Attempt": number;
+                /** @description HMAC-SHA256 of the raw request body: `sha256=<hex>`. Present only when the webhook has a secret configured. Verify with: HMAC-SHA256(secret, raw_body_bytes) == hex_part. */
+                "X-Webhook-Signature"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Webhook delivery envelope. The `data` field contains the event-specific payload. */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WebhookDeliveryEnvelope"] & {
+                    data?: components["schemas"]["EventLiquidityPayload"];
+                };
+            };
+        };
+        responses: {
+            /** @description Webhook delivery acknowledged */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error (will retry) */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     "market-volume-milestone": {
         parameters: {
             query?: never;
@@ -5958,6 +7323,135 @@ export interface operations {
             };
         };
     };
+    "price-threshold": {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description UUID of the webhook subscription that fired */
+                "X-Webhook-ID": string;
+                /** @description UUID of this specific delivery attempt (matches envelope `id` field) */
+                "X-Delivery-ID": string;
+                /** @description Event name string (e.g. `trader_first_trade`) */
+                "X-Event-Type": string;
+                /** @description Delivery attempt number (1 = first attempt) */
+                "X-Attempt": number;
+                /** @description HMAC-SHA256 of the raw request body: `sha256=<hex>`. Present only when the webhook has a secret configured. Verify with: HMAC-SHA256(secret, raw_body_bytes) == hex_part. */
+                "X-Webhook-Signature"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Webhook delivery envelope. The `data` field contains the event-specific payload. */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WebhookDeliveryEnvelope"] & {
+                    data?: components["schemas"]["PriceThresholdPayload"];
+                };
+            };
+        };
+        responses: {
+            /** @description Webhook delivery acknowledged */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error (will retry) */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    "market-resolved": {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description UUID of the webhook subscription that fired */
+                "X-Webhook-ID": string;
+                /** @description UUID of this specific delivery attempt (matches envelope `id` field) */
+                "X-Delivery-ID": string;
+                /** @description Event name string (e.g. `trader_first_trade`) */
+                "X-Event-Type": string;
+                /** @description Delivery attempt number (1 = first attempt) */
+                "X-Attempt": number;
+                /** @description HMAC-SHA256 of the raw request body: `sha256=<hex>`. Present only when the webhook has a secret configured. Verify with: HMAC-SHA256(secret, raw_body_bytes) == hex_part. */
+                "X-Webhook-Signature"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Webhook delivery envelope. The `data` field contains the event-specific payload. */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WebhookDeliveryEnvelope"] & {
+                    data?: components["schemas"]["MarketResolvedPayload"];
+                };
+            };
+        };
+        responses: {
+            /** @description Webhook delivery acknowledged */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error (will retry) */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    "market-disputed": {
+        parameters: {
+            query?: never;
+            header: {
+                /** @description UUID of the webhook subscription that fired */
+                "X-Webhook-ID": string;
+                /** @description UUID of this specific delivery attempt (matches envelope `id` field) */
+                "X-Delivery-ID": string;
+                /** @description Event name string (e.g. `trader_first_trade`) */
+                "X-Event-Type": string;
+                /** @description Delivery attempt number (1 = first attempt) */
+                "X-Attempt": number;
+                /** @description HMAC-SHA256 of the raw request body: `sha256=<hex>`. Present only when the webhook has a secret configured. Verify with: HMAC-SHA256(secret, raw_body_bytes) == hex_part. */
+                "X-Webhook-Signature"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        /** @description Webhook delivery envelope. The `data` field contains the event-specific payload. */
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["WebhookDeliveryEnvelope"] & {
+                    data?: components["schemas"]["MarketDisputedPayload"];
+                };
+            };
+        };
+        responses: {
+            /** @description Webhook delivery acknowledged */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error (will retry) */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     "market-created": {
         parameters: {
             query?: never;