@structbuild/sdk 0.1.7 → 0.1.9

package/dist/generated/polymarket.d.ts

@@ -563,26 +563,6 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/trader/pnl/{address}/positions": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get trader position PnL
-         * @description Retrieve position-level PnL breakdown for a trader
-         */
-        get: operations["get_trader_position_pnl"];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/polymarket/trader/portfolio/{address}": {
         parameters: {
             query?: never;
@@ -612,7 +592,7 @@ export interface paths {
         };
         /**
          * Get trader positions
-         * @description Retrieve a trader's active or closed positions with optional PnL data
+         * @description Retrieve a trader's active positions with PnL data, sorted by the specified field
          */
         get: operations["get_portfolio_positions"];
         put?: never;
@@ -752,7 +732,8 @@ export interface components {
         ConditionMetricsResponse: {
             condition_id: string;
             timeframe: string;
-            volume_usd: string;
+            /** Format: double */
+            volume_usd: number;
             /** Format: double */
             fees: number;
             /** Format: int32 */
@@ -766,6 +747,8 @@ export interface components {
             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
@@ -773,7 +756,11 @@ export interface components {
             position_count: number;
             /** @description USD balance (USDe on Polygon) */
             usd_balance?: string | null;
-            pnl?: null | components["schemas"]["EventHolderPnl"];
+            /**
+             * Format: double
+             * @description Lifetime realized PnL in USD
+             */
+            realized_pnl_usd?: number | null;
         };
         /** @description Event-level PnL data for a holder */
         EventHolderPnl: {
@@ -811,8 +798,6 @@ export interface components {
             total_holders: number;
             /** @description Top holders across all markets */
             holders: components["schemas"]["EventHolder"][];
-            /** @description Pagination info */
-            has_more: boolean;
         };
         /** @description Enriched market data for event API responses */
         EventMarket: {
@@ -858,10 +843,6 @@ export interface components {
             category: string | null;
             /** @default [] */
             clob_rewards: components["schemas"]["ClobReward"][];
-            /** @default {} */
-            metrics: {
-                [key: string]: components["schemas"]["SimpleTimeframeMetrics"];
-            };
             /** @default [] */
             outcomes: components["schemas"]["EventMarketOutcome"][];
         };
@@ -876,7 +857,8 @@ export interface components {
         EventMetricsResponse: {
             event_slug: string;
             timeframe: string;
-            volume_usd: string;
+            /** Format: double */
+            volume_usd: number;
             /** Format: double */
             fees: number;
             /** Format: int32 */
@@ -889,7 +871,7 @@ export interface components {
         /** @enum {string} */
         EventSortBy: "volume" | "txns" | "unique_traders" | "title" | "creation_date" | "start_date" | "end_date" | "relevance";
         /** @enum {string} */
-        GlobalPnlSortBy: "pnl_usd" | "win_rate" | "wins" | "losses" | "buys" | "sells" | "redemptions" | "merges" | "avg_hold_time" | "positions_traded" | "markets_traded" | "events_traded" | "markets_won" | "volume_usd" | "fees";
+        GlobalPnlSortBy: "pnl_usd" | "buys" | "sells" | "redemptions" | "merges" | "avg_hold_time" | "markets_traded" | "events_traded" | "markets_won" | "volume_usd" | "fees" | "best_trade" | "worst_trade";
         /** @description Individual trader entry in the global PnL leaderboard */
         GlobalPnlTrader: {
             trader: components["schemas"]["TraderInfo"];
@@ -898,16 +880,8 @@ export interface components {
             /** Format: int64 */
             events_traded?: number | null;
             /** Format: int64 */
-            positions_traded?: number | null;
-            /** Format: int64 */
             markets_traded?: number | null;
             /** Format: int64 */
-            winning_positions?: number | null;
-            /** Format: int64 */
-            losing_positions?: number | null;
-            /** Format: double */
-            win_rate_pct?: number | null;
-            /** Format: int64 */
             markets_won?: number | null;
             /** Format: int64 */
             markets_lost?: number | null;
@@ -933,16 +907,20 @@ export interface components {
             total_merges?: number | null;
             /** Format: int64 */
             total_trades?: number | null;
-            /** Format: int64 */
-            open_positions?: number | null;
             /** Format: double */
             total_fees?: number | null;
             /** Format: double */
-            avg_pnl_per_position?: number | null;
+            avg_pnl_per_market?: number | null;
             /** Format: double */
             avg_pnl_per_trade?: number | null;
             /** Format: double */
             avg_hold_time_seconds?: number | null;
+            /** Format: double */
+            best_trade_pnl_usd?: number | null;
+            best_trade_condition_id?: string | null;
+            /** Format: double */
+            worst_trade_pnl_usd?: number | null;
+            worst_trade_condition_id?: string | null;
             /** Format: int64 */
             first_trade_at?: number | null;
             /** Format: int64 */
@@ -958,20 +936,18 @@ export interface components {
             shares_usd?: string | null;
             /** @description USD balance of wallet (USDe on Polygon) */
             usd_balance?: string | null;
-            pnl?: null | components["schemas"]["PositionHolderPnl"];
+            /**
+             * Format: double
+             * @description Lifetime realized PnL in USD
+             */
+            realized_pnl_usd?: number | null;
         };
         /** @description Holder statistics data point (single time bucket) */
         HolderHistoryCandle: {
-            /** Format: date-time */
-            bucket: string;
-            /** Format: int64 */
-            total_holders?: number | null;
-            /** Format: int64 */
-            bot_holders?: number | null;
             /** Format: int64 */
-            insider_holders?: number | null;
+            timestamp: number;
             /** Format: int64 */
-            smart_money_holders?: number | null;
+            total_holders?: number | null;
         };
         /** @description Market-level PnL data for a holder */
         MarketHolderPnl: {
@@ -992,8 +968,6 @@ export interface components {
             /** Format: int64 */
             winning_outcomes?: number | null;
             /** Format: int64 */
-            losing_outcomes?: number | null;
-            /** Format: int64 */
             first_trade_at?: number | null;
             /** Format: int64 */
             last_trade_at?: number | null;
@@ -1118,7 +1092,7 @@ export interface components {
              * Format: double
              * @description Current price/probability
              */
-            last_price?: number | null;
+            price?: number | null;
             /**
              * Format: int64
              * @description Total holders count from holder_stats
@@ -1127,6 +1101,8 @@ export interface components {
             /** @description Top holders for this outcome */
             holders: components["schemas"]["Holder"][];
         };
+        /** @enum {string} */
+        OutcomeIndex: "0" | "1";
         OutcomeTimeframeMetrics: {
             /**
              * Format: double
@@ -1392,7 +1368,7 @@ export interface components {
              * Format: double
              * @description Current price
              */
-            last_price?: number | null;
+            price?: number | null;
             /**
              * Format: int64
              * @description Total holders count from holder_stats
@@ -1400,17 +1376,18 @@ export interface components {
             total_holders: number;
             /** @description Top holders */
             holders: components["schemas"]["Holder"][];
-            /** @description Pagination info */
-            has_more: boolean;
         };
         /** @description Response type for position metrics query */
         PositionMetricsResponse: {
             position_id: string;
             condition_id: string;
             timeframe: string;
-            volume_usd: string;
-            buy_volume_usd: string;
-            sell_volume_usd: string;
+            /** Format: double */
+            volume_usd: number;
+            /** Format: double */
+            buy_volume_usd: number;
+            /** Format: double */
+            sell_volume_usd: number;
             /** Format: double */
             fees: number;
             /** Format: int32 */
@@ -1430,10 +1407,6 @@ export interface components {
             /** Format: double */
             price_close: number;
         };
-        /** @enum {string} */
-        PositionPnlSortBy: "realized_pnl_usd" | "buy_usd" | "net_shares" | "cost_basis" | "total_fees";
-        /** @enum {string} */
-        PositionStatus: "active" | "resolved" | "all";
         PositionVolumeChartResponse: {
             volumes: components["schemas"]["PositionVolumeDataPoint"][];
             has_more: boolean;
@@ -1567,6 +1540,10 @@ export interface components {
             token_id: string;
             outcome: string;
         };
+        /** @enum {string} */
+        TradeSide: "0" | "1";
+        /** @enum {string} */
+        TradeType: "0" | "1" | "2" | "4";
         /**
          * @description Trader profile info embedded in API responses
          *
@@ -1638,8 +1615,8 @@ export interface operations {
                 sort_dir?: components["schemas"]["SortDirection"];
                 /** @description Metrics timeframe: 1m, 5m, 30m, 1h, 6h, 24h, 7d, 30d */
                 timeframe?: components["schemas"]["MetricsTimeframe"];
-                /** @description Filter by status: 'open' or 'closed' */
-                status?: string;
+                /** @description Filter by status: open or closed */
+                status?: components["schemas"]["MarketStatus"];
                 /** @description Comma-separated category filters */
                 categories?: string;
                 /** @description Comma-separated categories to exclude */
@@ -1677,7 +1654,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description List of Polymarket events with nested tags, markets, and series */
+            /** @description List of Polymarket events with nested tags, markets, and series. Response includes `pagination: { has_more, pagination_key }` for cursor-based pagination. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -1745,9 +1722,7 @@ export interface operations {
                 min_shares?: string;
                 /** @description Maximum total shares held (decimal string) */
                 max_shares?: string;
-                /** @description Include event-level PnL data (costs extra credits, default: false) */
-                include_pnl?: boolean;
-                /** @description PnL timeframe: 1d, 7d, 30d, lifetime (default: 7d) */
+                /** @description PnL timeframe: 1d, 7d, 30d, lifetime (default: lifetime) */
                 timeframe?: components["schemas"]["PnlTimeframe"];
             };
             header?: never;
@@ -1759,7 +1734,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Event holders aggregated across markets (sorted by total_shares DESC) */
+            /** @description Event holders aggregated across markets (sorted by total_shares DESC). Response includes `pagination: { has_more, pagination_key }` for cursor-based pagination. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -1819,9 +1794,7 @@ export interface operations {
                 min_shares?: string;
                 /** @description Maximum shares held (decimal string) */
                 max_shares?: string;
-                /** @description Include position-level PnL data (costs extra credits, default: false) */
-                include_pnl?: boolean;
-                /** @description PnL timeframe: 1d, 7d, 30d, lifetime (default: 7d) */
+                /** @description PnL timeframe: 1d, 7d, 30d, lifetime (default: lifetime) */
                 timeframe?: components["schemas"]["PnlTimeframe"];
             };
             header?: never;
@@ -1895,10 +1868,6 @@ export interface operations {
                 min_shares?: string;
                 /** @description Maximum shares held (decimal string) */
                 max_shares?: string;
-                /** @description Include position-level PnL data (costs extra credits, default: false) */
-                include_pnl?: boolean;
-                /** @description PnL timeframe: 1d, 7d, 30d, lifetime (default: 7d) */
-                timeframe?: components["schemas"]["PnlTimeframe"];
             };
             header?: never;
             path: {
@@ -1909,7 +1878,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Position holders (sorted by shares DESC) */
+            /** @description Position holders (sorted by shares DESC). Response includes `pagination: { has_more, pagination_key }` for cursor-based pagination. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2023,7 +1992,7 @@ export interface operations {
                 include_event?: boolean;
                 /** @description Include all timeframe metrics (default: true) */
                 include_metrics?: boolean;
-                /** @description Results limit (default: 50, max: 100) */
+                /** @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;
@@ -2034,7 +2003,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description List of markets with metadata, outcomes, tags, event, and metrics */
+            /** @description List of markets with metadata, outcomes, tags, event, and metrics. Response includes `pagination: { has_more, pagination_key }` for cursor-based pagination. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2057,7 +2026,7 @@ export interface operations {
                 min_probability?: number;
                 /** @description Maximum hours until market end */
                 max_hours?: number;
-                /** @description Number of results (default: 10, max: 200) */
+                /** @description Number of results (default: 10, max: 250) */
                 limit?: number;
                 /** @description Cursor for pagination: end_date (unix epoch) of the last item from the previous page */
                 pagination_key?: number;
@@ -2261,14 +2230,14 @@ export interface operations {
                 position_ids?: string;
                 /** @description Comma-separated trader addresses (max 25) */
                 traders?: string;
-                /** @description 0 = Buy, 1 = Sell */
-                side?: number;
+                /** @description Trade side: 0 (Buy), 1 (Sell) */
+                side?: components["schemas"]["TradeSide"];
                 /** @description Outcome name filter (e.g. Yes, No) */
                 outcome?: string;
-                /** @description Outcome index (0 or 1) */
-                outcome_index?: number;
-                /** @description 0 = OrderFilled, 1 = Redemption, 2 = Merge */
-                trade_type?: number;
+                /** @description Outcome index: 0 (Yes), 1 (No) */
+                outcome_index?: components["schemas"]["OutcomeIndex"];
+                /** @description Trade type: 0 (OrderFilled), 1 (Redemption), 2 (Merge) */
+                trade_type?: components["schemas"]["TradeType"];
                 /** @description Min USD amount */
                 min_usd_amount?: number;
                 /** @description Max USD amount */
@@ -2527,9 +2496,9 @@ export interface operations {
     get_global_pnl: {
         parameters: {
             query?: {
-                /** @description Timeframe: 1d, 7d, 30d (default: 7d) */
+                /** @description Timeframe: 1d, 7d, 30d, lifetime (default: 7d) */
                 timeframe?: components["schemas"]["PnlTimeframe"];
-                /** @description Sort: pnl_usd, win_rate, wins, losses, buys, sells, redemptions, merges, avg_hold_time, positions_traded, markets_traded, events_traded, markets_won, volume_usd, fees (default: pnl_usd) */
+                /** @description Sort: pnl_usd, buys, sells, redemptions, merges, avg_hold_time, markets_traded, events_traded, markets_won, volume_usd, fees, best_trade, worst_trade (default: pnl_usd) */
                 sort_by?: components["schemas"]["GlobalPnlSortBy"];
                 /** @description Sort direction: asc, desc (default: desc) */
                 sort_direction?: components["schemas"]["SortDirection"];
@@ -2544,7 +2513,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Global PnL leaderboard with trader stats */
+            /** @description Global PnL leaderboard with trader stats. Response includes `pagination: { has_more, pagination_key }` for cursor-based pagination. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2575,7 +2544,9 @@ export interface operations {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["GlobalPnlTrader"];
+                };
             };
             /** @description Trader not found */
             404: {
@@ -2641,7 +2612,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Event-level PnL entries for this trader */
+            /** @description Event-level PnL entries for this trader. Response includes `pagination: { has_more, pagination_key }` for offset-based pagination. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2677,43 +2648,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Market-level PnL entries for this trader */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
-        };
-    };
-    get_trader_position_pnl: {
-        parameters: {
-            query?: {
-                /** @description Timeframe: 1d, 7d, 30d, lifetime (default: 7d) */
-                timeframe?: components["schemas"]["PnlTimeframe"];
-                /** @description Sort: realized_pnl_usd, buy_usd, net_shares, cost_basis, total_fees (default: realized_pnl_usd) */
-                sort_by?: components["schemas"]["PositionPnlSortBy"];
-                /** @description Sort direction: asc, desc (default: desc) */
-                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 */
-                condition_id?: string;
-                /** @description Filter by event slug */
-                event_slug?: string;
-            };
-            header?: never;
-            path: {
-                /** @description Trader wallet address */
-                address: string;
-            };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Position-level PnL entries for this trader */
+            /** @description Market-level PnL entries for this trader. Response includes `pagination: { has_more, pagination_key }` for offset-based pagination. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2737,7 +2672,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Full portfolio with stats, positions, and PnL chart */
+            /** @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;
@@ -2749,15 +2684,15 @@ export interface operations {
     get_portfolio_positions: {
         parameters: {
             query?: {
-                /** @description Position status: active, resolved, all (default: all) */
-                status?: components["schemas"]["PositionStatus"];
+                /** @description Sort field: shares_usd (default), shares, realized_pnl_usd, price, buy_usd */
+                sort_by?: string;
+                /** @description Sort direction: asc, desc (default: desc) */
+                sort_direction?: components["schemas"]["SortDirection"];
                 /** @description Filter by condition ID */
                 condition_id?: string;
-                /** @description Filter by market slug */
-                market_slug?: string;
-                /** @description Search by question text */
-                question?: string;
-                /** @description Results limit (default: 10, max: 100) */
+                /** @description Filter by event slug */
+                event_slug?: string;
+                /** @description Results limit (default: 50, max: 200) */
                 limit?: number;
                 /** @description Offset-based pagination key (integer offset into result set) */
                 pagination_key?: number;
@@ -2771,7 +2706,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Trader positions with market metadata */
+            /** @description Trader positions with market metadata and PnL. Response includes `pagination: { has_more, pagination_key }` for offset-based pagination. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2797,7 +2732,9 @@ export interface operations {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["PolymarketUserProfile"];
+                };
             };
             /** @description Profile not found */
             404: {
@@ -2825,7 +2762,9 @@ export interface operations {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["PolymarketUserProfile"][];
+                };
             };
             /** @description Invalid request (empty addresses or more than 20) */
             400: {
@@ -2845,14 +2784,14 @@ export interface operations {
                 slugs?: string;
                 /** @description Comma-separated position IDs */
                 position_ids?: string;
-                /** @description 0 = Buy, 1 = Sell */
-                side?: number;
+                /** @description Trade side: 0 (Buy), 1 (Sell) */
+                side?: components["schemas"]["TradeSide"];
                 /** @description Outcome name filter (e.g. Yes, No) */
                 outcome?: string;
-                /** @description Outcome index (0 or 1) */
-                outcome_index?: number;
-                /** @description 0 = OrderFilled, 1 = Redemption, 2 = Merge */
-                trade_type?: number;
+                /** @description Outcome index: 0 (Yes), 1 (No) */
+                outcome_index?: components["schemas"]["OutcomeIndex"];
+                /** @description Trade type: 0 (OrderFilled), 1 (Redemption), 2 (Merge) */
+                trade_type?: components["schemas"]["TradeType"];
                 /** @description Min USD amount */
                 min_usd_amount?: number;
                 /** @description Max USD amount */