@structbuild/sdk 0.1.19 → 0.1.21

package/README.md

@@ -89,8 +89,7 @@ const history = await client.holders.getMarketHoldersHistory({ condition_id: "0x
 
 ```typescript
 const series = await client.series.getSeriesList();
-const detail = await client.series.getSeriesDetail({ identifier: "my-series" });
-const seriesEvents = await client.series.getSeriesEvents({ identifier: "my-series" });
+const outcomes = await client.series.getSeriesOutcomes({ series_slug: "my-series" });
 ```
 
 ### Search, Tags, Bonds

package/dist/generated/polymarket.d.ts

@@ -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 (ILIKE).
+         *
+         *     **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;
@@ -511,8 +517,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get series
-         * @description Retrieve a paginated list of event series
+         * List or get series
+         * @description Retrieve series. Use `id` or `series_slug` for single lookup, `series_ids` or `series_slugs` (comma-separated, max 250, mutually exclusive) for multi-lookup, or paginate with `active_only`.
          */
         get: operations["get_series_list"];
         put?: never;
@@ -543,46 +549,6 @@ export interface paths {
         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;
@@ -1177,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";
@@ -1383,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: {
             /**
@@ -1731,27 +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"];
         };
-        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"][];
-        };
+        /**
+         * @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
@@ -2916,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;
@@ -2929,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;
@@ -2938,14 +2917,27 @@ 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: {
         parameters: {
             query?: {
-                /** @description Only active series (default: true) */
+                /** @description Single series ID for direct lookup */
+                id?: string;
+                /** @description Comma-separated series IDs (max 250). Mutually exclusive with series_slugs. */
+                series_ids?: string;
+                /** @description Comma-separated series slugs (max 250). Mutually exclusive with series_ids. */
+                series_slugs?: string;
+                /** @description Only active series (default: true). Ignored when series_ids or series_slugs are provided. */
                 active_only?: boolean;
-                /** @description Results limit (default: 10) */
+                /** @description Results limit (default: 10, max: 250) */
                 limit?: number;
                 /** @description Cursor for pagination: id of the last series from the previous page */
                 pagination_key?: string;
@@ -2956,7 +2948,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description List of prediction market series */
+            /** @description Series or list of series */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2965,6 +2957,13 @@ export interface operations {
                     "application/json": components["schemas"]["PolymarketSeries"][];
                 };
             };
+            /** @description series_ids and series_slugs cannot both be provided */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
     };
     get_series_outcomes: {
@@ -2999,79 +2998,6 @@ export interface operations {
             };
         };
     };
-    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?: {