@structbuild/sdk 0.3.10-staging.6 → 0.3.10-staging.8

package/dist/generated/polymarket.d.ts

@@ -203,6 +203,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/polymarket/events/top-traders": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get top traders for an event
+         * @description Top traders ranked by realized PnL for a given event.
+         */
+        get: operations["get_event_top_traders"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/polymarket/events/{event_slug}/analytics/changes": {
         parameters: {
             query?: never;
@@ -292,7 +312,7 @@ export interface paths {
         };
         /**
          * Get market holders
-         * @description Retrieve holders of a market grouped by outcome, sorted by shares held. Identify the market with either `condition_id` or `market_slug` — exactly one must be provided. Set `include_pnl=true` to include a nested holder `pnl` object.
+         * @description Retrieve holders of a market grouped by outcome, sorted by shares held. Identify the market with either `condition_id` or `market_slug` — exactly one must be provided. Set `include_pnl=true` to include a nested holder `pnl` object. Uses cursor-based pagination.
          */
         get: operations["get_market_holders"];
         put?: never;
@@ -463,6 +483,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/polymarket/market/oracle-events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List oracle events
+         * @description Retrieve on-chain oracle lifecycle events (resolutions, disputes, assertions, emergency resolutions). Filter by `condition_ids` or `event_types` and paginate with `limit`/`pagination_key`.
+         */
+        get: operations["get_oracle_events"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/polymarket/market/position/candlestick": {
         parameters: {
             query?: never;
@@ -503,6 +543,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/polymarket/market/position/top-traders": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get top traders for a position id / outcome
+         * @description Top traders ranked by realized PnL on a specific position (ERC1155 outcome token).
+         */
+        get: operations["get_position_top_traders"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/polymarket/market/position/volume-chart": {
         parameters: {
             query?: never;
@@ -563,6 +623,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/polymarket/market/top-traders": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get top traders for a market
+         * @description Top traders ranked by realized PnL for a given market (condition_id or market_slug).
+         */
+        get: operations["get_market_top_traders"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/polymarket/market/trades": {
         parameters: {
             query?: never;
@@ -1092,7 +1172,7 @@ export interface paths {
         };
         /**
          * Get trader position PnL
-         * @description Retrieve per-outcome-token lifetime PnL for a trader from polymarket_accounts. Includes open/closed state, win/loss outcome, redemption payouts, and share quantities. Filter by status and won/lost to segment portfolio views.
+         * @description Retrieve per-outcome-token lifetime PnL for a trader. Includes open/closed state, win/loss outcome, redemption payouts, and share quantities. Filter by status and won/lost to segment portfolio views.
          */
         get: operations["get_trader_position_pnl"];
         put?: never;
@@ -1254,7 +1334,7 @@ export interface components {
          *     domains and re-bucketed from the `_1d` MV for market/event/trader.
          * @enum {string}
          */
-        AnalyticsResolution: "1" | "5" | "15" | "30" | "60" | "240" | "D" | "1D" | "W" | "1W" | "M" | "1M";
+        AnalyticsResolution: "60" | "240" | "D" | "1D" | "W" | "1W" | "M" | "1M";
         /** @description Output payload for ERC1155 setApprovalForAll events. */
         ApprovalTrade: {
             id: string;
@@ -1542,6 +1622,36 @@ export interface components {
             slug?: string | null;
             event_slug?: string | null;
         };
+        /** @description V2 UMA OOv2: a proposed price was disputed. */
+        DisputePriceEvent: {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block?: number | null;
+            /** Format: int64 */
+            confirmed_at?: number | null;
+            /** Format: int64 */
+            received_at?: number | null;
+            /** Format: int64 */
+            log_index?: number | null;
+            /** Format: int64 */
+            block_index?: number | null;
+            oracle_contract: string;
+            requester: string;
+            proposer: string;
+            disputer: string;
+            identifier: string;
+            timestamp: string;
+            ancillary_data: string;
+            /** Format: int64 */
+            proposed_price: number;
+            condition_id?: string | null;
+            proposed_outcome?: string | null;
+            question?: string | null;
+            image_url?: string | null;
+            slug?: string | null;
+            event_slug?: string | null;
+        };
         /** @description Enriched market data for event API responses */
         EventMarket: {
             /** @default  */
@@ -1660,8 +1770,21 @@ export interface components {
             buy_volume_usd: number;
             /** Format: double */
             sell_volume_usd: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Distinct addresses that have ever traded on Polymarket (lifetime).
+             */
             unique_traders: number;
+            /**
+             * Format: int64
+             * @description Distinct makers ever active (lifetime distinct).
+             */
+            unique_makers: number;
+            /**
+             * Format: int64
+             * @description Distinct takers ever active (lifetime distinct).
+             */
+            unique_takers: number;
             /** Format: int64 */
             txn_count: number;
             /** Format: int64 */
@@ -1828,11 +1951,10 @@ export interface components {
          */
         LeaderboardCategory: "overall" | "politics" | "sports" | "crypto" | "finance" | "culture" | "mentions" | "weather" | "economics" | "tech";
         /**
-         * @description Flat response row. `trader` is the canonical `TraderInfo` used across all
-         *     our other endpoints; all enrichment fields sit at the top level. Fields
-         *     other than `trader`, `rank`, `pnl`, and `timeframe` are sourced from our
-         *     `prediction_trader_pnl_*_v2` tables and are `null` when we don't yet have
-         *     a row for that address in the selected timeframe.
+         * @description Flat response row. `trader` is the canonical `TraderInfo` used across
+         *     endpoints; enrichment fields sit at the top level. Fields other than
+         *     `trader`, `rank`, `pnl`, and `timeframe` may be `null` when PnL data for
+         *     the trader in the selected timeframe isn't yet available.
          */
         LeaderboardEntry: {
             /** Format: int64 */
@@ -2061,8 +2183,16 @@ export interface components {
             /** Format: double */
             sell_volume_usd?: number | null;
             /** Format: double */
+            merge_volume_usd?: number | null;
+            /** Format: double */
+            split_volume_usd?: number | null;
+            /** Format: double */
             unique_traders?: number | null;
             /** Format: double */
+            unique_makers?: number | null;
+            /** Format: double */
+            unique_takers?: number | null;
+            /** Format: double */
             txn_count?: number | null;
             /** Format: double */
             fees_usd?: number | null;
@@ -2097,6 +2227,62 @@ export interface components {
             slug?: string | null;
             event_slug?: string | null;
         };
+        /**
+         * @description Tagged enum for all oracle event types — serializes with `"event_type": "..."` discriminator
+         *     and only includes fields relevant to each type.
+         */
+        OracleEventTyped: (components["schemas"]["AssertionMadeEvent"] & {
+            /** @enum {string} */
+            event_type: "AssertionMade";
+        }) | (components["schemas"]["AssertionDisputedEvent"] & {
+            /** @enum {string} */
+            event_type: "AssertionDisputed";
+        }) | (components["schemas"]["AssertionSettledEvent"] & {
+            /** @enum {string} */
+            event_type: "AssertionSettled";
+        }) | (components["schemas"]["RequestPriceEvent"] & {
+            /** @enum {string} */
+            event_type: "RequestPrice";
+        }) | (components["schemas"]["ProposePriceEvent"] & {
+            /** @enum {string} */
+            event_type: "ProposePrice";
+        }) | (components["schemas"]["DisputePriceEvent"] & {
+            /** @enum {string} */
+            event_type: "DisputePrice";
+        }) | (components["schemas"]["SettleEvent"] & {
+            /** @enum {string} */
+            event_type: "Settle";
+        }) | (components["schemas"]["QuestionResolvedEvent"] & {
+            /** @enum {string} */
+            event_type: "QuestionResolved";
+        }) | (components["schemas"]["QuestionEmergencyResolvedEvent"] & {
+            /** @enum {string} */
+            event_type: "QuestionEmergencyResolved";
+        }) | (components["schemas"]["QuestionResetEvent"] & {
+            /** @enum {string} */
+            event_type: "QuestionReset";
+        }) | (components["schemas"]["QuestionInitializedEvent"] & {
+            /** @enum {string} */
+            event_type: "QuestionInitialized";
+        }) | (components["schemas"]["QuestionPausedEvent"] & {
+            /** @enum {string} */
+            event_type: "QuestionPaused";
+        }) | (components["schemas"]["QuestionUnpausedEvent"] & {
+            /** @enum {string} */
+            event_type: "QuestionUnpaused";
+        }) | (components["schemas"]["QuestionFlaggedEvent"] & {
+            /** @enum {string} */
+            event_type: "QuestionFlagged";
+        }) | (components["schemas"]["QuestionUnflaggedEvent"] & {
+            /** @enum {string} */
+            event_type: "QuestionUnflagged";
+        }) | (components["schemas"]["ConditionResolutionEvent"] & {
+            /** @enum {string} */
+            event_type: "ConditionResolution";
+        }) | (components["schemas"]["NegRiskOutcomeReportedEvent"] & {
+            /** @enum {string} */
+            event_type: "NegRiskOutcomeReported";
+        });
         /** @description Output payload for OrderFilled and OrdersMatched trades (actual buy/sell). */
         OrderFilledTrade: {
             id: string;
@@ -2475,9 +2661,22 @@ export interface components {
             txn_count: number;
             /**
              * Format: int64
+             * @description Distinct active traders in the window.
              * @default null
              */
             unique_traders: number;
+            /**
+             * Format: int64
+             * @description Distinct active makers in the window.
+             * @default null
+             */
+            unique_makers: number;
+            /**
+             * Format: int64
+             * @description Distinct active takers in the window.
+             * @default null
+             */
+            unique_takers: number;
             /**
              * Format: double
              * @default null
@@ -2521,7 +2720,7 @@ export interface components {
              * @description Outcome index (0 = Yes, 1 = No for binary)
              */
             outcome_index: number;
-            /** @description Outcome name (e.g. "Yes", "No") — enriched from market metadata */
+            /** @description Outcome name (e.g. "Yes", "No"). Optional — may be omitted when the market metadata isn't yet available. */
             outcome?: string | null;
             /** @description Amount of shares created/burned/redeemed for this position */
             amount: string;
@@ -2673,6 +2872,37 @@ export interface components {
         };
         /** @enum {string} */
         PriceJumpResolution: "1" | "5" | "15" | "30" | "60" | "240";
+        /** @description V2 UMA OOv2: a price was proposed (resolution proposal). */
+        ProposePriceEvent: {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block?: number | null;
+            /** Format: int64 */
+            confirmed_at?: number | null;
+            /** Format: int64 */
+            received_at?: number | null;
+            /** Format: int64 */
+            log_index?: number | null;
+            /** Format: int64 */
+            block_index?: number | null;
+            oracle_contract: string;
+            requester: string;
+            proposer: string;
+            identifier: string;
+            timestamp: string;
+            ancillary_data: string;
+            /** Format: int64 */
+            proposed_price: number;
+            expiration_timestamp: string;
+            currency: string;
+            condition_id?: string | null;
+            proposed_outcome?: string | null;
+            question?: string | null;
+            image_url?: string | null;
+            slug?: string | null;
+            event_slug?: string | null;
+        };
         /** @description UMA CTF Adapter: admin emergency resolution. */
         QuestionEmergencyResolvedEvent: {
             id: string;
@@ -2903,6 +3133,41 @@ export interface components {
             event_slug?: string | null;
             exchange: components["schemas"]["PolymarketExchange"];
         };
+        /** @description V2 UMA OOv2: a price request was made (market initialization). */
+        RequestPriceEvent: {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block?: number | null;
+            /** Format: int64 */
+            confirmed_at?: number | null;
+            /** Format: int64 */
+            received_at?: number | null;
+            /** Format: int64 */
+            log_index?: number | null;
+            /** Format: int64 */
+            block_index?: number | null;
+            oracle_contract: string;
+            requester: string;
+            identifier: string;
+            /**
+             * @description UMA request timestamp (seconds, decimal string).
+             *     The point in time the requester is asking the oracle to resolve the
+             *     price for — part of the request identity tuple
+             *     `(requester, identifier, timestamp, ancillaryData)`. Not the block
+             *     timestamp of this event; see `confirmed_at` for that.
+             */
+            timestamp: string;
+            ancillary_data: string;
+            currency: string;
+            reward: string;
+            final_fee: string;
+            condition_id?: string | null;
+            question?: string | null;
+            image_url?: string | null;
+            slug?: string | null;
+            event_slug?: string | null;
+        };
         SearchResponse: {
             events?: components["schemas"]["PolymarketEvent"][] | null;
             events_pagination?: null | components["schemas"]["PaginationMeta"];
@@ -2916,6 +3181,38 @@ export interface components {
          * @enum {string}
          */
         SearchSortBy: "volume" | "txns" | "unique_traders" | "relevance" | "title" | "creation_date" | "start_date" | "end_date" | "liquidity" | "holders" | "end_time" | "start_time" | "created_time";
+        /** @description V2 UMA OOv2: a price request was settled (final resolution). */
+        SettleEvent: {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block?: number | null;
+            /** Format: int64 */
+            confirmed_at?: number | null;
+            /** Format: int64 */
+            received_at?: number | null;
+            /** Format: int64 */
+            log_index?: number | null;
+            /** Format: int64 */
+            block_index?: number | null;
+            oracle_contract: string;
+            requester: string;
+            proposer: string;
+            disputer: string;
+            identifier: string;
+            timestamp: string;
+            ancillary_data: string;
+            /** Format: int64 */
+            proposed_price: number;
+            payout: string;
+            disputed: boolean;
+            condition_id?: string | null;
+            proposed_outcome?: string | null;
+            question?: string | null;
+            image_url?: string | null;
+            slug?: string | null;
+            event_slug?: string | null;
+        };
         SimpleTimeframeMetrics: {
             /**
              * Format: double
@@ -2996,12 +3293,12 @@ export interface components {
         };
         /**
          * @description Metric to order by when `sort=<value>` is provided.
-         *     `traders` windowed sums per-block deltas — approximate for the "unique
-         *     traders in window" reading (double-counts traders active in multiple
-         *     blocks) but fine for ranking. `lifetime` uses the exact cumulative.
+         *
+         *     `unique_*` ranks by window-distinct addresses — exact `uniqExact` count
+         *     of addresses active in the timeframe.
          * @enum {string}
          */
-        TagSortBy: "volume" | "txns" | "traders" | "fees";
+        TagSortBy: "volume" | "txns" | "unique_traders" | "unique_makers" | "unique_takers" | "fees";
         /**
          * @description Timeframe for `?sort=...` — defines the window the metric is summed over
          *     (or `lifetime` for all-time cumulative).
@@ -3015,10 +3312,12 @@ export interface components {
          *
          *     Short field names for compact JSON responses:
          *       t=bucket (unix seconds), v=volume_usd, bv=buy_volume_usd, sv=sell_volume_usd,
-         *       ut=unique_traders, tc=txn_count, bc=buy_count, sc=sell_count,
-         *       rc=redemption_count, rv=redemption_volume_usd, mc=merge_count,
-         *       sp=split_count, f=fees_usd, sh=shares_volume,
-         *       yv=yes_volume_usd, nv=no_volume_usd, yc=yes_count, nc=no_count
+         *       ut=unique_traders, um=unique_makers, uk=unique_takers,
+         *       tc=txn_count, bc=buy_count, sc=sell_count,
+         *       rc=redemption_count, rv=redemption_volume_usd, mc=merge_count, mv=merge_volume_usd,
+         *       sp=split_count, spv=split_volume_usd, f=fees_usd, sh=shares_volume,
+         *       yv=yes_volume_usd, nv=no_volume_usd, yc=yes_count, nc=no_count,
+         *       bd_*=buy distribution by USD bucket
          */
         TimeBucketRow: {
             /** Format: int32 */
@@ -3030,8 +3329,6 @@ export interface components {
             /** Format: double */
             sv: number;
             /** Format: int64 */
-            ut: number;
-            /** Format: int64 */
             tc: number;
             /** Format: int64 */
             bc: number;
@@ -3076,6 +3373,21 @@ export interface components {
             bd_50k: number;
             /** Format: int64 */
             bd_50p: number;
+            /**
+             * Format: int64
+             * @description Distinct traders ACTIVE in this bucket (window-unique, not first-time).
+             */
+            ut: number;
+            /**
+             * Format: int64
+             * @description Distinct makers active in this bucket.
+             */
+            um: number;
+            /**
+             * Format: int64
+             * @description Distinct takers active in this bucket.
+             */
+            uk: number;
         };
         /** @description Token outcome (position) */
         TokenOutcome: {
@@ -3264,6 +3576,33 @@ export interface components {
             /** Format: double */
             realized_pnl_pct?: number | null;
         };
+        /**
+         * @description Per-metric percentage change over a lookback window for one trader
+         *     address. A `null` field means the window predates the trader's first
+         *     activity or the prior value was zero (percentage undefined).
+         */
+        TraderMetricPctChange: {
+            /** Format: double */
+            volume_usd?: number | null;
+            /** Format: double */
+            buy_volume_usd?: number | null;
+            /** Format: double */
+            sell_volume_usd?: number | null;
+            /** Format: double */
+            merge_volume_usd?: number | null;
+            /** Format: double */
+            split_volume_usd?: number | null;
+            /** Format: double */
+            txn_count?: number | null;
+            /** Format: double */
+            fees_usd?: number | null;
+            /** Format: double */
+            shares_volume?: number | null;
+            /** Format: double */
+            yes_volume_usd?: number | null;
+            /** Format: double */
+            no_volume_usd?: number | null;
+        };
         /** @description Outcome-level PnL entry (per outcome token / position_id) */
         TraderOutcomePnlEntry: {
             position_id?: string | null;
@@ -3384,6 +3723,65 @@ export interface components {
             /** Format: int64 */
             last_trade_at?: number | null;
         };
+        /**
+         * @description Bucket row returned by the per-trader `/analytics/timeseries` and
+         *     `/analytics/deltas` endpoints. Mirrors `TimeBucketRow` minus the
+         *     distinct-address counters (`new_*` / `unique_*`) — those only carry
+         *     information for aggregations over many addresses (market, event, tag,
+         *     global), not for a single trader.
+         */
+        TraderTimeBucketRow: {
+            /** Format: int32 */
+            t: number;
+            /** Format: double */
+            v: number;
+            /** Format: double */
+            bv: number;
+            /** Format: double */
+            sv: number;
+            /** Format: int64 */
+            tc: number;
+            /** Format: int64 */
+            bc: number;
+            /** Format: int64 */
+            sc: number;
+            /** Format: int64 */
+            rc: number;
+            /** Format: double */
+            rv: number;
+            /** Format: int64 */
+            mc: number;
+            /** Format: double */
+            mv: number;
+            /** Format: int64 */
+            sp: number;
+            /** Format: double */
+            spv: number;
+            /** Format: double */
+            f: number;
+            /** Format: double */
+            sh: number;
+            /** Format: double */
+            yv: number;
+            /** Format: double */
+            nv: number;
+            /** Format: int64 */
+            yc: number;
+            /** Format: int64 */
+            nc: number;
+            /** Format: int64 */
+            bd_u10: number;
+            /** Format: int64 */
+            bd_100: number;
+            /** Format: int64 */
+            bd_1k: number;
+            /** Format: int64 */
+            bd_10k: number;
+            /** Format: int64 */
+            bd_50k: number;
+            /** Format: int64 */
+            bd_50p: number;
+        };
         TraderVolumeChartResponse: {
             volumes: components["schemas"]["TraderVolumeDataPoint"][];
             has_more: boolean;
@@ -3428,9 +3826,9 @@ export type $defs = Record<string, never>;
 export interface operations {
     get_global_analytics_changes: {
         parameters: {
-            query: {
-                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y */
-                timeframe: components["schemas"]["ChangeTimeframe"];
+            query?: {
+                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y (default: 24h) */
+                timeframe?: components["schemas"]["ChangeTimeframe"];
             };
             header?: never;
             path?: never;
@@ -3472,7 +3870,7 @@ export interface operations {
     get_global_analytics_deltas: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds). Omit for all-time. */
                 from?: number;
@@ -3503,7 +3901,7 @@ export interface operations {
     get_global_analytics_timeseries: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds). Omit for all-time. */
                 from?: number;
@@ -3797,11 +4195,38 @@ export interface operations {
             };
         };
     };
-    get_event_analytics_changes: {
+    get_event_top_traders: {
         parameters: {
             query: {
-                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y */
-                timeframe: components["schemas"]["ChangeTimeframe"];
+                /** @description Event slug */
+                event_slug: string;
+                /** @description Timeframe: 1d, 7d, 30d, lifetime (default: lifetime) */
+                timeframe?: components["schemas"]["PnlTimeframe"];
+                /** @description Results limit (default: 10, max: 200) */
+                limit?: number;
+                /** @description Pagination key from the previous response */
+                pagination_key?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Top traders sorted by realized PnL desc. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_event_analytics_changes: {
+        parameters: {
+            query?: {
+                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y (default: 24h) */
+                timeframe?: components["schemas"]["ChangeTimeframe"];
             };
             header?: never;
             path: {
@@ -3826,7 +4251,7 @@ export interface operations {
     get_event_analytics_deltas: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
@@ -3860,7 +4285,7 @@ export interface operations {
     get_event_analytics_timeseries: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
@@ -3937,8 +4362,10 @@ export interface operations {
                 condition_id?: string;
                 /** @description Market slug (e.g. `will-trump-win`) */
                 market_slug?: string;
-                /** @description Results limit (default: 10, max: 100) */
+                /** @description Results limit per outcome (default: 10, max: 100) */
                 limit?: number;
+                /** @description Cursor-based pagination key */
+                pagination_key?: string;
                 /** @description Minimum shares held (decimal string) */
                 min_shares?: string;
                 /** @description Maximum shares held (decimal string) */
@@ -3954,7 +4381,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Market holders grouped by outcome (sorted by shares DESC). Holder `pnl` is included only when `include_pnl=true`. */
+            /** @description Market holders grouped by outcome (sorted by shares DESC). Holder `pnl` is included only when `include_pnl=true`. Response includes `pagination: { has_more, pagination_key }` for cursor-based pagination. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -4323,6 +4750,43 @@ export interface operations {
             };
         };
     };
+    get_oracle_events: {
+        parameters: {
+            query?: {
+                /** @description Comma-separated condition IDs (max 20) */
+                condition_ids?: string;
+                /** @description Comma-separated event names: Initialization, Proposal, Dispute, Settled, Resolution, ConditionResolution, Reset, Flag, Unflag, Pause, Unpause, ManualResolution, NegRiskOutcomeReported. Empty = all oracle event types. */
+                event_types?: string;
+                /** @description Start timestamp (Unix seconds) */
+                from?: number;
+                /** @description End timestamp (Unix seconds) */
+                to?: number;
+                /** @description Results per page (default 10, max 250) */
+                limit?: number;
+                /** @description Pagination offset. Takes precedence over pagination_key. */
+                offset?: number;
+                /** @description Cursor-based pagination key */
+                pagination_key?: string;
+                /** @description Sort direction (default true = newest first) */
+                sort_desc?: boolean;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Oracle events matching the filter */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TradeEvent"][];
+                };
+            };
+        };
+    };
     get_position_candlestick: {
         parameters: {
             query: {
@@ -4388,6 +4852,33 @@ export interface operations {
             };
         };
     };
+    get_position_top_traders: {
+        parameters: {
+            query: {
+                /** @description Position ID (ERC1155 token ID) */
+                position_id: string;
+                /** @description Filter by position status (omit for all) */
+                status?: "open" | "closed";
+                /** @description Results limit (default: 10, max: 200) */
+                limit?: number;
+                /** @description Pagination key from the previous response */
+                pagination_key?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Top traders sorted by realized PnL desc. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     get_position_volume_chart: {
         parameters: {
             query: {
@@ -4558,6 +5049,35 @@ export interface operations {
             };
         };
     };
+    get_market_top_traders: {
+        parameters: {
+            query?: {
+                /** @description Market condition ID */
+                condition_id?: string;
+                /** @description Market slug (alternative to condition_id) */
+                market_slug?: string;
+                /** @description Timeframe: 1d, 7d, 30d, lifetime (default: lifetime) */
+                timeframe?: components["schemas"]["PnlTimeframe"];
+                /** @description Results limit (default: 10, max: 200) */
+                limit?: number;
+                /** @description Pagination key from the previous response */
+                pagination_key?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Top traders sorted by realized PnL desc. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     get_market_trades: {
         parameters: {
             query?: {
@@ -4569,6 +5089,8 @@ export interface operations {
                 position_ids?: string;
                 /** @description Comma-separated trader addresses (max 25) */
                 traders?: string;
+                /** @description Comma-separated builder codes (max 25) */
+                builder_codes?: string;
                 /** @description Trade side: 0 (Buy), 1 (Sell) */
                 side?: components["schemas"]["TradeSide"];
                 /** @description Outcome name filter (e.g. Yes, No) */
@@ -4764,9 +5286,9 @@ export interface operations {
     };
     get_market_analytics_changes: {
         parameters: {
-            query: {
-                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y */
-                timeframe: components["schemas"]["ChangeTimeframe"];
+            query?: {
+                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y (default: 24h) */
+                timeframe?: components["schemas"]["ChangeTimeframe"];
             };
             header?: never;
             path: {
@@ -4791,7 +5313,7 @@ export interface operations {
     get_market_analytics_deltas: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
@@ -4825,7 +5347,7 @@ export interface operations {
     get_market_analytics_timeseries: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
@@ -5287,6 +5809,8 @@ export interface operations {
                 sort?: components["schemas"]["TagSortBy"];
                 /** @description Window for the sort metric. Defaults to `24h` when only `sort` is set. Setting either `sort` or `timeframe` adds +2 credits. */
                 timeframe?: components["schemas"]["TagSortTimeframe"];
+                /** @description Sort direction (default: true = highest first). Only applies to sort/timeframe mode. */
+                sort_desc?: boolean;
             };
             header?: never;
             path?: never;
@@ -5342,9 +5866,9 @@ export interface operations {
     };
     get_tag_analytics_changes: {
         parameters: {
-            query: {
-                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y */
-                timeframe: components["schemas"]["ChangeTimeframe"];
+            query?: {
+                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y (default: 24h) */
+                timeframe?: components["schemas"]["ChangeTimeframe"];
             };
             header?: never;
             path: {
@@ -5369,7 +5893,7 @@ export interface operations {
     get_tag_analytics_deltas: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
@@ -5403,7 +5927,7 @@ export interface operations {
     get_tag_analytics_timeseries: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
@@ -5780,6 +6304,8 @@ export interface operations {
                 slugs?: string;
                 /** @description Comma-separated position IDs */
                 position_ids?: string;
+                /** @description Comma-separated builder codes (max 25) */
+                builder_codes?: string;
                 /** @description Trade side: 0 (Buy), 1 (Sell) */
                 side?: components["schemas"]["TradeSide"];
                 /** @description Outcome name filter (e.g. Yes, No) */
@@ -5804,8 +6330,6 @@ export interface operations {
                 from?: number;
                 /** @description End timestamp (ms) */
                 to?: number;
-                /** @description Return all-time trades, not just last 30 days (default: false) */
-                all?: boolean;
                 /** @description Results per page (default: 10, max: 250) */
                 limit?: number;
                 /** @description Pagination offset (number of results to skip). Takes precedence over pagination_key. */
@@ -5871,9 +6395,9 @@ export interface operations {
     };
     get_trader_analytics_changes: {
         parameters: {
-            query: {
-                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y */
-                timeframe: components["schemas"]["ChangeTimeframe"];
+            query?: {
+                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y (default: 24h) */
+                timeframe?: components["schemas"]["ChangeTimeframe"];
             };
             header?: never;
             path: {
@@ -5890,7 +6414,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["MetricPctChange"];
+                    "application/json": components["schemas"]["TraderMetricPctChange"];
                 };
             };
         };
@@ -5898,7 +6422,7 @@ export interface operations {
     get_trader_analytics_deltas: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
@@ -5924,7 +6448,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TimeBucketRow"][];
+                    "application/json": components["schemas"]["TraderTimeBucketRow"][];
                 };
             };
         };
@@ -5932,7 +6456,7 @@ export interface operations {
     get_trader_analytics_timeseries: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
@@ -5958,7 +6482,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TimeBucketRow"][];
+                    "application/json": components["schemas"]["TraderTimeBucketRow"][];
                 };
             };
         };