@0xinsider/mcp 2.1.3 → 2.4.0

package/dist/sdk/schema.d.ts

@@ -25,7 +25,7 @@ export type AgentRegistration = {
     environment: "sandbox";
     created_at: string;
     sandbox: {
-        /** The sandbox V1 base URL. Every documented operation answers here with example data. */
+        /** The sandbox V1 base URL. Every documented operation answers here with example data, except GET /api/v1/stream: a Server-Sent Events stream is a live connection rather than a body, so the sandbox answers it with 400. */
         api_base_url: string;
         /** A read to send with the key. */
         first_request_url: string;
@@ -76,7 +76,7 @@ export type ApiError = {
         /** The recommended next request instant (RFC3339), always in the future. Present on every retryable error: `pick_not_released`, `rate_limited`, `rate_limit_unavailable`, and `read_model_warming`. Omitted otherwise. The absolute twin of `Retry-After`; prefer the header for the sleep duration. For `pick_not_released`, the earliest of the next scheduled release, the next automatic selector attempt, the operating-window start, or about 60 seconds. See that response. */
         retry_at?: string;
         /** 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 outside the HOT/WARM sync tiers -- stop asking for this wallet. 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 Pro 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. */
-        reason?: "cursor_expired" | "unknown_endpoint" | "pick_not_released" | "trader_not_tracked" | "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";
+        reason?: "cursor_expired" | "unknown_endpoint" | "pick_not_released" | "trader_not_tracked" | "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" | "export_expired";
     };
     meta: ResponseMeta;
 };
@@ -89,7 +89,7 @@ export type ApiErrorBody = {
     /** The recommended next retry instant (RFC3339). Present on every retryable error (reason=pick_not_released, code=rate_limited including reason=monthly_quota_exceeded, code=rate_limit_unavailable, reason=read_model_warming) and omitted otherwise. Always in the future. For pick_not_released: before the 11:00 UTC operating-window start, before a selected pick's stored release, or after a skipped day, it names the automatic system's next boundary. While no candidate exists in the live window it normally names the persisted next automatic selector attempt. Every value is advisory under supported operator actions: manual publication, release-time override, or admin generation can make a pick available first. When the automatic schedule is absent/due or a pick is overdue it degrades to ~60s. Schedule one request and do not poll. Prefer Retry-After for the duration because it is immune to client clock skew. */
     retry_at?: string;
     /** 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 outside the HOT/WARM sync tiers -- stop asking for this wallet. 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 Pro 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. */
-    reason?: "cursor_expired" | "unknown_endpoint" | "pick_not_released" | "trader_not_tracked" | "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";
+    reason?: "cursor_expired" | "unknown_endpoint" | "pick_not_released" | "trader_not_tracked" | "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" | "export_expired";
 };
 export type BatchMarketIntelItem = {
     /** Zero-based request index. Duplicate inputs keep separate result rows. */
@@ -273,8 +273,8 @@ export type EventReplayEvent = {
         /** Provider discriminator. Polymarket only. */
         platform: "polymarket";
     };
-    /** Present only with expand=trade: the public trade read for this row, the same object GET /api/v1/whale-trades/{id} returns, read at request time from one query per page. traded_at, side, size_usd, price, outcome, token_id, recorded_signal_score and trader.grade_at_trade with its status are the row's event-time facts; trader.grade, trader.username, signal_score, suspicion_score, suspicion_track and market title/slug/category are enrichment that can move after the event. null when that route would answer 404 for the row (its trader or market is not synced yet). */
-    trade?: WhaleTrade | null;
+    /** Present only with expand=trade: the base trade fields for this row, read at request time from one query per page. GET /api/v1/large-trades/{id} adds counterparty_analysis; replay does not include it. traded_at, side, size_usd, price, outcome, token_id, recorded_signal_score and trader.grade_at_trade with its status are the row's event-time facts; trader.grade, trader.username, signal_score, suspicion_score, suspicion_track and market title/slug/category are enrichment that can move after the event. null when that route would answer 404 for the row (its trader or market is not synced yet). */
+    trade?: LargeTrade | null;
     source: EventReplaySource;
     freshness: EventReplayFreshness;
 };
@@ -351,6 +351,8 @@ export type ExploreGroup = {
     /** Markets in the event cluster, ranked by volume with condition_id as the tie-breaker. The selected representative is retained within the 12-market cap. */
     markets: ExploreMarket[];
     rep_volume: number | null;
+    /** Canonical key since #16304; rep_whales is its deprecated spelling, emitted beside it with the same value. */
+    rep_large_trades: number | null;
     rep_whales: number | null;
 };
 export type ExploreMarket = {
@@ -369,9 +371,17 @@ export type ExploreMarket = {
     status: "active" | "closed";
     volume: number | null;
     liquidity: number | null;
+    /** Canonical key since #16304 (Polymarket's noun is large trade); whale_trade_count is its deprecated spelling, emitted beside it with the same value. */
+    large_trade_count: number | null;
     whale_trade_count: number | null;
+    /** Canonical key since #16304; whale_distinct_wallets is its deprecated spelling, emitted beside it with the same value. */
+    large_trade_distinct_wallets: number | null;
     whale_distinct_wallets: number | null;
+    /** Canonical key since #16304; whale_total_usd is its deprecated spelling, emitted beside it with the same value. */
+    large_trade_total_usd: number | null;
     whale_total_usd: number | null;
+    /** Canonical key since #16304; whale_last_trade_at is its deprecated spelling, emitted beside it with the same value. */
+    large_trade_last_at: string | null;
     whale_last_trade_at: string | null;
     end_date: string | null;
     created_at: string | null;
@@ -405,6 +415,8 @@ export type ExploreMarket = {
     discover_score: number | null;
     score_components?: {
         volume_signal: number | null;
+        /** Canonical key since #16304; whale_signal is its deprecated spelling, emitted beside it with the same value. */
+        large_trade_signal: number | null;
         whale_signal: number | null;
         liquidity_signal: number | null;
         recency_signal: number | null;
@@ -446,6 +458,125 @@ export type ExportVolumeReconciliation = {
     provider_activity_volume_gap: number | null;
     activity_volume_coverage: number | null;
 };
+/** One sports or esports game: both sides, its schedule, its provider status and the Polymarket markets linked to it. 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. */
+    event_slug: string;
+    /** The provider's Gamma gameId, as a string. Omitted when the canonical owner has no single value for this slug: the provider stamps one gameId across an event's derivative siblings, so an ambiguous read is reported as unknown rather than guessed. */
+    game_id?: string;
+    /** The canonical sport bucket, for example Soccer or Table Tennis. Omitted when neither the board scope nor the provider category names one. */
+    sport?: string;
+    /** The league tag, for example nfl or epl. Omitted for a sport served as one whole bucket with no league scope. */
+    league?: string;
+    /** The provider's event title. Omitted when the provider sent none. */
+    title?: string;
+    /** Kickoff in UTC, as the provider supplied it. Omitted when the provider published none; coverage.schedule then reads unavailable. */
+    scheduled_at?: string;
+    status: GameStatus;
+    /** Both sides, in the provider's own order. For a team league the provider lists the home side first. Empty when the provider identified neither side. */
+    competitors: GameCompetitor[];
+    /** The esports series length, for example Bo3. Omitted for everything else. */
+    series_format?: string;
+    /** Whether one of this game's markets pays on a draw. Read this instead of assuming a two-outcome moneyline. */
+    draw_offered: boolean;
+    /** Every market this read linked to the game, ordered by condition_id. */
+    markets: GameMarket[];
+    freshness: GameFreshness;
+    coverage: GameCoverage;
+    /** The game's page on 0xinsider. */
+    url: string;
+};
+/** One side of the game. */
+export type GameCompetitor = {
+    /** The competitor's name as the provider gives it. */
+    name: string;
+    /** The provider's league-scoped competitor id, as a string. Omitted when the provider has not identified this side; coverage.competitors then reads labels. */
+    provider_id?: string;
+    /** Provider crest or logo URL. Omitted when there is none. */
+    logo?: string;
+    /** The provider's score for this side, verbatim. A string because the provider sends one: a set score, a map score and a run total are not all integers. Omitted when no live-score frame carries a score. */
+    score?: string;
+    /** The provider's season record for this side, for example 12-4. Omitted when the provider sent none. */
+    record?: string;
+};
+/** 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. */
+    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";
+    /** available when the provider supplied a kickoff. */
+    schedule: "available" | "unavailable";
+};
+/** 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";
+    /** 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. */
+    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. */
+    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;
+    /** Whether a reader should be told these rows are behind. This applies the half's own servable-age bar (15 s live, 120 s upcoming), which is not the same as source_freshness: a live board whose scores are seconds old reads stale for about half of every publish cycle and is not delayed. */
+    delayed: boolean;
+    /** When this game's live-score frame was observed. Omitted when there is no frame. */
+    scores_observed_at?: string;
+    /** The provider's own frame clock. Omitted when the frame carries none. */
+    scores_source_at?: string;
+};
+/** One Polymarket market linked to this game. */
+export type GameMarket = {
+    /** The mkt_-prefixed market id every other V1 response uses. */
+    id: string;
+    /** The raw provider condition id. */
+    condition_id: string;
+    /** Always polymarket. */
+    platform: string;
+    /** The provider's market slug. Omitted when the provider sent none. */
+    slug?: string;
+    /** The provider's own market type, for example moneyline or spread. Omitted when the provider sent none. Not an enum: the provider owns this vocabulary and adds to it. */
+    sports_market_type?: string;
+    /** Which side of the game this market's YES leg pays. draw is a real value: a 1X2 market's third leg is not a competitor. Omitted when the provider ids do not classify the leg, which is not the same as other. */
+    side?: "home" | "away" | "draw" | "other";
+    /** The provider's label for the YES outcome. Omitted when the provider sent none. */
+    outcome_yes?: string;
+    /** The provider's label for the NO outcome. Omitted when the provider sent none. */
+    outcome_no?: string;
+    /** Polymarket CLOB token ids in the provider's own outcome-index order. Omitted when the provider has published none for this market. */
+    outcome_token_ids?: string[];
+};
+/** What this deployment covers, published with every page so a client never has to guess whether an empty list means no games or no coverage. */
+export type GamesCoverage = {
+    /** Canonical sport buckets served, sorted. */
+    sports: string[];
+    /** League tags served, sorted. */
+    leagues: string[];
+    /** Scopes whose source half was unavailable for this read, as <sport>:<half>. Empty means every scope answered. */
+    sources_unavailable: string[];
+};
+/** 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. 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. */
+    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. */
+    provider_status?: string;
+    /** The provider's period label, for example Q3, End Q2 or T5. Omitted when the provider sent none. */
+    period?: string;
+    /** The game clock as the provider spells it, never reformatted. Omitted when the provider sent none. */
+    clock?: string;
+    /** The provider's own in-play flag. Omitted when no live-score frame exists, which is not the same as false. */
+    live?: boolean;
+    /** Whether the game is over. Always present. */
+    ended: boolean;
+};
 /** 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";
@@ -457,7 +588,7 @@ export type LargeExportPolicy = {
     current_internal_route: string;
     /** Programmatic API-key-gated export routes (submit/status/download) and supported formats (json, ndjson, csv). */
     v1_async: {
-        /** POST route template to submit an export job. */
+        /** POST route template to submit an export job. fresh=true asks for a snapshot read after the submit instead of reusing a finished one. */
         submit_route?: string;
         /** GET route template to poll job status. */
         status_route?: string;
@@ -466,7 +597,7 @@ export type LargeExportPolicy = {
         /** Supported ?format= values. */
         formats?: ("json" | "ndjson" | "csv")[];
         /** Possible job status values. */
-        status_values?: ("queued" | "running" | "ready" | "failed")[];
+        status_values?: ("queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired")[];
         /** How long a finished export is retained before expiry. */
         retention?: string;
     };
@@ -545,6 +676,67 @@ export type LargePosition = {
         category?: string;
     };
 };
+export type LargeTrade = {
+    /** Prefixed ID (wt_...). */
+    id: string;
+    traded_at: string;
+    size_usd: number;
+    side: "BUY" | "SELL";
+    /** Traded outcome label (e.g. "Yes"/"No"/team name), resolved provider-first from the trade's outcome_index against market_canonical (index 0 -> yes, 1 -> no). Distinct axis from side (BUY/SELL): side is the trade direction, outcome is which leg was traded. null for multi-outcome (outcome_index >= 2) or unsynced markets, and for a Polymarket trade recorded before 2026-04-02T00:00:00Z, whose stored outcome_index is not trusted (a defaulted 0 for about a third of those rows; the side is unknown, not defaulted). */
+    outcome: string | null;
+    /** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for the traded outcome; null when unavailable (e.g. unsynced markets) and for a Polymarket trade recorded before 2026-04-02T00:00:00Z, where the traded side is unknown. */
+    token_id: string | null;
+    price: number;
+    /** Current 0.0–1.0 normalized signal score, computed at request time from the trader's win rate today and the trade's age now. On a historical row it is today's view of the trade, not what a reader saw then; use recorded_signal_score for that. */
+    signal_score: number;
+    /** 0.0–1.0 signal score written once when the trade row is inserted, from the trader's statistics at that moment. Populated from 2026-08-03T11:59Z; older rows return null and are never backfilled, because a backfill could only read today's statistics. If a trade is added later, its time-sensitive recorded score reflects that delay. */
+    recorded_signal_score: number | null;
+    /** Persisted live suspicion score from the scorer. Null when the row has no persisted score. */
+    suspicion_score: number | null;
+    /** Persisted scorer track. Null when a legacy row has no stored track label. */
+    suspicion_track: "whale" | "fresh_conviction" | "sliced_position" | null;
+    /** This fill's size relative to its market: size_usd divided by a market volume figure recorded at or after the trade, so the value always falls between 0 and 1 inclusive. A $10,000 fill is 0.00005 of a $200M market and 0.125 of an $80,000 one, which size_usd alone cannot distinguish. Absent when no volume figure recorded at or after the trade is available; never 0 as a stand-in and never capped at 1, because a denominator we cannot trust publishes nothing rather than a trimmed number. A market's volume keeps growing, so the same trade reports a smaller share as the market trades on. */
+    market_volume_share?: number;
+    trader: {
+        id: string;
+        address: string;
+        username?: string;
+        /** The trader's grade today, on every row however old. For what the grade was when the trade happened, read grade_at_trade. */
+        grade?: string;
+        /** The grade the trader held when the trade happened, from recorded grade history (recorded from 2026-09-19T23:00Z). Null unless grade_at_trade_status is graded. Never today's grade projected backward. */
+        grade_at_trade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+        /** graded: grade_at_trade holds the recorded grade. ungraded: the trader was recorded without a grade at that moment. unknown: no record covers the moment, which is every trade before 2026-09-19T23:00Z and a trade that fell between a grade change and its confirmation. unknown never means ungraded. */
+        grade_at_trade_status: "graded" | "ungraded" | "unknown";
+    };
+    market: {
+        id: string;
+        condition_id: string;
+        title: string;
+        slug?: string;
+        /** Provider-backed market_canonical category. */
+        category?: string;
+    };
+};
+export type LargeTradeDetail = LargeTrade & {
+    counterparty_analysis: CounterpartyAnalysis;
+};
+export type LargeTradeHistoryMeta = {
+    /** 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;
+    cached: boolean;
+    /** Cache age in seconds; the key is absent when the response was not cached. */
+    cache_age_s?: number;
+    source: {
+        kind: "local_replay";
+        table: "whale_alerts";
+        provider_fetch_at_request_time: false;
+    };
+    completeness: {
+        status: "best_effort";
+        /** Explains that local replay completeness can vary by market and time window. */
+        reason: string;
+    };
+};
 export type LeaderboardEntry = {
     id: string;
     address: string;
@@ -685,6 +877,8 @@ export type MarketIntel = {
         direction: "YES" | "NO";
         /** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for the net-flow direction outcome; null when unavailable (e.g. unsynced markets). */
         token_id: string | null;
+        /** Canonical key since #16304 (Polymarket's noun is large trade); whale_trade_count is its deprecated spelling, emitted beside it with the same value. */
+        large_trade_count?: number;
         whale_trade_count: number;
         buy_volume_usd: number;
         sell_volume_usd: number;
@@ -698,6 +892,8 @@ export type MarketIntel = {
             token_id: string | null;
             size_usd: number;
         })[];
+        /** Age of the oldest stored position snapshot behind top_positions: the minimum wallet sync clock over the positions this body publishes. The roster is a stored read rather than a live one, and graded wallets sit on different sync tiers, so this names how current the whole roster is; the response is no fresher than this timestamp. Null when the roster is empty or no published position carries a sync clock. It does not date net_flow_usd, the volumes or the trade counts, which come from large-trade event times. */
+        oldest_snapshot_as_of: string | null;
     };
     /** Deprecated alias of sharp_money; byte-identical and retained for backward compatibility. */
     smart_money: {
@@ -705,6 +901,8 @@ export type MarketIntel = {
         direction: "YES" | "NO";
         /** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for the net-flow direction outcome; null when unavailable (e.g. unsynced markets). */
         token_id: string | null;
+        /** Canonical key since #16304 (Polymarket's noun is large trade); whale_trade_count is its deprecated spelling, emitted beside it with the same value. */
+        large_trade_count?: number;
         whale_trade_count: number;
         buy_volume_usd: number;
         sell_volume_usd: number;
@@ -718,6 +916,8 @@ export type MarketIntel = {
             token_id: string | null;
             size_usd: number;
         })[];
+        /** Age of the oldest stored position snapshot behind top_positions: the minimum wallet sync clock over the positions this body publishes. The roster is a stored read rather than a live one, and graded wallets sit on different sync tiers, so this names how current the whole roster is; the response is no fresher than this timestamp. Null when the roster is empty or no published position carries a sync clock. It does not date net_flow_usd, the volumes or the trade counts, which come from large-trade event times. */
+        oldest_snapshot_as_of: string | null;
     };
     timeframe: string;
 };
