@structbuild/sdk 0.3.10-staging.6 → 0.3.10-staging.7

package/dist/generated/polymarket.d.ts

@@ -1254,7 +1254,7 @@ export interface components {
          *     domains and re-bucketed from the `_1d` MV for market/event/trader.
          * @enum {string}
          */
-        AnalyticsResolution: "1" | "5" | "15" | "30" | "60" | "240" | "D" | "1D" | "W" | "1W" | "M" | "1M";
+        AnalyticsResolution: "60" | "240" | "D" | "1D" | "W" | "1W" | "M" | "1M";
         /** @description Output payload for ERC1155 setApprovalForAll events. */
         ApprovalTrade: {
             id: string;
@@ -1660,8 +1660,21 @@ export interface components {
             buy_volume_usd: number;
             /** Format: double */
             sell_volume_usd: number;
-            /** Format: int64 */
+            /**
+             * Format: int64
+             * @description Distinct addresses that have ever traded on Polymarket (lifetime).
+             */
             unique_traders: number;
+            /**
+             * Format: int64
+             * @description Distinct makers ever active (lifetime distinct).
+             */
+            unique_makers: number;
+            /**
+             * Format: int64
+             * @description Distinct takers ever active (lifetime distinct).
+             */
+            unique_takers: number;
             /** Format: int64 */
             txn_count: number;
             /** Format: int64 */
@@ -2061,8 +2074,22 @@ export interface components {
             /** Format: double */
             sell_volume_usd?: number | null;
             /** Format: double */
+            merge_volume_usd?: number | null;
+            /** Format: double */
+            split_volume_usd?: number | null;
+            /** Format: double */
+            new_traders?: number | null;
+            /** Format: double */
+            new_makers?: number | null;
+            /** Format: double */
+            new_takers?: number | null;
+            /** Format: double */
             unique_traders?: number | null;
             /** Format: double */
+            unique_makers?: number | null;
+            /** Format: double */
+            unique_takers?: number | null;
+            /** Format: double */
             txn_count?: number | null;
             /** Format: double */
             fees_usd?: number | null;
@@ -2475,9 +2502,40 @@ export interface components {
             txn_count: number;
             /**
              * Format: int64
+             * @description First-time-ever traders in the window (delta of the lifetime counter).
+             * @default null
+             */
+            new_traders: number;
+            /**
+             * Format: int64
+             * @description First-time-ever makers in the window.
+             * @default null
+             */
+            new_makers: number;
+            /**
+             * Format: int64
+             * @description First-time-ever takers in the window.
+             * @default null
+             */
+            new_takers: number;
+            /**
+             * Format: int64
+             * @description Distinct active traders in the window.
              * @default null
              */
             unique_traders: number;
+            /**
+             * Format: int64
+             * @description Distinct active makers in the window.
+             * @default null
+             */
+            unique_makers: number;
+            /**
+             * Format: int64
+             * @description Distinct active takers in the window.
+             * @default null
+             */
+            unique_takers: number;
             /**
              * Format: double
              * @default null
@@ -2996,12 +3054,16 @@ export interface components {
         };
         /**
          * @description Metric to order by when `sort=<value>` is provided.
-         *     `traders` windowed sums per-block deltas — approximate for the "unique
-         *     traders in window" reading (double-counts traders active in multiple
-         *     blocks) but fine for ranking. `lifetime` uses the exact cumulative.
+         *
+         *     `new_*` ranks by first-time-ever arrivals — counted once in the bucket
+         *     where the address first appears, regardless of subsequent activity. Read
+         *     from the cumulative / delta MVs.
+         *
+         *     `unique_*` ranks by window-distinct addresses — exact `uniqExact` count
+         *     of addresses active in the timeframe. Read from the active MVs.
          * @enum {string}
          */
-        TagSortBy: "volume" | "txns" | "traders" | "fees";
+        TagSortBy: "volume" | "txns" | "new_traders" | "new_makers" | "new_takers" | "unique_traders" | "unique_makers" | "unique_takers" | "fees";
         /**
          * @description Timeframe for `?sort=...` — defines the window the metric is summed over
          *     (or `lifetime` for all-time cumulative).
@@ -3015,7 +3077,7 @@ export interface components {
          *
          *     Short field names for compact JSON responses:
          *       t=bucket (unix seconds), v=volume_usd, bv=buy_volume_usd, sv=sell_volume_usd,
-         *       ut=unique_traders, tc=txn_count, bc=buy_count, sc=sell_count,
+         *       ut=new_traders, tc=txn_count, bc=buy_count, sc=sell_count,
          *       rc=redemption_count, rv=redemption_volume_usd, mc=merge_count,
          *       sp=split_count, f=fees_usd, sh=shares_volume,
          *       yv=yes_volume_usd, nv=no_volume_usd, yc=yes_count, nc=no_count
@@ -3029,8 +3091,21 @@ export interface components {
             bv: number;
             /** Format: double */
             sv: number;
-            /** Format: int64 */
-            ut: number;
+            /**
+             * Format: int64
+             * @description Traders appearing for the first-time-ever in this bucket.
+             */
+            nt: number;
+            /**
+             * Format: int64
+             * @description Unique makers (order-resting side). Only tracked for match events.
+             */
+            nm: number;
+            /**
+             * Format: int64
+             * @description Unique takers (order-initiator side). Only tracked for match events.
+             */
+            nk: number;
             /** Format: int64 */
             tc: number;
             /** Format: int64 */
@@ -3076,6 +3151,21 @@ export interface components {
             bd_50k: number;
             /** Format: int64 */
             bd_50p: number;
+            /**
+             * Format: int64
+             * @description Distinct traders ACTIVE in this bucket (window-unique, not first-time).
+             */
+            ut: number;
+            /**
+             * Format: int64
+             * @description Distinct makers active in this bucket.
+             */
+            um: number;
+            /**
+             * Format: int64
+             * @description Distinct takers active in this bucket.
+             */
+            uk: number;
         };
         /** @description Token outcome (position) */
         TokenOutcome: {
@@ -3264,6 +3354,33 @@ export interface components {
             /** Format: double */
             realized_pnl_pct?: number | null;
         };
+        /**
+         * @description Per-metric percentage change over a lookback window for one trader
+         *     address. A `null` field means the window predates the trader's first
+         *     activity or the prior value was zero (percentage undefined).
+         */
+        TraderMetricPctChange: {
+            /** Format: double */
+            volume_usd?: number | null;
+            /** Format: double */
+            buy_volume_usd?: number | null;
+            /** Format: double */
+            sell_volume_usd?: number | null;
+            /** Format: double */
+            merge_volume_usd?: number | null;
+            /** Format: double */
+            split_volume_usd?: number | null;
+            /** Format: double */
+            txn_count?: number | null;
+            /** Format: double */
+            fees_usd?: number | null;
+            /** Format: double */
+            shares_volume?: number | null;
+            /** Format: double */
+            yes_volume_usd?: number | null;
+            /** Format: double */
+            no_volume_usd?: number | null;
+        };
         /** @description Outcome-level PnL entry (per outcome token / position_id) */
         TraderOutcomePnlEntry: {
             position_id?: string | null;
@@ -3384,6 +3501,65 @@ export interface components {
             /** Format: int64 */
             last_trade_at?: number | null;
         };
+        /**
+         * @description Bucket row returned by the per-trader `/analytics/timeseries` and
+         *     `/analytics/deltas` endpoints. Mirrors `TimeBucketRow` minus the
+         *     distinct-address counters (`new_*` / `unique_*`) — those only carry
+         *     information for aggregations over many addresses (market, event, tag,
+         *     global), not for a single trader.
+         */
+        TraderTimeBucketRow: {
+            /** Format: int32 */
+            t: number;
+            /** Format: double */
+            v: number;
+            /** Format: double */
+            bv: number;
+            /** Format: double */
+            sv: number;
+            /** Format: int64 */
+            tc: number;
+            /** Format: int64 */
+            bc: number;
+            /** Format: int64 */
+            sc: number;
+            /** Format: int64 */
+            rc: number;
+            /** Format: double */
+            rv: number;
+            /** Format: int64 */
+            mc: number;
+            /** Format: double */
+            mv: number;
+            /** Format: int64 */
+            sp: number;
+            /** Format: double */
+            spv: number;
+            /** Format: double */
+            f: number;
+            /** Format: double */
+            sh: number;
+            /** Format: double */
+            yv: number;
+            /** Format: double */
+            nv: number;
+            /** Format: int64 */
+            yc: number;
+            /** Format: int64 */
+            nc: number;
+            /** Format: int64 */
+            bd_u10: number;
+            /** Format: int64 */
+            bd_100: number;
+            /** Format: int64 */
+            bd_1k: number;
+            /** Format: int64 */
+            bd_10k: number;
+            /** Format: int64 */
+            bd_50k: number;
+            /** Format: int64 */
+            bd_50p: number;
+        };
         TraderVolumeChartResponse: {
             volumes: components["schemas"]["TraderVolumeDataPoint"][];
             has_more: boolean;
@@ -3428,9 +3604,9 @@ export type $defs = Record<string, never>;
 export interface operations {
     get_global_analytics_changes: {
         parameters: {
-            query: {
-                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y */
-                timeframe: components["schemas"]["ChangeTimeframe"];
+            query?: {
+                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y (default: 24h) */
+                timeframe?: components["schemas"]["ChangeTimeframe"];
             };
             header?: never;
             path?: never;
@@ -3472,7 +3648,7 @@ export interface operations {
     get_global_analytics_deltas: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds). Omit for all-time. */
                 from?: number;
@@ -3503,7 +3679,7 @@ export interface operations {
     get_global_analytics_timeseries: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds). Omit for all-time. */
                 from?: number;
@@ -3799,9 +3975,9 @@ export interface operations {
     };
     get_event_analytics_changes: {
         parameters: {
-            query: {
-                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y */
-                timeframe: components["schemas"]["ChangeTimeframe"];
+            query?: {
+                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y (default: 24h) */
+                timeframe?: components["schemas"]["ChangeTimeframe"];
             };
             header?: never;
             path: {
@@ -3826,7 +4002,7 @@ export interface operations {
     get_event_analytics_deltas: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
@@ -3860,7 +4036,7 @@ export interface operations {
     get_event_analytics_timeseries: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
@@ -4764,9 +4940,9 @@ export interface operations {
     };
     get_market_analytics_changes: {
         parameters: {
-            query: {
-                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y */
-                timeframe: components["schemas"]["ChangeTimeframe"];
+            query?: {
+                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y (default: 24h) */
+                timeframe?: components["schemas"]["ChangeTimeframe"];
             };
             header?: never;
             path: {
@@ -4791,7 +4967,7 @@ export interface operations {
     get_market_analytics_deltas: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
@@ -4825,7 +5001,7 @@ export interface operations {
     get_market_analytics_timeseries: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
@@ -5287,6 +5463,8 @@ export interface operations {
                 sort?: components["schemas"]["TagSortBy"];
                 /** @description Window for the sort metric. Defaults to `24h` when only `sort` is set. Setting either `sort` or `timeframe` adds +2 credits. */
                 timeframe?: components["schemas"]["TagSortTimeframe"];
+                /** @description Sort direction (default: true = highest first). Only applies to sort/timeframe mode. */
+                sort_desc?: boolean;
             };
             header?: never;
             path?: never;
@@ -5342,9 +5520,9 @@ export interface operations {
     };
     get_tag_analytics_changes: {
         parameters: {
-            query: {
-                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y */
-                timeframe: components["schemas"]["ChangeTimeframe"];
+            query?: {
+                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y (default: 24h) */
+                timeframe?: components["schemas"]["ChangeTimeframe"];
             };
             header?: never;
             path: {
@@ -5369,7 +5547,7 @@ export interface operations {
     get_tag_analytics_deltas: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
@@ -5403,7 +5581,7 @@ export interface operations {
     get_tag_analytics_timeseries: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
@@ -5804,8 +5982,6 @@ export interface operations {
                 from?: number;
                 /** @description End timestamp (ms) */
                 to?: number;
-                /** @description Return all-time trades, not just last 30 days (default: false) */
-                all?: boolean;
                 /** @description Results per page (default: 10, max: 250) */
                 limit?: number;
                 /** @description Pagination offset (number of results to skip). Takes precedence over pagination_key. */
@@ -5871,9 +6047,9 @@ export interface operations {
     };
     get_trader_analytics_changes: {
         parameters: {
-            query: {
-                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y */
-                timeframe: components["schemas"]["ChangeTimeframe"];
+            query?: {
+                /** @description Lookback window: 1h, 24h, 7d, 30d, 1mo, 1y (default: 24h) */
+                timeframe?: components["schemas"]["ChangeTimeframe"];
             };
             header?: never;
             path: {
@@ -5890,7 +6066,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["MetricPctChange"];
+                    "application/json": components["schemas"]["TraderMetricPctChange"];
                 };
             };
         };
@@ -5898,7 +6074,7 @@ export interface operations {
     get_trader_analytics_deltas: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
@@ -5924,7 +6100,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TimeBucketRow"][];
+                    "application/json": components["schemas"]["TraderTimeBucketRow"][];
                 };
             };
         };
@@ -5932,7 +6108,7 @@ export interface operations {
     get_trader_analytics_timeseries: {
         parameters: {
             query?: {
-                /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
+                /** @description Bucket size: 60, 240, D, 1D, W, 1W, M, 1M (default: 60) */
                 resolution?: components["schemas"]["AnalyticsResolution"];
                 /** @description Start timestamp (Unix seconds) */
                 from?: number;
@@ -5958,7 +6134,7 @@ export interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["TimeBucketRow"][];
+                    "application/json": components["schemas"]["TraderTimeBucketRow"][];
                 };
             };
         };

package/dist/types/index.d.ts

@@ -72,6 +72,8 @@ export type TimeBucketRow = Schemas["TimeBucketRow"];
 export type TokenOutcome = Schemas["TokenOutcome"];
 export type Trader = Schemas["Trader"];
 export type TraderInfo = Schemas["TraderInfo"];
+export type TraderMetricPctChange = Schemas["TraderMetricPctChange"];
+export type TraderTimeBucketRow = Schemas["TraderTimeBucketRow"];
 export type TraderVolumeChartResponse = Schemas["TraderVolumeChartResponse"];
 export type TraderOutcomePnlEntry = Schemas["TraderOutcomePnlEntry"];
 export type TraderVolumeDataPoint = Schemas["TraderVolumeDataPoint"];

package/package.json

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