@structbuild/sdk 0.2.8 → 0.2.10

package/README.md

@@ -139,6 +139,28 @@ function handleWebhook(payload: FirstTradePayload) {
 
 Available payload types: `FirstTradePayload`, `GlobalPnlPayload`, `MarketPnlPayload`, `EventPnlPayload`, `PositionPnlPayload`, `ConditionMetricsPayload`, `EventMetricsPayload`, `PositionMetricsPayload`, `VolumeMilestonePayload`, `EventVolumeMilestonePayload`, `PositionVolumeMilestonePayload`, `ProbabilitySpikePayload`.
 
+## JWT Auth
+
+Let your end users authenticate directly using JWTs from their own auth provider (Privy, Auth0, Google, Turnkey, etc.) without exposing your `sk_*` API key client-side.
+
+Create a JWT public key (`pk_jwt_*`) in your [Struct dashboard](https://struct.to), then pass it alongside the user's JWT:
+
+```typescript
+import { StructClient, StructWebSocket } from "@structbuild/sdk";
+
+const client = new StructClient({
+  apiKey: "pk_jwt_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
+  jwt: userAccessToken,
+});
+
+const ws = new StructWebSocket({
+  apiKey: "pk_jwt_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
+  jwt: userAccessToken,
+});
+```
+
+The `pk_jwt_*` key is safe to hardcode in frontend bundles — it is useless without a valid JWT from your configured auth provider.
+
 ## Pagination
 
 Use the `paginate` helper to iterate through all results:

package/dist/generated/polymarket.d.ts

@@ -103,7 +103,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/events/slug/{slug}": {
+    "/polymarket/events/slug/{event_slug}": {
         parameters: {
             query?: never;
             header?: never;
@@ -403,7 +403,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/polymarket/market/slug/{slug}": {
+    "/polymarket/market/slug/{market_slug}": {
         parameters: {
             query?: never;
             header?: never;
@@ -961,6 +961,18 @@ export interface components {
             rewards_daily_rate?: number | null;
             start_date?: string | null;
             end_date?: string | null;
+            /** Format: double */
+            rewards_max_spread?: number | null;
+            /** Format: double */
+            rewards_min_size?: number | null;
+            /** Format: double */
+            native_daily_rate?: number | null;
+            /** Format: double */
+            sponsored_daily_rate?: number | null;
+            /** Format: double */
+            total_daily_rate?: number | null;
+            /** Format: int32 */
+            sponsors_count?: number | null;
         };
         /** @description Response type for condition metrics query */
         ConditionMetricsResponse: {
@@ -1098,12 +1110,12 @@ export interface components {
         /** @enum {string} */
         EventSortBy: "volume" | "txns" | "unique_traders" | "title" | "creation_date" | "start_date" | "end_date" | "relevance";
         /** @enum {string} */
-        GlobalPnlSortBy: "pnl_usd" | "buys" | "sells" | "redemptions" | "merges" | "avg_hold_time" | "markets_traded" | "events_traded" | "markets_won" | "volume_usd" | "fees" | "best_trade" | "worst_trade";
+        GlobalPnlSortBy: "realized_pnl_usd" | "buys" | "sells" | "redemptions" | "merges" | "avg_hold_time" | "markets_traded" | "events_traded" | "markets_won" | "volume_usd" | "fees" | "best_trade";
         /** @description Individual trader entry in the global PnL leaderboard */
         GlobalPnlTrader: {
             trader: components["schemas"]["TraderInfo"];
             /** Format: double */
-            pnl_usd?: number | null;
+            realized_pnl_usd?: number | null;
             /** Format: int64 */
             events_traded?: number | null;
             /** Format: int64 */
@@ -1145,9 +1157,6 @@ export interface components {
             /** 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 */
@@ -1828,6 +1837,7 @@ export interface components {
             question?: string | null;
             image_url?: string | null;
             slug?: string | null;
+            event_slug?: string | null;
             /** Format: double */
             usd_amount: number;
             /** Format: double */
@@ -1936,7 +1946,7 @@ export interface components {
         /** @enum {string} */
         TradeSide: "0" | "1";
         /** @enum {string} */
-        TradeType: "0" | "1" | "2" | "4" | "6";
+        TradeType: "0" | "1" | "2" | "3" | "4" | "5" | "6";
         /**
          * @description Trader profile info embedded in API responses
          *
@@ -2154,9 +2164,6 @@ export interface components {
             /** 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 */
@@ -2226,6 +2233,8 @@ export interface operations {
                  * @example 10
                  */
                 limit?: number;
+                /** @description Cursor from previous response for keyset pagination. Pass the pagination_key from the previous page to fetch the next page. */
+                pagination_key?: string;
             };
             header?: never;
             path?: never;
@@ -2444,7 +2453,7 @@ export interface operations {
             header?: never;
             path: {
                 /** @description Event slug */
-                slug: string;
+                event_slug: string;
             };
             cookie?: never;
         };
@@ -2726,6 +2735,8 @@ export interface operations {
                 limit?: number;
                 /** @description Cursor-based pagination key */
                 pagination_key?: string;
+                /** @description Only return markets that have CLOB rewards (default: false) */
+                has_rewards?: boolean;
                 /** @description Return truncated response optimized for AI consumers (default: false) */
                 ai?: boolean;
             };
@@ -3016,7 +3027,7 @@ export interface operations {
             header?: never;
             path: {
                 /** @description Market slug (e.g. `will-trump-win`) */
-                slug: string;
+                market_slug: string;
             };
             cookie?: never;
         };
@@ -3103,8 +3114,8 @@ export interface operations {
                 outcome?: string;
                 /** @description Outcome index: 0 (Yes), 1 (No) */
                 outcome_index?: components["schemas"]["OutcomeIndex"];
-                /** @description Trade type: 0 (OrderFilled), 1 (Redemption), 2 (Merge) */
-                trade_type?: components["schemas"]["TradeType"];
+                /** @description Comma-separated trade types: OrderFilled, Redemption, Merge, Split, Cancelled, PositionsConverted, OrdersMatched */
+                trade_types?: string;
                 /** @description Min USD amount */
                 min_usd_amount?: number;
                 /** @description Max USD amount */
@@ -3702,7 +3713,7 @@ export interface operations {
             query?: {
                 /** @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) */
+                /** @description Sort: realized_pnl_usd, buys, sells, redemptions, merges, avg_hold_time, markets_traded, events_traded, markets_won, volume_usd, fees, best_trade (default: realized_pnl_usd) */
                 sort_by?: components["schemas"]["GlobalPnlSortBy"];
                 /** @description Sort direction: asc, desc (default: desc) */
                 sort_direction?: components["schemas"]["SortDirection"];
@@ -3913,6 +3924,8 @@ export interface operations {
                 market_slug?: string;
                 /** @description Filter by specific outcome token (position ID) */
                 position_id?: string;
+                /** @description Minimum shares balance to include (e.g. 1.0 to filter out dust positions) */
+                min_shares?: number;
             };
             header?: never;
             path: {
@@ -4002,8 +4015,8 @@ export interface operations {
                 outcome?: string;
                 /** @description Outcome index: 0 (Yes), 1 (No) */
                 outcome_index?: components["schemas"]["OutcomeIndex"];
-                /** @description Trade type: 0 (OrderFilled), 1 (Redemption), 2 (Merge) */
-                trade_type?: components["schemas"]["TradeType"];
+                /** @description Comma-separated trade types: OrderFilled, Redemption, Merge, Split, Cancelled, PositionsConverted, OrdersMatched */
+                trade_types?: string;
                 /** @description Min USD amount */
                 min_usd_amount?: number;
                 /** @description Max USD amount */

package/dist/generated/webhooks.d.ts

@@ -924,10 +924,6 @@ export interface components {
             best_trade_pnl_usd?: number | null;
             /** @description Condition ID of the best trade */
             best_trade_condition_id?: string | null;
-            /** @description Worst single-trade PnL in USD */
-            worst_trade_pnl_usd?: number | null;
-            /** @description Condition ID of the worst trade */
-            worst_trade_condition_id?: string | null;
             /**
              * Format: int64
              * @description Timestamp of the first trade (Unix seconds)

package/package.json

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