@structbuild/sdk 0.2.4 → 0.2.6

package/dist/generated/polymarket.d.ts

@@ -11,8 +11,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get asset price history
-         * @description Retrieve historical OHLC-style price data for a supported crypto asset (BTC, ETH, XRP, SOL, DOGE, BNB, HYPE) over a chosen time window variant. Timestamps are Unix seconds. Response includes `pagination: { has_more, pagination_key }` for cursor-based pagination — pass `pagination_key` from the previous response to fetch the next page.
+         * Get Asset Price History
+         * @description Returns historical price data for supported crypto assets from Polymarket API
          */
         get: operations["get_asset_history"];
         put?: never;
@@ -572,7 +572,7 @@ export interface paths {
         };
         /**
          * Search events, markets, and traders
-         * @description Search across markets, events, and traders. Trader search supports wallet address lookup or name search. Results for each category are independently paginated.
+         * @description Search across markets, events, and traders. Use `type` to limit which categories are searched. Trader search supports wallet address lookup or name search. Results for each category are independently paginated. Only requested categories are included in the response.
          */
         get: operations["search"];
         put?: never;
@@ -1545,7 +1545,7 @@ export interface components {
         PnlCandleEntry: {
             /**
              * Format: int64
-             * @description Timestamp in epoch milliseconds (start of bucket window)
+             * @description Timestamp in epoch seconds (start of bucket window)
              */
             t: number;
             /**
@@ -1820,12 +1820,13 @@ export interface components {
             confirmed_at: number;
             trader: components["schemas"]["TraderInfo"];
             taker: string;
-            side: string;
+            side?: string | null;
             condition_id?: string | null;
             outcome?: string | null;
             /** Format: int32 */
             outcome_index?: number | null;
             question?: string | null;
+            image_url?: string | null;
             slug?: string | null;
             /** Format: double */
             usd_amount: number;
@@ -1863,12 +1864,12 @@ export interface components {
             condition_id: string;
         };
         SearchResponse: {
-            events: components["schemas"]["PolymarketEvent"][];
-            events_pagination: components["schemas"]["PaginationMeta"];
-            markets: components["schemas"]["MarketResponse"][];
-            markets_pagination: components["schemas"]["PaginationMeta"];
-            traders: components["schemas"]["Trader"][];
-            traders_pagination: components["schemas"]["PaginationMeta"];
+            events?: components["schemas"]["PolymarketEvent"][] | null;
+            events_pagination?: null | components["schemas"]["PaginationMeta"];
+            markets?: components["schemas"]["MarketResponse"][] | null;
+            markets_pagination?: null | components["schemas"]["PaginationMeta"];
+            traders?: components["schemas"]["TraderWithPnl"][] | null;
+            traders_pagination?: null | components["schemas"]["PaginationMeta"];
         };
         /**
          * @description Combined sort options valid for both events and markets in search
@@ -2091,6 +2092,11 @@ export interface components {
              * @description Last traded price for this outcome (0–1). NULL if market_outcomes has no price yet.
              */
             current_price?: number | null;
+            /**
+             * Format: double
+             * @description Current shares held: balance / 1e6.
+             */
+            current_shares_balance?: number | null;
             /**
              * Format: double
              * @description Estimated current USD value of held shares: (balance / 1e6) * current_price.
@@ -2104,6 +2110,58 @@ export interface components {
              */
             realized_pnl_pct?: number | null;
         };
+        /** @description Trader's global PnL summary (single trader) */
+        TraderPnlSummary: {
+            trader?: string | null;
+            /** Format: double */
+            realized_pnl_usd?: number | null;
+            /** Format: int64 */
+            events_traded?: number | null;
+            /** Format: int64 */
+            markets_traded?: 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: 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 */
+            markets_won?: number | null;
+            /** Format: int64 */
+            markets_lost?: number | null;
+            /** Format: double */
+            market_win_rate_pct?: number | null;
+            /** Format: double */
+            avg_pnl_per_market?: number | null;
+            /** Format: double */
+            avg_pnl_per_trade?: number | null;
+            /** Format: double */
+            avg_hold_time_seconds?: number | null;
+            /** Format: double */
+            total_fees?: number | null;
+            /** Format: double */
+            best_trade_pnl_usd?: number | null;
+            best_trade_condition_id?: string | null;
+            /** Format: double */
+            worst_trade_pnl_usd?: number | null;
+            worst_trade_condition_id?: string | null;
+            /** Format: int64 */
+            first_trade_at?: number | null;
+            /** Format: int64 */
+            last_trade_at?: number | null;
+        };
         TraderVolumeChartResponse: {
             volumes: components["schemas"]["TraderVolumeDataPoint"][];
             has_more: boolean;
@@ -2124,6 +2182,9 @@ export interface components {
             /** Format: int32 */
             stc: number;
         };
+        TraderWithPnl: components["schemas"]["Trader"] & {
+            pnl?: null | components["schemas"]["TraderPnlSummary"];
+        };
         /**
          * @description Crypto asset symbols accepted by `asset_price_tick` and `asset_price_window_update` filters.
          * @enum {string}
@@ -2146,18 +2207,25 @@ export interface operations {
     get_asset_history: {
         parameters: {
             query: {
-                /** @description Asset ticker: BTC, ETH, XRP, SOL, DOGE, BNB, or HYPE */
-                asset_symbol: components["schemas"]["AssetSymbol"];
-                /** @description Time window: 5m, 15m, 1h, 4h, or 1d */
-                variant: components["schemas"]["AssetVariant"];
-                /** @description Start timestamp (Unix seconds, inclusive) */
+                /**
+                 * @description Asset ticker: BTC, ETH, XRP, SOL, DOGE, BNB, HYPE
+                 * @example BTC
+                 */
+                asset_symbol: string;
+                /**
+                 * @description Time window: 5m, 15m, 1h, 4h, 1d
+                 * @example 1h
+                 */
+                variant: string;
+                /** @description Start timestamp in seconds (Unix epoch, inclusive) */
                 from?: number;
-                /** @description End timestamp (Unix seconds, inclusive, defaults to now) */
+                /** @description End timestamp in seconds (Unix epoch, inclusive) */
                 to?: number;
-                /** @description Number of results (default: 10, max: 100) */
+                /**
+                 * @description Number of results (default: 10, max: 100)
+                 * @example 10
+                 */
                 limit?: number;
-                /** @description Cursor-based pagination key Obtained from previous response's `pagination.pagination_key`. Pass this to fetch the next page of results. */
-                pagination_key?: string;
             };
             header?: never;
             path?: never;
@@ -2165,7 +2233,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Asset price history records, sorted newest first. Response includes `pagination: { has_more, pagination_key }` for cursor-based pagination. */
+            /** @description Successful response */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -2174,13 +2242,20 @@ export interface operations {
                     "application/json": components["schemas"]["AssetPriceHistoryRow"][];
                 };
             };
