@0xinsider/mcp 3.7.0 → 3.9.0

package/dist/sdk/schema.d.ts

@@ -94,6 +94,14 @@ export type ApiErrorBody = {
     /** ADDITIVE (#7209). The specific, actionable cause behind `code`, when there is one more specific than the code itself. `code` keeps its published values, so existing clients are unaffected; new clients branch on `reason`. Omitted when the code already says everything we know. pick_not_released: no Pick of the Day is published for the current product day; schedule one request against retry_at instead of polling. unknown_endpoint: the PATH is not a route on this API -- read GET /api/v1, do not retry. trader_not_tracked: the wallet is real and the URL is right, but the trader is not on the warm sync tier (the wallets we sync most often) -- stop asking for this wallet. market_out_of_scope (404 not_found, #27303): the market or event is real and the URL is right, but 0xinsider serves sports and esports markets only -- stop asking for this market; neither a retry nor another URL for it can succeed. cursor_expired: pagination went stale mid-walk -- re-request the first page and continue. read_model_warming: the requested endpoint cannot serve its read model yet; exact causes are endpoint-specific and can include a cold or contended refresh or a dependency that prevented refresh. database_unavailable: the API's database or its connection pool is temporarily unreachable (a connection-class failure, not a query fault); code stays rate_limit_unavailable, nothing is rate-limited, retry after Retry-After / retry_at. idempotency_in_progress: retain the exact Idempotency-Key and request body, then retry shortly. webhook_delivery_in_progress: retry the URL or signing-secret configuration change after the destination's active request completes. request_accounting_unavailable: accounting capacity is unavailable before the handler executes; retry after Retry-After / retry_at. sandbox_api_key: the credential is a sandbox key (oxi_sk_test_) from POST /api/v1/agents/register, which only the sandbox server accepts -- call the sandbox base URL with it, or get a live key or OAuth access token; do not retry it here. api_key_in_query: the key was sent as a ?token= query parameter, which no route reads because URLs land in logs and history; the key itself was not checked -- resend it as Authorization: Bearer. subscription_inactive: the key is valid but the account's Pro subscription has lapsed (402 subscription_required); permanent until a person reactivates at https://0xinsider.com/billing, which the message names -- stop retrying on a schedule and surface the link. The key owner is emailed once per lapse. monthly_quota_exceeded: the account has used the requests its plan includes for the UTC calendar month (429 rate_limited); retry_at and Retry-After name the first of next month, the only retry that can succeed, and the message names https://0xinsider.com/developers, where pay as you go for requests over the quota is turned on. The X-Monthly-Quota-Limit, X-Monthly-Quota-Remaining and X-Monthly-Quota-Reset headers on every authenticated response say how close the account is. invalid_query, invalid_path, invalid_body (400 bad_request, #16146): a query parameter, a path segment or the JSON body did not parse or does not fit the route's schema, so no handler ran; param names the field when the parser named one (a query key, a path segment, a JSON path such as traders[0], or body); fix the request, never retry it as sent. unsupported_media_type (415 bad_request, param content-type): send the body with Content-Type: application/json. payload_too_large (413 bad_request, param body): the body is over 1048576 bytes. method_not_allowed (405 bad_request): the path is a route but not with this method; the Allow header names the methods it serves. ip_rate_limited (429 rate_limited, #16380): the per-address budget every caller behind one IP shares, counted before authentication, is spent; not the key's own window, and the RateLimit-* headers describe that bucket. ip_throttled (429 rate_limited): the address is in a cooldown after sustained over-limit traffic; Retry-After is minutes to days, and a request before it does not shorten the cooldown. cold_read_limited (429 rate_limited, #28752): the account has used its share of cold reads on GET /api/v1/market/{condition_id}/holders, requests for a market whose roster is not cached, each of which walks Polymarket (6 a minute, in bursts of up to 400); not the per-minute window, so a cached market still answers, and the next cold read is admitted at Retry-After. max_plan_required (403 forbidden, #23085): the key is valid and its account is on Pro, but the route is part of Max (GET /api/v1/edge-hunter); every Pro route keeps working with the same key, so do not disable it. The message names https://0xinsider.com/pricing, where the account upgrades; a retry never clears it. endpoint_retired (410): this legacy sports endpoint no longer serves data. Migrate to GET /api/v1/edge-hunter; retrying the retired path cannot succeed. */
     reason?: "cursor_expired" | "unknown_endpoint" | "pick_not_released" | "trader_not_tracked" | "market_out_of_scope" | "read_model_warming" | "database_unavailable" | "request_accounting_unavailable" | "idempotency_in_progress" | "webhook_delivery_in_progress" | "webhook_secret_rotation_not_prepared" | "webhook_secret_rotation_overlap_active" | "sandbox_api_key" | "api_key_in_query" | "subscription_inactive" | "monthly_quota_exceeded" | "invalid_query" | "unknown_query_parameter" | "invalid_path" | "invalid_body" | "unsupported_media_type" | "payload_too_large" | "method_not_allowed" | "ip_rate_limited" | "ip_throttled" | "cold_read_limited" | "export_expired" | "freshness_ceiling_unsatisfied" | "max_plan_required" | "endpoint_retired";
 };
