@structbuild/sdk 0.1.9 → 0.1.11

package/dist/generated/polymarket.d.ts

@@ -23,7 +23,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/events/metrics": {
+    "/polymarket/events/chart": {
         parameters: {
             query?: never;
             header?: never;
@@ -31,10 +31,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get event metrics
-         * @description Retrieve volume, transaction, and trader metrics for an event. Supports single timeframe (e.g., '1m'), multiple timeframes (e.g., '1m,5m,1h'), or 'all' to get all available timeframes.
+         * Get event chart
+         * @description Retrieve price data over time for up to 4 markets with highest YES outcome (outcome_index 0) prices in an event. Perfect for rendering multi-line charts showing price movement across top markets.
          */
-        get: operations["get_event_metrics"];
+        get: operations["get_event_chart"];
         put?: never;
         post?: never;
         delete?: never;
@@ -43,27 +43,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/holders/events/{event_slug}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get event holders
-         * @description Retrieve holders aggregated across all markets in an event, sorted by total shares. Uses cursor-based pagination for efficient traversal.
-         */
-        get: operations["get_event_holders"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/polymarket/holders/events/{event_slug}/history": {
+    "/polymarket/events/metrics": {
         parameters: {
             query?: never;
             header?: never;
@@ -71,10 +51,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get event holders history
-         * @description Retrieve historical holder count snapshots for an event over a time range
+         * Get event metrics
+         * @description Retrieve volume, transaction, and trader metrics for an event. Supports single timeframe (e.g., '1m'), multiple timeframes (e.g., '1m,5m,1h'), or 'all' to get all available timeframes.
          */
-        get: operations["get_event_holders_history"];
+        get: operations["get_event_metrics"];
         put?: never;
         post?: never;
         delete?: never;
@@ -83,7 +63,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/holders/markets/{condition_id}": {
+    "/polymarket/holders/markets": {
         parameters: {
             query?: never;
             header?: never;
@@ -92,7 +72,7 @@ export interface paths {
         };
         /**
          * Get market holders
-         * @description Retrieve holders of a market grouped by outcome, sorted by shares held
+         * @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. Each holder includes a nested `pnl` object with position-level PnL sourced from the position PnL table.
          */
         get: operations["get_market_holders"];
         put?: never;
@@ -103,7 +83,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/holders/markets/{condition_id}/history": {
+    "/polymarket/holders/markets/history": {
         parameters: {
             query?: never;
             header?: never;
@@ -112,7 +92,7 @@ export interface paths {
         };
         /**
          * Get market holders history
-         * @description Retrieve historical holder count snapshots for a market over a time range
+         * @description Retrieve historical holder count snapshots for a market over a time range. Identify the market with either `condition_id` or `market_slug` — exactly one must be provided.
          */
         get: operations["get_market_holders_history"];
         put?: never;
@@ -132,7 +112,7 @@ export interface paths {
         };
         /**
          * Get position holders
-         * @description Retrieve holders of a specific position (ERC1155 token), sorted by shares held. Uses cursor-based pagination for efficient traversal.
+         * @description Retrieve holders of a specific position (ERC1155 token), sorted by shares held. Each holder includes a nested `pnl` object with position-level PnL (realized_pnl_usd, buy_usd, sell_usd, avg_entry_price, avg_exit_price, total_buys, total_sells, total_fees, first/last_trade_at) sourced from the position PnL table — no extra joins required at query time. Uses cursor-based pagination for efficient traversal.
          */
         get: operations["get_position_holders"];
         put?: never;
@@ -223,6 +203,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/polymarket/market/chart": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get market chart
+         * @description Retrieve price data over time for up to 4 position outcomes in a market condition. Auto-selects the 4 most active outcomes if position_ids not specified.
+         */
+        get: operations["get_chart"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/polymarket/market/metrics": {
         parameters: {
             query?: never;
@@ -563,27 +563,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/trader/portfolio/{address}": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get trader portfolio
-         * @description Retrieve a trader's portfolio overview including balances and active positions
-         */
-        get: operations["get_portfolio"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    "/polymarket/trader/positions/{address}": {
+    "/polymarket/trader/pnl/{address}/positions": {
         parameters: {
             query?: never;
             header?: never;
@@ -591,10 +571,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get trader positions
-         * @description Retrieve a trader's active positions with PnL data, sorted by the specified field
+         * Get trader position PnL
+         * @description Retrieve per-outcome-token PnL for a trader. Only includes OrderFilled trades (no redemptions/merges). Each entry represents a specific position (outcome token) the trader has bought or sold.
          */
-        get: operations["get_portfolio_positions"];
+        get: operations["get_trader_position_pnl"];
         put?: never;
         post?: never;
         delete?: never;
@@ -632,7 +612,7 @@ export interface paths {
         };
         /**
          * Get multiple trader profiles
-         * @description Retrieve profiles for multiple traders in a single request. Returns a map of address -> profile.
+         * @description Retrieve profiles for multiple traders in a single request. Returns an array of profiles.
          */
         get: operations["get_trader_profiles_batch"];
         put?: never;
@@ -691,11 +671,11 @@ export interface components {
             condition_id: string;
             title?: string | null;
             question: string;
-            slug: string;
+            market_slug: string;
             event_slug?: string | null;
             image_url?: string | null;
             /** Format: int64 */
-            end_date: number;
+            end_time: number;
             /** Format: int32 */
             best_outcome_index: number;
             /** Format: double */
@@ -703,16 +683,16 @@ export interface components {
             /** Format: double */
             apy: number;
             /** Format: double */
-            usd_volume_24h?: number | null;
+            volume_24h?: number | null;
             outcomes: components["schemas"]["BondOutcome"][];
         };
         BondOutcome: {
             name: string;
             /** Format: int32 */
             index: number;
+            position_id: string;
             /** Format: double */
             price: number;
-            position_id: string;
         };
         /** @enum {string} */
         CandlestickResolution: "1" | "5" | "15" | "30" | "60" | "240" | "D" | "1D";
@@ -741,64 +721,6 @@ export interface components {
             /** Format: int32 */
             unique_traders: number;
         };
-        /** @description Holder data for event-level queries (aggregated across markets) */
-        EventHolder: {
-            /** @description Trader profile information */
-            trader: components["schemas"]["Trader"];
-            /** @description Total shares across all positions in this event */
-            total_shares: string;
-            /** @description USD value of all shares (sum of shares * price per position) */
-            shares_usd?: string | null;
-            /**
-             * Format: int32
-             * @description Number of distinct positions held
-             */
-            position_count: number;
-            /** @description USD balance (USDe on Polygon) */
-            usd_balance?: string | null;
-            /**
-             * Format: double
-             * @description Lifetime realized PnL in USD
-             */
-            realized_pnl_usd?: number | null;
-        };
-        /** @description Event-level PnL data for a holder */
-        EventHolderPnl: {
-            /** Format: double */
-            realized_pnl_usd?: number | null;
-            /** Format: double */
-            total_volume_usd?: number | null;
-            /** Format: double */
-            buy_usd?: number | null;
-            /** Format: double */
-            sell_usd?: number | null;
-            /** Format: double */
-            total_fees?: number | null;
-            /** Format: int64 */
-            markets_traded?: number | null;
-            /** Format: int64 */
-            winning_markets?: number | null;
-            /** Format: int64 */
-            losing_markets?: number | null;
-            /** Format: int64 */
-            first_trade_at?: number | null;
-            /** Format: int64 */
-            last_trade_at?: number | null;
-        };
-        /** @description Response for event holders endpoint */
-        EventHoldersResponse: {
-            /** @description Event slug */
-            event_slug: string;
-            /** @description Event title */
-            title?: string | null;
-            /**
-             * Format: int64
-             * @description Total unique holders across all markets (from holder_stats)
-             */
-            total_holders: number;
-            /** @description Top holders across all markets */
-            holders: components["schemas"]["EventHolder"][];
-        };
         /** @description Enriched market data for event API responses */
         EventMarket: {
             /** @default  */
@@ -810,14 +732,19 @@ export interface components {
             /** @default  */
             question: string;
             /** @default  */
-            slug: string;
+            market_slug: string;
             /** @default  */
             status: string;
             /**
              * Format: int64
              * @default null
              */
-            end_date: number | null;
+            created_time: number | null;
+            /**
+             * Format: int64
+             * @default null
+             */
+            end_time: number | null;
             /**
              * Format: double
              * @default null
@@ -845,13 +772,29 @@ export interface components {
             clob_rewards: components["schemas"]["ClobReward"][];
             /** @default [] */
             outcomes: components["schemas"]["EventMarketOutcome"][];
+            /** @default null */
+            winning_outcome: null | components["schemas"]["EventMarketOutcome"];
+        };
+        EventMarketChartDataPoint: {
+            /** Format: double */
+            value: number;
+            /** Format: int64 */
+            timestamp: number;
+        };
+        EventMarketChartOutcome: {
+            condition_id: string;
+            market_slug: string;
+            name: string;
+            data: components["schemas"]["EventMarketChartDataPoint"][];
         };
-        /** @description Market outcome with probability for event API responses */
+        /** @description Market outcome for event API responses */
         EventMarketOutcome: {
             name: string;
             /** Format: double */
-            probability?: number | null;
+            price?: number | null;
             position_id?: string | null;
+            /** Format: int32 */
+            outcome_index?: number | null;
         };
         /** @description Response type for event metrics query */
         EventMetricsResponse: {
@@ -936,11 +879,7 @@ export interface components {
             shares_usd?: string | null;
             /** @description USD balance of wallet (USDe on Polygon) */
             usd_balance?: string | null;
-            /**
-             * Format: double
-             * @description Lifetime realized PnL in USD
-             */
-            realized_pnl_usd?: number | null;
+            pnl?: null | components["schemas"]["PositionHolderPnl"];
         };
         /** @description Holder statistics data point (single time bucket) */
         HolderHistoryCandle: {
@@ -1051,10 +990,74 @@ export interface components {
         };
         /** @enum {string} */
         MarketPnlSortBy: "realized_pnl_usd" | "buy_usd" | "total_buys" | "total_fees" | "outcomes_traded";
+        /** @description Formatted market response with structured metrics, tags, outcomes, and event */
+        MarketResponse: {
+            condition_id: string;
+            id?: string | null;
+            market_slug?: string | null;
+            question?: string | null;
+            title?: string | null;
+            description?: string | null;
+            image_url?: string | null;
+            oracle?: string | null;
+            status: string;
+            /** Format: int64 */
+            created_time?: number | null;
+            /** Format: int64 */
+            start_time?: number | null;
+            /** Format: int64 */
+            game_start_time?: number | null;
+            /** Format: int64 */
+            closed_time?: number | null;
+            /** Format: int64 */
+            end_time?: number | null;
+            accepting_orders?: boolean | null;
+            uma_resolution_status?: string | null;
+            is_neg_risk?: boolean | null;
+            market_maker_address?: string | null;
+            creator?: string | null;
+            category?: string | null;
+            /** Format: double */
+            volume_usd?: number | null;
+            /** Format: double */
+            liquidity_usd?: number | null;
+            /** Format: double */
+            highest_probability?: number | null;
+            /** Format: int64 */
+            total_holders?: number | null;
+            winning_outcome?: null | components["schemas"]["MarketOutcome"];
+            outcomes?: components["schemas"]["MarketOutcome"][];
+            rewards?: components["schemas"]["MarketReward"][];
+            clob_rewards?: components["schemas"]["ClobReward"][];
+            tags?: string[];
+            event_slug?: string | null;
+            resolution_source?: string | null;
+            metrics?: {
+                [key: string]: components["schemas"]["SimpleTimeframeMetrics"];
+            };
+        };
+        /** @description Reward info for market API responses */
+        MarketReward: {
+            /**
+             * Format: double
+             * @default null
+             */
+            min_size: number | null;
+            /**
+             * Format: double
+             * @default null
+             */
+            max_spread: number | null;
+            /**
+             * Format: double
+             * @default null
+             */
+            daily_rate: number | null;
+        };
         /** @enum {string} */
         MarketSortBy: "volume" | "txns" | "unique_traders" | "liquidity" | "holders" | "end_time" | "start_time" | "created_time" | "created_at" | "relevance";
         /** @enum {string} */
-        MarketStatus: "open" | "closed";
+        MarketStatus: "open" | "closed" | "all";
         MarketVolumeChartResponse: {
             volumes: components["schemas"]["MarketVolumeDataPoint"][];
             has_more: boolean;
@@ -1134,11 +1137,6 @@ export interface components {
              * @default 0
              */
             sells: number;
-            /**
-             * Format: double
-             * @default 0
-             */
-            open_interest_change: number;
             /**
              * Format: double
              * @default null
@@ -1194,7 +1192,7 @@ export interface components {
             /** @default  */
             id: string;
             /** @default null */
-            slug: string | null;
+            event_slug: string | null;
             /** @default null */
             title: string | null;
             /** @default null */
@@ -1216,12 +1214,22 @@ export interface components {
              * Format: int64
              * @default null
              */
-            start_date: number | null;
+            created_time: number | null;
             /**
              * Format: int64
              * @default null
              */
-            end_date: number | null;
+            closed_time: number | null;
+            /**
+             * Format: int64
+             * @default null
+             */
+            start_time: number | null;
+            /**
+             * Format: int64
+             * @default null
+             */
+            end_time: number | null;
             /** @default false */
             neg_risk: boolean;
             /** @default null */
@@ -1245,16 +1253,6 @@ export interface components {
             markets: components["schemas"]["EventMarket"][];
             /** @default null */
             series: null | components["schemas"]["PolymarketSeries"];
-            /**
-             * Format: int64
-             * @default null
-             */
-            creation_date: number | null;
-            /**
-             * Format: int64
-             * @default null
-             */
-            closed_time: number | null;
         };
         /**
          * @description A Polymarket series from the Gamma API
@@ -1330,22 +1328,41 @@ export interface components {
             is_mod: boolean;
             created_at?: string | null;
         };
-        /** @description PnL data for a holder (position-level) */
-        PositionHolderPnl: {
+        PositionChartDataPoint: {
             /** Format: double */
-            realized_pnl_usd?: number | null;
+            value: number;
+            /** Format: int64 */
+            timestamp: number;
+        };
+        PositionChartOutcome: {
+            position_id: string;
+            name: string;
+            /** Format: int32 */
+            outcome_index: number;
+            data: components["schemas"]["PositionChartDataPoint"][];
+        };
+        /** @description Position-level PnL data for a holder (outcome token, OrderFilled trades only) */
+        PositionHolderPnl: {
             /** Format: double */
             buy_usd?: number | null;
             /** Format: double */
             sell_usd?: number | null;
-            /** Format: double */
-            total_fees?: number | null;
-            /** Format: double */
-            net_shares?: number | null;
+            /**
+             * Format: double
+             * @description Average price paid per share across all buys (0–1 range)
+             */
+            avg_entry_price?: number | null;
+            /**
+             * Format: double
+             * @description Average price received per share across all sells (0–1 range)
+             */
+            avg_exit_price?: number | null;
             /** Format: int64 */
-            buy_count?: number | null;
+            total_buys?: number | null;
             /** Format: int64 */
-            sell_count?: number | null;
+            total_sells?: number | null;
+            /** Format: double */
+            total_fees?: number | null;
             /** Format: int64 */
             first_trade_at?: number | null;
             /** Format: int64 */
@@ -1407,6 +1424,8 @@ export interface components {
             /** Format: double */
             price_close: number;
         };
+        /** @enum {string} */
+        PositionPnlSortBy: "realized_pnl_usd" | "buy_usd" | "sell_usd" | "total_buys" | "total_sells" | "total_fees";
         PositionVolumeChartResponse: {
             volumes: components["schemas"]["PositionVolumeDataPoint"][];
             has_more: boolean;
@@ -1445,10 +1464,6 @@ export interface components {
             /** Format: double */
             m?: number | null;
         };
-        PredictionCandlestickResponseData: {
-            candles: components["schemas"]["PredictionCandlestickBar"][];
-            has_more: boolean;
-        };
         /** @description Response format for prediction trades */
         PredictionTradeResponse: {
             id: string;
@@ -1527,11 +1542,6 @@ export interface components {
              * @default 0
              */
             unique_traders: number;
-            /**
-             * Format: double
-             * @default 0
-             */
-            open_interest_change: number;
         };
         /** @enum {string} */
         SortDirection: "asc" | "desc";
@@ -1562,6 +1572,44 @@ export interface components {
             x_username?: string | null;
             verified_badge?: boolean;
         };
+        /** @description Event-level PnL entry */
+        TraderEventPnlEntry: {
+            event_slug?: string | null;
+            /** Format: int64 */
+            markets_traded?: number | null;
+            /** Format: int64 */
+            outcomes_traded?: number | null;
+            /** Format: int64 */
+            total_buys?: number | null;
+            /** Format: int64 */
+            total_sells?: number | null;
+            /** Format: int64 */
+            total_redemptions?: number | null;
+            /** Format: int64 */
+            total_merges?: number | null;
+            /** Format: double */
+            total_volume_usd?: number | null;
+            /** Format: double */
+            buy_usd?: number | null;
+            /** Format: double */
+            sell_usd?: number | null;
+            /** Format: double */
+            redemption_usd?: number | null;
+            /** Format: double */
+            merge_usd?: number | null;
+            /** Format: double */
+            realized_pnl_usd?: number | null;
+            /** Format: int64 */
+            winning_markets?: number | null;
+            /** Format: int64 */
+            losing_markets?: number | null;
+            /** Format: double */
+            total_fees?: number | null;
+            /** Format: int64 */
+            first_trade_at?: number | null;
+            /** Format: int64 */
+            last_trade_at?: number | null;
+        };
         /** @description Trader profile info - backwards compatibility */
         TraderInfo: {
             address: string;
@@ -1571,6 +1619,72 @@ export interface components {
             x_username?: string | null;
             verified_badge?: boolean;
         };
+        /** @description Market-level PnL entry */
+        TraderMarketPnlEntry: {
+            condition_id?: string | null;
+            event_slug?: string | null;
+            /** Format: int64 */
+            outcomes_traded?: number | null;
+            /** Format: int64 */
+            total_buys?: number | null;
+            /** Format: int64 */
+            total_sells?: number | null;
+            /** Format: int64 */
+            total_redemptions?: number | null;
+            /** Format: int64 */
+            total_merges?: number | null;
+            /** Format: double */
+            buy_usd?: number | null;
+            /** Format: double */
+            sell_usd?: number | null;
+            /** Format: double */
+            redemption_usd?: number | null;
+            /** Format: double */
+            merge_usd?: number | null;
+            /** Format: double */
+            realized_pnl_usd?: number | null;
+            /** Format: int64 */
+            winning_outcomes?: number | null;
+            /** Format: double */
+            total_fees?: number | null;
+            /** Format: int64 */
+            first_trade_at?: number | null;
+            /** Format: int64 */
+            last_trade_at?: number | null;
+        };
+        /** @description Outcome-level PnL entry (per outcome token / position_id, OrderFilled trades only) */
+        TraderOutcomePnlEntry: {
+            position_id?: string | null;
+            condition_id?: string | null;
+            event_slug?: string | null;
+            outcome?: string | null;
+            /** Format: int32 */
+            outcome_index?: number | null;
+            /** Format: int64 */
+            total_buys?: number | null;
+            /** Format: int64 */
+            total_sells?: number | null;
+            /** Format: double */
+            buy_usd?: number | null;
+            /** Format: double */
+            sell_usd?: number | null;
+            /**
+             * Format: double
+             * @description VWAP price paid per share across all buys (0–1)
+             */
+            avg_entry_price?: number | null;
+            /**
+             * Format: double
+             * @description VWAP price received per share across all sells (0–1)
+             */
+            avg_exit_price?: number | null;
+            /** Format: double */
+            total_fees?: number | null;
+            /** Format: int64 */
+            first_trade_at?: number | null;
+            /** Format: int64 */
+            last_trade_at?: number | null;
+        };
         TraderVolumeChartResponse: {
             volumes: components["schemas"]["TraderVolumeDataPoint"][];
             has_more: boolean;
@@ -1603,19 +1717,19 @@ export interface operations {
     get_events: {
         parameters: {
             query?: {
-                /** @description Filter by event ID(s) - comma-separated (max 50). Cannot be used with 'slug'. Example: id=99600,99601,99583 */
+                /** @description Filter by event ID(s) - comma-separated (max 50). Cannot be used with 'event_slugs'. Example: id=99600,99601,99583 */
                 id?: string;
-                /** @description Filter by event slug(s) - comma-separated (max 50). Cannot be used with 'id'. Example: slug=will-trump-win,bitcoin-100k */
-                slug?: string;
+                /** @description Filter by event slug(s) - comma-separated (max 50). Cannot be used with 'id'. Example: event_slugs=will-trump-win,bitcoin-100k */
+                event_slugs?: string;
                 /** @description Search in title and description (3-100 characters). Example: search=trump */
                 search?: string;
-                /** @description Sort: volume, txns, unique_traders, title, creation_date, start_date, end_date, relevance (relevance only works in search mode) */
+                /** @description Sort: volume, txns, unique_traders, title, creation_date, start_date, end_date, relevance (relevance only works in search mode) (default: volume) */
                 sort_by?: components["schemas"]["EventSortBy"];
-                /** @description Sort direction: asc, desc */
+                /** @description Sort direction: asc, desc (default: desc) */
                 sort_dir?: components["schemas"]["SortDirection"];
-                /** @description Metrics timeframe: 1m, 5m, 30m, 1h, 6h, 24h, 7d, 30d */
+                /** @description Metrics timeframe: 1m, 5m, 30m, 1h, 6h, 24h, 7d, 30d (default: 24h) */
                 timeframe?: components["schemas"]["MetricsTimeframe"];
-                /** @description Filter by status: open or closed */
+                /** @description Filter by status: open, closed, or all (default: all) */
                 status?: components["schemas"]["MarketStatus"];
                 /** @description Comma-separated category filters */
                 categories?: string;
@@ -1672,13 +1786,27 @@ export interface operations {
             };
         };
     };
-    get_event_metrics: {
+    get_event_chart: {
         parameters: {
             query: {
-                /** @description Event slug */
+                /** @description Event slug (required) */
                 event_slug: string;
-                /** @description Timeframe: single (1m, 5m, 30m, 1h, 6h, 24h, 7d, 30d), comma-separated (1m,5m,1h), or 'all' */
-                timeframe: string;
+                /** @description Comma-separated condition IDs to include (max 4, optional) */
+                condition_ids?: string;
+                /** @description Comma-separated market slugs to include (max 4, optional). Use either condition_ids or market_slugs, not both */
+                market_slugs?: string;
+                /** @description Number of top markets to include if neither condition_ids nor market_slugs specified (max 4, default: 4) */
+                limit?: number;
+                /** @description Time interval: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
+                resolution?: components["schemas"]["CandlestickResolution"];
+                /** @description Number of data points (max: 2500) */
+                count_back?: number;
+                /** @description Start timestamp (Unix seconds) */
+                from?: number;
+                /** @description End timestamp (Unix seconds) */
+                to?: number;
+                /** @description Cursor-based pagination key for fetching next page */
+                pagination_key?: string;
             };
             header?: never;
             path?: never;
@@ -1686,97 +1814,48 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Event metrics for the specified timeframe(s). Returns single object for one timeframe, array for multiple. */
+            /** @description Price data over time for up to 4 markets with highest YES odds */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["EventMetricsResponse"];
+                    "application/json": components["schemas"]["EventMarketChartOutcome"][];
                 };
             };
-            /** @description Invalid timeframe */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-            /** @description Event metrics not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
         };
     };
-    get_event_holders: {
+    get_event_metrics: {
         parameters: {
-            query?: {
-                /** @description Results limit (default: 10, max: 100) */
-                limit?: number;
-                /** @description Cursor-based pagination key (base64-encoded, obtained from previous response's pagination.pagination_key) */
-                pagination_key?: string;
-                /** @description Minimum total shares held (decimal string) */
-                min_shares?: string;
-                /** @description Maximum total shares held (decimal string) */
-                max_shares?: string;
-                /** @description PnL timeframe: 1d, 7d, 30d, lifetime (default: lifetime) */
-                timeframe?: components["schemas"]["PnlTimeframe"];
-            };
-            header?: never;
-            path: {
+            query: {
                 /** @description Event slug */
                 event_slug: string;
+                /** @description Timeframe: single (1m, 5m, 30m, 1h, 6h, 24h, 7d, 30d), comma-separated (1m,5m,1h), or 'all' */
+                timeframe: string;
             };
+            header?: never;
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Event holders aggregated across markets (sorted by total_shares DESC). Response includes `pagination: { has_more, pagination_key }` for cursor-based pagination. */
+            /** @description Event metrics for the specified timeframe(s). Returns single object for one timeframe, array for multiple. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["EventHoldersResponse"];
+                    "application/json": components["schemas"]["EventMetricsResponse"];
                 };
             };
-            /** @description Event not found */
-            404: {
+            /** @description Invalid timeframe */
+            400: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-        };
-    };
-    get_event_holders_history: {
-        parameters: {
-            query?: {
-                /** @description Time range in hours (default: 24, max: 336 = 14 days) */
-                hours?: number;
-            };
-            header?: never;
-            path: {
-                /** @description Event slug */
-                event_slug: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Event holder count history with automatic view selection (1m/5m/15m/1h/6h buckets) */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["HolderHistoryCandle"][];
-                };
-            };
-            /** @description Event not found */
+            /** @description Event metrics not found */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -1788,25 +1867,24 @@ export interface operations {
     get_market_holders: {
         parameters: {
             query?: {
+                /** @description Market condition ID (0x-prefixed hex) */
+                condition_id?: string;
+                /** @description Market slug (e.g. `will-trump-win`) */
+                market_slug?: string;
                 /** @description Results limit (default: 10, max: 100) */
                 limit?: number;
                 /** @description Minimum shares held (decimal string) */
                 min_shares?: string;
                 /** @description Maximum shares held (decimal string) */
                 max_shares?: string;
-                /** @description PnL timeframe: 1d, 7d, 30d, lifetime (default: lifetime) */
-                timeframe?: components["schemas"]["PnlTimeframe"];
             };
             header?: never;
-            path: {
-                /** @description Market condition ID */
-                condition_id: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description Market holders grouped by outcome (sorted by shares DESC) */
+            /** @description Market holders grouped by outcome (sorted by shares DESC). Each holder has `pnl: PositionHolderPnl` with outcome-specific trading stats. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -1827,14 +1905,15 @@ export interface operations {
     get_market_holders_history: {
         parameters: {
             query?: {
+                /** @description Market condition ID (0x-prefixed hex) */
+                condition_id?: string;
+                /** @description Market slug (e.g. `will-trump-win`) */
+                market_slug?: string;
                 /** @description Time range in hours (default: 24, max: 336 = 14 days) */
                 hours?: number;
             };
             header?: never;
-            path: {
-                /** @description Market condition ID */
-                condition_id: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
@@ -1878,7 +1957,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Position holders (sorted by shares DESC). Response includes `pagination: { has_more, pagination_key }` for cursor-based pagination. */
+            /** @description Position holders (sorted by shares DESC). Each holder has `pnl: PositionHolderPnl` with outcome-specific trading stats. Response includes `pagination: { has_more, pagination_key }` for cursor-based pagination. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -1946,7 +2025,7 @@ export interface operations {
                 position_ids?: string;
                 /** @description Search in title (3-100 characters) */
                 search?: string;
-                /** @description Filter by status: open or closed */
+                /** @description Filter by status: open, closed, or all (default: all) */
                 status?: components["schemas"]["MarketStatus"];
                 /** @description Sort: volume, txns, unique_traders, liquidity, holders, end_time, start_time, created_time, created_at, relevance */
                 sort_by?: components["schemas"]["MarketSortBy"];
@@ -2074,7 +2153,44 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["PredictionCandlestickResponseData"];
+                    "application/json": components["schemas"]["PredictionCandlestickBar"][];
+                };
+            };
+        };
+    };
+    get_chart: {
+        parameters: {
+            query?: {
+                /** @description Market condition ID or market_slug (one required) */
+                condition_id?: string;
+                /** @description Market slug (alternative to condition_id) */
+                market_slug?: string;
+                /** @description Comma-separated list of position IDs (max 4, optional). Auto-selected if not provided */
+                position_ids?: string;
+                /** @description Time interval: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
+                resolution?: components["schemas"]["CandlestickResolution"];
+                /** @description Number of data points (max: 2500) */
+                count_back?: number;
+                /** @description Start timestamp (Unix seconds) */
+                from?: number;
+                /** @description End timestamp (Unix seconds) */
+                to?: number;
+                /** @description Cursor-based pagination key for fetching next page */
+                pagination_key?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Price data over time for up to 4 market outcomes */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PositionChartOutcome"][];
                 };
             };
         };
@@ -2144,7 +2260,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["PredictionCandlestickResponseData"];
+                    "application/json": components["schemas"]["PredictionCandlestickBar"][];
                 };
             };
         };
@@ -2214,7 +2330,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["PositionVolumeChartResponse"];
+                    "application/json": components["schemas"]["PositionVolumeDataPoint"][];
                 };
             };
         };
@@ -2282,9 +2398,11 @@ export interface operations {
     };
     get_market_volume_chart: {
         parameters: {
-            query: {
-                /** @description Market condition ID (required) */
-                condition_id: string;
+            query?: {
+                /** @description Market condition ID (or use market_slug) */
+                condition_id?: string;
+                /** @description Market slug (alternative to condition_id) */
+                market_slug?: string;
                 /** @description Time interval: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
                 resolution?: components["schemas"]["CandlestickResolution"];
                 /** @description Number of data points (max: 2500) */
@@ -2306,7 +2424,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["MarketVolumeChartResponse"];
+                    "application/json": components["schemas"]["MarketVolumeDataPoint"][];
                 };
             };
         };
@@ -2598,8 +2716,8 @@ export interface operations {
                 sort_direction?: components["schemas"]["SortDirection"];
                 /** @description Results limit (default: 10, max: 200) */
                 limit?: number;
-                /** @description Offset-based pagination key */
-                pagination_key?: number;
+                /** @description Cursor-based pagination key (base64-encoded, from previous response) */
+                pagination_key?: string;
                 /** @description Filter by event slug */
                 event_slug?: string;
             };
@@ -2612,12 +2730,14 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Event-level PnL entries for this trader. Response includes `pagination: { has_more, pagination_key }` for offset-based pagination. */
+            /** @description Event-level PnL entries for this trader */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["TraderEventPnlEntry"][];
+                };
             };
         };
     };
@@ -2632,10 +2752,12 @@ export interface operations {
                 sort_direction?: components["schemas"]["SortDirection"];
                 /** @description Results limit (default: 10, max: 200) */
                 limit?: number;
-                /** @description Offset-based pagination key */
-                pagination_key?: number;
-                /** @description Filter by condition ID */
+                /** @description Cursor-based pagination key (base64-encoded, from previous response) */
+                pagination_key?: string;
+                /** @description Filter by condition ID (or use market_slug) */
                 condition_id?: string;
+                /** @description Filter by market slug (alternative to condition_id) */
+                market_slug?: string;
                 /** @description Filter by event slug */
                 event_slug?: string;
             };
@@ -2648,54 +2770,36 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Market-level PnL entries for this trader. Response includes `pagination: { has_more, pagination_key }` for offset-based pagination. */
+            /** @description Market-level PnL entries for this trader */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
-            };
-        };
-    };
-    get_portfolio: {
-        parameters: {
-            query?: {
-                /** @description Stats timeframe: 7d, 30d, lifetime */
-                timeframe?: components["schemas"]["PnlTimeframe"];
-            };
-            header?: never;
-            path: {
-                /** @description Trader wallet address */
-                address: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Full portfolio with stats, positions, and PnL chart. Positions include `pagination: { has_more, pagination_key }` for offset-based pagination. */
-            200: {
-                headers: {
-                    [name: string]: unknown;
+                content: {
+                    "application/json": components["schemas"]["TraderMarketPnlEntry"][];
                 };
-                content?: never;
             };
         };
     };
-    get_portfolio_positions: {
+    get_trader_position_pnl: {
         parameters: {
             query?: {
-                /** @description Sort field: shares_usd (default), shares, realized_pnl_usd, price, buy_usd */
-                sort_by?: string;
+                /** @description Timeframe: 1d, 7d, 30d, lifetime (default: 7d) */
+                timeframe?: components["schemas"]["PnlTimeframe"];
+                /** @description Sort: realized_pnl_usd, buy_usd, sell_usd, total_buys, total_sells, total_fees (default: realized_pnl_usd) */
+                sort_by?: components["schemas"]["PositionPnlSortBy"];
                 /** @description Sort direction: asc, desc (default: desc) */
                 sort_direction?: components["schemas"]["SortDirection"];
-                /** @description Filter by condition ID */
-                condition_id?: string;
-                /** @description Filter by event slug */
-                event_slug?: string;
-                /** @description Results limit (default: 50, max: 200) */
+                /** @description Results limit (default: 10, max: 200) */
                 limit?: number;
-                /** @description Offset-based pagination key (integer offset into result set) */
-                pagination_key?: number;
+                /** @description Cursor-based pagination key (base64-encoded, from previous response) */
+                pagination_key?: string;
+                /** @description Filter by market condition ID (or use market_slug) */
+                condition_id?: string;
+                /** @description Filter by market slug (alternative to condition_id) */
+                market_slug?: string;
+                /** @description Filter by specific outcome token (position ID) */
+                position_id?: string;
             };
             header?: never;
             path: {
@@ -2706,12 +2810,14 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Trader positions with market metadata and PnL. Response includes `pagination: { has_more, pagination_key }` for offset-based pagination. */
+            /** @description Position-level PnL entries for this trader. Each entry is a specific outcome token with avg_entry_price and avg_exit_price. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["TraderOutcomePnlEntry"][];
+                };
             };
         };
     };
@@ -2757,7 +2863,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Map of trader addresses to their profile information */
+            /** @description Array of trader profiles */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2864,7 +2970,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TraderVolumeChartResponse"];
+                    "application/json": components["schemas"]["TraderVolumeDataPoint"][];
                 };
             };
         };