@structbuild/sdk 0.4.2-staging.0 → 0.4.2-staging.2

package/dist/generated/polymarket.d.ts

@@ -123,6 +123,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/polymarket/builders/composition": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Top-N builders + 'other' aggregate composition
+         * @description Returns the top N builders by the chosen metric plus a synthetic `other` row aggregating every remaining builder. Designed for stacked / pie charts where rendering all builders individually is overkill. `series=cumulative` returns end-of-window totals; `series=delta` returns the in-window change.
+         */
+        get: operations["get_builder_composition"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/polymarket/builders/global": {
         parameters: {
             query?: never;
@@ -194,6 +214,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/polymarket/builders/global/tags": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * All tags with builder-attributed activity
+         * @description Returns every tag that has builder-routed activity, with metrics aggregated across all builders. `distinct_builders` is exact; other `unique_*` columns sum per-builder uniques and may slightly over-count traders active under multiple builders.
+         */
+        get: operations["list_global_builder_tags"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/polymarket/builders/tags/{tag}": {
         parameters: {
             query?: never;
@@ -1895,6 +1935,23 @@ export interface components {
              * @description Distinct builder codes ever observed.
              */
             distinct_builders: number;
+            /**
+             * Format: int64
+             * @description Onboarding metric — traders whose *first ever* builder-attributed
+             *     trade occurred within the chosen window. Each trader contributes at
+             *     most once globally.
+             */
+            new_users: number;
+            /**
+             * Format: double
+             * @description Average revenue per user — `builder_fees / unique_traders`.
+             */
+            avg_rev_per_user: number;
+            /**
+             * Format: double
+             * @description Average volume per user — `volume_usd / unique_traders`.
+             */
+            avg_vol_per_user: number;
         };
         /** @description Cumulative stats for a single builder. */
         BuilderLatestRow: {
@@ -1947,6 +2004,31 @@ export interface components {
             buy_dist_10k_50k: number;
             /** Format: int64 */
             buy_dist_50k_plus: number;
+            /** Format: int64 */
+            new_users: number;
+            /**
+             * Format: double
+             * @description Average revenue per user — `builder_fees / unique_traders`.
+             */
+            avg_rev_per_user: number;
+            /**
+             * Format: double
+             * @description Average volume per user — `volume_usd / unique_traders`.
+             */
+            avg_vol_per_user: number;
+            /**
+             * Format: int32
+             * @description Builder's maker fee rate in basis points. Latest known value at the
+             *     end of the window — same value across all timeframes since it's a
+             *     static property of the builder, not an aggregate.
+             */
+            builder_maker_fee_rate_bps: number;
+            /**
+             * Format: int32
+             * @description Builder's taker fee rate in basis points. Same scoping as
+             *     `builder_maker_fee_rate_bps`.
+             */
+            builder_taker_fee_rate_bps: number;
         };
         /** @description Per-metric percentage change for a builder over the requested lookback window. */
         BuilderPctChange: {
@@ -1994,12 +2076,18 @@ export interface components {
             buy_dist_10k_50k: number;
             /** Format: double */
             buy_dist_50k_plus: number;
+            /** Format: double */
+            new_users: number;
+            /** Format: double */
+            avg_rev_per_user: number;
+            /** Format: double */
+            avg_vol_per_user: number;
         };
         /**
          * @description Sort metric for the builders list endpoint.
          * @enum {string}
          */
-        BuilderSortBy: "volume" | "txns" | "traders" | "fees" | "builder_fees";
+        BuilderSortBy: "volume" | "txns" | "traders" | "fees" | "builder_fees" | "new_users" | "avg_rev_per_user" | "avg_vol_per_user" | "builder_maker_fee_rate_bps" | "builder_taker_fee_rate_bps";
         /** @description One tag's stats under a single builder. */
         BuilderTagRow: {
             tag: string;
@@ -2051,6 +2139,12 @@ export interface components {
             buy_dist_10k_50k: number;
             /** Format: int64 */
             buy_dist_50k_plus: number;
+            /** Format: int64 */
+            new_users: number;
+            /** Format: double */
+            avg_rev_per_user: number;
+            /** Format: double */
+            avg_vol_per_user: number;
         };
         /**
          * @description One time bucket of builder activity. In `timeseries` responses fields are
@@ -2116,6 +2210,26 @@ export interface components {
             bd_50k: number;
             /** Format: int64 */
             bd_50p: number;
+            /**
+             * Format: int64
+             * @description Onboarding metric — traders whose *first ever* builder-attributed trade
+             *     touched this builder/grain. Cumulative on `timeseries`, delta on
+             *     `deltas`. Each trader contributes at most once globally (any builder).
+             */
+            nu: number;
+            /**
+             * Format: double
+             * @description Average revenue per user — `builder_fees / unique_traders`. Zero when
+             *     the bucket has no traders. Cumulative on `timeseries`, in-window on
+             *     `deltas`.
+             */
+            ar: number;
+            /**
+             * Format: double
+             * @description Average volume per user — `volume_usd / unique_traders`. Same scoping
+             *     as `avg_rev_per_user` (cumulative on `timeseries`, in-window on `deltas`).
+             */
+            av: number;
         };
         /**
          * @description Time window for cumulative builder stats.
@@ -2201,6 +2315,80 @@ export interface components {
                 [key: string]: number;
             };
         };
+        /**
+         * @description One row of the composition response. `builder_code` is either a real hex
+         *     address (for top-N entries) or the literal string `"other"` for the
+         *     aggregated remainder.
+         */
+        CompositionEntry: {
+            builder_code: string;
+            /**
+             * Format: int32
+             * @description 1-indexed rank within the response. The `other` row is always last
+             *     with rank `top_n + 1`.
+             */
+            rank: number;
+            /** Format: double */
+            volume_usd: number;
+            /** Format: double */
+            buy_volume_usd: number;
+            /** Format: double */
+            sell_volume_usd: number;
+            /**
+             * Format: int64
+             * @description Window-distinct trader count. For the `other` row this is summed
+             *     across the remainder builders, so a trader active under multiple
+             *     builders is counted in each — upper bound, not exact.
+             */
+            unique_traders: number;
+            /** Format: int64 */
+            unique_makers: number;
+            /** Format: int64 */
+            unique_takers: number;
+            /** Format: int64 */
+            txn_count: number;
+            /** Format: int64 */
+            buy_count: number;
+            /** Format: int64 */
+            sell_count: number;
+            /** Format: double */
+            fees_usd: number;
+            /** Format: double */
+            builder_fees: number;
+            /** Format: double */
+            shares_volume: number;
+            /** Format: double */
+            yes_volume_usd: number;
+            /** Format: double */
+            no_volume_usd: number;
+            /** Format: int64 */
+            yes_count: number;
+            /** Format: int64 */
+            no_count: number;
+            /** Format: int64 */
+            buy_dist_under_10: number;
+            /** Format: int64 */
+            buy_dist_10_100: number;
+            /** Format: int64 */
+            buy_dist_100_1k: number;
+            /** Format: int64 */
+            buy_dist_1k_10k: number;
+            /** Format: int64 */
+            buy_dist_10k_50k: number;
+            /** Format: int64 */
+            buy_dist_50k_plus: number;
+            /** Format: int64 */
+            new_users: number;
+            /** Format: double */
+            avg_rev_per_user: number;
+            /** Format: double */
+            avg_vol_per_user: number;
+        };
+        /**
+         * @description Series mode — cumulative end-of-window snapshot or in-window delta.
+         * @enum {string}
+         */
+        CompositionSeries: "cumulative" | "delta";
         ConcentrationResponse: {
             /**
              * Format: double
@@ -2451,6 +2639,73 @@ export interface components {
         EventPnlSortBy: "realized_pnl_usd" | "total_volume_usd" | "markets_traded" | "total_fees" | "realized_pnl_pct";
         /** @enum {string} */
         EventSortBy: "volume" | "txns" | "unique_traders" | "title" | "creation_date" | "start_date" | "end_date" | "relevance";
+        /**
+         * @description One tag's stats aggregated across every builder routing activity into it.
+         *
+         *     `distinct_builders` is the exact count of builders active in the tag.
+         *     `unique_traders` / `unique_makers` / `unique_takers` are summed per builder,
+         *     so a trader active under multiple builders is counted in each — these are
+         *     upper bounds rather than true window-distinct counts.
+         */
+        GlobalBuilderTagRow: {
+            tag: string;
+            /** Format: int64 */
+            block: number;
+            /** Format: int32 */
+            ts: number;
+            /** Format: int64 */
+            distinct_builders: number;
+            /** Format: double */
+            volume_usd: number;
+            /** Format: double */
+            buy_volume_usd: number;
+            /** Format: double */
+            sell_volume_usd: number;
+            /** Format: int64 */
+            unique_traders: number;
+            /** Format: int64 */
+            unique_makers: number;
+            /** Format: int64 */
+            unique_takers: number;
+            /** Format: int64 */
+            txn_count: number;
+            /** Format: int64 */
+            buy_count: number;
+            /** Format: int64 */
+            sell_count: number;
+            /** Format: double */
+            fees_usd: number;
+            /** Format: double */
+            builder_fees: number;
+            /** Format: double */
+            shares_volume: number;
+            /** Format: double */
+            yes_volume_usd: number;
+            /** Format: double */
+            no_volume_usd: number;
+            /** Format: int64 */
+            yes_count: number;
+            /** Format: int64 */
+            no_count: number;
+            /** Format: int64 */
+            buy_dist_under_10: number;
+            /** Format: int64 */
+            buy_dist_10_100: number;
+            /** Format: int64 */
+            buy_dist_100_1k: number;
+            /** Format: int64 */
+            buy_dist_1k_10k: number;
+            /** Format: int64 */
+            buy_dist_10k_50k: number;
+            /** Format: int64 */
+            buy_dist_50k_plus: number;
+            /** Format: int64 */
+            new_users: number;
+            /** Format: double */
+            avg_rev_per_user: number;
+            /** Format: double */
+            avg_vol_per_user: number;
+        };
         /** @enum {string} */
         GlobalChangeTimeframe: "1h" | "24h" | "7d" | "30d" | "1mo" | "1y";
         /**
@@ -2599,6 +2854,12 @@ export interface components {
             buy_dist_50k_plus: number;
             /** Format: double */
             distinct_builders: number;
+            /** Format: double */
+            new_users: number;
+            /** Format: double */
+            avg_rev_per_user: number;
+            /** Format: double */
+            avg_vol_per_user: number;
         };
         /** @enum {string} */
         GlobalPnlSortBy: "realized_pnl_usd" | "buys" | "sells" | "redemptions" | "merges" | "avg_hold_time" | "markets_traded" | "events_traded" | "markets_won" | "volume_usd" | "fees" | "best_trade";
@@ -4099,6 +4360,12 @@ export interface components {
             buy_dist_10k_50k: number;
             /** Format: int64 */
             buy_dist_50k_plus: number;
+            /** Format: int64 */
+            new_users: number;
+            /** Format: double */
+            avg_rev_per_user: number;
+            /** Format: double */
+            avg_vol_per_user: number;
         };
         /**
          * @description Metric to order by when `sort=<value>` is provided.
@@ -4948,10 +5215,39 @@ export interface operations {
             };
         };
     };
+    get_builder_composition: {
+        parameters: {
+            query?: {
+                /** @description Ranking metric. Default: volume. */
+                metric?: components["schemas"]["BuilderSortBy"];
+                /** @description Window: lifetime, 1d, 24h, 7d, 30d, 1mo. Default: lifetime. */
+                timeframe?: components["schemas"]["BuilderTimeframe"];
+                /** @description Number of top builders to return individually (clamped 1..50). Default: 10. */
+                top_n?: number;
+                /** @description cumulative (end-of-window snapshot) or delta (in-window change). Default: cumulative. At timeframe=lifetime, delta == cumulative. */
+                series?: components["schemas"]["CompositionSeries"];
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Top-N builders + 'other' aggregate */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CompositionEntry"][];
+                };
+            };
+        };
+    };
     get_builder_global: {
         parameters: {
             query?: {
-                /** @description Window: lifetime, 1d, 7d, 30d. Default: lifetime. */
+                /** @description Window: lifetime, 1d, 24h, 7d, 30d, 1mo. Default: lifetime. */
                 timeframe?: components["schemas"]["BuilderTimeframe"];
             };
             header?: never;
@@ -5056,12 +5352,43 @@ export interface operations {
             };
         };
     };
+    list_global_builder_tags: {
+        parameters: {
+            query?: {
+                /** @description Metric to sort by. Default: volume. */
+                sort?: components["schemas"]["BuilderSortBy"];
+                /** @description Window: lifetime, 1d, 24h, 7d, 30d, 1mo. Default: lifetime. */
+                timeframe?: components["schemas"]["BuilderTimeframe"];
+                /** @description Max rows to return (default 50, max 500). */
+                limit?: number;
+                /** @description Skip count. */
+                offset?: number;
+                /** @description Opaque cursor. */
+                pagination_key?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Per-tag aggregated stats */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["GlobalBuilderTagRow"][];
+                };
+            };
+        };
+    };
     list_tag_builders: {
         parameters: {
             query?: {
                 /** @description Metric to sort by. Default: volume. */
                 sort?: components["schemas"]["BuilderSortBy"];
-                /** @description Window: lifetime, 1d, 7d, 30d. Default: lifetime. */
+                /** @description Window: lifetime, 1d, 24h, 7d, 30d, 1mo. Default: lifetime. */
                 timeframe?: components["schemas"]["BuilderTimeframe"];
                 /** @description Max rows to return (default 50, max 500). */
                 limit?: number;
@@ -5332,7 +5659,7 @@ export interface operations {
             query?: {
                 /** @description Metric to sort by. Default: volume. */
                 sort?: components["schemas"]["BuilderSortBy"];
-                /** @description Window: lifetime, 1d, 7d, 30d. Default: lifetime. */
+                /** @description Window: lifetime, 1d, 24h, 7d, 30d, 1mo. Default: lifetime. */
                 timeframe?: components["schemas"]["BuilderTimeframe"];
                 /** @description Max rows to return (default 50, max 500). */
                 limit?: number;

package/dist/index.cjs

@@ -193,11 +193,14 @@ class HttpClient {
         } catch {}
       }
       if (!response.ok) {
-        let body2;
-        try {
-          body2 = await response.json();
-        } catch {
-          body2 = await response.text();
+        const text = await response.text();
+        let body2 = text;
+        if (text.length > 0) {
+          try {
+            body2 = JSON.parse(text);
+          } catch {}
+        } else {
+          body2 = null;
         }
         throw new HttpError(response.status, response.statusText, body2, response.headers);
       }
@@ -517,6 +520,9 @@ class BuildersNamespace extends Namespace {
   async getBuilders(params, venue) {
     return this.get(venue, "/builders", { params: { ...params } });
   }
+  async getComposition(params, venue) {
+    return this.get(venue, "/builders/composition", { params: { ...params } });
+  }
   async getBuilder(params, venue) {
     const { builder_code, ...query } = params;
     return this.get(venue, `/builders/${encodePathParam(builder_code)}`, { params: query });
@@ -568,6 +574,9 @@ class BuildersNamespace extends Namespace {
   async getGlobalTimeseries(params, venue) {
     return this.get(venue, "/builders/global/analytics/timeseries", { params: { ...params } });
   }
+  async getGlobalTags(params, venue) {
+    return this.get(venue, "/builders/global/tags", { params: { ...params } });
+  }
   async getTagBuilders(params, venue) {
     const { tag, ...query } = params;
     return this.get(venue, `/builders/tags/${encodePathParam(tag)}`, { params: query });
@@ -1507,5 +1516,5 @@ async function* paginate(fetcher, params, pageSize = DEFAULT_PAGE_SIZE) {
   }
 }
 
-//# debugId=0845CF70CA3C7A5A64756E2164756E21
+//# debugId=8298842F4C725C5864756E2164756E21
 //# sourceMappingURL=index.js.map