@structbuild/sdk 0.1.20 → 0.1.22

package/dist/generated/polymarket.d.ts

@@ -152,7 +152,7 @@ export interface paths {
         };
         /**
          * Get market holders
-         * @description Retrieve holders of a market grouped by outcome, sorted by shares held. Identify the market with either `condition_id` or `market_slug` — exactly one must be provided. Each holder includes a nested `pnl` object with position-level PnL sourced from the position PnL table.
+         * @description Retrieve holders of a market grouped by outcome, sorted by shares held. Identify the market with either `condition_id` or `market_slug` — exactly one must be provided. Each holder includes a nested `pnl` object with position-level PnL.
          */
         get: operations["get_market_holders"];
         put?: never;
@@ -192,7 +192,7 @@ export interface paths {
         };
         /**
          * Get position holders
-         * @description Retrieve holders of a specific position (ERC1155 token), sorted by shares held. Each holder includes a nested `pnl` object with position-level PnL (realized_pnl_usd, buy_usd, sell_usd, avg_entry_price, avg_exit_price, total_buys, total_sells, total_fees, first/last_trade_at) sourced from the position PnL table — no extra joins required at query time. Uses cursor-based pagination for efficient traversal.
+         * @description Retrieve holders of a specific position (ERC1155 token), sorted by shares held. Each holder includes a nested `pnl` object with position-level PnL (realized_pnl_usd, buy_usd, sell_usd, avg_entry_price, avg_exit_price, total_buys, total_sells, total_fees, first/last_trade_at). Uses cursor-based pagination for efficient traversal.
          */
         get: operations["get_position_holders"];
         put?: never;
@@ -491,8 +491,14 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Search events or traders
-         * @description Search across events and traders by keyword
+         * Search events, markets, and traders
+         * @description Search across events, markets, and traders simultaneously.
+         *
+         *     All three categories are queried in parallel. Each has independent cursor-based pagination via its own `*_pagination_key`.
+         *
+         *     **Trader search** matches by wallet address (exact, `0x...` 42 chars) or by display name / pseudonym (case-insensitive partial match).
+         *
+         *     **sort_by / timeframe** apply to events and markets. Some sort fields only apply to one category (e.g. `liquidity` and `holders` are markets-only; `title`, `creation_date`, `start_date`, `end_date` are events-only) — unrecognised fields fall back to `volume`.
          */
         get: operations["search"];
         put?: never;
@@ -1137,16 +1143,22 @@ export interface components {
                 [key: string]: components["schemas"]["OutcomeTimeframeMetrics"];
             };
         };
-        /** @description Market outcome with price/volume data */
+        /** @description Outcome for market API responses */
         MarketOutcome: {
-            /** Format: int32 */
-            index: number;
+            /** @default  */
             name: string;
-            position_id: string;
-            /** Format: double */
-            price?: number | null;
-            /** Format: double */
-            volume?: number | null;
+            /**
+             * Format: double
+             * @default null
+             */
+            price: number | null;
+            /** @default null */
+            position_id: string | null;
+            /**
+             * Format: int32
+             * @default null
+             */
+            outcome_index: number | null;
         };
         /** @enum {string} */
         MarketPnlSortBy: "realized_pnl_usd" | "buy_usd" | "total_buys" | "total_fees" | "outcomes_traded";
@@ -1343,6 +1355,13 @@ export interface components {
              */
             price_change_percent: number | null;
         };
+        /** @description Pagination metadata to include in API responses */
+        PaginationMeta: {
+            /** @description Whether there are more results available */
+            has_more: boolean;
+            /** @description Pagination key for the next page (if has_more is true) */
+            pagination_key?: string | null;
+        };
         /** @description A single PnL candle entry */
         PnlCandleEntry: {
             /**
@@ -1691,8 +1710,17 @@ export interface components {
         };
         SearchResponse: {
             events: unknown;
+            events_pagination: components["schemas"]["PaginationMeta"];
+            markets: components["schemas"]["MarketResponse"][];
+            markets_pagination: components["schemas"]["PaginationMeta"];
             traders: components["schemas"]["Trader"][];
+            traders_pagination: components["schemas"]["PaginationMeta"];
         };
+        /**
+         * @description Combined sort options valid for both events and markets in search
+         * @enum {string}
+         */
+        SearchSortBy: "volume" | "txns" | "unique_traders" | "relevance" | "title" | "creation_date" | "start_date" | "end_date" | "liquidity" | "holders" | "end_time" | "start_time" | "created_time";
         SimpleTimeframeMetrics: {
             /**
              * Format: double
@@ -2238,7 +2266,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Market holder count history with automatic view selection (1m/5m/15m/1h/6h buckets) */
+            /** @description Market holder count history with automatic granularity (1m/5m/15m/1h/6h buckets) */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2312,7 +2340,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Position holder count history with automatic view selection (1m/5m/15m/1h/6h buckets) */
+            /** @description Position holder count history with automatic granularity (1m/5m/15m/1h/6h buckets) */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2343,7 +2371,7 @@ export interface operations {
                 market_slugs?: string;
                 /** @description Filter by event slug(s) - comma-separated (max 50) */
                 event_slugs?: string;
-                /** @description Filter by position ID(s) - comma-separated (max 50), resolved via market_outcomes table */
+                /** @description Filter by position ID(s) - comma-separated (max 50) */
                 position_ids?: string;
                 /** @description Search in title (3-100 characters) */
                 search?: string;
@@ -2857,12 +2885,22 @@ export interface operations {
     search: {
         parameters: {
             query: {
-                /** @description Search query (min 2 characters) */
+                /** @description Search query (min 2 characters). Prefix with 0x for exact wallet address lookup. */
                 q: string;
-                /** @description Results limit (default: 20) */
+                /** @description Sort field applied to both events and markets (default: volume). Fields marked events-only or markets-only fall back to volume on the other category. */
+                sort_by?: components["schemas"]["SearchSortBy"];
+                /** @description Sort direction (default: desc) */
+                sort_dir?: components["schemas"]["SortDirection"];
+                /** @description Metrics timeframe used for volume/txns/unique_traders sort (default: 24h) */
+                timeframe?: components["schemas"]["MetricsTimeframe"];
+                /** @description Results limit per category (default: 10, max: 250) */
                 limit?: number;
-                /** @description Offset-based pagination key (integer offset into result set) */
-                pagination_key?: string;
+                /** @description Cursor for the next page of events, obtained from previous response's events_pagination.pagination_key */
+                events_pagination_key?: string;
+                /** @description Cursor for the next page of markets, obtained from previous response's markets_pagination.pagination_key */
+                markets_pagination_key?: string;
+                /** @description Cursor for the next page of traders, obtained from previous response's traders_pagination.pagination_key */
+                traders_pagination_key?: string;
             };
             header?: never;
             path?: never;
@@ -2870,7 +2908,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Search results with events and traders */
+            /** @description Search results with events, markets, and traders */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2879,6 +2917,13 @@ export interface operations {
                     "application/json": components["schemas"]["SearchResponse"];
                 };
             };
+            /** @description Bad request — q is missing or shorter than 2 characters */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
     };
     get_series_list: {