+export type BatchGameHoldersItem = {
+    /** Zero-based request index. Duplicate inputs keep separate result rows. */
+    index: number;
+    input: string;
+    status: "ok" | "error";
+    data?: GameHoldersItem;
+    error?: ApiErrorBody;
+};
 export type BatchMarketFlowItem = {
     /** Zero-based request index. Duplicate inputs keep separate result rows. */
     index: number;
@@ -142,6 +150,22 @@ export type Candle = {
     /** Close price in provider [0, 1] units (last observed point in the bucket). */
     c: number;
 };
+export type CategoryLeader = {
+    address: string;
+    as_of: string;
+    category: string;
+    edge_lower_bound: number | null;
+    grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+    id: string;
+    independent_events: number;
+    n_resolved: number | null;
+    platform: "polymarket";
+    pnl: number | null;
+    rank: number;
+    unresolved_events: number;
+    username: string | null;
+    win_rate: number | null;
+};
 /** Model-wide readiness, read in the same database snapshot as category_records. Individual category rows retain their own status. */
 export type CategorySkillModelReadiness = {
     status: "live" | "insufficient" | "stale" | "unknown" | "degraded";
@@ -883,10 +907,10 @@ export type EdgeHunterSportFunnelReport = {
     board_upcoming_configured: boolean;
     /** Whether every configured upcoming-board scope completed as available. False with board_upcoming_configured=false means not applicable. When board_upcoming_configured is true and this flag is false, read board_upcoming_status for the cause (unknown means no cause was recorded, which no computed snapshot reports): the board_source_unavailable and board_deadline_unavailable terminals are assigned only to already-started rows (the live half) and are structurally 0 for the upcoming source, so they never explain this flag. */
     board_upcoming_available: boolean;
-    /** Why the upcoming-board source is (un)available. Board supply is one canonical-sport union: the bare category owns live truth and every configured composed league scope contributes upcoming rows; folded leagues without a configured board (currently NCAAB and CFL) are not in the upcoming union. available: every configured scope completed truthfully (a successful empty schedule still counts). capacity_limited: provider pagination or a configured upcoming cache published an intentionally bounded complete-event prefix; those rows are excluded from diagnostic-universe input and must not be treated as a complete upcoming universe. Cache-bound prefixes are limited to an exact 5,000,000-byte final envelope. source_unavailable: composition failed before a truthful union; resolved scope readers turn half failures into cold_unavailable, so fresh producers are whole-union identity reconciliation or a registry contract failure and carry zero rows. cold_unavailable: every scope completed but at least one reported its upcoming half unavailable because no servable entry was inside the stale-serve bound and the background warm did not land in time; it is not by itself proof of a provider outage. deadline_unavailable: an internal configured-scope deadline or the outer bounded fair wave expired. An internal deadline may retain healthy bare-category or sibling-scope rows; the outer wave records zero rows. These upcoming fields do not describe league live-membership availability. If the bare-category live scope fails, all live rows are dropped even when a league scope completed, because the bare category is the sole live-truth owner. not_configured: no upcoming scope applies to the sport. unknown: no cause was recorded; every computed snapshot reports a concrete status, so none reads unknown. board_upcoming_available is exactly board_upcoming_status == available. */
+    /** Why the upcoming-board source is (un)available. Board supply is one canonical-sport union: the bare category owns live truth and every configured composed league scope contributes upcoming rows; folded leagues without a configured board (currently CFL) are not in the upcoming union. available: every configured scope completed truthfully (a successful empty schedule still counts). capacity_limited: provider pagination or a configured upcoming cache published an intentionally bounded complete-event prefix; those rows are excluded from diagnostic-universe input and must not be treated as a complete upcoming universe. Cache-bound prefixes are limited to an exact 5,000,000-byte final envelope. source_unavailable: composition failed before a truthful union; resolved scope readers turn half failures into cold_unavailable, so fresh producers are whole-union identity reconciliation or a registry contract failure and carry zero rows. cold_unavailable: every scope completed but at least one reported its upcoming half unavailable because no servable entry was inside the stale-serve bound and the background warm did not land in time; it is not by itself proof of a provider outage. deadline_unavailable: an internal configured-scope deadline or the outer bounded fair wave expired. An internal deadline may retain healthy bare-category or sibling-scope rows; the outer wave records zero rows. These upcoming fields do not describe league live-membership availability. If the bare-category live scope fails, all live rows are dropped even when a league scope completed, because the bare category is the sole live-truth owner. not_configured: no upcoming scope applies to the sport. unknown: no cause was recorded; every computed snapshot reports a concrete status, so none reads unknown. board_upcoming_available is exactly board_upcoming_status == available. */
     board_upcoming_status: "unknown" | "not_configured" | "available" | "capacity_limited" | "source_unavailable" | "cold_unavailable" | "deadline_unavailable";
-    /** Configured upcoming scopes that did not complete as available. Values are category, a provider league tag slug (nfl, cfb, nba, wnba, euroleague-basketball, nhl, mls, valorant, league-of-legends, counter-strike-2, or dota-2), registry when the compiled scope/projection contract drifted, union when cross-scope identity reconciliation failed, or wave when the outer fair-wave deadline expired before scope-level evidence returned. Empty means no unavailable upcoming scope was identified; this includes healthy/not-configured rows and a legacy cached row. Observation league scopes are upcoming-only and perform no live-membership read. */
-    board_upcoming_unavailable_scopes: ("category" | "nfl" | "cfb" | "nba" | "wnba" | "euroleague-basketball" | "nhl" | "mls" | "valorant" | "league-of-legends" | "counter-strike-2" | "dota-2" | "registry" | "union" | "wave")[];
+    /** Configured upcoming scopes that did not complete as available. Values are category, a provider league tag slug (nfl, cfb, nba, wnba, euroleague-basketball, ncaa-basketball, cwbb, nhl, mls, valorant, league-of-legends, counter-strike-2, or dota-2), registry when the compiled scope/projection contract drifted, union when cross-scope identity reconciliation failed, or wave when the outer fair-wave deadline expired before scope-level evidence returned. Empty means no unavailable upcoming scope was identified; this includes healthy/not-configured rows and a legacy cached row. Observation league scopes are upcoming-only and perform no live-membership read. */
+    board_upcoming_unavailable_scopes: ("category" | "nfl" | "cfb" | "nba" | "wnba" | "euroleague-basketball" | "ncaa-basketball" | "cwbb" | "nhl" | "mls" | "valorant" | "league-of-legends" | "counter-strike-2" | "dota-2" | "registry" | "union" | "wave")[];
     /** Stored-universe rows plus provider-board rows missing from storage. */
     input: number;
     /** Sparse counts over the closed 25-value terminal vocabulary: outside_horizon, resolved, provider_closed, provider_excluded, invalid_market, missing_token, missing_stored_market, not_provider_live, board_source_unavailable, board_deadline_unavailable, primary_slate_candidate, zero_indexed_holder_research, capacity_limited, provider_unavailable, holder_deadline_unavailable, holder_computation_unavailable, holder_scan_incomplete, no_current_graded_holder, split_holder_pile, price_unavailable, wider_holder_emitted, in_play_emitted, in_play_stale_observed, in_play_directional_unavailable, or internal_unclassified. primary_slate_candidate means the view=signals snapshot named by signals_as_of lists the market at its widest selection (horizon_hours=48, min_grade=B, no selector), so it is not a wider_holder candidate; when no view=signals snapshot could be read (signals_as_of null), no market takes it. capacity_limited is intentional bounded provider-work admission, is fully accounted here, and does not itself set degraded=true. board_source_unavailable means a completed board source was unavailable; board_deadline_unavailable means live-board work missed either an internal configured-scope deadline or the outer fair-wave deadline; provider_unavailable means a holder read sent to the provider failed and the market had no reusable holder page; holder_deadline_unavailable means holder cache/provider work missed the absolute request deadline, or local capacity never sent the holder read, and the market had no reusable holder page; holder_computation_unavailable means post-holder provider or DB-backed price/metadata evaluation was unavailable. */
@@ -1212,7 +1236,7 @@ export type FreshnessFailure = {
     /** The trader body's whole-response data-quality status. Only fresh can satisfy max_age_s. */
     data_quality_status: "fresh" | "partial" | "unknown" | "untracked" | "unavailable";
 };
-/** One sports or esports game: both sides, its schedule, provider status, linked Polymarket markets and their available provider moneyline price states. Assembled from the same provider-first live and upcoming projections the site's boards use, with no request-time provider fan-out. */
+/** One sports or esports game: both sides, its schedule, provider status, its winner markets (the moneyline, or the soccer 1X2 legs) with their available provider moneyline price states and liquidity, and the game's traded volume. The event's other markets are on GET /api/v1/games/{event_slug}/markets. Assembled from the same provider-first live and upcoming projections the site's boards use, with no request-time provider fan-out. */
 export type Game = {
     object: "game";
     /** The game's identity, for example mlb-mil-cin-2026-06-22. The same key the live_sports_updated webhook pulse carries and the same key /api/v1/games/{event_slug} takes. */
@@ -1234,12 +1258,15 @@ export type Game = {
     series_format?: string;
     /** Whether this read includes a market classified as paying on a draw, including soccer's independent 1X2 draw leg. Read this instead of assuming a two-outcome moneyline. */
     draw_offered: boolean;
-    /** Every market this read linked to the game, ordered by condition_id. */
+    /** The game's winner markets the sports board binds to its sides (the moneyline, or a soccer game's three 1X2 legs), ordered by condition_id. Spreads, totals, period lines and props are on GET /api/v1/games/{event_slug}/markets. */
     markets: GameMarket[];
     freshness: GameFreshness;
     coverage: GameCoverage;
     /** The game's page on 0xinsider. */
     url: string;
+    sharp_money?: GameSharpMoney;
+    /** The game's traded volume, the figure the sports board carries for it, with its source, basis, unit and observation clock. A client can rank or filter games by volume.value. Omitted when the board carries no volume for the game, and on a finished game read from its stored record (freshness.source stored); never 0 in place of a missing figure. */
+    volume?: GameVolume;
 };
 /** One side of the game. */
 export type GameCompetitor = {
@@ -1256,7 +1283,7 @@ export type GameCompetitor = {
 };
 /** What this game's read actually supplied, so a client branches on coverage instead of on a missing key. */
 export type GameCoverage = {
-    /** available when a live-score frame supplied this game's scores. */
+    /** available when a live-score frame supplied a score for this game. A game no live-score feed has reported yet, as most scheduled games are, reads unavailable. */
     scores: "available" | "unavailable";
     /** provider_ids when every side carries a provider id, labels when only the provider's names identify them, unavailable when neither exists. Do not join on names when this reads labels. */
     competitors: "provider_ids" | "labels" | "unavailable";
@@ -1265,15 +1292,15 @@ export type GameCoverage = {
 };
 /** How current this game's facts are. Independent per source: the board half that produced the game, and the live-score frame that produced its scores. */
 export type GameFreshness = {
-    /** Which board half produced this game. */
-    source: "live" | "upcoming";
+    /** What produced this game: live or upcoming, the board half that carried it, or stored, the stored record of a finished game that has left the board (GET /api/v1/games/{event_slug}, and GET /api/v1/games with a finished status). */
+    source: "live" | "upcoming" | "stored";
     /** Whether that half returned a truthful source body for this read. */
     source_status: "ok" | "unavailable";
     /** Whether that half had a source body at all. not_applicable means the sport has no configured source for that half. */
     source_availability: "available" | "unavailable" | "not_applicable";
-    /** Freshness of the cached source body, never inferred from the response clock or the row count. */
+    /** Freshness of the cached source body, never inferred from the response clock or the row count. not_applicable for a stored game, whose record is final. */
     source_freshness: "fresh" | "stale" | "unknown" | "not_applicable";
-    /** The source body's data vintage. Omitted when the read has no vintage anchor, which is not age zero. */
+    /** The source body's data vintage. Omitted when the read has no vintage anchor, which is not age zero. For a stored game, the later of its last live-score write and its last leg settlement. */
     source_observed_at?: string;
     /** Age of source_observed_at in seconds, capped at 600. Omitted past the cap or with no anchor. */
     source_age_seconds?: number;
@@ -1284,6 +1311,22 @@ export type GameFreshness = {
     /** The provider's own frame clock. Omitted when the frame carries none. */
     scores_source_at?: string;
 };
+/** One market of a game holders batch: GET /api/v1/market/{condition_id}/holders unfiltered and cut to the batch limit. */
+export type GameHoldersItem = {
+    /** The roster's top holders by current value, at most limit. */
+    data: MarketHolder[];
+    /** More graded holders than limit: page them on GET /api/v1/market/{condition_id}/holders. */
+    has_more: boolean;
+    /** Graded holders in the roster, across every page. */
+    total: number;
+    market: MarketHoldersMarket;
+    scan: MarketHoldersScan;
+    totals: MarketHoldersTotals;
+    /** When this roster was computed. A cached roster is at most 60 seconds old. */
+    computed_at: string;
+    /** true when the roster came from the 60-second roster cache. */
+    cached: boolean;
+};
 /** One Polymarket market linked to this game. */
 export type GameMarket = {
     /** The mkt_-prefixed market id every other V1 response uses. */
@@ -1306,6 +1349,17 @@ export type GameMarket = {
     outcome_token_ids?: string[];
     /** Default provider moneyline state. Omitted when this market has no classified moneyline projection; incomplete and invalid projections remain explicit. */
     prices?: GameMarketPrices;
+    /** Polymarket's reported liquidity for this market. Omitted when the provider read carried none, and on a finished game read from its stored record; never 0 in place of a missing figure. */
+    liquidity?: GameMarketLiquidity;
+};
+/** One market's liquidity as Polymarket reports it (Gamma liquidityNum), verbatim. Polymarket documents it only as reported market liquidity, with no unit. It describes the market's resting order book, not traded volume. */
+export type GameMarketLiquidity = {
+    /** The provider's figure at full precision. */
+    value: number;
+    /** Always gamma: the Polymarket Gamma API. */
+    source: "gamma";
+    /** When 0xinsider read the sports board body this figure came from, never a provider-authored timestamp. Omitted when that read has no clock. */
+    observed_at?: string;
 };
 /** How the existing sports-board writer bound prices to competitors. */
 export type GameMarketPriceBindingProvenance = "provider_ids" | "exact_labels" | "containment_labels" | "elimination";
@@ -1366,18 +1420,66 @@ export type GameMarketProviderPrices = GameMarketPricePaired | GameMarketPriceIn
 export type GamesCoverage = {
     /** Canonical sport buckets served, sorted. */
     sports: string[];
-    /** League tags served, sorted. EuroLeague is euroleague under the Basketball sport bucket. */
+    /** League tags served, sorted. EuroLeague is euroleague, NCAA men's college basketball cbb and NCAA women's college basketball cwbb, all under the Basketball sport bucket. */
     leagues: string[];
     /** Scopes whose source half was unavailable for this read, as <sport>:<half>. Empty means every scope answered. */
     sources_unavailable: string[];
 };
+/** Event-level sharp money for one game. Every aggregate field is null unless status is computed; null means unknown, never zero. */
+export type GameSharpMoney = {
+    allocation: "exact" | "degraded" | null;
+    computed_at: string | null;
+    event_slug: string;
+    holders_partial: boolean | null;
+    lifecycle: "live" | "settled" | "indeterminate" | null;
+    money_as_of: string | null;
+    object: string;
+    outcomes: ({
+        is_leader: boolean;
+        label: string;
+        pct: number;
+        side: "home" | "draw" | "away";
+        usd: number;
+        wallets: {
+            a: number;
+            b: number;
+            s: number;
+        };
+    })[];
+    status: "computed" | "not_computed" | "unavailable";
+    total_usd: number | null;
+    trader_count: number | null;
+    unallocated_usd: number | null;
+    verdict: {
+        kind: "no_sharp_money";
+    } | {
+        kind: "all_on";
+        label: string;
+    } | {
+        kind: "split";
+    } | {
+        kind: "leans";
+        label: string;
+        pct: number;
+    } | {
+        kind: "unavailable";
+    } | {
+        divergence_pts: number;
+        kind: "leans_over_price";
+        label: string;
+    } | {
+        kind: "no_clear_lean";
+    } | {
+        kind: "withheld";
+    } | null;
+};
 /** Where the game is in its own life, as the provider reports it. A postponement, a cancellation and a suspension each keep their own state, so a client can tell a game that will be played later from one that never will be. */
 export type GameStatus = {
-    /** scheduled: kickoff is ahead or the provider still calls it scheduled. live: the provider reports it in play. paused: halftime or a provider-reported break. ended: the provider reported a final, an award or a forfeit. postponed, cancelled, suspended, delayed: the provider's own verdict, kept distinct. A tennis match that the provider still lists in play, with no live score feed and no change of period or score for 3 hours, also reads suspended. unknown: no provider state reached this read. A kickoff in the past is never read as live on its own. */
+    /** scheduled: kickoff is ahead, or the provider still lists the game open and neither in play nor ended. With no live-score frame a game stays scheduled past its kickoff until the provider says otherwise. live: the provider reports it in play. paused: halftime or a provider-reported break. ended: the provider reported a final, an award or a forfeit. postponed, cancelled, suspended, delayed: the provider's own verdict, kept distinct. A tennis match that the provider still lists in play, with no live score feed and no change of period or score for 3 hours, also reads suspended. unknown: no provider state reached this read. A kickoff in the past is never read as live on its own. */
     state: "scheduled" | "live" | "paused" | "ended" | "postponed" | "cancelled" | "suspended" | "delayed" | "unknown";
-    /** The provider status folded onto one vocabulary across leagues. unknown means the provider sent a value this API has no meaning for; provider_status keeps that value verbatim. Omitted when no live-score frame carries a status. */
+    /** The provider status folded onto one vocabulary across leagues. unknown means the provider sent a value this API has no meaning for; provider_status keeps that value verbatim. Omitted when no live-score frame carries a status, as for a listed game no live-score feed has reported yet. */
     match_status?: "scheduled" | "in_progress" | "halftime" | "penalty_shootout" | "delayed" | "suspended" | "final" | "final_overtime" | "final_shootout" | "awarded" | "forfeit" | "not_necessary" | "postponed" | "cancelled" | "unknown";
-    /** The provider's status string, verbatim. Omitted when the provider sent none. */
+    /** The live-score feed's status string, verbatim. Omitted when no live-score frame carries one. This API never puts a label of its own here, such as Scheduled for a listed game. */
     provider_status?: string;
     /** The provider's period label, for example Q3, End Q2 or T5. Omitted when the provider sent none. */
     period?: string;
@@ -1388,6 +1490,62 @@ export type GameStatus = {
     /** Whether the game is over. Always present. */
     ended: boolean;
 };
+/** One fill in a game, as the game page's activity list shows it. */
+export type GameTrade = {
+    /** Stable fill identity: {transaction_hash}:{token_id}:{wallet}:{shares}. Deduplicate on it across polls. */
+    id: string;
+    /** When the fill happened, to the second. */
+    traded_at: string;
+    /** The provider's side of the fill. */
+    side: "BUY" | "SELL";
+    /** The traded outcome's label; null when the provider named none. */
+    outcome: string | null;
+    /** 0 for the first (Yes) outcome token, 1 for the second (No); null when the provider did not say. */
+    outcome_index: number | null;
+    /** Fill price, 0 to 1. */
+    price: number;
+    /** Shares filled. */
+    shares: number;
+    /** USDC notional of the fill. */
+    size_usd: number;
+    /** The signed handicap the fill's side carries on a spread line, for example -1.5 or 1.5; null off spreads. */
+    point: number | null;
+    trader: {
+        /** Lowercase proxy wallet. */
+        address: string;
+        /** The name the site shows: the 0xinsider username, else the provider's name or pseudonym, else the shortened address. */
+        display_name: string;
+        /** The trader's grade today; null for an ungraded or untracked wallet. */
+        grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+    };
+    market: {
+        /** The market's v1 id, mkt_ plus the condition_id. */
+        id: string;
+        /** The raw provider condition_id. */
+        condition_id: string;
+        /** The market's question. */
+        title: string | null;
+        /** The market's page slug. */
+        slug: string | null;
+        /** The market's name within the game, for example Draw, O/U 2.5, First to Score: CD Guadalajara, Game 2: Any Player Quadra Kill. */
+        line_label: string | null;
+    };
+};
+/** A game's traded volume as Polymarket reports it, read by the sports board with no request-time provider call. A one-side taker share count, the number Polymarket's own pages print behind a dollar sign, not the cash that changed hands. */
+export type GameVolume = {
+    /** The volume at full precision, in unit. */
+    value: number;
+    /** taker_shares: cumulative one-side taker volume in shares. One share pays $1 at settlement, so this is not cash traded. Omitted only on a figure observed before units were recorded; never assume cash. */
+    unit?: "taker_shares";
+    /** game_lines: the game volume Polymarket's game page states, summed over the game's own lines. event_total: the whole event's volume, stated when no game volume was readable. The two can differ in either direction. Omitted when the basis is unknown. */
+    basis?: "game_lines" | "event_total";
+    /** The Polymarket API the figure was read from: polymarket_data (the Data API's live volume) or gamma (the Gamma API). */
+    source: "polymarket_data" | "gamma";
+    /** When 0xinsider read the figure from the provider, never a provider-authored timestamp. Omitted when no read time is held for it. */
+    observed_at?: string;
+    /** How long after observed_at 0xinsider treats the figure as current: 60 or 300 by source and basis, or 3600 for an older figure kept because a later read of the same total was lower or missing (a cumulative volume never falls). */
+    fresh_for_seconds: number;
+};
 /** Current category evidence, independent of the global grade. Pick of the Day stamps only the served display roster; frozen entry snapshots remain unchanged. */
 export type HolderCategoryEvidence = {
     status: "live" | "insufficient" | "stale" | "unknown" | "degraded";
@@ -1660,12 +1818,42 @@ export type LeaderboardEntry = {
     win_rate?: number;
     /** Additive (#27859): the wallet's sports and esports record, the same object as GET /api/v1/trader/{address} pnl.in_scope, as of the leaderboard's last refresh. The 0xinsider leaderboard page shows and sorts by in_scope.realized_pnl and in_scope.win_rate. Omitted until 0xinsider has computed the wallet's record; absent means not computed yet, never zero. */
     in_scope?: TraderPnlInScope;
+    /** Additive (#32270): the wallet's edge over the price paid on its sports and esports markets, the figures the 0xinsider leaderboard page's Edge column states for the row. sort=edge orders by price_edge.edge. Omitted when the wallet has no settled sports or esports market of $20 or more at a known entry price. */
+    price_edge?: LeaderboardPriceEdge;
     /** Observed trading style identifier. New rows use two_sided, category_focused, high_activity, diversified, mixed, or unclassified, counted over the wallet's sports and esports markets only. Historical identifiers remain readable during normal reclassification; style does not predict skill or intent. */
     strategy_type?: string;
     /** Provider platform. Always polymarket. */
     platform: "polymarket";
     last_active?: string;
 };
+export type LeaderboardLeagues = {
+    leagues: {
+        category: string;
+        name: string;
+        ranked_traders: number;
+        slug: string;
+        sport: string;
+        total_traders: number;
+    }[];
+    min_ranked: number;
+    min_resolved: number;
+    refreshed_at: string;
+};
+/** Edge over the price paid (#32270): how often the side a wallet bought won, minus the average price it paid, over its settled sports and esports markets of $20 or more at a known entry price. Probabilities throughout: edge 0.12 is 12 percentage points. A wallet buying at 99 cents that wins every market has an edge of about 0.01. A market bought on both sides counts by its shares: the winning side's share of the shares bought is its hit, the cost over those shares its price. */
+export type LeaderboardPriceEdge = {
+    /** Settled sports and esports markets of $20 or more at a known entry price that the edge is measured over. */
+    markets: number;
+    /** Share of those markets whose bought side won, 0-1. */
+    hit_rate: number;
+    /** Mean entry price paid, 0-1. */
+    avg_price: number;
+    /** hit_rate minus avg_price, full precision. The value sort=edge orders by. */
+    edge: number;
+    /** Whether the edge ranks. ranked: at least 30 such markets, and the share of the decided ones that made money at settlement within 10 points of the win rate over the same markets. too_few_markets: fewer than 30. sample_mismatch: that share is more than 10 points away, so these markets do not describe the wallet's record. Only a ranked edge with no hold orders on sort=edge. */
+    status: "ranked" | "too_few_markets" | "sample_mismatch";
+    /** Why the leaderboard does not rank a ranked edge. record_incomplete: the wallet's stored sports and esports record shows more profit than Polymarket reports for it, so some losing markets are likely missing. Omitted when nothing holds the edge, and always omitted unless status is ranked. */
+    hold?: "record_incomplete";
+};
 /** One side's score line inside a `live_sports_updated` pulse. */
 export type LiveSportsScoreEntry = {
     /** Team name, ordered for the league (away first where the league reads that way). */
@@ -1870,6 +2058,15 @@ export type MarketHoldersSideGrades = {
     a: number;
     b: number;
 };
+/** Polymarket currentValue in USD per grade on one side, over the same wallets as that side's usd total. Each value is rounded to the cent after summing, so s + a + b can differ from the side total by up to 2 cents. */
+export type MarketHoldersSideGradeUsd = {
+    /** USD held by S-grade wallets netting this side. */
+    s: number;
+    /** USD held by A-grade wallets netting this side. */
+    a: number;
+    /** USD held by B-grade wallets netting this side. */
+    b: number;
+};
 /** Roster totals BEFORE any `outcome` or `min_grade` filter, so a page always knows the whole market it was cut from. */
 export type MarketHoldersTotals = {
     /** Distinct graded wallets with net exposure; a two-sided wallet counts once. */
@@ -1884,6 +2081,10 @@ export type MarketHoldersTotals = {
     no_usd: number;
     yes_grades: MarketHoldersSideGrades;
     no_grades: MarketHoldersSideGrades;
+    /** yes_usd split by grade: where the S, A and B money on YES sits. */
+    yes_grade_usd: MarketHoldersSideGradeUsd;
+    /** no_usd split by grade: where the S, A and B money on NO sits. */
+    no_grade_usd: MarketHoldersSideGradeUsd;
 };
 export type MarketSearchResult = {
     id: string;
@@ -1895,6 +2096,7 @@ export type MarketSearchResult = {
     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";
+    event_slug?: string;
 };
 export type MarketSnapshot = {
     market: {
@@ -1989,6 +2191,143 @@ export type MarketSnapshotTrust = {
     current_price: TrustMetadata;
     spread_bps: TrustMetadata;
 };
+export type MarketTopHolder = {
+    /** 1-based position on this outcome, by shares. */
+    rank: number;
+    /** `trd_`-prefixed trader id, accepted by `GET /api/v1/trader/{address}`. */
+    trader_id: string;
+    /** Lowercased proxy wallet. */
+    address: string;
+    /** The wallet's display name; null when it shows none. */
+    name: string | null;
+    /** All-time trader grade, S to F. Null for a wallet 0xinsider has not graded: this route lists every holder whatever its grade. */
+    grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+    /** Shares held on this outcome. */
+    shares: number;
+    /** Polymarket's current value of this position, in USD. Null when the provider served none. */
+    current_value_usd: number | null;
+    /** Average price paid for the shares still held, as a 0..1 fraction of $1. Null when the provider served none. */
+    avg_entry_price: number | null;
+    /** Shares on the other outcome when the wallet holds both; the wallet is then listed on both sides. Absent when it is one-sided. */
+    other_outcome_shares?: number;
+    /** Polymarket's realized P&L of this position (sells and redemptions), in USD. Null when the provider served no economics for the row. */
+    position_realized_pnl: number | null;
+    /** Polymarket's mark-to-market P&L of the shares still held, in USD. On a resolved market the mark is the settlement price. */
+    position_unrealized_pnl: number | null;
+    /** `position_realized_pnl` plus `position_unrealized_pnl`, in USD. */
+    position_total_pnl: number | null;
+    /** The wallet's realized P&L on sports and esports markets, in USD, the figure on its 0xinsider profile. Null until 0xinsider has computed the record, never 0 in its place, and null for every row when `profiles_status` is `unavailable`. */
+    in_scope_realized_pnl: number | null;
+    /** The wallet's volume traded on sports and esports markets, in USD. Null under the same rule as `in_scope_realized_pnl`. */
+    in_scope_volume: number | null;
+    /** The wallet's stored trading-style label (see Wallet trading styles); null when it has none. */
+    strategy_type: string | null;
+    /** The wallet's last recorded trade anywhere, null when unknown. */
+    last_traded_at: string | null;
+    /** This wallet's win rate in the market's canonical category (`market.category`): the share of its settled markets in that category (it closed its position by selling out, or the market resolved) whose realized P&L closed positive, as a 0..1 fraction. Present only with `category_win_rate_status` = `measured`. The same read `GET /api/v1/trader/{address}/categories` serves per wallet. */
+    category_win_rate?: number;
+    /** The two counts `category_win_rate` is the ratio of, from the same row: `wins / decided` equals the rate. Every settled Polymarket market the wallet traded (it closed its position by selling out, or the market resolved) in the market's canonical category, at any position size, rebuilt daily. Present only with `category_win_rate_status` = `measured`. */
+    category_win_record?: {
+        /** Settled markets in the category that this wallet closed with a profit. */
+        wins: number;
+        /** Settled markets in the category that this wallet closed with a profit or a loss. A market resolved at zero realized P&L is in neither count. */
+        decided: number;
+    };
+    /** The wallet's average entry price in the market's canonical category, as a 0..1 fraction of $1 (0.98 is 98 cents). Its sample is the wallet's markets in that category that resolved to a winning side, of $20 or more where it bought one side at a known price, so it can differ from the `category_win_record` sample. A wallet that buys near-certain outcomes wins almost every time, so read the win rate beside this price. Present only with `category_win_rate_status` = `measured`, and only when that sample has at least 5 markets. When `category_win_rate_game` is present the price is still the whole `category` bucket's: this field has no per-game or per-league price. Absent otherwise and on payloads predating the field. */
+    category_avg_price?: number;
+    /** Where `category_win_rate` and `category_win_record` were measured: for an esports market the game (`LoL`, `CS2`, `Dota 2`, `Valorant`, `Call of Duty`, `Honor of Kings`, `Mobile Legends: Bang Bang`, `Overwatch`, `Rainbow Six Siege`, `Rocket League` or `StarCraft II`), and for a market in a registered league that league, by the name Pick of the Day uses for it (`NBA`, `NFL`, `NHL`, `MLB`, `UFC`, `ATP`, `WTA`, `LaLiga`, `Premier League`, `Serie A`, `UEFA Champions League`, `MLS` and the other registered leagues). Present only when the wallet's record there clears the 5-settled-market floor, in which case the rate and record are the game's or league's rather than the whole `category` bucket's. Absent when the rate is the bucket's (the wallet's history there is under the floor, or the competition is not a registered league), on every other market, and beside every non-measured status. Label the rate with this when present and with the market's `category` otherwise. */
+    category_win_rate_game?: string;
+    /** Why `category_win_rate` is present or absent: `measured` (rate present), `not_enough_data` (under the floor of 5 decided markets in the category), or `unavailable` (the read failed; retry later). Absent when the market has no canonical category. */
+    category_win_rate_status?: "measured" | "not_enough_data" | "unavailable";
+    /** Whole days since this wallet's first trade, rounded down (3.6 days reads 3), so it changes once a day, not on every request. The five badge fields are present together, only for a wallet that draws at least one badge. */
+    wallet_age_days?: number | null;
+    /** True when the wallet's first trade was under 30 days ago. */
+    is_new_wallet?: boolean;
+    /** Distinct markets the wallet has traded. */
+    markets_traded?: number | null;
+    /** True when the wallet is flagged as automated. */
+    is_bot?: boolean;
+    /** The wallet's X handle without the @, when linked. */
+    x_username?: string | null;
+};
+export type MarketTopHolders = {
+    market: MarketHoldersMarket;
+    /** The largest YES holders, by shares, up to `limit`. */
+    yes: MarketTopHolder[];
+    /** The largest NO holders, by shares, up to `limit`. */
+    no: MarketTopHolder[];
+    totals: MarketTopHoldersTotals;
+    /** `unavailable` when the wallet record read failed: `in_scope_realized_pnl`, `in_scope_volume` and `strategy_type` are then null for every row because they were not read, not because they are unknown. */
+    profiles_status: "available" | "unavailable";
+    /** When the daily pass behind the rows' category win records began. Absent when the market has no category or the read answered no row. */
+    category_records_as_of?: string;
+    /** When this holder sample was built. */
+    computed_at?: string;
+    /** When Polymarket's holder board behind this sample was fetched: up to 120 s before `computed_at` on an open market. Absent on a resolved market, whose sample reads no live board, and when the fetch stamp could not be read. */
+    positions_as_of?: string;
+};
+export type MarketTopHoldersTotals = {
+    /** Holders in the YES sample, before `limit`. Equal to `sample_cap` means that many or more. */
+    yes_count: number;
+    /** Holders in the NO sample, before `limit`. */
+    no_count: number;
+    /** Shares summed over the YES sample. */
+    yes_shares: number;
+    /** Shares summed over the NO sample. */
+    no_shares: number;
+    /** The most holders the sample keeps per outcome (100). */
+    sample_cap: number;
+};
+/** One market's net buyers and net sellers over a 24h or 7d window, as the market page's wallets in/out panel shows a Pro viewer. */
+export type MarketWalletsInOut = {
+    /** The market's raw provider condition id. */
+    condition_id: string;
+    /** The window the nets are summed over: 24h or 7d. */
+    window: string;
+    /** The window's inclusive start; null only when the bounds are unknown. */
+    window_start: string | null;
+    /** The window's inclusive end, the read's clock; null only when the bounds are unknown. */
+    window_end: string | null;
+    /** Totals over every wallet that traded the market in the window, not only the listed 50. */
+    summary: {
+        /** Wallets with a positive net in the window. */
+        wallets_in: number;
+        /** Wallets with a negative net in the window. */
+        wallets_out: number;
+        /** The sum of every wallet's net, in USD. A fully rotated wallet nets zero and is on neither side. */
+        net_usd: number;
+    };
+    /** Wallets whose net is positive, largest first, at most 25. */
+    net_buyers: ({
+        /** Lowercase proxy wallet. */
+        address: string;
+        /** The name the site shows: the 0xinsider username, else the shortened address. */
+        display_name: string;
+        /** Today's grade; null for an ungraded or untracked wallet. */
+        grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+        /** Buys minus sells in the window, both outcomes, in USD: the matched notional, fees excluded. */
+        net_usd: number;
+        /** Fills in the window. */
+        trades: number;
+        /** The wallet's newest trade on any market, at or before window_end; null when unknown. */
+        last_traded_at: string | null;
+    })[];
+    /** Wallets whose net is negative, most negative first, at most 25. */
+    net_sellers: ({
+        /** Lowercase proxy wallet. */
+        address: string;
+        /** The name the site shows: the 0xinsider username, else the shortened address. */
+        display_name: string;
+        /** Today's grade; null for an ungraded or untracked wallet. */
+        grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+        /** Buys minus sells in the window, both outcomes, in USD: the matched notional, fees excluded. */
+        net_usd: number;
+        /** Fills in the window. */
+        trades: number;
+        /** The wallet's newest trade on any market, at or before window_end; null when unknown. */
+        last_traded_at: string | null;
+    })[];
+};
 export type McpJsonRpcError = {
     jsonrpc: "2.0";
     /** The request's id, or null when the request could not be parsed. Omitted on the answer to an unsolicited response message. */
@@ -2616,6 +2955,405 @@ export type PickOfTheDayNoEntitledPicks = {
      */
     supersedes_pick_id: string | null;
 };
+export type PickOfTheDayStats = {
+    categories: {
+        canonical_category?: string;
+        clv_avg_display?: string;
+        clv_avg_pct?: number;
+        clv_avg_pp?: number;
+        clv_avg_pp_display?: string;
+        clv_measured: number;
+        edge_display?: string;
+        edge_pp?: number;
+        key: string;
+        label: string;
+        losses: number;
+        net_profit_display?: string;
+        net_profit_usd?: number;
+        pending: number;
+        picks: number;
+        priced_decided: number;
+        priced_in_display?: string;
+        priced_in_pct?: number;
+        roi_display?: string;
+        roi_pct?: number;
+        settled: number;
+        small_sample: boolean;
+        staked_usd: number;
+        unit_score?: number;
+        unit_score_display?: string;
+        void: number;
+        win_rate_display?: string;
+        win_rate_pct?: number;
+        wins: number;
+    }[];
+    days: ({
+        date: string;
+        losses: number;
+        net_profit_display?: string;
+        net_profit_usd?: number;
+        pending: number;
+        picks: number;
+        sweep?: "win" | "loss";
+        unit_score?: number;
+        unit_score_display?: string;
+        void: number;
+        wins: number;
+    })[];
+    hit_rate: PickOfTheDayHitRate;
+    market_expectations: {
+        as_of_date: string;
+        price_basis: string;
+        timezone: string;
+        windows: ({
+            clv_avg_display: string | null;
+            clv_avg_pct: number | null;
+            clv_avg_pp: number | null;
+            clv_avg_pp_display: string | null;
+            clv_measured: number;
+            clv_missing: number;
+            expected_wins: number | null;
+            expected_wins_display: string | null;
+            from_date: string | null;
+            key: string;
+            label: string;
+            numeric_unavailable: boolean;
+            priced_decided: number;
+            through_date: string;
+            units: number | null;
+            units_display: string | null;
+            units_z: number | null;
+            units_z_display: string | null;
+            unpriced_decided: number;
+            wins: number;
+            wins_z: number | null;
+            wins_z_display: string | null;
+        })[];
+    };
+    market_types: {
+        canonical_category?: string;
+        clv_avg_display?: string;
+        clv_avg_pct?: number;
+        clv_avg_pp?: number;
+        clv_avg_pp_display?: string;
+        clv_measured: number;
+        edge_display?: string;
+        edge_pp?: number;
+        key: string;
+        label: string;
+        losses: number;
+        net_profit_display?: string;
+        net_profit_usd?: number;
+        pending: number;
+        picks: number;
+        priced_decided: number;
+        priced_in_display?: string;
+        priced_in_pct?: number;
+        roi_display?: string;
+        roi_pct?: number;
+        settled: number;
+        small_sample: boolean;
+        staked_usd: number;
+        unit_score?: number;
+        unit_score_display?: string;
+        void: number;
+        win_rate_display?: string;
+        win_rate_pct?: number;
+        wins: number;
+    }[];
+    months: {
+        canonical_category?: string;
+        clv_avg_display?: string;
+        clv_avg_pct?: number;
+        clv_avg_pp?: number;
+        clv_avg_pp_display?: string;
+        clv_measured: number;
+        edge_display?: string;
+        edge_pp?: number;
+        key: string;
+        label: string;
+        losses: number;
+        net_profit_display?: string;
+        net_profit_usd?: number;
+        pending: number;
+        picks: number;
+        priced_decided: number;
+        priced_in_display?: string;
+        priced_in_pct?: number;
+        roi_display?: string;
+        roi_pct?: number;
+        settled: number;
+        small_sample: boolean;
+        staked_usd: number;
+        unit_score?: number;
+        unit_score_display?: string;
+        void: number;
+        win_rate_display?: string;
+        win_rate_pct?: number;
+        wins: number;
+    }[];
+    outcome_stats: {
+        concentration: {
+            positive_wins: number;
+            remaining_valued_decided: number;
+            removed_wins: number;
+            roi_without_top_wins_display: string | null;
+            roi_without_top_wins_pct: number | null;
+            target_wins: number;
+            top_wins_share_display: string | null;
+            top_wins_share_pct: number | null;
+            valued_decided: number;
+        };
+        drawdown: {
+            completed_days: number;
+            current_days_below_peak: number | null;
+            current_drawdown_display: string | null;
+            current_drawdown_units: number | null;
+            days_below_peak: number | null;
+            excluded_days: number;
+            from_date: string | null;
+            longest_days_below_peak: number | null;
+            longest_recovery_days: number | null;
+            max_drawdown_display: string | null;
+            max_drawdown_units: number | null;
+            peak_date: string | null;
+            peak_net_profit_usd: number | null;
+            through_date: string | null;
+        };
+        profit_factor: {
+            display: string | null;
+            gross_loss_usd: number | null;
+            gross_profit_usd: number | null;
+            state: "empty" | "measured" | "no_losses" | "numeric_unavailable";
+            value: number | null;
+            valued_decided: number;
+        };
+        rolling: ({
+            from_date: string | null;
+            losses: number;
+            roi_display: string | null;
+            roi_pct: number | null;
+            through_date: string | null;
+            units: number | null;
+            units_display: string | null;
+            valued_decided: number;
+            win_rate_display: string | null;
+            win_rate_pct: number | null;
+            window_size: number;
+            wins: number;
+        })[];
+    };
+    price_bands: {
+        canonical_category?: string;
+        clv_avg_display?: string;
+        clv_avg_pct?: number;
+        clv_avg_pp?: number;
+        clv_avg_pp_display?: string;
+        clv_measured: number;
+        edge_display?: string;
+        edge_pp?: number;
+        key: string;
+        label: string;
+        losses: number;
+        net_profit_display?: string;
+        net_profit_usd?: number;
+        pending: number;
+        picks: number;
+        priced_decided: number;
+        priced_in_display?: string;
+        priced_in_pct?: number;
+        roi_display?: string;
+        roi_pct?: number;
+        settled: number;
+        small_sample: boolean;
+        staked_usd: number;
+        unit_score?: number;
+        unit_score_display?: string;
+        void: number;
+        win_rate_display?: string;
+        win_rate_pct?: number;
+        wins: number;
+    }[];
+    records: {
+        best_day?: {
+            date: string;
+            date_display: string;
+            losses: number;
+            net_profit_display: string;
+            net_profit_usd: number;
+            picks: number;
+            wins: number;
+        };
+        biggest_win?: {
+            category: string;
+            date: string;
+            date_display: string;
+            matchup: string;
+            net_profit_display: string;
+            net_profit_usd: number;
+        };
+        longest_losing_day_streak?: {
+            days: number;
+            end_date: string;
+            net_profit_display: string;
+            net_profit_usd: number;
+            range_display: string;
+            start_date: string;
+        };
+        longest_winning_day_streak?: {
+            days: number;
+            end_date: string;
+            net_profit_display: string;
+            net_profit_usd: number;
+            range_display: string;
+            start_date: string;
+        };
+        sweeps: {
+            clean_sweeps: number;
+            latest_clean_sweep?: {
+                date: string;
+                date_display: string;
+                losses: number;
+                wins: number;
+            };
+            latest_wipeout?: {
+                date: string;
+                date_display: string;
+                losses: number;
+                wins: number;
+            };
+            min_decided: number;
+            wipeouts: number;
+        };
+        winning_days?: {
+            flat: number;
+            losing: number;
+            settled: number;
+            winning: number;
+            winning_pct: number;
+            winning_pct_display: string;
+        };
+        worst_day?: {
+            date: string;
+            date_display: string;
+            losses: number;
+            net_profit_display: string;
+            net_profit_usd: number;
+            picks: number;
+            wins: number;
+        };
+    };
+    sports: {
+        canonical_category?: string;
+        clv_avg_display?: string;
+        clv_avg_pct?: number;
+        clv_avg_pp?: number;
+        clv_avg_pp_display?: string;
+        clv_measured: number;
+        edge_display?: string;
+        edge_pp?: number;
+        key: string;
+        label: string;
+        losses: number;
+        net_profit_display?: string;
+        net_profit_usd?: number;
+        pending: number;
+        picks: number;
+        priced_decided: number;
+        priced_in_display?: string;
+        priced_in_pct?: number;
+        roi_display?: string;
+        roi_pct?: number;
+        settled: number;
+        small_sample: boolean;
+        staked_usd: number;
+        unit_score?: number;
+        unit_score_display?: string;
+        void: number;
+        win_rate_display?: string;
+        win_rate_pct?: number;
+        wins: number;
+    }[];
+    streaks: {
+        current?: number;
+        current_day?: number;
+        current_day_display?: string;
+        current_display?: string;
+        longest_loss: number;
+        longest_win: number;
+    };
+    tiers: {
+        canonical_category?: string;
+        clv_avg_display?: string;
+        clv_avg_pct?: number;
+        clv_avg_pp?: number;
+        clv_avg_pp_display?: string;
+        clv_measured: number;
+        edge_display?: string;
+        edge_pp?: number;
+        key: string;
+        label: string;
+        losses: number;
+        net_profit_display?: string;
+        net_profit_usd?: number;
+        pending: number;
+        picks: number;
+        priced_decided: number;
+        priced_in_display?: string;
+        priced_in_pct?: number;
+        roi_display?: string;
+        roi_pct?: number;
+        settled: number;
+        small_sample: boolean;
+        staked_usd: number;
+        unit_score?: number;
+        unit_score_display?: string;
+        void: number;
+        win_rate_display?: string;
+        win_rate_pct?: number;
+        wins: number;
+    }[];
+    total_sides: {
+        canonical_category?: string;
+        clv_avg_display?: string;
+        clv_avg_pct?: number;
+        clv_avg_pp?: number;
+        clv_avg_pp_display?: string;
+        clv_measured: number;
+        edge_display?: string;
+        edge_pp?: number;
+        key: string;
+        label: string;
+        losses: number;
+        net_profit_display?: string;
+        net_profit_usd?: number;
+        pending: number;
+        picks: number;
+        priced_decided: number;
+        priced_in_display?: string;
+        priced_in_pct?: number;
+        roi_display?: string;
+        roi_pct?: number;
+        settled: number;
+        small_sample: boolean;
+        staked_usd: number;
+        unit_score?: number;
+        unit_score_display?: string;
+        void: number;
+        win_rate_display?: string;
+        win_rate_pct?: number;
+        wins: number;
+    }[];
+    voids: {
+        backed_price?: number;
+        backed_side?: string;
+        category?: string;
+        matchup?: string;
+        pick_date: string;
+        pick_id: string;
+        pick_rank: number;
+    }[];
+};
 /** A settled uncommitted pick's market, side and price. The same eight fields as PickOfTheDayCommitmentPayload, in the same key order, so a settled pick's side and price sit under payload whatever the entry's state. It is NOT a commitment: no hash was taken over it before the game, and it proves nothing about when the pick was made. */
 export type PickOfTheDayUncommittedPayload = {
     /** Frozen pre-game price of the backed side, 0..1, as the plain decimal text of the stored NUMERIC at full stored precision, trailing zeros included -- rendered exactly as the commitment payload renders it. */
@@ -2984,6 +3722,60 @@ export type ReportSourceRange = {
     end_date: string;
     timezone: "UTC";
 };
+export type ResolutionReport = {
+    accuracy: number | null;
+    all_wallets_accuracy: number | null;
+    all_wallets_right: number | null;
+    all_wallets_wrong: number | null;
+    date: string | null;
+    generated_at: string | null;
+    grade_basis: "at_resolution" | "current" | null;
+    market_scope: "all_markets" | "sports_and_esports";
+    markets?: ({
+        all_wallets_right: boolean | null;
+        category: string | null;
+        condition_id: string | null;
+        confidence: number | null;
+        event_slug: string | null;
+        out_of_product_scope: boolean;
+        outcome_no: string | null;
+        outcome_yes: string | null;
+        report_at: string;
+        smart_consensus: string | null;
+        smart_right: boolean | null;
+        smart_trader_count: number | null;
+        time_basis: "polymarket_gamma_closed_time" | "observed_resolution";
+        title: string | null;
+        total_smart_pnl: number | null;
+        traders: ({
+            address: string | null;
+            correct: boolean | null;
+            cost: number | null;
+            grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+            last_traded_at: string | null;
+            pnl: number | null;
+            side: string | null;
+            username: string | null;
+        })[];
+        weighted_no: number | null;
+        weighted_yes: number | null;
+        winning_outcome: number | null;
+    })[];
+    markets_without_smart_positions: number | null;
+    no_consensus: number | null;
+    positions_grade_unknown: number | null;
+    positions_without_side: number | null;
+    smart_money_right: number | null;
+    smart_money_wrong: number | null;
+    source_updates_pending: boolean;
+    time_basis_counts: {
+        observed_resolution: number;
+        polymarket_gamma_closed_time: number;
+    } | null;
+    total_resolved: number | null;
+    total_smart_pnl: number | null;
+    with_smart_positions: number | null;
+};
 export type ResponseMeta = {
     /** Unique request ID (req_ prefix). The same value as the X-Request-Id response header, the request's usage accounting row and its log lines. */
     request_id: string;
@@ -3148,6 +3940,50 @@ export type SnapshotState = {
     /** When this body's source read started, the clock finality is judged on. null for a body stored before that clock was recorded. */
     source_read_started_at: string | null;
 };
+export type SportLeaderboard = {
+    as_of: string | null;
+    category: string | null;
+    edge_average: number | null;
+    league: {
+        name: string;
+        ranked_traders: number;
+        slug: string;
+    } | null;
+    limit: number;
+    min_resolved: number;
+    rows: ({
+        address: string;
+        cost: number | null;
+        edge_hold: "category_loss" | "record_incomplete" | null;
+        edge_skill: number | null;
+        grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+        id: string;
+        last_category_trade_at: string | null;
+        losses: number;
+        n_resolved: number;
+        platform: "polymarket";
+        pnl: number | null;
+        price_edge: {
+            avg_price: number;
+            edge: number;
+            edge_lower: number;
+            hit_rate: number;
+            markets: number;
+            status: "ranked" | "too_few_markets" | "sample_mismatch";
+        } | null;
+        rank: number;
+        roi: number | null;
+        username: string | null;
+        volume: number | null;
+        win_rate: number | null;
+        win_rate_wilson_lb: number | null;
+        wins: number;
+    })[];
+    sort: "edge" | "pnl" | "win_rate";
+    sport: string;
+    total_traders: number;
+    volume_scope: "sports_and_esports";
+};
 export type SuspiciousTrade = {
     /** Prefixed ID (rf_...). */
     id: string;
@@ -3276,7 +4112,7 @@ export type Trader = {
          * @deprecated
          */
         realized?: number;
-        /** Unrealized P&L in USD of the wallet's open positions on its synced markets, from the open-position aggregate (dated by the positions data_quality group). Since 2026-10-27 (#29366) a wallet that holds a sports or esports market has only sports and esports markets synced, so this covers those positions; before, it covered every Polymarket market. A wallet with no sports or esports market can still carry older markets of other categories until they are deleted. */
+        /** Unrealized P&L in USD of the wallet's open positions on its synced sports and esports markets, from the open-position aggregate (dated by the positions data_quality group). Each open position's market is judged when the aggregate is read (#32119), so a stored position on a market of another category (one that moved out of sports and esports, or one stored before its category was known) is left out. Before 2026-10-27 (#29366) it covered every Polymarket market. */
         unrealized?: number;
         /**
          * Deprecated since 2026-10-27 and never sent: its one member was the lossless counterpart of the retired pnl.realized (#29830).
@@ -3376,7 +4212,7 @@ export type TraderCategoryRecords = {
 };
 export type TraderContext = {
     trader: Trader;
-    /** Aggregate position and P&L coverage for the trader, over its synced markets. Since 2026-10-27 (#29366) a wallet that holds a sports or esports market has only sports and esports markets synced, so markets_synced, markets_resolved, markets_open, unrealized_mtm, cost_basis_locked and the resolved win figures cover those markets; before, they covered every Polymarket market. A wallet with no sports or esports market can still carry older markets of other categories until they are deleted. markets_total, total_realized_pnl and synced_realized_pnl still cover every Polymarket market of the wallet. Omitted entirely (key absent, never null) when the trader is not in the local database or native net economics is unavailable. Realized fields remain numbers when present, including a genuine zero. */
+    /** Aggregate position and P&L coverage for the trader, over its synced markets. markets_open, unrealized_mtm and cost_basis_locked cover the open positions on sports and esports markets, each market judged when the summary is read (#32119). markets_synced, markets_resolved and the resolved win figures count every stored market: since 2026-10-27 (#29366) those are mostly sports and esports markets, but a market that moved out of sports and esports, or one stored before its category was known, stays in them, and sync_coverage counts every category on both sides. markets_total, total_realized_pnl and synced_realized_pnl still cover every Polymarket market of the wallet. Omitted entirely (key absent, never null) when the trader is not in the local database or native net economics is unavailable. Realized fields remain numbers when present, including a genuine zero. */
     position_summary?: {
         /** Polymarket's count of the markets the wallet traded, every category, when known; null when the provider total is unavailable. */
         markets_total: number | null;
@@ -3390,7 +4226,7 @@ export type TraderContext = {
         markets_combo: number;
         /** Synced markets the wallet has settled: it closed its position by selling out, or the market resolved. Its P&L there is final. */
         markets_resolved: number;
-        /** Synced markets still open with residual value (open positions with current value > 0). */
+        /** Synced sports and esports markets still open with residual value (open positions with current value > 0); a stored market of another category is left out (#32119). */
         markets_open: number;
         /** markets_synced plus markets_pruned plus markets_unstored plus markets_combo, divided by markets_total when the provider total is known (capped at 1.0); 0.0-1.0. Both sides count every category: no Polymarket count of a wallet's sports and esports markets exists, so the ratio does not estimate one. When markets_total is unknown or not positive (null, 0, or negative), this is 1.0 if that sum is positive (else 0.0), so cross-check markets_total before treating 1.0 as full coverage. */
         sync_coverage: number;
@@ -3398,9 +4234,9 @@ export type TraderContext = {
         synced_realized_pnl: number;
         /** Native net realized P&L (USD) over every Polymarket market of the wallet, including credited rebates, read directly from the accounting snapshot. For the sports and esports figure read trader.pnl.in_scope.realized_pnl. Position sync_coverage is separate from this accounting basis. */
         total_realized_pnl: number;
-        /** Mark-to-market unrealized P&L (USD) on open positions in synced markets. */
+        /** Mark-to-market unrealized P&L (USD) on open positions in synced sports and esports markets (#32119). */
         unrealized_mtm: number;
-        /** Cost basis (USD) currently tied up in open positions in synced markets. */
+        /** Cost basis (USD) currently tied up in open positions in synced sports and esports markets (#32119). */
         cost_basis_locked: number;
         /** Win rate as a percentage (0-100): resolved_wins over resolved_decided. A settled market that closed at exactly zero realized P&L (a void, a refund, a fully hedged position) is neither a win nor a loss and is not in the denominator, the same rule the leaderboard applies; null when no resolved market was decided. It is the rule of trader.stats.win_rate, read from the synced rows at request time; stats.win_rate is the stored figure the profile shows, refreshed by each sync and a few minutes after a closed-history write. context.md prints one Market win rate, stats.win_rate. */
         resolved_win_rate: number | null;
@@ -4330,6 +5166,7 @@ export interface OperationData {
         scopes: string[] | null;
     };
     getApiDiscovery: ApiDiscovery;
+    getCategoryLeaderboard: CategoryLeader[];
     getCombo: ComboDetail;
     getCombosSummary: CombosSummary;
     getCoverage: Platforms;
@@ -4337,6 +5174,8 @@ export interface OperationData {
     getEdgeHunter: EdgeHunterBoard | EdgeHunterRankedSignal[] | EdgeHunterObservation[];
     getEventReplaySince: EventReplayEvent[];
     getGame: Game;
+    getGameHolders: BatchGameHoldersItem[];
+    getGameSharpMoney: GameSharpMoney;
     getHealth: {
         status: "ok" | "degraded" | "down" | "maintenance";
         db: boolean;
@@ -4367,15 +5206,20 @@ export interface OperationData {
     getMarketHolders: MarketHolder[];
     getMarketIntel: MarketFlow;
     getMarketSnapshot: MarketSnapshot;
+    getMarketTopHolders: MarketTopHolders;
+    getMarketWalletsInOut: MarketWalletsInOut;
     getMonthlyReportSnapshot: ReportSnapshot;
     getPickOfTheDay: PickOfTheDay | PickOfTheDayNoEntitledPicks;
     getPickOfTheDayArchive: PickOfTheDayArchive;
     getPickOfTheDayLedger: PickOfTheDayLedger;
     getPickOfTheDayLedgerEntry: PickOfTheDayLedgerEntry;
+    getPickOfTheDayStats: PickOfTheDayStats;
     getPlatforms: Platforms;
     getPositionTimeline: PositionTimelineEvent[];
     getPositionTimelineById: PositionTimelineEvent[];
     getReports: ReportSnapshot;
+    getResolutionReport: ResolutionReport;
+    getSportLeaderboard: SportLeaderboard;
     getStream: string;
     getSuspiciousTrade: SuspiciousTrade;
     getTrader: Trader;
@@ -4528,8 +5372,43 @@ export interface OperationData {
         filters: WhaleDatasetFilters;
     };
     getWhaleTrade: LargeTradeDetail;
+    listCategoryLeaders: CategoryLeader[];
     listComboFills: ComboFill[];
+    listGameMarkets: ({
+        condition_id: string;
+        event_slug: string;
+        group_item_title?: string;
+        id: string;
+        line?: number;
+        line_outcome_index?: number;
+        negative_risk?: boolean;
+        outcomes: {
+            index: number;
+            label?: string;
+            token_id?: string;
+        }[];
+        platform?: string;
+        slug?: string;
+        sports_market_type?: string;
+        status: string;
+        title?: string;
+        sharp_money?: {
+            money_as_of: string | null;
+            outcomes: {
+                index: number;
+                usd: number;
+                wallets: {
+                    a: number;
+                    b: number;
+                    s: number;
+                };
+            }[];
+            status: "computed" | "not_computed" | "unavailable";
+            trader_count: number | null;
+        };
+    })[];
     listGames: Game[];
+    listGameTrades: GameTrade[];
     listInsiderRadar: SuspiciousTrade[];
     listLargePositions: LargePosition[];
     listLargeTradeCounterpartyExecutions: CounterpartyAnalysis;
@@ -4537,6 +5416,7 @@ export interface OperationData {
     listLargeTradeHistory: LargeTrade[];
     listLargeTrades: LargeTrade[];
     listLeaderboard: LeaderboardEntry[];
+    listLeaderboardLeagues: LeaderboardLeagues;
     listPositions: Position[];
     listSharpMoneyFlows: SmartMoneyFlowMarket[];
     listSmartMoneyFlows: SmartMoneyFlowMarket[];
@@ -4693,6 +5573,16 @@ export interface OperationQuery {
     };
     getAccountIdentity: Record<string, never>;
     getApiDiscovery: Record<string, never>;
+    getCategoryLeaderboard: {
+        /** Keep wallets that traded in the category within this window. all (the default) keeps every ranked wallet. */
+        active_within?: "all" | "7d" | "30d" | "90d";
+        /** Independent events a wallet needs in the category to be listed. The site offers 0, 50, 100 and 250. Clamped to 0..1000000. */
+        min_events?: number;
+        /** Maximum number of leaders to return. Out-of-range values are clamped to 1..100. */
+        limit?: number;
+        /** Opaque cel_ pagination cursor from a prior response. It binds the lower-bound/independent-event/wallet boundary to the committed category-skill ranking and to the slug, active_within and min_events of the request that issued it; a cursor from another filter is 400 on cursor, and one issued before the ranking refreshed is 400 with error.reason=cursor_expired. */
+        cursor?: string;
+    };
     getCombo: Record<string, never>;
     getCombosSummary: Record<string, never>;
     getCoverage: Record<string, never>;
@@ -4751,6 +5641,13 @@ export interface OperationQuery {
         expand?: "trade"[];
     };
     getGame: Record<string, never>;
+    getGameHolders: {
+        /** 1 to 25 condition_id values of this game's markets, comma-separated. The key may also repeat (condition_ids=a&condition_ids=b). A raw provider condition_id or the mkt_-prefixed market id. */
+        condition_ids: string[];
+        /** Holders per market. Out-of-range values are clamped to 1..100. */
+        limit?: number;
+    };
+    getGameSharpMoney: Record<string, never>;
     getHealth: Record<string, never>;
     getInsiderRadarFlag: Record<string, never>;
     getLargeTrade: Record<string, never>;
@@ -4787,6 +5684,14 @@ export interface OperationQuery {
         /** Include trust metadata for current_price and spread_bps. Repeatable: trust. */
         expand?: "trust"[];
     };
+    getMarketTopHolders: {
+        /** Maximum holders per outcome. Out-of-range values are clamped to 1..100. `totals` covers the whole sample whatever the limit. */
+        limit?: number;
+    };
+    getMarketWalletsInOut: {
+        /** The window the nets are summed over, ending at the read's clock: 24h (the default) or 7d. */
+        window?: "24h" | "7d";
+    };
     getMonthlyReportSnapshot: {
         /** 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;
@@ -4795,6 +5700,7 @@ export interface OperationQuery {
     getPickOfTheDayArchive: Record<string, never>;
     getPickOfTheDayLedger: Record<string, never>;
     getPickOfTheDayLedgerEntry: Record<string, never>;
+    getPickOfTheDayStats: Record<string, never>;
     getPlatforms: Record<string, never>;
     getPositionTimeline: {
         /** Market condition_id. One timeline per (trader, market). */
@@ -4818,6 +5724,20 @@ export interface OperationQuery {
         /** 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;
     };
+    getResolutionReport: {
+        /** UTC report date in YYYY-MM-DD format, no later than today UTC. Any other value returns 400 bad_request with error.param=date. */
+        date: string;
+        /** `totals` returns the counts without `markets`. Any other value than full or totals returns 400 bad_request with error.param=view. */
+        view?: "full" | "totals";
+    };
+    getSportLeaderboard: {
+        /** A league slug of the sport, for example premier-league or cs2, from GET /api/v1/leaderboard/leagues. Omit it for the sport board. */
+        league?: string;
+        /** Ranking axis. Any other value returns 400 bad_request with error.param=sort. */
+        sort?: "edge" | "pnl" | "win_rate";
+        /** Rows to return from the top of the board. Out-of-range values are clamped to 1..100. */
+        limit?: number;
+    };
     getStream: {
         /** Query-string fallback for the Last-Event-ID resume cursor when the client cannot set the request header. Numeric cluster-shared sequence id; non-numeric or absent attaches live with no replay. A future or expired id emits resync. */
         last_event_id?: string;
@@ -4881,6 +5801,7 @@ export interface OperationQuery {
     };
     getWhaleDatasetStatus: Record<string, never>;
     getWhaleTrade: Record<string, never>;
+    listCategoryLeaders: Record<string, never>;
     listComboFills: {
         /** CSV of pending, won, or lost; all clears the filter. Unknown results appear only in unfiltered lists. */
         result?: string;
@@ -4905,21 +5826,45 @@ export interface OperationQuery {
         /** Offset for ranked largest or payout ordering; use returned next_offset. */
         offset?: number;
     };
+    listGameMarkets: {
+        /** Comma-separated provider market types to keep, case-insensitive: spreads, totals, points, first_half_totals. Omitted keeps every type. An unknown type returns an empty page, not a 400; families lists the event's types. */
+        sports_market_type?: string;
+        /** active, closed or all. closed means the provider closed the market or it resolved. */
+        status?: "active" | "closed" | "all";
+        /** Page size. Out-of-range values are clamped to 1..100. */
+        limit?: number;
+        /** Opaque gmk_v1_ cursor from next_cursor, sent with the same filters. It pins the page position (sports_market_type, line, condition_id), not a snapshot. A cursor this endpoint did not issue returns 400 with error.param=cursor. */
+        cursor?: string;
+        /** sharp_money adds each row's sharp_money: the game page's per-line split, side USD and S, A and B wallet counts per outcome. One read for the event whatever the page size; the request costs 5 instead of 2. Pro and Max. Repeatable: sharp_money. */
+        expand?: "sharp_money"[];
+        /** Backward-compatible alias for expand. Repeatable: sharp_money. */
+        "expand[]"?: "sharp_money"[];
+    };
     listGames: {
         /** Canonical sport bucket, case-insensitive, with - and _ read as a space: table-tennis and Table Tennis are the same bucket. Omit for every covered sport. A bucket this deployment does not serve returns an empty page. */
         sport?: string;
-        /** League tag, case-insensitive, as coverage.leagues spells it: nfl, epl, cs2, euroleague. EuroLeague games use sport=Basketball and league=euroleague. Omit for every league inside the selected sports. */
+        /** League tag, case-insensitive, as coverage.leagues spells it: nfl, epl, cs2, euroleague, cbb, cwbb. EuroLeague games use sport=Basketball and league=euroleague; NCAA men's and women's college basketball games use sport=Basketball with league=cbb and league=cwbb. Omit for every league inside the selected sports. */
         league?: string;
-        /** Keep only games in this state. A value outside the enum returns an empty page. */
+        /** Keep only games in this state. ended, cancelled and postponed also list finished games that have left the live board, read from their stored records, for kickoffs within starts_after..starts_before (default: the 7 days before now). Without status, or with any other state, the list is the live and upcoming board. A value outside the enum returns an empty page. */
         status?: "scheduled" | "live" | "paused" | "ended" | "postponed" | "cancelled" | "suspended" | "delayed" | "unknown";
-        /** RFC 3339 instant. Keep only games whose kickoff is at or after it. Games with no published kickoff are excluded whenever either bound is set. */
+        /** RFC 3339 instant. Keep only games whose kickoff is at or after it. Games with no published kickoff are excluded whenever either bound is set. With a finished status, the stored games' look-back starts here; omitted, it starts 7 days before starts_before, and nothing caps an earlier value. */
         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;
+        /** Which games to read. all, the default, lists the whole covered catalog, which can start with games the provider still holds open weeks after kickoff. now lists what is on now: every game the provider reports in play (live or paused), plus any other game whose kickoff was at most 3 hours ago or is still to come; ended, postponed and cancelled games are left out, and a game with no published kickoff stays and sorts last. Combines with every other filter. A value other than all or now returns 400 invalid_query with error.param=window. */
+        window?: "all" | "now";
         /** 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. */
+        /** 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. With a finished status, a page that spent its read budget carries a cursor past everything it read, which may be past the last game it returned. A cursor this endpoint did not issue returns 400 with error.param=cursor. */
         cursor?: string;
+        /** Backward-compatible alias for expand. Repeatable: sharp_money. */
+        "expand[]"?: "sharp_money"[];
+        /** sharp_money adds each game's sharp_money, the GameSharpMoney object GET /api/v1/games/{event_slug}/sharp-money returns, read from the sport board's cached aggregate: one board read per sport on the page, never a per-game compute. A game the board did not evaluate carries status not_computed (read the per-game route for it); a sport whose aggregate could not be read carries status unavailable while the rest of the page is served. Adds 3 to the request cost. Repeatable. */
+        expand?: "sharp_money"[];
+    };
+    listGameTrades: {
+        /** Newest fills to return. Out-of-range values are clamped to 1..200. */
+        limit?: number;
     };
     listInsiderRadar: {
         /** Maximum number of radar flags to return. Out-of-range values are clamped to 1..100. */
@@ -4990,6 +5935,8 @@ export interface OperationQuery {
         min_market_volume_share?: number;
         /** Order of the returned page. recent is newest first and is the default. market_volume_share ranks by each trade's share of its market's traded volume, biggest first, with a trade whose share is unavailable last. That ranking reads from, or the last 30 days when from is omitted, for the same reason. A cursor is bound to the order it was minted in, so a continuation cannot cross from one order into the other. */
         sort?: "recent" | "market_volume_share";
+        /** Only the large trades in one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them. Matched case-insensitively. Newest first only (sort=market_volume_share answers 400), and cannot be combined with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
+        event_slug?: string;
     };
     listLargeTrades: {
         /** Maximum number of recent large trades to return. Out-of-range values are clamped to 1..100. */
@@ -5010,17 +5957,28 @@ export interface OperationQuery {
         sort?: "recent" | "market_volume_share";
         /** Return only the trades recorded after this one. Pass the id of a large trade this API returned (wt_<n>, or the bare integer). The answer keeps the list shape and newest-first order, and next_cursor pages within it. After means commit order: a trade recorded late with an earlier traded_at is still returned, and a trade whose write has not committed yet is returned on a later poll, never skipped. To poll, send the id of the first trade on the first page of your last answer that had trades, with If-None-Match set to the ETag you last received; when nothing new was recorded the answer is 304 with an empty body. A late trade can come back once, so deduplicate on id. Only with sort=recent. An id that names no trade, or one more than 10000 trades behind the newest, answers 400 with error.param since; request the list without since and continue from its first trade. */
         since?: string;
+        /** Only this market's large trades: an exact raw provider condition_id. The page is read from the market's own index, newest first, and pages with cursor; it cannot be combined with since or with event_slug (400). An unknown market returns an empty list. */
+        condition_id?: string;
+        /** Only the large trades in one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them. Matched case-insensitively. Newest first only (sort=market_volume_share answers 400), pages with cursor, and cannot be combined with since or with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
+        event_slug?: string;
     };
     listLeaderboard: {
         /** 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. */
+        /** 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, and on a sorted page to its sort, dir and activity. A cursor from another sort or dir is a 400 bad_request on cursor; one from another activity, category, strategy or generation is cursor_expired. Legacy, malformed, non-finite, and unsupported-version cursors are rejected. */
         cursor?: string;
         /** Filter by category: a sport or esports bucket. Values are matched to canonical category buckets: league values fold into their sport (NBA and NCAAB into Basketball, NFL into Football). Mapped buckets are case-insensitive; passthrough buckets (Cricket, Sports) match case-sensitively against the provider-native bucket key, so use exact casing. Sports and esports only (#27306): a category outside them returns 400 bad_request with param category and names the accepted buckets. */
         category?: string;
         /** Filter by observed trading style. Current styles: two_sided, category_focused, high_activity, diversified, mixed, unclassified. Current styles count the wallet's sports and esports markets only. The ten archetype keys retired on 2026-10-01 (accumulator, algo_trader, arbitrageur, directional, event_driven, market_maker, momentum, scalper, speculator, swing_trader) are still accepted and match no wallet. Style describes recorded behavior; grade measures performance. */
         strategy?: "category_focused" | "diversified" | "high_activity" | "mixed" | "two_sided" | "unclassified";
-    };
+        /** Order of the list, the sort columns of the site's leaderboard (/skill-leaderboard). rank (default) is the board's own order, the rank the site and the trader profile show. grade orders by score. volume orders by sports and esports USD volume, the figure GET /api/v1/trader/{address} serves as stats.total_volume. predictions orders by markets_traded. pnl orders by in_scope.realized_pnl. win_rate orders by win_rate among wallets with at least 5 decided sports and esports markets; a wallet with fewer sorts as having none. edge orders by price_edge.edge among wallets whose price_edge.status is ranked and that carry no price_edge.hold; any other wallet sorts as having none. The site's Edge column ranks those same wallets by their edge pulled toward the sports and esports average, a figure the API does not send, so the two orders can differ. A wallet without the value sorts as the lowest, so last in the natural direction and first with the direction reversed. Ties fall to address ascending. With ?category= a sort still orders by these whole-record figures; the category only decides which wallets are listed. Since 2026-11-02 (#32237; edge, #32270). */
+        sort?: "rank" | "grade" | "volume" | "predictions" | "pnl" | "win_rate" | "edge";
+        /** Direction of sort. Omitted, each sort reads in its natural direction: rank 1 first for rank (asc), largest first for every other sort (desc). The opposite value reverses the list. Since 2026-11-02 (#32237). */
+        dir?: "asc" | "desc";
+        /** Limit the list to wallets by recent trading, the site leaderboard's split. active: the wallet's last trade, as its current grade recorded it and aged to today, is 30 days old or less. inactive: older than 30 days, or no trade on record. all (default): every ranked wallet. Since 2026-11-02 (#32237). */
+        activity?: "all" | "active" | "inactive";
+    };
+    listLeaderboardLeagues: Record<string, never>;
     listPositions: {
         /** Maximum number of current positions to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
@@ -5058,6 +6016,10 @@ export interface OperationQuery {
         min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
         /** Optional post-aggregate flow direction filter. */
         direction?: "YES" | "NO";
+        /** Only this market's flow: an exact raw provider condition_id. Cannot be combined with event_slug (400). An unknown market returns an empty list. */
+        condition_id?: string;
+        /** Only the markets of one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them, ranked as the unfiltered list ranks. Matched case-insensitively; cannot be combined with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
+        event_slug?: string;
     };
     listSmartMoneyFlows: {
         /** Lookback window for grade-filtered whale flow aggregation. */
@@ -5074,6 +6036,10 @@ export interface OperationQuery {
         min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
         /** Optional post-aggregate flow direction filter. */
         direction?: "YES" | "NO";
+        /** Only this market's flow: an exact raw provider condition_id. Cannot be combined with event_slug (400). An unknown market returns an empty list. */
+        condition_id?: string;
+        /** Only the markets of one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them, ranked as the unfiltered list ranks. Matched case-insensitively; cannot be combined with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
+        event_slug?: string;
     };
     listSuspiciousTrades: {
         /** Maximum number of suspicious trades to return. Out-of-range values are clamped to 1..100. */
@@ -5146,6 +6112,8 @@ export interface OperationQuery {
         min_market_volume_share?: number;
         /** Order of the returned page. recent is newest first and is the default. market_volume_share ranks by each trade's share of its market's traded volume, biggest first, with a trade whose share is unavailable last. That ranking reads from, or the last 30 days when from is omitted, for the same reason. A cursor is bound to the order it was minted in, so a continuation cannot cross from one order into the other. */
         sort?: "recent" | "market_volume_share";
+        /** Only the large trades in one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them. Matched case-insensitively. Newest first only (sort=market_volume_share answers 400), and cannot be combined with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
+        event_slug?: string;
     };
     listWhaleTrades: {
         /** Maximum number of recent large trades to return. Out-of-range values are clamped to 1..100. */
@@ -5166,6 +6134,10 @@ export interface OperationQuery {
         sort?: "recent" | "market_volume_share";
         /** Return only the trades recorded after this one. Pass the id of a large trade this API returned (wt_<n>, or the bare integer). The answer keeps the list shape and newest-first order, and next_cursor pages within it. After means commit order: a trade recorded late with an earlier traded_at is still returned, and a trade whose write has not committed yet is returned on a later poll, never skipped. To poll, send the id of the first trade on the first page of your last answer that had trades, with If-None-Match set to the ETag you last received; when nothing new was recorded the answer is 304 with an empty body. A late trade can come back once, so deduplicate on id. Only with sort=recent. An id that names no trade, or one more than 10000 trades behind the newest, answers 400 with error.param since; request the list without since and continue from its first trade. */
         since?: string;
+        /** Only this market's large trades: an exact raw provider condition_id. The page is read from the market's own index, newest first, and pages with cursor; it cannot be combined with since or with event_slug (400). An unknown market returns an empty list. */
+        condition_id?: string;
+        /** Only the large trades in one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them. Matched case-insensitively. Newest first only (sort=market_volume_share answers 400), pages with cursor, and cannot be combined with since or with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
+        event_slug?: string;
     };
     prepareWebhookSecret: Record<string, never>;
     redeliverWebhookDelivery: Record<string, never>;
@@ -5179,7 +6151,7 @@ export interface OperationQuery {
         limit?: number;
     };
     searchMarkets: {
-        /** Search query. Must be 1-512 characters before whitespace trimming and non-empty after trimming. */
+        /** Search query. Must be 2-512 characters before whitespace trimming and hold at least 2 letters or digits after trimming; a query with fewer letters or digits (a, 7, ?) returns 400 bad_request with param q (#32309). */
         q: string;
         /** Maximum number of matching markets to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
@@ -5230,6 +6202,10 @@ export interface OperationPath {
     exploreMarkets: Record<string, never>;
     getAccountIdentity: Record<string, never>;
     getApiDiscovery: Record<string, never>;
+    getCategoryLeaderboard: {
+        /** The category slug, for example soccer, basketball, tennis or esports, as GET /api/v1/leaderboard/categories lists it lowercased. Matched case-insensitively. */
+        slug: string;
+    };
     getCombo: {
         /** Combo identifier: 0x followed by 62 lowercase hex characters. This differs from a binary market condition ID. */
         condition_id: string;
@@ -5243,6 +6219,14 @@ export interface OperationPath {
         /** The game's event slug, for example nfl-buf-nyj-2026-09-22. Matched case-insensitively. */
         event_slug: string;
     };
+    getGameHolders: {
+        /** The game's event slug from GET /api/v1/games, for example nba-bos-orl-2026-11-01. Matched case-insensitively. */
+        event_slug: string;
+    };
+    getGameSharpMoney: {
+        /** The game's event slug, for example nba-bos-orl-2026-11-01. Matched case-insensitively; the response carries the canonical slug. */
+        event_slug: string;
+    };
     getHealth: Record<string, never>;
     getInsiderRadarFlag: {
         /** Raw whale_alerts.id or rf_-prefixed radar flag id. */
@@ -5276,6 +6260,14 @@ export interface OperationPath {
         /** Market condition ID. Accepts the raw provider-backed condition_id returned by /api/v1/markets/search or /api/v1/markets/explore, or the mkt_-prefixed market.id emitted by V1 responses. */
         condition_id: string;
     };
+    getMarketTopHolders: {
+        /** Market condition ID. Accepts the raw provider-backed condition_id returned by /api/v1/markets/search or the mkt_-prefixed market.id emitted by V1 responses. */
+        condition_id: string;
+    };
+    getMarketWalletsInOut: {
+        /** Market condition ID. Accepts the raw provider-backed condition_id returned by /api/v1/markets/search or /api/v1/markets/explore, or the mkt_-prefixed market.id emitted by V1 responses. */
+        condition_id: string;
+    };
     getMonthlyReportSnapshot: Record<string, never>;
     getPickOfTheDay: Record<string, never>;
     getPickOfTheDayArchive: Record<string, never>;
@@ -5284,6 +6276,7 @@ export interface OperationPath {
         /** Stable positive pick row id as canonical decimal text. */
         pick_id: string;
     };
+    getPickOfTheDayStats: Record<string, never>;
     getPlatforms: Record<string, never>;
     getPositionTimeline: {
         /** Trader identity: 0x... wallet address, username, trd_-prefixed trader id, bare integer traders.id, or @username. Resolved with precedence @username -> wallet -> trd_ -> integer -> username (a leading @ forces a username lookup, for all-digit usernames); wallet matching is case-insensitive. */
@@ -5294,6 +6287,11 @@ export interface OperationPath {
         trader: string;
     };
     getReports: Record<string, never>;
+    getResolutionReport: Record<string, never>;
+    getSportLeaderboard: {
+        /** The sport slug, for example soccer, basketball, football or esports. Matched case-insensitively. A league or title alias such as nba, epl or cs2 reads its sport's board, and the body's sport is that board's slug; pass league for one league's board. */
+        sport: string;
+    };
     getStream: Record<string, never>;
     getSuspiciousTrade: {
         /** Raw whale_alerts.id or rf_-prefixed suspicious trade id. */
@@ -5351,8 +6349,17 @@ export interface OperationPath {
         /** Raw whale_alerts.id or wt_-prefixed whale trade id. */
         id: string;
     };
+    listCategoryLeaders: Record<string, never>;
     listComboFills: Record<string, never>;
+    listGameMarkets: {
+        /** The event slug from GET /api/v1/games, GET /api/v1/games/{event_slug} or a markets/search result's event_slug, for example nba-bos-orl-2026-11-01. Matched case-insensitively. */
+        event_slug: string;
+    };
     listGames: Record<string, never>;
+    listGameTrades: {
+        /** The game's event slug, for example nfl-buf-nyj-2026-09-22. Matched case-insensitively. */
+        event_slug: string;
+    };
     listInsiderRadar: Record<string, never>;
     listLargePositions: Record<string, never>;
     listLargeTradeCounterpartyExecutions: {
@@ -5368,6 +6375,7 @@ export interface OperationPath {
     listLargeTradeHistory: Record<string, never>;
     listLargeTrades: Record<string, never>;
     listLeaderboard: Record<string, never>;
+    listLeaderboardLeagues: Record<string, never>;
     listPositions: Record<string, never>;
     listSharpMoneyFlows: Record<string, never>;
     listSmartMoneyFlows: Record<string, never>;
@@ -5465,6 +6473,7 @@ export interface OperationBody {
     exploreMarkets: never;
     getAccountIdentity: never;
     getApiDiscovery: never;
+    getCategoryLeaderboard: never;
     getCombo: never;
     getCombosSummary: never;
     getCoverage: never;
@@ -5472,6 +6481,8 @@ export interface OperationBody {
     getEdgeHunter: never;
     getEventReplaySince: never;
     getGame: never;
+    getGameHolders: never;
+    getGameSharpMoney: never;
     getHealth: never;
     getInsiderRadarFlag: never;
     getLargeTrade: never;
@@ -5481,15 +6492,20 @@ export interface OperationBody {
     getMarketHolders: never;
     getMarketIntel: never;
     getMarketSnapshot: never;
+    getMarketTopHolders: never;
+    getMarketWalletsInOut: never;
     getMonthlyReportSnapshot: never;
     getPickOfTheDay: never;
     getPickOfTheDayArchive: never;
     getPickOfTheDayLedger: never;
     getPickOfTheDayLedgerEntry: never;
+    getPickOfTheDayStats: never;
     getPlatforms: never;
     getPositionTimeline: never;
     getPositionTimelineById: never;
     getReports: never;
+    getResolutionReport: never;
+    getSportLeaderboard: never;
     getStream: never;
     getSuspiciousTrade: never;
     getTrader: never;
@@ -5506,8 +6522,11 @@ export interface OperationBody {
     getWeeklyReportSnapshot: never;
     getWhaleDatasetStatus: never;
     getWhaleTrade: never;
+    listCategoryLeaders: never;
     listComboFills: never;
+    listGameMarkets: never;
     listGames: never;
+    listGameTrades: never;
     listInsiderRadar: never;
     listLargePositions: never;
     listLargeTradeCounterpartyExecutions: never;
@@ -5515,6 +6534,7 @@ export interface OperationBody {
     listLargeTradeHistory: never;
     listLargeTrades: never;
     listLeaderboard: never;
+    listLeaderboardLeagues: never;
     listPositions: never;
     listSharpMoneyFlows: never;
     listSmartMoneyFlows: never;
@@ -5620,6 +6640,15 @@ export interface OperationResponse {
         data: OperationData["getApiDiscovery"];
         meta: ResponseMeta;
     };
+    getCategoryLeaderboard: {
+        object: "list";
+        data: OperationData["getCategoryLeaderboard"];
+        has_more: boolean;
+        next_cursor?: string;
+        /** Wallets in the category whose edge lower bound is above zero, Wallets in the full walk across every page: those in the category, under this request's active_within and min_events, whose edge lower bound is above zero. The same on every page. */
+        total?: number;
+        meta: ResponseMeta;
+    };
     getCombo: ComboResponse;
     getCombosSummary: CombosSummaryResponse;
     getCoverage: {
@@ -5647,6 +6676,16 @@ export interface OperationResponse {
         as_of: string;
         meta: ResponseMeta;
     };
+    getGameHolders: {
+        object: "game_holders_batch";
+        data: OperationData["getGameHolders"];
+        meta: BatchResponseMeta;
+    };
+    getGameSharpMoney: {
+        object: "game_sharp_money";
+        data: OperationData["getGameSharpMoney"];
+        meta: ResponseMeta;
+    };
     getHealth: {
         object: "health";
         data: OperationData["getHealth"];
@@ -5696,6 +6735,16 @@ export interface OperationResponse {
         data: OperationData["getMarketSnapshot"];
         meta: ResponseMeta;
     };
+    getMarketTopHolders: {
+        object: "market_top_holders";
+        data: OperationData["getMarketTopHolders"];
+        meta: ResponseMeta;
+    };
+    getMarketWalletsInOut: {
+        object: "market_wallets_in_out";
+        data: OperationData["getMarketWalletsInOut"];
+        meta: ResponseMeta;
+    };
     getMonthlyReportSnapshot: {
         object: "report_snapshot";
         data: OperationData["getMonthlyReportSnapshot"];
@@ -5721,6 +6770,11 @@ export interface OperationResponse {
         data: OperationData["getPickOfTheDayLedgerEntry"];
         meta: ResponseMeta;
     };
+    getPickOfTheDayStats: {
+        object: "pick_of_the_day_stats";
+        data: OperationData["getPickOfTheDayStats"];
+        meta: ResponseMeta;
+    };
     getPlatforms: {
         object: "platforms";
         data: OperationData["getPlatforms"];
@@ -5749,6 +6803,16 @@ export interface OperationResponse {
         data: OperationData["getReports"];
         meta: ResponseMeta;
     };
+    getResolutionReport: {
+        object: "resolution_report";
+        data: OperationData["getResolutionReport"];
+        meta: ResponseMeta;
+    };
+    getSportLeaderboard: {
+        object: "sport_leaderboard";
+        data: OperationData["getSportLeaderboard"];
+        meta: ResponseMeta;
+    };
     getStream: string;
     getSuspiciousTrade: {
         object: "suspicious_trade";
@@ -5809,18 +6873,52 @@ export interface OperationResponse {
         data: OperationData["getWhaleTrade"];
         meta: ResponseMeta;
     };
+    listCategoryLeaders: {
+        object: "list";
+        data: OperationData["listCategoryLeaders"];
+        has_more: boolean;
+        next_cursor?: string;
+        /** Number of rows returned: up to three per category. */
+        total?: number;
+        meta: ResponseMeta;
+    };
     listComboFills: ComboFillsResponse;
+    listGameMarkets: {
+        data: OperationData["listGameMarkets"];
+        event_slug: string;
+        families: {
+            active: number;
+            markets: number;
+            sports_market_type?: string;
+        }[];
+        has_more: boolean;
+        meta: ResponseMeta;
+        next_cursor?: string;
+        object: string;
+    };
     listGames: {
         object: "list";
         data: OperationData["listGames"];
         has_more: boolean;
         /** Pass as cursor for the next page. Present only when has_more is true. */
         next_cursor?: string;
-        /** When this read assembled the catalog. Per-source vintage is on each game's freshness. */
+        /** When this read assembled the catalog; with status ended, cancelled or postponed, when it read the stored records. Per-source vintage is on each game's freshness. */
         as_of: string;
         coverage: GamesCoverage;
         meta: ResponseMeta;
     };
+    listGameTrades: {
+        object: "list";
+        /** Newest first. */
+        data: OperationData["listGameTrades"];
+        /** Always false: the list is the game's newest limit fills, not a walk. Poll again for newer fills. */
+        has_more: boolean;
+        /** The game the rows were read for, lowercased. */
+        event_slug: string;
+        /** true when the rows are the game's last complete read, served while its refresh runs. Read again in a few seconds for the live rows. */
+        source_stale: boolean;
+        meta: ResponseMeta;
+    };
     listInsiderRadar: {
         object: "list";
         data: OperationData["listInsiderRadar"];
@@ -5881,6 +6979,11 @@ export interface OperationResponse {
         total?: number;
         meta: ResponseMeta;
     };
+    listLeaderboardLeagues: {
+        object: "leaderboard_leagues";
+        data: OperationData["listLeaderboardLeagues"];
+        meta: ResponseMeta;
+    };
     listPositions: {
         object: "list";
         data: OperationData["listPositions"];