@structbuild/sdk 0.1.6 → 0.1.7

package/dist/generated/webhooks.d.ts

@@ -0,0 +1,1656 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/webhooks": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List webhooks
+         * @description Retrieve a paginated list of your webhook subscriptions with optional filtering
+         */
+        get: operations["list_webhooks"];
+        put?: never;
+        /**
+         * Create webhook
+         * @description Create a new webhook subscription for real-time event notifications
+         */
+        post: operations["create_webhook"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/webhooks/{webhook_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get webhook
+         * @description Retrieve details of a specific webhook by its ID
+         */
+        get: operations["get_webhook"];
+        /**
+         * Update webhook
+         * @description Update an existing webhook's URL, filters, or status
+         */
+        put: operations["update_webhook"];
+        post?: never;
+        /**
+         * Delete webhook
+         * @description Permanently delete a webhook subscription
+         */
+        delete: operations["delete_webhook"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/webhooks/{webhook_id}/test": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Test webhook
+         * @description Send a test payload to the webhook URL to verify connectivity
+         */
+        post: operations["test_webhook"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export interface webhooks {
+    "first-trade": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * First trade callback
+         * @description Fired when a tracked trader executes their first trade on a market
+         */
+        post: operations["first-trade"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "global-pnl": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Global PnL callback
+         * @description Fired when a trader's global PnL crosses a configured threshold
+         */
+        post: operations["global-pnl"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "market-pnl": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Market PnL callback
+         * @description Fired when a trader's market-level PnL crosses a configured threshold
+         */
+        post: operations["market-pnl"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "event-pnl": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Event PnL callback
+         * @description Fired when a trader's event-level PnL crosses a configured threshold
+         */
+        post: operations["event-pnl"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "position-pnl": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Position PnL callback
+         * @description Fired when a trader's position-level PnL crosses a configured threshold
+         */
+        post: operations["position-pnl"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "market-metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Market metrics callback
+         * @description Fired when a market's volume or transaction metrics cross a configured threshold
+         */
+        post: operations["market-metrics"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "event-metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Event metrics callback
+         * @description Fired when an event's volume or transaction metrics cross a configured threshold
+         */
+        post: operations["event-metrics"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "position-metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Position metrics callback
+         * @description Fired when a position's volume or transaction metrics cross a configured threshold
+         */
+        post: operations["position-metrics"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "market-volume-milestone": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Market volume milestone callback
+         * @description Fired when a market's trading volume reaches a milestone threshold
+         */
+        post: operations["market-volume-milestone"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "event-volume-milestone": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Event volume milestone callback
+         * @description Fired when an event's trading volume reaches a milestone threshold
+         */
+        post: operations["event-volume-milestone"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "position-volume-milestone": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Position volume milestone callback
+         * @description Fired when a position's trading volume reaches a milestone threshold
+         */
+        post: operations["position-volume-milestone"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "probability-spike": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Probability spike callback
+         * @description Fired when a position's probability changes by more than a configured percentage
+         */
+        post: operations["probability-spike"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export interface components {
+    schemas: {
+        /** @description Condition metrics webhook payload (Arc-optimized, no internal metadata) */
+        ConditionMetricsPayload: {
+            condition_id?: string | null;
+            timeframe?: string | null;
+            /** Format: double */
+            volume_usd?: number | null;
+            /** Format: double */
+            fees?: number | null;
+            /** Format: int64 */
+            txns?: number | null;
+            /** Format: int64 */
+            unique_traders?: number | null;
+        };
+        /** @description Request body for creating a webhook */
+        CreateWebhookRequestBody: {
+            /** @description Destination URL for webhook deliveries (must be HTTPS) */
+            url: string;
+            /** @description Events to subscribe to */
+            events: components["schemas"]["PolymarketWebhookEvent"][];
+            /** @description Optional secret for HMAC signature verification */
+            secret?: string | null;
+            filters?: null | components["schemas"]["WebhookFiltersBody"];
+            /** @description Optional description/name */
+            description?: string | null;
+        };
+        /** @description Event metrics webhook payload (Arc-optimized, no internal metadata) */
+        EventMetricsPayload: {
+            event_slug?: string | null;
+            timeframe?: string | null;
+            /** Format: double */
+            volume_usd?: number | null;
+            /** Format: double */
+            fees?: number | null;
+            /** Format: int64 */
+            txns?: number | null;
+            /** Format: int64 */
+            unique_traders?: number | null;
+        };
+        /** @description Event PnL webhook payload (Arc-optimized) */
+        EventPnlPayload: {
+            event_slug?: string | 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: 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 Event volume milestone webhook payload */
+        EventVolumeMilestonePayload: {
+            event_slug: string;
+            timeframe: string;
+            /**
+             * Format: double
+             * @description Milestone amount reached (USD)
+             */
+            milestone_usd: number;
+            /**
+             * Format: double
+             * @description Current volume (USD) that triggered the milestone
+             */
+            current_volume_usd: number;
+            /**
+             * Format: double
+             * @description Total fees collected in this timeframe
+             */
+            fees: number;
+            /**
+             * Format: int64
+             * @description Total transactions in this timeframe
+             */
+            txns: number;
+        };
+        /** @description First trade webhook payload with zero-copy Arc<str> for string sharing */
+        FirstTradePayload: {
+            /** @description Event type identifier */
+            event_type: string;
+            /** @description Trader/taker address (zero-copy Arc) */
+            trader: string;
+            /** @description Taker address (same as trader, zero-copy Arc) */
+            taker: string;
+            /** @description Position ID (ERC1155 token ID, zero-copy Arc) */
+            position_id: string;
+            /** @description Market ID (same as position_id for compatibility, zero-copy Arc) */
+            market_id: string;
+            /** @description Condition ID (market condition, zero-copy Arc) */
+            condition_id?: string | null;
+            /** @description Market outcome (e.g., "Yes", "No", zero-copy Arc) */
+            outcome?: string | null;
+            /**
+             * Format: int32
+             * @description Outcome index (0 = Yes, 1 = No)
+             */
+            outcome_index?: number | null;
+            /** @description Market question (zero-copy Arc) */
+            question?: string | null;
+            /** @description Market slug (zero-copy Arc) */
+            slug?: string | null;
+            /** @description Event slug (parent event, zero-copy Arc) */
+            event_slug?: string | null;
+            /** @description Trade ID (zero-copy Arc) */
+            trade_id: string;
+            /** @description Transaction hash (zero-copy Arc) */
+            hash: string;
+            /**
+             * Format: int64
+             * @description Block number
+             */
+            block: number;
+            /**
+             * Format: int64
+             * @description Confirmed timestamp (Unix seconds)
+             */
+            confirmed_at: number;
+            /**
+             * Format: int64
+             * @description Timestamp (same as confirmed_at for compatibility)
+             */
+            timestamp: number;
+            amount_usd: string;
+            shares_amount: string;
+            fee: string;
+            /** @description Trade side (Buy/Sell, zero-copy Arc) */
+            side: string;
+            /**
+             * Format: double
+             * @description Price per share (0.0 - 1.0)
+             */
+            price: number;
+            /**
+             * Format: double
+             * @description Implied probability (0.0 - 1.0)
+             */
+            probability?: number | null;
+            exchange: string;
+            trade_type: string;
+        };
+        /** @description Global PnL webhook payload (Arc-optimized) */
+        GlobalPnlPayload: {
+            trader?: string | null;
+            /** Format: double */
+            realized_pnl_usd?: number | null;
+            /** Format: int64 */
+            events_traded?: number | null;
+            /** Format: int64 */
+            markets_traded?: number | null;
+            /** Format: int64 */
+            positions_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_volume_usd?: number | null;
+            /** Format: double */
+            sell_volume_usd?: number | null;
+            /** Format: double */
+            redemption_volume_usd?: number | null;
+            /** Format: double */
+            merge_volume_usd?: number | null;
+            /** Format: int64 */
+            winning_positions?: number | null;
+            /** Format: int64 */
+            losing_positions?: number | null;
+            /** Format: double */
+            win_rate_pct?: number | null;
+            /** Format: int64 */
+            markets_won?: number | null;
+            /** Format: int64 */
+            markets_lost?: number | null;
+            /** Format: double */
+            market_win_rate_pct?: number | null;
+            /** Format: int64 */
+            open_positions?: number | null;
+            /** Format: double */
+            avg_pnl_per_position?: number | null;
+            /** Format: double */
+            avg_pnl_per_trade?: number | null;
+            /** Format: double */
+            avg_hold_time_seconds?: number | null;
+            /** Format: double */
+            total_fees?: number | null;
+            /** Format: int64 */
+            first_trade_at?: number | null;
+            /** Format: int64 */
+            last_trade_at?: number | null;
+        };
+        /** @description Market PnL webhook payload (Arc-optimized) */
+        MarketPnlPayload: {
+            condition_id?: string | null;
+            event_slug?: string | 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 */
+            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;
+            has_open_position?: boolean | null;
+            /** Format: double */
+            net_yes_shares?: number | null;
+            /** Format: double */
+            net_no_shares?: number | null;
+            /** Format: int64 */
+            winning_outcomes?: number | null;
+            /** Format: int64 */
+            losing_outcomes?: number | null;
+            /** Format: double */
+            total_fees?: number | null;
+            /** Format: int64 */
+            first_trade_at?: number | null;
+            /** Format: int64 */
+            last_trade_at?: number | null;
+        };
+        /**
+         * @description PnL timeframe enum for webhook filtering
+         * @enum {string}
+         */
+        PnlTimeframeFilter: "1d" | "7d" | "30d" | "lifetime";
+        /**
+         * @description Polymarket webhook event types
+         * @enum {string}
+         */
+        PolymarketWebhookEvent: "first_trade" | "global_pnl" | "market_pnl" | "event_pnl" | "position_pnl" | "condition_metrics" | "event_metrics" | "position_metrics" | "volume_milestone" | "event_volume_milestone" | "position_volume_milestone" | "probability_spike" | "volume_spike" | "*";
+        /**
+         * @description Polymarket-specific webhook filters
+         *
+         *     Different webhook handlers use different subsets of these fields:
+         *     - first_trade: wallet_addresses, min_usd_value, min_probability, max_probability, condition_ids, event_slugs, tags
+         *     - global_pnl: traders, min_realized_pnl_usd, max_realized_pnl_usd, min_volume_usd, min_win_rate, min_markets_traded
+         *     - market_pnl: traders, min_realized_pnl_usd, max_realized_pnl_usd, min_buy_usd, condition_ids, event_slugs, has_open_position
+         *     - event_pnl: traders, min_realized_pnl_usd, max_realized_pnl_usd, min_volume_usd, event_slugs, min_markets_traded
+         *     - position_pnl: traders, min_realized_pnl_usd, max_realized_pnl_usd, min_buy_usd, min_net_shares, max_net_shares, position_ids, condition_ids, event_slugs, outcomes
+         *     - condition_metrics: condition_ids, min_volume_usd, max_volume_usd, min_fees, min_txns, timeframes
+         *     - event_metrics: event_slugs, 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
+         *
+         *     Implements Hash + Eq manually (f64 fields use bit representation)
+         */
+        PolymarketWebhookFilter: {
+            /** @description Filter by wallet addresses (for first_trade, normalized to lowercase) */
+            wallet_addresses?: string[];
+            /** @description Filter by trader addresses (for PnL webhooks, normalized to lowercase) */
+            traders?: string[];
+            /** @description Filter by market/condition IDs */
+            condition_ids?: string[];
+            /**
+             * Format: double
+             * @description Filter by minimum USD value (for trades)
+             */
+            min_usd_value?: number | null;
+            /** @description Filter by event slugs */
+            event_slugs?: string[];
+            /** @description Filter by tags */
+            tags?: string[];
+            /**
+             * Format: double
+             * @description Minimum probability threshold (0.0 - 1.0)
+             */
+            min_probability?: number | null;
+            /**
+             * Format: double
+             * @description Maximum probability threshold (0.0 - 1.0)
+             */
+            max_probability?: number | null;
+            /**
+             * Format: double
+             * @description Minimum realized PnL (USD) - for PnL webhooks
+             */
+            min_realized_pnl_usd?: number | null;
+            /**
+             * Format: double
+             * @description Maximum realized PnL (USD) - for PnL webhooks
+             */
+            max_realized_pnl_usd?: number | null;
+            /**
+             * Format: double
+             * @description Minimum volume (USD) - for PnL and metrics webhooks
+             */
+            min_volume_usd?: number | null;
+            /**
+             * Format: double
+             * @description Maximum volume (USD) - for metrics webhooks
+             */
+            max_volume_usd?: number | null;
+            /**
+             * Format: double
+             * @description Minimum buy volume (USD) - for PnL and metrics webhooks
+             */
+            min_buy_usd?: number | null;
+            /**
+             * Format: double
+             * @description Minimum win rate (0.0 - 100.0) - for global PnL webhooks
+             */
+            min_win_rate?: number | null;
+            /**
+             * Format: int64
+             * @description Minimum markets traded - for PnL webhooks
+             */
+            min_markets_traded?: number | null;
+            /**
+             * Format: double
+             * @description Minimum net shares - for position PnL webhooks
+             */
+            min_net_shares?: number | null;
+            /**
+             * Format: double
+             * @description Maximum net shares - for position PnL webhooks
+             */
+            max_net_shares?: number | null;
+            /** @description Filter by position IDs - for position PnL webhooks */
+            position_ids?: string[];
+            /** @description Filter by outcomes (e.g., "Yes", "No") - for position PnL webhooks */
+            outcomes?: string[];
+            /** @description Only markets with open positions - for market PnL webhooks */
+            has_open_position?: boolean | null;
+            /**
+             * Format: double
+             * @description Minimum fees - for metrics webhooks
+             */
+            min_fees?: number | null;
+            /**
+             * Format: int64
+             * @description Minimum transaction count - for metrics webhooks
+             */
+            min_txns?: number | null;
+            /**
+             * Format: double
+             * @description Minimum sell volume (USD) - for position metrics webhooks
+             */
+            min_sell_volume_usd?: number | null;
+            /**
+             * Format: double
+             * @description Minimum price change percentage - for position metrics webhooks
+             */
+            min_price_change_pct?: number | null;
+            /**
+             * Format: double
+             * @description Minimum probability change percentage - for position metrics webhooks
+             */
+            min_probability_change_pct?: number | null;
+            /** @description Timeframes to track - for metrics webhooks (1m, 5m, 30m, 1h, 6h, 24h) */
+            timeframes?: string[];
+            /** @description Milestone amounts to track - for volume milestone webhooks (e.g., 10000, 100000, 1000000) */
+            milestone_amounts?: number[];
+            /**
+             * Format: double
+             * @description User's baseline volume for spike detection (USD) - for volume spike webhooks
+             *     Example: 50000.0 for $50k baseline
+             */
+            baseline_volume_usd?: number | null;
+            /**
+             * Format: double
+             * @description Spike ratio multiplier (must be > 1.0) - for volume spike webhooks
+             *     Example: 2.0 for 2x, 5.0 for 5x, 10.0 for 10x
+             */
+            spike_ratio?: number | null;
+            /**
+             * @description Exclude short-term trading markets by timeframe (e.g., ["5m", "15m", "30m", "1h"])
+             *     Filters out event slugs containing these timeframe patterns (auto-wrapped: "5m" → "-5m-")
+             *     Example: Excludes "btc-updown-5m-1771678800" when "5m" is in the list
+             */
+            exclude_shortterm_market_timeframes?: string[];
+        };
+        /** @description Position metrics webhook payload (Arc-optimized, no internal metadata) */
+        PositionMetricsPayload: {
+            position_id?: string | null;
+            outcome?: string | null;
+            /** Format: int32 */
+            outcome_index?: number | null;
+            timeframe?: string | null;
+            /** Format: double */
+            volume_usd?: number | null;
+            /** Format: double */
+            buy_volume_usd?: number | null;
+            /** Format: double */
+            sell_volume_usd?: number | null;
+            /** Format: double */
+            fees?: number | null;
+            /** Format: int64 */
+            txns?: number | null;
+            /** Format: int64 */
+            buys?: number | null;
+            /** Format: int64 */
+            sells?: number | null;
+            /** Format: int64 */
+            unique_traders?: number | null;
+            /** Format: double */
+            price_open?: number | null;
+            /** Format: double */
+            price_close?: number | null;
+            /** Format: double */
+            price_high?: number | null;
+            /** Format: double */
+            price_low?: number | null;
+            /** Format: double */
+            probability_open?: number | null;
+            /** Format: double */
+            probability_close?: number | null;
+            /** Format: double */
+            probability_high?: number | null;
+            /** Format: double */
+            probability_low?: number | null;
+        };
+        /** @description Position PnL webhook payload (Arc-optimized) */
+        PositionPnlPayload: {
+            condition_id?: string | null;
+            position_id?: string | null;
+            outcome?: string | null;
+            /** Format: int64 */
+            outcome_index?: number | null;
+            event_slug?: string | null;
+            /** Format: int64 */
+            buy_count?: number | null;
+            /** Format: int64 */
+            sell_count?: number | null;
+            /** Format: int64 */
+            redemption_count?: number | null;
+            /** Format: int64 */
+            merge_count?: number | null;
+            /** Format: double */
+            total_shares_bought?: number | null;
+            /** Format: double */
+            total_shares_sold?: number | null;
+            /** Format: double */
+            total_shares_redeemed?: number | null;
+            /** Format: double */
+            total_shares_merged?: number | null;
+            /** Format: double */
+            net_shares?: 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: double */
+            cost_basis?: number | null;
+            /** Format: double */
+            total_fees?: number | null;
+            /** Format: int64 */
+            first_trade_at?: number | null;
+            /** Format: int64 */
+            last_trade_at?: number | null;
+        };
+        /** @description Position volume milestone webhook payload */
+        PositionVolumeMilestonePayload: {
+            condition_id?: string | null;
+            position_id: string;
+            outcome?: string | null;
+            /** Format: int32 */
+            outcome_index?: number | null;
+            timeframe: string;
+            /**
+             * Format: double
+             * @description Milestone amount reached (USD)
+             */
+            milestone_usd: number;
+            /**
+             * Format: double
+             * @description Current volume (USD) that triggered the milestone
+             */
+            current_volume_usd: number;
+            /**
+             * Format: double
+             * @description Buy volume (USD)
+             */
+            buy_volume_usd: number;
+            /**
+             * Format: double
+             * @description Sell volume (USD)
+             */
+            sell_volume_usd: number;
+            /**
+             * Format: double
+             * @description Total fees collected in this timeframe
+             */
+            fees: number;
+            /**
+             * Format: int64
+             * @description Total transactions in this timeframe
+             */
+            txns: number;
+            /**
+             * Format: int64
+             * @description Buy transactions
+             */
+            buys: number;
+            /**
+             * Format: int64
+             * @description Sell transactions
+             */
+            sells: number;
+        };
+        /** @description Position probability spike webhook payload */
+        ProbabilitySpikePayload: {
+            position_id: string;
+            outcome?: string | null;
+            /** Format: int32 */
+            outcome_index?: number | null;
+            timeframe: string;
+            /**
+             * Format: double
+             * @description Probability at the start of the timeframe (0.0 - 1.0)
+             */
+            probability_open: number;
+            /**
+             * Format: double
+             * @description Probability at the end of the timeframe (0.0 - 1.0)
+             */
+            probability_close: number;
+            /**
+             * Format: double
+             * @description Absolute probability change (e.g., 0.25 for 25 percentage points)
+             */
+            probability_change: number;
+            /**
+             * Format: double
+             * @description Percentage change relative to open (e.g., 83.33 for 30% -> 55%)
+             */
+            probability_change_pct: number;
+            /**
+             * Format: double
+             * @description Price at open (0.0 - 1.0)
+             */
+            price_open: number;
+            /**
+             * Format: double
+             * @description Price at close (0.0 - 1.0)
+             */
+            price_close: number;
+            /**
+             * Format: double
+             * @description Volume during the timeframe (USD)
+             */
+            volume_usd: number;
+            /**
+             * Format: int64
+             * @description Number of transactions
+             */
+            txns: number;
+        };
+        /** @description Request body for updating a webhook */
+        UpdateWebhookRequestBody: {
+            /** @description Destination URL for webhook deliveries (must be HTTPS) */
+            url?: string | null;
+            /** @description Events to subscribe to */
+            events?: components["schemas"]["PolymarketWebhookEvent"][] | null;
+            /** @description New secret for HMAC signature verification */
+            secret?: string | null;
+            filters?: null | components["schemas"]["WebhookFiltersBody"];
+            status?: null | components["schemas"]["WebhookStatusBody"];
+            /** @description Description/name */
+            description?: string | null;
+        };
+        /** @description Volume milestone webhook payload */
+        VolumeMilestonePayload: {
+            condition_id: string;
+            timeframe: string;
+            /**
+             * Format: double
+             * @description Milestone amount reached (USD)
+             */
+            milestone_usd: number;
+            /**
+             * Format: double
+             * @description Current volume (USD) that triggered the milestone
+             */
+            current_volume_usd: number;
+            /**
+             * Format: double
+             * @description Total fees collected in this timeframe
+             */
+            fees: number;
+            /**
+             * Format: int64
+             * @description Total transactions in this timeframe
+             */
+            txns: number;
+        };
+        /** @description Webhook filters request body */
+        WebhookFiltersBody: {
+            /** @description Filter by wallet addresses */
+            wallet_addresses?: string[];
+            /** @description Filter by market/condition IDs */
+            condition_ids?: string[];
+            /**
+             * Format: double
+             * @description Filter by minimum USD value
+             */
+            min_usd_value?: number | null;
+            /** @description Filter by event slugs */
+            event_slugs?: string[];
+            /**
+             * Format: double
+             * @description Minimum probability threshold (0.0 - 1.0)
+             */
+            min_probability?: number | null;
+            /**
+             * Format: double
+             * @description Maximum probability threshold (0.0 - 1.0)
+             */
+            max_probability?: number | null;
+            /** @description Exclude short-term trading markets by timeframe (e.g., ["5m", "15m"]) */
+            exclude_shortterm_market_timeframes?: string[];
+        };
+        /** @description List webhooks response */
+        WebhookListResponseBody: {
+            /** @description List of webhooks */
+            webhooks: components["schemas"]["WebhookResponse"][];
+            /** @description Total count */
+            total: number;
+        };
+        /** @description Webhook response (returned from API) */
+        WebhookResponse: {
+            /** @description Unique webhook ID */
+            id: string;
+            /** @description Destination URL */
+            url: string;
+            /** @description Subscribed events */
+            events: components["schemas"]["PolymarketWebhookEvent"][];
+            /** @description Filters */
+            filters: components["schemas"]["WebhookFiltersBody"];
+            /** @description Current status */
+            status: string;
+            /**
+             * Format: int32
+             * @description Consecutive failure count
+             */
+            failure_count: number;
+            /**
+             * Format: int64
+             * @description Last successful delivery timestamp
+             */
+            last_success_at?: number | null;
+            /**
+             * Format: int64
+             * @description Last failed delivery timestamp
+             */
+            last_failure_at?: number | null;
+            /** @description Last failure reason */
+            last_failure_reason?: string | null;
+            /**
+             * Format: int64
+             * @description Created timestamp
+             */
+            created_at: number;
+            /**
+             * Format: int64
+             * @description Updated timestamp
+             */
+            updated_at: number;
+            /** @description Description */
+            description?: string | null;
+            /** @description Whether a secret is configured */
+            has_secret: boolean;
+        };
+        /**
+         * @description Webhook status
+         * @enum {string}
+         */
+        WebhookStatusBody: "active" | "paused";
+        /** @description Test webhook response */
+        WebhookTestResponseBody: {
+            /** @description Whether the test delivery succeeded */
+            success: boolean;
+            /**
+             * Format: int32
+             * @description HTTP status code from the endpoint
+             */
+            status_code?: number | null;
+            /** @description Error message if failed */
+            error?: string | null;
+            /**
+             * Format: int64
+             * @description Delivery duration in milliseconds
+             */
+            duration_ms: number;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    list_webhooks: {
+        parameters: {
+            query?: {
+                /** @description Results per page (default: 20, max: 100) */
+                limit?: number;
+                /** @description Pagination offset (default: 0) */
+                offset?: number;
+                /** @description Filter by status: active, paused */
+                status?: components["schemas"]["WebhookStatusBody"];
+                /** @description Filter by event type */
+                event?: components["schemas"]["PolymarketWebhookEvent"];
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of webhooks */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookListResponseBody"];
+                };
+            };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    create_webhook: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateWebhookRequestBody"];
+            };
+        };
+        responses: {
+            /** @description Webhook created successfully */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookResponse"];
+                };
+            };
+            /** @description Invalid request (malformed URL, invalid filters, etc.) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Insufficient credits */
+            402: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Rate limit exceeded (max 100 webhooks per user) */
+            429: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_webhook: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Webhook UUID */
+                webhook_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Webhook details */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookResponse"];
+                };
+            };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Webhook not found or not owned by user */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    update_webhook: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Webhook UUID */
+                webhook_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateWebhookRequestBody"];
+            };
+        };
+        responses: {
+            /** @description Webhook updated successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookResponse"];
+                };
+            };
+            /** @description Invalid request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Webhook not found or not owned by user */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    delete_webhook: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Webhook UUID */
+                webhook_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Webhook deleted successfully */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Webhook not found or not owned by user */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    test_webhook: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Webhook UUID */
+                webhook_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Test delivery completed */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookTestResponseBody"];
+                };
+            };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Webhook not found or not owned by user */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    "first-trade": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["FirstTradePayload"];
+            };
+        };
+        responses: {
+            /** @description Webhook delivery acknowledged */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error (will retry) */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    "global-pnl": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["GlobalPnlPayload"];
+            };
+        };
+        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-pnl": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["MarketPnlPayload"];
+            };
+        };
+        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-pnl": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["EventPnlPayload"];
+            };
+        };
+        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-pnl": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PositionPnlPayload"];
+            };
+        };
+        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-metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ConditionMetricsPayload"];
+            };
+        };
+        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-metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["EventMetricsPayload"];
+            };
+        };
+        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-metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PositionMetricsPayload"];
+            };
+        };
+        responses: {
+            /** @description Webhook delivery acknowledged */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error (will retry) */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    "market-volume-milestone": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["VolumeMilestonePayload"];
+            };
+        };
+        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-volume-milestone": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["EventVolumeMilestonePayload"];
+            };
+        };
+        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-volume-milestone": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PositionVolumeMilestonePayload"];
+            };
+        };
+        responses: {
+            /** @description Webhook delivery acknowledged */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error (will retry) */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    "probability-spike": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ProbabilitySpikePayload"];
+            };
+        };
+        responses: {
+            /** @description Webhook delivery acknowledged */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Server error (will retry) */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+}