@0xinsider/mcp 2.10.1 → 2.11.4

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.
Files changed (46) hide show
  1. package/dist/constants.d.ts +1 -1
  2. package/dist/constants.js +1 -1
  3. package/dist/sdk/client.d.ts +10 -5
  4. package/dist/sdk/client.d.ts.map +1 -1
  5. package/dist/sdk/client.js +9 -4
  6. package/dist/sdk/client.js.map +1 -1
  7. package/dist/sdk/schema.d.ts +34 -22
  8. package/dist/sdk/schema.d.ts.map +1 -1
  9. package/dist/tools/explore-markets.js +3 -3
  10. package/dist/tools/explore-markets.js.map +1 -1
  11. package/dist/tools/games.d.ts.map +1 -1
  12. package/dist/tools/games.js +8 -6
  13. package/dist/tools/games.js.map +1 -1
  14. package/dist/tools/get-large-positions.d.ts.map +1 -1
  15. package/dist/tools/get-large-positions.js +10 -8
  16. package/dist/tools/get-large-positions.js.map +1 -1
  17. package/dist/tools/get-market-flow.d.ts.map +1 -1
  18. package/dist/tools/get-market-flow.js +21 -12
  19. package/dist/tools/get-market-flow.js.map +1 -1
  20. package/dist/tools/get-position-timeline.js +4 -4
  21. package/dist/tools/get-position-timeline.js.map +1 -1
  22. package/dist/tools/get-positions.d.ts +1 -1
  23. package/dist/tools/get-positions.d.ts.map +1 -1
  24. package/dist/tools/get-positions.js +6 -3
  25. package/dist/tools/get-positions.js.map +1 -1
  26. package/dist/tools/get-suspicious-trades.d.ts +8 -2
  27. package/dist/tools/get-suspicious-trades.d.ts.map +1 -1
  28. package/dist/tools/get-suspicious-trades.js +16 -3
  29. package/dist/tools/get-suspicious-trades.js.map +1 -1
  30. package/dist/tools/get-trader-pnl.d.ts.map +1 -1
  31. package/dist/tools/get-trader-pnl.js +6 -4
  32. package/dist/tools/get-trader-pnl.js.map +1 -1
  33. package/dist/tools/get-trader.js +2 -2
  34. package/dist/tools/get-trending-wallets.d.ts.map +1 -1
  35. package/dist/tools/get-trending-wallets.js +9 -7
  36. package/dist/tools/get-trending-wallets.js.map +1 -1
  37. package/dist/tools/get-whale-trades.d.ts.map +1 -1
  38. package/dist/tools/get-whale-trades.js +37 -18
  39. package/dist/tools/get-whale-trades.js.map +1 -1
  40. package/dist/tools/pick-of-the-day.js +1 -1
  41. package/dist/tools/read-parity.d.ts.map +1 -1
  42. package/dist/tools/read-parity.js +158 -84
  43. package/dist/tools/read-parity.js.map +1 -1
  44. package/dist/tools/search-markets.js +1 -1
  45. package/dist/tools/search-markets.js.map +1 -1
  46. package/package.json +1 -2
