@structbuild/sdk 0.1.2

package/dist/generated/polymarket.d.ts

@@ -0,0 +1,2924 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/polymarket/bonds": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get bonds
+         * @description Retrieve a list of bond markets sorted by yield, filtered by probability and time to expiry
+         */
+        get: operations["get_bonds"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get events
+         * @description Retrieve a paginated list of events with filtering, sorting, and optional nested tags/markets
+         */
+        get: operations["get_events"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/events/metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            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: operations["get_event_metrics"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        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": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get event holders history
+         * @description Retrieve historical holder count snapshots for an event over a time range
+         */
+        get: operations["get_event_holders_history"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/holders/markets/{condition_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get market holders
+         * @description Retrieve holders of a market grouped by outcome, sorted by shares held
+         */
+        get: operations["get_market_holders"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/holders/markets/{condition_id}/history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get market holders history
+         * @description Retrieve historical holder count snapshots for a market over a time range
+         */
+        get: operations["get_market_holders_history"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/holders/positions/{position_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get position holders
+         * @description Retrieve holders of a specific position (ERC1155 token), sorted by shares held. Uses cursor-based pagination for efficient traversal.
+         */
+        get: operations["get_position_holders"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/holders/positions/{position_id}/history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get position holders history
+         * @description Retrieve historical holder count snapshots for a position over a time range
+         */
+        get: operations["get_position_holders_history"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/market": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get markets
+         * @description Retrieve a list of markets with metadata and outcomes
+         */
+        get: operations["list_markets"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/market/candlestick": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get market candlesticks by condition_id
+         * @description Retrieve OHLCV candlestick data for a market by its condition_id
+         */
+        get: operations["get_market_candlestick"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/market/metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get market metrics
+         * @description Retrieve volume, transaction, and trader metrics for a market. Supports single timeframe (e.g., '1m'), multiple timeframes (e.g., '1m,5m,1h'), or 'all' to get all available timeframes.
+         */
+        get: operations["get_market_metrics"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/market/position/candlestick": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get position candlesticks by position_id
+         * @description Retrieve OHLCV candlestick data for a specific position by its position_id
+         */
+        get: operations["get_position_candlestick"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/market/position/metrics": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get position metrics
+         * @description Retrieve volume, transaction, and trader metrics for a specific position. Supports single timeframe (e.g., '1m'), multiple timeframes (e.g., '1m,5m,1h'), or 'all' to get all available timeframes.
+         */
+        get: operations["get_position_metrics"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/market/position/volume-chart": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get position volume chart
+         * @description Retrieve volume over time for a specific position with buy/sell breakdown
+         */
+        get: operations["get_position_volume_chart"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/market/slug/{slug}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get market by slug
+         * @description Retrieve detailed market information by its slug
+         */
+        get: operations["get_market_by_slug"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/market/trades": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get market trades
+         * @description Retrieve trades for one or more markets, with filtering by trader, side, price, amount, and time range
+         */
+        get: operations["get_market_trades"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/market/volume-chart": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get market volume chart
+         * @description Retrieve volume breakdown by YES/NO outcome over time for a prediction market
+         */
+        get: operations["get_market_volume_chart"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/market/{condition_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get market by condition ID
+         * @description Retrieve detailed market information by its condition ID
+         */
+        get: operations["get_market"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/search": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Search events or traders
+         * @description Search across events and traders by keyword
+         */
+        get: operations["search"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/series": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get series
+         * @description Retrieve a paginated list of event series
+         */
+        get: operations["get_series_list"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/series/{identifier}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get series by ID
+         * @description Retrieve a single series by its ID or slug
+         */
+        get: operations["get_series_by_id"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/series/{identifier}/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get events from series
+         * @description Retrieve all events belonging to a specific series
+         */
+        get: operations["get_series_events"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/tags": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get tags
+         * @description Retrieve all available event tags/categories. Uses cursor-based pagination for efficient traversal.
+         */
+        get: operations["get_tags"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/tags/{identifier}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get tag by slug
+         * @description Retrieve a single tag by its ID or slug
+         */
+        get: operations["get_tag_by_id"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/trader/global_pnl": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get global leaderboard
+         * @description Retrieve the global PnL leaderboard ranked by profit and loss. Uses cursor-based pagination for efficient traversal of large datasets.
+         */
+        get: operations["get_global_pnl"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/trader/pnl/{address}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get trader PnL summary
+         * @description Retrieve a trader's overall profit and loss summary
+         */
+        get: operations["get_trader_pnl"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/trader/pnl/{address}/candles": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get trader PnL candles
+         * @description Retrieve PnL candle data for charting a trader's equity curve over time
+         */
+        get: operations["get_trader_pnl_candles"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/trader/pnl/{address}/events": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get trader event PnL
+         * @description Retrieve event-level PnL breakdown for a trader
+         */
+        get: operations["get_trader_event_pnl"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/trader/pnl/{address}/markets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get trader market PnL
+         * @description Retrieve market-level PnL breakdown for a trader
+         */
+        get: operations["get_trader_market_pnl"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        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;
+            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}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get trader positions
+         * @description Retrieve a trader's active or closed positions with optional PnL data
+         */
+        get: operations["get_portfolio_positions"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/trader/profile/{address}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get trader overview
+         * @description Retrieve a trader's profile including stats and trading history summary
+         */
+        get: operations["get_trader_profile"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/trader/profiles/batch": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get multiple trader profiles
+         * @description Retrieve profiles for multiple traders in a single request. Returns a map of address -> profile.
+         */
+        get: operations["get_trader_profiles_batch"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/trader/trades/{address}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get trader trades
+         * @description Retrieve trade history for a specific trader across all markets
+         */
+        get: operations["get_trader_trades"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/trader/volume-chart/{address}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get trader volume chart
+         * @description Retrieve volume breakdown by buy/sell over time for a specific trader
+         */
+        get: operations["get_trader_volume_chart"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        BondMarket: {
+            condition_id: string;
+            title?: string | null;
+            question: string;
+            slug: string;
+            event_slug?: string | null;
+            image_url?: string | null;
+            /** Format: int64 */
+            end_date: number;
+            /** Format: int32 */
+            best_outcome_index: number;
+            /** Format: double */
+            return_pct: number;
+            /** Format: double */
+            apy: number;
+            /** Format: double */
+            usd_volume_24h?: number | null;
+            outcomes: components["schemas"]["BondOutcome"][];
+        };
+        BondOutcome: {
+            name: string;
+            /** Format: int32 */
+            index: number;
+            /** Format: double */
+            probability: number;
+            position_id: string;
+        };
+        /** @enum {string} */
+        CandlestickResolution: "1" | "5" | "15" | "30" | "60" | "240" | "D" | "1D";
+        /** @description CLOB reward (public API format) */
+        ClobReward: {
+            id: string;
+            condition_id: string;
+            asset_address?: string | null;
+            /** Format: double */
+            rewards_amount?: number | null;
+            /** Format: double */
+            rewards_daily_rate?: number | null;
+            start_date?: string | null;
+            end_date?: string | null;
+        };
+        /** @description Response type for condition metrics query */
+        ConditionMetricsResponse: {
+            condition_id: string;
+            timeframe: string;
+            volume_usd: string;
+            /** Format: double */
+            fees: number;
+            /** Format: int32 */
+            txns: number;
+            /** 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;
+            /**
+             * Format: int32
+             * @description Number of distinct positions held
+             */
+            position_count: number;
+            /** @description USD balance (USDe on Polygon) */
+            usd_balance?: string | null;
+            pnl?: null | components["schemas"]["EventHolderPnl"];
+        };
+        /** @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 Pagination info */
+            has_more: boolean;
+        };
+        /** @description Enriched market data for event API responses */
+        EventMarket: {
+            /** @default  */
+            condition_id: string;
+            /** @default null */
+            id: string | null;
+            /** @default null */
+            title: string | null;
+            /** @default  */
+            question: string;
+            /** @default  */
+            slug: string;
+            /** @default  */
+            status: string;
+            /**
+             * Format: int64
+             * @default null
+             */
+            end_date: number | null;
+            /**
+             * Format: double
+             * @default null
+             */
+            volume: number | null;
+            /**
+             * Format: double
+             * @default null
+             */
+            liquidity_usd: number | null;
+            /**
+             * Format: double
+             * @default null
+             */
+            volume_24hr: number | null;
+            /** @default null */
+            image_url: string | null;
+            /** @default null */
+            market_maker_address: string | null;
+            /** @default null */
+            creator: string | null;
+            /** @default null */
+            category: string | null;
+            /** @default [] */
+            clob_rewards: components["schemas"]["ClobReward"][];
+            /** @default {} */
+            metrics: {
+                [key: string]: components["schemas"]["SimpleTimeframeMetrics"];
+            };
+            /** @default [] */
+            outcomes: components["schemas"]["EventMarketOutcome"][];
+        };
+        /** @description Market outcome with probability for event API responses */
+        EventMarketOutcome: {
+            name: string;
+            /** Format: double */
+            probability?: number | null;
+            position_id?: string | null;
+        };
+        /** @description Response type for event metrics query */
+        EventMetricsResponse: {
+            event_slug: string;
+            timeframe: string;
+            volume_usd: string;
+            /** Format: double */
+            fees: number;
+            /** Format: int32 */
+            txns: number;
+            /** Format: int32 */
+            unique_traders: number;
+        };
+        /** @enum {string} */
+        EventPnlSortBy: "realized_pnl_usd" | "total_volume_usd" | "markets_traded" | "total_fees";
+        /** @enum {string} */
+        EventSortBy: "volume" | "txns" | "unique_traders" | "market_count" | "creation_date" | "end_date";
+        /** @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";
+        /** @description Individual trader entry in the global PnL leaderboard */
+        GlobalPnlTrader: {
+            trader: components["schemas"]["TraderInfo"];
+            /** Format: double */
+            pnl_usd?: number | null;
+            /** 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;
+            /** Format: double */
+            market_win_rate_pct?: number | null;
+            /** Format: double */
+            total_volume_usd?: number | null;
+            /** Format: double */
+            buy_volume_usd?: number | null;
+            /** Format: double */
+            sell_volume_usd?: number | null;
+            /** Format: double */
+            redemption_volume_usd?: number | null;
+            /** Format: double */
+            merge_volume_usd?: number | null;
+            /** Format: int64 */
+            total_buys?: number | null;
+            /** Format: int64 */
+            total_sells?: number | null;
+            /** Format: int64 */
+            total_redemptions?: number | null;
+            /** Format: int64 */
+            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;
+            /** Format: double */
+            avg_pnl_per_trade?: number | null;
+            /** Format: double */
+            avg_hold_time_seconds?: number | null;
+            /** Format: int64 */
+            first_trade_at?: number | null;
+            /** Format: int64 */
+            last_trade_at?: number | null;
+        };
+        /** @description Individual holder data */
+        Holder: {
+            /** @description Trader profile information */
+            trader: components["schemas"]["Trader"];
+            /** @description Position shares held (raw balance as string for precision) */
+            shares: string;
+            /** @description USD value of shares (shares * latest price) */
+            shares_usd?: string | null;
+            /** @description USD balance of wallet (USDe on Polygon) */
+            usd_balance?: string | null;
+            pnl?: null | components["schemas"]["PositionHolderPnl"];
+        };
+        /** @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;
+            /** Format: int64 */
+            smart_money_holders?: number | null;
+        };
+        /** @description Market-level PnL data for a holder */
+        MarketHolderPnl: {
+            /** Format: double */
+            realized_pnl_usd?: number | null;
+            /** Format: double */
+            buy_usd?: number | null;
+            /** Format: double */
+            sell_usd?: number | null;
+            /** Format: double */
+            total_fees?: number | null;
+            /** Format: int64 */
+            outcomes_traded?: number | null;
+            /** Format: int64 */
+            total_buys?: number | null;
+            /** Format: int64 */
+            total_sells?: number | null;
+            /** 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;
+        };
+        /** @description Response for market (condition_id) holders endpoint */
+        MarketHoldersResponse: {
+            /** @description Market condition ID */
+            condition_id: string;
+            /** @description Market question/title */
+            question?: string | null;
+            /** @description Market slug */
+            slug?: string | null;
+            /**
+             * Format: int64
+             * @description Total unique holders across all outcomes (from holder_stats)
+             */
+            total_holders: number;
+            /** @description Holders grouped by outcome */
+            outcomes: components["schemas"]["OutcomeHolders"][];
+        };
+        /** @description Market metadata (enriched, cached version) */
+        MarketMetadata: {
+            condition_id: string;
+            question: string;
+            description: string;
+            slug: string;
+            event_slug?: string | null;
+            neg_risk: boolean;
+            tokens: components["schemas"]["TokenOutcome"][];
+            image_url?: string | null;
+            tags: string[];
+            /** Format: int64 */
+            end_date?: number | null;
+            title?: string | null;
+            id?: string | null;
+            /** Format: double */
+            volume_usd?: number | null;
+            /** Format: double */
+            liquidity_usd?: number | null;
+            outcomes: components["schemas"]["MarketOutcome"][];
+            metrics: {
+                [key: string]: number;
+            };
+            market_maker_address?: string | null;
+            creator?: string | null;
+            category?: string | null;
+            clob_rewards: components["schemas"]["ClobReward"][];
+        };
+        /** @description Market outcome with timeframe metrics (websocket API format) */
+        MarketMetadataOutcome: {
+            token_id: string;
+            outcome: string;
+            /** Format: double */
+            last_price?: number | null;
+            /** Format: double */
+            last_probability?: number | null;
+            metrics?: {
+                [key: string]: components["schemas"]["OutcomeTimeframeMetrics"];
+            };
+        };
+        /** @description Market outcome with price/volume data */
+        MarketOutcome: {
+            /** Format: int32 */
+            index: number;
+            name: string;
+            position_id: string;
+            /** Format: double */
+            price?: number | null;
+            /** Format: double */
+            volume?: number | null;
+        };
+        /** @enum {string} */
+        MarketPnlSortBy: "realized_pnl_usd" | "buy_usd" | "total_buys" | "total_fees" | "outcomes_traded";
+        MarketVolumeChartResponse: {
+            volumes: components["schemas"]["MarketVolumeDataPoint"][];
+            has_more: boolean;
+        };
+        MarketVolumeDataPoint: {
+            /** Format: int64 */
+            timestamp: number;
+            /** Format: double */
+            total_volume: number;
+            /** Format: double */
+            yes_volume: number;
+            /** Format: double */
+            no_volume: number;
+            /** Format: int32 */
+            trades_count: number;
+            /** Format: int32 */
+            yes_trades_count: number;
+            /** Format: int32 */
+            no_trades_count: number;
+        };
+        /** @enum {string} */
+        MetricsTimeframe: "1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d";
+        /** @description Holder data grouped by outcome for market-level queries */
+        OutcomeHolders: {
+            /**
+             * Format: int32
+             * @description Outcome index (0, 1, etc.)
+             */
+            outcome_index: number;
+            /** @description Outcome name (Yes, No, etc.) */
+            outcome_name: string;
+            /** @description Position ID for this outcome */
+            position_id: string;
+            /**
+             * Format: double
+             * @description Current price/probability
+             */
+            last_price?: number | null;
+            /**
+             * Format: int64
+             * @description Total holders count from holder_stats
+             */
+            total_holders: number;
+            /** @description Top holders for this outcome */
+            holders: components["schemas"]["Holder"][];
+        };
+        OutcomeTimeframeMetrics: {
+            /**
+             * Format: double
+             * @default 0
+             */
+            volume: number;
+            /**
+             * Format: double
+             * @default 0
+             */
+            buy_volume: number;
+            /**
+             * Format: double
+             * @default 0
+             */
+            sell_volume: number;
+            /**
+             * Format: int32
+             * @default 0
+             */
+            txns: number;
+            /**
+             * Format: int32
+             * @default 0
+             */
+            buys: number;
+            /**
+             * Format: int32
+             * @default 0
+             */
+            sells: number;
+            /**
+             * Format: double
+             * @default 0
+             */
+            open_interest_change: number;
+            /**
+             * Format: double
+             * @default null
+             */
+            price_open: number | null;
+            /**
+             * Format: double
+             * @default null
+             */
+            price_close: number | null;
+            /**
+             * Format: double
+             * @default null
+             */
+            price_high: number | null;
+            /**
+             * Format: double
+             * @default null
+             */
+            price_low: number | null;
+            /**
+             * Format: double
+             * @default null
+             */
+            probability_open: number | null;
+            /**
+             * Format: double
+             * @default null
+             */
+            probability_close: number | null;
+            /**
+             * Format: double
+             * @default null
+             */
+            probability_high: number | null;
+            /**
+             * Format: double
+             * @default null
+             */
+            probability_low: number | null;
+            /**
+             * Format: double
+             * @default null
+             */
+            price_change_percent: number | null;
+        };
+        /** @enum {string} */
+        PnlCandleResolution: "1m" | "1h" | "1d";
+        /** @enum {string} */
+        PnlTimeframe: "1d" | "7d" | "30d" | "lifetime";
+        /** @description A Polymarket event from the Gamma API */
+        PolymarketEvent: {
+            /** @default  */
+            id: string;
+            /** @default null */
+            slug: string | null;
+            /** @default null */
+            title: string | null;
+            /** @default null */
+            ticker: string | null;
+            /** @default null */
+            description: string | null;
+            /** @default null */
+            resolution_source: string | null;
+            /** @default null */
+            category: string | null;
+            /** @default null */
+            image_url: string | null;
+            /**
+             * Format: int32
+             * @default 0
+             */
+            market_count: number;
+            /**
+             * Format: int64
+             * @default null
+             */
+            start_date: number | null;
+            /**
+             * Format: int64
+             * @default null
+             */
+            end_date: number | null;
+            /** @default false */
+            neg_risk: boolean;
+            /** @default null */
+            neg_risk_market_id: string | null;
+            /** @default null */
+            game_status: string | null;
+            /** @default {} */
+            metrics: {
+                [key: string]: components["schemas"]["SimpleTimeframeMetrics"];
+            };
+            /** @default [] */
+            tags: components["schemas"]["PolymarketTag"][];
+            /** @default [] */
+            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
+         *     Series are parent groupings above events (e.g., "NBA Season 2024-25")
+         */
+        PolymarketSeries: {
+            /** @default  */
+            id: string;
+            /** @default null */
+            slug: string | null;
+            /** @default null */
+            ticker: string | null;
+            /** @default null */
+            title: string | null;
+            /** @default null */
+            description: string | null;
+            /** @default null */
+            series_type: string | null;
+            /** @default null */
+            recurrence: string | null;
+            /** @default null */
+            layout: string | null;
+            /** @default null */
+            image_url: string | null;
+            /** @default null */
+            icon_url: string | null;
+            /** @default false */
+            active: boolean;
+            /** @default false */
+            closed: boolean;
+            /** @default false */
+            archived: boolean;
+            /** @default false */
+            featured: boolean;
+            /** @default false */
+            restricted: boolean;
+            /** @default null */
+            pyth_token_id: string | null;
+            /** @default null */
+            cg_asset_name: string | null;
+            /**
+             * Format: int64
+             * @default null
+             */
+            start_date: number | null;
+            /**
+             * Format: int32
+             * @default 0
+             */
+            event_count: number;
+        };
+        /** @description A Polymarket tag from the Gamma API */
+        PolymarketTag: {
+            /** @default  */
+            id: string;
+            /** @default  */
+            label: string;
+            /** @default null */
+            slug: string | null;
+        };
+        /** @description Polymarket user profile (public API format) */
+        PolymarketUserProfile: {
+            proxy_wallet: string;
+            name?: string | null;
+            pseudonym?: string | null;
+            bio?: string | null;
+            profile_image?: string | null;
+            x_username?: string | null;
+            display_username_public: boolean;
+            verified_badge: boolean;
+            user_id?: string | null;
+            is_creator: boolean;
+            is_mod: boolean;
+            created_at?: string | null;
+        };
+        /** @description PnL data for a holder (position-level) */
+        PositionHolderPnl: {
+            /** Format: double */
+            realized_pnl_usd?: number | null;
+            /** 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: int64 */
+            buy_count?: number | null;
+            /** Format: int64 */
+            sell_count?: number | null;
+            /** Format: int64 */
+            first_trade_at?: number | null;
+            /** Format: int64 */
+            last_trade_at?: number | null;
+        };
+        /** @description Response for position (position_id) holders endpoint */
+        PositionHoldersResponse: {
+            /** @description Position ID (ERC1155 token ID) */
+            position_id: string;
+            /** @description Condition ID this position belongs to */
+            condition_id?: string | null;
+            /** @description Outcome name */
+            outcome_name?: string | null;
+            /**
+             * Format: int32
+             * @description Outcome index
+             */
+            outcome_index?: number | null;
+            /**
+             * Format: double
+             * @description Current price
+             */
+            last_price?: number | null;
+            /**
+             * Format: int64
+             * @description Total holders count from holder_stats
+             */
+            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 */
+            fees: number;
+            /** Format: int32 */
+            txns: number;
+            /** Format: int32 */
+            buys: number;
+            /** Format: int32 */
+            sells: number;
+            /** Format: int32 */
+            unique_traders: number;
+            /** Format: double */
+            price_open: number;
+            /** Format: double */
+            price_high: number;
+            /** Format: double */
+            price_low: number;
+            /** 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;
+        };
+        PositionVolumeDataPoint: {
+            /** Format: int64 */
+            timestamp: number;
+            /** Format: double */
+            volume: number;
+            /** Format: double */
+            buy_volume: number;
+            /** Format: double */
+            sell_volume: number;
+            /** Format: int32 */
+            trades_count: number;
+            /** Format: int32 */
+            buy_trades_count: number;
+            /** Format: int32 */
+            sell_trades_count: number;
+        };
+        PredictionCandlestickBar: {
+            /** Format: double */
+            l?: number | null;
+            /** Format: double */
+            h?: number | null;
+            /** Format: double */
+            o?: number | null;
+            /** Format: double */
+            c?: number | null;
+            /** Format: double */
+            v?: number | null;
+            /** Format: int64 */
+            t: number;
+            /** Format: int32 */
+            tc?: number | null;
+            /** Format: double */
+            m?: number | null;
+        };
+        PredictionCandlestickResponseData: {
+            candles: components["schemas"]["PredictionCandlestickBar"][];
+            has_more: boolean;
+        };
+        /** @description Response format for prediction trades */
+        PredictionTradeResponse: {
+            id: string;
+            hash: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int64 */
+            confirmed_at: number;
+            trader: components["schemas"]["TraderInfo"];
+            taker: string;
+            side: string;
+            condition_id?: string | null;
+            outcome?: string | null;
+            /** Format: int32 */
+            outcome_index?: number | null;
+            question?: string | null;
+            slug?: string | null;
+            /** Format: double */
+            usd_amount: number;
+            /** Format: double */
+            shares_amount: number;
+            /** Format: double */
+            price: number;
+            /** Format: double */
+            probability?: number | null;
+            /** Format: double */
+            fee: number;
+            exchange: string;
+            trade_type: string;
+            /** Format: int64 */
+            log_index: number;
+            order_hash: string;
+            position_id: string;
+        };
+        SearchResponse: {
+            events: unknown;
+            traders: components["schemas"]["Trader"][];
+        };
+        SeriesFullResponse: {
+            id: string;
+            slug?: string | null;
+            ticker?: string | null;
+            title?: string | null;
+            description?: string | null;
+            series_type?: string | null;
+            recurrence?: string | null;
+            image_url?: string | null;
+            active: boolean;
+            closed: boolean;
+            archived: boolean;
+            featured: boolean;
+            restricted: boolean;
+            pyth_token_id?: string | null;
+            cg_asset_name?: string | null;
+            tags: components["schemas"]["PolymarketTag"][];
+            events: components["schemas"]["PolymarketEvent"][];
+        };
+        SimpleTimeframeMetrics: {
+            /**
+             * Format: double
+             * @default 0
+             */
+            volume: number;
+            /**
+             * Format: double
+             * @default 0
+             */
+            fees: number;
+            /**
+             * Format: int32
+             * @default 0
+             */
+            txns: number;
+            /**
+             * Format: int32
+             * @default 0
+             */
+            unique_traders: number;
+            /**
+             * Format: double
+             * @default 0
+             */
+            open_interest_change: number;
+        };
+        /** @enum {string} */
+        SortDirection: "asc" | "desc";
+        /** @description Token outcome (position) */
+        TokenOutcome: {
+            token_id: string;
+            outcome: string;
+        };
+        /**
+         * @description Trader profile info embedded in API responses
+         *
+         *     Corresponds to SQL function: `pm_build_trader(address, name, pseudonym, profile_image, x_username, verified_badge)`
+         *
+         *     Used in:
+         *     - holders endpoints (market/event holders)
+         *     - trades endpoints
+         *     - leaderboard endpoints
+         */
+        Trader: {
+            address: string;
+            name?: string | null;
+            pseudonym?: string | null;
+            profile_image?: string | null;
+            x_username?: string | null;
+            verified_badge?: boolean;
+        };
+        /** @description Trader profile info - backwards compatibility */
+        TraderInfo: {
+            address: string;
+            name?: string | null;
+            pseudonym?: string | null;
+            profile_image?: string | null;
+            x_username?: string | null;
+            verified_badge?: boolean;
+        };
+        TraderVolumeChartResponse: {
+            volumes: components["schemas"]["TraderVolumeDataPoint"][];
+            has_more: boolean;
+        };
+        TraderVolumeDataPoint: {
+            /** Format: int64 */
+            timestamp: number;
+            /** Format: double */
+            total_volume: number;
+            /** Format: double */
+            buy_volume: number;
+            /** Format: double */
+            sell_volume: number;
+            /** Format: int32 */
+            trades_count: number;
+            /** Format: int32 */
+            buy_trades_count: number;
+            /** Format: int32 */
+            sell_trades_count: number;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    get_bonds: {
+        parameters: {
+            query?: {
+                /** @description Minimum probability threshold (default: 0.85) */
+                min_probability?: number;
+                /** @description Maximum hours until market end */
+                max_hours?: number;
+                /** @description Number of results (default: 10, max: 200) */
+                limit?: number;
+                /** @description Cursor for pagination: end_date (unix epoch) of the last item from the previous page */
+                pagination_key?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of bond markets sorted by yield */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BondMarket"][];
+                };
+            };
+        };
+    };
+    get_events: {
+        parameters: {
+            query?: {
+                /** @description Get single event by ID */
+                id?: string;
+                /** @description Get single event by slug */
+                event_slug?: string;
+                /** @description Search query (min 3 chars) */
+                search?: string;
+                /** @description Sort: volume, txns, unique_traders, market_count, end_date */
+                sort_by?: components["schemas"]["EventSortBy"];
+                /** @description Sort direction: asc, desc */
+                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 Comma-separated category filters */
+                categories?: string;
+                /** @description Comma-separated categories to exclude */
+                exclude_categories?: string;
+                /** @description Filter by tag slug(s). Array parameter - provide comma-separated values (e.g. tags=sports,football,crypto) */
+                tags?: string;
+                /** @description Comma-separated tag slugs to exclude */
+                exclude_tags?: string;
+                /** @description Minimum volume in selected timeframe */
+                min_volume?: number;
+                /** @description Maximum volume in selected timeframe */
+                max_volume?: number;
+                /** @description Minimum transactions in selected timeframe */
+                min_txns?: number;
+                /** @description Maximum transactions in selected timeframe */
+                max_txns?: number;
+                /** @description Minimum unique traders in selected timeframe */
+                min_unique_traders?: number;
+                /** @description Maximum unique traders in selected timeframe */
+                max_unique_traders?: number;
+                /** @description Include tags array (default: true) */
+                include_tags?: boolean;
+                /** @description Include markets array with outcomes (default: true) */
+                include_markets?: boolean;
+                /** @description Include metrics object with all timeframes (default: true) */
+                include_metrics?: boolean;
+                /** @description Results limit (default: 10, max: 100) */
+                limit?: number;
+                /** @description Offset-based pagination key (integer offset into result set) */
+                pagination_key?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of Polymarket events with nested tags, markets, and series */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PolymarketEvent"][];
+                };
+            };
+        };
+    };
+    get_event_metrics: {
+        parameters: {
+            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 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"]["EventMetricsResponse"];
+                };
+            };
+            /** @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: {
+        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 Include event-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: {
+                /** @description Event slug */
+                event_slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Event holders aggregated across markets (sorted by total_shares DESC) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["EventHoldersResponse"];
+                };
+            };
+            /** @description Event not found */
+            404: {
+                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 */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_market_holders: {
+        parameters: {
+            query?: {
+                /** @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 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: {
+                /** @description Market condition ID */
+                condition_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Market holders grouped by outcome (sorted by shares DESC) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MarketHoldersResponse"];
+                };
+            };
+            /** @description Market not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_market_holders_history: {
+        parameters: {
+            query?: {
+                /** @description Time range in hours (default: 24, max: 336 = 14 days) */
+                hours?: number;
+            };
+            header?: never;
+            path: {
+                /** @description Market condition ID */
+                condition_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Market 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 Market not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_position_holders: {
+        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 shares held (decimal string) */
+                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: {
+                /** @description Position ID (ERC1155 token ID) */
+                position_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Position holders (sorted by shares DESC) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PositionHoldersResponse"];
+                };
+            };
+            /** @description Position not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_position_holders_history: {
+        parameters: {
+            query?: {
+                /** @description Time range in hours (default: 24, max: 336 = 14 days) */
+                hours?: number;
+            };
+            header?: never;
+            path: {
+                /** @description Position ID (ERC1155 token ID) */
+                position_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Position 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 Position not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    list_markets: {
+        parameters: {
+            query?: {
+                /** @description Comma-separated condition IDs */
+                condition_ids?: string;
+                /** @description Comma-separated market slugs */
+                slugs?: string;
+                /** @description Results limit (default: 10, max: 100) */
+                limit?: number;
+                /** @description Cursor for pagination: condition_id of the last item from the previous page */
+                pagination_key?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of markets with metadata */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_market_candlestick: {
+        parameters: {
+            query: {
+                /** @description Market condition ID (required) */
+                condition_id: string;
+                /** @description Candle interval: 1, 5, 15, 30, 60, 240, D, 1D */
+                resolution: components["schemas"]["CandlestickResolution"];
+                /** @description Number of candles (max: 2500) */
+                count_back?: number;
+                /** @description Start timestamp (Unix seconds) */
+                from?: number;
+                /** @description End timestamp (Unix seconds) */
+                to?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OHLCV candlestick data */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PredictionCandlestickResponseData"];
+                };
+            };
+        };
+    };
+    get_market_metrics: {
+        parameters: {
+            query: {
+                /** @description Market condition ID */
+                condition_id: 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 Market 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"]["ConditionMetricsResponse"];
+                };
+            };
+            /** @description Invalid timeframe */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Market metrics not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_position_candlestick: {
+        parameters: {
+            query: {
+                /** @description Position/token ID (required) */
+                position_id: string;
+                /** @description Candle interval: 1, 5, 15, 30, 60, 240, D, 1D */
+                resolution: components["schemas"]["CandlestickResolution"];
+                /** @description Number of candles (max: 2500) */
+                count_back?: number;
+                /** @description Start timestamp (Unix seconds) */
+                from?: number;
+                /** @description End timestamp (Unix seconds) */
+                to?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OHLCV candlestick data */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PredictionCandlestickResponseData"];
+                };
+            };
+        };
+    };
+    get_position_metrics: {
+        parameters: {
+            query: {
+                /** @description Position/token ID */
+                position_id: 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 Position 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"]["PositionMetricsResponse"];
+                };
+            };
+            /** @description Invalid timeframe */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Position metrics not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_position_volume_chart: {
+        parameters: {
+            query: {
+                /** @description Position/token ID (required) */
+                position_id: 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;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Volume with buy/sell breakdown over time */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PositionVolumeChartResponse"];
+                };
+            };
+        };
+    };
+    get_market_by_slug: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Market slug */
+                slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Market details by slug */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_market_trades: {
+        parameters: {
+            query?: {
+                /** @description Comma-separated condition IDs (max 20) */
+                condition_ids?: string;
+                /** @description Comma-separated market slugs */
+                slugs?: string;
+                /** @description Comma-separated position IDs */
+                position_ids?: string;
+                /** @description Comma-separated trader addresses (max 25) */
+                traders?: string;
+                /** @description 0 = Buy, 1 = Sell */
+                side?: number;
+                /** @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 Min USD amount */
+                min_usd_amount?: number;
+                /** @description Max USD amount */
+                max_usd_amount?: number;
+                /** @description Min shares amount */
+                min_shares_amount?: number;
+                /** @description Max shares amount */
+                max_shares_amount?: number;
+                /** @description Min price (0.0-1.0) */
+                min_price?: number;
+                /** @description Max price (0.0-1.0) */
+                max_price?: number;
+                /** @description Start timestamp (ms) */
+                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 Offset-based pagination key (integer offset into result set) */
+                pagination_key?: number;
+                /** @description Sort newest first (default: true) */
+                sort_desc?: boolean;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Prediction trades matching filters */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PredictionTradeResponse"][];
+                };
+            };
+        };
+    };
+    get_market_volume_chart: {
+        parameters: {
+            query: {
+                /** @description Market condition ID (required) */
+                condition_id: 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;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Volume breakdown by YES/NO over time */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MarketVolumeChartResponse"];
+                };
+            };
+        };
+    };
+    get_market: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Market condition ID */
+                condition_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Market details by condition ID */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    search: {
+        parameters: {
+            query: {
+                /** @description Search query (min 2 characters) */
+                q: string;
+                /** @description Results limit (default: 20) */
+                limit?: number;
+                /** @description Offset-based pagination key (integer offset into result set) */
+                pagination_key?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Search results with events and traders */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SearchResponse"];
+                };
+            };
+        };
+    };
+    get_series_list: {
+        parameters: {
+            query?: {
+                /** @description Only active series (default: true) */
+                active_only?: boolean;
+                /** @description Results limit (default: 10) */
+                limit?: number;
+                /** @description Cursor for pagination: id of the last series from the previous page */
+                pagination_key?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of prediction market series */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PolymarketSeries"][];
+                };
+            };
+        };
+    };
+    get_series_by_id: {
+        parameters: {
+            query?: {
+                /** @description Return minimal data without events (default: false) */
+                slim?: boolean;
+                /** @description Events to include (default: 20, max: 100) */
+                event_limit?: number;
+                /** @description Event pagination offset */
+                event_offset?: number;
+            };
+            header?: never;
+            path: {
+                /** @description Series slug or ID */
+                identifier: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Series details with events and tags */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SeriesFullResponse"];
+                };
+            };
+            /** @description Series not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_series_events: {
+        parameters: {
+            query?: {
+                /** @description Only active events (default: false) */
+                active_only?: boolean;
+                /** @description Include tags array (default: true) */
+                include_tags?: boolean;
+                /** @description Include markets array with outcomes (default: true) */
+                include_markets?: boolean;
+                /** @description Include metrics object with all timeframes (default: true) */
+                include_metrics?: boolean;
+                /** @description Results limit (default: 10) */
+                limit?: number;
+                /** @description Offset-based pagination key (integer offset into result set) */
+                pagination_key?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Series slug or ID */
+                identifier: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Events belonging to this series with nested tags and markets */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PolymarketEvent"][];
+                };
+            };
+        };
+    };
+    get_tags: {
+        parameters: {
+            query?: {
+                /** @description Results limit (default: 10, max: 250) */
+                limit?: number;
+                /** @description Cursor-based pagination key (base64-encoded, obtained from previous response's pagination.pagination_key) */
+                pagination_key?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description List of all tags */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PolymarketTag"][];
+                };
+            };
+        };
+    };
+    get_tag_by_id: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Tag ID or slug */
+                identifier: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Tag details */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PolymarketTag"];
+                };
+            };
+            /** @description Tag not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_global_pnl: {
+        parameters: {
+            query?: {
+                /** @description Timeframe: 1d, 7d, 30d (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) */
+                sort_by?: components["schemas"]["GlobalPnlSortBy"];
+                /** @description Sort direction: asc, desc (default: desc) */
+                sort_direction?: components["schemas"]["SortDirection"];
+                /** @description Results limit (default: 10, max: 200) */
+                limit?: number;
+                /** @description Cursor-based pagination key (base64-encoded, obtained from previous response's pagination.pagination_key) */
+                pagination_key?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Global PnL leaderboard with trader stats */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GlobalPnlTrader"][];
+                };
+            };
+        };
+    };
+    get_trader_pnl: {
+        parameters: {
+            query?: {
+                /** @description Timeframe: 1d, 7d, 30d, lifetime (default: 7d) */
+                timeframe?: components["schemas"]["PnlTimeframe"];
+            };
+            header?: never;
+            path: {
+                /** @description Trader wallet address */
+                address: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Trader's global PnL summary */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Trader not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_trader_pnl_candles: {
+        parameters: {
+            query?: {
+                /** @description Candle resolution: 1m, 1h, 1d (default: 1h) */
+                resolution?: components["schemas"]["PnlCandleResolution"];
+                /** @description Start timestamp (Unix seconds) */
+                start_ts?: number;
+                /** @description End timestamp (Unix seconds) */
+                end_ts?: number;
+                /** @description Results limit (default: 1440, max: 10000) */
+                limit?: number;
+            };
+            header?: never;
+            path: {
+                /** @description Trader wallet address */
+                address: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description PnL candles for equity curve charting */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_trader_event_pnl: {
+        parameters: {
+            query?: {
+                /** @description Timeframe: 1d, 7d, 30d, lifetime (default: 7d) */
+                timeframe?: components["schemas"]["PnlTimeframe"];
+                /** @description Sort: realized_pnl_usd, total_volume_usd, markets_traded, total_fees (default: realized_pnl_usd) */
+                sort_by?: components["schemas"]["EventPnlSortBy"];
+                /** @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 event slug */
+                event_slug?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Trader wallet address */
+                address: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Event-level PnL entries for this trader */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_trader_market_pnl: {
+        parameters: {
+            query?: {
+                /** @description Timeframe: 1d, 7d, 30d, lifetime (default: 7d) */
+                timeframe?: components["schemas"]["PnlTimeframe"];
+                /** @description Sort: realized_pnl_usd, buy_usd, total_buys, total_fees, outcomes_traded (default: realized_pnl_usd) */
+                sort_by?: components["schemas"]["MarketPnlSortBy"];
+                /** @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 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 */
+            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 */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_portfolio_positions: {
+        parameters: {
+            query?: {
+                /** @description Position status: active, resolved, all (default: all) */
+                status?: components["schemas"]["PositionStatus"];
+                /** @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) */
+                limit?: number;
+                /** @description Offset-based pagination key (integer offset into result set) */
+                pagination_key?: number;
+            };
+            header?: never;
+            path: {
+                /** @description Trader wallet address */
+                address: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Trader positions with market metadata */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_trader_profile: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Trader wallet address */
+                address: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Trader profile information with username, bio, and badges */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Profile not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_trader_profiles_batch: {
+        parameters: {
+            query: {
+                /** @description Comma-separated list of trader addresses (max: 20) */
+                addresses: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Map of trader addresses to their profile information */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid request (empty addresses or more than 20) */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_trader_trades: {
+        parameters: {
+            query?: {
+                /** @description Comma-separated condition IDs (max 20) */
+                condition_ids?: string;
+                /** @description Comma-separated market slugs */
+                slugs?: string;
+                /** @description Comma-separated position IDs */
+                position_ids?: string;
+                /** @description 0 = Buy, 1 = Sell */
+                side?: number;
+                /** @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 Min USD amount */
+                min_usd_amount?: number;
+                /** @description Max USD amount */
+                max_usd_amount?: number;
+                /** @description Min shares amount */
+                min_shares_amount?: number;
+                /** @description Max shares amount */
+                max_shares_amount?: number;
+                /** @description Min price (0.0-1.0) */
+                min_price?: number;
+                /** @description Max price (0.0-1.0) */
+                max_price?: number;
+                /** @description Start timestamp (ms) */
+                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 Offset-based pagination key (integer offset into result set) */
+                pagination_key?: number;
+                /** @description Sort newest first (default: true) */
+                sort_desc?: boolean;
+            };
+            header?: never;
+            path: {
+                /** @description Trader wallet address */
+                address: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Trader's trade history with advanced filtering (same as /market/trades but filtered by trader) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PredictionTradeResponse"][];
+                };
+            };
+        };
+    };
+    get_trader_volume_chart: {
+        parameters: {
+            query?: {
+                /** @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;
+            };
+            header?: never;
+            path: {
+                /** @description Trader wallet address */
+                address: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Trader volume with buy/sell breakdown over time */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TraderVolumeChartResponse"];
+                };
+            };
+        };
+    };
+}