@structbuild/sdk 0.3.9 → 0.3.10-staging.1

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.
@@ -3,7 +3,7 @@
3
3
  * Do not make direct changes to the file.
4
4
  */
5
5
  export interface paths {
6
- "/polymarket/asset-history": {
6
+ "/polymarket/analytics/candles": {
7
7
  parameters: {
8
8
  query?: never;
9
9
  header?: never;
@@ -11,10 +11,30 @@ export interface paths {
11
11
  cookie?: never;
12
12
  };
13
13
  /**
14
- * Get Asset Price History
15
- * @description Returns historical price data for supported crypto assets from Polymarket API
14
+ * Global analytics candles (per-bucket deltas)
15
+ * @description Returns per-bucket deltas (volume, traders, fees etc. that happened *during* each bucket). Use for bar-chart visualisations of activity over time.
16
16
  */
17
- get: operations["get_asset_history"];
17
+ get: operations["get_global_analytics_candles"];
18
+ put?: never;
19
+ post?: never;
20
+ delete?: never;
21
+ options?: never;
22
+ head?: never;
23
+ patch?: never;
24
+ trace?: never;
25
+ };
26
+ "/polymarket/analytics/changes": {
27
+ parameters: {
28
+ query?: never;
29
+ header?: never;
30
+ path?: never;
31
+ cookie?: never;
32
+ };
33
+ /**
34
+ * Global analytics % change
35
+ * @description Returns % change for each metric over the requested lookback window. `null` fields mean the window predates the available data.
36
+ */
37
+ get: operations["get_global_analytics_changes"];
18
38
  put?: never;
19
39
  post?: never;
20
40
  delete?: never;
@@ -23,7 +43,7 @@ export interface paths {
23
43
  patch?: never;
24
44
  trace?: never;
25
45
  };
26
- "/polymarket/counts": {
46
+ "/polymarket/analytics/counts": {
27
47
  parameters: {
28
48
  query?: never;
29
49
  header?: never;
@@ -31,10 +51,50 @@ export interface paths {
31
51
  cookie?: never;
32
52
  };
33
53
  /**
34
- * Get counts
35
- * @description Returns total counts of Polymarket events, markets, tags, positions, and traders.
54
+ * Global analytics snapshot
55
+ * @description Returns the latest cumulative analytics metrics across all of Polymarket: volume, traders, txn counts, fees, yes/no splits, and buy distribution.
36
56
  */
37
- get: operations["get_counts"];
57
+ get: operations["get_analytics_counts"];
58
+ put?: never;
59
+ post?: never;
60
+ delete?: never;
61
+ options?: never;
62
+ head?: never;
63
+ patch?: never;
64
+ trace?: never;
65
+ };
66
+ "/polymarket/analytics/timeseries": {
67
+ parameters: {
68
+ query?: never;
69
+ header?: never;
70
+ path?: never;
71
+ cookie?: never;
72
+ };
73
+ /**
74
+ * Global analytics timeseries (cumulative)
75
+ * @description Returns cumulative analytics values at the end of each bucket. Use for running-total line charts of global volume, traders, fees over time.
76
+ */
77
+ get: operations["get_global_analytics_timeseries"];
78
+ put?: never;
79
+ post?: never;
80
+ delete?: never;
81
+ options?: never;
82
+ head?: never;
83
+ patch?: never;
84
+ trace?: never;
85
+ };
86
+ "/polymarket/asset-history": {
87
+ parameters: {
88
+ query?: never;
89
+ header?: never;
90
+ path?: never;
91
+ cookie?: never;
92
+ };
93
+ /**
94
+ * Get Asset Price History
95
+ * @description Returns historical price data for supported crypto assets from Polymarket API
96
+ */
97
+ get: operations["get_asset_history"];
38
98
  put?: never;
39
99
  post?: never;
40
100
  delete?: never;
@@ -143,6 +203,66 @@ export interface paths {
143
203
  patch?: never;
144
204
  trace?: never;
145
205
  };
206
+ "/polymarket/events/{event_slug}/analytics/candles": {
207
+ parameters: {
208
+ query?: never;
209
+ header?: never;
210
+ path?: never;
211
+ cookie?: never;
212
+ };
213
+ /**
214
+ * Event analytics candles (per-bucket deltas)
215
+ * @description Returns per-bucket deltas for a specific event (what happened during each bucket).
216
+ */
217
+ get: operations["get_event_analytics_candles"];
218
+ put?: never;
219
+ post?: never;
220
+ delete?: never;
221
+ options?: never;
222
+ head?: never;
223
+ patch?: never;
224
+ trace?: never;
225
+ };
226
+ "/polymarket/events/{event_slug}/analytics/changes": {
227
+ parameters: {
228
+ query?: never;
229
+ header?: never;
230
+ path?: never;
231
+ cookie?: never;
232
+ };
233
+ /**
234
+ * Event analytics % change
235
+ * @description Per-metric % change over the requested lookback window for a specific event.
236
+ */
237
+ get: operations["get_event_analytics_changes"];
238
+ put?: never;
239
+ post?: never;
240
+ delete?: never;
241
+ options?: never;
242
+ head?: never;
243
+ patch?: never;
244
+ trace?: never;
245
+ };
246
+ "/polymarket/events/{event_slug}/analytics/timeseries": {
247
+ parameters: {
248
+ query?: never;
249
+ header?: never;
250
+ path?: never;
251
+ cookie?: never;
252
+ };
253
+ /**
254
+ * Event analytics timeseries (cumulative)
255
+ * @description Returns cumulative analytics values for a specific event at the end of each bucket.
256
+ */
257
+ get: operations["get_event_analytics_timeseries"];
258
+ put?: never;
259
+ post?: never;
260
+ delete?: never;
261
+ options?: never;
262
+ head?: never;
263
+ patch?: never;
264
+ trace?: never;
265
+ };
146
266
  "/polymarket/events/{identifier}": {
147
267
  parameters: {
148
268
  query?: never;
@@ -272,7 +392,7 @@ export interface paths {
272
392
  };
273
393
  /**
274
394
  * Get bonds
275
- * @description Retrieve bond markets with sorting, probability range filter, and offset pagination
395
+ * @description Retrieve bond markets with sorting, probability range filter, and deterministic keyset pagination.
276
396
  */
277
397
  get: operations["get_bonds"];
278
398
  put?: never;
@@ -503,6 +623,66 @@ export interface paths {
503
623
  patch?: never;
504
624
  trace?: never;
505
625
  };
626
+ "/polymarket/market/{condition_id}/analytics/candles": {
627
+ parameters: {
628
+ query?: never;
629
+ header?: never;
630
+ path?: never;
631
+ cookie?: never;
632
+ };
633
+ /**
634
+ * Market analytics candles (per-bucket deltas)
635
+ * @description Returns per-bucket deltas for a specific market (what happened during each bucket).
636
+ */
637
+ get: operations["get_market_analytics_candles"];
638
+ put?: never;
639
+ post?: never;
640
+ delete?: never;
641
+ options?: never;
642
+ head?: never;
643
+ patch?: never;
644
+ trace?: never;
645
+ };
646
+ "/polymarket/market/{condition_id}/analytics/changes": {
647
+ parameters: {
648
+ query?: never;
649
+ header?: never;
650
+ path?: never;
651
+ cookie?: never;
652
+ };
653
+ /**
654
+ * Market analytics % change
655
+ * @description Per-metric % change over the requested lookback window for a specific market.
656
+ */
657
+ get: operations["get_market_analytics_changes"];
658
+ put?: never;
659
+ post?: never;
660
+ delete?: never;
661
+ options?: never;
662
+ head?: never;
663
+ patch?: never;
664
+ trace?: never;
665
+ };
666
+ "/polymarket/market/{condition_id}/analytics/timeseries": {
667
+ parameters: {
668
+ query?: never;
669
+ header?: never;
670
+ path?: never;
671
+ cookie?: never;
672
+ };
673
+ /**
674
+ * Market analytics timeseries (cumulative)
675
+ * @description Returns cumulative analytics values for a specific market at the end of each bucket.
676
+ */
677
+ get: operations["get_market_analytics_timeseries"];
678
+ put?: never;
679
+ post?: never;
680
+ delete?: never;
681
+ options?: never;
682
+ head?: never;
683
+ patch?: never;
684
+ trace?: never;
685
+ };
506
686
  "/polymarket/order-book": {
507
687
  parameters: {
508
688
  query?: never;
@@ -703,6 +883,66 @@ export interface paths {
703
883
  patch?: never;
704
884
  trace?: never;
705
885
  };
886
+ "/polymarket/tags/{tag}/analytics/candles": {
887
+ parameters: {
888
+ query?: never;
889
+ header?: never;
890
+ path?: never;
891
+ cookie?: never;
892
+ };
893
+ /**
894
+ * Tag analytics candles (per-bucket deltas)
895
+ * @description Returns per-bucket deltas for a specific tag (what happened during each bucket).
896
+ */
897
+ get: operations["get_tag_analytics_candles"];
898
+ put?: never;
899
+ post?: never;
900
+ delete?: never;
901
+ options?: never;
902
+ head?: never;
903
+ patch?: never;
904
+ trace?: never;
905
+ };
906
+ "/polymarket/tags/{tag}/analytics/changes": {
907
+ parameters: {
908
+ query?: never;
909
+ header?: never;
910
+ path?: never;
911
+ cookie?: never;
912
+ };
913
+ /**
914
+ * Tag analytics % change
915
+ * @description Per-metric % change over the requested lookback window for a specific tag.
916
+ */
917
+ get: operations["get_tag_analytics_changes"];
918
+ put?: never;
919
+ post?: never;
920
+ delete?: never;
921
+ options?: never;
922
+ head?: never;
923
+ patch?: never;
924
+ trace?: never;
925
+ };
926
+ "/polymarket/tags/{tag}/analytics/timeseries": {
927
+ parameters: {
928
+ query?: never;
929
+ header?: never;
930
+ path?: never;
931
+ cookie?: never;
932
+ };
933
+ /**
934
+ * Tag analytics timeseries (cumulative)
935
+ * @description Returns cumulative analytics values for a specific tag at the end of each bucket.
936
+ */
937
+ get: operations["get_tag_analytics_timeseries"];
938
+ put?: never;
939
+ post?: never;
940
+ delete?: never;
941
+ options?: never;
942
+ head?: never;
943
+ patch?: never;
944
+ trace?: never;
945
+ };
706
946
  "/polymarket/trader/global_pnl": {
707
947
  parameters: {
708
948
  query?: never;
@@ -943,6 +1183,66 @@ export interface paths {
943
1183
  patch?: never;
944
1184
  trace?: never;
945
1185
  };
1186
+ "/polymarket/trader/{address}/analytics/candles": {
1187
+ parameters: {
1188
+ query?: never;
1189
+ header?: never;
1190
+ path?: never;
1191
+ cookie?: never;
1192
+ };
1193
+ /**
1194
+ * Trader analytics candles (per-bucket deltas)
1195
+ * @description Returns per-bucket deltas for a specific trader address (what happened during each bucket).
1196
+ */
1197
+ get: operations["get_trader_analytics_candles"];
1198
+ put?: never;
1199
+ post?: never;
1200
+ delete?: never;
1201
+ options?: never;
1202
+ head?: never;
1203
+ patch?: never;
1204
+ trace?: never;
1205
+ };
1206
+ "/polymarket/trader/{address}/analytics/changes": {
1207
+ parameters: {
1208
+ query?: never;
1209
+ header?: never;
1210
+ path?: never;
1211
+ cookie?: never;
1212
+ };
1213
+ /**
1214
+ * Trader analytics % change
1215
+ * @description Per-metric % change over the requested lookback window for a specific trader address.
1216
+ */
1217
+ get: operations["get_trader_analytics_changes"];
1218
+ put?: never;
1219
+ post?: never;
1220
+ delete?: never;
1221
+ options?: never;
1222
+ head?: never;
1223
+ patch?: never;
1224
+ trace?: never;
1225
+ };
1226
+ "/polymarket/trader/{address}/analytics/timeseries": {
1227
+ parameters: {
1228
+ query?: never;
1229
+ header?: never;
1230
+ path?: never;
1231
+ cookie?: never;
1232
+ };
1233
+ /**
1234
+ * Trader analytics timeseries (cumulative)
1235
+ * @description Returns cumulative analytics values for a specific trader address at the end of each bucket.
1236
+ */
1237
+ get: operations["get_trader_analytics_timeseries"];
1238
+ put?: never;
1239
+ post?: never;
1240
+ delete?: never;
1241
+ options?: never;
1242
+ head?: never;
1243
+ patch?: never;
1244
+ trace?: never;
1245
+ };
946
1246
  }
947
1247
  export type webhooks = Record<string, never>;
948
1248
  export interface components {
@@ -1117,6 +1417,8 @@ export interface components {
1117
1417
  /** Format: double */
1118
1418
  price: number;
1119
1419
  };
1420
+ /** @enum {string} */
1421
+ BondsSortBy: "end_date" | "apy" | "liquidity" | "volume";
1120
1422
  /** @description Output payload for Cancelled orders. */
1121
1423
  CancelledTrade: {
1122
1424
  id: string;
@@ -1140,6 +1442,11 @@ export interface components {
1140
1442
  };
1141
1443
  /** @enum {string} */
1142
1444
  CandlestickResolution: "1" | "5" | "15" | "30" | "60" | "240" | "D" | "1D";
1445
+ /**
1446
+ * @description Lookback window for `/analytics/changes` endpoints.
1447
+ * @enum {string}
1448
+ */
1449
+ ChangeTimeframe: "1h" | "24h" | "7d" | "30d" | "1y";
1143
1450
  /** @enum {string} */
1144
1451
  ChartResolution: "1H" | "6H" | "1D" | "1W" | "1M" | "ALL";
1145
1452
  /** @description CLOB reward (public API format) */
@@ -1227,18 +1534,6 @@ export interface components {
1227
1534
  slug?: string | null;
1228
1535
  event_slug?: string | null;
1229
1536
  };
1230
- CountsResponse: {
1231
- /** Format: int64 */
1232
- tags: number;
1233
- /** Format: int64 */
1234
- events: number;
1235
- /** Format: int64 */
1236
- markets: number;
1237
- /** Format: int64 */
1238
- positions: number;
1239
- /** Format: int64 */
1240
- traders: number;
1241
- };
1242
1537
  /** @description Enriched market data for event API responses */
1243
1538
  EventMarket: {
1244
1539
  /** @default */
@@ -1324,19 +1619,90 @@ export interface components {
1324
1619
  event_slug: string;
1325
1620
  timeframe: string;
1326
1621
  /** Format: double */
1327
- volume_usd: number;
1622
+ volume_usd: number;
1623
+ /** Format: double */
1624
+ fees: number;
1625
+ /** Format: int32 */
1626
+ txns: number;
1627
+ /** Format: int32 */
1628
+ unique_traders: number;
1629
+ };
1630
+ /** @enum {string} */
1631
+ EventPnlSortBy: "realized_pnl_usd" | "total_volume_usd" | "markets_traded" | "total_fees" | "realized_pnl_pct";
1632
+ /** @enum {string} */
1633
+ EventSortBy: "volume" | "txns" | "unique_traders" | "title" | "creation_date" | "start_date" | "end_date" | "relevance";
1634
+ /**
1635
+ * @description Response body for `GET /polymarket/analytics/counts`.
1636
+ * Cumulative analytics metrics (from ClickHouse `analytics_global`) plus
1637
+ * entity-count enrichment (from Postgres `pg_class.reltuples` estimates).
1638
+ */
1639
+ GlobalCountsResponse: {
1640
+ /**
1641
+ * Format: int32
1642
+ * @description Unix-second timestamp of the latest block reflected in the metrics.
1643
+ */
1644
+ ts: number;
1645
+ /**
1646
+ * Format: int64
1647
+ * @description Latest block number processed.
1648
+ */
1649
+ block: number;
1650
+ /** Format: double */
1651
+ volume_usd: number;
1652
+ /** Format: double */
1653
+ buy_volume_usd: number;
1654
+ /** Format: double */
1655
+ sell_volume_usd: number;
1656
+ /** Format: int64 */
1657
+ unique_traders: number;
1658
+ /** Format: int64 */
1659
+ txn_count: number;
1660
+ /** Format: int64 */
1661
+ buy_count: number;
1662
+ /** Format: int64 */
1663
+ sell_count: number;
1664
+ /** Format: int64 */
1665
+ redemption_count: number;
1666
+ /** Format: double */
1667
+ redemption_volume_usd: number;
1668
+ /** Format: int64 */
1669
+ merge_count: number;
1670
+ /** Format: int64 */
1671
+ split_count: number;
1672
+ /** Format: double */
1673
+ fees_usd: number;
1328
1674
  /** Format: double */
1329
- fees: number;
1330
- /** Format: int32 */
1331
- txns: number;
1332
- /** Format: int32 */
1333
- unique_traders: number;
1675
+ shares_volume: number;
1676
+ /** Format: double */
1677
+ yes_volume_usd: number;
1678
+ /** Format: double */
1679
+ no_volume_usd: number;
1680
+ /** Format: int64 */
1681
+ yes_count: number;
1682
+ /** Format: int64 */
1683
+ no_count: number;
1684
+ /**
1685
+ * Format: int64
1686
+ * @description Estimated row count of `polymarket_tags` (Postgres pg_class.reltuples).
1687
+ */
1688
+ tags: number;
1689
+ /**
1690
+ * Format: int64
1691
+ * @description Estimated row count of `polymarket_events`.
1692
+ */
1693
+ events: number;
1694
+ /**
1695
+ * Format: int64
1696
+ * @description Estimated row count of `prediction_markets`.
1697
+ */
1698
+ markets: number;
1699
+ /**
1700
+ * Format: int64
1701
+ * @description Estimated row count of `polymarket_accounts` (traders / positions).
1702
+ */
1703
+ positions: number;
1334
1704
  };
1335
1705
  /** @enum {string} */
1336
- EventPnlSortBy: "realized_pnl_usd" | "total_volume_usd" | "markets_traded" | "total_fees" | "realized_pnl_pct";
1337
- /** @enum {string} */
1338
- EventSortBy: "volume" | "txns" | "unique_traders" | "title" | "creation_date" | "start_date" | "end_date" | "relevance";
1339
- /** @enum {string} */
1340
1706
  GlobalPnlSortBy: "realized_pnl_usd" | "buys" | "sells" | "redemptions" | "merges" | "avg_hold_time" | "markets_traded" | "events_traded" | "markets_won" | "volume_usd" | "fees" | "best_trade";
1341
1707
  /** @description Individual trader entry in the global PnL leaderboard */
1342
1708
  GlobalPnlTrader: {
@@ -1660,6 +2026,30 @@ export interface components {
1660
2026
  position_details?: components["schemas"]["PositionDetail"][];
1661
2027
  exchange: components["schemas"]["PolymarketExchange"];
1662
2028
  };
2029
+ /**
2030
+ * @description Per-metric % change. `None` when the window predates the entity's data
2031
+ * or the previous value was zero (division undefined).
2032
+ */
2033
+ MetricPctChange: {
2034
+ /** Format: double */
2035
+ volume_usd?: number | null;
2036
+ /** Format: double */
2037
+ buy_volume_usd?: number | null;
2038
+ /** Format: double */
2039
+ sell_volume_usd?: number | null;
2040
+ /** Format: double */
2041
+ unique_traders?: number | null;
2042
+ /** Format: double */
2043
+ txn_count?: number | null;
2044
+ /** Format: double */
2045
+ fees_usd?: number | null;
2046
+ /** Format: double */
2047
+ shares_volume?: number | null;
2048
+ /** Format: double */
2049
+ yes_volume_usd?: number | null;
2050
+ /** Format: double */
2051
+ no_volume_usd?: number | null;
2052
+ };
1663
2053
  /** @enum {string} */
1664
2054
  MetricsTimeframe: "1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d" | "lifetime";
1665
2055
  /** @description NegRisk Adapter: outcome reported for a neg-risk market question. */
@@ -1726,6 +2116,11 @@ export interface components {
1726
2116
  /** Format: double */
1727
2117
  fee_pct?: number | null;
1728
2118
  exchange: components["schemas"]["PolymarketExchange"];
2119
+ /**
2120
+ * @description CLOB V2 builder code (lower-cased "0x..." bytes32 hex). Always absent for V1
2121
+ * trades and may be `0x0000…` for V2 trades placed without a builder code.
2122
+ */
2123
+ builder_code?: string | null;
1729
2124
  };
1730
2125
  OrderbookHistoryRow: {
1731
2126
  /** Format: int64 */
@@ -1981,10 +2376,12 @@ export interface components {
1981
2376
  series: null | components["schemas"]["PolymarketSeries"];
1982
2377
  };
1983
2378
  /**
1984
- * @description Polymarket exchange contract types
2379
+ * @description Polymarket exchange contract types.
2380
+ * `repr(u8)` discriminants double as the database column value — DO NOT renumber
2381
+ * existing variants. New variants get fresh numbers.
1985
2382
  * @enum {string}
1986
2383
  */
1987
- PolymarketExchange: "CTFExchange" | "NegRiskExchange" | "ConditionalTokens" | "NegRiskAdapter" | "Unknown";
2384
+ PolymarketExchange: "CTFExchange" | "NegRiskExchange" | "ConditionalTokens" | "NegRiskAdapter" | "CTFExchangeV2" | "NegRiskExchangeV2" | "Unknown";
1988
2385
  /**
1989
2386
  * @description A Polymarket series from the Gamma API
1990
2387
  * Series are parent groupings above events (e.g., "NBA Season 2024-25")
@@ -2231,6 +2628,8 @@ export interface components {
2231
2628
  trades_count: number;
2232
2629
  condition_id: string;
2233
2630
  };
2631
+ /** @enum {string} */
2632
+ PriceJumpResolution: "1" | "5" | "15" | "30" | "60" | "240";
2234
2633
  /** @description UMA CTF Adapter: admin emergency resolution. */
2235
2634
  QuestionEmergencyResolvedEvent: {
2236
2635
  id: string;
@@ -2552,6 +2951,35 @@ export interface components {
2552
2951
  /** Format: int32 */
2553
2952
  ask_levels?: number | null;
2554
2953
  };
2954
+ /**
2955
+ * @description Timeseries bucket row.
2956
+ * Short field names for compact JSON responses:
2957
+ * t=bucket (unix seconds), v=volume_usd, bv=buy_volume_usd, sv=sell_volume_usd,
2958
+ * ut=unique_traders, tc=txn_count, f=fees_usd, sh=shares_volume,
2959
+ * yv=yes_volume_usd, nv=no_volume_usd
2960
+ */
2961
+ TimeBucketRow: {
2962
+ /** Format: int32 */
2963
+ t: number;
2964
+ /** Format: double */
2965
+ v: number;
2966
+ /** Format: double */
2967
+ bv: number;
2968
+ /** Format: double */
2969
+ sv: number;
2970
+ /** Format: int64 */
2971
+ ut: number;
2972
+ /** Format: int64 */
2973
+ tc: number;
2974
+ /** Format: double */
2975
+ f: number;
2976
+ /** Format: double */
2977
+ sh: number;
2978
+ /** Format: double */
2979
+ yv: number;
2980
+ /** Format: double */
2981
+ nv: number;
2982
+ };
2555
2983
  /** @description Token outcome (position) */
2556
2984
  TokenOutcome: {
2557
2985
  token_id: string;
@@ -2901,6 +3329,111 @@ export interface components {
2901
3329
  }
2902
3330
  export type $defs = Record<string, never>;
2903
3331
  export interface operations {
3332
+ get_global_analytics_candles: {
3333
+ parameters: {
3334
+ query?: {
3335
+ /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
3336
+ resolution?: components["schemas"]["CandlestickResolution"];
3337
+ /** @description Start timestamp (Unix seconds). Omit for all-time. */
3338
+ from?: number;
3339
+ /** @description End timestamp (Unix seconds) */
3340
+ to?: number;
3341
+ /** @description Max data points (default: 500, max: 2500) */
3342
+ count_back?: number;
3343
+ /** @description Cursor from previous response for next page */
3344
+ pagination_key?: string;
3345
+ };
3346
+ header?: never;
3347
+ path?: never;
3348
+ cookie?: never;
3349
+ };
3350
+ requestBody?: never;
3351
+ responses: {
3352
+ /** @description Delta time-bucketed analytics */
3353
+ 200: {
3354
+ headers: {
3355
+ [name: string]: unknown;
3356
+ };
3357
+ content: {
3358
+ "application/json": components["schemas"]["TimeBucketRow"][];
3359
+ };
3360
+ };
3361
+ };
3362
+ };
3363
+ get_global_analytics_changes: {
3364
+ parameters: {
3365
+ query: {
3366
+ /** @description Lookback window: 1h, 24h, 7d, 30d, 1y */
3367
+ timeframe: components["schemas"]["ChangeTimeframe"];
3368
+ };
3369
+ header?: never;
3370
+ path?: never;
3371
+ cookie?: never;
3372
+ };
3373
+ requestBody?: never;
3374
+ responses: {
3375
+ /** @description Per-metric pct change */
3376
+ 200: {
3377
+ headers: {
3378
+ [name: string]: unknown;
3379
+ };
3380
+ content: {
3381
+ "application/json": components["schemas"]["MetricPctChange"];
3382
+ };
3383
+ };
3384
+ };
3385
+ };
3386
+ get_analytics_counts: {
3387
+ parameters: {
3388
+ query?: never;
3389
+ header?: never;
3390
+ path?: never;
3391
+ cookie?: never;
3392
+ };
3393
+ requestBody?: never;
3394
+ responses: {
3395
+ /** @description Latest global metrics snapshot */
3396
+ 200: {
3397
+ headers: {
3398
+ [name: string]: unknown;
3399
+ };
3400
+ content: {
3401
+ "application/json": components["schemas"]["GlobalCountsResponse"];
3402
+ };
3403
+ };
3404
+ };
3405
+ };
3406
+ get_global_analytics_timeseries: {
3407
+ parameters: {
3408
+ query?: {
3409
+ /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
3410
+ resolution?: components["schemas"]["CandlestickResolution"];
3411
+ /** @description Start timestamp (Unix seconds). Omit for all-time. */
3412
+ from?: number;
3413
+ /** @description End timestamp (Unix seconds) */
3414
+ to?: number;
3415
+ /** @description Max data points (default: 500, max: 2500) */
3416
+ count_back?: number;
3417
+ /** @description Cursor from previous response for next page */
3418
+ pagination_key?: string;
3419
+ };
3420
+ header?: never;
3421
+ path?: never;
3422
+ cookie?: never;
3423
+ };
3424
+ requestBody?: never;
3425
+ responses: {
3426
+ /** @description Cumulative time-bucketed analytics */
3427
+ 200: {
3428
+ headers: {
3429
+ [name: string]: unknown;
3430
+ };
3431
+ content: {
3432
+ "application/json": components["schemas"]["TimeBucketRow"][];
3433
+ };
3434
+ };
3435
+ };
3436
+ };
2904
3437
  get_asset_history: {
2905
3438
  parameters: {
2906
3439
  query: {
@@ -2957,26 +3490,6 @@ export interface operations {
2957
3490
  };
2958
3491
  };
2959
3492
  };
2960
- get_counts: {
2961
- parameters: {
2962
- query?: never;
2963
- header?: never;
2964
- path?: never;
2965
- cookie?: never;
2966
- };
2967
- requestBody?: never;
2968
- responses: {
2969
- /** @description Total counts */
2970
- 200: {
2971
- headers: {
2972
- [name: string]: unknown;
2973
- };
2974
- content: {
2975
- "application/json": components["schemas"]["CountsResponse"];
2976
- };
2977
- };
2978
- };
2979
- };
2980
3493
  get_events: {
2981
3494
  parameters: {
2982
3495
  query?: {
@@ -3144,21 +3657,122 @@ export interface operations {
3144
3657
  headers: {
3145
3658
  [name: string]: unknown;
3146
3659
  };
3147
- content?: never;
3660
+ content?: never;
3661
+ };
3662
+ };
3663
+ };
3664
+ get_event_by_slug: {
3665
+ parameters: {
3666
+ query?: {
3667
+ /** @description Include tags array (default: true) */
3668
+ include_tags?: boolean;
3669
+ /** @description Include markets array with outcomes (default: true) */
3670
+ include_markets?: boolean;
3671
+ /** @description Include metrics object with all timeframes (default: true) */
3672
+ include_metrics?: boolean;
3673
+ /** @description Return truncated response optimized for AI consumers (default: false) */
3674
+ ai?: boolean;
3675
+ };
3676
+ header?: never;
3677
+ path: {
3678
+ /** @description Event slug */
3679
+ event_slug: string;
3680
+ };
3681
+ cookie?: never;
3682
+ };
3683
+ requestBody?: never;
3684
+ responses: {
3685
+ /** @description Event with nested tags, markets, and series */
3686
+ 200: {
3687
+ headers: {
3688
+ [name: string]: unknown;
3689
+ };
3690
+ content: {
3691
+ "application/json": components["schemas"]["PolymarketEvent"];
3692
+ };
3693
+ };
3694
+ /** @description Event not found */
3695
+ 404: {
3696
+ headers: {
3697
+ [name: string]: unknown;
3698
+ };
3699
+ content?: never;
3700
+ };
3701
+ };
3702
+ };
3703
+ get_event_analytics_candles: {
3704
+ parameters: {
3705
+ query?: {
3706
+ /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
3707
+ resolution?: components["schemas"]["CandlestickResolution"];
3708
+ /** @description Start timestamp (Unix seconds) */
3709
+ from?: number;
3710
+ /** @description End timestamp (Unix seconds) */
3711
+ to?: number;
3712
+ /** @description Max data points (default: 500, max: 2500) */
3713
+ count_back?: number;
3714
+ /** @description Cursor from previous response */
3715
+ pagination_key?: string;
3716
+ };
3717
+ header?: never;
3718
+ path: {
3719
+ /** @description Event slug */
3720
+ event_slug: string;
3721
+ };
3722
+ cookie?: never;
3723
+ };
3724
+ requestBody?: never;
3725
+ responses: {
3726
+ /** @description Delta time-bucketed event analytics */
3727
+ 200: {
3728
+ headers: {
3729
+ [name: string]: unknown;
3730
+ };
3731
+ content: {
3732
+ "application/json": components["schemas"]["TimeBucketRow"][];
3733
+ };
3734
+ };
3735
+ };
3736
+ };
3737
+ get_event_analytics_changes: {
3738
+ parameters: {
3739
+ query: {
3740
+ /** @description Lookback window: 1h, 24h, 7d, 30d, 1y */
3741
+ timeframe: components["schemas"]["ChangeTimeframe"];
3742
+ };
3743
+ header?: never;
3744
+ path: {
3745
+ /** @description Event slug */
3746
+ event_slug: string;
3747
+ };
3748
+ cookie?: never;
3749
+ };
3750
+ requestBody?: never;
3751
+ responses: {
3752
+ /** @description Per-metric pct change */
3753
+ 200: {
3754
+ headers: {
3755
+ [name: string]: unknown;
3756
+ };
3757
+ content: {
3758
+ "application/json": components["schemas"]["MetricPctChange"];
3759
+ };
3148
3760
  };
3149
3761
  };
3150
3762
  };
3151
- get_event_by_slug: {
3763
+ get_event_analytics_timeseries: {
3152
3764
  parameters: {
3153
3765
  query?: {
3154
- /** @description Include tags array (default: true) */
3155
- include_tags?: boolean;
3156
- /** @description Include markets array with outcomes (default: true) */
3157
- include_markets?: boolean;
3158
- /** @description Include metrics object with all timeframes (default: true) */
3159
- include_metrics?: boolean;
3160
- /** @description Return truncated response optimized for AI consumers (default: false) */
3161
- ai?: boolean;
3766
+ /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
3767
+ resolution?: components["schemas"]["CandlestickResolution"];
3768
+ /** @description Start timestamp (Unix seconds) */
3769
+ from?: number;
3770
+ /** @description End timestamp (Unix seconds) */
3771
+ to?: number;
3772
+ /** @description Max data points (default: 500, max: 2500) */
3773
+ count_back?: number;
3774
+ /** @description Cursor from previous response */
3775
+ pagination_key?: string;
3162
3776
  };
3163
3777
  header?: never;
3164
3778
  path: {
@@ -3169,21 +3783,14 @@ export interface operations {
3169
3783
  };
3170
3784
  requestBody?: never;
3171
3785
  responses: {
3172
- /** @description Event with nested tags, markets, and series */
3786
+ /** @description Cumulative time-bucketed event analytics */
3173
3787
  200: {
3174
3788
  headers: {
3175
3789
  [name: string]: unknown;
3176
3790
  };
3177
3791
  content: {
3178
- "application/json": components["schemas"]["PolymarketEvent"];
3179
- };
3180
- };
3181
- /** @description Event not found */
3182
- 404: {
3183
- headers: {
3184
- [name: string]: unknown;
3792
+ "application/json": components["schemas"]["TimeBucketRow"][];
3185
3793
  };
3186
- content?: never;
3187
3794
  };
3188
3795
  };
3189
3796
  };
@@ -3500,11 +4107,13 @@ export interface operations {
3500
4107
  /** @description Maximum hours until market end */
3501
4108
  max_hours?: number;
3502
4109
  /** @description Sort by: apy, liquidity, volume, end_date (default: end_date) */
3503
- sort_by?: string;
4110
+ sort_by?: components["schemas"]["BondsSortBy"];
3504
4111
  /** @description Number of results (default: 10, max: 250) */
3505
4112
  limit?: number;
3506
- /** @description Offset for pagination (default: 0) */
4113
+ /** @description Initial skip (default: 0). Applied only on the first page; ignored when pagination_key is supplied. */
3507
4114
  offset?: number;
4115
+ /** @description Keyset cursor from previous response. Opaque token — pass verbatim to fetch the next page. */
4116
+ pagination_key?: string;
3508
4117
  };
3509
4118
  header?: never;
3510
4119
  path?: never;
@@ -3723,7 +4332,7 @@ export interface operations {
3723
4332
  /** @description Market slug (resolved to condition_id) */
3724
4333
  market_slug?: string;
3725
4334
  /** @description Candle resolution in minutes: 1, 5, 15, 30, 60, 240 (default: 15) */
3726
- resolution?: string;
4335
+ resolution?: components["schemas"]["PriceJumpResolution"];
3727
4336
  /** @description Minimum relative percent change to qualify as a jump (default: 10.0) */
3728
4337
  min_change_pct?: number;
3729
4338
  /** @description Number of candles to scan back from now (default: 1440, max: 2500) */
@@ -4056,6 +4665,100 @@ export interface operations {
4056
4665
  };
4057
4666
  };
4058
4667
  };
4668
+ get_market_analytics_candles: {
4669
+ parameters: {
4670
+ query?: {
4671
+ /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
4672
+ resolution?: components["schemas"]["CandlestickResolution"];
4673
+ /** @description Start timestamp (Unix seconds) */
4674
+ from?: number;
4675
+ /** @description End timestamp (Unix seconds) */
4676
+ to?: number;
4677
+ /** @description Max data points (default: 500, max: 2500) */
4678
+ count_back?: number;
4679
+ /** @description Cursor from previous response */
4680
+ pagination_key?: string;
4681
+ };
4682
+ header?: never;
4683
+ path: {
4684
+ /** @description Market condition ID */
4685
+ condition_id: string;
4686
+ };
4687
+ cookie?: never;
4688
+ };
4689
+ requestBody?: never;
4690
+ responses: {
4691
+ /** @description Delta time-bucketed market analytics */
4692
+ 200: {
4693
+ headers: {
4694
+ [name: string]: unknown;
4695
+ };
4696
+ content: {
4697
+ "application/json": components["schemas"]["TimeBucketRow"][];
4698
+ };
4699
+ };
4700
+ };
4701
+ };
4702
+ get_market_analytics_changes: {
4703
+ parameters: {
4704
+ query: {
4705
+ /** @description Lookback window: 1h, 24h, 7d, 30d, 1y */
4706
+ timeframe: components["schemas"]["ChangeTimeframe"];
4707
+ };
4708
+ header?: never;
4709
+ path: {
4710
+ /** @description Market condition ID */
4711
+ condition_id: string;
4712
+ };
4713
+ cookie?: never;
4714
+ };
4715
+ requestBody?: never;
4716
+ responses: {
4717
+ /** @description Per-metric pct change */
4718
+ 200: {
4719
+ headers: {
4720
+ [name: string]: unknown;
4721
+ };
4722
+ content: {
4723
+ "application/json": components["schemas"]["MetricPctChange"];
4724
+ };
4725
+ };
4726
+ };
4727
+ };
4728
+ get_market_analytics_timeseries: {
4729
+ parameters: {
4730
+ query?: {
4731
+ /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
4732
+ resolution?: components["schemas"]["CandlestickResolution"];
4733
+ /** @description Start timestamp (Unix seconds) */
4734
+ from?: number;
4735
+ /** @description End timestamp (Unix seconds) */
4736
+ to?: number;
4737
+ /** @description Max data points (default: 500, max: 2500) */
4738
+ count_back?: number;
4739
+ /** @description Cursor from previous response */
4740
+ pagination_key?: string;
4741
+ };
4742
+ header?: never;
4743
+ path: {
4744
+ /** @description Market condition ID */
4745
+ condition_id: string;
4746
+ };
4747
+ cookie?: never;
4748
+ };
4749
+ requestBody?: never;
4750
+ responses: {
4751
+ /** @description Cumulative time-bucketed market analytics */
4752
+ 200: {
4753
+ headers: {
4754
+ [name: string]: unknown;
4755
+ };
4756
+ content: {
4757
+ "application/json": components["schemas"]["TimeBucketRow"][];
4758
+ };
4759
+ };
4760
+ };
4761
+ };
4059
4762
  get_order_book: {
4060
4763
  parameters: {
4061
4764
  query: {
@@ -4531,6 +5234,100 @@ export interface operations {
4531
5234
  };
4532
5235
  };
4533
5236
  };
5237
+ get_tag_analytics_candles: {
5238
+ parameters: {
5239
+ query?: {
5240
+ /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
5241
+ resolution?: components["schemas"]["CandlestickResolution"];
5242
+ /** @description Start timestamp (Unix seconds) */
5243
+ from?: number;
5244
+ /** @description End timestamp (Unix seconds) */
5245
+ to?: number;
5246
+ /** @description Max data points (default: 500, max: 2500) */
5247
+ count_back?: number;
5248
+ /** @description Cursor from previous response */
5249
+ pagination_key?: string;
5250
+ };
5251
+ header?: never;
5252
+ path: {
5253
+ /** @description Tag label (e.g. Politics, Sports) */
5254
+ tag: string;
5255
+ };
5256
+ cookie?: never;
5257
+ };
5258
+ requestBody?: never;
5259
+ responses: {
5260
+ /** @description Delta time-bucketed tag analytics */
5261
+ 200: {
5262
+ headers: {
5263
+ [name: string]: unknown;
5264
+ };
5265
+ content: {
5266
+ "application/json": components["schemas"]["TimeBucketRow"][];
5267
+ };
5268
+ };
5269
+ };
5270
+ };
5271
+ get_tag_analytics_changes: {
5272
+ parameters: {
5273
+ query: {
5274
+ /** @description Lookback window: 1h, 24h, 7d, 30d, 1y */
5275
+ timeframe: components["schemas"]["ChangeTimeframe"];
5276
+ };
5277
+ header?: never;
5278
+ path: {
5279
+ /** @description Tag label (e.g. Politics, Sports) */
5280
+ tag: string;
5281
+ };
5282
+ cookie?: never;
5283
+ };
5284
+ requestBody?: never;
5285
+ responses: {
5286
+ /** @description Per-metric pct change */
5287
+ 200: {
5288
+ headers: {
5289
+ [name: string]: unknown;
5290
+ };
5291
+ content: {
5292
+ "application/json": components["schemas"]["MetricPctChange"];
5293
+ };
5294
+ };
5295
+ };
5296
+ };
5297
+ get_tag_analytics_timeseries: {
5298
+ parameters: {
5299
+ query?: {
5300
+ /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
5301
+ resolution?: components["schemas"]["CandlestickResolution"];
5302
+ /** @description Start timestamp (Unix seconds) */
5303
+ from?: number;
5304
+ /** @description End timestamp (Unix seconds) */
5305
+ to?: number;
5306
+ /** @description Max data points (default: 500, max: 2500) */
5307
+ count_back?: number;
5308
+ /** @description Cursor from previous response */
5309
+ pagination_key?: string;
5310
+ };
5311
+ header?: never;
5312
+ path: {
5313
+ /** @description Tag label (e.g. Politics, Sports) */
5314
+ tag: string;
5315
+ };
5316
+ cookie?: never;
5317
+ };
5318
+ requestBody?: never;
5319
+ responses: {
5320
+ /** @description Cumulative time-bucketed tag analytics */
5321
+ 200: {
5322
+ headers: {
5323
+ [name: string]: unknown;
5324
+ };
5325
+ content: {
5326
+ "application/json": components["schemas"]["TimeBucketRow"][];
5327
+ };
5328
+ };
5329
+ };
5330
+ };
4534
5331
  get_global_pnl: {
4535
5332
  parameters: {
4536
5333
  query?: {
@@ -4966,4 +5763,98 @@ export interface operations {
4966
5763
  };
4967
5764
  };
4968
5765
  };
5766
+ get_trader_analytics_candles: {
5767
+ parameters: {
5768
+ query?: {
5769
+ /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
5770
+ resolution?: components["schemas"]["CandlestickResolution"];
5771
+ /** @description Start timestamp (Unix seconds) */
5772
+ from?: number;
5773
+ /** @description End timestamp (Unix seconds) */
5774
+ to?: number;
5775
+ /** @description Max data points (default: 500, max: 2500) */
5776
+ count_back?: number;
5777
+ /** @description Cursor from previous response */
5778
+ pagination_key?: string;
5779
+ };
5780
+ header?: never;
5781
+ path: {
5782
+ /** @description Trader wallet address */
5783
+ address: string;
5784
+ };
5785
+ cookie?: never;
5786
+ };
5787
+ requestBody?: never;
5788
+ responses: {
5789
+ /** @description Delta time-bucketed trader analytics */
5790
+ 200: {
5791
+ headers: {
5792
+ [name: string]: unknown;
5793
+ };
5794
+ content: {
5795
+ "application/json": components["schemas"]["TimeBucketRow"][];
5796
+ };
5797
+ };
5798
+ };
5799
+ };
5800
+ get_trader_analytics_changes: {
5801
+ parameters: {
5802
+ query: {
5803
+ /** @description Lookback window: 1h, 24h, 7d, 30d, 1y */
5804
+ timeframe: components["schemas"]["ChangeTimeframe"];
5805
+ };
5806
+ header?: never;
5807
+ path: {
5808
+ /** @description Trader wallet address */
5809
+ address: string;
5810
+ };
5811
+ cookie?: never;
5812
+ };
5813
+ requestBody?: never;
5814
+ responses: {
5815
+ /** @description Per-metric pct change */
5816
+ 200: {
5817
+ headers: {
5818
+ [name: string]: unknown;
5819
+ };
5820
+ content: {
5821
+ "application/json": components["schemas"]["MetricPctChange"];
5822
+ };
5823
+ };
5824
+ };
5825
+ };
5826
+ get_trader_analytics_timeseries: {
5827
+ parameters: {
5828
+ query?: {
5829
+ /** @description Bucket size: 1, 5, 15, 30, 60, 240, D, 1D (default: 60) */
5830
+ resolution?: components["schemas"]["CandlestickResolution"];
5831
+ /** @description Start timestamp (Unix seconds) */
5832
+ from?: number;
5833
+ /** @description End timestamp (Unix seconds) */
5834
+ to?: number;
5835
+ /** @description Max data points (default: 500, max: 2500) */
5836
+ count_back?: number;
5837
+ /** @description Cursor from previous response */
5838
+ pagination_key?: string;
5839
+ };
5840
+ header?: never;
5841
+ path: {
5842
+ /** @description Trader wallet address */
5843
+ address: string;
5844
+ };
5845
+ cookie?: never;
5846
+ };
5847
+ requestBody?: never;
5848
+ responses: {
5849
+ /** @description Cumulative time-bucketed trader analytics */
5850
+ 200: {
5851
+ headers: {
5852
+ [name: string]: unknown;
5853
+ };
5854
+ content: {
5855
+ "application/json": components["schemas"]["TimeBucketRow"][];
5856
+ };
5857
+ };
5858
+ };
5859
+ };
4969
5860
  }