@@ -1356,7 +1556,10 @@ export type PlatformCapabilities = {
     pnl: PlatformCapabilityStatus;
     strategy: PlatformCapabilityStatus;
     timeline: PlatformCapabilityStatus;
+    /** The large-trade feed. Canonical key since #16304; whale_signal is its deprecated spelling, emitted beside it with the same value. */
+    large_trades: PlatformCapabilityStatus;
     whale_signal: PlatformCapabilityStatus;
+    suspicious_trades: PlatformCapabilityStatus;
     insider_radar: PlatformCapabilityStatus;
     market_snapshot: PlatformCapabilityStatus;
 };
@@ -1464,6 +1667,193 @@ export type PotdEntryAuthorization = {
     /** Original provider kickoff ceiling. Never extended on retry. */
     expires_at: string;
 };
+/** One ranked pre-game sports market where graded sharp money is piled on one side, with required-status shadow category evidence from partial forward-observed Polymarket fills. */
+export type PreGameSide = {
+    /** The side profitable wallets hold, as a provider-backed display label. Canonical spelling of piled_side (#16310), same value: when provider group context is unavailable it may remain a bare Yes/No/Over/Under, so do not use it alone as participant identity. */
+    side: string | null;
+    /** UTC time at which the snapshot that ranked this row was computed. Canonical spelling of signal_created_at (#16310), same value. */
+    ranked_at: string;
+    /** Grade-weighted holders times the share of their money on the side: (5*s + 4*a + 3*b) * sharp_pct. Canonical spelling of conviction_score (#16310), same value. */
+    backing_score: number;
+    /** Signed share of graded money on the side, (yes_usd - no_usd)/(yes_usd + no_usd) in [-1, 1] (side-yes positive, side-no negative). Canonical spelling of smart_score (#16309, #16310), same value. */
+    side_share: number | null;
+    /** Polymarket condition id. */
+    condition_id: string;
+    /** UTC time at which the immutable signal snapshot was computed. Every row from one snapshot shares this value; it is not provider market creation time and is not rewritten at request time. Deprecated (#16310): `ranked_at` is the canonical spelling and carries the same value; this key stays on the wire. */
+    signal_created_at: string;
+    /** Polymarket CLOB token id (ERC1155 asset id, decimal string) for the PILED outcome; null when unavailable. */
+    token_id: string | null;
+    /** Canonical sport bucket (e.g. Basketball, Tennis); null when the raw category has no canonical mapping. */
+    category: string | null;
+    /** Raw provider category as stored (e.g. NBA, EPL). */
+    raw_category: string | null;
+    title: string | null;
+    event_slug: string | null;
+    /** Kickoff (UTC). In the future at SNAPSHOT time and within the requested horizon; because the response is served from a shared snapshot cached up to the ~180s TTL, a served kickoff can be up to ~180s in the past relative to the response time. Not a live guarantee that the game has not yet started. */
+    game_start_time: string | null;
+    /** Nullable provider-backed piled-outcome display label. When provider group context is unavailable, it may remain a bare Yes/No/Over/Under; do not use it alone as participant identity. Deprecated (#16310): `side` is the canonical spelling and carries the same value; this key stays on the wire. */
+    piled_side: string | null;
+    /** Provider binary-column selector: 0 selects outcome_yes/token_id_yes; 1 selects outcome_no/token_id_no. It does not identify home/away or a participant. Use piled_side together with title/event context for display. */
+    piled_outcome_index: number;
+    /** Piled-side dollar concentration backed_usd / (yes_usd + no_usd), in (0.5, 1] for a real pile; null when there is no sharp USD. */
+    sharp_pct: number | null;
+    /** Raw piled-side sharp-money USD. */
+    backed_sharp_usd: number;
+    /** S-grade graded holders on the piled side. */
+    s_count: number;
+    /** A-grade graded holders on the piled side. */
+    a_count: number;
+    /** B-grade graded holders on the piled side. */
+    b_count: number;
+    /** Piled-side graded holder count (s_count + a_count + b_count). */
+    graded_holders: number;
+    /** Best grade present on the piled side; null when none. */
+    top_grade: "S" | "A" | "B" | null;
+    /** Canonical sharp-money score (yes_usd - no_usd)/(yes_usd + no_usd) in [-1, 1] (piled-yes positive, piled-no negative); a lower-order ranking tiebreak (after directional_rank_score and conviction_score). Deprecated (#16310): `side_share` is the canonical spelling and carries the same value; this key stays on the wire. */
+    smart_score: number | null;
+    /** Market volume (USD). */
+    volume: number | null;
+    /** Aggregate recent flow direction on the market; null when unavailable. */
+    net_side: "BUY" | "SELL" | null;
+    /** Grade-weighted pile score (5*s + 4*a + 3*b) * sharp_pct; the raw conviction input to the ranking (see directional_rank_score). Deprecated (#16310): `backing_score` is the canonical spelling and carries the same value; this key stays on the wire. */
+    conviction_score: number;
+    /** Piled-side graded holders read one-way: their fresh open legs across the signal game's markets (cross-market within the one game; moneyline+spread family only) all back the same team, or, when the market's holder scan was complete, Polymarket's currentValue shows no opposite leg on this market worth 10% of the backed leg and no fresh leg opposes it. Null when the directional read was not computed (no groupable game, no holder-level data on this ranking path, or the enrichment read failed) or classified nobody. */
+    one_way_holder_count: number | null;
+    /** Piled-side graded holders classified HEDGED across the game by fresh legs (they back two or more distinct teams). A wallet long both outcomes of this market is not one-way and not counted here. Null when the directional read was not computed or classified nobody. */
+    hedged_holder_count: number | null;
+    /** Piled-side graded USD held by one-way wallets (share-weighted allocation of backed_sharp_usd). Null when the directional read was not computed or classified nobody. */
+    one_way_graded_usd: number | null;
+    /** One-way fraction of the piled graded dollars, in [0, 1] -- the metric orthogonal to sharp_pct. Stale, unknown, hedged, and two-sided dollars dilute it toward zero (conservative). Null when the directional read was not computed or classified nobody. */
+    directional_confidence: number | null;
+    /** The ranking key, descending: conviction_score * (1 + 0.25 * directional_confidence). Equals conviction_score when the directional read is null/zero, so signals without the read rank exactly as before. */
+    directional_rank_score: number;
+    category_skill: PreGameSideCategorySkill;
+    /** 1-based rank within the (min_grade-filtered) ranked result. */
+    rank: number;
+};
+/** Shadow-only category evidence over the full uncapped piled-side S/A/B holder allocation. It never changes signal membership, ordering, routing, or sizing. */
+export type PreGameSideCategorySkill = {
+    status: "live" | "insufficient" | "stale" | "unknown" | "degraded";
+    model_version: string;
+    taxonomy_version: string | null;
+    platform: "polymarket";
+    scope: "observed_goldsky_primary_taker_fill";
+    source_coverage: "partial_whale_threshold_fills" | "graded_wallet_fills";
+    observation_started_at: string;
+    as_of: string;
+    canonical_category: string | null;
+    eligible_holders: number;
+    covered_holders: number;
+    backed_sharp_usd: number | null;
+    covered_backed_usd: number | null;
+    coverage_pct: number | null;
+    weighted_edge_mean: number | null;
+    weighted_holder_lower_mean: number | null;
+    specialist_backed_usd: number | null;
+    specialist_backed_usd_pct: number | null;
+    largest_holder_backed_usd_pct: number | null;
+    minimum_holder_event_count: number | null;
+};
+/** Per-sport accountable funnel for the full observation snapshot, returned on every page. */
+export type PreGameSideFunnelReport = {
+    sports: PreGameSideSportFunnelReport[];
+};
+/** One explicitly observation-only holder-pile measurement. It is evidence for cohort evaluation, not an execution instruction, and is isolated from the funded sports-edge-signals route. */
+export type PreGameSideObservation = {
+    /** The side profitable wallets hold, as a provider-backed display label. Canonical spelling of piled_side (#16310), same value: when provider group context is unavailable it may remain a bare Yes/No/Over/Under, so do not use it alone as participant identity. */
+    side: string | null;
+    /** Grade-weighted holder-pile score before directional enrichment. Canonical spelling of conviction_score (#16310), same value. */
+    backing_score: number;
+    /** Signed share of graded money on the side, in [-1, 1]. Canonical spelling of smart_score (#16309, #16310), same value. */
+    side_share: number;
+    /** Raw Polymarket condition id. */
+    condition_id: string;
+    /** Provider-backed Polymarket CLOB token id for the piled outcome. Rows without a verified token terminate before emission. */
+    token_id: string;
+    /** Canonical sport bucket. */
+    category: "Basketball" | "Football" | "Baseball" | "Hockey" | "MMA" | "Boxing" | "Soccer" | "Cricket" | "Golf" | "Tennis" | "Esports" | "Racing" | "Table Tennis" | "Pickleball";
+    /** Raw provider category as stored. */
+    raw_category: string | null;
+    /** Provider-backed market title. */
+    title: string;
+    event_slug: string | null;
+    /** Provider event id when available. */
+    event_id: string | null;
+    /** Provider parent-event id used as the first event-cap identity when available. */
+    parent_event_id: string | null;
+    /** Provider-backed kickoff time in UTC. */
+    game_start_time: string;
+    /** UTC instant when this row finished provider/holder evaluation. */
+    observed_at: string;
+    /** Source cohort or additive projection view. emerging_pile is projected from wider_holder after source computation, overlaps its funnel denominator, and uses the source row's directional evidence. */
+    cohort: "wider_holder" | "in_play" | "emerging_pile";
+    /** Always true. This row must not be routed to an order executor. */
+    observation_only: true;
+    /** Nullable provider-backed piled-outcome display label. When provider group context is unavailable, it may remain a bare Yes/No/Over/Under; do not use it alone as participant identity. Deprecated (#16310): `side` is the canonical spelling and carries the same value; this key stays on the wire. */
+    piled_side: string | null;
+    /** Provider binary-column selector: 0 selects outcome_yes/token_id_yes; 1 selects outcome_no/token_id_no. It does not identify home/away or a participant. Use piled_side together with title/event context for display. */
+    piled_outcome_index: 0 | 1;
+    /** Provider-backed implied price for the piled outcome at observation time. */
+    backed_price: number;
+    /** Piled-side graded-holder dollar concentration. */
+    sharp_pct: number;
+    /** Raw graded-holder USD on the piled outcome. */
+    backed_sharp_usd: number;
+    s_count: number;
+    a_count: number;
+    b_count: number;
+    /** Piled-side S/A/B holder count. */
+    graded_holders: number;
+    top_grade: "S" | "A" | "B";
+    /** Canonical signed holder-pile score. Deprecated (#16310): `side_share` is the canonical spelling and carries the same value; this key stays on the wire. */
+    smart_score: number;
+    /** Strictly positive stored market volume in USD. Missing, zero, or non-finite volume terminates as invalid_market and is never emitted as an observation. */
+    volume: number;
+    /** Grade-weighted holder-pile score before directional enrichment. Deprecated (#16310): `backing_score` is the canonical spelling and carries the same value; this key stays on the wire. */
+    conviction_score: number;
+    /** Whether the provider holder page came from the shared cache or a live provider read. */
+    provider_read_source: "cached" | "live";
+    /** True only when neither provider outcome holder page hit the top-100 scan bound. False means the pile is a positive lower bound and cannot satisfy a future capital-promotion gate. */
+    holder_scan_complete: boolean;
+    /** Proven provider holder observation time. A warm cache hit uses only the original provider completion time from its companion metadata, never cache-read time. Null, malformed, future, or stale holder time fails in-play closed. */
+    holder_snapshot_at: string | null;
+    /** Truthful state of the directional read, which classifies each graded holder by its fresh synced legs across the game's markets and, when holder_scan_complete is true, by Polymarket's currentValue on both outcomes of this market. A wider_holder row can remain emitted with unavailable and terminal wider_holder_emitted; in_play fails closed instead and terminates as in_play_directional_unavailable. */
+    directional_status: "available" | "unknown_ungrouped" | "unknown_stale" | "unavailable";
+    one_way_holder_count: number | null;
+    hedged_holder_count: number | null;
+    one_way_graded_usd: number | null;
+    directional_confidence: number | null;
+    /** Default cohort ordering key: conviction_score * (1 + 0.25 * directional_confidence), or conviction_score when confidence is null. */
+    directional_rank_score: number;
+    /** 1-based rank within this observation cohort and snapshot. */
+    rank: number;
+};
+/** Closed 25-value terminal-reason vocabulary for the accountable sports-edge observation funnel. capacity_limited is intentional bounded provider-work admission and does not itself set the snapshot degraded. board_source_unavailable is a completed board-source failure; board_deadline_unavailable means live-board work missed either an internal configured-scope deadline or the outer fair-wave deadline; both classify only already-started rows, so for the upcoming source read funnel.sports[].board_upcoming_status instead; provider_unavailable is reserved for an attempted holder-provider failure; holder_deadline_unavailable is holder cache/provider absolute-deadline exhaustion. */
+export type PreGameSideObservationTerminalReason = "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" | "internal_unclassified";
+/** Independent sports-board supply plus stored-universe terminal accounting for one canonical sport. */
+export type PreGameSideSportFunnelReport = {
+    sport: "Basketball" | "Football" | "Baseball" | "Hockey" | "MMA" | "Boxing" | "Soccer" | "Cricket" | "Golf" | "Tennis" | "Esports" | "Racing" | "Table Tennis" | "Pickleball";
+    /** Unique condition ids independently visible on the provider-first sports board. */
+    board_input: number;
+    /** Whether the always-applicable live-board source completed as available. False can mean a completed source failure (board_source_unavailable) or live-board work missing an internal configured-scope deadline or the outer fair-wave deadline (board_deadline_unavailable); inspect terminals to distinguish them. */
+    board_live_available: boolean;
+    /** Whether a provider-backed upcoming-board source is configured and applicable for this sport. False means not applicable, not provider failure. */
+    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 (it reads unknown, i.e. no recorded cause, only on a snapshot cached before that field existed, which self-clears within one TTL): 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 3,000 rows or 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: exactly one cause -- a snapshot cached before this field existed whose legacy flags recorded an unavailable-but-configured half without saying why. Every freshly computed snapshot reports a concrete status, and a legacy available or not-configured row is reconstructed exactly, so unknown self-clears within one TTL. 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, 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" | "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 exact admission by the funded route's raw shared signals query before provider/holder enrichment; recent-flow rows rejected by its event, bucket, or total caps remain eligible for wider_holder measurement. 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 an attempted holder-provider read failed; holder_deadline_unavailable means holder cache/provider work missed the absolute request deadline; holder_computation_unavailable means post-holder provider or DB-backed price/metadata evaluation was unavailable. */
+    terminals: Record<string, number>;
+    /** Sum of every sparse terminal count. */
+    terminal_total: number;
+    /** True exactly when input equals terminal_total. */
+    reconciled: boolean;
+};
 /** One PUBLISHED same-day pick whose holder proof is not readable yet: its stable slot rank, the release and kickoff instants, and the instant before which a retry cannot succeed. Every item in `picks` carries its full required shape, so a pick that cannot meet it is listed here instead of being served with missing fields or a synthetic zero. */
 export type ProofPendingPickSlot = {
     /** Stable 1-based slot within the product day's ranked picks. The pick keeps this rank once its proof is readable and it moves into `picks`. */
@@ -1475,44 +1865,44 @@ export type ProofPendingPickSlot = {
     /** Recommended next read: 30 seconds ahead while pre-game proof is warming, one hour ahead for a post-kickoff pending legacy row that only settlement can make readable. Schedule against it instead of polling. */
     retry_at: string;
 };
-export type RadarFlag = {
-    /** Prefixed ID (rf_...). */
-    id: string;
-    /** Stored score that met the live flag threshold. */
-    suspicion_score: number;
-    /** The live scorer persists one threshold class. */
-    severity: "flag";
-    trader: {
-        id: string;
-        address: string;
-        username: string | null;
-    };
-    market: {
-        id: string;
-        condition_id: string;
-        /** Canonical market question when available. */
-        title: string | null;
-    };
-    scores: {
-        /** Null because the live scorer does not record this component. */
-        timing: number | null;
-        /** Null because the live scorer does not record this component. */
-        edge: number | null;
-        /** Numeric evidence.size when recorded; otherwise null. */
-        size: number | null;
-        /** Numeric evidence.fresh when recorded; otherwise null. */
-        fresh_wallet: number | null;
-    };
-    /** Stored whale_alerts.suspicion_signals JSON from the scorer. */
-    evidence: unknown;
-    /** Stored trade timestamp. */
-    created_at: string;
-};
 export type ReportPayload = {
+    /** Canonical key since #16304; total_whale_trades is its deprecated spelling, emitted beside it with the same value. */
+    total_large_trades: number | null;
     total_whale_trades: number | null;
+    /** Canonical key since #16304; total_whale_volume is its deprecated spelling, emitted beside it with the same value. */
+    total_large_trade_volume: number | null;
     total_whale_volume: number | null;
     biggest_trade_size: number | null;
     active_traders: number | null;
+    /** Canonical key since #16304; top_whale_trades is its deprecated spelling, emitted beside it with the same value. */
+    top_large_trades: ({
+        /** Provider outcome label for the traded side. */
+        outcome: string | null;
+        /** Trade direction (BUY or SELL), not the outcome side. */
+        side: string | null;
+        /** Market title. */
+        title: string | null;
+        /** Trade size in USD. */
+        size: number | null;
+        /** Trade price in provider [0, 1] units. */
+        price: number | null;
+        /** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for the traded outcome; null when unavailable (e.g. unsynced markets). */
+        token_id: string | null;
+        /** Whale trade id. */
+        id: number | null;
+        /** Trade timestamp (UTC). */
+        trade_time: string | null;
+        /** Provider market category. */
+        market_category: string | null;
+        /** Venue: polymarket. */
+        platform: string | null;
+        /** Trader display name, when known. */
+        name: string | null;
+        /** Trader pseudonym, when no display name is known. */
+        pseudonym: string | null;
+        /** Trader grade (S-F) at snapshot time. */
+        trader_grade: string | null;
+    })[] | null;
     top_whale_trades: ({
         /** Provider outcome label for the traded side. */
         outcome: string | null;
@@ -1542,6 +1932,7 @@ export type ReportPayload = {
         trader_grade: string | null;
     })[] | null;
     categories: Record<string, unknown>[] | null;
+    /** Counts of current grades for distinct Polymarket traders with at least one whale alert in the report's source date range. The grade is the current projection at snapshot materialization time, not a historical grade at trade time. Traders without a current ranking projection are omitted; a null grade entry means the active trader's current grade is unavailable. */
     grade_distribution: Record<string, unknown>[] | null;
 };
 export type ReportReconciliation = {
@@ -1635,6 +2026,8 @@ export type SmartMoneyFlowMarket = {
         direction: "YES" | "NO";
         /** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for the net-flow direction outcome; null when unavailable (e.g. unsynced markets). */
         token_id: string | null;
+        /** Canonical key since #16304 (Polymarket's noun is large trade); whale_trade_count is its deprecated spelling, emitted beside it with the same value. */
+        large_trade_count?: number;
         whale_trade_count: number;
         buy_volume_usd: number;
         sell_volume_usd: number;
@@ -1645,6 +2038,8 @@ export type SmartMoneyFlowMarket = {
         direction: "YES" | "NO";
         /** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for the net-flow direction outcome; null when unavailable (e.g. unsynced markets). */
         token_id: string | null;
+        /** Canonical key since #16304 (Polymarket's noun is large trade); whale_trade_count is its deprecated spelling, emitted beside it with the same value. */
+        large_trade_count?: number;
         whale_trade_count: number;
         buy_volume_usd: number;
         sell_volume_usd: number;
@@ -1656,6 +2051,8 @@ export type SnapshotCompleteness = {
     status: "complete" | "partial" | "empty";
     reason: string;
     expected_days: number;
+    /** Canonical key since #16304; covered_days_with_whale_activity is its deprecated spelling, emitted beside it with the same value. */
+    covered_days_with_large_trade_activity?: number;
     covered_days_with_whale_activity: number;
 };
 export type SnapshotState = {
@@ -1667,186 +2064,46 @@ export type SnapshotState = {
     status: "final" | "rolling";
     generated_at: string;
     /** For a rolling body, the UTC date on which a final body can first be built (the date of final_after); null once final. */
-    mutable_until: string | null;
-    /** Whether the source range has ended on the UTC calendar. Closing is not finality: a closed range is rolling until final_after. */
-    period_closed: boolean;
-    /** The instant a source read must start at or after to produce a final body: the range's UTC close plus 7,530 s, the whale-trade ingestion budget (p95 block lag gate plus the projection retry budget). */
-    final_after: string;
-    /** 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;
-};
-/** Per-sport accountable funnel for the full observation snapshot, returned on every page. */
-export type SportsEdgeFunnelReport = {
-    sports: SportsEdgeSportFunnelReport[];
-};
-/** One explicitly observation-only holder-pile measurement. It is evidence for cohort evaluation, not an execution instruction, and is isolated from the funded sports-edge-signals route. */
-export type SportsEdgeObservation = {
-    /** Raw Polymarket condition id. */
-    condition_id: string;
-    /** Provider-backed Polymarket CLOB token id for the piled outcome. Rows without a verified token terminate before emission. */
-    token_id: string;
-    /** Canonical sport bucket. */
-    category: "Basketball" | "Football" | "Baseball" | "Hockey" | "MMA" | "Boxing" | "Soccer" | "Cricket" | "Golf" | "Tennis" | "Esports" | "Racing" | "Table Tennis" | "Pickleball";
-    /** Raw provider category as stored. */
-    raw_category: string | null;
-    /** Provider-backed market title. */
-    title: string;
-    event_slug: string | null;
-    /** Provider event id when available. */
-    event_id: string | null;
-    /** Provider parent-event id used as the first event-cap identity when available. */
-    parent_event_id: string | null;
-    /** Provider-backed kickoff time in UTC. */
-    game_start_time: string;
-    /** UTC instant when this row finished provider/holder evaluation. */
-    observed_at: string;
-    /** Source cohort or additive projection view. emerging_pile is projected from wider_holder after source computation, overlaps its funnel denominator, and uses the source row's directional evidence. */
-    cohort: "wider_holder" | "in_play" | "emerging_pile";
-    /** Always true. This row must not be routed to an order executor. */
-    observation_only: true;
-    /** Nullable provider-backed piled-outcome display label. When provider group context is unavailable, it may remain a bare Yes/No/Over/Under; do not use it alone as participant identity. */
-    piled_side: string | null;
-    /** Provider binary-column selector: 0 selects outcome_yes/token_id_yes; 1 selects outcome_no/token_id_no. It does not identify home/away or a participant. Use piled_side together with title/event context for display. */
-    piled_outcome_index: 0 | 1;
-    /** Provider-backed implied price for the piled outcome at observation time. */
-    backed_price: number;
-    /** Piled-side graded-holder dollar concentration. */
-    sharp_pct: number;
-    /** Raw graded-holder USD on the piled outcome. */
-    backed_sharp_usd: number;
-    s_count: number;
-    a_count: number;
-    b_count: number;
-    /** Piled-side S/A/B holder count. */
-    graded_holders: number;
-    top_grade: "S" | "A" | "B";
-    /** Canonical signed holder-pile score. */
-    smart_score: number;
-    /** Strictly positive stored market volume in USD. Missing, zero, or non-finite volume terminates as invalid_market and is never emitted as an observation. */
-    volume: number;
-    /** Grade-weighted holder-pile score before directional enrichment. */
-    conviction_score: number;
-    /** Whether the provider holder page came from the shared cache or a live provider read. */
-    provider_read_source: "cached" | "live";
-    /** True only when neither provider outcome holder page hit the top-100 scan bound. False means the pile is a positive lower bound and cannot satisfy a future capital-promotion gate. */
-    holder_scan_complete: boolean;
-    /** Proven provider holder observation time. A warm cache hit uses only the original provider completion time from its companion metadata, never cache-read time. Null, malformed, future, or stale holder time fails in-play closed. */
-    holder_snapshot_at: string | null;
-    /** Truthful state of the directional read, which classifies each graded holder by its fresh synced legs across the game's markets and, when holder_scan_complete is true, by Polymarket's currentValue on both outcomes of this market. A wider_holder row can remain emitted with unavailable and terminal wider_holder_emitted; in_play fails closed instead and terminates as in_play_directional_unavailable. */
-    directional_status: "available" | "unknown_ungrouped" | "unknown_stale" | "unavailable";
-    one_way_holder_count: number | null;
-    hedged_holder_count: number | null;
-    one_way_graded_usd: number | null;
-    directional_confidence: number | null;
-    /** Default cohort ordering key: conviction_score * (1 + 0.25 * directional_confidence), or conviction_score when confidence is null. */
-    directional_rank_score: number;
-    /** 1-based rank within this observation cohort and snapshot. */
-    rank: number;
-};
-/** Closed 25-value terminal-reason vocabulary for the accountable sports-edge observation funnel. capacity_limited is intentional bounded provider-work admission and does not itself set the snapshot degraded. board_source_unavailable is a completed board-source failure; board_deadline_unavailable means live-board work missed either an internal configured-scope deadline or the outer fair-wave deadline; both classify only already-started rows, so for the upcoming source read funnel.sports[].board_upcoming_status instead; provider_unavailable is reserved for an attempted holder-provider failure; holder_deadline_unavailable is holder cache/provider absolute-deadline exhaustion. */
-export type SportsEdgeObservationTerminalReason = "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" | "internal_unclassified";
-/** One ranked pre-game sports market where graded sharp money is piled on one side, with required-status shadow category evidence from partial forward-observed Polymarket fills. */
-export type SportsEdgeSignal = {
-    /** Polymarket condition id. */
-    condition_id: string;
-    /** UTC time at which the immutable signal snapshot was computed. Every row from one snapshot shares this value; it is not provider market creation time and is not rewritten at request time. */
-    signal_created_at: string;
-    /** Polymarket CLOB token id (ERC1155 asset id, decimal string) for the PILED outcome; null when unavailable. */
-    token_id: string | null;
-    /** Canonical sport bucket (e.g. Basketball, Tennis); null when the raw category has no canonical mapping. */
-    category: string | null;
-    /** Raw provider category as stored (e.g. NBA, EPL). */
-    raw_category: string | null;
-    title: string | null;
-    event_slug: string | null;
-    /** Kickoff (UTC). In the future at SNAPSHOT time and within the requested horizon; because the response is served from a shared snapshot cached up to the ~180s TTL, a served kickoff can be up to ~180s in the past relative to the response time. Not a live guarantee that the game has not yet started. */
-    game_start_time: string | null;
-    /** Nullable provider-backed piled-outcome display label. When provider group context is unavailable, it may remain a bare Yes/No/Over/Under; do not use it alone as participant identity. */
-    piled_side: string | null;
-    /** Provider binary-column selector: 0 selects outcome_yes/token_id_yes; 1 selects outcome_no/token_id_no. It does not identify home/away or a participant. Use piled_side together with title/event context for display. */
-    piled_outcome_index: number;
-    /** Piled-side dollar concentration backed_usd / (yes_usd + no_usd), in (0.5, 1] for a real pile; null when there is no sharp USD. */
-    sharp_pct: number | null;
-    /** Raw piled-side sharp-money USD. */
-    backed_sharp_usd: number;
-    /** S-grade graded holders on the piled side. */
-    s_count: number;
-    /** A-grade graded holders on the piled side. */
-    a_count: number;
-    /** B-grade graded holders on the piled side. */
-    b_count: number;
-    /** Piled-side graded holder count (s_count + a_count + b_count). */
-    graded_holders: number;
-    /** Best grade present on the piled side; null when none. */
-    top_grade: "S" | "A" | "B" | null;
-    /** Canonical sharp-money score (yes_usd - no_usd)/(yes_usd + no_usd) in [-1, 1] (piled-yes positive, piled-no negative); a lower-order ranking tiebreak (after directional_rank_score and conviction_score). */
-    smart_score: number | null;
-    /** Market volume (USD). */
-    volume: number | null;
-    /** Aggregate recent flow direction on the market; null when unavailable. */
-    net_side: "BUY" | "SELL" | null;
-    /** Grade-weighted pile score (5*s + 4*a + 3*b) * sharp_pct; the raw conviction input to the ranking (see directional_rank_score). */
-    conviction_score: number;
-    /** Piled-side graded holders read one-way: their fresh open legs across the signal game's markets (cross-market within the one game; moneyline+spread family only) all back the same team, or, when the market's holder scan was complete, Polymarket's currentValue shows no opposite leg on this market worth 10% of the backed leg and no fresh leg opposes it. Null when the directional read was not computed (no groupable game, no holder-level data on this ranking path, or the enrichment read failed) or classified nobody. */
-    one_way_holder_count: number | null;
-    /** Piled-side graded holders classified HEDGED across the game by fresh legs (they back two or more distinct teams). A wallet long both outcomes of this market is not one-way and not counted here. Null when the directional read was not computed or classified nobody. */
-    hedged_holder_count: number | null;
-    /** Piled-side graded USD held by one-way wallets (share-weighted allocation of backed_sharp_usd). Null when the directional read was not computed or classified nobody. */
-    one_way_graded_usd: number | null;
-    /** One-way fraction of the piled graded dollars, in [0, 1] -- the metric orthogonal to sharp_pct. Stale, unknown, hedged, and two-sided dollars dilute it toward zero (conservative). Null when the directional read was not computed or classified nobody. */
-    directional_confidence: number | null;
-    /** The ranking key, descending: conviction_score * (1 + 0.25 * directional_confidence). Equals conviction_score when the directional read is null/zero, so signals without the read rank exactly as before. */
-    directional_rank_score: number;
-    category_skill: SportsEdgeSignalCategorySkill;
-    /** 1-based rank within the (min_grade-filtered) ranked result. */
-    rank: number;
-};
-/** Shadow-only category evidence over the full uncapped piled-side S/A/B holder allocation. It never changes signal membership, ordering, routing, or sizing. */
-export type SportsEdgeSignalCategorySkill = {
-    status: "live" | "insufficient" | "stale" | "unknown" | "degraded";
-    model_version: string;
-    taxonomy_version: string | null;
-    platform: "polymarket";
-    scope: "observed_goldsky_primary_taker_fill";
-    source_coverage: "partial_whale_threshold_fills" | "graded_wallet_fills";
-    observation_started_at: string;
-    as_of: string;
-    canonical_category: string | null;
-    eligible_holders: number;
-    covered_holders: number;
-    backed_sharp_usd: number | null;
-    covered_backed_usd: number | null;
-    coverage_pct: number | null;
-    weighted_edge_mean: number | null;
-    weighted_holder_lower_mean: number | null;
-    specialist_backed_usd: number | null;
-    specialist_backed_usd_pct: number | null;
-    largest_holder_backed_usd_pct: number | null;
-    minimum_holder_event_count: number | null;
-};
-/** Independent sports-board supply plus stored-universe terminal accounting for one canonical sport. */
-export type SportsEdgeSportFunnelReport = {
-    sport: "Basketball" | "Football" | "Baseball" | "Hockey" | "MMA" | "Boxing" | "Soccer" | "Cricket" | "Golf" | "Tennis" | "Esports" | "Racing" | "Table Tennis" | "Pickleball";
-    /** Unique condition ids independently visible on the provider-first sports board. */
-    board_input: number;
-    /** Whether the always-applicable live-board source completed as available. False can mean a completed source failure (board_source_unavailable) or live-board work missing an internal configured-scope deadline or the outer fair-wave deadline (board_deadline_unavailable); inspect terminals to distinguish them. */
-    board_live_available: boolean;
-    /** Whether a provider-backed upcoming-board source is configured and applicable for this sport. False means not applicable, not provider failure. */
-    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 (it reads unknown, i.e. no recorded cause, only on a snapshot cached before that field existed, which self-clears within one TTL): 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 3,000 rows or 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: exactly one cause -- a snapshot cached before this field existed whose legacy flags recorded an unavailable-but-configured half without saying why. Every freshly computed snapshot reports a concrete status, and a legacy available or not-configured row is reconstructed exactly, so unknown self-clears within one TTL. 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, 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" | "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 exact admission by the funded route's raw shared signals query before provider/holder enrichment; recent-flow rows rejected by its event, bucket, or total caps remain eligible for wider_holder measurement. 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 an attempted holder-provider read failed; holder_deadline_unavailable means holder cache/provider work missed the absolute request deadline; holder_computation_unavailable means post-holder provider or DB-backed price/metadata evaluation was unavailable. */
-    terminals: Record<string, number>;
-    /** Sum of every sparse terminal count. */
-    terminal_total: number;
-    /** True exactly when input equals terminal_total. */
-    reconciled: boolean;
+    mutable_until: string | null;
+    /** Whether the source range has ended on the UTC calendar. Closing is not finality: a closed range is rolling until final_after. */
+    period_closed: boolean;
+    /** The instant a source read must start at or after to produce a final body: the range's UTC close plus 7,530 s, the whale-trade ingestion budget (p95 block lag gate plus the projection retry budget). */
+    final_after: string;
+    /** 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 SuspiciousTrade = {
+    /** Prefixed ID (rf_...). */
+    id: string;
+    /** Stored score that met the live flag threshold. */
+    suspicion_score: number;
+    /** The live scorer persists one threshold class. */
+    severity: "flag";
+    trader: {
+        id: string;
+        address: string;
+        username: string | null;
+    };
+    market: {
+        id: string;
+        condition_id: string;
+        /** Canonical market question when available. */
+        title: string | null;
+    };
+    scores: {
+        /** Null because the live scorer does not record this component. */
+        timing: number | null;
+        /** Null because the live scorer does not record this component. */
+        edge: number | null;
+        /** Numeric evidence.size when recorded; otherwise null. */
+        size: number | null;
+        /** Numeric evidence.fresh when recorded; otherwise null. */
+        fresh_wallet: number | null;
+    };
+    /** Stored whale_alerts.suspicion_signals JSON from the scorer. */
+    evidence: unknown;
+    /** Stored trade timestamp. */
+    created_at: string;
 };
 export type Trader = {
     /** Prefixed ID (trd_...). */
@@ -1995,12 +2252,44 @@ export type TraderExportJob = {
     object: "trader_export_job";
     data: {
         job_id: number;
-        status: "queued" | "running" | "ready" | "failed";
+        /** queued: accepted, not started. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the hourly reconciler reads the object back and moves the job to ready or failed, and expires_at bounds the wait. ready: downloadable until expires_at. failed: terminal; error says why; submit a new export. expired: the retention window passed; the file is retired, the download route answers 410, submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed and expired rows stay readable for 48 hours, then the job answers 404. */
+        status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired";
         format: "json" | "ndjson" | "csv";
         total_trades: number | null;
         processed_trades: number | null;
         file_size: number | null;
         error: string | null;
+        /** True when status never changes again (ready, failed, expired). Stop polling. */
+        terminal: boolean;
+        /** What to do next: poll the status route after poll_after_s, follow the download route, or submit a new export. Published beside status so a status value added later does not strand a client. */
+        next_action: "poll" | "download" | "resubmit";
+        /** Seconds to wait before polling again. Absent when terminal. 5 while queued or running; 300 while reconcile_required, the cadence that state can change at. */
+        poll_after_s?: number;
+        created_at: string;
+        /** When the worker last claimed the job; null while queued. */
+        started_at: string | null;
+        /** When the file became downloadable. null before ready, and on jobs finalized before this field existed. */
+        ready_at: string | null;
+        failed_at: string | null;
+        /** The retention window: 24 hours from submit. A ready file downloads until this instant; a job that has not reached ready by it fails. A reused job (200 on submit) keeps its original window. */
+        expires_at: string;
+        /** When the job became expired; null until then. */
+        expired_at: string | null;
+        /** What the file is a snapshot of: the trader's served-data clock (the latest position refresh, else the last completed sync) when the file was written; the same value as export_metadata.data_as_of inside the file. null until the file is written, or when the trader had neither. Read this, not ready_at, to decide whether a reused job is fresh enough; submit with fresh=true for a newer snapshot. */
+        data_as_of: string | null;
+        /** Worker claims so far. */
+        attempt: number;
+        /** The job fails when attempt reaches this. */
+        max_attempts: number;
+        /** Present only while status is ready: the stored object's identity, so a client can check the download it receives. */
+        artifact?: {
+            /** The storage ETag of the object. */
+            etag: string | null;
+            /** Bytes on the wire (gzip); file_size is the decompressed size. */
+            compressed_size_bytes: number | null;
+            content_type: "application/json" | "application/x-ndjson" | "text/csv";
+            content_encoding: "gzip";
+        };
     };
     meta: ResponseMeta;
 };
@@ -2013,13 +2302,37 @@ export type TraderExportSnapshot = {
     counts: ExportCounts;
     large_export_policy: LargeExportPolicy;
 };
+/** A trader's daily P&L object. `id` is always present. The five sections -- `entries`, `stats`, `monthly`, `year_totals`, `drawdown` -- are present unless the request's `sections` parameter excluded them, so a request that sends no `sections` always carries all five. An excluded section is absent from the object, never null and never an empty array. */
 export type TraderPnl = {
     /** Prefixed trader ID (`trd_...`). */
     id: string;
+    /** Representation parameters applied to this body. Present only when the request sent `from`, `to` or `sections`; omitted otherwise, which is what keeps a no-parameter response identical to the one this route served before the parameters existed. */
+    view?: {
+        /** Inclusive UTC lower bound applied to the daily series; null when the request left the series unbounded below. */
+        from: string | null;
+        /** Inclusive UTC upper bound applied to the daily series; null when the request left the series unbounded above. */
+        to: string | null;
+        /** Sections this body carries, in the order the object publishes them, whatever order the query listed. */
+        sections: ("entries" | "stats" | "monthly" | "year_totals" | "drawdown")[];
+        /** Points in the full stored daily series, before the window. Compare with entries_in_window to tell a clipped chart from a wallet that really has that many days. */
+        entries_total: number;
+        /** Points of the daily series inside the window. Equal to entries_total when no bound narrowed it, and reported whether or not entries was among the requested sections. */
+        entries_in_window: number;
+        /** The last daily point strictly before `from`: the cumulative baseline the window was cut away from. null when the request set no lower bound, or when the window starts at or before the first stored point and the slice already begins at the start of the history. Cumulative values in `entries` and `drawdown` are never rebased to the window, so this is the figure to subtract for a window-relative change. */
+        anchor: {
+            date: string;
+            /** Cumulative profit carried into the window; null when the stored point has none, the same nullability entries[].cumulative_profit has. */
+            cumulative_profit: number | null;
+            /** Cumulative total P&L carried into the window; null on the same terms. */
+            total_pnl: number | null;
+            /** Underwater value at the anchor date; null when that date has no drawdown point, which happens exactly when its cumulative_profit is null. The running peak behind the window is cumulative_profit minus drawdown (drawdown is zero or negative). */
+            drawdown: number | null;
+        } | null;
+    };
     /** RFC3339 served-freshness clock for this trader's PnL history = traders.daily_pnl_recomputed_at, when the daily_pnl read model this response is served from was last rebuilt; null when it has never been recomputed for the trader. Always present, so read it as a value that can be null rather than a key that can be missing. */
     freshness_at: string | null;
-    /** Daily cumulative-P&L series (oldest-first). */
-    entries: {
+    /** Daily cumulative-P&L series (oldest-first). Present unless the request's `sections` excluded it, and clipped to `from`/`to` when either is set. cumulative_profit and total_pnl stay cumulative from the start of the stored history, so a clipped slice keeps the same economic meaning; view.anchor carries the point before the window. */
+    entries?: {
         date: string;
         markets_traded?: number;
         total_volume?: number;
@@ -2027,7 +2340,8 @@ export type TraderPnl = {
         total_pnl?: number;
         daily_change: number;
     }[];
-    stats: {
+    /** Pre-derived period stats. Present unless the request's `sections` excluded it. Always the published all/90d/30d/7d windows over the full stored history; `from`/`to` never recompute them over the request's range. */
+    stats?: {
         all: {
             current: number;
             change: number;
@@ -2081,20 +2395,20 @@ export type TraderPnl = {
             rebase_anchor: number;
         };
     };
-    /** Per-month P&L aggregation. */
-    monthly: {
+    /** Per-month P&L aggregation. Present unless the request's `sections` excluded it. Whole months over the full stored history, never clipped to `from`/`to`, so a month is never a partial month. */
+    monthly?: {
         year: number;
         month: number;
         pnl: number;
         markets_traded: number;
     }[];
-    /** Per-year P&L totals (ascending by year). */
-    year_totals: {
+    /** Per-year P&L totals (ascending by year). Present unless the request's `sections` excluded it. Whole years over the full stored history, never clipped to `from`/`to`. */
+    year_totals?: {
         year: number;
         pnl: number;
     }[];
-    /** Underwater (drawdown) series. */
-    drawdown: {
+    /** Underwater (drawdown) series. Present unless the request's `sections` excluded it, and clipped to `from`/`to` when either is set. The running peak behind each point is the full-history peak, so a clipped slice is not rebased; view.anchor.drawdown carries the value at the point before the window. */
+    drawdown?: {
         date: string;
         cumulative_profit: number;
         drawdown: number;
@@ -2277,7 +2591,7 @@ export type WebhookEndpoint = {
     signing_secret?: string;
     verification?: WebhookVerification;
 };
-/** Self-describing entry in the webhook event catalog: the event type a subscriber lists in event_types, when it fires, the data payload shape, and whether it currently fires (active) or is reserved (dormant, subscribable but not yet delivered). Pro-only event types (whale_trades_inserted, wallet_grade_changed, insider_radar_flag_raised, smart_money_flow_detected) only deliver to API keys on an active Pro subscription. */
+/** Self-describing entry in the webhook event catalog: the event type a subscriber lists in event_types, when it fires, the data payload shape, and whether it currently fires (active) or is reserved (dormant, subscribable but not yet delivered). Pro-only event types (whale_trades_inserted, wallet_grade_changed, suspicious_trade_flagged, insider_radar_flag_raised, smart_money_flow_detected) only deliver to API keys on an active Pro subscription. suspicious_trade_flagged and insider_radar_flag_raised are two spellings of one event: either one subscribes, and an endpoint receives deliveries under the spelling it registered. */
 export type WebhookEventDescriptor = {
     id: WebhookEventType;
     /** One-line description of when the event fires. */
@@ -2287,7 +2601,7 @@ export type WebhookEventDescriptor = {
     /** active: the event has a firing producer callsite. dormant: advertised and subscribable, but does not yet enqueue any delivery. */
     status: "active" | "dormant";
 };
-export type WebhookEventType = "whale_trades_inserted" | "live_sports_updated" | "whale_trader_synced" | "large_positions_updated" | "wallet_grade_changed" | "insider_radar_flag_raised" | "smart_money_flow_detected";
+export type WebhookEventType = "whale_trades_inserted" | "live_sports_updated" | "whale_trader_synced" | "large_positions_updated" | "wallet_grade_changed" | "suspicious_trade_flagged" | "insider_radar_flag_raised" | "smart_money_flow_detected";
 export type WebhookRetryPolicy = {
     max_attempts: 8;
     terminal_status: "dead_letter";
@@ -2308,67 +2622,6 @@ export type WebhookVerification = {
     token: string;
     expires_at: string;
 };
-export type WhaleTrade = {
-    /** Prefixed ID (wt_...). */
-    id: string;
-    traded_at: string;
-    size_usd: number;
-    side: "BUY" | "SELL";
-    /** Traded outcome label (e.g. "Yes"/"No"/team name), resolved provider-first from the trade's outcome_index against market_canonical (index 0 -> yes, 1 -> no). Distinct axis from side (BUY/SELL): side is the trade direction, outcome is which leg was traded. null for multi-outcome (outcome_index >= 2) or unsynced markets, and for a Polymarket trade recorded before 2026-04-02T00:00:00Z, whose stored outcome_index is not trusted (a defaulted 0 for about a third of those rows; the side is unknown, not defaulted). */
-    outcome: string | null;
-    /** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for the traded outcome; null when unavailable (e.g. unsynced markets) and for a Polymarket trade recorded before 2026-04-02T00:00:00Z, where the traded side is unknown. */
-    token_id: string | null;
-    price: number;
-    /** Current 0.0–1.0 normalized signal score, computed at request time from the trader's win rate today and the trade's age now. On a historical row it is today's view of the trade, not what a reader saw then; use recorded_signal_score for that. */
-    signal_score: number;
-    /** 0.0–1.0 signal score written once when the trade row is inserted, from the trader's statistics at that moment. Populated from 2026-08-03T11:59Z; older rows return null and are never backfilled, because a backfill could only read today's statistics. If a trade is added later, its time-sensitive recorded score reflects that delay. */
-    recorded_signal_score: number | null;
-    /** Persisted live suspicion score from the scorer. Null when the row has no persisted score. */
-    suspicion_score: number | null;
-    /** Persisted scorer track. Null when a legacy row has no stored track label. */
-    suspicion_track: "whale" | "fresh_conviction" | "sliced_position" | null;
-    /** This fill's size relative to its market: size_usd divided by the market's volume at the moment the trade was inserted. A $10,000 fill is 0.00005 of a $200M market and 0.125 of an $80,000 one, which size_usd alone cannot distinguish. Absent when the market carried no volume figure and on rows written before 2026-09-16; never 0 as a stand-in. Not capped at 1: a fill larger than the stored trailing volume is real, and that is the most significant case. */
-    market_volume_share?: number;
-    trader: {
-        id: string;
-        address: string;
-        username?: string;
-        /** The trader's grade today, on every row however old. For what the grade was when the trade happened, read grade_at_trade. */
-        grade?: string;
-        /** The grade the trader held when the trade happened, from recorded grade history (recorded from 2026-09-19T23:00Z). Null unless grade_at_trade_status is graded. Never today's grade projected backward. */
-        grade_at_trade: "S" | "A" | "B" | "C" | "D" | "F" | null;
-        /** graded: grade_at_trade holds the recorded grade. ungraded: the trader was recorded without a grade at that moment. unknown: no record covers the moment, which is every trade before 2026-09-19T23:00Z and a trade that fell between a grade change and its confirmation. unknown never means ungraded. */
-        grade_at_trade_status: "graded" | "ungraded" | "unknown";
-    };
-    market: {
-        id: string;
-        condition_id: string;
-        title: string;
-        slug?: string;
-        /** Provider-backed market_canonical category. */
-        category?: string;
-    };
-};
-export type WhaleTradeDetail = WhaleTrade & {
-    counterparty_analysis: CounterpartyAnalysis;
-};
-export type WhaleTradeHistoryMeta = {
-    /** 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;
-    cached: boolean;
-    /** Cache age in seconds; the key is absent when the response was not cached. */
-    cache_age_s?: number;
-    source: {
-        kind: "local_replay";
-        table: "whale_alerts";
-        provider_fetch_at_request_time: false;
-    };
-    completeness: {
-        status: "best_effort";
-        /** Explains that local replay completeness can vary by market and time window. */
-        reason: string;
-    };
-};
 /**
  * The `data` payload each operation answers with: what
  * `ApiClient.call<T>` resolves to, and the default `T` of every
@@ -2407,6 +2660,7 @@ export interface OperationData {
     getApiDiscovery: ApiDiscovery;
     getDailyReportSnapshot: ReportSnapshot;
     getEventReplaySince: EventReplayEvent[];
+    getGame: Game;
     getHealth: {
         status?: "ok" | "degraded" | "down" | "maintenance";
         db?: boolean;
@@ -2429,7 +2683,8 @@ export interface OperationData {
             };
         };
     };
-    getInsiderRadarFlag: RadarFlag;
+    getInsiderRadarFlag: SuspiciousTrade;
+    getLargeTrade: LargeTradeDetail;
     getMarketCandles: MarketCandles;
     getMarketContextMarkdown: string;
     getMarketHolders: MarketHolder[];
@@ -2444,6 +2699,7 @@ export interface OperationData {
     getPositionTimelineById: PositionTimelineEvent[];
     getReports: ReportSnapshot;
     getStream: string;
+    getSuspiciousTrade: SuspiciousTrade;
     getTrader: Trader;
     getTraderCategoryRecords: TraderCategoryRecords;
     getTraderContext: TraderContext;
@@ -2451,12 +2707,44 @@ export interface OperationData {
     getTraderExportSnapshot: TraderExportSnapshot;
     getTraderExportStatus: {
         job_id: number;
-        status: "queued" | "running" | "ready" | "failed";
+        /** queued: accepted, not started. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the hourly reconciler reads the object back and moves the job to ready or failed, and expires_at bounds the wait. ready: downloadable until expires_at. failed: terminal; error says why; submit a new export. expired: the retention window passed; the file is retired, the download route answers 410, submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed and expired rows stay readable for 48 hours, then the job answers 404. */
+        status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired";
         format: "json" | "ndjson" | "csv";
         total_trades: number | null;
         processed_trades: number | null;
         file_size: number | null;
         error: string | null;
+        /** True when status never changes again (ready, failed, expired). Stop polling. */
+        terminal: boolean;
+        /** What to do next: poll the status route after poll_after_s, follow the download route, or submit a new export. Published beside status so a status value added later does not strand a client. */
+        next_action: "poll" | "download" | "resubmit";
+        /** Seconds to wait before polling again. Absent when terminal. 5 while queued or running; 300 while reconcile_required, the cadence that state can change at. */
+        poll_after_s?: number;
+        created_at: string;
+        /** When the worker last claimed the job; null while queued. */
+        started_at: string | null;
+        /** When the file became downloadable. null before ready, and on jobs finalized before this field existed. */
+        ready_at: string | null;
+        failed_at: string | null;
+        /** The retention window: 24 hours from submit. A ready file downloads until this instant; a job that has not reached ready by it fails. A reused job (200 on submit) keeps its original window. */
+        expires_at: string;
+        /** When the job became expired; null until then. */
+        expired_at: string | null;
+        /** What the file is a snapshot of: the trader's served-data clock (the latest position refresh, else the last completed sync) when the file was written; the same value as export_metadata.data_as_of inside the file. null until the file is written, or when the trader had neither. Read this, not ready_at, to decide whether a reused job is fresh enough; submit with fresh=true for a newer snapshot. */
+        data_as_of: string | null;
+        /** Worker claims so far. */
+        attempt: number;
+        /** The job fails when attempt reaches this. */
+        max_attempts: number;
+        /** Present only while status is ready: the stored object's identity, so a client can check the download it receives. */
+        artifact?: {
+            /** The storage ETag of the object. */
+            etag: string | null;
+            /** Bytes on the wire (gzip); file_size is the decompressed size. */
+            compressed_size_bytes: number | null;
+            content_type: "application/json" | "application/x-ndjson" | "text/csv";
+            content_encoding: "gzip";
+        };
     };
     getTraderPnl: TraderPnl;
     getUsage: {
@@ -2496,23 +2784,31 @@ export interface OperationData {
     };
     getWebhook: WebhookEndpoint;
     getWeeklyReportSnapshot: ReportSnapshot;
-    getWhaleTrade: WhaleTradeDetail;
-    listInsiderRadar: RadarFlag[];
+    getWhaleTrade: LargeTradeDetail;
+    listGames: Game[];
+    listInsiderRadar: SuspiciousTrade[];
     listLargePositions: LargePosition[];
+    listLargeTradeCounterpartyExecutions: CounterpartyAnalysis;
+    listLargeTradeCounterpartyMakers: CounterpartyMakerPage;
+    listLargeTradeHistory: LargeTrade[];
+    listLargeTrades: LargeTrade[];
     listLeaderboard: LeaderboardEntry[];
     listPositions: Position[];
+    listPreGameSideObservations: PreGameSideObservation[];
+    listPreGameSides: PreGameSide[];
     listSharpMoneyFlows: SmartMoneyFlowMarket[];
     listSmartMoneyFlows: SmartMoneyFlowMarket[];
-    listSportsEdgeObservations: SportsEdgeObservation[];
-    listSportsEdgeSignals: SportsEdgeSignal[];
+    listSportsEdgeObservations: PreGameSideObservation[];
+    listSportsEdgeSignals: PreGameSide[];
+    listSuspiciousTrades: SuspiciousTrade[];
     listTrendingWallets: TrendingWallet[];
     listWebhookDeliveries: WebhookDelivery[];
     listWebhookEvents: WebhookEventDescriptor[];
     listWebhooks: WebhookEndpoint[];
     listWhaleTradeCounterpartyExecutions: CounterpartyAnalysis;
     listWhaleTradeCounterpartyMakers: CounterpartyMakerPage;
-    listWhaleTradeHistory: WhaleTrade[];
-    listWhaleTrades: WhaleTrade[];
+    listWhaleTradeHistory: LargeTrade[];
+    listWhaleTrades: LargeTrade[];
     prepareWebhookSecret: WebhookEndpoint;
     redeliverWebhookDelivery: WebhookDelivery;
     registerAgent: AgentRegistration;
@@ -2522,12 +2818,44 @@ export interface OperationData {
     searchMarkets: MarketSearchResult[];
     submitTraderExport: {
         job_id: number;
-        status: "queued" | "running" | "ready" | "failed";
+        /** queued: accepted, not started. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the hourly reconciler reads the object back and moves the job to ready or failed, and expires_at bounds the wait. ready: downloadable until expires_at. failed: terminal; error says why; submit a new export. expired: the retention window passed; the file is retired, the download route answers 410, submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed and expired rows stay readable for 48 hours, then the job answers 404. */
+        status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired";
         format: "json" | "ndjson" | "csv";
         total_trades: number | null;
         processed_trades: number | null;
         file_size: number | null;
         error: string | null;
+        /** True when status never changes again (ready, failed, expired). Stop polling. */
+        terminal: boolean;
+        /** What to do next: poll the status route after poll_after_s, follow the download route, or submit a new export. Published beside status so a status value added later does not strand a client. */
+        next_action: "poll" | "download" | "resubmit";
+        /** Seconds to wait before polling again. Absent when terminal. 5 while queued or running; 300 while reconcile_required, the cadence that state can change at. */
+        poll_after_s?: number;
+        created_at: string;
+        /** When the worker last claimed the job; null while queued. */
+        started_at: string | null;
+        /** When the file became downloadable. null before ready, and on jobs finalized before this field existed. */
+        ready_at: string | null;
+        failed_at: string | null;
+        /** The retention window: 24 hours from submit. A ready file downloads until this instant; a job that has not reached ready by it fails. A reused job (200 on submit) keeps its original window. */
+        expires_at: string;
+        /** When the job became expired; null until then. */
+        expired_at: string | null;
+        /** What the file is a snapshot of: the trader's served-data clock (the latest position refresh, else the last completed sync) when the file was written; the same value as export_metadata.data_as_of inside the file. null until the file is written, or when the trader had neither. Read this, not ready_at, to decide whether a reused job is fresh enough; submit with fresh=true for a newer snapshot. */
+        data_as_of: string | null;
+        /** Worker claims so far. */
+        attempt: number;
+        /** The job fails when attempt reaches this. */
+        max_attempts: number;
+        /** Present only while status is ready: the stored object's identity, so a client can check the download it receives. */
+        artifact?: {
+            /** The storage ETag of the object. */
+            etag: string | null;
+            /** Bytes on the wire (gzip); file_size is the decompressed size. */
+            compressed_size_bytes: number | null;
+            content_type: "application/json" | "application/x-ndjson" | "text/csv";
+            content_encoding: "gzip";
+        };
     };
     updateWebhook: WebhookEndpoint;
     verifyWebhook: WebhookEndpoint;
@@ -2578,8 +2906,10 @@ export interface OperationQuery {
         /** Repeatable. trade adds the public trade read to every event (the object GET /api/v1/whale-trades/{id} returns for it), from one query per page, so a page of 100 events needs no per-event detail request. Not bound to the cursor: switch it on or off mid-walk. */
         expand?: "trade"[];
     };
+    getGame: Record<string, never>;
     getHealth: Record<string, never>;
     getInsiderRadarFlag: Record<string, never>;
+    getLargeTrade: Record<string, never>;
     getMarketCandles: {
         /** Bucketing granularity. 1d aggregates by UTC calendar day, 1w by ISO week (Monday 00:00 UTC start). Defaults to 1d. */
         resolution?: "1d" | "1w";
@@ -2651,6 +2981,7 @@ export interface OperationQuery {
         /** Optional per-connection subscribe-time filter. A frame passes only when it carries a grade field whose grade is better-or-equal to this minimum (S is best). Frames that carry no grade field (every frame except wallet_grade_changed) are EXCLUDED while this is set. An invalid grade returns HTTP 400. Combines with event and condition_id as a logical AND; an absent param adds no constraint. */
         min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
     };
+    getSuspiciousTrade: Record<string, never>;
     getTrader: {
         /** Backward-compatible alias for expand. Repeatable: strategy, categories, quant_metrics, trust. */
         "expand[]"?: ("strategy" | "categories" | "quant_metrics" | "trust")[];
@@ -2668,7 +2999,16 @@ export interface OperationQuery {
         /** Export job id returned by the submit route. */
         job_id: number;
     };
-    getTraderPnl: Record<string, never>;
+    getTraderPnl: {
+        /** Inclusive UTC calendar-date lower bound in YYYY-MM-DD form for the daily series (entries and drawdown). Omit for the whole stored history. A value that is not a calendar date, or a from later than to, returns 400 bad_request with error.param from. Does not change stats, monthly or year_totals, which stay defined over the full history. */
+        from?: string;
+        /** Inclusive UTC calendar-date upper bound in YYYY-MM-DD form for the daily series (entries and drawdown). Omit for the whole stored history. A value that is not a calendar date returns 400 bad_request with error.param to. Does not change stats, monthly or year_totals. */
+        to?: string;
+        /** Which sections of the object to return. Repeatable and comma-separated: entries, stats, monthly, year_totals, drawdown. Omit it, or send it empty, for all five. A section left out is absent from data. An unrecognized name returns 400 bad_request with error.param sections rather than being ignored, so a typo cannot look like a successful request that silently dropped the section you came for. */
+        sections?: ("entries" | "stats" | "monthly" | "year_totals" | "drawdown")[];
+        /** Backward-compatible bracket alias for sections, for clients that emit array keys. Repeatable and comma-separated: entries, stats, monthly, year_totals, drawdown. */
+        "sections[]"?: ("entries" | "stats" | "monthly" | "year_totals" | "drawdown")[];
+    };
     getUsage: Record<string, never>;
     getWebhook: Record<string, never>;
     getWeeklyReportSnapshot: {
@@ -2680,6 +3020,22 @@ export interface OperationQuery {
         week?: string;
     };
     getWhaleTrade: Record<string, never>;
+    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. 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. */
+        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. */
+        starts_after?: string;
+        /** RFC 3339 instant. Keep only games whose kickoff is at or before it. Must be at or after starts_after. */
+        starts_before?: string;
+        /** Page size. */
+        limit?: number;
+        /** Opaque gms_v1_ cursor from next_cursor. It pins the page position (kickoff and event_slug), not a snapshot: the catalog is live, so a game added or removed between pages moves with it. A cursor this endpoint did not issue returns 400 with error.param=cursor. */
+        cursor?: string;
+    };
     listInsiderRadar: {
         /** Maximum number of radar flags to return. */
         limit?: number;
@@ -2706,6 +3062,60 @@ export interface OperationQuery {
         /** Scope to one market. Accepts the raw provider condition_id or the mkt_-prefixed market id (round-trips a value from a list response). Polymarket-only; an unknown id returns []. */
         condition_id?: string;
     };
+    listLargeTradeCounterpartyExecutions: {
+        /** Counterparty snapshot ID from the large trade detail response. */
+        snapshot_id: string;
+        /** Opaque cursor from the previous response's next_cursor. */
+        cursor?: string;
+        /** Maximum number of counterparty execution rows to return. */
+        limit?: number;
+    };
+    listLargeTradeCounterpartyMakers: {
+        /** Counterparty snapshot ID from the large trade detail response. */
+        snapshot_id: string;
+        /** Opaque cursor from the previous response's next_cursor. */
+        cursor?: string;
+        /** Maximum number of maker rows to return. */
+        limit?: number;
+    };
+    listLargeTradeHistory: {
+        /** Maximum number of historical large trades to return. */
+        limit?: number;
+        /** Pagination cursor from previous response's next_cursor. Prefix: wth_. URL-encode when replaying as a query parameter. */
+        cursor?: string;
+        /** Minimum trade size in USD. The capture floor was 3,000 USD before 2026-07-06 and 10,000 USD from then (1,000 USD in earnings markets), so 10000 gives one size rule across the whole archive. */
+        min_size?: number;
+        /** Exact raw provider condition_id. Unknown markets return an empty list. */
+        condition_id?: string;
+        /** Trader wallet address, timestamp-suffixed wallet alias, username, or trd_-prefixed trader ID, resolved against the traders table. Unknown traders return an empty list. */
+        trader?: string;
+        /** Filter by market category (case-insensitive). A canonical bucket name (e.g. Basketball) matches every provider member that folds into it (NBA, WNBA, NCAAB); a raw provider value also resolves to its bucket. */
+        category?: string;
+        /** Minimum trader grade as of today (trader.grade), not at trade time. On a historical window it selects wallets by a grade they may have earned after the trade; for a point-in-time rule filter on trader.grade_at_trade instead. A means S or A, B means S, A or B. */
+        min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
+        /** When true, return only rows with persisted suspicion_score >= 60. The filter is applied before SQL-backed limit + 1 pagination. */
+        suspicious_only?: boolean;
+        /** Filter by whale_alerts.platform. all is equivalent to omitted. */
+        platform?: "polymarket" | "all";
+        /** Inclusive RFC3339 lower bound on whale_alerts.traded_at. */
+        from?: string;
+        /** Exclusive RFC3339 upper bound on whale_alerts.traded_at. Must be after from when both are present. */
+        to?: string;
+    };
+    listLargeTrades: {
+        /** Maximum number of recent large trades to return. */
+        limit?: number;
+        /** Pagination cursor from previous response's next_cursor. */
+        cursor?: string;
+        /** Minimum trade size in USD. */
+        min_size?: number;
+        /** Filter by market category (case-insensitive). A canonical bucket name (e.g. Basketball) matches every provider member that folds into it (NBA, WNBA, NCAAB); a raw provider value also resolves to its bucket. */
+        category?: string;
+        /** Minimum trader grade. */
+        min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
+        /** When true, return only rows with persisted suspicion_score >= 60. The filter is applied before SQL-backed limit + 1 pagination. */
+        suspicious_only?: boolean;
+    };
     listLeaderboard: {
         /** Maximum number of ranked traders to return. */
         limit?: number;
@@ -2736,6 +3146,28 @@ export interface OperationQuery {
         /** Filter by the binary outcome side. `yes` maps to outcome_index=0, `no` to outcome_index=1. */
         side?: "yes" | "no";
     };
+    listPreGameSideObservations: {
+        /** Observation cohort. wider_holder measures pre-game holder piles outside the funded route's exact raw signals admission. in_play admits only provider-confirmed live games and excludes stale or unavailable provider live-board, holder, or directional evidence. emerging_pile is a post-compute wider_holder projection for finite sharp_pct in [0.75, 0.85) with holder_scan_complete=true and a kickoff after its pinned projection cutoff; it overlaps wider_holder, is not an independent denominator, and is not arrival history. */
+        cohort: "wider_holder" | "in_play" | "emerging_pile";
+        /** Optional canonical sport bucket. Omitted or blank selects all registered sports. Raw provider categories resolve through the canonical taxonomy, including table-tennis or table tennis to Table Tennis and pickleball to Pickleball; a non-sport category returns an empty list. */
+        category?: string;
+        /** Page size. */
+        limit?: number;
+        /** Server-authenticated opaque seo_v2_ cursor from next_cursor. Pins snapshot_as_of, cohort, rank, and condition_id; pre-deploy unsigned seo_ cursors are rejected, so clients must request the first page after this contract ships; emerging_pile cursors also pin the first-page projection_now cutoff so kickoff filtering cannot renumber continuation pages. Client edits fail closed; it cannot cross cohorts; a refreshed snapshot invalidates it with 400. */
+        cursor?: string;
+    };
+    listPreGameSides: {
+        /** Optional canonical sport bucket filter (e.g. Basketball, Tennis, Soccer). A raw provider value (NBA) resolves to its canonical bucket. A non-sport category returns an empty list. */
+        category?: string;
+        /** Page size. */
+        limit?: number;
+        /** Opaque cursor from a previous response's next_cursor. Encodes the snapshot anchor plus the last row's directional_rank_score, conviction_score, smart_score and condition_id. A cursor from an expired snapshot returns 400. */
+        cursor?: string;
+        /** Kickoff ceiling in hours from now; the floor is now (only games not yet started). Clamped to 1..48. */
+        horizon_hours?: number;
+        /** Minimum trader grade required on the piled side. Only S, A, B are accepted (the piled-side grade distribution is S/A/B only; C, D, F return 400). Default B means at least one S/A/B holder is piled; S requires an S holder, A requires an S or A holder. */
+        min_grade?: "S" | "A" | "B";
+    };
     listSharpMoneyFlows: {
         /** Lookback window for grade-filtered whale flow aggregation. */
         timeframe?: "1h" | "4h" | "24h" | "7d";
@@ -2790,6 +3222,18 @@ export interface OperationQuery {
         /** Minimum trader grade required on the piled side. Only S, A, B are accepted (the piled-side grade distribution is S/A/B only; C, D, F return 400). Default B means at least one S/A/B holder is piled; S requires an S holder, A requires an S or A holder. */
         min_grade?: "S" | "A" | "B";
     };
+    listSuspiciousTrades: {
+        /** Maximum number of suspicious trades to return. */
+        limit?: number;
+        /** Pagination cursor from previous response. */
+        cursor?: string;
+        /** Minimum suspicion score (0-100). The live flag floor of 60 also applies. */
+        min_suspicion?: number;
+        /** Compatible filter. flag selects live threshold crossings. watch returns no rows because no live watch policy exists. */
+        severity?: "flag" | "watch";
+        /** Pagination mode. live (default) keeps the 120-second response cache; stable pins the walk to one published scoring generation and binds the cursor to the limit and filters. */
+        mode?: "live" | "stable";
+    };
     listTrendingWallets: {
         /** Polymarket's weekly leaderboard caps the ranked set at 50 wallets; requests above 50 still return at most 50. */
         limit?: number;
@@ -2827,15 +3271,15 @@ export interface OperationQuery {
         limit?: number;
         /** Pagination cursor from previous response's next_cursor. Prefix: wth_. URL-encode when replaying as a query parameter. */
         cursor?: string;
-        /** Minimum trade size in USD. The capture floor was 3,000 USD before 2026-07-06 and 10,000 USD from then (1,000 USD in earnings markets), so 10000 gives one size rule across the whole archive. */
+        /** Minimum trade size in USD. */
         min_size?: number;
         /** Exact raw provider condition_id. Unknown markets return an empty list. */
         condition_id?: string;
-        /** Trader wallet address, timestamp-suffixed wallet alias, username, or trd_-prefixed trader ID, resolved against the traders table. Unknown traders return an empty list. */
+        /** Trader wallet address, timestamp-suffixed wallet alias, or username resolved against the traders table. Unknown traders return an empty list. */
         trader?: string;
         /** Filter by market category (case-insensitive). A canonical bucket name (e.g. Basketball) matches every provider member that folds into it (NBA, WNBA, NCAAB); a raw provider value also resolves to its bucket. */
         category?: string;
-        /** Minimum trader grade as of today (trader.grade), not at trade time. On a historical window it selects wallets by a grade they may have earned after the trade; for a point-in-time rule filter on trader.grade_at_trade instead. A means S or A, B means S, A or B. */
+        /** Minimum trader grade. */
         min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
         /** When true, return only rows with persisted suspicion_score >= 60. The filter is applied before SQL-backed limit + 1 pagination. */
         suspicious_only?: boolean;
@@ -2886,6 +3330,8 @@ export interface OperationQuery {
     submitTraderExport: {
         /** Output serialization. json = full envelope document (default); ndjson = full envelope as line 1 then one trade object per line; csv = flat trades rows only. */
         format?: "json" | "ndjson" | "csv";
+        /** true: do not reuse a finished, running or reconciling job; only a queued job is reused, so the file is a snapshot read after this submit. Consumes quota when nothing is queued. Default false. */
+        fresh?: boolean;
     };
     updateWebhook: Record<string, never>;
     verifyWebhook: Record<string, never>;
@@ -2909,11 +3355,19 @@ export interface OperationPath {
     getApiDiscovery: Record<string, never>;
     getDailyReportSnapshot: Record<string, never>;
     getEventReplaySince: Record<string, never>;
+    getGame: {
+        /** The game's event slug, for example nfl-buf-nyj-2026-09-22. Matched case-insensitively. */
+        event_slug: string;
+    };
     getHealth: Record<string, never>;
     getInsiderRadarFlag: {
         /** Raw whale_alerts.id or rf_-prefixed radar flag id. */
         id: string;
     };
+    getLargeTrade: {
+        /** Raw whale_alerts.id or wt_-prefixed large trade id. */
+        id: string;
+    };
     getMarketCandles: {
         /** 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;
@@ -2949,6 +3403,10 @@ export interface OperationPath {
     };
     getReports: Record<string, never>;
     getStream: Record<string, never>;
+    getSuspiciousTrade: {
+        /** Raw whale_alerts.id or rf_-prefixed suspicious trade id. */
+        id: string;
+    };
     getTrader: {
         /** Ethereum wallet address (0x...), known trader username, or trd_-prefixed trader ID emitted by this API. */
         address: string;
@@ -2987,14 +3445,30 @@ export interface OperationPath {
         /** Raw whale_alerts.id or wt_-prefixed whale trade id. */
         id: string;
     };
+    listGames: Record<string, never>;
     listInsiderRadar: Record<string, never>;
     listLargePositions: Record<string, never>;
+    listLargeTradeCounterpartyExecutions: {
+        /** Large trade ID. Accepts wt_-prefixed or raw whale_alerts.id. */
+        id: string;
+    };
+    listLargeTradeCounterpartyMakers: {
+        /** Large trade ID. Accepts wt_-prefixed or raw whale_alerts.id. */
+        id: string;
+        /** Counterparty execution ID from the parent response. */
+        execution_id: string;
+    };
+    listLargeTradeHistory: Record<string, never>;
+    listLargeTrades: Record<string, never>;
     listLeaderboard: Record<string, never>;
     listPositions: Record<string, never>;
+    listPreGameSideObservations: Record<string, never>;
+    listPreGameSides: Record<string, never>;
     listSharpMoneyFlows: Record<string, never>;
     listSmartMoneyFlows: Record<string, never>;
     listSportsEdgeObservations: Record<string, never>;
     listSportsEdgeSignals: Record<string, never>;
+    listSuspiciousTrades: Record<string, never>;
     listTrendingWallets: Record<string, never>;
     listWebhookDeliveries: {
         /** Webhook endpoint id owned by the authenticated API key user. */
@@ -3080,8 +3554,10 @@ export interface OperationBody {
     getApiDiscovery: never;
     getDailyReportSnapshot: never;
     getEventReplaySince: never;
+    getGame: never;
     getHealth: never;
     getInsiderRadarFlag: never;
+    getLargeTrade: never;
     getMarketCandles: never;
     getMarketContextMarkdown: never;
     getMarketHolders: never;
@@ -3096,6 +3572,7 @@ export interface OperationBody {
     getPositionTimelineById: never;
     getReports: never;
     getStream: never;
+    getSuspiciousTrade: never;
     getTrader: never;
     getTraderCategoryRecords: never;
     getTraderContext: never;
@@ -3107,14 +3584,22 @@ export interface OperationBody {
     getWebhook: never;
     getWeeklyReportSnapshot: never;
     getWhaleTrade: never;
+    listGames: never;
     listInsiderRadar: never;
     listLargePositions: never;
+    listLargeTradeCounterpartyExecutions: never;
+    listLargeTradeCounterpartyMakers: never;
+    listLargeTradeHistory: never;
+    listLargeTrades: never;
     listLeaderboard: never;
     listPositions: never;
+    listPreGameSideObservations: never;
+    listPreGameSides: never;
     listSharpMoneyFlows: never;
     listSmartMoneyFlows: never;
     listSportsEdgeObservations: never;
     listSportsEdgeSignals: never;
+    listSuspiciousTrades: never;
     listTrendingWallets: never;
     listWebhookDeliveries: never;
     listWebhookEvents: never;
@@ -3206,6 +3691,13 @@ export interface OperationResponse {
         next_cursor: string;
         meta: EventReplayMeta;
     };
+    getGame: {
+        object: "game";
+        data: OperationData["getGame"];
+        /** When this read assembled the catalog. Per-source vintage is on freshness. */
+        as_of: string;
+        meta: ResponseMeta;
+    };
     getHealth: {
         object: "health";
         data: OperationData["getHealth"];
@@ -3216,6 +3708,11 @@ export interface OperationResponse {
         data: OperationData["getInsiderRadarFlag"];
         meta: ResponseMeta;
     };
+    getLargeTrade: {
+        object: "large_trade";
+        data: OperationData["getLargeTrade"];
+        meta: ResponseMeta;
+    };
     getMarketCandles: {
         object: "market_candles";
         data: OperationData["getMarketCandles"];
@@ -3294,6 +3791,11 @@ export interface OperationResponse {
         meta: ResponseMeta;
     };
     getStream: string;
+    getSuspiciousTrade: {
+        object: "suspicious_trade";
+        data: OperationData["getSuspiciousTrade"];
+        meta: ResponseMeta;
+    };
     getTrader: {
         object: "trader";
         data: OperationData["getTrader"];
@@ -3337,6 +3839,17 @@ export interface OperationResponse {
         data: OperationData["getWhaleTrade"];
         meta: ResponseMeta;
     };
+    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. */
+        as_of: string;
+        coverage: GamesCoverage;
+        meta: ResponseMeta;
+    };
     listInsiderRadar: {
         object: "list";
         data: OperationData["listInsiderRadar"];
@@ -3356,6 +3869,34 @@ export interface OperationResponse {
         total?: number;
         meta: ResponseMeta;
     };
+    listLargeTradeCounterpartyExecutions: {
+        object: "counterparty_analysis";
+        data: OperationData["listLargeTradeCounterpartyExecutions"];
+        meta: ResponseMeta;
+    };
+    listLargeTradeCounterpartyMakers: {
+        object: "counterparty_maker_page";
+        data: OperationData["listLargeTradeCounterpartyMakers"];
+        meta: ResponseMeta;
+    };
+    listLargeTradeHistory: {
+        object: "list";
+        data: OperationData["listLargeTradeHistory"];
+        has_more: boolean;
+        next_cursor?: string;
+        /** Total matching rows when the read model exposes a count; the key is absent when it does not. */
+        total?: number;
+        meta: LargeTradeHistoryMeta;
+    };
+    listLargeTrades: {
+        object: "list";
+        data: OperationData["listLargeTrades"];
+        has_more: boolean;
+        next_cursor?: string;
+        /** Total matching rows when the read model exposes a count; absent (or null) when it does not. */
+        total?: number;
+        meta: ResponseMeta;
+    };
     listLeaderboard: {
         object: "list";
         data: OperationData["listLeaderboard"];
@@ -3374,6 +3915,26 @@ export interface OperationResponse {
         total?: number;
         meta: ResponseMeta;
     };
+    listPreGameSideObservations: {
+        object: "list";
+        data: OperationData["listPreGameSideObservations"];
+        has_more: boolean;
+        next_cursor?: string;
+        /** Completion time of the shared observation snapshot pinned by the cursor. */
+        snapshot_as_of: string;
+        /** True when an operational failure or unknown provider-board, holder, directional, reconciliation, or internal completeness state made this snapshot partial. This is snapshot-wide and can retain degradation that the funnel's one-terminal-per-input accounting cannot represent. Intentional bounded capacity_limited rows remain fully accounted in the funnel and do not by themselves set this field. */
+        degraded: boolean;
+        funnel: PreGameSideFunnelReport;
+        meta: ResponseMeta;
+    };
+    listPreGameSides: {
+        object: "list";
+        data: OperationData["listPreGameSides"];
+        has_more: boolean;
+        next_cursor?: string;
+        total?: number;
+        meta: ResponseMeta;
+    };
     listSharpMoneyFlows: {
         object: "list";
         data: OperationData["listSharpMoneyFlows"];
@@ -3399,7 +3960,7 @@ export interface OperationResponse {
         snapshot_as_of: string;
         /** True when an operational failure or unknown provider-board, holder, directional, reconciliation, or internal completeness state made this snapshot partial. This is snapshot-wide and can retain degradation that the funnel's one-terminal-per-input accounting cannot represent. Intentional bounded capacity_limited rows remain fully accounted in the funnel and do not by themselves set this field. */
         degraded: boolean;
-        funnel: SportsEdgeFunnelReport;
+        funnel: PreGameSideFunnelReport;
         meta: ResponseMeta;
     };
     listSportsEdgeSignals: {
@@ -3410,6 +3971,15 @@ export interface OperationResponse {
         total?: number;
         meta: ResponseMeta;
     };
+    listSuspiciousTrades: {
+        object: "list";
+        data: OperationData["listSuspiciousTrades"];
+        has_more: boolean;
+        next_cursor?: string;
+        /** Total matching rows when the read model exposes a count; the key is absent when it does not. */
+        total?: number;
+        meta: ResponseMeta;
+    };
     listTrendingWallets: {
         object: "list";
         data: OperationData["listTrendingWallets"];
@@ -3459,9 +4029,9 @@ export interface OperationResponse {
         data: OperationData["listWhaleTradeHistory"];
         has_more: boolean;
         next_cursor?: string;
-        /** Total matching rows when the read model exposes a count; the key is absent when it does not. */
+        /** Total matching rows when the read model exposes a count; absent (or null) when it does not. */
         total?: number;
-        meta: WhaleTradeHistoryMeta;
+        meta: LargeTradeHistoryMeta;
     };
     listWhaleTrades: {
         object: "list";