@@ -382,7 +382,8 @@ export type ExploreGroup = {
382
382
  event_slug: string;
383
383
  parent_title: string;
384
384
  image: string | null;
385
- platform: string | null;
385
+ /** Provider platform. Always polymarket, or null when the row carries no stored value. */
386
+ platform: "polymarket" | null;
386
387
  category: string | null;
387
388
  /** Markets in the event cluster, ranked by volume with condition_id as the tie-breaker. The selected representative is retained within the 12-market cap. */
388
389
  markets: ExploreMarket[];
@@ -403,7 +404,8 @@ export type ExploreMarket = {
403
404
  image: string | null;
404
405
  icon: string | null;
405
406
  category: string | null;
406
- platform: string | null;
407
+ /** Provider platform. Always polymarket, or null when the row carries no stored value. */
408
+ platform: "polymarket" | null;
407
409
  /** closed once Polymarket has closed trading or the market has resolved; active otherwise. The same rule labels a market on markets/search, markets/explore and market/{condition_id}/snapshot. */
408
410
  status: "active" | "closed";
409
411
  volume: number | null;
@@ -431,6 +433,7 @@ export type ExploreMarket = {
431
433
  event_slug: string | null;
432
434
  smart_score: number | null;
433
435
  smart_count: number | null;
436
+ /** The outcome graded money leans toward RELATIVE TO THE PRICE: named only when the graded money's share of a side diverges from that side's price-implied share by at least 10 points, with at least $500 on the leaning side and outside the crowded-side guard. Null when the money sits with the price (no lean), when there is no graded money, or when the price is unavailable. The same rule as the market page. */
434
437
  smart_label: string | null;
435
438
  /** Display label for the YES/outcome_index=0 side, enriched from provider outcome metadata when available. */
436
439
  outcome_yes_label: string | null;
@@ -590,7 +593,7 @@ export type GameMarket = {
590
593
  /** The raw provider condition id. */
591
594
  condition_id: string;
592
595
  /** Always polymarket. */
593
- platform: string;
596
+ platform: "polymarket";
594
597
  /** The provider's market slug. Omitted when the provider sent none. */
595
598
  slug?: string;
596
599
  /** The provider's own market type, for example moneyline or spread. Omitted when the provider sent none. Not an enum: the provider owns this vocabulary and adds to it. */
@@ -888,7 +891,8 @@ export type LeaderboardEntry = {
888
891
  /** The wallet's win rate across ALL categories, not the filtered one. ?category= decides WHICH wallets are listed (the wallet must be ranked in that category); it does not rescope this field, so a soccer-filtered list still reports each wallet's overall rate. For a per-category record use GET /api/v1/trader/{address}/categories. */
889
892
  win_rate?: number;
890
893
  strategy_type?: string;
891
- platform: string;
894
+ /** Provider platform. Always polymarket. */
895
+ platform: "polymarket";
892
896
  last_active?: string;
893
897
  };
894
898
  /** Provider-first bucketed OHLC price candles for a market's outcome tokens, derived from the stored token_price_snapshots series (covers open and resolved markets). */
@@ -907,7 +911,8 @@ export type MarketFlow = {
907
911
  title: string;
908
912
  slug: string | null;
909
913
  category: string | null;
910
- platform: string | null;
914
+ /** Provider platform. Always polymarket, or null when the row carries no stored value. */
915
+ platform: "polymarket" | null;
911
916
  };
912
917
  /** Outcome-aware flow from all tracked whale trades in the window, without a grade filter. BUY YES and SELL NO add net exposure; BUY NO and SELL YES subtract it. Gross buy/sell volumes count both outcomes. Top positions are separately graded. Direction uses unrounded net: negative is NO, otherwise YES; the zero tie-break is not conviction. Canonical; smart_money is a deprecated byte-identical alias. */
913
918
  sharp_money: {
@@ -1063,7 +1068,8 @@ export type MarketSearchResult = {
1063
1068
  title: string;
1064
1069
  slug: string | null;
1065
1070
  category: string | null;
1066
- platform: string | null;
1071
+ /** Provider platform. Always polymarket, or null when the row carries no stored value. */
1072
+ platform: "polymarket" | null;
1067
1073
  /** closed once Polymarket has closed trading or the market has resolved; active otherwise. The same rule labels a market on markets/search, markets/explore and market/{condition_id}/snapshot. */
1068
1074
  status: "active" | "closed";
1069
1075
  };
@@ -1218,10 +1224,10 @@ export type PickOfTheDay = {
1218
1224
  matchup?: string;
1219
1225
  /** Frozen canonical calibration/report bucket (e.g. "Basketball", "MMA", or "Soccer"). Existing semantics are unchanged; presentation consumers should prefer display_category when present. */
1220
1226
  category?: string;
1221
- /** Frozen public presentation category. For supported Polymarket sports this is the exact verified provider event identity: an official league (e.g. "WNBA" or "UFC"), the esports title (e.g. "CS2", "LoL", "Dota 2" or "Valorant"), or a soccer competition whose official mark we vendor (e.g. "LaLiga", "Premier League", "Serie A" or "UEFA Champions League"). Only identities with a vendored official mark are split out; every other competition keeps its canonical bucket, so "Soccer" remains a live value; otherwise it equals category. An esports pick keeps the pooled "Esports" bucket in category, so a per-title label never implies a per-title measured cohort. Additive and optional for mixed-version client compatibility. */
1227
+ /** Frozen public presentation category: the competition the Polymarket event belongs to. A curated label comes first -- an official league (e.g. "WNBA" or "UFC"), the esports title (e.g. "CS2", "LoL", "Dota 2" or "Valorant"), or a soccer competition (e.g. "LaLiga", "Premier League", "Serie A" or "UEFA Champions League"); any other competition carries the provider's own competition name without its season year (e.g. "UEFA Nations League", "ATP" or "Wimbledon"). It equals category only when the provider names no competition. An esports pick keeps the pooled "Esports" bucket in category, so a per-title label never implies a per-title measured cohort. Additive and optional for mixed-version client compatibility. */
1222
1228
  display_category?: string;
1223
- /** Provider platform (e.g. "polymarket"). */
1224
- platform?: string;
1229
+ /** Provider platform. Always polymarket. */
1230
+ platform?: "polymarket";
1225
1231
  /** The pick's stored release instant. Normally the current provider kickoff minus one hour; an operator may override it. The actual publish instant can trail it because of worker or claim delay. */
1226
1232
  release_at?: string;
1227
1233
  /** True only before the pick's stored release instant (a pre-release embargo flag); effectively always false on a served, already-published pick. To detect that the backed game has kicked off, use `game_started`. */
@@ -1409,11 +1415,13 @@ export type PickOfTheDayArchiveEntry = {
1409
1415
  pick_date: string;
1410
1416
  /** Stable 1-based slot within the product day's ranked picks. */
1411
1417
  pick_rank?: number;
1418
+ /** When this pick became public (RFC3339 UTC). pick_date above is the America/New_York product day, not an instant, so read this whenever you need a real time: reading the bare date as UTC midnight places it hours before the earliest instant a pick can drop (11:00 UTC on that date). A day's last pick can drop at 23:00 ET, which is the following UTC date. Omitted (not null) when the instant is unknown; additive and optional for mixed-version client compatibility. */
1419
+ published_at?: string;
1412
1420
  /** Human-readable matchup (e.g. "Portugal vs. Uzbekistan"). */
1413
1421
  matchup: string;
1414
1422
  /** Frozen canonical calibration/report bucket (e.g. "Basketball", "MMA", or "Soccer"). Existing semantics are unchanged; presentation consumers should prefer display_category when present. */
1415
1423
  category: string;
1416
- /** Frozen public presentation category. For supported Polymarket sports this is the exact verified provider event identity: an official league (e.g. "WNBA" or "UFC"), the esports title (e.g. "CS2", "LoL", "Dota 2" or "Valorant"), or a soccer competition whose official mark we vendor (e.g. "LaLiga", "Premier League", "Serie A" or "UEFA Champions League"). Only identities with a vendored official mark are split out; every other competition keeps its canonical bucket, so "Soccer" remains a live value; otherwise it equals category. An esports pick keeps the pooled "Esports" bucket in category, so a per-title label never implies a per-title measured cohort. Additive and optional for mixed-version client compatibility. */
1424
+ /** Frozen public presentation category: the competition the Polymarket event belongs to. A curated label comes first -- an official league (e.g. "WNBA" or "UFC"), the esports title (e.g. "CS2", "LoL", "Dota 2" or "Valorant"), or a soccer competition (e.g. "LaLiga", "Premier League", "Serie A" or "UEFA Champions League"); any other competition carries the provider's own competition name without its season year (e.g. "UEFA Nations League", "ATP" or "Wimbledon"). It equals category only when the provider names no competition. An esports pick keeps the pooled "Esports" bucket in category, so a per-title label never implies a per-title measured cohort. Additive and optional for mixed-version client compatibility. */
1417
1425
  display_category?: string;
1418
1426
  /** Provider (Polymarket Gamma) market thumbnail URL (markets.image); omitted (not null) when the market has no image. Public regardless of the backed-side gate, so present for pending rows too. */
1419
1427
  image_url?: string;
@@ -1425,6 +1433,8 @@ export type PickOfTheDayArchiveEntry = {
1425
1433
  outcome: "pending" | "win" | "loss" | "void";
1426
1434
  /** Pre-formatted settlement status for display: "Win" / "Loss" / "Void" / "Pending" -- the outcome enum above as a label, from the same formatter the pick payload's outcome_display uses. Convenience only; outcome is the source value. */
1427
1435
  outcome_display?: string;
1436
+ /** When outcome was LAST written to a settled value (RFC3339 UTC), the same instant the commitment ledger publishes. It moves with a corrected market re-mapping an already-settled pick. Omitted (not null) for a pending pick and for a pick that settled before the instant was recorded, so absence means the instant is unknown, never that the pick is unsettled -- outcome answers that. Additive and optional for mixed-version client compatibility. */
1437
+ resolved_at?: string;
1428
1438
  /** The flat stake this row was valued at, in USD: 1000 since 2026-09-22 (100 before). Every row of the record is valued at the current stake, including picks published before the change. Present exactly when return_usd is. */
1429
1439
  stake_usd?: number;
1430
1440
  /** Gross return of stake_usd on this resolved pick: a win returns stake_usd / backed_price, a loss returns 0, a void refunds stake_usd. A loss always returns 0 (the whole stake is lost regardless of price). The operand is published beside it as backed_price on exactly the same rows, so the entry never has to be recovered by inverting this number. Omitted (not null) only for a still-pending pick or a resolved WIN with no frozen price (a win's payout needs the price); mirrors the backend skip-when-absent behavior and the route-client optional (non-nullable) schema. */
@@ -1472,8 +1482,8 @@ export type PickOfTheDayCommitmentPayload = {
1472
1482
  pick_outcome_label: string;
1473
1483
  /** 1-based daily slot. */
1474
1484
  pick_rank: number;
1475
- /** Provider platform. */
1476
- platform: string;
1485
+ /** Provider platform. Always polymarket. */
1486
+ platform: "polymarket";
1477
1487
  };
1478
1488
  export type PickOfTheDayHitRate = {
1479
1489
  /** Number of decided picks that won. */
@@ -1650,8 +1660,8 @@ export type PickOfTheDayUncommittedPayload = {
1650
1660
  pick_outcome_label: string;
1651
1661
  /** 1-based daily slot. */
1652
1662
  pick_rank: number;
1653
- /** Provider platform. */
1654
- platform: string;
1663
+ /** Provider platform. Always polymarket. */
1664
+ platform: "polymarket";
1655
1665
  };
1656
1666
  /** Provider-first sports context for a Pick of the Day market: team crests, league branding, and live score. Team logos and league logo are provider-owned (Polymarket /teams crests for clubs, country flags for national teams and tennis players); no local derivation. */
1657
1667
  export type PickSportsContext = {
@@ -1721,7 +1731,8 @@ export type PlatformCapabilities = {
1721
1731
  insider_radar: PlatformCapabilityStatus;
1722
1732
  market_snapshot: PlatformCapabilityStatus;
1723
1733
  };
1724
- export type PlatformCapabilityStatus = "supported" | "partial" | "unsupported";
1734
+ /** Every capability the API serves reports supported. The field names a per-capability status so a client can branch on coverage; no other value is emitted. */
1735
+ export type PlatformCapabilityStatus = "supported";
1725
1736
  export type Platforms = {
1726
1737
  platforms: {
1727
1738
  polymarket: PlatformCapabilities;
@@ -2086,8 +2097,8 @@ export type ReportPayload = {
2086
2097
  trade_time: string | null;
2087
2098
  /** Provider market category. */
2088
2099
  market_category: string | null;
2089
- /** Venue: polymarket. */
2090
- platform: string | null;
2100
+ /** Always polymarket, or null when the row carries no stored value. */
2101
+ platform: "polymarket" | null;
2091
2102
  /** Trader display name, when known. */
2092
2103
  name: string | null;
2093
2104
  /** Trader pseudonym, when no display name is known. */
@@ -2114,8 +2125,8 @@ export type ReportPayload = {
2114
2125
  trade_time: string | null;
2115
2126
  /** Provider market category. */
2116
2127
  market_category: string | null;
2117
- /** Venue: polymarket. */
2118
- platform: string | null;
2128
+ /** Always polymarket, or null when the row carries no stored value. */
2129
+ platform: "polymarket" | null;
2119
2130
  /** Trader display name, when known. */
2120
2131
  name: string | null;
2121
2132
  /** Trader pseudonym, when no display name is known. */
@@ -2210,7 +2221,8 @@ export type SmartMoneyFlowMarket = {
2210
2221
  title: string | null;
2211
2222
  slug: string | null;
2212
2223
  category: string | null;
2213
- platform: string | null;
2224
+ /** Provider platform. Always polymarket, or null when the row carries no stored value. */
2225
+ platform: "polymarket" | null;
2214
2226
  };
2215
2227
  /** Sharp-money flow aggregate for the market (canonical; smart_money is a deprecated byte-identical alias). */
2216
2228
  sharp_money: {
@@ -2761,7 +2773,7 @@ export type TrendingWallet = {
2761
2773
  profile_image_url?: string;
2762
2774
  /** Real provider platform; surfaced, never coerced. Polymarket only. */
2763
2775
  platform: "polymarket";
2764
- /** Polymarket weekly/monthly P&L for the wallet in USD, taken from Polymarket's canonical leaderboard (data-api.polymarket.com/v1/leaderboard?timePeriod=week|month&orderBy=PNL). This is the ranking axis and the rows are returned in Polymarket's by-PNL order; it is the provider's number, not a locally summed realized-leaf total. */
2776
+ /** Polymarket weekly/monthly P&L for the wallet in USD, taken from Polymarket's canonical leaderboard (data-api.polymarket.com/v2/leaderboard?time_period=week|month&sort_by=PNL). This is the ranking axis and the rows are returned in Polymarket's by-PNL order; it is the provider's number, not a locally summed realized-leaf total. */
2765
2777
  trending_pnl_usd: number;
2766
2778
  /** Both-sides cash volume over the window in USD, from Polymarket GET /v2/user-volume (volume_usdc). Omitted when Polymarket served no volume for the wallet: an absent observation, never zero. Polymarket tracks volume in whole UTC days, so this window is the whole-day span covering the requested one, which is not the exact span trending_pnl_usd was scored over. */
2767
2779
  window_volume_usd?: number;
@@ -3466,7 +3478,7 @@ export interface OperationQuery {
3466
3478
  category?: string;
3467
3479
  /** Minimum trader grade. */
3468
3480
  min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
3469
- /** Scope to one market. Accepts the raw provider condition_id or the mkt_-prefixed market id (round-trips a value from a list response). Polymarket-only; an unknown id returns []. */
3481
+ /** Scope to one market. Accepts the raw provider condition_id or the mkt_-prefixed market id (round-trips a value from a list response). Must be 0x followed by 64 hexadecimal characters after any mkt_ prefix is stripped; any other value returns 400. Polymarket-only; an unknown but well-formed id returns []. */
3470
3482
  condition_id?: string;
3471
3483
  };
3472
3484
  listLargeTradeCounterpartyExecutions: {