@structbuild/sdk 0.1.18 → 0.1.20

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

@@ -103,6 +103,46 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/polymarket/events/slug/{slug}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get event by slug
+         * @description Retrieve a single event by its slug with optional nested tags, markets, and metrics
+         */
+        get: operations["get_event_by_slug"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/polymarket/events/{identifier}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get event by ID or slug
+         * @description Retrieve a single event by its numeric ID or slug with optional nested tags, markets, and metrics
+         */
+        get: operations["get_event"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/polymarket/holders/markets": {
         parameters: {
             query?: never;
@@ -363,7 +403,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/market/trades": {
+    "/polymarket/market/slug/{slug}": {
         parameters: {
             query?: never;
             header?: never;
@@ -371,10 +411,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get market trades
-         * @description Retrieve trades for one or more markets, with filtering by trader, side, price, amount, and time range
+         * Get market by slug
+         * @description Retrieve a single market by its slug with optional nested tags, event, and metrics
          */
-        get: operations["get_market_trades"];
+        get: operations["get_market_by_slug"];
         put?: never;
         post?: never;
         delete?: never;
@@ -383,7 +423,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/market/volume-chart": {
+    "/polymarket/market/trades": {
         parameters: {
             query?: never;
             header?: never;
@@ -391,10 +431,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get market volume chart
-         * @description Retrieve volume breakdown by YES/NO outcome over time for a prediction market
+         * 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_volume_chart"];
+        get: operations["get_market_trades"];
         put?: never;
         post?: never;
         delete?: never;
@@ -403,7 +443,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/search": {
+    "/polymarket/market/volume-chart": {
         parameters: {
             query?: never;
             header?: never;
@@ -411,10 +451,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Search events or traders
-         * @description Search across events and traders by keyword
+         * Get market volume chart
+         * @description Retrieve volume breakdown by YES/NO outcome over time for a prediction market
          */
-        get: operations["search"];
+        get: operations["get_market_volume_chart"];
         put?: never;
         post?: never;
         delete?: never;
@@ -423,7 +463,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/series": {
+    "/polymarket/market/{condition_id}": {
         parameters: {
             query?: never;
             header?: never;
@@ -431,10 +471,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get series
-         * @description Retrieve a paginated list of event series
+         * Get market by condition ID
+         * @description Retrieve a single market by its condition ID with optional nested tags, event, and metrics
          */
-        get: operations["get_series_list"];
+        get: operations["get_market"];
         put?: never;
         post?: never;
         delete?: never;
@@ -443,7 +483,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/series/outcomes": {
+    "/polymarket/search": {
         parameters: {
             query?: never;
             header?: never;
@@ -451,10 +491,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get series market outcomes
-         * @description Returns the winning outcome name for each resolved market across all events in a series, keyed by market slug. Useful for checking historical results across recurring series (e.g., btc-updown-5m).
+         * Search events or traders
+         * @description Search across events and traders by keyword
          */
-        get: operations["get_series_outcomes"];
+        get: operations["search"];
         put?: never;
         post?: never;
         delete?: never;
@@ -463,7 +503,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/series/{identifier}": {
+    "/polymarket/series": {
         parameters: {
             query?: never;
             header?: never;
@@ -471,10 +511,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get series by ID
-         * @description Retrieve a single series by its ID or slug
+         * 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_by_id"];
+        get: operations["get_series_list"];
         put?: never;
         post?: never;
         delete?: never;
@@ -483,7 +523,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/series/{identifier}/events": {
+    "/polymarket/series/outcomes": {
         parameters: {
             query?: never;
             header?: never;
@@ -491,10 +531,10 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get events from series
-         * @description Retrieve all events belonging to a specific series
+         * Get series market outcomes
+         * @description Returns the winning outcome name for each resolved market across all events in a series, keyed by market slug. Useful for checking historical results across recurring series (e.g., btc-updown-5m).
          */
-        get: operations["get_series_events"];
+        get: operations["get_series_outcomes"];
         put?: never;
         post?: never;
         delete?: never;
@@ -1653,25 +1693,6 @@ export interface components {
             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
@@ -1956,6 +1977,8 @@ export interface operations {
                 limit?: number;
                 /** @description Cursor-based pagination key */
                 pagination_key?: string;
+                /** @description Return truncated response optimized for AI consumers (default: false) */
+                ai?: boolean;
             };
             header?: never;
             path?: never;
@@ -2081,6 +2104,84 @@ export interface operations {
             };
         };
     };
+    get_event_by_slug: {
+        parameters: {
+            query?: {
+                /** @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 Return truncated response optimized for AI consumers (default: false) */
+                ai?: boolean;
+            };
+            header?: never;
+            path: {
+                /** @description Event slug */
+                slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Event with nested tags, markets, and series */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PolymarketEvent"];
+                };
+            };
+            /** @description Event not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    get_event: {
+        parameters: {
+            query?: {
+                /** @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 Return truncated response optimized for AI consumers (default: false) */
+                ai?: boolean;
+            };
+            header?: never;
+            path: {
+                /** @description Event ID or slug */
+                identifier: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Event with nested tags, markets, and series */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PolymarketEvent"];
+                };
+            };
+            /** @description Event not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     get_market_holders: {
         parameters: {
             query?: {
@@ -2094,6 +2195,8 @@ export interface operations {
                 min_shares?: string;
                 /** @description Maximum shares held (decimal string) */
                 max_shares?: string;
+                /** @description Return truncated response optimized for AI consumers (default: false) */
+                ai?: boolean;
             };
             header?: never;
             path?: never;
@@ -2164,6 +2267,8 @@ export interface operations {
                 min_shares?: string;
                 /** @description Maximum shares held (decimal string) */
                 max_shares?: string;
+                /** @description Return truncated response optimized for AI consumers (default: false) */
+                ai?: boolean;
             };
             header?: never;
             path: {
@@ -2292,6 +2397,8 @@ export interface operations {
                 limit?: number;
                 /** @description Cursor-based pagination key */
                 pagination_key?: string;
+                /** @description Return truncated response optimized for AI consumers (default: false) */
+                ai?: boolean;
             };
             header?: never;
             path?: never;
@@ -2577,6 +2684,43 @@ export interface operations {
             };
         };
     };
+    get_market_by_slug: {
+        parameters: {
+            query?: {
+                /** @description Include tags array (default: true) */
+                include_tags?: boolean;
+                /** @description Include event object (default: true) */
+                include_event?: boolean;
+                /** @description Include all timeframe metrics (default: true) */
+                include_metrics?: boolean;
+                /** @description Return truncated response optimized for AI consumers (default: false) */
+                ai?: boolean;
+            };
+            header?: never;
+            path: {
+                /** @description Market slug (e.g. `will-trump-win`) */
+                slug: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Market with metadata, outcomes, tags, event, and metrics */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Market not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     get_market_trades: {
         parameters: {
             query?: {
@@ -2620,6 +2764,8 @@ export interface operations {
                 pagination_key?: number;
                 /** @description Sort newest first (default: true) */
                 sort_desc?: boolean;
+                /** @description Return truncated response optimized for AI consumers (default: false) */
+                ai?: boolean;
             };
             header?: never;
             path?: never;
@@ -2671,6 +2817,43 @@ export interface operations {
             };
         };
     };
+    get_market: {
+        parameters: {
+            query?: {
+                /** @description Include tags array (default: true) */
+                include_tags?: boolean;
+                /** @description Include event object (default: true) */
+                include_event?: boolean;
+                /** @description Include all timeframe metrics (default: true) */
+                include_metrics?: boolean;
+                /** @description Return truncated response optimized for AI consumers (default: false) */
+                ai?: boolean;
+            };
+            header?: never;
+            path: {
+                /** @description Market condition ID (0x-prefixed hex) */
+                condition_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Market with metadata, outcomes, tags, event, and metrics */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Market not found */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     search: {
         parameters: {
             query: {
@@ -2701,9 +2884,15 @@ export interface operations {
     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;
@@ -2714,7 +2903,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description List of prediction market series */
+            /** @description Series or list of series */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2723,6 +2912,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: {
@@ -2757,79 +2953,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?: {
@@ -3198,6 +3321,8 @@ export interface operations {
                 pagination_key?: number;
                 /** @description Sort newest first (default: true) */
                 sort_desc?: boolean;
+                /** @description Return truncated response optimized for AI consumers (default: false) */
+                ai?: boolean;
             };
             header?: never;
             path: {