@structbuild/sdk 0.2.11 → 0.3.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.
@@ -632,7 +632,7 @@ export interface paths {
632
632
  };
633
633
  /**
634
634
  * Get tags
635
- * @description Retrieve all available event tags/categories. Uses cursor-based pagination for efficient traversal.
635
+ * @description Retrieve all available event tags/categories. Supports both cursor-based and offset-based pagination.
636
636
  */
637
637
  get: operations["get_tags"];
638
638
  put?: never;
@@ -887,6 +887,113 @@ export interface paths {
887
887
  export type webhooks = Record<string, never>;
888
888
  export interface components {
889
889
  schemas: {
890
+ /** @description Output payload for ERC1155 setApprovalForAll events. */
891
+ ApprovalTrade: {
892
+ id: string;
893
+ hash: string;
894
+ /** Format: int64 */
895
+ block?: number | null;
896
+ /** Format: int64 */
897
+ confirmed_at?: number | null;
898
+ /** Format: int64 */
899
+ received_at?: number | null;
900
+ /** Format: int64 */
901
+ log_index?: number | null;
902
+ /** Format: int64 */
903
+ block_index?: number | null;
904
+ trader: components["schemas"]["TraderInfo"];
905
+ operator: string;
906
+ approved: boolean;
907
+ question?: string | null;
908
+ image_url?: string | null;
909
+ slug?: string | null;
910
+ event_slug?: string | null;
911
+ exchange: components["schemas"]["PolymarketExchange"];
912
+ };
913
+ /** @description V3 UMA OOv3: an assertion was disputed. */
914
+ AssertionDisputedEvent: {
915
+ id: string;
916
+ hash: string;
917
+ /** Format: int64 */
918
+ block?: number | null;
919
+ /** Format: int64 */
920
+ confirmed_at?: number | null;
921
+ /** Format: int64 */
922
+ received_at?: number | null;
923
+ /** Format: int64 */
924
+ log_index?: number | null;
925
+ /** Format: int64 */
926
+ block_index?: number | null;
927
+ oracle_contract: string;
928
+ assertion_id: string;
929
+ caller: string;
930
+ disputer: string;
931
+ condition_id?: string | null;
932
+ question?: string | null;
933
+ image_url?: string | null;
934
+ slug?: string | null;
935
+ event_slug?: string | null;
936
+ };
937
+ /** @description V3 UMA OOv3: a new assertion (resolution proposal) was made. */
938
+ AssertionMadeEvent: {
939
+ id: string;
940
+ hash: string;
941
+ /** Format: int64 */
942
+ block?: number | null;
943
+ /** Format: int64 */
944
+ confirmed_at?: number | null;
945
+ /** Format: int64 */
946
+ received_at?: number | null;
947
+ /** Format: int64 */
948
+ log_index?: number | null;
949
+ /** Format: int64 */
950
+ block_index?: number | null;
951
+ oracle_contract: string;
952
+ assertion_id: string;
953
+ domain_id: string;
954
+ claim: string;
955
+ asserter: string;
956
+ callback_recipient: string;
957
+ escalation_manager: string;
958
+ caller: string;
959
+ /** Format: int64 */
960
+ expiration_time: number;
961
+ currency: string;
962
+ bond: string;
963
+ identifier: string;
964
+ condition_id?: string | null;
965
+ proposed_outcome?: string | null;
966
+ question?: string | null;
967
+ image_url?: string | null;
968
+ slug?: string | null;
969
+ event_slug?: string | null;
970
+ };
971
+ /** @description V3 UMA OOv3: an assertion liveness period expired and was settled. */
972
+ AssertionSettledEvent: {
973
+ id: string;
974
+ hash: string;
975
+ /** Format: int64 */
976
+ block?: number | null;
977
+ /** Format: int64 */
978
+ confirmed_at?: number | null;
979
+ /** Format: int64 */
980
+ received_at?: number | null;
981
+ /** Format: int64 */
982
+ log_index?: number | null;
983
+ /** Format: int64 */
984
+ block_index?: number | null;
985
+ oracle_contract: string;
986
+ assertion_id: string;
987
+ bond_recipient: string;
988
+ disputed: boolean;
989
+ settlement_resolution: boolean;
990
+ settle_caller: string;
991
+ condition_id?: string | null;
992
+ question?: string | null;
993
+ image_url?: string | null;
994
+ slug?: string | null;
995
+ event_slug?: string | null;
996
+ };
890
997
  /** @description A single asset price history record from the `asset_price_history` table. */
891
998
  AssetPriceHistoryRow: {
892
999
  asset_symbol: string;
@@ -948,6 +1055,27 @@ export interface components {
948
1055
  /** Format: double */
949
1056
  price: number;
950
1057
  };
1058
+ /** @description Output payload for Cancelled orders. */
1059
+ CancelledTrade: {
1060
+ id: string;
1061
+ hash: string;
1062
+ /** Format: int64 */
1063
+ block?: number | null;
1064
+ /** Format: int64 */
1065
+ confirmed_at?: number | null;
1066
+ /** Format: int64 */
1067
+ received_at?: number | null;
1068
+ /** Format: int64 */
1069
+ log_index?: number | null;
1070
+ /** Format: int64 */
1071
+ block_index?: number | null;
1072
+ order_hash?: string | null;
1073
+ question?: string | null;
1074
+ image_url?: string | null;
1075
+ slug?: string | null;
1076
+ event_slug?: string | null;
1077
+ exchange: components["schemas"]["PolymarketExchange"];
1078
+ };
951
1079
  /** @enum {string} */
952
1080
  CandlestickResolution: "1" | "5" | "15" | "30" | "60" | "240" | "D" | "1D";
953
1081
  /** @enum {string} */
@@ -1014,6 +1142,29 @@ export interface components {
1014
1142
  /** Format: int32 */
1015
1143
  ask_levels?: number | null;
1016
1144
  };
1145
+ /** @description CTF ConditionResolution: positions become redeemable on the Conditional Tokens contract. */
1146
+ ConditionResolutionEvent: {
1147
+ id: string;
1148
+ hash: string;
1149
+ /** Format: int64 */
1150
+ block?: number | null;
1151
+ /** Format: int64 */
1152
+ confirmed_at?: number | null;
1153
+ /** Format: int64 */
1154
+ received_at?: number | null;
1155
+ /** Format: int64 */
1156
+ log_index?: number | null;
1157
+ /** Format: int64 */
1158
+ block_index?: number | null;
1159
+ oracle_contract: string;
1160
+ condition_id: string;
1161
+ oracle: string;
1162
+ proposed_outcome?: string | null;
1163
+ question?: string | null;
1164
+ image_url?: string | null;
1165
+ slug?: string | null;
1166
+ event_slug?: string | null;
1167
+ };
1017
1168
  /** @description Enriched market data for event API responses */
1018
1169
  EventMarket: {
1019
1170
  /** @default */
@@ -1223,45 +1374,6 @@ export interface components {
1223
1374
  /** @description Holders grouped by outcome */
1224
1375
  outcomes: components["schemas"]["OutcomeHolders"][];
1225
1376
  };
1226
- /** @description Market metadata (enriched, cached version) */
1227
- MarketMetadata: {
1228
- condition_id: string;
1229
- question: string;
1230
- description: string;
1231
- slug: string;
1232
- event_slug?: string | null;
1233
- event_id?: string | null;
1234
- event_title?: string | null;
1235
- series_slug?: string | null;
1236
- neg_risk: boolean;
1237
- tokens: components["schemas"]["TokenOutcome"][];
1238
- image_url?: string | null;
1239
- tags: string[];
1240
- /** Format: int64 */
1241
- created_time?: number | null;
1242
- /** Format: int64 */
1243
- start_time?: number | null;
1244
- /** Format: int64 */
1245
- game_start_time?: number | null;
1246
- /** Format: int64 */
1247
- closed_time?: number | null;
1248
- /** Format: int64 */
1249
- end_time?: number | null;
1250
- title?: string | null;
1251
- id?: string | null;
1252
- /** Format: double */
1253
- volume_usd?: number | null;
1254
- /** Format: double */
1255
- liquidity_usd?: number | null;
1256
- outcomes: components["schemas"]["MarketOutcome"][];
1257
- metrics: {
1258
- [key: string]: number;
1259
- };
1260
- market_maker_address?: string | null;
1261
- creator?: string | null;
1262
- category?: string | null;
1263
- clob_rewards: components["schemas"]["ClobReward"][];
1264
- };
1265
1377
  /** @description Market outcome with timeframe metrics (websocket API format) */
1266
1378
  MarketMetadataOutcome: {
1267
1379
  token_id: string;
@@ -1328,9 +1440,10 @@ export interface components {
1328
1440
  highest_probability?: number | null;
1329
1441
  /** Format: int64 */
1330
1442
  total_holders?: number | null;
1443
+ /** Format: double */
1444
+ total_daily_rate?: number | null;
1331
1445
  winning_outcome?: null | components["schemas"]["MarketOutcome"];
1332
1446
  outcomes?: components["schemas"]["MarketOutcome"][];
1333
- rewards?: components["schemas"]["MarketReward"][];
1334
1447
  clob_rewards?: components["schemas"]["ClobReward"][];
1335
1448
  tags?: string[];
1336
1449
  event_slug?: string | null;
@@ -1341,26 +1454,8 @@ export interface components {
1341
1454
  /** Format: double */
1342
1455
  relevance_score?: number | null;
1343
1456
  };
1344
- /** @description Reward info for market API responses */
1345
- MarketReward: {
1346
- /**
1347
- * Format: double
1348
- * @default null
1349
- */
1350
- min_size: number | null;
1351
- /**
1352
- * Format: double
1353
- * @default null
1354
- */
1355
- max_spread: number | null;
1356
- /**
1357
- * Format: double
1358
- * @default null
1359
- */
1360
- daily_rate: number | null;
1361
- };
1362
1457
  /** @enum {string} */
1363
- MarketSortBy: "volume" | "txns" | "unique_traders" | "liquidity" | "holders" | "end_time" | "start_time" | "created_time" | "relevance";
1458
+ MarketSortBy: "volume" | "txns" | "unique_traders" | "liquidity" | "holders" | "total_daily_rate" | "end_time" | "start_time" | "created_time" | "relevance";
1364
1459
  /** @enum {string} */
1365
1460
  MarketStatus: "open" | "closed" | "all";
1366
1461
  MarketVolumeChartResponse: {
@@ -1383,8 +1478,99 @@ export interface components {
1383
1478
  /** Format: int32 */
1384
1479
  ntc: number;
1385
1480
  };
1481
+ /** @description Output payload for Merge trades (burn outcome tokens → receive collateral). */
1482
+ MergeTrade: {
1483
+ id: string;
1484
+ hash: string;
1485
+ /** Format: int64 */
1486
+ block?: number | null;
1487
+ /** Format: int64 */
1488
+ confirmed_at?: number | null;
1489
+ /** Format: int64 */
1490
+ received_at?: number | null;
1491
+ /** Format: int64 */
1492
+ log_index?: number | null;
1493
+ /** Format: int64 */
1494
+ block_index?: number | null;
1495
+ trader: components["schemas"]["TraderInfo"];
1496
+ condition_id?: string | null;
1497
+ question?: string | null;
1498
+ image_url?: string | null;
1499
+ slug?: string | null;
1500
+ event_slug?: string | null;
1501
+ /** Format: double */
1502
+ usd_amount: number;
1503
+ /** @description Per-position burn amounts */
1504
+ position_details?: components["schemas"]["PositionDetail"][];
1505
+ exchange: components["schemas"]["PolymarketExchange"];
1506
+ };
1386
1507
  /** @enum {string} */
1387
1508
  MetricsTimeframe: "1m" | "5m" | "30m" | "1h" | "6h" | "24h" | "7d" | "30d";
1509
+ /** @description NegRisk Adapter: outcome reported for a neg-risk market question. */
1510
+ NegRiskOutcomeReportedEvent: {
1511
+ id: string;
1512
+ hash: string;
1513
+ /** Format: int64 */
1514
+ block?: number | null;
1515
+ /** Format: int64 */
1516
+ confirmed_at?: number | null;
1517
+ /** Format: int64 */
1518
+ received_at?: number | null;
1519
+ /** Format: int64 */
1520
+ log_index?: number | null;
1521
+ /** Format: int64 */
1522
+ block_index?: number | null;
1523
+ oracle_contract: string;
1524
+ condition_id: string;
1525
+ proposed_outcome?: string | null;
1526
+ question?: string | null;
1527
+ image_url?: string | null;
1528
+ slug?: string | null;
1529
+ event_slug?: string | null;
1530
+ };
1531
+ /** @description Output payload for OrderFilled and OrdersMatched trades (actual buy/sell). */
1532
+ OrderFilledTrade: {
1533
+ id: string;
1534
+ hash: string;
1535
+ /** Format: int64 */
1536
+ block?: number | null;
1537
+ /** Format: int64 */
1538
+ confirmed_at?: number | null;
1539
+ /** Format: int64 */
1540
+ received_at?: number | null;
1541
+ /** Format: int64 */
1542
+ log_index?: number | null;
1543
+ /** Format: int64 */
1544
+ block_index?: number | null;
1545
+ order_hash?: string | null;
1546
+ trader: components["schemas"]["TraderInfo"];
1547
+ taker?: string | null;
1548
+ side: string;
1549
+ condition_id?: string | null;
1550
+ position_id: string;
1551
+ outcome?: string | null;
1552
+ /** Format: int32 */
1553
+ outcome_index?: number | null;
1554
+ question?: string | null;
1555
+ image_url?: string | null;
1556
+ slug?: string | null;
1557
+ event_slug?: string | null;
1558
+ /** Format: double */
1559
+ usd_amount: number;
1560
+ /** Format: double */
1561
+ shares_amount: number;
1562
+ /** Format: double */
1563
+ price: number;
1564
+ /** Format: double */
1565
+ probability?: number | null;
1566
+ /** Format: double */
1567
+ fee?: number | null;
1568
+ /** Format: double */
1569
+ fee_shares?: number | null;
1570
+ /** Format: double */
1571
+ fee_pct?: number | null;
1572
+ exchange: components["schemas"]["PolymarketExchange"];
1573
+ };
1388
1574
  OrderbookHistoryRow: {
1389
1575
  /** Format: int64 */
1390
1576
  ts: number;
@@ -1638,6 +1824,11 @@ export interface components {
1638
1824
  /** @default null */
1639
1825
  series: null | components["schemas"]["PolymarketSeries"];
1640
1826
  };
1827
+ /**
1828
+ * @description Polymarket exchange contract types
1829
+ * @enum {string}
1830
+ */
1831
+ PolymarketExchange: "CTFExchange" | "NegRiskExchange" | "ConditionalTokens" | "NegRiskAdapter" | "Unknown";
1641
1832
  /**
1642
1833
  * @description A Polymarket series from the Gamma API
1643
1834
  * Series are parent groupings above events (e.g., "NBA Season 2024-25")
@@ -1725,6 +1916,20 @@ export interface components {
1725
1916
  outcome_index: number;
1726
1917
  data: components["schemas"]["PositionChartDataPoint"][];
1727
1918
  };
1919
+ /** @description Per-position detail for Split/Merge/Redemption trades. */
1920
+ PositionDetail: {
1921
+ /** @description ERC1155 position ID */
1922
+ position_id: string;
1923
+ /**
1924
+ * Format: int32
1925
+ * @description Outcome index (0 = Yes, 1 = No for binary)
1926
+ */
1927
+ outcome_index: number;
1928
+ /** @description Outcome name (e.g. "Yes", "No") — enriched from market metadata */
1929
+ outcome?: string | null;
1930
+ /** @description Amount of shares created/burned/redeemed for this position */
1931
+ amount: string;
1932
+ };
1728
1933
  /** @description Response for position (position_id) holders endpoint */
1729
1934
  PositionHoldersResponse: {
1730
1935
  /** @description Position ID (ERC1155 token ID) */
@@ -1808,6 +2013,32 @@ export interface components {
1808
2013
  /** Format: int32 */
1809
2014
  stc: number;
1810
2015
  };
2016
+ /**
2017
+ * @description Output payload for NegRisk PositionsConverted trades
2018
+ * (convert NO-position tokens → YES tokens + collateral).
2019
+ */
2020
+ PositionsConvertedTrade: {
2021
+ id: string;
2022
+ hash: string;
2023
+ /** Format: int64 */
2024
+ block?: number | null;
2025
+ /** Format: int64 */
2026
+ confirmed_at?: number | null;
2027
+ /** Format: int64 */
2028
+ received_at?: number | null;
2029
+ /** Format: int64 */
2030
+ log_index?: number | null;
2031
+ /** Format: int64 */
2032
+ block_index?: number | null;
2033
+ trader: components["schemas"]["TraderInfo"];
2034
+ /** @description NegRisk umbrella market ID */
2035
+ market_id: string;
2036
+ /** @description Bitmask of question indices whose NO tokens are being converted */
2037
+ index_set: string;
2038
+ /** Format: double */
2039
+ shares_amount: number;
2040
+ exchange: components["schemas"]["PolymarketExchange"];
2041
+ };
1811
2042
  PredictionCandlestickBar: {
1812
2043
  /** Format: double */
1813
2044
  l?: number | null;
@@ -1826,17 +2057,215 @@ export interface components {
1826
2057
  /** Format: double */
1827
2058
  m?: number | null;
1828
2059
  };
1829
- /** @description Response format for prediction trades */
1830
- PredictionTradeResponse: {
2060
+ PriceJump: {
2061
+ /** Format: int64 */
2062
+ from: number;
2063
+ /** Format: int64 */
2064
+ to: number;
2065
+ /** Format: double */
2066
+ price_before: number;
2067
+ /** Format: double */
2068
+ price_after: number;
2069
+ /** Format: double */
2070
+ change_pct: number;
2071
+ direction: string;
2072
+ /** Format: double */
2073
+ volume: number;
2074
+ /** Format: int32 */
2075
+ trades_count: number;
2076
+ condition_id: string;
2077
+ };
2078
+ /** @description UMA CTF Adapter: admin emergency resolution. */
2079
+ QuestionEmergencyResolvedEvent: {
2080
+ id: string;
2081
+ hash: string;
2082
+ /** Format: int64 */
2083
+ block?: number | null;
2084
+ /** Format: int64 */
2085
+ confirmed_at?: number | null;
2086
+ /** Format: int64 */
2087
+ received_at?: number | null;
2088
+ /** Format: int64 */
2089
+ log_index?: number | null;
2090
+ /** Format: int64 */
2091
+ block_index?: number | null;
2092
+ oracle_contract: string;
2093
+ condition_id: string;
2094
+ proposed_outcome?: string | null;
2095
+ question?: string | null;
2096
+ image_url?: string | null;
2097
+ slug?: string | null;
2098
+ event_slug?: string | null;
2099
+ };
2100
+ /** @description UMA CTF Adapter: market flagged for emergency resolution. */
2101
+ QuestionFlaggedEvent: {
1831
2102
  id: string;
1832
2103
  hash: string;
1833
2104
  /** Format: int64 */
1834
- block: number;
2105
+ block?: number | null;
2106
+ /** Format: int64 */
2107
+ confirmed_at?: number | null;
1835
2108
  /** Format: int64 */
1836
- confirmed_at: number;
2109
+ received_at?: number | null;
2110
+ /** Format: int64 */
2111
+ log_index?: number | null;
2112
+ /** Format: int64 */
2113
+ block_index?: number | null;
2114
+ oracle_contract: string;
2115
+ condition_id: string;
2116
+ question?: string | null;
2117
+ image_url?: string | null;
2118
+ slug?: string | null;
2119
+ event_slug?: string | null;
2120
+ };
2121
+ /** @description UMA CTF Adapter: questionID first initialized on-chain. */
2122
+ QuestionInitializedEvent: {
2123
+ id: string;
2124
+ hash: string;
2125
+ /** Format: int64 */
2126
+ block?: number | null;
2127
+ /** Format: int64 */
2128
+ confirmed_at?: number | null;
2129
+ /** Format: int64 */
2130
+ received_at?: number | null;
2131
+ /** Format: int64 */
2132
+ log_index?: number | null;
2133
+ /** Format: int64 */
2134
+ block_index?: number | null;
2135
+ oracle_contract: string;
2136
+ condition_id: string;
2137
+ creator: string;
2138
+ reward_token: string;
2139
+ reward: string;
2140
+ proposal_bond: string;
2141
+ question?: string | null;
2142
+ image_url?: string | null;
2143
+ slug?: string | null;
2144
+ event_slug?: string | null;
2145
+ };
2146
+ /** @description UMA CTF Adapter: market paused by admin. */
2147
+ QuestionPausedEvent: {
2148
+ id: string;
2149
+ hash: string;
2150
+ /** Format: int64 */
2151
+ block?: number | null;
2152
+ /** Format: int64 */
2153
+ confirmed_at?: number | null;
2154
+ /** Format: int64 */
2155
+ received_at?: number | null;
2156
+ /** Format: int64 */
2157
+ log_index?: number | null;
2158
+ /** Format: int64 */
2159
+ block_index?: number | null;
2160
+ oracle_contract: string;
2161
+ condition_id: string;
2162
+ question?: string | null;
2163
+ image_url?: string | null;
2164
+ slug?: string | null;
2165
+ event_slug?: string | null;
2166
+ };
2167
+ /** @description UMA CTF Adapter: dispute succeeded, market returns to active. */
2168
+ QuestionResetEvent: {
2169
+ id: string;
2170
+ hash: string;
2171
+ /** Format: int64 */
2172
+ block?: number | null;
2173
+ /** Format: int64 */
2174
+ confirmed_at?: number | null;
2175
+ /** Format: int64 */
2176
+ received_at?: number | null;
2177
+ /** Format: int64 */
2178
+ log_index?: number | null;
2179
+ /** Format: int64 */
2180
+ block_index?: number | null;
2181
+ oracle_contract: string;
2182
+ condition_id: string;
2183
+ question?: string | null;
2184
+ image_url?: string | null;
2185
+ slug?: string | null;
2186
+ event_slug?: string | null;
2187
+ };
2188
+ /** @description UMA CTF Adapter: market resolved with definitive outcome. */
2189
+ QuestionResolvedEvent: {
2190
+ id: string;
2191
+ hash: string;
2192
+ /** Format: int64 */
2193
+ block?: number | null;
2194
+ /** Format: int64 */
2195
+ confirmed_at?: number | null;
2196
+ /** Format: int64 */
2197
+ received_at?: number | null;
2198
+ /** Format: int64 */
2199
+ log_index?: number | null;
2200
+ /** Format: int64 */
2201
+ block_index?: number | null;
2202
+ oracle_contract: string;
2203
+ condition_id: string;
2204
+ /** Format: int64 */
2205
+ settled_price: number;
2206
+ proposed_outcome?: string | null;
2207
+ question?: string | null;
2208
+ image_url?: string | null;
2209
+ slug?: string | null;
2210
+ event_slug?: string | null;
2211
+ };
2212
+ /** @description UMA CTF Adapter: flag removed. */
2213
+ QuestionUnflaggedEvent: {
2214
+ id: string;
2215
+ hash: string;
2216
+ /** Format: int64 */
2217
+ block?: number | null;
2218
+ /** Format: int64 */
2219
+ confirmed_at?: number | null;
2220
+ /** Format: int64 */
2221
+ received_at?: number | null;
2222
+ /** Format: int64 */
2223
+ log_index?: number | null;
2224
+ /** Format: int64 */
2225
+ block_index?: number | null;
2226
+ oracle_contract: string;
2227
+ condition_id: string;
2228
+ question?: string | null;
2229
+ image_url?: string | null;
2230
+ slug?: string | null;
2231
+ event_slug?: string | null;
2232
+ };
2233
+ /** @description UMA CTF Adapter: market unpaused. */
2234
+ QuestionUnpausedEvent: {
2235
+ id: string;
2236
+ hash: string;
2237
+ /** Format: int64 */
2238
+ block?: number | null;
2239
+ /** Format: int64 */
2240
+ confirmed_at?: number | null;
2241
+ /** Format: int64 */
2242
+ received_at?: number | null;
2243
+ /** Format: int64 */
2244
+ log_index?: number | null;
2245
+ /** Format: int64 */
2246
+ block_index?: number | null;
2247
+ oracle_contract: string;
2248
+ condition_id: string;
2249
+ question?: string | null;
2250
+ image_url?: string | null;
2251
+ slug?: string | null;
2252
+ event_slug?: string | null;
2253
+ };
2254
+ /** @description Output payload for Redemption trades (payout after market resolution). */
2255
+ RedemptionTrade: {
2256
+ id: string;
2257
+ hash: string;
2258
+ /** Format: int64 */
2259
+ block?: number | null;
2260
+ /** Format: int64 */
2261
+ confirmed_at?: number | null;
2262
+ /** Format: int64 */
2263
+ received_at?: number | null;
2264
+ /** Format: int64 */
2265
+ log_index?: number | null;
2266
+ /** Format: int64 */
2267
+ block_index?: number | null;
1837
2268
  trader: components["schemas"]["TraderInfo"];
1838
- taker: string;
1839
- side?: string | null;
1840
2269
  condition_id?: string | null;
1841
2270
  outcome?: string | null;
1842
2271
  /** Format: int32 */
@@ -1847,38 +2276,34 @@ export interface components {
1847
2276
  event_slug?: string | null;
1848
2277
  /** Format: double */
1849
2278
  usd_amount: number;
1850
- /** Format: double */
1851
- shares_amount: number;
1852
- /** Format: double */
1853
- price: number;
1854
- /** Format: double */
1855
- probability?: number | null;
1856
- /** Format: double */
1857
- fee: number;
1858
- exchange: string;
1859
- trade_type: string;
1860
- /** Format: int64 */
1861
- log_index: number;
1862
- order_hash: string;
1863
- position_id: string;
2279
+ /** Format: int32 */
2280
+ winning_outcome_index?: number | null;
2281
+ /** @description Per-position burn amounts */
2282
+ position_details?: components["schemas"]["PositionDetail"][];
2283
+ exchange: components["schemas"]["PolymarketExchange"];
1864
2284
  };
1865
- PriceJump: {
2285
+ /** @description Output payload for RegisterToken events (YES/NO token pair registered for a condition). */
2286
+ RegisterTokenTrade: {
2287
+ id: string;
2288
+ hash: string;
1866
2289
  /** Format: int64 */
1867
- from: number;
2290
+ block?: number | null;
1868
2291
  /** Format: int64 */
1869
- to: number;
1870
- /** Format: double */
1871
- price_before: number;
1872
- /** Format: double */
1873
- price_after: number;
1874
- /** Format: double */
1875
- change_pct: number;
1876
- direction: string;
1877
- /** Format: double */
1878
- volume: number;
1879
- /** Format: int32 */
1880
- trades_count: number;
2292
+ confirmed_at?: number | null;
2293
+ /** Format: int64 */
2294
+ received_at?: number | null;
2295
+ /** Format: int64 */
2296
+ log_index?: number | null;
2297
+ /** Format: int64 */
2298
+ block_index?: number | null;
1881
2299
  condition_id: string;
2300
+ token0: string;
2301
+ token1: string;
2302
+ question?: string | null;
2303
+ image_url?: string | null;
2304
+ slug?: string | null;
2305
+ event_slug?: string | null;
2306
+ exchange: components["schemas"]["PolymarketExchange"];
1882
2307
  };
1883
2308
  SearchResponse: {
1884
2309
  events?: components["schemas"]["PolymarketEvent"][] | null;
@@ -1922,6 +2347,32 @@ export interface components {
1922
2347
  * @enum {string}
1923
2348
  */
1924
2349
  SpikeDirection: "up" | "down" | "both";
2350
+ /** @description Output payload for Split trades (deposit collateral → receive outcome tokens). */
2351
+ SplitTrade: {
2352
+ id: string;
2353
+ hash: string;
2354
+ /** Format: int64 */
2355
+ block?: number | null;
2356
+ /** Format: int64 */
2357
+ confirmed_at?: number | null;
2358
+ /** Format: int64 */
2359
+ received_at?: number | null;
2360
+ /** Format: int64 */
2361
+ log_index?: number | null;
2362
+ /** Format: int64 */
2363
+ block_index?: number | null;
2364
+ trader: components["schemas"]["TraderInfo"];
2365
+ condition_id?: string | null;
2366
+ question?: string | null;
2367
+ image_url?: string | null;
2368
+ slug?: string | null;
2369
+ event_slug?: string | null;
2370
+ /** Format: double */
2371
+ usd_amount: number;
2372
+ /** @description Per-position mint amounts */
2373
+ position_details?: components["schemas"]["PositionDetail"][];
2374
+ exchange: components["schemas"]["PolymarketExchange"];
2375
+ };
1925
2376
  /** @description Lightweight row — derived metrics only, no bids/asks JSONB. */
1926
2377
  SpreadRow: {
1927
2378
  /** Format: int64 */
@@ -1950,6 +2401,77 @@ export interface components {
1950
2401
  token_id: string;
1951
2402
  outcome: string;
1952
2403
  };
2404
+ /**
2405
+ * @description Tagged enum for all trade types — serializes with `"trade_type": "..."` discriminator
2406
+ * and only includes fields relevant to each type.
2407
+ */
2408
+ TradeEvent: (components["schemas"]["OrderFilledTrade"] & {
2409
+ /** @enum {string} */
2410
+ trade_type: "OrderFilled";
2411
+ }) | (components["schemas"]["OrderFilledTrade"] & {
2412
+ /** @enum {string} */
2413
+ trade_type: "OrdersMatched";
2414
+ }) | (components["schemas"]["RedemptionTrade"] & {
2415
+ /** @enum {string} */
2416
+ trade_type: "Redemption";
2417
+ }) | (components["schemas"]["MergeTrade"] & {
2418
+ /** @enum {string} */
2419
+ trade_type: "Merge";
2420
+ }) | (components["schemas"]["SplitTrade"] & {
2421
+ /** @enum {string} */
2422
+ trade_type: "Split";
2423
+ }) | (components["schemas"]["PositionsConvertedTrade"] & {
2424
+ /** @enum {string} */
2425
+ trade_type: "PositionsConverted";
2426
+ }) | (components["schemas"]["CancelledTrade"] & {
2427
+ /** @enum {string} */
2428
+ trade_type: "Cancelled";
2429
+ }) | (components["schemas"]["QuestionInitializedEvent"] & {
2430
+ /** @enum {string} */
2431
+ trade_type: "Initialization";
2432
+ }) | (components["schemas"]["AssertionMadeEvent"] & {
2433
+ /** @enum {string} */
2434
+ trade_type: "Proposal";
2435
+ }) | (components["schemas"]["AssertionDisputedEvent"] & {
2436
+ /** @enum {string} */
2437
+ trade_type: "Dispute";
2438
+ }) | (components["schemas"]["AssertionSettledEvent"] & {
2439
+ /** @enum {string} */
2440
+ trade_type: "Settled";
2441
+ }) | (components["schemas"]["QuestionResolvedEvent"] & {
2442
+ /** @enum {string} */
2443
+ trade_type: "Resolution";
2444
+ }) | (components["schemas"]["ConditionResolutionEvent"] & {
2445
+ /** @enum {string} */
2446
+ trade_type: "ConditionResolution";
2447
+ }) | (components["schemas"]["QuestionResetEvent"] & {
2448
+ /** @enum {string} */
2449
+ trade_type: "Reset";
2450
+ }) | (components["schemas"]["QuestionFlaggedEvent"] & {
2451
+ /** @enum {string} */
2452
+ trade_type: "Flag";
2453
+ }) | (components["schemas"]["QuestionUnflaggedEvent"] & {
2454
+ /** @enum {string} */
2455
+ trade_type: "Unflag";
2456
+ }) | (components["schemas"]["QuestionPausedEvent"] & {
2457
+ /** @enum {string} */
2458
+ trade_type: "Pause";
2459
+ }) | (components["schemas"]["QuestionUnpausedEvent"] & {
2460
+ /** @enum {string} */
2461
+ trade_type: "Unpause";
2462
+ }) | (components["schemas"]["QuestionEmergencyResolvedEvent"] & {
2463
+ /** @enum {string} */
2464
+ trade_type: "ManualResolution";
2465
+ }) | (components["schemas"]["NegRiskOutcomeReportedEvent"] & {
2466
+ /** @enum {string} */
2467
+ trade_type: "NegRiskOutcomeReported";
2468
+ }) | (components["schemas"]["RegisterTokenTrade"] & {
2469
+ /** @enum {string} */
2470
+ trade_type: "RegisterToken";
2471
+ }) | (components["schemas"]["ApprovalTrade"] & {
2472
+ /** @enum {string} */
2473
+ trade_type: "Approval";
2474
+ });
1953
2475
  /** @enum {string} */
1954
2476
  TradeSide: "0" | "1";
1955
2477
  /** @enum {string} */
@@ -2694,7 +3216,7 @@ export interface operations {
2694
3216
  search?: string;
2695
3217
  /** @description Filter by status: open, closed, or all (default: all) */
2696
3218
  status?: components["schemas"]["MarketStatus"];
2697
- /** @description Sort: volume, txns, unique_traders, liquidity, holders, end_time, start_time, created_time, relevance */
3219
+ /** @description Sort: volume, txns, unique_traders, liquidity, holders, total_daily_rate, end_time, start_time, created_time, relevance */
2698
3220
  sort_by?: components["schemas"]["MarketSortBy"];
2699
3221
  /** @description Sort direction: asc, desc (default: desc) */
2700
3222
  sort_dir?: components["schemas"]["SortDirection"];
@@ -3080,9 +3602,10 @@ export interface operations {
3080
3602
  highest_probability?: number | null;
3081
3603
  /** Format: int64 */
3082
3604
  total_holders?: number | null;
3605
+ /** Format: double */
3606
+ total_daily_rate?: number | null;
3083
3607
  winning_outcome?: null | components["schemas"]["MarketOutcome"];
3084
3608
  outcomes?: components["schemas"]["MarketOutcome"][];
3085
- rewards?: components["schemas"]["MarketReward"][];
3086
3609
  clob_rewards?: components["schemas"]["ClobReward"][];
3087
3610
  tags?: string[];
3088
3611
  event_slug?: string | null;
@@ -3143,8 +3666,10 @@ export interface operations {
3143
3666
  all?: boolean;
3144
3667
  /** @description Results per page (default: 10, max: 250) */
3145
3668
  limit?: number;
3146
- /** @description Offset-based pagination key (integer offset into result set) */
3147
- pagination_key?: number;
3669
+ /** @description Pagination offset (number of results to skip). Takes precedence over pagination_key. */
3670
+ offset?: number;
3671
+ /** @description Cursor-based pagination key obtained from previous response's pagination.pagination_key */
3672
+ pagination_key?: string;
3148
3673
  /** @description Sort newest first (default: true) */
3149
3674
  sort_desc?: boolean;
3150
3675
  /** @description Return truncated response optimized for AI consumers (default: false) */
@@ -3162,7 +3687,7 @@ export interface operations {
3162
3687
  [name: string]: unknown;
3163
3688
  };
3164
3689
  content: {
3165
- "application/json": components["schemas"]["PredictionTradeResponse"][];
3690
+ "application/json": components["schemas"]["TradeEvent"][];
3166
3691
  };
3167
3692
  };
3168
3693
  };
@@ -3261,9 +3786,10 @@ export interface operations {
3261
3786
  highest_probability?: number | null;
3262
3787
  /** Format: int64 */
3263
3788
  total_holders?: number | null;
3789
+ /** Format: double */
3790
+ total_daily_rate?: number | null;
3264
3791
  winning_outcome?: null | components["schemas"]["MarketOutcome"];
3265
3792
  outcomes?: components["schemas"]["MarketOutcome"][];
3266
- rewards?: components["schemas"]["MarketReward"][];
3267
3793
  clob_rewards?: components["schemas"]["ClobReward"][];
3268
3794
  tags?: string[];
3269
3795
  event_slug?: string | null;
@@ -3665,6 +4191,8 @@ export interface operations {
3665
4191
  query?: {
3666
4192
  /** @description Results limit (default: 10, max: 250) */
3667
4193
  limit?: number;
4194
+ /** @description Offset-based pagination (number of results to skip). Takes precedence over pagination_key. */
4195
+ offset?: number;
3668
4196
  /** @description Cursor-based pagination key */
3669
4197
  pagination_key?: string;
3670
4198
  };
@@ -4068,7 +4596,7 @@ export interface operations {
4068
4596
  [name: string]: unknown;
4069
4597
  };
4070
4598
  content: {
4071
- "application/json": components["schemas"]["PredictionTradeResponse"][];
4599
+ "application/json": components["schemas"]["TradeEvent"][];
4072
4600
  };
4073
4601
  };
4074
4602
  };