@structbuild/sdk 0.3.10-staging.1 → 0.3.10-staging.10

package/dist/generated/polymarket.d.ts

@@ -3,7 +3,7 @@
  * Do not make direct changes to the file.
  */
 export interface paths {
-    "/polymarket/analytics/candles": {
+    "/polymarket/analytics/changes": {
         parameters: {
             query?: never;
             header?: never;
@@ -11,10 +11,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Global analytics candles (per-bucket deltas)
-         * @description Returns per-bucket deltas (volume, traders, fees etc. that happened *during* each bucket). Use for bar-chart visualisations of activity over time.
+         * Global analytics % change
+         * @description Returns % change for each metric over the requested lookback window. `null` fields mean the window predates the available data.
          */
-        get: operations["get_global_analytics_candles"];
+        get: operations["get_global_analytics_changes"];
         put?: never;
         post?: never;
         delete?: never;
@@ -23,7 +23,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/analytics/changes": {
+    "/polymarket/analytics/counts": {
         parameters: {
             query?: never;
             header?: never;
@@ -31,10 +31,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Global analytics % change
-         * @description Returns % change for each metric over the requested lookback window. `null` fields mean the window predates the available data.
+         * Global analytics snapshot
+         * @description Returns the latest cumulative analytics metrics across all of Polymarket: volume, traders, txn counts, fees, yes/no splits, and buy distribution.
          */
-        get: operations["get_global_analytics_changes"];
+        get: operations["get_analytics_counts"];
         put?: never;
         post?: never;
         delete?: never;
@@ -43,7 +43,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/analytics/counts": {
+    "/polymarket/analytics/deltas": {
         parameters: {
             query?: never;
             header?: never;
@@ -51,10 +51,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Global analytics snapshot
-         * @description Returns the latest cumulative analytics metrics across all of Polymarket: volume, traders, txn counts, fees, yes/no splits, and buy distribution.
+         * Global analytics candles (per-bucket deltas)
+         * @description Returns per-bucket deltas (volume, traders, fees etc. that happened *during* each bucket). Use for bar-chart visualisations of activity over time.
          */
-        get: operations["get_analytics_counts"];
+        get: operations["get_global_analytics_deltas"];
         put?: never;
         post?: never;
         delete?: never;
@@ -203,7 +203,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/events/{event_slug}/analytics/candles": {
+    "/polymarket/events/top-traders": {
         parameters: {
             query?: never;
             header?: never;
@@ -211,10 +211,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Event analytics candles (per-bucket deltas)
-         * @description Returns per-bucket deltas for a specific event (what happened during each bucket).
+         * Get top traders for an event
+         * @description Top traders ranked by realized PnL for a given event.
          */
-        get: operations["get_event_analytics_candles"];
+        get: operations["get_event_top_traders"];
         put?: never;
         post?: never;
         delete?: never;
@@ -243,6 +243,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/polymarket/events/{event_slug}/analytics/deltas": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Event analytics candles (per-bucket deltas)
+         * @description Returns per-bucket deltas for a specific event (what happened during each bucket).
+         */
+        get: operations["get_event_analytics_deltas"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/polymarket/events/{event_slug}/analytics/timeseries": {
         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;
@@ -623,7 +703,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/market/{condition_id}/analytics/candles": {
+    "/polymarket/market/{condition_id}/analytics/changes": {
         parameters: {
             query?: never;
             header?: never;
@@ -631,10 +711,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Market analytics candles (per-bucket deltas)
-         * @description Returns per-bucket deltas for a specific market (what happened during each bucket).
+         * Market analytics % change
+         * @description Per-metric % change over the requested lookback window for a specific market.
          */
-        get: operations["get_market_analytics_candles"];
+        get: operations["get_market_analytics_changes"];
         put?: never;
         post?: never;
         delete?: never;
@@ -643,7 +723,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/market/{condition_id}/analytics/changes": {
+    "/polymarket/market/{condition_id}/analytics/deltas": {
         parameters: {
             query?: never;
             header?: never;
@@ -651,10 +731,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Market analytics % change
-         * @description Per-metric % change over the requested lookback window for a specific market.
+         * Market analytics candles (per-bucket deltas)
+         * @description Returns per-bucket deltas for a specific market (what happened during each bucket).
          */
-        get: operations["get_market_analytics_changes"];
+        get: operations["get_market_analytics_deltas"];
         put?: never;
         post?: never;
         delete?: never;
@@ -852,7 +932,7 @@ export interface paths {
         };
         /**
          * Get tags
-         * @description Retrieve all available event tags/categories. Supports both cursor-based and offset-based pagination.
+         * @description Retrieve all available event tags/categories. Default listing is alphabetical (cursor-paginated). If either `sort` or `timeframe` is provided, the listing is ranked by the chosen metric+window (offset-paginated): sort defaults to `volume` when only `timeframe` is set, timeframe defaults to `24h` when only `sort` is set.
          */
         get: operations["get_tags"];
         put?: never;
@@ -872,7 +952,7 @@ export interface paths {
         };
         /**
          * Get tag by slug
-         * @description Retrieve a single tag by its ID or slug
+         * @description Retrieve a single tag by its ID or slug. Pass `include_metrics=true` to attach analytics metrics (volume_usd, txn_count, unique_traders, fees_usd) — adds +1 credit. Use `timeframe` to select the window; defaults to `1d`.
          */
         get: operations["get_tag_by_id"];
         put?: never;
@@ -883,7 +963,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/tags/{tag}/analytics/candles": {
+    "/polymarket/tags/{tag}/analytics/changes": {
         parameters: {
             query?: never;
             header?: never;
@@ -891,10 +971,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Tag analytics candles (per-bucket deltas)
-         * @description Returns per-bucket deltas for a specific tag (what happened during each bucket).
+         * Tag analytics % change
+         * @description Per-metric % change over the requested lookback window for a specific tag.
          */
-        get: operations["get_tag_analytics_candles"];
+        get: operations["get_tag_analytics_changes"];
         put?: never;
         post?: never;
         delete?: never;
@@ -903,7 +983,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/tags/{tag}/analytics/changes": {
+    "/polymarket/tags/{tag}/analytics/deltas": {
         parameters: {
             query?: never;
             header?: never;
@@ -911,10 +991,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Tag analytics % change
-         * @description Per-metric % change over the requested lookback window for a specific tag.
+         * Tag analytics candles (per-bucket deltas)
+         * @description Returns per-bucket deltas for a specific tag (what happened during each bucket).
          */
-        get: operations["get_tag_analytics_changes"];
+        get: operations["get_tag_analytics_deltas"];
         put?: never;
         post?: never;
         delete?: 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;
@@ -1183,7 +1263,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/trader/{address}/analytics/candles": {
+    "/polymarket/trader/{address}/analytics/changes": {
         parameters: {
             query?: never;
             header?: never;
@@ -1191,10 +1271,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Trader analytics candles (per-bucket deltas)
-         * @description Returns per-bucket deltas for a specific trader address (what happened during each bucket).
+         * Trader analytics % change
+         * @description Per-metric % change over the requested lookback window for a specific trader address.
          */
-        get: operations["get_trader_analytics_candles"];
+        get: operations["get_trader_analytics_changes"];
         put?: never;
         post?: never;
         delete?: never;
@@ -1203,7 +1283,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/trader/{address}/analytics/changes": {
+    "/polymarket/trader/{address}/analytics/deltas": {
         parameters: {
             query?: never;
             header?: never;
@@ -1211,10 +1291,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Trader analytics % change
-         * @description Per-metric % change over the requested lookback window for a specific trader address.
+         * Trader analytics candles (per-bucket deltas)
+         * @description Returns per-bucket deltas for a specific trader address (what happened during each bucket).
          */
-        get: operations["get_trader_analytics_changes"];
+        get: operations["get_trader_analytics_deltas"];
         put?: never;
         post?: never;
         delete?: never;
@@ -1247,6 +1327,14 @@ export interface paths {
 export type webhooks = Record<string, never>;
 export interface components {
     schemas: {
+        /**
+         * @description Resolution for `/analytics/timeseries` and `/analytics/deltas`.
+         *     Superset of `CandlestickResolution` — adds 7-day (`W`/`1W`) and calendar
+         *     month (`M`/`1M`) buckets, which are pre-aggregated for global and tag
+         *     domains and re-bucketed from the `_1d` MV for market/event/trader.
+         * @enum {string}
+         */
+        AnalyticsResolution: "60" | "240" | "D" | "1D" | "W" | "1W" | "M" | "1M";
         /** @description Output payload for ERC1155 setApprovalForAll events. */
         ApprovalTrade: {
             id: string;
@@ -1446,7 +1534,7 @@ export interface components {
          * @description Lookback window for `/analytics/changes` endpoints.
          * @enum {string}
          */
-        ChangeTimeframe: "1h" | "24h" | "7d" | "30d" | "1y";
+        ChangeTimeframe: "1h" | "24h" | "7d" | "30d" | "1mo" | "1y";
         /** @enum {string} */
         ChartResolution: "1H" | "6H" | "1D" | "1W" | "1M" | "ALL";
         /** @description CLOB reward (public API format) */
@@ -1534,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  */
@@ -1633,8 +1751,7 @@ export interface components {
         EventSortBy: "volume" | "txns" | "unique_traders" | "title" | "creation_date" | "start_date" | "end_date" | "relevance";
         /**
          * @description Response body for `GET /polymarket/analytics/counts`.
-         *     Cumulative analytics metrics (from ClickHouse `analytics_global`) plus
-         *     entity-count enrichment (from Postgres `pg_class.reltuples` estimates).
+         *     Cumulative analytics metrics plus entity-count enrichment.
          */
         GlobalCountsResponse: {
             /**
@@ -1653,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 */
@@ -1667,9 +1797,13 @@ export interface components {
             redemption_volume_usd: number;
             /** Format: int64 */
             merge_count: number;
+            /** Format: double */
+            merge_volume_usd: number;
             /** Format: int64 */
             split_count: number;
             /** Format: double */
+            split_volume_usd: number;
+            /** Format: double */
             fees_usd: number;
             /** Format: double */
             shares_volume: number;
@@ -1681,24 +1815,36 @@ export interface components {
             yes_count: number;
             /** Format: int64 */
             no_count: number;
+            /** Format: int64 */
+            buy_dist_under_10: number;
+            /** Format: int64 */
+            buy_dist_10_100: number;
+            /** Format: int64 */
+            buy_dist_100_1k: number;
+            /** Format: int64 */
+            buy_dist_1k_10k: number;
+            /** Format: int64 */
+            buy_dist_10k_50k: number;
+            /** Format: int64 */
+            buy_dist_50k_plus: number;
             /**
              * Format: int64
-             * @description Estimated row count of `polymarket_tags` (Postgres pg_class.reltuples).
+             * @description Estimated total number of tags.
              */
             tags: number;
             /**
              * Format: int64
-             * @description Estimated row count of `polymarket_events`.
+             * @description Estimated total number of events.
              */
             events: number;
             /**
              * Format: int64
-             * @description Estimated row count of `prediction_markets`.
+             * @description Estimated total number of markets.
              */
             markets: number;
             /**
              * Format: int64
-             * @description Estimated row count of `polymarket_accounts` (traders / positions).
+             * @description Estimated total number of unique positions / traders.
              */
             positions: number;
         };
@@ -1805,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 */
@@ -2038,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;
@@ -2074,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;
@@ -2121,6 +2330,11 @@ export interface components {
              *     trades and may be `0x0000…` for V2 trades placed without a builder code.
              */
             builder_code?: string | null;
+            /**
+             * Format: double
+             * @description Builder fee in USDC. Absent when no builder code is attached.
+             */
+            builder_fee?: number | null;
         };
         OrderbookHistoryRow: {
             /** Format: int64 */
@@ -2440,6 +2654,39 @@ export interface components {
             label: string;
             /** @default null */
             slug: string | null;
+            /**
+             * Format: double
+             * @default null
+             */
+            volume_usd: number;
+            /**
+             * Format: int64
+             * @default null
+             */
+            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
+             */
+            fees_usd: number;
         };
         /** @description Polymarket user profile (public API format) */
         PolymarketUserProfile: {
@@ -2478,7 +2725,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;
@@ -2630,8 +2877,8 @@ export interface components {
         };
         /** @enum {string} */
         PriceJumpResolution: "1" | "5" | "15" | "30" | "60" | "240";
-        /** @description UMA CTF Adapter: admin emergency resolution. */
-        QuestionEmergencyResolvedEvent: {
+        /** @description V2 UMA OOv2: a price was proposed (resolution proposal). */
+        ProposePriceEvent: {
             id: string;
             hash: string;
             /** Format: int64 */
@@ -2645,15 +2892,24 @@ export interface components {
             /** Format: int64 */
             block_index?: number | null;
             oracle_contract: string;
-            condition_id: 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: market flagged for emergency resolution. */
-        QuestionFlaggedEvent: {
+        /** @description UMA CTF Adapter: admin emergency resolution. */
+        QuestionEmergencyResolvedEvent: {
             id: string;
             hash: string;
             /** Format: int64 */
@@ -2668,13 +2924,14 @@ export interface components {
             block_index?: number | null;
             oracle_contract: string;
             condition_id: string;
+            proposed_outcome?: string | null;
             question?: string | null;
             image_url?: string | null;
             slug?: string | null;
             event_slug?: string | null;
         };
-        /** @description UMA CTF Adapter: questionID first initialized on-chain. */
-        QuestionInitializedEvent: {
+        /** @description UMA CTF Adapter: market flagged for emergency resolution. */
+        QuestionFlaggedEvent: {
             id: string;
             hash: string;
             /** Format: int64 */
@@ -2689,9 +2946,30 @@ export interface components {
             block_index?: number | null;
             oracle_contract: string;
             condition_id: string;
-            creator: string;
-            reward_token: string;
-            reward: string;
+            question?: string | null;
+            image_url?: string | null;
+            slug?: string | null;
+            event_slug?: string | null;
+        };
+        /** @description UMA CTF Adapter: questionID first initialized on-chain. */
+        QuestionInitializedEvent: {
+            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;
+            condition_id: string;
+            creator: string;
+            reward_token: string;
+            reward: string;
             proposal_bond: string;
             question?: string | null;
             image_url?: string | null;
@@ -2860,6 +3138,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"];
@@ -2873,6 +3186,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
@@ -2952,11 +3297,32 @@ export interface components {
             ask_levels?: number | null;
         };
         /**
-         * @description Timeseries bucket row.
+         * @description Metric to order by when `sort=<value>` is provided.
+         *
+         *     `unique_*` ranks by window-distinct addresses — exact `uniqExact` count
+         *     of addresses active in the timeframe.
+         * @enum {string}
+         */
+        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).
+         * @enum {string}
+         */
+        TagSortTimeframe: "lifetime" | "1h" | "24h" | "7d" | "30d" | "1mo" | "1y";
+        /**
+         * @description Bucket row returned by both `/analytics/timeseries` (cumulative values
+         *     at end of bucket) and `/analytics/deltas` (per-bucket deltas). All metrics
+         *     the snapshot `/counts` returns are included.
+         *
          *     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, f=fees_usd, sh=shares_volume,
-         *       yv=yes_volume_usd, nv=no_volume_usd
+         *       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 */
@@ -2968,9 +3334,23 @@ export interface components {
             /** Format: double */
             sv: number;
             /** Format: int64 */
-            ut: 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 */
@@ -2979,6 +3359,40 @@ export interface components {
             yv: number;
             /** Format: double */
             nv: number;
+            /** Format: int64 */
+            yc: number;
+            /** Format: int64 */
+            nc: number;
+            /**
+             * Format: int64
+             * @description Buy distribution — count of buy trades falling in each USD bucket.
+             */
+            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;
+            /**
+             * 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: {
@@ -3167,6 +3581,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;
@@ -3287,6 +3728,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;
@@ -3329,19 +3829,11 @@ export interface components {
 }
 export type $defs = Record<string, never>;
 export interface operations {
-    get_global_analytics_candles: {
+    get_global_analytics_changes: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
-                resolution?: components["schemas"]["CandlestickResolution"];
-                /** @description Start timestamp (Unix seconds). Omit for all-time. */
-                from?: number;
-                /** @description End timestamp (Unix seconds) */
-                to?: number;
-                /** @description Max data points (default: 500, max: 2500) */
-                count_back?: number;
-                /** @description Cursor from previous response for next page */
-                pagination_key?: string;
+                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y (default: 24h) */
+                timeframe?: components["schemas"]["ChangeTimeframe"];
             };
             header?: never;
             path?: never;
@@ -3349,56 +3841,64 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Delta time-bucketed analytics */
+            /** @description Per-metric pct change */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TimeBucketRow"][];
+                    "application/json": components["schemas"]["MetricPctChange"];
                 };
             };
         };
     };
-    get_global_analytics_changes: {
+    get_analytics_counts: {
         parameters: {
-            query: {
-                /** @description Lookback window: 1h, 24h, 7d, 30d, 1y */
-                timeframe: components["schemas"]["ChangeTimeframe"];
-            };
+            query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Per-metric pct change */
+            /** @description Latest global metrics snapshot */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["MetricPctChange"];
+                    "application/json": components["schemas"]["GlobalCountsResponse"];
                 };
             };
         };
     };
-    get_analytics_counts: {
+    get_global_analytics_deltas: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @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;
+                /** @description End timestamp (Unix seconds) */
+                to?: number;
+                /** @description Max data points (default: 500, max: 2500) */
+                count_back?: number;
+                /** @description Cursor from previous response for next page */
+                pagination_key?: string;
+            };
             header?: never;
             path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Latest global metrics snapshot */
+            /** @description Delta time-bucketed analytics */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GlobalCountsResponse"];
+                    "application/json": components["schemas"]["TimeBucketRow"][];
                 };
             };
         };
@@ -3406,8 +3906,8 @@ export interface operations {
     get_global_analytics_timeseries: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
-                resolution?: components["schemas"]["CandlestickResolution"];
+                /** @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;
                 /** @description End timestamp (Unix seconds) */
@@ -3700,21 +4200,40 @@ export interface operations {
             };
         };
     };
-    get_event_analytics_candles: {
+    get_event_top_traders: {
         parameters: {
-            query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
-                resolution?: components["schemas"]["CandlestickResolution"];
-                /** @description Start timestamp (Unix seconds) */
-                from?: number;
-                /** @description End timestamp (Unix seconds) */
-                to?: number;
-                /** @description Max data points (default: 500, max: 2500) */
-                count_back?: number;
-                /** @description Cursor from previous response */
+            query: {
+                /** @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: {
                 /** @description Event slug */
                 event_slug: string;
@@ -3723,22 +4242,30 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Delta time-bucketed event analytics */
+            /** @description Per-metric pct change */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TimeBucketRow"][];
+                    "application/json": components["schemas"]["MetricPctChange"];
                 };
             };
         };
     };
-    get_event_analytics_changes: {
+    get_event_analytics_deltas: {
         parameters: {
-            query: {
-                /** @description Lookback window: 1h, 24h, 7d, 30d, 1y */
-                timeframe: components["schemas"]["ChangeTimeframe"];
+            query?: {
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                resolution?: components["schemas"]["AnalyticsResolution"];
+                /** @description Start timestamp (Unix seconds) */
+                from?: number;
+                /** @description End timestamp (Unix seconds) */
+                to?: number;
+                /** @description Max data points (default: 500, max: 2500) */
+                count_back?: number;
+                /** @description Cursor from previous response */
+                pagination_key?: string;
             };
             header?: never;
             path: {
@@ -3749,13 +4276,13 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Per-metric pct change */
+            /** @description Delta time-bucketed event analytics */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["MetricPctChange"];
+                    "application/json": components["schemas"]["TimeBucketRow"][];
                 };
             };
         };
@@ -3763,8 +4290,8 @@ export interface operations {
     get_event_analytics_timeseries: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
-                resolution?: components["schemas"]["CandlestickResolution"];
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
                 /** @description End timestamp (Unix seconds) */
@@ -3840,8 +4367,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) */
@@ -3857,7 +4386,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;
@@ -4226,6 +4755,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: {
@@ -4291,6 +4857,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: {
@@ -4461,6 +5054,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?: {
@@ -4472,6 +5094,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) */
@@ -4496,8 +5120,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. */
@@ -4665,19 +5287,11 @@ export interface operations {
             };
         };
     };
-    get_market_analytics_candles: {
+    get_market_analytics_changes: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
-                resolution?: components["schemas"]["CandlestickResolution"];
-                /** @description Start timestamp (Unix seconds) */
-                from?: number;
-                /** @description End timestamp (Unix seconds) */
-                to?: number;
-                /** @description Max data points (default: 500, max: 2500) */
-                count_back?: number;
-                /** @description Cursor from previous response */
-                pagination_key?: string;
+                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y (default: 24h) */
+                timeframe?: components["schemas"]["ChangeTimeframe"];
             };
             header?: never;
             path: {
@@ -4688,22 +5302,30 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Delta time-bucketed market analytics */
+            /** @description Per-metric pct change */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TimeBucketRow"][];
+                    "application/json": components["schemas"]["MetricPctChange"];
                 };
             };
         };
     };
-    get_market_analytics_changes: {
+    get_market_analytics_deltas: {
         parameters: {
-            query: {
-                /** @description Lookback window: 1h, 24h, 7d, 30d, 1y */
-                timeframe: components["schemas"]["ChangeTimeframe"];
+            query?: {
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                resolution?: components["schemas"]["AnalyticsResolution"];
+                /** @description Start timestamp (Unix seconds) */
+                from?: number;
+                /** @description End timestamp (Unix seconds) */
+                to?: number;
+                /** @description Max data points (default: 500, max: 2500) */
+                count_back?: number;
+                /** @description Cursor from previous response */
+                pagination_key?: string;
             };
             header?: never;
             path: {
@@ -4714,13 +5336,13 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Per-metric pct change */
+            /** @description Delta time-bucketed market analytics */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["MetricPctChange"];
+                    "application/json": components["schemas"]["TimeBucketRow"][];
                 };
             };
         };
@@ -4728,8 +5350,8 @@ export interface operations {
     get_market_analytics_timeseries: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
-                resolution?: components["schemas"]["CandlestickResolution"];
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
                 /** @description End timestamp (Unix seconds) */
@@ -5184,8 +5806,14 @@ export interface operations {
                 limit?: number;
                 /** @description Offset-based pagination (number of results to skip). Takes precedence over pagination_key. */
                 offset?: number;
-                /** @description Cursor-based pagination key */
+                /** @description Cursor-based pagination key (alphabetical mode only). */
                 pagination_key?: string;
+                /** @description Sort metric. Defaults to `volume` when only `timeframe` is set. Setting either `sort` or `timeframe` adds +2 credits. */
+                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;
@@ -5206,7 +5834,12 @@ export interface operations {
     };
     get_tag_by_id: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Attach analytics metrics. +1 credit. */
+                include_metrics?: boolean;
+                /** @description Metrics window. Default `1d` (= `24h`). Ignored unless `include_metrics=true`. */
+                timeframe?: components["schemas"]["TagSortTimeframe"];
+            };
             header?: never;
             path: {
                 /** @description Tag ID or slug */
@@ -5234,19 +5867,11 @@ export interface operations {
             };
         };
     };
-    get_tag_analytics_candles: {
+    get_tag_analytics_changes: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
-                resolution?: components["schemas"]["CandlestickResolution"];
-                /** @description Start timestamp (Unix seconds) */
-                from?: number;
-                /** @description End timestamp (Unix seconds) */
-                to?: number;
-                /** @description Max data points (default: 500, max: 2500) */
-                count_back?: number;
-                /** @description Cursor from previous response */
-                pagination_key?: string;
+                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y (default: 24h) */
+                timeframe?: components["schemas"]["ChangeTimeframe"];
             };
             header?: never;
             path: {
@@ -5257,22 +5882,30 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Delta time-bucketed tag analytics */
+            /** @description Per-metric pct change */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TimeBucketRow"][];
+                    "application/json": components["schemas"]["MetricPctChange"];
                 };
             };
         };
     };
-    get_tag_analytics_changes: {
+    get_tag_analytics_deltas: {
         parameters: {
-            query: {
-                /** @description Lookback window: 1h, 24h, 7d, 30d, 1y */
-                timeframe: components["schemas"]["ChangeTimeframe"];
+            query?: {
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                resolution?: components["schemas"]["AnalyticsResolution"];
+                /** @description Start timestamp (Unix seconds) */
+                from?: number;
+                /** @description End timestamp (Unix seconds) */
+                to?: number;
+                /** @description Max data points (default: 500, max: 2500) */
+                count_back?: number;
+                /** @description Cursor from previous response */
+                pagination_key?: string;
             };
             header?: never;
             path: {
@@ -5283,13 +5916,13 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Per-metric pct change */
+            /** @description Delta time-bucketed tag analytics */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["MetricPctChange"];
+                    "application/json": components["schemas"]["TimeBucketRow"][];
                 };
             };
         };
@@ -5297,8 +5930,8 @@ export interface operations {
     get_tag_analytics_timeseries: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
-                resolution?: components["schemas"]["CandlestickResolution"];
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
                 /** @description End timestamp (Unix seconds) */
@@ -5674,6 +6307,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) */
@@ -5698,8 +6333,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. */
@@ -5763,19 +6396,11 @@ export interface operations {
             };
         };
     };
-    get_trader_analytics_candles: {
+    get_trader_analytics_changes: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
-                resolution?: components["schemas"]["CandlestickResolution"];
-                /** @description Start timestamp (Unix seconds) */
-                from?: number;
-                /** @description End timestamp (Unix seconds) */
-                to?: number;
-                /** @description Max data points (default: 500, max: 2500) */
-                count_back?: number;
-                /** @description Cursor from previous response */
-                pagination_key?: string;
+                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y (default: 24h) */
+                timeframe?: components["schemas"]["ChangeTimeframe"];
             };
             header?: never;
             path: {
@@ -5786,22 +6411,30 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Delta time-bucketed trader analytics */
+            /** @description Per-metric pct change */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TimeBucketRow"][];
+                    "application/json": components["schemas"]["TraderMetricPctChange"];
                 };
             };
         };
     };
-    get_trader_analytics_changes: {
+    get_trader_analytics_deltas: {
         parameters: {
-            query: {
-                /** @description Lookback window: 1h, 24h, 7d, 30d, 1y */
-                timeframe: components["schemas"]["ChangeTimeframe"];
+            query?: {
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                resolution?: components["schemas"]["AnalyticsResolution"];
+                /** @description Start timestamp (Unix seconds) */
+                from?: number;
+                /** @description End timestamp (Unix seconds) */
+                to?: number;
+                /** @description Max data points (default: 500, max: 2500) */
+                count_back?: number;
+                /** @description Cursor from previous response */
+                pagination_key?: string;
             };
             header?: never;
             path: {
@@ -5812,13 +6445,13 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Per-metric pct change */
+            /** @description Delta time-bucketed trader analytics */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["MetricPctChange"];
+                    "application/json": components["schemas"]["TraderTimeBucketRow"][];
                 };
             };
         };
@@ -5826,8 +6459,8 @@ export interface operations {
     get_trader_analytics_timeseries: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
-                resolution?: components["schemas"]["CandlestickResolution"];
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
                 /** @description End timestamp (Unix seconds) */
@@ -5852,7 +6485,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TimeBucketRow"][];
+                    "application/json": components["schemas"]["TraderTimeBucketRow"][];
                 };
             };
         };