@0xinsider/mcp 2.10.0 → 2.11.4

package/dist/sdk/schema.d.ts

@@ -382,7 +382,8 @@ export type ExploreGroup = {
     event_slug: string;
     parent_title: string;
     image: string | null;
-    platform: string | null;
+    /** Provider platform. Always polymarket, or null when the row carries no stored value. */
+    platform: "polymarket" | null;
     category: string | null;
     /** 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. */
     markets: ExploreMarket[];
@@ -403,7 +404,8 @@ export type ExploreMarket = {
     image: string | null;
     icon: string | null;
     category: string | null;
-    platform: string | null;
+    /** Provider platform. Always polymarket, or null when the row carries no stored value. */
+    platform: "polymarket" | null;
     /** 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. */
     status: "active" | "closed";
     volume: number | null;
@@ -431,6 +433,7 @@ export type ExploreMarket = {
     event_slug: string | null;
     smart_score: number | null;
     smart_count: number | null;
+    /** 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. */
     smart_label: string | null;
     /** Display label for the YES/outcome_index=0 side, enriched from provider outcome metadata when available. */
     outcome_yes_label: string | null;
@@ -590,7 +593,7 @@ export type GameMarket = {
     /** The raw provider condition id. */
     condition_id: string;
     /** Always polymarket. */
-    platform: string;
+    platform: "polymarket";
     /** The provider's market slug. Omitted when the provider sent none. */
     slug?: string;
     /** 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 = {
     /** 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. */
     win_rate?: number;
     strategy_type?: string;
-    platform: string;
+    /** Provider platform. Always polymarket. */
+    platform: "polymarket";
     last_active?: string;
 };
 /** 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 = {
         title: string;
         slug: string | null;
         category: string | null;
-        platform: string | null;
+        /** Provider platform. Always polymarket, or null when the row carries no stored value. */
+        platform: "polymarket" | null;
     };
     /** 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. */
     sharp_money: {
@@ -1063,7 +1068,8 @@ export type MarketSearchResult = {
     title: string;
     slug: string | null;
     category: string | null;
-    platform: string | null;
+    /** Provider platform. Always polymarket, or null when the row carries no stored value. */
+    platform: "polymarket" | null;
     /** 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. */
     status: "active" | "closed";
 };
@@ -1169,9 +1175,13 @@ export type PickHolder = {
     name: string | null;
     /** All-time trader grade (S, A, B, C, D, F). */
     grade: string | null;
+    /** The wallet's most recent recorded trade time, stamped at serve time from its current trader record rather than frozen with the pick. Always sent; null when no trade time is recorded. */
+    last_traded_at: string | null;
     /** 0xinsider profile path segment this wallet links to: `@<username>` when that username resolves to this wallet alone, otherwise the lowercase wallet. Percent-encode the part after `@` and append to `https://0xinsider.com/profile/`. Stamped at serve time; absent on a body cached before the field shipped. */
     profile_segment?: string;
     shares: number;
+    /** USD entry value of this wallet's position: `shares` times the pick's frozen `backed_price`. An entry valuation, never a live balance or the provider's current value. Omitted when the holder snapshot has no valid price. */
+    entry_value_usd?: number;
     /** This wallet's win rate in the pick's canonical category bucket (the pick's `category` field, e.g. Basketball -- label the rate with it, never with the narrower `display_category` league, except when `category_win_rate_game` is present, in which case the rate is that game's and is labelled with it): the share of the wallet's resolved markets in that category whose realized P&L closed positive, as a 0..1 fraction. Present only with `category_win_rate_status` = `measured`, on `display_holders` entries, and only when the wallet clears the resolved-market floor; recomputed at serve time from the current category read model, not frozen with the pick. Absent on `holders` entries, legacy rows, and payloads predating the field. */
     category_win_rate?: number;
     /** The two counts `category_win_rate` is the ratio of, read from the same row: `wins / decided` equals the rate. Counts every resolved Polymarket market the wallet traded in the pick's canonical category (or in its game, when `category_win_rate_game` is present), at any position size; the counts are rebuilt daily. Present only with `category_win_rate_status` = `measured`; absent otherwise and on payloads predating the field. */
@@ -1214,16 +1224,18 @@ export type PickOfTheDay = {
     matchup?: string;
     /** Frozen canonical calibration/report bucket (e.g. "Basketball", "MMA", or "Soccer"). Existing semantics are unchanged; presentation consumers should prefer display_category when present. */
     category?: string;
-    /** 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. */
+    /** 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. */
     display_category?: string;
-    /** Provider platform (e.g. "polymarket"). */
-    platform?: string;
+    /** Provider platform. Always polymarket. */
+    platform?: "polymarket";
     /** 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. */
     release_at?: string;
     /** 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`. */
     is_locked?: boolean;
     /** True once the backed game's kickoff has passed (kickoff <= now). When true the snapshotted pre-game price is no longer actionable. Absent for a legacy pick with no stored kickoff (treat as not-started). */
     game_started?: boolean;
+    /** Whether the backed game is over according to the cached live scoreboard, read at serve time. Tells a finished game from one still in play before `outcome` settles. Omitted when the pick has no event slug or no scoreboard is cached for it; absence is unknown, never false. */
+    game_ended?: boolean;
     /** Settlement outcome of the backed side; 'pending' until the market resolves. */
     outcome?: "pending" | "win" | "loss" | "void";
     /** Pre-formatted SETTLEMENT STATUS for display: "Win" / "Loss" / "Void" / "Pending" -- the outcome enum above as a label. Convenience only; outcome is the source value. NOTE: this is the win/loss STATUS, not the backed side. The backed side is pick_outcome_label ("Belgium (-2.5)") -- a different field answering a different question. */
@@ -1354,6 +1366,8 @@ export type PickOfTheDay = {
     thesis?: string;
     /** Canonical web market URL. */
     market_url?: string;
+    /** Where this pick's outbound Polymarket link lands: Polymarket's own redirect answer for `/event/<event_slug>`, carrying the referral tag. Omitted until that redirect has been resolved; link to the event page instead when it is absent. */
+    polymarket_url?: string;
     /** The canonical /event game-page slug (one neutral page per game); omitted when the game has no neutral event page. */
     event_slug?: string;
     /** Backend-resolved /event destination slug for this pick's source market; its absence is an authoritative no-link decision. */
@@ -1401,11 +1415,13 @@ export type PickOfTheDayArchiveEntry = {
     pick_date: string;
     /** Stable 1-based slot within the product day's ranked picks. */
     pick_rank?: number;
+    /** 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. */
+    published_at?: string;
     /** Human-readable matchup (e.g. "Portugal vs. Uzbekistan"). */
     matchup: string;
     /** Frozen canonical calibration/report bucket (e.g. "Basketball", "MMA", or "Soccer"). Existing semantics are unchanged; presentation consumers should prefer display_category when present. */
     category: string;
-    /** 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. */
+    /** 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. */
     display_category?: string;
     /** 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. */
     image_url?: string;
@@ -1417,6 +1433,8 @@ export type PickOfTheDayArchiveEntry = {
     outcome: "pending" | "win" | "loss" | "void";
     /** 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. */
     outcome_display?: string;
+    /** 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. */
+    resolved_at?: string;
     /** 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. */
     stake_usd?: number;
     /** 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. */
@@ -1464,8 +1482,8 @@ export type PickOfTheDayCommitmentPayload = {
     pick_outcome_label: string;
     /** 1-based daily slot. */
     pick_rank: number;
-    /** Provider platform. */
-    platform: string;
+    /** Provider platform. Always polymarket. */
+    platform: "polymarket";
 };
 export type PickOfTheDayHitRate = {
     /** Number of decided picks that won. */
@@ -1642,8 +1660,8 @@ export type PickOfTheDayUncommittedPayload = {
     pick_outcome_label: string;
     /** 1-based daily slot. */
     pick_rank: number;
-    /** Provider platform. */
-    platform: string;
+    /** Provider platform. Always polymarket. */
+    platform: "polymarket";
 };
 /** 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. */
 export type PickSportsContext = {
@@ -1678,6 +1696,8 @@ export type PickSportsTeam = {
     provider_id: number | null;
     /** Team crest or flag URL. Provider-owned for most teams (Polymarket /teams crest for clubs, country flag for national teams and tennis players). A club with a vendored crest carries it instead, served same-origin as a relative path (`/api/sports/team-logos/{league}/{abbr}.svg?v=<content hash>` or `.png`, resolve it against this server): every NFL and WNBA team, whose provider asset is a text tile, and the soccer clubs whose provider asset is an empty object. */
     logo: string | null;
+    /** True when the team mark is dark enough to disappear on a dark background, measured from the artwork by the teams sync. Render a dark mark on a light plate. Always sent; false until the artwork has been measured. */
+    logo_mark_dark: boolean;
     /** Team brand color as a hex string (provider-owned). */
     color: string | null;
     /** Win-loss record as a display string (e.g. "12-4"). */
@@ -1711,7 +1731,8 @@ export type PlatformCapabilities = {
     insider_radar: PlatformCapabilityStatus;
     market_snapshot: PlatformCapabilityStatus;
 };
-export type PlatformCapabilityStatus = "supported" | "partial" | "unsupported";
+/** 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. */
+export type PlatformCapabilityStatus = "supported";
 export type Platforms = {
     platforms: {
         polymarket: PlatformCapabilities;
@@ -2076,8 +2097,8 @@ export type ReportPayload = {
         trade_time: string | null;
         /** Provider market category. */
         market_category: string | null;
-        /** Venue: polymarket. */
-        platform: string | null;
+        /** Always polymarket, or null when the row carries no stored value. */
+        platform: "polymarket" | null;
         /** Trader display name, when known. */
         name: string | null;
         /** Trader pseudonym, when no display name is known. */
@@ -2104,8 +2125,8 @@ export type ReportPayload = {
         trade_time: string | null;
         /** Provider market category. */
         market_category: string | null;
-        /** Venue: polymarket. */
-        platform: string | null;
+        /** Always polymarket, or null when the row carries no stored value. */
+        platform: "polymarket" | null;
         /** Trader display name, when known. */
         name: string | null;
         /** Trader pseudonym, when no display name is known. */
@@ -2200,7 +2221,8 @@ export type SmartMoneyFlowMarket = {
         title: string | null;
         slug: string | null;
         category: string | null;
-        platform: string | null;
+        /** Provider platform. Always polymarket, or null when the row carries no stored value. */
+        platform: "polymarket" | null;
     };
     /** Sharp-money flow aggregate for the market (canonical; smart_money is a deprecated byte-identical alias). */
     sharp_money: {
@@ -2344,7 +2366,7 @@ export type Trader = {
         sharpe_7d: number | null;
         /** Gross profit divided by gross loss; greater than 1 is profitable. Capped at 1000 when there are effectively no losses. null when insufficient history. */
         profit_factor: number | null;
-        /** Stability of the trader's edge over time, 0-1 (higher is more consistent). null when insufficient history. */
+        /** Share of the trader's last 30 days with realized P&L that closed positive, 0-1 (higher is more consistent). A day with no realized P&L is not one of them, so the window can span months. null below 10 such days; null never means 0. */
         edge_consistency: number | null;
         /** Cross-sectional percentile rank of the trader's Sharpe ratio versus all traders, 0-100. null when insufficient history. */
         sharpe_percentile: number | null;
@@ -2751,7 +2773,7 @@ export type TrendingWallet = {
     profile_image_url?: string;
     /** Real provider platform; surfaced, never coerced. Polymarket only. */
     platform: "polymarket";
-    /** 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. */
+    /** 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. */
     trending_pnl_usd: number;
     /** 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. */
     window_volume_usd?: number;
@@ -3255,11 +3277,11 @@ export interface OperationQuery {
         status?: "active" | "closed" | "all";
         /** Filter by source platform. Explore is Polymarket-only; polymarket is the only supported value and the parameter is accepted for backward-compatibility but does not change the result set. */
         platform?: "polymarket";
-        /** Sort order for the discovery feed. */
-        sort?: "trending" | "hot" | "expiring" | "whales" | "volume" | "newest";
+        /** Sort order for the discovery feed. `large_trades` ranks by large-trade activity; `whales` is its deprecated spelling and selects the same order. */
+        sort?: "trending" | "hot" | "expiring" | "large_trades" | "whales" | "volume" | "newest";
         /** Opaque pagination cursor from the previous response. */
         cursor?: string;
-        /** Page size. */
+        /** Page size. Out-of-range values are clamped to 1..48. */
         limit?: number;
         /** Keyword search against market titles. At most 64 characters before whitespace trimming. */
         q?: string;
@@ -3268,13 +3290,13 @@ export interface OperationQuery {
     getApiDiscovery: Record<string, never>;
     getCoverage: Record<string, never>;
     getDailyReportSnapshot: {
-        /** UTC report date in YYYY-MM-DD format. */
+        /** UTC report date in YYYY-MM-DD format, from 2024-03-01 (the first day report data covers) through tomorrow UTC. Any other date returns 400 bad_request with error.param=date. */
         date: string;
     };
     getEventReplaySince: {
         /** Opaque event replay cursor returned as next_cursor by a prior response. The cursor maps to the global (whale_alerts.inserted_xid, whale_alerts.id) commit-order position, is valid across backend replicas, and is bound to the filter set the walk ran with (trader, condition_id, min_grade, min_size): presenting it under different filters answers 400 bad_request with error.reason cursor_expired, and the walk restarts without a cursor. Cursors issued before 2026-09-22 (id-only) stay accepted and are bound to no filters. Omit to fetch the latest durable public suffix. */
         cursor?: string;
-        /** Maximum durable public whale-trade events to return. */
+        /** Maximum durable public whale-trade events to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Only this wallet's trades: a wallet address, trd_-prefixed trader id or username resolved against the traders table. Bound to the cursor: a cursor issued under other filters answers 400 with error.reason cursor_expired. An unknown trader matches nothing and the walk still advances. */
         trader?: string;
@@ -3284,6 +3306,8 @@ export interface OperationQuery {
         min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
         /** Only trades of at least this size in USD (compared in cents). Bound to the cursor. */
         min_size?: number;
+        /** Backward-compatible alias for expand. Repeatable: trade. */
+        "expand[]"?: "trade"[];
         /** Repeatable. trade adds the public trade read to every event (the object GET /api/v1/whale-trades/{id} returns for it), from one query per page, so a page of 100 events needs no per-event detail request. Not bound to the cursor: switch it on or off mid-walk. */
         expand?: "trade"[];
     };
@@ -3309,7 +3333,7 @@ export interface OperationQuery {
         outcome?: "yes" | "no" | "all";
         /** Narrow within the graded cohort: `S` keeps S, `A` keeps S and A, `B` (default) keeps S, A and B. `C`, `D` and `F` are rejected with 400: the route lists the S/A/B cohort only. The cohort is the wallet's current grade (`traders.latest_grade`), so no value here reaches a C, D, F or ungraded holder; those are counted only in `scan.wallet_count`. `min_grade=D` on GET /api/v1/positions does return C and D, which is one of the three reasons the two routes' counts differ for the same market. */
         min_grade?: "S" | "A" | "B";
-        /** Maximum holders per page. */
+        /** Maximum holders per page. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Opaque pagination cursor from the previous response's next_cursor. It encodes a page of one shared roster, so it stays valid across the roster's refresh, but a page read after a refresh can repeat or skip a holder. */
         cursor?: string;
@@ -3325,7 +3349,7 @@ export interface OperationQuery {
         expand?: "trust"[];
     };
     getMonthlyReportSnapshot: {
-        /** UTC report month in YYYY-MM format. */
+        /** UTC report month in YYYY-MM format. A month that ends before 2024-03-01, the first day report data covers, or starts after tomorrow UTC returns 400 bad_request with error.param=month. */
         month: string;
     };
     getPickOfTheDay: Record<string, never>;
@@ -3335,7 +3359,7 @@ export interface OperationQuery {
     getPositionTimeline: {
         /** Market condition_id. One timeline per (trader, market). */
         condition_id: string;
-        /** Maximum number of timeline events to return. */
+        /** Maximum number of timeline events to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response's next_cursor. */
         cursor?: string;
@@ -3343,7 +3367,7 @@ export interface OperationQuery {
     getPositionTimelineById: {
         /** Market condition_id. One timeline per (trader, market). */
         condition_id: string;
-        /** Maximum number of timeline events to return. */
+        /** Maximum number of timeline events to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response's next_cursor. */
         cursor?: string;
@@ -3351,7 +3375,7 @@ export interface OperationQuery {
     getReports: {
         /** Report granularity selector. */
         granularity: "daily" | "weekly" | "monthly";
-        /** Period token for the granularity. daily: UTC date YYYY-MM-DD. weekly: ISO week YYYY-WW for a durable canonical snapshot, or a from,to YYYY-MM-DD pair for an exact ephemeral range limited to 31 inclusive UTC days. A wider explicit range returns 400 invalid_query. monthly: UTC month YYYY-MM. */
+        /** Period token for the granularity. daily: UTC date YYYY-MM-DD. weekly: ISO week YYYY-WW for a durable canonical snapshot, or a from,to YYYY-MM-DD pair for an exact ephemeral range limited to 31 inclusive UTC days. A wider explicit range returns 400 invalid_query. monthly: UTC month YYYY-MM. A period that ends before 2024-03-01, the first day report data covers, or starts after tomorrow UTC returns 400 bad_request with error.param=period. */
         period: string;
     };
     getStream: {
@@ -3407,11 +3431,11 @@ export interface OperationQuery {
     getUsage: Record<string, never>;
     getWebhook: Record<string, never>;
     getWeeklyReportSnapshot: {
-        /** UTC source-range start in YYYY-MM-DD format; required with to. Together with to, selects an exact ephemeral range of at most 31 inclusive UTC days. */
+        /** UTC source-range start in YYYY-MM-DD format; required with to. Together with to, selects an exact ephemeral range of at most 31 inclusive UTC days. A start after tomorrow UTC returns 400 bad_request with error.param=from. */
         from?: string;
-        /** UTC source-range end in YYYY-MM-DD format; required with from. Together with from, selects an exact ephemeral range of at most 31 inclusive UTC days. */
+        /** UTC source-range end in YYYY-MM-DD format; required with from. Together with from, selects an exact ephemeral range of at most 31 inclusive UTC days. An end before 2024-03-01, the first day report data covers, returns 400 bad_request with error.param=to. */
         to?: string;
-        /** ISO week selector in YYYY-WW format; alternative to from/to. Selects a durable canonical snapshot. */
+        /** ISO week selector in YYYY-WW format; alternative to from/to. Selects a durable canonical snapshot. A week that ends before 2024-03-01, the first day report data covers, or starts after tomorrow UTC returns 400 bad_request with error.param=week. */
         week?: string;
     };
     getWhaleTrade: Record<string, never>;
@@ -3426,13 +3450,13 @@ export interface OperationQuery {
         starts_after?: string;
         /** RFC 3339 instant. Keep only games whose kickoff is at or before it. Must be at or after starts_after. */
         starts_before?: string;
-        /** Page size. */
+        /** Page size. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Opaque gms_v1_ cursor from next_cursor. It pins the page position (kickoff and event_slug), not a snapshot: the catalog is live, so a game added or removed between pages moves with it. A cursor this endpoint did not issue returns 400 with error.param=cursor. */
         cursor?: string;
     };
     listInsiderRadar: {
-        /** Maximum number of radar flags to return. */
+        /** Maximum number of radar flags to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response. */
         cursor?: string;
@@ -3444,7 +3468,7 @@ export interface OperationQuery {
         mode?: "live" | "stable";
     };
     listLargePositions: {
-        /** Maximum number of large positions to return. */
+        /** Maximum number of large positions to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Opaque pagination cursor from a previous response. */
         cursor?: string;
@@ -3454,7 +3478,7 @@ export interface OperationQuery {
         category?: string;
         /** Minimum trader grade. */
         min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
-        /** 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 []. */
+        /** 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 []. */
         condition_id?: string;
     };
     listLargeTradeCounterpartyExecutions: {
@@ -3462,7 +3486,7 @@ export interface OperationQuery {
         snapshot_id: string;
         /** Opaque cursor from the previous response's next_cursor. */
         cursor?: string;
-        /** Maximum number of counterparty execution rows to return. */
+        /** Maximum number of counterparty execution rows to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
     };
     listLargeTradeCounterpartyMakers: {
@@ -3470,11 +3494,11 @@ export interface OperationQuery {
         snapshot_id: string;
         /** Opaque cursor from the previous response's next_cursor. */
         cursor?: string;
-        /** Maximum number of maker rows to return. */
+        /** Maximum number of maker rows to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
     };
     listLargeTradeHistory: {
-        /** Maximum number of historical large trades to return. */
+        /** Maximum number of historical large trades to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response's next_cursor. Prefix: wth_. URL-encode when replaying as a query parameter. */
         cursor?: string;
@@ -3502,7 +3526,7 @@ export interface OperationQuery {
         sort?: "recent" | "market_volume_share";
     };
     listLargeTrades: {
-        /** Maximum number of recent large trades to return. */
+        /** Maximum number of recent large trades to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response's next_cursor. */
         cursor?: string;
@@ -3520,7 +3544,7 @@ export interface OperationQuery {
         sort?: "recent" | "market_volume_share";
     };
     listLeaderboard: {
-        /** Maximum number of ranked traders to return. */
+        /** Maximum number of ranked traders to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Opaque lbv1_ pagination cursor from a prior response. It binds the finite score/address boundary to the committed leaderboard generation and the effective category/strategy filters; legacy, malformed, non-finite, and unsupported-version cursors are rejected. */
         cursor?: string;
@@ -3530,7 +3554,7 @@ export interface OperationQuery {
         strategy?: "accumulator" | "algo_trader" | "arbitrageur" | "directional" | "event_driven" | "market_maker" | "momentum" | "scalper" | "speculator" | "swing_trader";
     };
     listPositions: {
-        /** Maximum number of current positions to return. */
+        /** Maximum number of current positions to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response's next_cursor. */
         cursor?: string;
@@ -3556,7 +3580,7 @@ export interface OperationQuery {
         cohort: "wider_holder" | "in_play" | "emerging_pile";
         /** Optional canonical sport bucket. Omitted or blank selects all registered sports. Raw provider categories resolve through the canonical taxonomy, including table-tennis or table tennis to Table Tennis and pickleball to Pickleball; a non-sport category returns an empty list. */
         category?: string;
-        /** Page size. */
+        /** Page size. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Server-authenticated opaque seo_v2_ cursor from next_cursor. Pins snapshot_as_of, cohort, rank, and condition_id; pre-deploy unsigned seo_ cursors are rejected, so clients must request the first page after this contract ships; emerging_pile cursors also pin the first-page projection_now cutoff so kickoff filtering cannot renumber continuation pages. Client edits fail closed; it cannot cross cohorts; a refreshed snapshot invalidates it with 400. */
         cursor?: string;
@@ -3564,7 +3588,7 @@ export interface OperationQuery {
     listPreGameSides: {
         /** Optional canonical sport bucket filter (e.g. Basketball, Tennis, Soccer). A raw provider value (NBA) resolves to its canonical bucket. A non-sport category returns an empty list. */
         category?: string;
-        /** Page size. */
+        /** Page size. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Opaque cursor from a previous response's next_cursor. Encodes the snapshot anchor plus the last row's directional_rank_score, conviction_score, smart_score and condition_id. A cursor from an expired snapshot returns 400. */
         cursor?: string;
@@ -3576,7 +3600,7 @@ export interface OperationQuery {
     listSharpMoneyFlows: {
         /** Lookback window for grade-filtered whale flow aggregation. */
         timeframe?: "1h" | "4h" | "24h" | "7d";
-        /** Page size. */
+        /** Page size. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Opaque cursor from previous response's next_cursor. Encodes the first-page as_of timestamp, normalized effective filters, ranking and aggregate collection revisions, plus the last row's absolute net flow and condition_id. A changed filter or collection returns cursor_expired; request the first page again. */
         cursor?: string;
@@ -3592,7 +3616,7 @@ export interface OperationQuery {
     listSmartMoneyFlows: {
         /** Lookback window for grade-filtered whale flow aggregation. */
         timeframe?: "1h" | "4h" | "24h" | "7d";
-        /** Page size. */
+        /** Page size. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Opaque cursor from previous response's next_cursor. Encodes the first-page as_of timestamp, normalized effective filters, ranking and aggregate collection revisions, plus the last row's absolute net flow and condition_id. A changed filter or collection returns cursor_expired; request the first page again. */
         cursor?: string;
@@ -3610,7 +3634,7 @@ export interface OperationQuery {
         cohort: "wider_holder" | "in_play" | "emerging_pile";
         /** Optional canonical sport bucket. Omitted or blank selects all registered sports. Raw provider categories resolve through the canonical taxonomy, including table-tennis or table tennis to Table Tennis and pickleball to Pickleball; a non-sport category returns an empty list. */
         category?: string;
-        /** Page size. */
+        /** Page size. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Server-authenticated opaque seo_v2_ cursor from next_cursor. Pins snapshot_as_of, cohort, rank, and condition_id; pre-deploy unsigned seo_ cursors are rejected, so clients must request the first page after this contract ships; emerging_pile cursors also pin the first-page projection_now cutoff so kickoff filtering cannot renumber continuation pages. Client edits fail closed; it cannot cross cohorts; a refreshed snapshot invalidates it with 400. */
         cursor?: string;
@@ -3618,7 +3642,7 @@ export interface OperationQuery {
     listSportsEdgeSignals: {
         /** Optional canonical sport bucket filter (e.g. Basketball, Tennis, Soccer). A raw provider value (NBA) resolves to its canonical bucket. A non-sport category returns an empty list. */
         category?: string;
-        /** Page size. */
+        /** Page size. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Opaque cursor from a previous response's next_cursor. Encodes the snapshot anchor plus the last row's directional_rank_score, conviction_score, smart_score and condition_id. A cursor from an expired snapshot returns 400. */
         cursor?: string;
@@ -3628,7 +3652,7 @@ export interface OperationQuery {
         min_grade?: "S" | "A" | "B";
     };
     listSuspiciousTrades: {
-        /** Maximum number of suspicious trades to return. */
+        /** Maximum number of suspicious trades to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response. */
         cursor?: string;
@@ -3640,7 +3664,7 @@ export interface OperationQuery {
         mode?: "live" | "stable";
     };
     listTrendingWallets: {
-        /** Polymarket's weekly leaderboard caps the ranked set at 50 wallets; requests above 50 still return at most 50. */
+        /** Polymarket's weekly leaderboard caps the ranked set at 50 wallets; requests above 50 still return at most 50. Out-of-range values are clamped to 1..50. */
         limit?: number;
         /** Opaque pagination cursor from a previous response, bound to its effective limit, window and ranked-board generation. A changed board or request scope returns error.reason=cursor_expired; legacy page-only cursors must restart from page one. */
         cursor?: string;
@@ -3660,7 +3684,7 @@ export interface OperationQuery {
         snapshot_id: string;
         /** Opaque cursor from the previous response's next_cursor. */
         cursor?: string;
-        /** Maximum number of counterparty execution rows to return. */
+        /** Maximum number of counterparty execution rows to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
     };
     listWhaleTradeCounterpartyMakers: {
@@ -3668,11 +3692,11 @@ export interface OperationQuery {
         snapshot_id: string;
         /** Opaque cursor from the previous response's next_cursor. */
         cursor?: string;
-        /** Maximum number of maker rows to return. */
+        /** Maximum number of maker rows to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
     };
     listWhaleTradeHistory: {
-        /** Maximum number of historical large trades to return. */
+        /** Maximum number of historical large trades to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response's next_cursor. Prefix: wth_. URL-encode when replaying as a query parameter. */
         cursor?: string;
@@ -3700,7 +3724,7 @@ export interface OperationQuery {
         sort?: "recent" | "market_volume_share";
     };
     listWhaleTrades: {
-        /** Maximum number of recent large trades to return. */
+        /** Maximum number of recent large trades to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response's next_cursor. */
         cursor?: string;
@@ -3725,13 +3749,13 @@ export interface OperationQuery {
     searchContent: {
         /** Search query. Must be 1-256 characters before whitespace trimming and non-empty after trimming. */
         q: string;
-        /** Maximum content items to return. */
+        /** Maximum content items to return. Out-of-range values are clamped to 1..50. */
         limit?: number;
     };
     searchMarkets: {
         /** Search query. Must be 1-512 characters before whitespace trimming and non-empty after trimming. */
         q: string;
-        /** Maximum number of matching markets to return. */
+        /** Maximum number of matching markets to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response's next_cursor. */
         cursor?: string;
@@ -4389,7 +4413,8 @@ export interface OperationResponse {
         object: "list";
         data: OperationData["listPreGameSideObservations"];
         has_more: boolean;
-        next_cursor?: string;
+        /** Pass as cursor for the next page. Always sent; null on the last page. */
+        next_cursor: string | null;
         /** Completion time of the shared observation snapshot pinned by the cursor. */
         snapshot_as_of: string;
         /** True when an operational failure or unknown provider-board, holder, directional, reconciliation, or internal completeness state made this snapshot partial. This is snapshot-wide and can retain degradation that the funnel's one-terminal-per-input accounting cannot represent. Intentional bounded capacity_limited rows remain fully accounted in the funnel and do not by themselves set this field. */
@@ -4425,7 +4450,8 @@ export interface OperationResponse {
         object: "list";
         data: OperationData["listSportsEdgeObservations"];
         has_more: boolean;
-        next_cursor?: string;
+        /** Pass as cursor for the next page. Always sent; null on the last page. */
+        next_cursor: string | null;
         /** Completion time of the shared observation snapshot pinned by the cursor. */
         snapshot_as_of: string;
         /** True when an operational failure or unknown provider-board, holder, directional, reconciliation, or internal completeness state made this snapshot partial. This is snapshot-wide and can retain degradation that the funnel's one-terminal-per-input accounting cannot represent. Intentional bounded capacity_limited rows remain fully accounted in the funnel and do not by themselves set this field. */