@structbuild/sdk 0.1.6 → 0.1.7

package/README.md

@@ -101,6 +101,45 @@ const tags = await client.tags.getTags();
 const bonds = await client.bonds.getBonds();
 ```
 
+### Webhooks
+
+Manage webhook subscriptions for real-time event notifications. Webhook endpoints are platform-level (not venue-scoped).
+
+```typescript
+const webhooks = await client.webhooks.list();
+const webhook = await client.webhooks.create({
+  url: "https://example.com/webhook",
+  events: ["first_trade", "probability_spike"],
+  filters: {
+    condition_ids: ["0x..."],
+    min_usd_value: 100,
+  },
+});
+const detail = await client.webhooks.getWebhook({ webhookId: webhook.data.id });
+await client.webhooks.update({ webhookId: webhook.data.id, events: ["first_trade"] });
+await client.webhooks.test({ webhookId: webhook.data.id });
+await client.webhooks.deleteWebhook({ webhookId: webhook.data.id });
+```
+
+#### Webhook Payload Types
+
+The SDK exports typed payload schemas for building webhook receivers:
+
+```typescript
+import type {
+  FirstTradePayload,
+  ProbabilitySpikePayload,
+  GlobalPnlPayload,
+  VolumeMilestonePayload,
+} from "@structbuild/sdk";
+
+function handleWebhook(payload: FirstTradePayload) {
+  console.log(payload.trader, payload.price, payload.side);
+}
+```
+
+Available payload types: `FirstTradePayload`, `GlobalPnlPayload`, `MarketPnlPayload`, `EventPnlPayload`, `PositionPnlPayload`, `ConditionMetricsPayload`, `EventMetricsPayload`, `PositionMetricsPayload`, `VolumeMilestonePayload`, `EventVolumeMilestonePayload`, `PositionVolumeMilestonePayload`, `ProbabilitySpikePayload`.
+
 ## Pagination
 
 Use the `paginate` helper to iterate through all results:

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 import type { Venue } from "./types/common.js";
 import type { RetryConfig, RequestHookInfo, ResponseHookInfo } from "./types/index.js";
-import { HoldersNamespace, ScoringNamespace, TagsNamespace, EventsNamespace, MarketsNamespace, SeriesNamespace, TraderNamespace, BondsNamespace, SearchNamespace } from "./namespaces/index.js";
+import { HoldersNamespace, TagsNamespace, EventsNamespace, MarketsNamespace, SeriesNamespace, TraderNamespace, BondsNamespace, SearchNamespace, WebhooksNamespace } from "./namespaces/index.js";
 export interface StructClientConfig {
     apiKey: string;
     baseUrl?: string;
@@ -13,7 +13,6 @@ export interface StructClientConfig {
 }
 export declare class StructClient {
     readonly holders: HoldersNamespace;
-    readonly scoring: ScoringNamespace;
     readonly tags: TagsNamespace;
     readonly events: EventsNamespace;
     readonly markets: MarketsNamespace;
@@ -21,5 +20,6 @@ export declare class StructClient {
     readonly trader: TraderNamespace;
     readonly bonds: BondsNamespace;
     readonly search: SearchNamespace;
+    readonly webhooks: WebhooksNamespace;
     constructor(config: StructClientConfig);
 }

package/dist/generated/polymarket.d.ts

@@ -1028,7 +1028,15 @@ export interface components {
             image_url?: string | null;
             tags: string[];
             /** Format: int64 */
-            end_date?: number | null;
+            created_time?: number | null;
+            /** Format: int64 */
+            start_time?: number | null;
+            /** Format: int64 */
+            game_start_time?: number | null;
+            /** Format: int64 */
+            closed_time?: number | null;
+            /** Format: int64 */
+            end_time?: number | null;
             title?: string | null;
             id?: string | null;
             /** Format: double */
@@ -1070,7 +1078,7 @@ export interface components {
         /** @enum {string} */
         MarketPnlSortBy: "realized_pnl_usd" | "buy_usd" | "total_buys" | "total_fees" | "outcomes_traded";
         /** @enum {string} */
-        MarketSortBy: "volume" | "txns" | "unique_traders" | "liquidity" | "holders" | "end_date" | "created_at" | "relevance";
+        MarketSortBy: "volume" | "txns" | "unique_traders" | "liquidity" | "holders" | "end_time" | "start_time" | "created_time" | "created_at" | "relevance";
         /** @enum {string} */
         MarketStatus: "open" | "closed";
         MarketVolumeChartResponse: {
@@ -1244,6 +1252,8 @@ export interface components {
             neg_risk_market_id: string | null;
             /** @default null */
             game_status: string | null;
+            /** @default false */
+            show_market_images: boolean;
             /**
              * @description Event status: "open" or "closed"
              * @default null
@@ -1965,11 +1975,11 @@ export interface operations {
                 event_slugs?: string;
                 /** @description Filter by position ID(s) - comma-separated (max 50), resolved via market_outcomes table */
                 position_ids?: string;
-                /** @description Search in title and description (3-100 characters) */
+                /** @description Search in title (3-100 characters) */
                 search?: string;
                 /** @description Filter by status: open or closed */
                 status?: components["schemas"]["MarketStatus"];
-                /** @description Sort: volume, txns, unique_traders, liquidity, holders, end_date, created_at, relevance */
+                /** @description Sort: volume, txns, unique_traders, liquidity, holders, end_time, start_time, created_time, created_at, relevance */
                 sort_by?: components["schemas"]["MarketSortBy"];
                 /** @description Sort direction: asc, desc (default: desc) */
                 sort_dir?: components["schemas"]["SortDirection"];
@@ -2003,9 +2013,9 @@ export interface operations {
                 tags?: string;
                 /** @description Comma-separated tags to exclude */
                 exclude_tags?: string;
-                /** @description Filter markets with end_date >= start_time (Unix timestamp) */
+                /** @description Filter markets with end_time >= start_time (Unix timestamp) */
                 start_time?: number;
-                /** @description Filter markets with end_date <= end_time (Unix timestamp) */
+                /** @description Filter markets with end_time <= end_time (Unix timestamp) */
                 end_time?: number;
                 /** @description Include tags array (default: true) */
                 include_tags?: boolean;
@@ -2015,10 +2025,8 @@ export interface operations {
                 include_metrics?: boolean;
                 /** @description Results limit (default: 50, max: 100) */
                 limit?: number;
-                /** @description Cursor value for pagination (sort column value) */
-                cursor_value?: string;
-                /** @description Cursor ID for pagination (condition_id) */
-                cursor_id?: string;
+                /** @description Cursor-based pagination key (base64-encoded, obtained from previous response's pagination.pagination_key) */
+                pagination_key?: string;
             };
             header?: never;
             path?: never;