@structbuild/sdk 0.5.6-staging.1 → 0.5.6-staging.2

package/dist/generated/polymarket.d.ts

@@ -1742,8 +1742,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get trader PnL v3 candles
-         * @description Retrieve ClickHouse-backed PnL v3 candles with total PnL OHLC, realized/unrealized PnL, balances, portfolio value, and open-position count.
+         * Get trader PnL candles
+         * @description Retrieve a trader's PnL chart candles, including total PnL, realized and unrealized PnL, balances, portfolio value, and open-position count.
          */
         get: operations["get_trader_pnl_v3_candles"];
         put?: never;
@@ -1762,7 +1762,7 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get trader PnL v3 changes
+         * Get trader PnL changes
          * @description Retrieve absolute and percentage PnL, portfolio, balance, and open-position changes over 1h, 24h, 7d, 30d, and lifetime.
          */
         get: operations["get_trader_pnl_v3_changes"];
@@ -1782,8 +1782,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get trader PnL v3 best/worst periods
-         * @description Retrieve best and worst daily, weekly, and monthly total-PnL and portfolio periods using daily PnL candles.
+         * Get trader best and worst PnL periods
+         * @description Retrieve the trader's best and worst daily, weekly, and monthly periods for total PnL and portfolio value.
          */
         get: operations["get_trader_pnl_v3_periods"];
         put?: never;
@@ -1802,7 +1802,7 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Get trader PnL v3 risk
+         * Get trader PnL risk
          * @description Retrieve max drawdown, current drawdown, max runup, high, low, and latest values over a timeframe.
          */
         get: operations["get_trader_pnl_v3_risk"];
@@ -4478,6 +4478,82 @@ export interface components {
              */
             num_open_positions: number;
         };
+        PnlV3CandlestickBar: {
+            /**
+             * Format: double
+             * @description Total PnL low value for the candle.
+             */
+            l?: number | null;
+            /**
+             * Format: double
+             * @description Total PnL high value for the candle.
+             */
+            h?: number | null;
+            /**
+             * Format: double
+             * @description Total PnL open value for the candle.
+             */
+            o?: number | null;
+            /**
+             * Format: double
+             * @description Total PnL close/latest value for the candle.
+             */
+            c?: number | null;
+            /**
+             * Format: int64
+             * @description Timestamp in epoch seconds at the start of the candle bucket.
+             */
+            t: number;
+            /** Format: int64 */
+            open_block: number;
+            /** Format: int64 */
+            close_block: number;
+            /**
+             * Format: double
+             * @description Latest realized PnL at candle close.
+             */
+            realized_pnl: number;
+            /**
+             * Format: double
+             * @description Latest unrealized/open-position value at candle close.
+             */
+            unrealized_pnl: number;
+            /**
+             * Format: double
+             * @description Latest USDC balance at candle close.
+             */
+            usdc_balance: number;
+            /**
+             * Format: double
+             * @description Latest pUSD balance at candle close.
+             */
+            pusd_balance: number;
+            /**
+             * Format: double
+             * @description Portfolio value low value for the candle.
+             */
+            portfolio_l?: number | null;
+            /**
+             * Format: double
+             * @description Portfolio value high value for the candle.
+             */
+            portfolio_h?: number | null;
+            /**
+             * Format: double
+             * @description Portfolio value open value for the candle.
+             */
+            portfolio_o?: number | null;
+            /**
+             * Format: double
+             * @description Portfolio value close/latest value for the candle.
+             */
+            portfolio_c?: number | null;
+            /**
+             * Format: int32
+             * @description Latest open position count at candle close.
+             */
+            num_open_positions: number;
+        };
         PnlV3ChangeWindow: {
             timeframe: string;
             /** Format: int64 */
@@ -9892,13 +9968,13 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description PnL v3 candles */
+            /** @description Trader PnL candles */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["PnlV3CandleEntry"][];
+                    "application/json": components["schemas"]["PnlV3CandlestickBar"][];
                 };
             };
         };
@@ -9915,7 +9991,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description PnL v3 changes */
+            /** @description Trader PnL changes */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -9941,7 +10017,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description PnL v3 best/worst periods */
+            /** @description Trader best and worst PnL periods */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -9967,7 +10043,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description PnL v3 risk */
+            /** @description Trader PnL risk */
             200: {
                 headers: {
                     [name: string]: unknown;

package/dist/generated/ws.d.ts

@@ -202,7 +202,7 @@ export interface components {
              */
             threshold: number;
         };
-        /** @description Condition metrics webhook payload (Arc-optimized, no internal metadata) */
+        /** @description Condition metrics webhook payload. */
         ConditionMetricsPayload: {
             condition_id?: string | null;
             timeframe?: string | null;
@@ -284,7 +284,7 @@ export interface components {
             slug?: string | null;
             event_slug?: string | null;
         };
-        /** @description Event metrics webhook payload (Arc-optimized, no internal metadata) */
+        /** @description Event metrics webhook payload. */
         EventMetricsPayload: {
             event_slug?: string | null;
             timeframe?: string | null;
@@ -297,7 +297,7 @@ export interface components {
             /** Format: int64 */
             unique_traders?: number | null;
         };
-        /** @description Event PnL webhook payload (Arc-optimized) */
+        /** @description Event PnL webhook payload. */
         EventPnlPayload: {
             trader?: string | null;
             event_slug?: string | null;
@@ -453,7 +453,7 @@ export interface components {
             exchange: string;
             trade_type: string;
         };
-        /** @description Global PnL webhook payload (Arc-optimized) */
+        /** @description Global PnL webhook payload. */
         GlobalPnlPayload: {
             trader?: string | null;
             /** @description Aggregation timeframe: "1d", "7d", "30d", or "lifetime" */
@@ -551,7 +551,7 @@ export interface components {
             /** @description Whether this is a neg-risk market */
             neg_risk: boolean;
         };
-        /** @description Market PnL webhook payload (Arc-optimized) */
+        /** @description Market PnL webhook payload. */
         MarketPnlPayload: {
             trader?: string | null;
             condition_id?: string | null;
@@ -1040,7 +1040,7 @@ export interface components {
              */
             oracle_event_types?: string[];
         };
-        /** @description Position metrics webhook payload (Arc-optimized, no internal metadata) */
+        /** @description Position metrics webhook payload. */
         PositionMetricsPayload: {
             position_id?: string | null;
             outcome?: string | null;

package/dist/types/index.d.ts

@@ -471,6 +471,7 @@ export type OnboardStatus = Schemas["OnboardStatus"];
 export type OrderType = Schemas["OrderType"];
 export type PnlV3AnalyticsTimeframe = Schemas["PnlV3AnalyticsTimeframe"];
 export type PnlV3CandleEntry = Schemas["PnlV3CandleEntry"];
+export type PnlV3CandlestickBar = Schemas["PnlV3CandlestickBar"];
 export type PnlV3ChangeWindow = Schemas["PnlV3ChangeWindow"];
 export type PnlV3ChangesResponse = Schemas["PnlV3ChangesResponse"];
 export type PnlV3LatestSnapshot = Schemas["PnlV3LatestSnapshot"];

package/package.json

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