@structbuild/sdk 0.6.0 → 0.6.2

package/dist/generated/webhooks.d.ts

@@ -548,7 +548,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 +568,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 +648,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 +657,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 +886,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 +911,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. */
@@ -971,6 +1041,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.
@@ -1068,6 +1147,11 @@ export interface components {
         };
         ConditionHolderMetricsFilters: {
             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 */
@@ -1235,6 +1319,11 @@ export interface components {
         };
         EventHolderMetricsFilters: {
             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 */
@@ -1247,6 +1336,11 @@ export interface components {
         };
         /** @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. */
@@ -1336,6 +1430,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. */
@@ -1372,6 +1471,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.
@@ -1612,6 +1716,11 @@ export interface components {
         };
         /** @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 +1771,65 @@ 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 `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. */
@@ -1739,8 +1905,67 @@ export interface components {
             /** Format: int64 */
             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 +1975,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.
@@ -2052,6 +2282,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 +2313,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" | "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 +2333,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
@@ -2122,8 +2361,16 @@ export interface components {
             min_usd_value?: number | null;
             /** @description Filter by event slugs. Max 500 entries. */
             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?: string[];
+            /**
+             * @description Filter by series slugs (case-insensitive). Matches a market's parent
+             *     series. Max 500 entries.
+             */
+            series_slugs?: string[];
             /**
              * Format: double
              * @description Minimum probability threshold (0.0 - 1.0)
@@ -2266,9 +2513,25 @@ export interface components {
              *     `NegRiskOutcomeReported`. Empty = all types.
              */
             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: {
             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 */
@@ -2289,6 +2552,11 @@ export interface components {
         };
         /** @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. */
@@ -2494,6 +2762,8 @@ export interface components {
             /** Format: double */
             total_pnl_usd?: number;
             /** Format: double */
+            unrealized_pnl_usd?: number;
+            /** Format: double */
             redemption_usd?: number;
             open?: boolean;
             won?: boolean | null;
@@ -2514,6 +2784,8 @@ export interface components {
              *     window. `0.0` when the trader has no cost basis on this row yet.
              */
             realized_pnl_pct?: number;
+            /** Format: double */
+            total_pnl_pct?: number;
             /** @description Market slug for the parent market of this outcome. */
             market_slug?: string | null;
             /** @description Market title. */
@@ -2588,6 +2860,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. */
@@ -2650,6 +2927,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.
@@ -2714,6 +2996,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. */
@@ -2722,6 +3009,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).
@@ -2785,8 +3076,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. */
@@ -2805,6 +3214,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).
@@ -3149,6 +3562,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. */
@@ -3242,6 +3660,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`). */
@@ -3291,6 +3714,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. */
@@ -3300,6 +3728,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. */
@@ -3326,6 +3759,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;
             /**
@@ -3373,6 +3811,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. */
@@ -3416,6 +3859,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. */
@@ -3442,6 +3890,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. */
@@ -3471,6 +3924,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. */
@@ -3489,6 +3947,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`. */
@@ -3518,6 +3981,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. */
@@ -3622,8 +4090,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. */
@@ -3746,6 +4222,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: {
@@ -5954,6 +6441,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;