-            /** @description Missing or invalid asset_symbol / variant */
+            /** @description Bad request - missing or invalid parameters */
             400: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
     };
     get_events: {
@@ -2316,13 +2391,6 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Event metrics not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
         };
     };
     get_event_outcomes: {
@@ -2452,7 +2520,7 @@ export interface operations {
                 min_shares?: string;
                 /** @description Maximum shares held (decimal string) */
                 max_shares?: string;
-                /** @description Include nested holder PnL data (default: false) */
+                /** @description Include nested holder PnL data (default: false, +1 credit) */
                 include_pnl?: boolean;
                 /** @description Return truncated response optimized for AI consumers (default: false) */
                 ai?: boolean;
@@ -2526,7 +2594,7 @@ export interface operations {
                 min_shares?: string;
                 /** @description Maximum shares held (decimal string) */
                 max_shares?: string;
-                /** @description Include nested holder PnL data (default: false) */
+                /** @description Include nested holder PnL data (default: false, +1 credit) */
                 include_pnl?: boolean;
                 /** @description Return truncated response optimized for AI consumers (default: false) */
                 ai?: boolean;
@@ -2804,13 +2872,6 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Market metrics not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
         };
     };
     get_position_candlestick: {
@@ -2874,13 +2935,6 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Position metrics not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
         };
     };
     get_position_volume_chart: {
@@ -3265,13 +3319,6 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description No snapshot found for this position */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
         };
     };
     get_order_book_history: {
@@ -3400,13 +3447,6 @@ export interface operations {
                 };
                 content?: never;
             };
