@structbuild/sdk 0.6.6 → 0.6.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1505,7 +1505,7 @@ export interface paths {
1505
1505
  put?: never;
1506
1506
  /**
1507
1507
  * Batch trader PnL summaries
1508
- * @description PnL summaries for many wallets across many timeframes in one call. Credits scale with the number of wallet × timeframe units but stay below the cost of the equivalent single-trader requests. Results are keyed by wallet then timeframe; the `billing` block reports the units and credits charged.
1508
+ * @description PnL summaries for many wallets across many timeframes in one call, keyed by wallet then timeframe (a wallet/timeframe with no data is omitted). Billing is per `wallet × timeframe` unit on a decreasing marginal tariff: 1 credit for the 1st unit, 0.6 for units 2–5, 0.45 for units 6–20, and 0.35 for units 21+, summed and rounded to the nearest credit (minimum 1). For example, 4 units cost 3 credits, 40 units cost 17, and 200 units cost 73.
1509
1509
  */
1510
1510
  post: operations["get_trader_pnl_batch"];
1511
1511
  delete?: never;
@@ -12165,6 +12165,56 @@ export interface operations {
12165
12165
  [name: string]: unknown;
12166
12166
  };
12167
12167
  content: {
12168
+ /**
12169
+ * @example {
12170
+ * "0x96cfcb0c30942cfcd1cdf76c7d408794d66b1acb": {
12171
+ * "lifetime": {
12172
+ * "trader": {
12173
+ * "address": "0x96cfcb0c30942cfcd1cdf76c7d408794d66b1acb",
12174
+ * "name": "mintblade",
12175
+ * "pseudonym": "Golden-Reclamation",
12176
+ * "verified_badge": false
12177
+ * },
12178
+ * "realized_pnl_usd": 1878816.203922,
12179
+ * "total_pnl_usd": 9094807.981258,
12180
+ * "unrealized_pnl_usd": 7215991.777336,
12181
+ * "usd_balance": 3367872.058961,
12182
+ * "realized_pnl_pct": 21.719621,
12183
+ * "total_pnl_pct": 105.13843,
12184
+ * "open_positions_value": 14351553.789366,
12185
+ * "events_traded": 4,
12186
+ * "categories_traded": 1,
12187
+ * "markets_traded": 5,
12188
+ * "markets_won": 4,
12189
+ * "markets_lost": 0,
12190
+ * "market_win_rate_pct": 100,
12191
+ * "avg_win_usd": 469704.050981,
12192
+ * "avg_loss_usd": 0,
12193
+ * "profit_factor": 0,
12194
+ * "total_buys": 727,
12195
+ * "total_sells": 0,
12196
+ * "total_redemptions": 4,
12197
+ * "total_volume_usd": 11916491.517144,
12198
+ * "buy_volume_usd": 8522919.883091,
12199
+ * "total_fees": 127397.55907,
12200
+ * "total_wins_usd": 1878816.203922,
12201
+ * "total_losses_usd": 0,
12202
+ * "best_trade_pnl_usd": 1351658.511818,
12203
+ * "best_trade_condition_id": "0xbc54d73527785bdc7b443cfdf3b0d59558c5ac2bbffca23425ecfbd161b07317",
12204
+ * "best_trade_metadata": {
12205
+ * "market_slug": "fifwc-ksa-ury-2026-06-15-ury",
12206
+ * "event_slug": "fifwc-ksa-ury-2026-06-15",
12207
+ * "question": "Will Uruguay win on 2026-06-15?",
12208
+ * "title": "Uruguay"
12209
+ * },
12210
+ * "avg_hold_time_seconds": 518864,
12211
+ * "first_trade_at": 1780521522,
12212
+ * "last_trade_at": 1781580031,
12213
+ * "open_position_count": 1
12214
+ * }
12215
+ * }
12216
+ * }
12217
+ */
12168
12218
  "application/json": {
12169
12219
  [key: string]: {
12170
12220
  [key: string]: components["schemas"]["GlobalEntry"];
@@ -6562,8 +6562,13 @@ export interface components {
6562
6562
  /** @description Filter values that were rejected (invalid format or limit exceeded) */
6563
6563
  rejected?: string[];
6564
6564
  };
6565
- /** @description A single price level: [price_string, size_string] */
6566
- OrderBookLevel: string[];
6565
+ /** @description A single order book price level. Matches the HTTP order book API's OrderbookLevel. */
6566
+ OrderBookLevel: {
6567
+ /** @description Price as a decimal string (0–1) */
6568
+ p: string;
6569
+ /** @description Size as a decimal string */
6570
+ s: string;
6571
+ };
6567
6572
  /** @description Server-pushed event: full CLOB orderbook snapshot for an outcome token. Envelope type: "order_book_update". Delivered whenever the book changes for a subscribed condition or position. */
6568
6573
  OrderBookUpdateEvent: {
6569
6574
  /** @description Hex token ID (position / outcome token) */
@@ -630,4 +630,4 @@ export interface GetWebhookLogsParams extends WebhookOperationQuery<"get_webhook
630
630
  }
631
631
  export type { RetryConfig, HttpClientConfig, RequestOptions, HttpResponse, RequestHookInfo, ResponseHookInfo, ApiResponseInfo, PaginationInfo } from "./http.js";
632
632
  export type { Address, PaginationParams, SortParams, Venue } from "./common.js";
633
- export type { ConnectionState, StructWebSocketConfig, AlertsWebSocketEventMap, WsRoomId, WsFiltersOptionalRoom, WsFiltersRequiredRoom, WebSocketEventMap, WsSubscriptionMap, WsSubscribeResponseMap, TradesSubscribeFilters, WsTradeType, WsTradeStatus, WsAssetTimeframe, AssetPricesSubscribeFilters, AssetWindowUpdatesSubscribeFilters, MarketMetricsSubscribeFilters, EventMetricsSubscribeFilters, PositionMetricsSubscribeFilters, TagMetricsSubscribeFilters, TraderPnlSubscribeFilters, AccountsSubscribeFilters, OrderBookSubscribeFilters, TraderPositionsSubscribeFilters, TraderExitMarkersSubscribeFilters, HolderMetricsSubscribeFilters, TraderPositionsSubscribeResponse, TraderExitMarkersSubscribeResponse, HolderMetricsSubscribeResponse, TraderPositionRow, TraderPositionBatchEvent, TraderPositionPriceRow, TraderPositionPriceBatchEvent, TraderPositionResolutionRow, TraderPositionResolutionBatchEvent, TraderExitMarkerRow, TraderExitMarkerBatchEvent, PositionHolderMetricsRow, ConditionHolderMetricsRow, EventHolderMetricsRow, HolderMetricsPositionBatchEvent, HolderMetricsConditionBatchEvent, HolderMetricsEventBatchEvent, ClobRewardsSubscribeFilters, ClobRewardsUpdateEvent, ClobRewardsSubscribeResponse, EventsStreamSubscribeFilters, EventsStreamSubscribeResponse, EventsStreamUpdateEvent, MarketsStreamSubscribeFilters, MarketsStreamSubscribeResponse, MarketsStreamUpdateEvent, OracleEventStreamEvent, OracleEventsStreamSubscribeFilters, OracleEventsStreamSubscribeResponse, PositionLiquiditySubscribeFilters, MarketLiquiditySubscribeFilters, EventLiquiditySubscribeFilters, PositionLiquidityEvent, MarketLiquidityEvent, EventLiquidityEvent, PositionLiquiditySubscribeResponse, MarketLiquiditySubscribeResponse, EventLiquiditySubscribeResponse, WsAlertSubscribedResponse, WsAlertUnsubscribedResponse, WsAlertErrorResponse, WsAlertEventType, WsAlertSubscribeMessage, WsAlertUnsubscribeMessage, WsAlertEventPayload, WsAlertSubscribeMap, WsAlertEventDataMap, WsAlertEventName, TradeStreamEvent, AssetPriceTickEvent, AssetPriceWindowUpdateEvent, AssetWindowUpdateEvent, MarketMetricsEvent, EventMetricsEvent, PositionMetricsEvent, TagMetricsEvent, TraderGlobalPnlBatchEvent, TraderMarketPnlBatchEvent, TraderCategoryPnlBatchEvent, TraderGlobalTickBatchEvent, TraderMarketTickBatchEvent, TraderCategoryTickBatchEvent, TraderGlobalResolutionBatchEvent, TraderMarketResolutionBatchEvent, TraderCategoryResolutionBatchEvent, AccountsUpdateEvent, UsdceUpdateEvent, MaticUpdateEvent, PusdUpdateEvent, WsOrderBookLevel, OrderBookUpdateEvent, TradesStreamSubscribeResponse, AssetPricesSubscribeResponse, AssetWindowUpdatesSubscribeResponse, MarketMetricsSubscribeResponse, EventMetricsSubscribeResponse, PositionMetricsSubscribeResponse, TagMetricsSubscribeResponse, TraderPnlSubscribeResponse, AccountsSubscribeResponse, OrderBookSubscribeResponse, TradeOrderFilledEvent, TradeRedemptionEvent, TradeMergeEvent, TradeSplitEvent, TradePositionsConvertedEvent, TradeCancelledEvent, TradeOracleLifecycleEvent, TradeRegisterTokenEvent, } from "./ws.js";
633
+ export type { ConnectionState, StructWebSocketConfig, AlertsWebSocketEventMap, WsRoomId, WsFiltersOptionalRoom, WsFiltersRequiredRoom, WebSocketEventMap, WsSubscriptionMap, WsSubscribeResponseMap, TradesSubscribeFilters, WsTradeType, WsTradeStatus, WsAssetTimeframe, AssetPricesSubscribeFilters, AssetWindowUpdatesSubscribeFilters, MarketMetricsSubscribeFilters, EventMetricsSubscribeFilters, PositionMetricsSubscribeFilters, TagMetricsSubscribeFilters, TraderPnlSubscribeFilters, AccountsSubscribeFilters, OrderBookSubscribeFilters, TraderPositionsSubscribeFilters, TraderExitMarkersSubscribeFilters, HolderMetricsSubscribeFilters, TraderPositionsSubscribeResponse, TraderExitMarkersSubscribeResponse, HolderMetricsSubscribeResponse, TraderPositionRow, TraderPositionBatchEvent, TraderPositionPriceRow, TraderPositionPriceBatchEvent, TraderPositionResolutionRow, TraderPositionResolutionBatchEvent, TraderExitMarkerRow, TraderExitMarkerBatchEvent, PositionHolderMetricsRow, ConditionHolderMetricsRow, EventHolderMetricsRow, HolderMetricsPositionBatchEvent, HolderMetricsConditionBatchEvent, HolderMetricsEventBatchEvent, ClobRewardsSubscribeFilters, ClobRewardsUpdateEvent, ClobRewardsSubscribeResponse, EventsStreamSubscribeFilters, EventsStreamSubscribeResponse, EventsStreamUpdateEvent, EventsStreamUpdateRows, MarketsStreamSubscribeFilters, MarketsStreamSubscribeResponse, MarketsStreamUpdateEvent, MarketsStreamUpdateRows, OracleEventStreamEvent, OracleEventsStreamSubscribeFilters, OracleEventsStreamSubscribeResponse, PositionLiquiditySubscribeFilters, MarketLiquiditySubscribeFilters, EventLiquiditySubscribeFilters, PositionLiquidityEvent, MarketLiquidityEvent, EventLiquidityEvent, PositionLiquiditySubscribeResponse, MarketLiquiditySubscribeResponse, EventLiquiditySubscribeResponse, WsAlertSubscribedResponse, WsAlertUnsubscribedResponse, WsAlertErrorResponse, WsAlertEventType, WsAlertSubscribeMessage, WsAlertUnsubscribeMessage, WsAlertEventPayload, WsAlertSubscribeMap, WsAlertEventDataMap, WsAlertEventName, TradeStreamEvent, AssetPriceTickEvent, AssetPriceWindowUpdateEvent, AssetWindowUpdateEvent, MarketMetricsEvent, EventMetricsEvent, PositionMetricsEvent, TagMetricsEvent, TraderGlobalPnlBatchEvent, TraderMarketPnlBatchEvent, TraderCategoryPnlBatchEvent, TraderGlobalTickBatchEvent, TraderMarketTickBatchEvent, TraderCategoryTickBatchEvent, TraderGlobalResolutionBatchEvent, TraderMarketResolutionBatchEvent, TraderCategoryResolutionBatchEvent, AccountsUpdateEvent, UsdceUpdateEvent, MaticUpdateEvent, PusdUpdateEvent, WsOrderBookLevel, OrderBookUpdateEvent, TradesStreamSubscribeResponse, AssetPricesSubscribeResponse, AssetWindowUpdatesSubscribeResponse, MarketMetricsSubscribeResponse, EventMetricsSubscribeResponse, PositionMetricsSubscribeResponse, TagMetricsSubscribeResponse, TraderPnlSubscribeResponse, AccountsSubscribeResponse, OrderBookSubscribeResponse, TradeOrderFilledEvent, TradeRedemptionEvent, TradeMergeEvent, TradeSplitEvent, TradePositionsConvertedEvent, TradeCancelledEvent, TradeOracleLifecycleEvent, TradeRegisterTokenEvent, } from "./ws.js";
@@ -1,4 +1,5 @@
1
1
  import type { RetryConfig } from "./http.js";
2
+ import type { Event, MarketResponse } from "./index.js";
2
3
  import type { WsSchemas, WsAlertSchemas, WsAlertSubscribeMap, WsAlertEventDataMap, WsAlertEventName } from "./ws-helpers.js";
3
4
  export type ConnectionState = "disconnected" | "connecting" | "connected" | "reconnecting";
4
5
  export interface StructWebSocketConfig {
@@ -76,8 +77,10 @@ export type TraderPositionsSubscribeResponse = WsSchemas["TraderPositionsSubscri
76
77
  export type ClobRewardsUpdateEvent = WsSchemas["ClobRewardsUpdateEvent"];
77
78
  export type ClobRewardsSubscribeResponse = WsSchemas["ClobRewardsSubscribeResponse"];
78
79
  export type EventsStreamUpdateEvent = WsSchemas["EventsStreamUpdateEvent"];
80
+ export type EventsStreamUpdateRows = Event[];
79
81
  export type EventsStreamSubscribeResponse = WsSchemas["EventsStreamSubscribeResponse"];
80
82
  export type MarketsStreamUpdateEvent = WsSchemas["MarketsStreamUpdateEvent"];
83
+ export type MarketsStreamUpdateRows = MarketResponse[];
81
84
  export type MarketsStreamSubscribeResponse = WsSchemas["MarketsStreamSubscribeResponse"];
82
85
  export type OracleEventStreamEvent = WsSchemas["OracleEventTyped"];
83
86
  export type OracleEventsStreamSubscribeResponse = WsSchemas["OracleEventsStreamSubscribeResponse"];
@@ -162,8 +165,8 @@ export interface WebSocketEventMap {
162
165
  pusd_update: PusdUpdateEvent;
163
166
  order_book_update: OrderBookUpdateEvent;
164
167
  clob_rewards_update: ClobRewardsUpdateEvent;
165
- events_stream_update: EventsStreamUpdateEvent;
166
- markets_stream_update: MarketsStreamUpdateEvent;
168
+ events_stream_update: EventsStreamUpdateRows;
169
+ markets_stream_update: MarketsStreamUpdateRows;
167
170
  oracle_event_update: OracleEventStreamEvent;
168
171
  position_liquidity_update: PositionLiquidityEvent;
169
172
  market_liquidity_update: MarketLiquidityEvent;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@structbuild/sdk",
3
- "version": "0.6.6",
3
+ "version": "0.6.7",
4
4
  "type": "module",
5
5
  "repository": {
6
6
  "type": "git",