@structbuild/sdk 0.5.11 → 0.6.0

package/dist/generated/webhooks.d.ts

@@ -248,7 +248,7 @@ export interface webhooks {
         put?: never;
         /**
          * Global PnL callback
-         * @description Fired when a trader's global PnL crosses a configured threshold
+         * @description Fired when a trader's global PnL  crosses a configured threshold
          */
         post: operations["trader-global-pnl"];
         delete?: never;
@@ -268,7 +268,7 @@ export interface webhooks {
         put?: never;
         /**
          * Market PnL callback
-         * @description Fired when a trader's market-level PnL crosses a configured threshold
+         * @description Fired when a trader's market-level PnL  crosses a configured threshold
          */
         post: operations["trader-market-pnl"];
         delete?: never;
@@ -277,7 +277,7 @@ export interface webhooks {
         patch?: never;
         trace?: never;
     };
-    "trader-event-pnl": {
+    "trader-category-pnl": {
         parameters: {
             query?: never;
             header?: never;
@@ -287,10 +287,110 @@ export interface webhooks {
         get?: never;
         put?: never;
         /**
-         * Event PnL callback
-         * @description Fired when a trader's event-level PnL crosses a configured threshold
+         * Category PnL callback
+         * @description Fired when a trader's category-level PnL  crosses a configured threshold
          */
-        post: operations["trader-event-pnl"];
+        post: operations["trader-category-pnl"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "trader-position-resolved": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Position Resolved callback
+         * @description Fired once when a trader's position is resolved (won or lost)
+         */
+        post: operations["trader-position-resolved"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "trader-pnl-exits": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Exit Markers callback
+         * @description Fired once per position close, labelled with the exit reason (resolved_win / resolved_loss / sold_win / sold_loss).
+         */
+        post: operations["trader-pnl-exits"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "position-holder-metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Position holder metrics callback
+         * @description Fired when holder metrics change for a position.
+         */
+        post: operations["position-holder-metrics"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "condition-holder-metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Condition holder metrics callback
+         * @description Fired when holder metrics change for a condition.
+         */
+        post: operations["condition-holder-metrics"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "event-holder-metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Event holder metrics callback
+         * @description Fired when holder metrics change for an event.
+         */
+        post: operations["event-holder-metrics"];
         delete?: never;
         options?: never;
         head?: never;
@@ -795,6 +895,77 @@ export interface components {
          * @enum {string}
          */
         AssetWindowFilterTimeframe: "5m" | "15m" | "1h" | "4h" | "1d" | "24h";
+        /** @description Category PnL webhook payload. */
+        CategoryPnlPayload: {
+            trader?: string | null;
+            category?: string | null;
+            /** @description Aggregation timeframe: "1d", "7d", "30d", or "lifetime" */
+            timeframe: string;
+            /** Format: double */
+            realized_pnl_usd?: number | null;
+            /** Format: int64 */
+            markets_in_category?: number | null;
+            /** Format: int64 */
+            markets_traded?: number | null;
+            /** Format: int64 */
+            outcomes_traded?: number | null;
+            /** Format: int64 */
+            total_buys?: number | null;
+            /** Format: int64 */
+            total_sells?: number | null;
+            /** Format: int64 */
+            total_redemptions?: number | null;
+            /** Format: int64 */
+            total_merges?: number | null;
+            /** Format: int64 */
+            total_splits?: number | null;
+            /** Format: double */
+            total_volume_usd?: number | null;
+            /** Format: double */
+            buy_usd?: number | null;
+            /** Format: double */
+            sell_usd?: number | null;
+            /** Format: double */
+            redemption_usd?: number | null;
+            /** Format: double */
+            merge_usd?: number | null;
+            /** Format: double */
+            convert_collateral_usd?: number | null;
+            /** Format: double */
+            split_volume_usd?: number | null;
+            /** Format: double */
+            total_fees?: number | null;
+            /** Format: double */
+            total_shares_bought?: number | null;
+            /** Format: int64 */
+            markets_won?: number | null;
+            /** Format: int64 */
+            markets_lost?: number | null;
+            /** Format: double */
+            market_win_rate_pct?: number | null;
+            /** Format: double */
+            avg_hold_time_seconds?: number | null;
+            /** Format: double */
+            best_trade_pnl_usd?: number | null;
+            best_trade_condition_id?: string | null;
+            /** Format: double */
+            worst_trade_pnl_usd?: number | null;
+            worst_trade_condition_id?: string | null;
+            /** Format: double */
+            total_wins_usd?: number | null;
+            /** Format: double */
+            total_losses_usd?: number | null;
+            /** Format: double */
+            avg_win_usd?: number | null;
+            /** Format: double */
+            avg_loss_usd?: number | null;
+            /** Format: double */
+            profit_factor?: number | null;
+            /** Format: int64 */
+            first_trade_at?: number | null;
+            /** Format: int64 */
+            last_trade_at?: number | null;
+        };
         /**
          * @description Subscription filters for the `close_to_bond` event. At least one of
          *     `min_probability` or `max_probability` is required (enforced at runtime).
@@ -895,6 +1066,18 @@ export interface components {
              */
             threshold: number;
         };
+        ConditionHolderMetricsFilters: {
+            condition_ids?: string[];
+        };
+        ConditionHolderMetricsPayload: {
+            /** Format: int32 */
+            ts: number;
+            /** Format: int64 */
+            block: number;
+            condition_id: string;
+            /** Format: int32 */
+            holder_count: number;
+        };
         /** @description Payload delivered when a market's volume or transaction metrics cross a configured threshold */
         ConditionMetricsPayload: {
             /** @description Market condition ID */
@@ -1001,6 +1184,25 @@ export interface components {
         DeleteWebhookResponse: {
             deleted: boolean;
         };
+        /**
+         * @description What triggered a position update. Each value is serialised as a
+         *     lowercase string in the `dirty_kinds` array on every payload, and
+         *     the same values are accepted as a subscribe-time filter on rooms
+         *     that expose one.
+         *
+         *     * `trade` — a buy, sell, merge, split, redemption, or NegRisk
+         *       convert landed for the position
+         *     * `price` — the outcome price moved (mark-to-market refresh)
+         *     * `window` — a 1d / 7d / 30d rolling window boundary was crossed
+         *     * `position_resolved` — the market that owns this position resolved
+         *       on this update
+         *     * `market_resolved` — the market itself resolved (stamped on
+         *       `MarketRollup` rows for lifetime holders who never redeemed).
+         *       Carried on the resolution tick stream and on any full-row update
+         *       that bundles a resolution with a trade.
+         * @enum {string}
+         */
+        DirtyKind: "trade" | "price" | "window" | "position_resolved" | "market_resolved";
         /** @description V2 UMA OOv2: a proposed price was disputed. */
         DisputePriceEvent: {
             id: string;
@@ -1031,6 +1233,18 @@ export interface components {
             slug?: string | null;
             event_slug?: string | null;
         };
+        EventHolderMetricsFilters: {
+            event_slugs?: string[];
+        };
+        EventHolderMetricsPayload: {
+            /** Format: int32 */
+            ts: number;
+            /** Format: int64 */
+            block: number;
+            event_slug: string;
+            /** Format: int32 */
+            holder_count: number;
+        };
         /** @description Subscription filters for the `event_metrics` event. All fields are optional. */
         EventMetricsFilters: {
             /** @description Restrict to these events. Empty = all events. */
@@ -1120,47 +1334,6 @@ export interface components {
              */
             unique_builder_traders?: number | null;
         };
-        /** @description Event PnL webhook payload. */
-        EventPnlPayload: {
-            trader?: string | null;
-            event_slug?: string | null;
-            /** @description Aggregation timeframe: "1d", "7d", "30d", or "lifetime" */
-            timeframe: string;
-            /** Format: int64 */
-            markets_traded?: number | null;
-            /** Format: int64 */
-            outcomes_traded?: number | null;
-            /** Format: int64 */
-            total_buys?: number | null;
-            /** Format: int64 */
-            total_sells?: number | null;
-            /** Format: int64 */
-            total_redemptions?: number | null;
-            /** Format: int64 */
-            total_merges?: number | null;
-            /** Format: double */
-            total_volume_usd?: number | null;
-            /** Format: double */
-            buy_usd?: number | null;
-            /** Format: double */
-            sell_usd?: number | null;
-            /** Format: double */
-            redemption_usd?: number | null;
-            /** Format: double */
-            merge_usd?: number | null;
-            /** Format: double */
-            realized_pnl_usd?: number | null;
-            /** Format: int64 */
-            winning_markets?: number | null;
-            /** Format: int64 */
-            losing_markets?: number | null;
-            /** Format: double */
-            total_fees?: number | null;
-            /** Format: int64 */
-            first_trade_at?: number | null;
-            /** Format: int64 */
-            last_trade_at?: number | null;
-        };
         /** @description Subscription filters for the `event_volume_milestone` event. */
         EventVolumeMilestoneFilters: {
             /** @description **Required.** Aggregation windows to monitor. */
@@ -1253,6 +1426,35 @@ export interface components {
              */
             fees: number;
         };
+        /** @description Exit Markers webhook payload — one position open->closed transition. */
+        ExitMarkersPayload: {
+            trader: string;
+            position_id: string;
+            condition_id: string;
+            event_slug: string;
+            market_slug: string;
+            title: string;
+            question: string;
+            image_url: string;
+            outcome: string;
+            /** Format: int32 */
+            outcome_index?: number | null;
+            /** Format: double */
+            pnl_usd: number;
+            /** Format: double */
+            pnl_pct: number;
+            /** Format: double */
+            cost_basis_usd: number;
+            /** @description resolved_win | resolved_loss | sold_win | sold_loss */
+            reason: string;
+            /** Format: int64 */
+            block: number;
+            /**
+             * Format: int32
+             * @description Exit time, unix seconds.
+             */
+            ts: number;
+        };
         /** @description Payload delivered when a tracked trader executes their first-ever trade on Polymarket */
         FirstTradePayload: {
             /** @description Limit-order maker wallet address (lowercase) */
@@ -1324,7 +1526,10 @@ export interface components {
             trader?: string | null;
             /** @description Aggregation timeframe: "1d", "7d", "30d", or "lifetime" */
             timeframe: string;
-            /** Format: double */
+            /**
+             * Format: double
+             * @description Realized PnL for the timeframe (matches REST `/pnl/global`).
+             */
             realized_pnl_usd?: number | null;
             /** Format: int64 */
             events_traded?: number | null;
@@ -1338,6 +1543,8 @@ export interface components {
             total_redemptions?: number | null;
             /** Format: int64 */
             total_merges?: number | null;
+            /** Format: int64 */
+            total_splits?: number | null;
             /** Format: double */
             total_volume_usd?: number | null;
             /** Format: double */
@@ -1348,6 +1555,26 @@ export interface components {
             redemption_volume_usd?: number | null;
             /** Format: double */
             merge_volume_usd?: number | null;
+            /** Format: double */
+            convert_collateral_usd?: number | null;
+            /** Format: double */
+            split_volume_usd?: number | null;
+            /** Format: int64 */
+            maker_rebate_count?: number | null;
+            /** Format: double */
+            maker_rebate_usd?: number | null;
+            /** Format: int64 */
+            reward_count?: number | null;
+            /** Format: double */
+            reward_usd?: number | null;
+            /** Format: int64 */
+            yield_count?: number | null;
+            /** Format: double */
+            yield_usd?: number | null;
+            /** Format: int64 */
+            total_credit_count?: number | null;
+            /** Format: double */
+            total_credit_usd?: number | null;
             /** Format: int64 */
             markets_won?: number | null;
             /** Format: int64 */
@@ -1355,9 +1582,15 @@ export interface components {
             /** Format: double */
             market_win_rate_pct?: number | null;
             /** Format: double */
-            avg_pnl_per_market?: number | null;
+            total_wins_usd?: number | null;
             /** Format: double */
-            avg_pnl_per_trade?: number | null;
+            total_losses_usd?: number | null;
+            /** Format: double */
+            avg_win_usd?: number | null;
+            /** Format: double */
+            avg_loss_usd?: number | null;
+            /** Format: double */
+            profit_factor?: number | null;
             /** Format: double */
             avg_hold_time_seconds?: number | null;
             /** Format: double */
@@ -1365,6 +1598,9 @@ export interface components {
             /** Format: double */
             best_trade_pnl_usd?: number | null;
             best_trade_condition_id?: string | null;
+            /** Format: double */
+            worst_trade_pnl_usd?: number | null;
+            worst_trade_condition_id?: string | null;
             /** Format: int64 */
             first_trade_at?: number | null;
             /** Format: int64 */
@@ -1463,8 +1699,13 @@ export interface components {
             trader?: string | null;
             condition_id?: string | null;
             event_slug?: string | null;
+            category?: string | null;
             /** @description Aggregation timeframe: "1d", "7d", "30d", or "lifetime" */
             timeframe: string;
+            /** Format: double */
+            realized_pnl_usd?: number | null;
+            /** Format: double */
+            current_shares_balance?: number | null;
             /** Format: int64 */
             outcomes_traded?: number | null;
             /** Format: int64 */
@@ -1475,6 +1716,8 @@ export interface components {
             total_redemptions?: number | null;
             /** Format: int64 */
             total_merges?: number | null;
+            /** Format: int64 */
+            total_splits?: number | null;
             /** Format: double */
             buy_usd?: number | null;
             /** Format: double */
@@ -1484,11 +1727,13 @@ export interface components {
             /** Format: double */
             merge_usd?: number | null;
             /** Format: double */
-            realized_pnl_usd?: number | null;
-            /** Format: int64 */
-            winning_outcomes?: number | null;
+            convert_collateral_usd?: number | null;
+            /** Format: double */
+            split_volume_usd?: number | null;
             /** Format: double */
             total_fees?: number | null;
+            /** Format: double */
+            total_shares_bought?: number | null;
             /** Format: int64 */
             first_trade_at?: number | null;
             /** Format: int64 */
@@ -1825,7 +2070,7 @@ export interface components {
          */
         PnlFilterTimeframe: "1d" | "7d" | "30d" | "lifetime";
         /**
-         * @description PnL timeframe enum for webhook filtering
+         * @description PnL timeframe enum for webhook filtering.
          * @enum {string}
          */
         PnlTimeframeFilter: "1d" | "7d" | "30d" | "lifetime";
@@ -1833,7 +2078,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_trade_event" | "trader_global_pnl" | "trader_market_pnl" | "trader_event_pnl" | "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";
         /**
          * @description Polymarket-specific webhook filters
          *
@@ -2022,6 +2267,26 @@ export interface components {
              */
             oracle_event_types?: string[];
         };
+        PositionHolderMetricsFilters: {
+            position_ids?: string[];
+        };
+        PositionHolderMetricsPayload: {
+            /** Format: int32 */
+            ts: number;
+            /** Format: int64 */
+            block: number;
+            position_id: string;
+            /** Format: int32 */
+            holder_count: number;
+            /** Format: double */
+            total_balance: number;
+            /** Format: double */
+            total_cost_basis: number;
+            /** Format: int32 */
+            condition_holder_count?: number | null;
+            /** Format: int32 */
+            event_holder_count?: number | null;
+        };
         /** @description Subscription filters for the `position_metrics` event. All fields are optional. */
         PositionMetricsFilters: {
             /** @description Restrict to these outcome token IDs. */
@@ -2180,11 +2445,146 @@ export interface components {
             /** Format: double */
             probability_low?: number | null;
             /** Format: double */
-            avg_trade_shares?: number | null;
+            avg_trade_shares?: number | null;
+            /** Format: double */
+            avg_buy_shares?: number | null;
+            /** Format: double */
+            avg_sell_shares?: number | null;
+        };
+        PositionResolvedPayload: {
+            trader?: string;
+            position_id?: string;
+            condition_id?: string | null;
+            event_slug?: string | null;
+            /**
+             * @description Market category slug (e.g. "politics", "sports") — mirror of
+             *     `PositionRollup.category_id` resolved against the rollup
+             *     interner. Surfaces on the `/trader/{addr}/positions` API and
+             *     enables direct category-filtered + sorted position lookups
+             *     without a cross-grain join.
+             */
+            category?: string | null;
+            outcome?: string | null;
+            /** Format: int32 */
+            outcome_index?: number | null;
+            /** Format: int64 */
+            total_buys?: number;
+            /** Format: int64 */
+            total_sells?: number;
+            /** Format: int64 */
+            total_merges?: number;
+            /** Format: int64 */
+            total_splits?: number;
+            /** Format: int32 */
+            winning_outcome_index?: number | null;
+            /** Format: double */
+            total_shares_bought?: number;
+            /** Format: double */
+            total_shares_sold?: number;
+            /** Format: double */
+            buy_usd?: number;
+            /** Format: double */
+            sell_usd?: number;
+            /** Format: double */
+            avg_entry_price?: number;
+            /** Format: double */
+            total_fees?: number;
+            /** Format: double */
+            realized_pnl_usd?: number;
+            /** Format: double */
+            total_pnl_usd?: number;
+            /** Format: double */
+            redemption_usd?: number;
+            open?: boolean;
+            won?: boolean | null;
+            /** Format: int64 */
+            first_trade_at?: number | null;
+            /** Format: int64 */
+            last_trade_at?: number | null;
+            /**
+             * @description What kind of activity triggered this update. One or more of
+             *     `"trade"`, `"price"`, `"window"`, `"position_resolved"`.
+             *     Subscribers that only care about one kind filter on
+             *     `data.dirty_kinds` containing the value.
+             */
+            dirty_kinds?: components["schemas"]["DirtyKind"][];
+            /**
+             * Format: double
+             * @description `realized_pnl_usd / (buy_usd + total_fees) * 100` for the
+             *     window. `0.0` when the trader has no cost basis on this row yet.
+             */
+            realized_pnl_pct?: number;
+            /** @description Market slug for the parent market of this outcome. */
+            market_slug?: string | null;
+            /** @description Market title. */
+            title?: string | null;
+            /** @description Market question. */
+            question?: string | null;
+            /** @description Market image URL. */
+            image_url?: string | null;
+            /**
+             * Format: int32
+             * @description NegRisk conversion count + share deltas for this position.
+             */
+            converted_count?: number;
+            /** Format: double */
+            converted_shares_gained?: number;
+            /** Format: double */
+            converted_shares_lost?: number;
+            /**
+             * Format: double
+             * @description Aggregate buy/sell USD totals for this position across its
+             *     lifetime.
+             */
+            total_buy_usd?: number;
+            /** Format: double */
+            total_sell_usd?: number;
+            /**
+             * Format: double
+             * @description Merge proceeds (Y+N → collateral).
+             */
+            merge_usd?: number;
+            /**
+             * Format: double
+             * @description Sell-side average price.
+             */
+            avg_exit_price?: number | null;
+            /**
+             * Format: double
+             * @description Volume-weighted average trade price across buys + sells.
+             */
+            avg_price?: number | null;
+            /**
+             * Format: double
+             * @description Mark-to-market values from the latest price tick.
+             */
+            current_price?: number | null;
             /** Format: double */
-            avg_buy_shares?: number | null;
+            current_shares_balance?: number | null;
             /** Format: double */
-            avg_sell_shares?: number | null;
+            current_value?: number | null;
+            /**
+             * Format: double
+             * @description Last on-chain trade price for the outcome token.
+             */
+            last_traded_price?: number | null;
+            /**
+             * Format: int64
+             * @description Market resolution deadline as Unix seconds.
+             */
+            end_date?: number | null;
+            /** @description NegRisk multi-outcome flag. */
+            is_neg_risk?: boolean | null;
+            /**
+             * @description `true` when the market is resolved AND the trader still holds
+             *     shares (redeem available).
+             */
+            redeemable?: boolean | null;
+            /**
+             * @description `true` when the market is NegRisk, unresolved, and the trader
+             *     holds shares (NegRisk-adapter merge available).
+             */
+            mergeable?: boolean | null;
         };
         /** @description Subscription filters for the `position_volume_milestone` event. */
         PositionVolumeMilestoneFilters: {
@@ -2840,51 +3240,63 @@ export interface components {
          * @enum {string}
          */
         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_event_pnl` event. All fields are optional. */
-        TraderEventPnlFilters: {
-            /** @description Track only these trader wallet addresses. */
+        /** @description Subscription filters for the `trader_category_pnl` event. All fields are optional. */
+        TraderCategoryPnlFilters: {
+            /** @description Track only these trader wallet addresses. Empty = all traders. */
             traders?: string[] | null;
-            /** @description Restrict to these events. */
-            event_slugs?: string[] | null;
+            /** @description Restrict to these market categories (e.g. `politics`, `sports`). */
+            categories?: string[] | null;
             /**
              * Format: double
-             * @description Only fire when per-event realized PnL ≥ this value (USD).
+             * @description Only fire when per-category realized PnL ≥ this value (USD). Use negative values for loss thresholds.
              */
             min_realized_pnl_usd?: number | null;
             /**
              * Format: double
-             * @description Only fire when per-event realized PnL ≤ this value (USD).
+             * @description Only fire when per-category realized PnL ≤ this value (USD).
              */
             max_realized_pnl_usd?: number | null;
             /**
              * Format: double
-             * @description Only fire when total event volume ≥ this value (USD).
+             * @description Only fire when total category volume ≥ this value (USD).
              */
             min_volume_usd?: number | null;
             /**
              * Format: double
-             * @description Only fire when total event volume ≤ this value (USD).
+             * @description Only fire when total category volume ≤ this value (USD).
              */
             max_volume_usd?: number | null;
             /**
              * Format: double
-             * @description Only fire when buy volume within the event ≥ this value (USD).
+             * @description Only fire when buy volume within the category ≥ this value (USD).
              */
             min_buy_usd?: number | null;
             /**
              * Format: double
-             * @description Only fire when sell volume within the event ≥ this value (USD).
+             * @description Only fire when sell volume within the category ≥ this value (USD).
              */
             min_sell_volume_usd?: number | null;
+            /**
+             * Format: double
+             * @description Only fire when market win rate ≥ this percentage (0.0–100.0).
+             */
+            min_win_rate?: number | null;
             /**
              * Format: int64
-             * @description Only fire when the trader has traded in ≥ this many markets within the event.
+             * @description Only fire when the trader has traded in ≥ this many markets within the category.
              */
             min_markets_traded?: number | null;
-            /** @description Restrict to these PnL windows. */
+            /** @description Restrict to these PnL windows. Empty = all windows. */
             timeframes?: components["schemas"]["PnlFilterTimeframe"][] | null;
-            /** @description When `true`, suppress webhooks for short-term "updown" markets. Default: `false`. */
-            exclude_shortterm_markets?: boolean | null;
+        };
+        /** @description Subscription filters for the `trader_pnl_exits` event. All fields are optional. */
+        TraderExitMarkersFilters: {
+            /** @description Track only these trader wallet addresses. Empty = all traders. */
+            traders?: string[] | null;
+            /** @description Restrict to these markets. */
+            condition_ids?: string[] | null;
+            /** @description Restrict to positions in these events. */
+            event_slugs?: string[] | null;
         };
         /** @description Subscription filters for the `trader_first_trade` event. All fields are optional. */
         TraderFirstTradeFilters: {
@@ -3057,6 +3469,19 @@ export interface components {
             /** @description When `true`, suppress webhooks for short-term "updown" markets. Default: `false`. */
             exclude_shortterm_markets?: boolean | null;
         };
+        /** @description Subscription filters for the `trader_position_resolved` event. All fields are optional. */
+        TraderPositionResolvedFilters: {
+            /** @description Track only these trader wallet addresses. Empty = all traders. */
+            traders?: string[] | null;
+            /** @description Restrict to these markets. */
+            condition_ids?: string[] | null;
+            /** @description Restrict to positions in these events. */
+            event_slugs?: string[] | null;
+            /** @description Restrict to these outcome indexes within the resolved market. */
+            outcome_indexes?: number[] | null;
+            /** @description Only fire for won (`true`) or lost (`false`) positions. Omit to receive both. */
+            won_only?: boolean | null;
+        };
         /**
          * @description Subscription filters for the `trader_trade_event` event. All fields are optional.
          *     `event_slugs` and `exclude_shortterm_markets` require explicit `trade_types` that
@@ -4712,7 +5137,222 @@ export interface operations {
             };
         };
     };
-    "trader-event-pnl": {
+    "trader-category-pnl": {
+        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"]["CategoryPnlPayload"];
+                };
+            };
+        };
+        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-position-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"]["PositionResolvedPayload"];
+                };
+            };
+        };
+        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-pnl-exits": {
+        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"]["ExitMarkersPayload"];
+                };
+            };
+        };
+        responses: {
+            /** @description Webhook delivery acknowledged */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error (will retry) */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    "position-holder-metrics": {
+        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"]["PositionHolderMetricsPayload"];
+                };
+            };
+        };
+        responses: {
+            /** @description Webhook delivery acknowledged */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error (will retry) */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    "condition-holder-metrics": {
+        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"]["ConditionHolderMetricsPayload"];
+                };
+            };
+        };
+        responses: {
+            /** @description Webhook delivery acknowledged */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error (will retry) */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    "event-holder-metrics": {
         parameters: {
             query?: never;
             header: {
@@ -4734,7 +5374,7 @@ export interface operations {
         requestBody: {
             content: {
                 "application/json": components["schemas"]["WebhookDeliveryEnvelope"] & {
-                    data?: components["schemas"]["EventPnlPayload"];
+                    data?: components["schemas"]["EventHolderMetricsPayload"];
                 };
             };
         };