-            /** @description Market not found or no snapshots exist */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
         };
     };
     get_spread_history: {
@@ -3483,6 +3523,10 @@ export interface operations {
             query: {
                 /** @description Search query (min 2 characters). Prefix with 0x for exact wallet address lookup. */
                 q: string;
+                /** @description Comma-separated categories to search: events, markets, traders (default: all three, 1 credit per type). Example: type=markets,traders */
+                type?: string;
+                /** @description Include lifetime PnL summary for each trader (default: false, +1 credit) */
+                include_pnl?: boolean;
                 /** @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) */
@@ -3504,7 +3548,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Search results with events, markets, and traders */
+            /** @description Search results. Only requested categories (via `type`) are included in the response. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -3656,7 +3700,7 @@ export interface operations {
     get_global_pnl: {
         parameters: {
             query?: {
-                /** @description Timeframe: 1d, 7d, 30d, lifetime (default: 7d) */
+                /** @description Timeframe: 1d, 7d, 30d, lifetime (default: lifetime) */
                 timeframe?: components["schemas"]["PnlTimeframe"];
                 /** @description Sort: pnl_usd, buys, sells, redemptions, merges, avg_hold_time, markets_traded, events_traded, markets_won, volume_usd, fees, best_trade, worst_trade (default: pnl_usd) */
                 sort_by?: components["schemas"]["GlobalPnlSortBy"];
@@ -3687,7 +3731,7 @@ export interface operations {
     get_trader_pnl: {
         parameters: {
             query?: {
-                /** @description Timeframe: 1d, 7d, 30d, lifetime (default: 7d) */
+                /** @description Timeframe: 1d, 7d, 30d, lifetime (default: lifetime) */
                 timeframe?: components["schemas"]["PnlTimeframe"];
             };
             header?: never;
@@ -3705,16 +3749,9 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["GlobalPnlTrader"];
+                    "application/json": components["schemas"]["TraderPnlSummary"];
                 };
             };
-            /** @description Trader not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
         };
     };
     get_trader_pnl_calendar: {
@@ -3776,7 +3813,7 @@ export interface operations {
     get_trader_event_pnl: {
         parameters: {
             query?: {
-                /** @description Timeframe: 1d, 7d, 30d, lifetime (default: 7d) */
+                /** @description Timeframe: 1d, 7d, 30d, lifetime (default: lifetime) */
                 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"];
@@ -3784,7 +3821,9 @@ export interface operations {
                 sort_direction?: components["schemas"]["SortDirection"];
                 /** @description Results limit (default: 10, max: 200) */
                 limit?: number;
-                /** @description Cursor-based pagination key */
+                /** @description Pagination offset (number of results to skip). Takes precedence over pagination_key. */
+                offset?: number;
+                /** @description Cursor-based pagination key obtained from previous response's pagination.pagination_key */
                 pagination_key?: string;
                 /** @description Filter by event slug */
                 event_slug?: string;
@@ -3812,7 +3851,7 @@ export interface operations {
     get_trader_market_pnl: {
         parameters: {
             query?: {
-                /** @description Timeframe: 1d, 7d, 30d, lifetime (default: 7d) */
+                /** @description Timeframe: 1d, 7d, 30d, lifetime (default: lifetime) */
                 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"];
@@ -3820,7 +3859,9 @@ export interface operations {
                 sort_direction?: components["schemas"]["SortDirection"];
                 /** @description Results limit (default: 10, max: 200) */
                 limit?: number;
-                /** @description Cursor-based pagination key */
+                /** @description Pagination offset (number of results to skip). Takes precedence over pagination_key. */
+                offset?: number;
+                /** @description Cursor-based pagination key obtained from previous response's pagination.pagination_key */
                 pagination_key?: string;
                 /** @description Filter by condition ID (or use market_slug) */
                 condition_id?: string;
@@ -3914,13 +3955,6 @@ export interface operations {
                     "application/json": components["schemas"]["PolymarketUserProfile"];
                 };
             };
-            /** @description Profile not found */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content?: never;
-            };
         };
     };
     get_trader_profiles_batch: {
@@ -3990,8 +4024,10 @@ export interface operations {
                 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 Pagination offset (number of results to skip). Takes precedence over pagination_key. */
+                offset?: number;
+                /** @description Cursor-based pagination key obtained from previous response's pagination.pagination_key */
+                pagination_key?: string;
                 /** @description Sort newest first (default: true) */
                 sort_desc?: boolean;
                 /** @description Return truncated response optimized for AI consumers (default: false) */

package/dist/types/index.d.ts

@@ -62,6 +62,8 @@ export type TraderInfo = Schemas["TraderInfo"];
 export type TraderVolumeChartResponse = Schemas["TraderVolumeChartResponse"];
 export type TraderOutcomePnlEntry = Schemas["TraderOutcomePnlEntry"];
 export type TraderVolumeDataPoint = Schemas["TraderVolumeDataPoint"];
+export type TraderPnlSummary = Schemas["TraderPnlSummary"];
+export type TraderWithPnl = Schemas["TraderWithPnl"];
 export type PositionPnlSortBy = Schemas["PositionPnlSortBy"];
 export type EventMarketChartOutcome = Schemas["EventMarketChartOutcome"];
 export type PositionChartOutcome = Schemas["PositionChartOutcome"];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@structbuild/sdk",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",