@structbuild/sdk 0.3.1 → 0.3.3

package/dist/generated/webhooks.d.ts

@@ -188,7 +188,7 @@ export interface webhooks {
         put?: never;
         /**
          * New trade callback
-         * @description Fired on every order-filled trade. Use `wallet_addresses` to watch specific traders, `min_usd_value` to filter by size, and `min_probability`/`max_probability` to restrict to a probability range.
+         * @description Fired on fill-style trades only (`OrderFilled`, `OrdersMatched`). Use `wallet_addresses` to watch specific traders, `min_usd_value` to filter by size, and `min_probability`/`max_probability` to restrict to a probability range.
          */
         post: operations["trader-new-trade"];
         delete?: never;
@@ -197,6 +197,26 @@ export interface webhooks {
         patch?: never;
         trace?: never;
     };
+    "trade-event": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Typed trade-event callback
+         * @description Fired on every live confirmed prediction-trade event. Payload uses the exact tagged `WebhookTradeEventPayload` union for the trade types currently emitted by the webhook pipeline.
+         */
+        post: operations["trade-event"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "trader-global-pnl": {
         parameters: {
             query?: never;
@@ -657,8 +677,11 @@ export interface components {
         ConditionMetricsPayload: {
             /** @description Market condition ID */
             condition_id?: string | null;
-            /** @description Aggregation window (e.g. "1h", "24h") */
-            timeframe?: string | null;
+            /**
+             * @description Aggregation window
+             * @enum {string|null}
+             */
+            timeframe?: "1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d" | null;
             /** @description Total trading volume in USD for this timeframe */
             volume_usd?: number | null;
             /** @description Total fees collected in USD */
@@ -694,8 +717,11 @@ export interface components {
         EventMetricsPayload: {
             /** @description Event slug */
             event_slug?: string | null;
-            /** @description Aggregation window (e.g. "1h", "24h") */
-            timeframe?: string | null;
+            /**
+             * @description Aggregation window
+             * @enum {string|null}
+             */
+            timeframe?: "1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d" | null;
             /** @description Total aggregated volume across all markets in the event (USD) */
             volume_usd?: number | null;
             /** @description Total fees collected in USD */
@@ -765,8 +791,11 @@ export interface components {
         EventVolumeMilestonePayload: {
             /** @description Event slug */
             event_slug: string;
-            /** @description Aggregation window (e.g. "1h", "24h") */
-            timeframe: string;
+            /**
+             * @description Aggregation window
+             * @enum {string}
+             */
+            timeframe: "1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d";
             /** @description The USD milestone amount that was crossed */
             milestone_usd: number;
             /** @description Current aggregated event volume at time of trigger (USD) */
@@ -783,8 +812,11 @@ export interface components {
         EventVolumeSpikePayload: {
             /** @description Event slug */
             event_slug: string;
-            /** @description Aggregation window (e.g. "1h", "24h") */
-            timeframe: string;
+            /**
+             * @description Aggregation window
+             * @enum {string}
+             */
+            timeframe: "1m" | "5m" | "30m" | "1h" | "6h" | "1d" | "24h" | "7d" | "30d";
             /** @description Current aggregated event volume at time of the spike (USD) */
             current_volume_usd: number;
             /** @description Volume at the snapshot baseline (USD) */
@@ -844,10 +876,16 @@ export interface components {
             side: "Buy" | "Sell";
             /** @description Outcome token price (0.0–1.0) */
             price: number;
-            /** @description Exchange identifier */
-            exchange: string;
-            /** @description Trade type identifier */
-            trade_type: string;
+            /**
+             * @description Exchange contract that processed the trade
+             * @enum {string}
+             */
+            exchange: "CTFExchange" | "NegRiskExchange" | "ConditionalTokens" | "NegRiskAdapter" | "Unknown";
+            /**
+             * @description Trade type (webhook events only fire on order fills)
+             * @enum {string}
+             */
+            trade_type: "OrderFilled" | "OrdersMatched";
         };
         /** @description Payload delivered when a trader's global PnL (across all markets) crosses a configured threshold */
         GlobalPnlPayload: {
@@ -1037,8 +1075,11 @@ export interface components {
         MarketVolumeSpikePayload: {
             /** @description Market condition ID */
             condition_id: string;
-            /** @description Aggregation window (e.g. "1h", "24h") */
-            timeframe: string;
+            /**
+             * @description Aggregation window
+             * @enum {string}
+             */
+            timeframe: "1m" | "5m" | "30m" | "1h" | "6h" | "1d" | "24h" | "7d" | "30d";
             /** @description Current volume at the time of the spike (USD) */
             current_volume_usd: number;
             /** @description Volume at the snapshot baseline (USD) */
@@ -1104,10 +1145,16 @@ export interface components {
             price: number;
             /** @description Implied probability (0.0–1.0); null when outcome is unknown */
             probability?: number | null;
-            /** @description Exchange identifier */
-            exchange: string;
-            /** @description Trade type identifier */
-            trade_type: string;
+            /**
+             * @description Exchange contract that processed the trade
+             * @enum {string}
+             */
+            exchange: "CTFExchange" | "NegRiskExchange" | "ConditionalTokens" | "NegRiskAdapter" | "Unknown";
+            /**
+             * @description Trade type (webhook events only fire on order fills)
+             * @enum {string}
+             */
+            trade_type: "OrderFilled" | "OrdersMatched";
         };
         /** @description Payload delivered on every order-filled trade */
         NewTradePayload: {
@@ -1158,10 +1205,16 @@ export interface components {
             price: number;
             /** @description Implied probability (0.0–1.0); null when outcome is unknown */
             probability?: number | null;
-            /** @description Exchange identifier */
-            exchange: string;
-            /** @description Trade type identifier */
-            trade_type: string;
+            /**
+             * @description Exchange contract that processed the trade
+             * @enum {string}
+             */
+            exchange: "CTFExchange" | "NegRiskExchange" | "ConditionalTokens" | "NegRiskAdapter" | "Unknown";
+            /**
+             * @description Trade type (webhook events only fire on order fills)
+             * @enum {string}
+             */
+            trade_type: "OrderFilled" | "OrdersMatched";
         };
         /**
          * @description PnL timeframe enum for webhook filtering
@@ -1172,7 +1225,7 @@ export interface components {
          * @description Polymarket webhook event types
          * @enum {string}
          */
-        PolymarketWebhookEvent: "trader_first_trade" | "trader_new_market" | "trader_whale_trade" | "trader_new_trade" | "trader_global_pnl" | "trader_market_pnl" | "trader_event_pnl" | "condition_metrics" | "event_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";
+        PolymarketWebhookEvent: "trader_first_trade" | "trader_new_market" | "trader_whale_trade" | "trader_new_trade" | "trade_event" | "trader_global_pnl" | "trader_market_pnl" | "trader_event_pnl" | "condition_metrics" | "event_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";
         /**
          * @description Polymarket-specific webhook filters
          *
@@ -1191,6 +1244,8 @@ export interface components {
          *     - market_created: event_slugs, tags, exclude_shortterm_markets
          *     - probability_spike: condition_ids, event_slugs, outcomes, 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
+         *     - trader_new_trade: wallet_addresses, min_usd_value, min_probability, max_probability, condition_ids, event_slugs, trade_types, exclude_shortterm_markets
+         *     - 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
          *     - trader_new_market: wallet_addresses, condition_ids, event_slugs, min_usd_value, min_probability, max_probability, exclude_shortterm_markets
          *     - trader_whale_trade: min_usd_value (required), min_probability, max_probability, condition_ids, event_slugs, exclude_shortterm_markets
@@ -1279,6 +1334,8 @@ export interface components {
              *     When non-empty, only trades whose outcome_index is in this list will match. Max 500 entries.
              */
             position_outcome_indices?: number[];
+            /** @description Filter by trade type (e.g. "OrderFilled", "Redemption", "Merge", "Split"). Empty = default behavior per handler. */
+            trade_types?: string[];
             /**
              * Format: double
              * @description Minimum fees - for metrics webhooks
@@ -1357,8 +1414,11 @@ export interface components {
              * @description Outcome index
              */
             outcome_index?: number | null;
-            /** @description Aggregation window (e.g. "1h", "24h") */
-            timeframe?: string | null;
+            /**
+             * @description Aggregation window
+             * @enum {string|null}
+             */
+            timeframe?: "1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d" | null;
             /** @description Total trading volume in USD */
             volume_usd?: number | null;
             /** @description Buy volume in USD */
@@ -1397,8 +1457,11 @@ export interface components {
              * @description Outcome index
              */
             outcome_index?: number | null;
-            /** @description Aggregation window (e.g. "1h", "24h") */
-            timeframe: string;
+            /**
+             * @description Aggregation window
+             * @enum {string}
+             */
+            timeframe: "1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d";
             /** @description The USD milestone amount that was crossed */
             milestone_usd: number;
             /** @description Current position volume at time of trigger (USD) */
@@ -1426,8 +1489,11 @@ export interface components {
             outcome?: string | null;
             /** Format: int16 */
             outcome_index?: number | null;
-            /** @description Aggregation window (e.g. "1h", "24h") */
-            timeframe: string;
+            /**
+             * @description Aggregation window
+             * @enum {string}
+             */
+            timeframe: "1m" | "5m" | "30m" | "1h" | "6h" | "1d" | "24h" | "7d" | "30d";
             /** @description Current position volume at the time of the spike (USD) */
             current_volume_usd: number;
             /** @description Volume at the snapshot baseline (USD) */
@@ -1523,8 +1589,11 @@ export interface components {
         VolumeMilestonePayload: {
             /** @description Market condition ID */
             condition_id: string;
-            /** @description Aggregation window that crossed the milestone (e.g. "1h", "24h") */
-            timeframe: string;
+            /**
+             * @description Aggregation window that crossed the milestone
+             * @enum {string}
+             */
+            timeframe: "1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d";
             /** @description The USD milestone amount that was crossed */
             milestone_usd: number;
             /** @description Current volume at time of trigger (USD) */
@@ -1548,13 +1617,16 @@ export interface components {
             event: string;
             /** @description Human-readable description */
             description: string;
-            /** @description Category grouping: "trader", "market", "event", or "position" */
-            category: string;
+            /**
+             * @description Category grouping for the event type
+             * @enum {string}
+             */
+            category: "trader" | "trade" | "market" | "event" | "position" | "assets";
             /**
              * Format: int64
-             * @description Credits consumed per webhook delivery
+             * @description Millicredits consumed per webhook delivery (1 credit = 1000 mc)
              */
-            credits_cost: number;
+            millicredits_cost: number;
             /** @description Filter field names that apply to this event type */
             applicable_filters: string[];
         };
@@ -1570,10 +1642,14 @@ 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. */
+            tags?: 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. */
             position_outcome_indices?: number[];
+            /** @description Filter by trade type — for `trader_new_trade` and `trade_event`. Max 500 entries. */
+            trade_types?: string[];
             /**
              * Format: double
              * @description Minimum USD trade size (for whale_trade / first_trade)
@@ -1629,6 +1705,16 @@ export interface components {
              * @description Minimum markets traded — for global_pnl / event_pnl
              */
             min_markets_traded?: number | null;
+            /**
+             * Format: double
+             * @description Minimum net shares held — for position-level filters
+             */
+            min_net_shares?: number | null;
+            /**
+             * Format: double
+             * @description Maximum net shares held — for position-level filters
+             */
+            max_net_shares?: number | null;
             /**
              * Format: double
              * @description Minimum fees (USD) — for metrics webhooks
@@ -1667,6 +1753,14 @@ export interface components {
              * @description Spike ratio multiplier (must be > 1.0) — for volume_spike. E.g. 2.0 for 2x baseline
              */
             spike_ratio?: number | null;
+            spike_direction?: null | components["schemas"]["SpikeDirection"];
+            /**
+             * Format: int64
+             * @description Observation window in seconds (max 600) — for probability_spike, price_spike, volume_spike
+             */
+            window_secs?: number | null;
+            /** @description When true, suppress webhooks for short-term "updown" markets */
+            exclude_shortterm_markets?: boolean;
             /**
              * @description Filter by crypto asset symbol — for `asset_price_tick` and `asset_price_window_update`.
              *     Valid values: "BTC", "ETH", "SOL", "XRP", "DOGE", "BNB", "HYPE". Empty = all assets (send everything).
@@ -1690,8 +1784,11 @@ export interface components {
             event: components["schemas"]["PolymarketWebhookEvent"];
             /** @description Active filters (omitted when no filters are set) */
             filters?: components["schemas"]["PolymarketWebhookFilter"];
-            /** @description Current status: "active", "paused", or "disabled" */
-            status: string;
+            /**
+             * @description Current webhook status
+             * @enum {string}
+             */
+            status: "active" | "paused" | "disabled" | "suspended";
             /**
              * Format: int64
              * @description Created timestamp (ms)
@@ -1788,10 +1885,16 @@ export interface components {
             price: number;
             /** @description Implied probability (0.0–1.0); null when outcome is unknown */
             probability?: number | null;
-            /** @description Exchange identifier */
-            exchange: string;
-            /** @description Trade type identifier */
-            trade_type: string;
+            /**
+             * @description Exchange contract that processed the trade
+             * @enum {string}
+             */
+            exchange: "CTFExchange" | "NegRiskExchange" | "ConditionalTokens" | "NegRiskAdapter" | "Unknown";
+            /**
+             * @description Trade type (webhook events only fire on order fills)
+             * @enum {string}
+             */
+            trade_type: "OrderFilled" | "OrdersMatched";
         };
         /** @description Outer envelope for every webhook HTTP POST delivery. The `data` field contains the event-specific payload. Delivery headers sent with every POST: `X-Webhook-ID` (subscription UUID), `X-Delivery-ID` (this attempt's UUID), `X-Event-Type` (event name string, e.g. `trader_first_trade`), `X-Attempt` (attempt number, 1-indexed). When the webhook has a secret configured, `X-Webhook-Signature: sha256=<hmac-hex>` is also included — compute HMAC-SHA256 over the raw request body using your secret to verify. */
         WebhookDeliveryEnvelope: {
@@ -1817,6 +1920,482 @@ export interface components {
             /** @description Delivery attempt number. 1 = first attempt; increments on each retry. */
             attempt: number;
         };
+        /** @description Exact payload union for `trade_event` webhook deliveries. These callbacks are emitted from the live confirmed trade pipeline, so pending-only fields such as `received_at` are absent. */
+        WebhookTradeEventPayload: {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            /** Format: int64 */
+            log_index: number;
+            /** Format: int64 */
+            block_index: number;
+            order_hash: string;
+            trader: {
+                address: string;
+                name: string | null;
+                pseudonym: string | null;
+                profile_image: string | null;
+                x_username: string | null;
+                verified_badge: boolean;
+            };
+            taker: string;
+            /** @enum {string} */
+            side: "Buy" | "Sell";
+            condition_id: string | null;
+            position_id: string;
+            outcome?: string;
+            outcome_index: number | null;
+            question?: string;
+            image_url?: string;
+            slug?: string;
+            event_slug?: string;
+            usd_amount: number;
+            shares_amount: number;
+            price: number;
+            probability?: number;
+            fee: number;
+            fee_shares: number;
+            fee_pct: number;
+            /**
+             * @description Exchange contract that processed the event
+             * @enum {string}
+             */
+            exchange: "CTFExchange" | "NegRiskExchange" | "ConditionalTokens" | "NegRiskAdapter" | "Unknown";
+            /** @enum {string} */
+            trade_type: "OrderFilled" | "OrdersMatched";
+        } | {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            /** Format: int64 */
+            log_index: number;
+            /** Format: int64 */
+            block_index: number;
+            trader: {
+                address: string;
+                name: string | null;
+                pseudonym: string | null;
+                profile_image: string | null;
+                x_username: string | null;
+                verified_badge: boolean;
+            };
+            condition_id: string | null;
+            outcome?: string;
+            outcome_index: number | null;
+            question?: string;
+            image_url?: string;
+            slug?: string;
+            event_slug?: string;
+            usd_amount: number;
+            winning_outcome_index?: number;
+            position_details?: {
+                position_id: string;
+                outcome_index: number;
+                outcome?: string;
+                amount: string;
+            }[];
+            /**
+             * @description Exchange contract that processed the event
+             * @enum {string}
+             */
+            exchange: "CTFExchange" | "NegRiskExchange" | "ConditionalTokens" | "NegRiskAdapter" | "Unknown";
+            /** @enum {string} */
+            trade_type: "Redemption";
+        } | {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            /** Format: int64 */
+            log_index: number;
+            /** Format: int64 */
+            block_index: number;
+            trader: {
+                address: string;
+                name: string | null;
+                pseudonym: string | null;
+                profile_image: string | null;
+                x_username: string | null;
+                verified_badge: boolean;
+            };
+            condition_id: string | null;
+            question?: string;
+            image_url?: string;
+            slug?: string;
+            event_slug?: string;
+            usd_amount: number;
+            position_details?: {
+                position_id: string;
+                outcome_index: number;
+                outcome?: string;
+                amount: string;
+            }[];
+            /**
+             * @description Exchange contract that processed the event
+             * @enum {string}
+             */
+            exchange: "CTFExchange" | "NegRiskExchange" | "ConditionalTokens" | "NegRiskAdapter" | "Unknown";
+            /** @enum {string} */
+            trade_type: "Merge";
+        } | {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            /** Format: int64 */
+            log_index: number;
+            /** Format: int64 */
+            block_index: number;
+            trader: {
+                address: string;
+                name: string | null;
+                pseudonym: string | null;
+                profile_image: string | null;
+                x_username: string | null;
+                verified_badge: boolean;
+            };
+            condition_id: string | null;
+            question?: string;
+            image_url?: string;
+            slug?: string;
+            event_slug?: string;
+            usd_amount: number;
+            position_details?: {
+                position_id: string;
+                outcome_index: number;
+                outcome?: string;
+                amount: string;
+            }[];
+            /**
+             * @description Exchange contract that processed the event
+             * @enum {string}
+             */
+            exchange: "CTFExchange" | "NegRiskExchange" | "ConditionalTokens" | "NegRiskAdapter" | "Unknown";
+            /** @enum {string} */
+            trade_type: "Split";
+        } | {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            /** Format: int64 */
+            log_index: number;
+            /** Format: int64 */
+            block_index: number;
+            trader: {
+                address: string;
+                name: string | null;
+                pseudonym: string | null;
+                profile_image: string | null;
+                x_username: string | null;
+                verified_badge: boolean;
+            };
+            market_id: string;
+            index_set: string;
+            shares_amount: number;
+            /**
+             * @description Exchange contract that processed the event
+             * @enum {string}
+             */
+            exchange: "CTFExchange" | "NegRiskExchange" | "ConditionalTokens" | "NegRiskAdapter" | "Unknown";
+            /** @enum {string} */
+            trade_type: "PositionsConverted";
+        } | {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            /** Format: int64 */
+            log_index: number;
+            /** Format: int64 */
+            block_index: number;
+            order_hash: string;
+            question?: string;
+            image_url?: string;
+            slug?: string;
+            event_slug?: string;
+            /**
+             * @description Exchange contract that processed the event
+             * @enum {string}
+             */
+            exchange: "CTFExchange" | "NegRiskExchange" | "ConditionalTokens" | "NegRiskAdapter" | "Unknown";
+            /** @enum {string} */
+            trade_type: "Cancelled";
+        } | {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            /** Format: int64 */
+            log_index: number;
+            /** Format: int64 */
+            block_index: number;
+            oracle_contract: string;
+            condition_id: string;
+            creator: string;
+            reward_token: string;
+            reward: string;
+            proposal_bond: string;
+            question?: string;
+            image_url?: string;
+            slug?: string;
+            event_slug?: string;
+            /** @enum {string} */
+            trade_type: "Initialization";
+        } | {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            /** Format: int64 */
+            log_index: number;
+            /** Format: int64 */
+            block_index: number;
+            oracle_contract: string;
+            condition_id: string;
+            assertion_id: string;
+            domain_id: string;
+            claim: string;
+            asserter: string;
+            callback_recipient: string;
+            escalation_manager: string;
+            caller: string;
+            /** Format: int64 */
+            expiration_time: number;
+            currency: string;
+            bond: string;
+            identifier: string;
+            proposed_outcome?: string;
+            question?: string;
+            image_url?: string;
+            slug?: string;
+            event_slug?: string;
+            /** @enum {string} */
+            trade_type: "Proposal";
+        } | {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            /** Format: int64 */
+            log_index: number;
+            /** Format: int64 */
+            block_index: number;
+            oracle_contract: string;
+            condition_id: string;
+            assertion_id: string;
+            caller: string;
+            disputer: string;
+            question?: string;
+            image_url?: string;
+            slug?: string;
+            event_slug?: string;
+            /** @enum {string} */
+            trade_type: "Dispute";
+        } | {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            /** Format: int64 */
+            log_index: number;
+            /** Format: int64 */
+            block_index: number;
+            oracle_contract: string;
+            condition_id: string;
+            assertion_id: string;
+            bond_recipient: string;
+            disputed: boolean;
+            settlement_resolution: boolean;
+            settle_caller: string;
+            question?: string;
+            image_url?: string;
+            slug?: string;
+            event_slug?: string;
+            /** @enum {string} */
+            trade_type: "Settled";
+        } | {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            /** Format: int64 */
+            log_index: number;
+            /** Format: int64 */
+            block_index: number;
+            oracle_contract: string;
+            condition_id: string;
+            /** Format: int64 */
+            settled_price: number;
+            proposed_outcome?: string;
+            question?: string;
+            image_url?: string;
+            slug?: string;
+            event_slug?: string;
+            /** @enum {string} */
+            trade_type: "Resolution";
+        } | {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            /** Format: int64 */
+            log_index: number;
+            /** Format: int64 */
+            block_index: number;
+            oracle_contract: string;
+            condition_id: string;
+            oracle: string;
+            proposed_outcome?: string;
+            question?: string;
+            image_url?: string;
+            slug?: string;
+            event_slug?: string;
+            /** @enum {string} */
+            trade_type: "ConditionResolution";
+        } | {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            /** Format: int64 */
+            log_index: number;
+            /** Format: int64 */
+            block_index: number;
+            oracle_contract: string;
+            condition_id: string;
+            question?: string;
+            image_url?: string;
+            slug?: string;
+            event_slug?: string;
+            /** @enum {string} */
+            trade_type: "Reset" | "Flag" | "Unflag" | "Pause" | "Unpause";
+        } | {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            /** Format: int64 */
+            log_index: number;
+            /** Format: int64 */
+            block_index: number;
+            oracle_contract: string;
+            condition_id: string;
+            proposed_outcome?: string;
+            question?: string;
+            image_url?: string;
+            slug?: string;
+            event_slug?: string;
+            /** @enum {string} */
+            trade_type: "ManualResolution";
+        } | {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            /** Format: int64 */
+            log_index: number;
+            /** Format: int64 */
+            block_index: number;
+            oracle_contract: string;
+            condition_id: string;
+            proposed_outcome?: string;
+            question?: string;
+            image_url?: string;
+            slug?: string;
+            event_slug?: string;
+            /** @enum {string} */
+            trade_type: "NegRiskOutcomeReported";
+        } | {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            /** Format: int64 */
+            log_index: number;
+            /** Format: int64 */
+            block_index: number;
+            condition_id: string;
+            token0: string;
+            token1: string;
+            question?: string;
+            image_url?: string;
+            slug?: string;
+            event_slug?: string;
+            /**
+             * @description Exchange contract that processed the event
+             * @enum {string}
+             */
+            exchange: "CTFExchange" | "NegRiskExchange" | "ConditionalTokens" | "NegRiskAdapter" | "Unknown";
+            /** @enum {string} */
+            trade_type: "RegisterToken";
+        } | {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            /** Format: int64 */
+            log_index: number;
+            /** Format: int64 */
+            block_index: number;
+            trader: {
+                address: string;
+                name: string | null;
+                pseudonym: string | null;
+                profile_image: string | null;
+                x_username: string | null;
+                verified_badge: boolean;
+            };
+            operator: string;
+            approved: boolean;
+            question?: string;
+            image_url?: string;
+            slug?: string;
+            event_slug?: string;
+            /**
+             * @description Exchange contract that processed the event
+             * @enum {string}
+             */
+            exchange: "CTFExchange" | "NegRiskExchange" | "ConditionalTokens" | "NegRiskAdapter" | "Unknown";
+            /** @enum {string} */
+            trade_type: "Approval";
+        };
         /** @description Subscription filters for the `trader_first_trade` event. All fields are optional. */
         TraderFirstTradeFilters: {
             /** @description Only fire for trades by these wallet addresses (lowercase). Empty = all traders. */
@@ -1842,6 +2421,12 @@ export interface components {
             condition_ids?: string[];
             /** @description Restrict to markets belonging to these events. */
             event_slugs?: string[];
+            /** @description Minimum trade size in USD. Omit to match all sizes. */
+            min_usd_value?: number;
+            /** @description Only fire when the outcome probability is ≥ this value. */
+            min_probability?: number;
+            /** @description Only fire when the outcome probability is ≤ this value. */
+            max_probability?: number;
             /** @description When `true`, suppress webhooks for short-term "updown" markets. Default: `false`. */
             exclude_shortterm_markets?: boolean;
         };
@@ -1882,9 +2467,33 @@ export interface components {
             min_probability?: number;
             /** @description Only fire when outcome probability is ≤ this value. */
             max_probability?: number;
+            /** @description Only fire for these fill-style trade types. Empty = OrderFilled and OrdersMatched only (default). */
+            trade_types?: ("OrderFilled" | "OrdersMatched")[];
             /** @description When `true`, suppress webhooks for short-term "updown" markets. Default: `false`. */
             exclude_shortterm_markets?: boolean;
         };
+        /** @description Subscription filters for the `trade_event` event. All fields are optional. `event_slugs` and `exclude_shortterm_markets` require explicit `trade_types` that exclude `PositionsConverted`, because conversion events do not currently carry `event_slug` in the typed webhook payload. */
+        TradeEventFilters: {
+            /** @description Only fire for events associated with these wallet addresses. Empty = all traders. */
+            wallet_addresses?: string[];
+            /** @description Restrict to these markets. For `PositionsConverted`, this also matches the NegRisk `market_id`. */
+            condition_ids?: string[];
+            /** @description Restrict to markets belonging to these events. Requires explicit `trade_types` that exclude `PositionsConverted`. */
+            event_slugs?: string[];
+            /**
+             * @description Minimum USD amount for the underlying event. Defaults to 0 (matches all events).
+             * @default 0
+             */
+            min_usd_value: number;
+            /** @description Only fire when event probability is ≥ this value. Events without probability data do not match. */
+            min_probability?: number;
+            /** @description Only fire when event probability is ≤ this value. Events without probability data do not match. */
+            max_probability?: number;
+            /** @description Only fire for these trade types currently emitted through the webhook pipeline. Empty = all supported trade-event variants. */
+            trade_types?: ("OrderFilled" | "Redemption" | "Merge" | "Split" | "Cancelled" | "PositionsConverted" | "OrdersMatched" | "Initialization" | "Proposal" | "Dispute" | "Settled" | "Resolution" | "ConditionResolution" | "Reset" | "Flag" | "Unflag" | "Pause" | "Unpause" | "ManualResolution" | "NegRiskOutcomeReported" | "RegisterToken" | "Approval")[];
+            /** @description When `true`, suppress webhooks for short-term "updown" markets. Requires explicit `trade_types` that exclude `PositionsConverted`. Default: `false`. */
+            exclude_shortterm_markets?: boolean;
+        };
         /** @description Subscription filters for the `trader_global_pnl` event. All fields are optional. */
         TraderGlobalPnlFilters: {
             /** @description Track only these trader wallet addresses. Empty = all traders. */
@@ -1968,8 +2577,6 @@ export interface components {
         MarketMetricsFilters: {
             /** @description Restrict to these markets. Empty = all markets. */
             condition_ids?: string[];
-            /** @description Restrict to markets in these events. */
-            event_slugs?: string[];
             /** @description Restrict to these aggregation windows. Empty = all windows. */
             timeframes?: ("1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d")[];
             /** @description Only fire when volume ≥ this value (USD). */
@@ -2168,8 +2775,6 @@ export interface components {
         MarketCreatedFilters: {
             /** @description Restrict to markets with these tags or category names (case-insensitive match). */
             tags?: string[];
-            /** @description Restrict to these specific markets. */
-            condition_ids?: string[];
             /** @description Restrict to markets belonging to these events. */
             event_slugs?: string[];
             /** @description When `true`, suppress webhooks for short-term "updown" markets (event slugs containing `updown`). Default: `false`. */
@@ -2679,6 +3284,49 @@ export interface operations {
             };
         };
     };
+    "trade-event": {
+        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"]["WebhookTradeEventPayload"];
+                };
+            };
+        };
+        responses: {
+            /** @description Webhook delivery acknowledged */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error (will retry) */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     "trader-global-pnl": {
         parameters: {
             query?: never;