@0xinsider/sdk 0.31.0 → 0.35.0

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.
package/dist/client.d.ts CHANGED
@@ -115,7 +115,9 @@ export interface ApiUnsupportedOperation {
115
115
  * `scripts/check-sdk-openapi-drift.mjs`, which also checks every row's kind
116
116
  * against the spec. Do not add a row without a matching spec operation, and
117
117
  * do not remove a spec operation without removing its row. A redirect-only
118
- * operation belongs in `REDIRECT_OPERATIONS` below, not here.
118
+ * operation belongs in `REDIRECT_OPERATIONS` below, not here, and a
119
+ * deprecated alias this client no longer wraps belongs in
120
+ * `UNSUPPORTED_OPERATIONS` (#29350).
119
121
  */
120
122
  export declare const API_CLIENT_OPERATIONS: readonly [{
121
123
  readonly method: "GET";
@@ -233,6 +235,26 @@ export declare const API_CLIENT_OPERATIONS: readonly [{
233
235
  readonly path: "/api/v1/leaderboard/trending";
234
236
  readonly operationId: "listTrendingWallets";
235
237
  readonly auth: "bearer";
238
+ }, {
239
+ readonly method: "GET";
240
+ readonly path: "/api/v1/leaderboard/leagues";
241
+ readonly operationId: "listLeaderboardLeagues";
242
+ readonly auth: "bearer";
243
+ }, {
244
+ readonly method: "GET";
245
+ readonly path: "/api/v1/leaderboard/sports/{sport}";
246
+ readonly operationId: "getSportLeaderboard";
247
+ readonly auth: "bearer";
248
+ }, {
249
+ readonly method: "GET";
250
+ readonly path: "/api/v1/leaderboard/categories";
251
+ readonly operationId: "listCategoryLeaders";
252
+ readonly auth: "bearer";
253
+ }, {
254
+ readonly method: "GET";
255
+ readonly path: "/api/v1/leaderboard/categories/{slug}";
256
+ readonly operationId: "getCategoryLeaderboard";
257
+ readonly auth: "bearer";
236
258
  }, {
237
259
  readonly method: "GET";
238
260
  readonly path: "/api/v1/edge-hunter";
@@ -250,59 +272,54 @@ export declare const API_CLIENT_OPERATIONS: readonly [{
250
272
  readonly auth: "bearer";
251
273
  }, {
252
274
  readonly method: "GET";
253
- readonly path: "/api/v1/large-trades";
254
- readonly operationId: "listLargeTrades";
275
+ readonly path: "/api/v1/games/{event_slug}/markets";
276
+ readonly operationId: "listGameMarkets";
255
277
  readonly auth: "bearer";
256
278
  }, {
257
279
  readonly method: "GET";
258
- readonly path: "/api/v1/large-trades/history";
259
- readonly operationId: "listLargeTradeHistory";
280
+ readonly path: "/api/v1/games/{event_slug}/sharp-money";
281
+ readonly operationId: "getGameSharpMoney";
260
282
  readonly auth: "bearer";
261
283
  }, {
262
284
  readonly method: "GET";
263
- readonly path: "/api/v1/large-trades/{id}/counterparties/executions";
264
- readonly operationId: "listLargeTradeCounterpartyExecutions";
285
+ readonly path: "/api/v1/games/{event_slug}/trades";
286
+ readonly operationId: "listGameTrades";
265
287
  readonly auth: "bearer";
266
288
  }, {
267
289
  readonly method: "GET";
268
- readonly path: "/api/v1/large-trades/{id}/counterparties/executions/{execution_id}/makers";
269
- readonly operationId: "listLargeTradeCounterpartyMakers";
290
+ readonly path: "/api/v1/games/{event_slug}/holders";
291
+ readonly operationId: "getGameHolders";
270
292
  readonly auth: "bearer";
271
293
  }, {
272
294
  readonly method: "GET";
273
- readonly path: "/api/v1/large-trades/{id}";
274
- readonly operationId: "getLargeTrade";
295
+ readonly path: "/api/v1/large-trades";
296
+ readonly operationId: "listLargeTrades";
275
297
  readonly auth: "bearer";
276
298
  }, {
277
299
  readonly method: "GET";
278
- readonly path: "/api/v1/whale-trades";
279
- readonly operationId: "listWhaleTrades";
300
+ readonly path: "/api/v1/large-trades/history";
301
+ readonly operationId: "listLargeTradeHistory";
280
302
  readonly auth: "bearer";
281
303
  }, {
282
304
  readonly method: "GET";
283
- readonly path: "/api/v1/whale-trades/history";
284
- readonly operationId: "listWhaleTradeHistory";
305
+ readonly path: "/api/v1/large-trades/{id}/counterparties/executions";
306
+ readonly operationId: "listLargeTradeCounterpartyExecutions";
285
307
  readonly auth: "bearer";
286
308
  }, {
287
309
  readonly method: "GET";
288
- readonly path: "/api/v1/whale-trades/{id}/counterparties/executions";
289
- readonly operationId: "listWhaleTradeCounterpartyExecutions";
310
+ readonly path: "/api/v1/large-trades/{id}/counterparties/executions/{execution_id}/makers";
311
+ readonly operationId: "listLargeTradeCounterpartyMakers";
290
312
  readonly auth: "bearer";
291
313
  }, {
292
314
  readonly method: "GET";
293
- readonly path: "/api/v1/whale-trades/{id}/counterparties/executions/{execution_id}/makers";
294
- readonly operationId: "listWhaleTradeCounterpartyMakers";
315
+ readonly path: "/api/v1/large-trades/{id}";
316
+ readonly operationId: "getLargeTrade";
295
317
  readonly auth: "bearer";
296
318
  }, {
297
319
  readonly method: "GET";
298
320
  readonly path: "/api/v1/content/search";
299
321
  readonly operationId: "searchContent";
300
322
  readonly auth: "bearer";
301
- }, {
302
- readonly method: "GET";
303
- readonly path: "/api/v1/whale-trades/{id}";
304
- readonly operationId: "getWhaleTrade";
305
- readonly auth: "bearer";
306
323
  }, {
307
324
  readonly method: "GET";
308
325
  readonly path: "/api/v1/leaderboard";
@@ -318,11 +335,6 @@ export declare const API_CLIENT_OPERATIONS: readonly [{
318
335
  readonly path: "/api/v1/markets/explore";
319
336
  readonly operationId: "exploreMarkets";
320
337
  readonly auth: "bearer";
321
- }, {
322
- readonly method: "GET";
323
- readonly path: "/api/v1/markets/smart-money-flows";
324
- readonly operationId: "listSmartMoneyFlows";
325
- readonly auth: "bearer";
326
338
  }, {
327
339
  readonly method: "GET";
328
340
  readonly path: "/api/v1/markets/sharp-money-flows";
@@ -333,11 +345,6 @@ export declare const API_CLIENT_OPERATIONS: readonly [{
333
345
  readonly path: "/api/v1/coverage";
334
346
  readonly operationId: "getCoverage";
335
347
  readonly auth: "none";
336
- }, {
337
- readonly method: "GET";
338
- readonly path: "/api/v1/platforms";
339
- readonly operationId: "getPlatforms";
340
- readonly auth: "none";
341
348
  }, {
342
349
  readonly method: "GET";
343
350
  readonly path: "/api/v1/market/{condition_id}/holders";
@@ -345,24 +352,19 @@ export declare const API_CLIENT_OPERATIONS: readonly [{
345
352
  readonly auth: "bearer";
346
353
  }, {
347
354
  readonly method: "GET";
348
- readonly path: "/api/v1/market/{condition_id}/flow";
349
- readonly operationId: "getMarketFlow";
355
+ readonly path: "/api/v1/market/{condition_id}/top-holders";
356
+ readonly operationId: "getMarketTopHolders";
350
357
  readonly auth: "bearer";
351
358
  }, {
352
359
  readonly method: "GET";
353
- readonly path: "/api/v1/market/{condition_id}/intel";
354
- readonly operationId: "getMarketIntel";
360
+ readonly path: "/api/v1/market/{condition_id}/flow";
361
+ readonly operationId: "getMarketFlow";
355
362
  readonly auth: "bearer";
356
363
  }, {
357
364
  readonly method: "POST";
358
365
  readonly path: "/api/v1/markets/flow/batch";
359
366
  readonly operationId: "batchGetMarketFlow";
360
367
  readonly auth: "bearer";
361
- }, {
362
- readonly method: "POST";
363
- readonly path: "/api/v1/markets/intel/batch";
364
- readonly operationId: "batchGetMarketIntel";
365
- readonly auth: "bearer";
366
368
  }, {
367
369
  readonly method: "GET";
368
370
  readonly path: "/api/v1/market/{condition_id}/snapshot";
@@ -379,6 +381,11 @@ export declare const API_CLIENT_OPERATIONS: readonly [{
379
381
  readonly path: "/api/v1/market/{condition_id}/candles";
380
382
  readonly operationId: "getMarketCandles";
381
383
  readonly auth: "bearer";
384
+ }, {
385
+ readonly method: "GET";
386
+ readonly path: "/api/v1/market/{condition_id}/wallets-in-out";
387
+ readonly operationId: "getMarketWalletsInOut";
388
+ readonly auth: "bearer";
382
389
  }, {
383
390
  readonly method: "GET";
384
391
  readonly path: "/api/v1/suspicious-trades";
@@ -389,16 +396,6 @@ export declare const API_CLIENT_OPERATIONS: readonly [{
389
396
  readonly path: "/api/v1/suspicious-trades/{id}";
390
397
  readonly operationId: "getSuspiciousTrade";
391
398
  readonly auth: "bearer";
392
- }, {
393
- readonly method: "GET";
394
- readonly path: "/api/v1/insider-radar";
395
- readonly operationId: "listInsiderRadar";
396
- readonly auth: "bearer";
397
- }, {
398
- readonly method: "GET";
399
- readonly path: "/api/v1/insider-radar/{id}";
400
- readonly operationId: "getInsiderRadarFlag";
401
- readonly auth: "bearer";
402
399
  }, {
403
400
  readonly method: "GET";
404
401
  readonly path: "/api/v1/events/feed/since";
@@ -516,6 +513,11 @@ export declare const API_CLIENT_OPERATIONS: readonly [{
516
513
  readonly path: "/api/v1/reports/monthly";
517
514
  readonly operationId: "getMonthlyReportSnapshot";
518
515
  readonly auth: "bearer";
516
+ }, {
517
+ readonly method: "GET";
518
+ readonly path: "/api/v1/reports/resolutions";
519
+ readonly operationId: "getResolutionReport";
520
+ readonly auth: "bearer";
519
521
  }, {
520
522
  readonly method: "GET";
521
523
  readonly path: "/api/v1/trader/{address}/export";
@@ -536,6 +538,11 @@ export declare const API_CLIENT_OPERATIONS: readonly [{
536
538
  readonly path: "/api/v1/pick-of-the-day/archive";
537
539
  readonly operationId: "getPickOfTheDayArchive";
538
540
  readonly auth: "bearer";
541
+ }, {
542
+ readonly method: "GET";
543
+ readonly path: "/api/v1/pick-of-the-day/stats";
544
+ readonly operationId: "getPickOfTheDayStats";
545
+ readonly auth: "bearer";
539
546
  }, {
540
547
  readonly method: "GET";
541
548
  readonly path: "/api/v1/pick-of-the-day/ledger";
@@ -597,9 +604,67 @@ export declare const REDIRECT_OPERATIONS: readonly [{
597
604
  /**
598
605
  * Published operations this client deliberately does not wrap, with the
599
606
  * reason. The drift check requires every remaining spec operation to be
600
- * accounted for here, so "unsupported" is always a stated decision.
607
+ * accounted for here, so "unsupported" is always a stated decision. An
608
+ * operation that still answers 200 may appear here only while the spec marks
609
+ * it `deprecated`: 0.32.0 dropped the September rename aliases (#29350), whose
610
+ * paths stay live until their 2027-02-01 sunset (#29351).
601
611
  */
602
612
  export declare const UNSUPPORTED_OPERATIONS: readonly [{
613
+ readonly method: "GET";
614
+ readonly path: "/api/v1/whale-trades";
615
+ readonly operationId: "listWhaleTrades";
616
+ readonly reason: "Deprecated alias (#16304), sunset 2027-02-01: use listLargeTrades().";
617
+ }, {
618
+ readonly method: "GET";
619
+ readonly path: "/api/v1/whale-trades/history";
620
+ readonly operationId: "listWhaleTradeHistory";
621
+ readonly reason: "Deprecated alias (#16304), sunset 2027-02-01: use listLargeTradeHistory().";
622
+ }, {
623
+ readonly method: "GET";
624
+ readonly path: "/api/v1/whale-trades/{id}";
625
+ readonly operationId: "getWhaleTrade";
626
+ readonly reason: "Deprecated alias (#16304), sunset 2027-02-01: use getLargeTrade().";
627
+ }, {
628
+ readonly method: "GET";
629
+ readonly path: "/api/v1/whale-trades/{id}/counterparties/executions";
630
+ readonly operationId: "listWhaleTradeCounterpartyExecutions";
631
+ readonly reason: 'Deprecated alias (#16304), sunset 2027-02-01: use call("listLargeTradeCounterpartyExecutions").';
632
+ }, {
633
+ readonly method: "GET";
634
+ readonly path: "/api/v1/whale-trades/{id}/counterparties/executions/{execution_id}/makers";
635
+ readonly operationId: "listWhaleTradeCounterpartyMakers";
636
+ readonly reason: 'Deprecated alias (#16304), sunset 2027-02-01: use call("listLargeTradeCounterpartyMakers").';
637
+ }, {
638
+ readonly method: "GET";
639
+ readonly path: "/api/v1/markets/smart-money-flows";
640
+ readonly operationId: "listSmartMoneyFlows";
641
+ readonly reason: "Deprecated alias (#16308), sunset 2027-02-01: use listSharpMoneyFlows().";
642
+ }, {
643
+ readonly method: "GET";
644
+ readonly path: "/api/v1/platforms";
645
+ readonly operationId: "getPlatforms";
646
+ readonly reason: "Deprecated alias (#16315), sunset 2027-02-01: use getCoverage().";
647
+ }, {
648
+ readonly method: "GET";
649
+ readonly path: "/api/v1/market/{condition_id}/intel";
650
+ readonly operationId: "getMarketIntel";
651
+ readonly reason: "Deprecated alias (#16312), sunset 2027-02-01: use getMarketFlow().";
652
+ }, {
653
+ readonly method: "POST";
654
+ readonly path: "/api/v1/markets/intel/batch";
655
+ readonly operationId: "batchGetMarketIntel";
656
+ readonly reason: "Deprecated alias (#16312), sunset 2027-02-01: use batchGetMarketFlow().";
657
+ }, {
658
+ readonly method: "GET";
659
+ readonly path: "/api/v1/insider-radar";
660
+ readonly operationId: "listInsiderRadar";
661
+ readonly reason: "Deprecated alias (#16301), sunset 2027-02-01: use listSuspiciousTrades().";
662
+ }, {
663
+ readonly method: "GET";
664
+ readonly path: "/api/v1/insider-radar/{id}";
665
+ readonly operationId: "getInsiderRadarFlag";
666
+ readonly reason: "Deprecated alias (#16301), sunset 2027-02-01: use getSuspiciousTrade().";
667
+ }, {
603
668
  readonly method: "GET";
604
669
  readonly path: "/api/v1/sports/pre-game-sides";
605
670
  readonly operationId: "listPreGameSides";
@@ -640,15 +705,14 @@ export declare const IDEMPOTENT_WRITE_OPERATIONS: readonly ["createWebhookVerifi
640
705
  export type IdempotentWriteOperationId = (typeof IDEMPOTENT_WRITE_OPERATIONS)[number];
641
706
  /**
642
707
  * POST operations that read and never write (#16182): the batch lookups.
643
- * `POST /api/v1/traders/batch` and `POST /api/v1/markets/flow/batch` (with its
644
- * deprecated alias `POST /api/v1/markets/intel/batch`) resolve
708
+ * `POST /api/v1/traders/batch` and `POST /api/v1/markets/flow/batch` resolve
645
709
  * their inputs and store nothing (`backend/src/api_v1/handlers/batch.rs`), so
646
710
  * a repeat cannot duplicate a side effect. Each attempt is one request
647
711
  * against the account's quota and one reservation of batch item units, which
648
712
  * is exactly what a retried GET costs, so they are retried like a GET. Every
649
713
  * other POST, PATCH or DELETE is retried only as a keyed write above.
650
714
  */
651
- export declare const READ_ONLY_POST_OPERATIONS: readonly ["batchGetTraders", "batchGetMarketFlow", "batchGetMarketIntel"];
715
+ export declare const READ_ONLY_POST_OPERATIONS: readonly ["batchGetTraders", "batchGetMarketFlow"];
652
716
  /**
653
717
  * Writes whose repeat converges on the state the first one reached, so a
654
718
  * retry cannot repeat a side effect and needs no `Idempotency-Key` (#16254).
@@ -856,6 +920,12 @@ export interface CategorySkillStatusCounts {
856
920
  }
857
921
  /** Query parameters accepted by {@link OxinsiderApiClient.listGames}. */
858
922
  export type GamesListParams = OperationQuery["listGames"];
923
+ /** Query parameters accepted by {@link OxinsiderApiClient.listGameMarkets}. */
924
+ export type GameMarketsListParams = OperationQuery["listGameMarkets"];
925
+ /** Query parameters accepted by {@link OxinsiderApiClient.listGameTrades}. */
926
+ export type GameTradesParams = OperationQuery["listGameTrades"];
927
+ /** One fill in a game, as the game page's activity list shows it. */
928
+ export type { GameTrade } from "./schema.js";
859
929
  /** One game: both sides, its schedule, its provider status and its markets. */
860
930
  export type { Game } from "./schema.js";
861
931
  /** Optional selection axes shared by every Max-only Edge Hunter view. */
@@ -1112,7 +1182,7 @@ export interface ListParams {
1112
1182
  [key: string]: ApiQueryValue;
1113
1183
  }
1114
1184
  /** `GET /api/v1/leaderboard` -> parameters -> strategy (`web/public/api/v1/openapi.json`). */
1115
- export declare const LEADERBOARD_STRATEGIES: readonly ["accumulator", "algo_trader", "arbitrageur", "category_focused", "directional", "diversified", "event_driven", "high_activity", "market_maker", "mixed", "momentum", "scalper", "speculator", "swing_trader", "two_sided", "unclassified"];
1185
+ export declare const LEADERBOARD_STRATEGIES: readonly ["category_focused", "diversified", "high_activity", "mixed", "two_sided", "unclassified"];
1116
1186
  export type LeaderboardStrategy = (typeof LEADERBOARD_STRATEGIES)[number];
1117
1187
  /**
1118
1188
  * Query parameters for `GET /api/v1/leaderboard`, from the operation
@@ -1127,27 +1197,16 @@ export type TrendingWalletsParams = OperationQuery["listTrendingWallets"];
1127
1197
  export type LargeTradeListParams = OperationQuery["listLargeTrades"];
1128
1198
  /** Query parameters of the V1 historical large-trade replay (#16304). */
1129
1199
  export type LargeTradeHistoryParams = OperationQuery["listLargeTradeHistory"];
1130
- /** @deprecated Use {@link LargeTradeListParams} (#16304). */
1131
- export type WhaleTradeListParams = OperationQuery["listWhaleTrades"];
1132
- /** @deprecated Use {@link LargeTradeHistoryParams} (#16304). */
1133
- export type WhaleTradeHistoryParams = OperationQuery["listWhaleTradeHistory"];
1134
1200
  /** Query parameters of `GET /api/v1/positions`. */
1135
1201
  export type PositionsListParams = OperationQuery["listPositions"];
1136
1202
  /** Query parameters of `GET /api/v1/combos/fills`. */
1137
1203
  export type ComboFillsParams = OperationQuery["listComboFills"];
1138
1204
  /** Query parameters of `GET /api/v1/large-positions`. */
1139
1205
  export type LargePositionsListParams = OperationQuery["listLargePositions"];
1140
- /** Query parameters of the sharp-money flows read and its legacy alias. */
1206
+ /** Query parameters of `GET /api/v1/markets/sharp-money-flows`. */
1141
1207
  export type SharpMoneyFlowsParams = OperationQuery["listSharpMoneyFlows"];
1142
1208
  /** Query parameters of `GET /api/v1/suspicious-trades`: `min_suspicion` and `severity`, not a grade. */
1143
1209
  export type SuspiciousTradesListParams = OperationQuery["listSuspiciousTrades"];
1144
- /**
1145
- * @deprecated Use `SuspiciousTradesListParams`; the Insider Radar spelling of
1146
- * this contract was renamed to suspicious trades in #16301. The deprecated
1147
- * `GET /api/v1/insider-radar` takes the same parameters, so this stays an
1148
- * alias with no retirement date.
1149
- */
1150
- export type InsiderRadarListParams = SuspiciousTradesListParams;
1151
1210
  /** Query parameters of `GET /api/v1/markets/explore`. */
1152
1211
  export type ExploreMarketsParams = OperationQuery["exploreMarkets"];
1153
1212
  /**
@@ -1389,12 +1448,6 @@ export declare class OxinsiderApiClient {
1389
1448
  * (`POST /api/v1/markets/flow/batch`); `meta` is the batch's own.
1390
1449
  */
1391
1450
  batchGetMarketFlow(body: OperationBody["batchGetMarketFlow"], options?: ConvenienceOptions): Promise<OperationResult<"batchGetMarketFlow">>;
1392
- /**
1393
- * @deprecated Use {@link batchGetMarketFlow} (#16312); calls the deprecated
1394
- * `POST /api/v1/markets/intel/batch`, whose envelope keeps
1395
- * `object: "market_intel_batch"`.
1396
- */
1397
- batchGetMarketIntel(body: OperationBody["batchGetMarketIntel"], options?: ConvenienceOptions): Promise<OperationResult<"batchGetMarketIntel">>;
1398
1451
  listLeaderboard(params?: LeaderboardListParams, options?: ConvenienceOptions): Promise<Omit<{
1399
1452
  object: "list";
1400
1453
  data: OperationData["listLeaderboard"];
@@ -1415,10 +1468,22 @@ export declare class OxinsiderApiClient {
1415
1468
  }, "meta"> & {
1416
1469
  meta: ClientMeta<ResponseMeta>;
1417
1470
  }>;
1418
- listLargeTrades(params?: LargeTradeListParams, options?: ConvenienceOptions): Promise<Omit<{
1471
+ /** List the leagues that have their own skill leaderboard (single-object envelope). */
1472
+ listLeaderboardLeagues(options?: ConvenienceOptions): Promise<OperationResult<"listLeaderboardLeagues">>;
1473
+ /**
1474
+ * Fetch one sport's skill leaderboard, or with `league` one league's
1475
+ * (single-object envelope). `sport` is a slug such as `soccer`; the leagues
1476
+ * come from {@link listLeaderboardLeagues}.
1477
+ */
1478
+ getSportLeaderboard(sport: OperationPath["getSportLeaderboard"]["sport"], params?: OperationQuery["getSportLeaderboard"], options?: ConvenienceOptions): Promise<OperationResult<"getSportLeaderboard">>;
1479
+ /**
1480
+ * Every sports and esports category's top three edge leaders, by category
1481
+ * and then rank (one list page, not paginated): the categories index on the
1482
+ * site. Same row shape as {@link getCategoryLeaderboard}.
1483
+ */
1484
+ listCategoryLeaders(options?: ConvenienceOptions): Promise<Omit<{
1419
1485
  object: "list";
1420
- data: OperationData["listLargeTrades"];
1421
- data_quality: import("./schema.js").DataQuality;
1486
+ data: OperationData["listCategoryLeaders"];
1422
1487
  has_more: boolean;
1423
1488
  next_cursor?: string;
1424
1489
  total?: number;
@@ -1427,28 +1492,26 @@ export declare class OxinsiderApiClient {
1427
1492
  meta: ClientMeta<ResponseMeta>;
1428
1493
  }>;
1429
1494
  /**
1430
- * Typed conditional-read variant of {@link listLargeTrades}, for polling
1431
- * (#18507). Returns the list envelope on 200 or the typed `not_modified`
1432
- * result on 304, where {@link listLargeTrades} throws on a 304. Pass
1433
- * `since` (the id of the first trade of your last answer that had trades)
1434
- * with `If-None-Match`: a poll that finds no new trade is a 304 with no body.
1495
+ * One page of a category's edge leaderboard: wallets ranked by the 95% lower
1496
+ * bound of their edge over the price they paid in the category. `slug` is a
1497
+ * category such as `soccer` or `esports`; `params.active_within` (`all` |
1498
+ * `7d` | `30d` | `90d`), `params.min_events`, `params.limit` and
1499
+ * `params.cursor` (the previous page's opaque `next_cursor`). `total` counts
1500
+ * the listed wallets across every page.
1435
1501
  */
1436
- listLargeTradesConditional(params?: LargeTradeListParams, options?: ConvenienceOptions): Promise<OperationResult<"listLargeTrades">>;
1437
- listLargeTradeHistory(params?: LargeTradeHistoryParams, options?: ConvenienceOptions): Promise<Omit<{
1502
+ getCategoryLeaderboard(slug: OperationPath["getCategoryLeaderboard"]["slug"], params?: OperationQuery["getCategoryLeaderboard"], options?: ConvenienceOptions): Promise<Omit<{
1438
1503
  object: "list";
1439
- data: OperationData["listLargeTradeHistory"];
1440
- data_quality: import("./schema.js").DataQuality;
1504
+ data: OperationData["getCategoryLeaderboard"];
1441
1505
  has_more: boolean;
1442
1506
  next_cursor?: string;
1443
1507
  total?: number;
1444
- meta: import("./schema.js").LargeTradeHistoryMeta;
1508
+ meta: ResponseMeta;
1445
1509
  }, "meta"> & {
1446
- meta: ClientMeta<import("./schema.js").LargeTradeHistoryMeta>;
1510
+ meta: ClientMeta<ResponseMeta>;
1447
1511
  }>;
1448
- /** @deprecated Use {@link listLargeTrades} (#16304); calls the deprecated `/api/v1/whale-trades`. */
1449
- listWhaleTrades(params?: WhaleTradeListParams, options?: ConvenienceOptions): Promise<Omit<{
1512
+ listLargeTrades(params?: LargeTradeListParams, options?: ConvenienceOptions): Promise<Omit<{
1450
1513
  object: "list";
1451
- data: OperationData["listWhaleTrades"];
1514
+ data: OperationData["listLargeTrades"];
1452
1515
  data_quality: import("./schema.js").DataQuality;
1453
1516
  has_more: boolean;
1454
1517
  next_cursor?: string;
@@ -1457,10 +1520,17 @@ export declare class OxinsiderApiClient {
1457
1520
  }, "meta"> & {
1458
1521
  meta: ClientMeta<ResponseMeta>;
1459
1522
  }>;
1460
- /** @deprecated Use {@link listLargeTradeHistory} (#16304); calls the deprecated `/api/v1/whale-trades/history`. */
1461
- listWhaleTradeHistory(params?: WhaleTradeHistoryParams, options?: ConvenienceOptions): Promise<Omit<{
1523
+ /**
1524
+ * Typed conditional-read variant of {@link listLargeTrades}, for polling
1525
+ * (#18507). Returns the list envelope on 200 or the typed `not_modified`
1526
+ * result on 304, where {@link listLargeTrades} throws on a 304. Pass
1527
+ * `since` (the id of the first trade of your last answer that had trades)
1528
+ * with `If-None-Match`: a poll that finds no new trade is a 304 with no body.
1529
+ */
1530
+ listLargeTradesConditional(params?: LargeTradeListParams, options?: ConvenienceOptions): Promise<OperationResult<"listLargeTrades">>;
1531
+ listLargeTradeHistory(params?: LargeTradeHistoryParams, options?: ConvenienceOptions): Promise<Omit<{
1462
1532
  object: "list";
1463
- data: OperationData["listWhaleTradeHistory"];
1533
+ data: OperationData["listLargeTradeHistory"];
1464
1534
  data_quality: import("./schema.js").DataQuality;
1465
1535
  has_more: boolean;
1466
1536
  next_cursor?: string;
@@ -1509,26 +1579,15 @@ export declare class OxinsiderApiClient {
1509
1579
  }, "meta"> & {
1510
1580
  meta: ClientMeta<ResponseMeta>;
1511
1581
  }>;
1512
- /**
1513
- * @deprecated Use {@link listSharpMoneyFlows} (#16308). Kept live; it calls
1514
- * the deprecated `/api/v1/markets/smart-money-flows`, whose responses carry
1515
- * `Deprecation` and a `Link rel="successor-version"`.
1516
- */
1517
- listSmartMoneyFlows(params?: OperationQuery["listSmartMoneyFlows"], options?: ConvenienceOptions): Promise<Omit<{
1518
- object: "list";
1519
- data: OperationData["listSmartMoneyFlows"];
1520
- has_more: boolean;
1521
- next_cursor?: string;
1522
- total?: number;
1523
- meta: ResponseMeta;
1524
- }, "meta"> & {
1525
- meta: ClientMeta<ResponseMeta>;
1526
- }>;
1527
1582
  /**
1528
1583
  * List covered games: both sides with their provider ids and live scores, the
1529
- * UTC kickoff, the provider's own status, and every linked Polymarket market
1530
- * with its condition id and outcome token ids. Ordered by kickoff, then by
1531
- * `event_slug`, with unscheduled games last. An unknown `sport` or `status`
1584
+ * UTC kickoff, the provider's own status, and the winner markets (the
1585
+ * moneyline, or a soccer game's three 1X2 legs) with their condition ids and
1586
+ * outcome token ids; `listGameMarkets` lists the rest. Ordered by kickoff, then by
1587
+ * `event_slug`, with unscheduled games last. Pass `window: "now"` for what is
1588
+ * on now (games in play, plus any game whose kickoff was at most 3 hours ago
1589
+ * or is still to come); the default, `"all"`, is the whole catalog, which can
1590
+ * start with games weeks old. An unknown `sport` or `status`
1532
1591
  * returns an empty page rather than an error, and the response's `coverage`
1533
1592
  * names what this deployment serves.
1534
1593
  */
@@ -1548,6 +1607,70 @@ export declare class OxinsiderApiClient {
1548
1607
  * webhook pulse carries. A slug outside the published coverage returns 404.
1549
1608
  */
1550
1609
  getGame(eventSlug: OperationPath["getGame"]["event_slug"], options?: ConvenienceOptions): Promise<OperationResult<"getGame">>;
1610
+ /**
1611
+ * List every stored market of one game's `event_slug` and of its child
1612
+ * events: spreads, totals, team totals, period lines and player props, each
1613
+ * with its `condition_id`, `sports_market_type`, typed `line` and outcome
1614
+ * token ids. `families` counts every market type the event holds.
1615
+ * `expand: ["sharp_money"]` adds each row's per-line sharp-money split.
1616
+ */
1617
+ listGameMarkets(eventSlug: OperationPath["listGameMarkets"]["event_slug"], params?: GameMarketsListParams, options?: ConvenienceOptions): Promise<Omit<{
1618
+ data: OperationData["listGameMarkets"];
1619
+ event_slug: string;
1620
+ families: {
1621
+ active: number;
1622
+ markets: number;
1623
+ sports_market_type?: string;
1624
+ }[];
1625
+ has_more: boolean;
1626
+ meta: ResponseMeta;
1627
+ next_cursor?: string;
1628
+ object: string;
1629
+ }, "meta"> & {
1630
+ meta: ClientMeta<ResponseMeta>;
1631
+ }>;
1632
+ /**
1633
+ * Read where the graded money sits on one whole game: S, A and B grade USD per
1634
+ * outcome summed across the game's markets, each outcome's share, the leader,
1635
+ * wallet counts by grade and the backend's verdict. Every aggregate field is
1636
+ * `null` unless `status` is `computed`. A game still computing answers 503
1637
+ * `read_model_warming` with `Retry-After`, which the client's retries honour.
1638
+ * Pro and Max.
1639
+ */
1640
+ getGameSharpMoney(eventSlug: OperationPath["getGameSharpMoney"]["event_slug"], options?: ConvenienceOptions): Promise<OperationResult<"getGameSharpMoney">>;
1641
+ /**
1642
+ * List a game's newest fills across every market in it, newest first and
1643
+ * live: the moneyline, spreads, totals and every prop. The list does not
1644
+ * page (`has_more` is always `false`); deduplicate on `id`. This method
1645
+ * throws on a 304, so poll with {@link listGameTradesConditional} and
1646
+ * `If-None-Match`; it returns the typed `not_modified` result instead.
1647
+ * `source_stale` is `true` while the game's refresh runs. A 503
1648
+ * `read_model_warming` means the first read is still running.
1649
+ */
1650
+ listGameTrades(eventSlug: OperationPath["listGameTrades"]["event_slug"], params?: GameTradesParams, options?: ConvenienceOptions): Promise<Omit<{
1651
+ object: "list";
1652
+ data: OperationData["listGameTrades"];
1653
+ has_more: boolean;
1654
+ event_slug: string;
1655
+ source_stale: boolean;
1656
+ meta: ResponseMeta;
1657
+ }, "meta"> & {
1658
+ meta: ClientMeta<ResponseMeta>;
1659
+ }>;
1660
+ /**
1661
+ * Typed conditional-read variant of {@link listGameTrades}, for polling.
1662
+ * Returns the list envelope on 200 or the typed `not_modified` result on
1663
+ * 304, where {@link listGameTrades} throws on a 304. Send the last `ETag`
1664
+ * as the `If-None-Match` header in `options.headers`.
1665
+ */
1666
+ listGameTradesConditional(eventSlug: OperationPath["listGameTrades"]["event_slug"], params?: GameTradesParams, options?: ConvenienceOptions): Promise<OperationResult<"listGameTrades">>;
1667
+ /**
1668
+ * The graded holders of up to 25 of one game's markets in one request
1669
+ * (`GET /api/v1/games/{event_slug}/holders`): each item is
1670
+ * {@link getMarketHolders} for one market, unfiltered and cut to `limit`.
1671
+ * Batch envelope, so `meta` is the batch's own.
1672
+ */
1673
+ getGameHolders(eventSlug: OperationPath["getGameHolders"]["event_slug"], params: OperationQuery["getGameHolders"], options?: ConvenienceOptions): Promise<OperationResult<"getGameHolders">>;
1551
1674
  searchMarkets(q: OperationQuery["searchMarkets"]["q"], options?: ConvenienceOptions & {
1552
1675
  query?: Omit<OperationQuery["searchMarkets"], "q">;
1553
1676
  }): Promise<Omit<{
@@ -1587,18 +1710,12 @@ export declare class OxinsiderApiClient {
1587
1710
  }>;
1588
1711
  /** One market's flow and top positions (`GET /api/v1/market/{condition_id}/flow`). */
1589
1712
  getMarketFlow(conditionId: OperationPath["getMarketFlow"]["condition_id"], options?: Omit<OperationRequestOptions<"getMarketFlow">, "path">): Promise<OperationResult<"getMarketFlow">>;
1590
- /**
1591
- * @deprecated Use {@link getMarketFlow} (#16312); calls the deprecated
1592
- * `GET /api/v1/market/{condition_id}/intel`, whose envelope keeps
1593
- * `object: "market_intel"`.
1594
- */
1595
- getMarketIntel(conditionId: OperationPath["getMarketIntel"]["condition_id"], options?: Omit<OperationRequestOptions<"getMarketIntel">, "path">): Promise<OperationResult<"getMarketIntel">>;
1596
1713
  getMarketSnapshot(conditionId: OperationPath["getMarketSnapshot"]["condition_id"], options?: Omit<OperationRequestOptions<"getMarketSnapshot">, "path">): Promise<OperationResult<"getMarketSnapshot">>;
1597
1714
  /**
1598
1715
  * One page of a market's graded (S/A/B) holder roster from a complete
1599
1716
  * provider holder scan: the list a Pick of the Day shows, for any market.
1600
1717
  * `params.outcome` (`yes` | `no` | `all`), `params.min_grade` (`S` | `A` |
1601
- * `B`), `params.limit` and `params.cursor` (`mh_` prefix). The page carries
1718
+ * `B`), `params.limit` and `params.cursor` (the previous page's opaque `next_cursor`). The page carries
1602
1719
  * the `market`, `scan` and roster `totals` beside `data`; `total` is the
1603
1720
  * count matching the filters across every page.
1604
1721
  */
@@ -1615,6 +1732,15 @@ export declare class OxinsiderApiClient {
1615
1732
  }, "meta"> & {
1616
1733
  meta: ClientMeta<ResponseMeta>;
1617
1734
  }>;
1735
+ /**
1736
+ * A market's largest holders on each outcome, every grade from S to F and
1737
+ * ungraded wallets included: the event page's Top holders table (#32238).
1738
+ * `params.limit` is holders per outcome (1-100). `data.yes` and `data.no`
1739
+ * are largest `shares` first; `data.totals` covers the whole sample, at
1740
+ * most 100 per outcome. For the complete S/A/B roster use
1741
+ * `getMarketHolders`.
1742
+ */
1743
+ getMarketTopHolders(conditionId: OperationPath["getMarketTopHolders"]["condition_id"], params?: OperationQuery["getMarketTopHolders"], options?: ConvenienceOptions): Promise<OperationResult<"getMarketTopHolders">>;
1618
1744
  /**
1619
1745
  * Fetch bucketed OHLC candles for a market's outcome tokens.
1620
1746
  * Resolution defaults to the server default; pass `params.resolution` as
@@ -1623,6 +1749,13 @@ export declare class OxinsiderApiClient {
1623
1749
  * `to`.
1624
1750
  */
1625
1751
  getMarketCandles(conditionId: OperationPath["getMarketCandles"]["condition_id"], params?: OperationQuery["getMarketCandles"], options?: ConvenienceOptions): Promise<OperationResult<"getMarketCandles">>;
1752
+ /**
1753
+ * Fetch one market's net buyers and net sellers over the last 24 hours
1754
+ * (the default) or 7 days: the window totals and the top 25 wallets on each
1755
+ * side, live, as the market page's wallets in/out panel shows a Pro viewer.
1756
+ * Pass `params.window` as `"24h"` or `"7d"`.
1757
+ */
1758
+ getMarketWalletsInOut(conditionId: OperationPath["getMarketWalletsInOut"]["condition_id"], params?: OperationQuery["getMarketWalletsInOut"], options?: ConvenienceOptions): Promise<OperationResult<"getMarketWalletsInOut">>;
1626
1759
  /**
1627
1760
  * Fetch one suspicious trade by raw `whale_alerts.id` or the `rf_`-prefixed
1628
1761
  * id list responses emit. The envelope's `object` is `"suspicious_trade"`.
@@ -1639,32 +1772,7 @@ export declare class OxinsiderApiClient {
1639
1772
  }, "meta"> & {
1640
1773
  meta: ClientMeta<ResponseMeta>;
1641
1774
  }>;
1642
- /**
1643
- * @deprecated Use `getSuspiciousTrade()`; renamed in #16301. This method
1644
- * keeps calling the deprecated `GET /api/v1/insider-radar/{id}`, which stays
1645
- * live with no retirement date and still answers `object: "radar_flag"`, so
1646
- * an integration branching on that envelope keeps working.
1647
- */
1648
- getInsiderRadarFlag(id: OperationPath["getInsiderRadarFlag"]["id"], options?: ConvenienceOptions): Promise<OperationResult<"getInsiderRadarFlag">>;
1649
- /**
1650
- * @deprecated Use `listSuspiciousTrades()`; renamed in #16301. This method
1651
- * keeps calling the deprecated `GET /api/v1/insider-radar`, which stays live
1652
- * with no retirement date and answers with `Deprecation` plus a `Link
1653
- * rel="successor-version"` header.
1654
- */
1655
- listInsiderRadar(params?: InsiderRadarListParams, options?: ConvenienceOptions): Promise<Omit<{
1656
- object: "list";
1657
- data: OperationData["listInsiderRadar"];
1658
- has_more: boolean;
1659
- next_cursor?: string;
1660
- total?: number;
1661
- meta: ResponseMeta;
1662
- }, "meta"> & {
1663
- meta: ClientMeta<ResponseMeta>;
1664
- }>;
1665
1775
  getLargeTrade(id: OperationPath["getLargeTrade"]["id"], options?: ConvenienceOptions): Promise<OperationResult<"getLargeTrade">>;
1666
- /** @deprecated Use {@link getLargeTrade} (#16304); calls the deprecated `/api/v1/whale-trades/{id}`. */
1667
- getWhaleTrade(id: OperationPath["getWhaleTrade"]["id"], options?: ConvenienceOptions): Promise<OperationResult<"getWhaleTrade">>;
1668
1776
  /**
1669
1777
  * Cancel a submitted export (`POST /api/v1/trader/{address}/export/cancel`, #16254).
1670
1778
  *
@@ -1737,11 +1845,6 @@ export declare class OxinsiderApiClient {
1737
1845
  * Public: needs no API key.
1738
1846
  */
1739
1847
  getCoverage(options?: ConvenienceOptions): Promise<OperationResult<"getCoverage">>;
1740
- /**
1741
- * @deprecated Use {@link getCoverage} (#16315); calls the deprecated
1742
- * `GET /api/v1/platforms`, which serves the same body.
1743
- */
1744
- getPlatforms(options?: ConvenienceOptions): Promise<OperationResult<"getPlatforms">>;
1745
1848
  getAccountIdentity(options?: ConvenienceOptions): Promise<OperationResult<"getAccountIdentity">>;
1746
1849
  /**
1747
1850
  * One wallet's context as Markdown, ready to paste into a model prompt
@@ -1769,8 +1872,25 @@ export declare class OxinsiderApiClient {
1769
1872
  getUsage(options?: ConvenienceOptions): Promise<OperationResult<"getUsage">>;
1770
1873
  /** Fetch today's editorial Pick of the Day (single-object envelope). */
1771
1874
  getPickOfTheDay(options?: ConvenienceOptions): Promise<OperationResult<"getPickOfTheDay">>;
1875
+ /**
1876
+ * Fetch a past product day's Pick of the Day slate (single-object envelope),
1877
+ * gated by the key's tier the same way the dated web page is. `date` is a
1878
+ * product day in America/New_York, `YYYY-MM-DD`; today's date is the same
1879
+ * read as `getPickOfTheDay`. A past day with no published pick throws the
1880
+ * 404 `not_found` with `error.param` `date`, which a retry cannot change;
1881
+ * a date after today throws the 400 `bad_request`.
1882
+ */
1883
+ getPickOfTheDayForDate(date: NonNullable<OperationQuery["getPickOfTheDay"]["date"]>, options?: ConvenienceOptions): Promise<OperationResult<"getPickOfTheDay">>;
1772
1884
  /** Fetch the Pick of the Day archive with hit-rate (single-object envelope). */
1773
1885
  getPickOfTheDayArchive(options?: ConvenienceOptions): Promise<OperationResult<"getPickOfTheDayArchive">>;
1886
+ /** Fetch the Pick of the Day track-record breakdown the stats page shows (single-object envelope). */
1887
+ getPickOfTheDayStats(options?: ConvenienceOptions): Promise<OperationResult<"getPickOfTheDayStats">>;
1888
+ /**
1889
+ * Fetch one UTC day's resolution report (single-object envelope): how often
1890
+ * the profitable wallets' side won on the day's resolved sports and esports
1891
+ * markets. `view: "totals"` drops the per-market list.
1892
+ */
1893
+ getResolutionReport(date: OperationQuery["getResolutionReport"]["date"], params?: Omit<OperationQuery["getResolutionReport"], "date">, options?: ConvenienceOptions): Promise<OperationResult<"getResolutionReport">>;
1774
1894
  /**
1775
1895
  * Fetch the Pick of the Day commitment ledger (single-object envelope).
1776
1896
  *