@0xinsider/sdk 0.32.0 → 0.36.0

package/dist/schema.d.ts

@@ -3,7 +3,8 @@ export type AccountIdentity = {
     data: {
         user_id: number;
         credential_id: number;
-        credential_kind: "api_key" | "oauth_grant";
+        /** The kind of credential that made the request: api_key is a full-access developer key, oauth_grant an OAuth access token, integration_key a named integration key with fixed scopes created on https://0xinsider.com/developers. Before integration_key was added, these keys reported oauth_grant. */
+        credential_kind: "api_key" | "oauth_grant" | "integration_key";
         /** The credential is currently valid; revoked, expired or unknown credentials are rejected. */
         credential_status: "active";
         entitlement: {
@@ -11,7 +12,7 @@ export type AccountIdentity = {
             /** When paid data access is lapsed, the caller should renew the subscription; otherwise null. */
             recovery_action: "renew_subscription" | null;
         };
-        /** Approved OAuth scopes; null for full developer-key access. */
+        /** The scopes an OAuth grant or integration key carries; null for full developer-key access. */
         scopes: string[] | null;
     };
     meta: ResponseMeta;
@@ -76,8 +77,10 @@ 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;
         freshness?: FreshnessFailure;
-        /** ADDITIVE (#7209). The specific, actionable cause behind `code`, when there is one more specific than the code itself. `code` keeps its published values, so existing clients are unaffected; new clients branch on `reason`. Omitted when the code already says everything we know. pick_not_released: no Pick of the Day is published for the current product day; schedule one request against retry_at instead of polling. unknown_endpoint: the PATH is not a route on this API -- read GET /api/v1, do not retry. trader_not_tracked: the wallet is real and the URL is right, but the trader is not on the warm sync tier (the wallets we sync most often) -- stop asking for this wallet. market_out_of_scope (404 not_found, #27303): the market or event is real and the URL is right, but 0xinsider serves sports and esports markets only -- stop asking for this market; neither a retry nor another URL for it can succeed. cursor_expired: pagination went stale mid-walk -- re-request the first page and continue. read_model_warming: the requested endpoint cannot serve its read model yet; exact causes are endpoint-specific and can include a cold or contended refresh or a dependency that prevented refresh. database_unavailable: the API's database or its connection pool is temporarily unreachable (a connection-class failure, not a query fault); code stays rate_limit_unavailable, nothing is rate-limited, retry after Retry-After / retry_at. idempotency_in_progress: retain the exact Idempotency-Key and request body, then retry shortly. webhook_delivery_in_progress: retry the URL or signing-secret configuration change after the destination's active request completes. request_accounting_unavailable: accounting capacity is unavailable before the handler executes; retry after Retry-After / retry_at. sandbox_api_key: the credential is a sandbox key (oxi_sk_test_) from POST /api/v1/agents/register, which only the sandbox server accepts -- call the sandbox base URL with it, or get a live key or OAuth access token; do not retry it here. api_key_in_query: the key was sent as a ?token= query parameter, which no route reads because URLs land in logs and history; the key itself was not checked -- resend it as Authorization: Bearer. subscription_inactive: the key is valid but the account's Pro subscription has lapsed (402 subscription_required); permanent until a person reactivates at https://0xinsider.com/billing, which the message names -- stop retrying on a schedule and surface the link. The key owner is emailed once per lapse. monthly_quota_exceeded: the account has used the requests its plan includes for the UTC calendar month (429 rate_limited); retry_at and Retry-After name the first of next month, the only retry that can succeed, and the message names https://0xinsider.com/developers, where pay as you go for requests over the quota is turned on. The X-Monthly-Quota-Limit, X-Monthly-Quota-Remaining and X-Monthly-Quota-Reset headers on every authenticated response say how close the account is. invalid_query, invalid_path, invalid_body (400 bad_request, #16146): a query parameter, a path segment or the JSON body did not parse or does not fit the route's schema, so no handler ran; param names the field when the parser named one (a query key, a path segment, a JSON path such as traders[0], or body); fix the request, never retry it as sent. unsupported_media_type (415 bad_request, param content-type): send the body with Content-Type: application/json. payload_too_large (413 bad_request, param body): the body is over 1048576 bytes. method_not_allowed (405 bad_request): the path is a route but not with this method; the Allow header names the methods it serves. ip_rate_limited (429 rate_limited, #16380): the per-address budget every caller behind one IP shares, counted before authentication, is spent; not the key's own window, and the RateLimit-* headers describe that bucket. ip_throttled (429 rate_limited): the address is in a cooldown after sustained over-limit traffic; Retry-After is minutes to days, and a request before it does not shorten the cooldown. cold_read_limited (429 rate_limited, #28752): the account has used its share of cold reads on GET /api/v1/market/{condition_id}/holders, requests for a market whose roster is not cached, each of which walks Polymarket (6 a minute, in bursts of up to 400); not the per-minute window, so a cached market still answers, and the next cold read is admitted at Retry-After. max_plan_required (403 forbidden, #23085): the key is valid and its account is on Pro, but the route is part of Max (GET /api/v1/edge-hunter); every Pro route keeps working with the same key, so do not disable it. The message names https://0xinsider.com/pricing, where the account upgrades; a retry never clears it. endpoint_retired (410): this legacy sports endpoint no longer serves data. Migrate to GET /api/v1/edge-hunter; retrying the retired path cannot succeed. */
-        reason?: "cursor_expired" | "unknown_endpoint" | "pick_not_released" | "trader_not_tracked" | "market_out_of_scope" | "read_model_warming" | "database_unavailable" | "request_accounting_unavailable" | "idempotency_in_progress" | "webhook_delivery_in_progress" | "webhook_secret_rotation_not_prepared" | "webhook_secret_rotation_overlap_active" | "sandbox_api_key" | "api_key_in_query" | "subscription_inactive" | "monthly_quota_exceeded" | "invalid_query" | "unknown_query_parameter" | "invalid_path" | "invalid_body" | "unsupported_media_type" | "payload_too_large" | "method_not_allowed" | "ip_rate_limited" | "ip_throttled" | "cold_read_limited" | "export_expired" | "freshness_ceiling_unsatisfied" | "max_plan_required" | "endpoint_retired";
+        /** Where a person clears this 402 (#32592): pays the overdue invoice (reason payment_overdue) or reactivates the plan (reason subscription_inactive). Present on every 402 subscription_required, omitted on every other error. The message names the same URL; link this field instead of parsing the message. */
+        billing_url?: 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 not on the warm sync tier (the wallets we sync most often) -- stop asking for this wallet. market_out_of_scope (404 not_found, #27303): the market or event is real and the URL is right, but 0xinsider serves sports and esports markets only -- stop asking for this market; neither a retry nor another URL for it can succeed. cursor_expired: pagination went stale mid-walk -- re-request the first page and continue. read_model_warming: the requested endpoint cannot serve its read model yet; exact causes are endpoint-specific and can include a cold or contended refresh or a dependency that prevented refresh. database_unavailable: the API's database or its connection pool is temporarily unreachable (a connection-class failure, not a query fault); code stays rate_limit_unavailable, nothing is rate-limited, retry after Retry-After / retry_at. idempotency_in_progress: retain the exact Idempotency-Key and request body, then retry shortly. webhook_delivery_in_progress: retry the URL or signing-secret configuration change after the destination's active request completes. request_accounting_unavailable: accounting capacity is unavailable before the handler executes; retry after Retry-After / retry_at. sandbox_api_key: the credential is a sandbox key (oxi_sk_test_) from POST /api/v1/agents/register, which only the sandbox server accepts -- call the sandbox base URL with it, or get a live key or OAuth access token; do not retry it here. api_key_in_query: the key was sent as a ?token= query parameter, which no route reads because URLs land in logs and history; the key itself was not checked -- resend it as Authorization: Bearer. subscription_inactive: the key is valid but the account's Pro subscription has lapsed (402 subscription_required); permanent until a person reactivates at https://0xinsider.com/billing, which the message names -- stop retrying on a schedule and surface the link. The key owner is emailed once per lapse. payment_overdue (402 subscription_required, #32592): the key is valid and the account still has its plan, but its latest subscription invoice is unpaid (Stripe past_due or unpaid), so paid access is paused; permanent until a person pays at billing_url (https://0xinsider.com/billing) -- stop retrying on a schedule and surface the link. The key works again the moment the invoice is paid. GET /api/v1/me and GET /api/v1/usage keep answering. monthly_quota_exceeded: the account has used the requests its plan includes for the UTC calendar month (429 rate_limited); retry_at and Retry-After name the first of next month, the only retry that can succeed, and the message names https://0xinsider.com/developers, where pay as you go for requests over the quota is turned on. The X-Monthly-Quota-Limit, X-Monthly-Quota-Remaining and X-Monthly-Quota-Reset headers on every authenticated response say how close the account is. invalid_query, invalid_path, invalid_body (400 bad_request, #16146): a query parameter, a path segment or the JSON body did not parse or does not fit the route's schema, so no handler ran; param names the field when the parser named one (a query key, a path segment, a JSON path such as traders[0], or body); fix the request, never retry it as sent. unsupported_media_type (415 bad_request, param content-type): send the body with Content-Type: application/json. payload_too_large (413 bad_request, param body): the body is over 1048576 bytes. method_not_allowed (405 bad_request): the path is a route but not with this method; the Allow header names the methods it serves. ip_rate_limited (429 rate_limited, #16380): the per-address budget every caller behind one IP shares, counted before authentication, is spent; not the key's own window, and the RateLimit-* headers describe that bucket. ip_throttled (429 rate_limited): the address is in a cooldown after sustained over-limit traffic; Retry-After is minutes to days, and a request before it does not shorten the cooldown. cold_read_limited (429 rate_limited, #28752): the account has used its share of cold reads on GET /api/v1/market/{condition_id}/holders, requests for a market whose roster is not cached, each of which walks Polymarket (6 a minute, in bursts of up to 400); not the per-minute window, so a cached market still answers, and the next cold read is admitted at Retry-After. max_plan_required (403 forbidden, #23085): the key is valid and its account is on Pro, but the route is part of Max (GET /api/v1/edge-hunter); every Pro route keeps working with the same key, so do not disable it. The message names https://0xinsider.com/pricing, where the account upgrades; a retry never clears it. endpoint_retired (410): this legacy sports endpoint no longer serves data. Migrate to GET /api/v1/edge-hunter; retrying the retired path cannot succeed. */
+        reason?: "cursor_expired" | "unknown_endpoint" | "pick_not_released" | "trader_not_tracked" | "market_out_of_scope" | "read_model_warming" | "database_unavailable" | "request_accounting_unavailable" | "idempotency_in_progress" | "webhook_delivery_in_progress" | "webhook_secret_rotation_not_prepared" | "webhook_secret_rotation_overlap_active" | "sandbox_api_key" | "api_key_in_query" | "subscription_inactive" | "payment_overdue" | "monthly_quota_exceeded" | "invalid_query" | "unknown_query_parameter" | "invalid_path" | "invalid_body" | "unsupported_media_type" | "payload_too_large" | "method_not_allowed" | "ip_rate_limited" | "ip_throttled" | "cold_read_limited" | "export_expired" | "freshness_ceiling_unsatisfied" | "max_plan_required" | "endpoint_retired";
     };
     meta: ResponseMeta;
 };
@@ -90,8 +93,18 @@ 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, the recommendation is advisory and can change before a pick becomes available. Schedule the next request from the returned value instead of inferring a release schedule or polling. Prefer Retry-After for the duration because it is immune to client clock skew. */
     retry_at?: string;
     freshness?: FreshnessFailure;
-    /** ADDITIVE (#7209). The specific, actionable cause behind `code`, when there is one more specific than the code itself. `code` keeps its published values, so existing clients are unaffected; new clients branch on `reason`. Omitted when the code already says everything we know. pick_not_released: no Pick of the Day is published for the current product day; schedule one request against retry_at instead of polling. unknown_endpoint: the PATH is not a route on this API -- read GET /api/v1, do not retry. trader_not_tracked: the wallet is real and the URL is right, but the trader is not on the warm sync tier (the wallets we sync most often) -- stop asking for this wallet. market_out_of_scope (404 not_found, #27303): the market or event is real and the URL is right, but 0xinsider serves sports and esports markets only -- stop asking for this market; neither a retry nor another URL for it can succeed. cursor_expired: pagination went stale mid-walk -- re-request the first page and continue. read_model_warming: the requested endpoint cannot serve its read model yet; exact causes are endpoint-specific and can include a cold or contended refresh or a dependency that prevented refresh. database_unavailable: the API's database or its connection pool is temporarily unreachable (a connection-class failure, not a query fault); code stays rate_limit_unavailable, nothing is rate-limited, retry after Retry-After / retry_at. idempotency_in_progress: retain the exact Idempotency-Key and request body, then retry shortly. webhook_delivery_in_progress: retry the URL or signing-secret configuration change after the destination's active request completes. request_accounting_unavailable: accounting capacity is unavailable before the handler executes; retry after Retry-After / retry_at. sandbox_api_key: the credential is a sandbox key (oxi_sk_test_) from POST /api/v1/agents/register, which only the sandbox server accepts -- call the sandbox base URL with it, or get a live key or OAuth access token; do not retry it here. api_key_in_query: the key was sent as a ?token= query parameter, which no route reads because URLs land in logs and history; the key itself was not checked -- resend it as Authorization: Bearer. subscription_inactive: the key is valid but the account's Pro subscription has lapsed (402 subscription_required); permanent until a person reactivates at https://0xinsider.com/billing, which the message names -- stop retrying on a schedule and surface the link. The key owner is emailed once per lapse. monthly_quota_exceeded: the account has used the requests its plan includes for the UTC calendar month (429 rate_limited); retry_at and Retry-After name the first of next month, the only retry that can succeed, and the message names https://0xinsider.com/developers, where pay as you go for requests over the quota is turned on. The X-Monthly-Quota-Limit, X-Monthly-Quota-Remaining and X-Monthly-Quota-Reset headers on every authenticated response say how close the account is. invalid_query, invalid_path, invalid_body (400 bad_request, #16146): a query parameter, a path segment or the JSON body did not parse or does not fit the route's schema, so no handler ran; param names the field when the parser named one (a query key, a path segment, a JSON path such as traders[0], or body); fix the request, never retry it as sent. unsupported_media_type (415 bad_request, param content-type): send the body with Content-Type: application/json. payload_too_large (413 bad_request, param body): the body is over 1048576 bytes. method_not_allowed (405 bad_request): the path is a route but not with this method; the Allow header names the methods it serves. ip_rate_limited (429 rate_limited, #16380): the per-address budget every caller behind one IP shares, counted before authentication, is spent; not the key's own window, and the RateLimit-* headers describe that bucket. ip_throttled (429 rate_limited): the address is in a cooldown after sustained over-limit traffic; Retry-After is minutes to days, and a request before it does not shorten the cooldown. cold_read_limited (429 rate_limited, #28752): the account has used its share of cold reads on GET /api/v1/market/{condition_id}/holders, requests for a market whose roster is not cached, each of which walks Polymarket (6 a minute, in bursts of up to 400); not the per-minute window, so a cached market still answers, and the next cold read is admitted at Retry-After. max_plan_required (403 forbidden, #23085): the key is valid and its account is on Pro, but the route is part of Max (GET /api/v1/edge-hunter); every Pro route keeps working with the same key, so do not disable it. The message names https://0xinsider.com/pricing, where the account upgrades; a retry never clears it. endpoint_retired (410): this legacy sports endpoint no longer serves data. Migrate to GET /api/v1/edge-hunter; retrying the retired path cannot succeed. */
-    reason?: "cursor_expired" | "unknown_endpoint" | "pick_not_released" | "trader_not_tracked" | "market_out_of_scope" | "read_model_warming" | "database_unavailable" | "request_accounting_unavailable" | "idempotency_in_progress" | "webhook_delivery_in_progress" | "webhook_secret_rotation_not_prepared" | "webhook_secret_rotation_overlap_active" | "sandbox_api_key" | "api_key_in_query" | "subscription_inactive" | "monthly_quota_exceeded" | "invalid_query" | "unknown_query_parameter" | "invalid_path" | "invalid_body" | "unsupported_media_type" | "payload_too_large" | "method_not_allowed" | "ip_rate_limited" | "ip_throttled" | "cold_read_limited" | "export_expired" | "freshness_ceiling_unsatisfied" | "max_plan_required" | "endpoint_retired";
+    /** Where a person clears this 402 (#32592): pays the overdue invoice (reason payment_overdue) or reactivates the plan (reason subscription_inactive). Present on every 402 subscription_required, omitted on every other error. The message names the same URL; link this field instead of parsing the message. */
+    billing_url?: 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 not on the warm sync tier (the wallets we sync most often) -- stop asking for this wallet. market_out_of_scope (404 not_found, #27303): the market or event is real and the URL is right, but 0xinsider serves sports and esports markets only -- stop asking for this market; neither a retry nor another URL for it can succeed. cursor_expired: pagination went stale mid-walk -- re-request the first page and continue. read_model_warming: the requested endpoint cannot serve its read model yet; exact causes are endpoint-specific and can include a cold or contended refresh or a dependency that prevented refresh. database_unavailable: the API's database or its connection pool is temporarily unreachable (a connection-class failure, not a query fault); code stays rate_limit_unavailable, nothing is rate-limited, retry after Retry-After / retry_at. idempotency_in_progress: retain the exact Idempotency-Key and request body, then retry shortly. webhook_delivery_in_progress: retry the URL or signing-secret configuration change after the destination's active request completes. request_accounting_unavailable: accounting capacity is unavailable before the handler executes; retry after Retry-After / retry_at. sandbox_api_key: the credential is a sandbox key (oxi_sk_test_) from POST /api/v1/agents/register, which only the sandbox server accepts -- call the sandbox base URL with it, or get a live key or OAuth access token; do not retry it here. api_key_in_query: the key was sent as a ?token= query parameter, which no route reads because URLs land in logs and history; the key itself was not checked -- resend it as Authorization: Bearer. subscription_inactive: the key is valid but the account's Pro subscription has lapsed (402 subscription_required); permanent until a person reactivates at https://0xinsider.com/billing, which the message names -- stop retrying on a schedule and surface the link. The key owner is emailed once per lapse. payment_overdue (402 subscription_required, #32592): the key is valid and the account still has its plan, but its latest subscription invoice is unpaid (Stripe past_due or unpaid), so paid access is paused; permanent until a person pays at billing_url (https://0xinsider.com/billing) -- stop retrying on a schedule and surface the link. The key works again the moment the invoice is paid. GET /api/v1/me and GET /api/v1/usage keep answering. monthly_quota_exceeded: the account has used the requests its plan includes for the UTC calendar month (429 rate_limited); retry_at and Retry-After name the first of next month, the only retry that can succeed, and the message names https://0xinsider.com/developers, where pay as you go for requests over the quota is turned on. The X-Monthly-Quota-Limit, X-Monthly-Quota-Remaining and X-Monthly-Quota-Reset headers on every authenticated response say how close the account is. invalid_query, invalid_path, invalid_body (400 bad_request, #16146): a query parameter, a path segment or the JSON body did not parse or does not fit the route's schema, so no handler ran; param names the field when the parser named one (a query key, a path segment, a JSON path such as traders[0], or body); fix the request, never retry it as sent. unsupported_media_type (415 bad_request, param content-type): send the body with Content-Type: application/json. payload_too_large (413 bad_request, param body): the body is over 1048576 bytes. method_not_allowed (405 bad_request): the path is a route but not with this method; the Allow header names the methods it serves. ip_rate_limited (429 rate_limited, #16380): the per-address budget every caller behind one IP shares, counted before authentication, is spent; not the key's own window, and the RateLimit-* headers describe that bucket. ip_throttled (429 rate_limited): the address is in a cooldown after sustained over-limit traffic; Retry-After is minutes to days, and a request before it does not shorten the cooldown. cold_read_limited (429 rate_limited, #28752): the account has used its share of cold reads on GET /api/v1/market/{condition_id}/holders, requests for a market whose roster is not cached, each of which walks Polymarket (6 a minute, in bursts of up to 400); not the per-minute window, so a cached market still answers, and the next cold read is admitted at Retry-After. max_plan_required (403 forbidden, #23085): the key is valid and its account is on Pro, but the route is part of Max (GET /api/v1/edge-hunter); every Pro route keeps working with the same key, so do not disable it. The message names https://0xinsider.com/pricing, where the account upgrades; a retry never clears it. endpoint_retired (410): this legacy sports endpoint no longer serves data. Migrate to GET /api/v1/edge-hunter; retrying the retired path cannot succeed. */
+    reason?: "cursor_expired" | "unknown_endpoint" | "pick_not_released" | "trader_not_tracked" | "market_out_of_scope" | "read_model_warming" | "database_unavailable" | "request_accounting_unavailable" | "idempotency_in_progress" | "webhook_delivery_in_progress" | "webhook_secret_rotation_not_prepared" | "webhook_secret_rotation_overlap_active" | "sandbox_api_key" | "api_key_in_query" | "subscription_inactive" | "payment_overdue" | "monthly_quota_exceeded" | "invalid_query" | "unknown_query_parameter" | "invalid_path" | "invalid_body" | "unsupported_media_type" | "payload_too_large" | "method_not_allowed" | "ip_rate_limited" | "ip_throttled" | "cold_read_limited" | "export_expired" | "freshness_ceiling_unsatisfied" | "max_plan_required" | "endpoint_retired";
+};
+export type BatchGameHoldersItem = {
+    /** Zero-based request index. Duplicate inputs keep separate result rows. */
+    index: number;
+    input: string;
+    status: "ok" | "error";
+    data?: GameHoldersItem;
+    error?: ApiErrorBody;
 };
 export type BatchMarketFlowItem = {
     /** Zero-based request index. Duplicate inputs keep separate result rows. */
@@ -141,6 +154,22 @@ export type Candle = {
     /** Close price in provider [0, 1] units (last observed point in the bucket). */
     c: number;
 };
+export type CategoryLeader = {
+    address: string;
+    as_of: string;
+    category: string;
+    edge_lower_bound: number | null;
+    grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+    id: string;
+    independent_events: number;
+    n_resolved: number | null;
+    platform: "polymarket";
+    pnl: number | null;
+    rank: number;
+    unresolved_events: number;
+    username: string | null;
+    win_rate: number | null;
+};
 /** Model-wide readiness, read in the same database snapshot as category_records. Individual category rows retain their own status. */
 export type CategorySkillModelReadiness = {
     status: "live" | "insufficient" | "stale" | "unknown" | "degraded";
@@ -267,8 +296,6 @@ export type ComboFillsResponse = {
     /** Continuation offset for largest or payout ordering. */
     next_offset?: number;
     meta: ResponseMeta;
-    /** Not computed for combo fill pages; omitted. */
-    total?: number;
 };
 export type ComboLeg = {
     leg_index: number;
@@ -450,10 +477,10 @@ export type CreateWebhookVerificationAttemptRequest = {
     /** The original one-time token returned by webhook creation or a URL change. Sent only in the request body and signed receiver challenge. */
     verification_token: string;
 };
-/** Compact data age and coverage for a response body, always present on the operations that publish it. Read status and as_of to decide whether to use the body at all, and field_groups to see which part is weak. Everything here comes from stored observation clocks, so a cached body reports the same ages a freshly computed one does: meta.cached and meta.cache_age_s stay the only transport-time facts and neither makes this block newer. The per-field audit object is still available through expand=trust; this is the default summary of the same question. */
+/** Compact data age and coverage for a response body, always present on the operations that publish it. Read status and as_of to decide whether to use the body at all, and field_groups to see which part is weak. Everything here comes from stored observation clocks, and each clocked group is judged against its writer's budget when the body is served, so a cached body reports the same ages and verdicts a freshly computed one does: meta.cached and meta.cache_age_s stay the only transport-time facts and neither makes this block newer. The per-field audit object is still available through expand=trust; this is the default summary of the same question. */
 export type DataQuality = {
-    /** fresh when every group is fresh, unavailable when every group is unavailable, and partial in every other case. */
-    status: "fresh" | "partial" | "unknown" | "untracked" | "unavailable";
+    /** fresh when every group is fresh, unavailable when every group is unavailable, stale when every group is fresh or stale and at least one is stale, and partial in every other case. */
+    status: "fresh" | "stale" | "partial" | "unknown" | "untracked" | "unavailable";
     /** The oldest as_of among the groups that carry one: the age of the weakest clock this body rests on. Omitted when no group carries a clock. */
     as_of?: string;
     /** One entry per field group. Entries may be added in later releases, so match on group rather than on position or length. */
@@ -465,12 +492,14 @@ export type DataQualityGroup = {
     group: string;
     /** The table and column that write this group, named so the verdict can be audited (for example trader_rankings.computed_at). */
     owner: string;
-    /** fresh: served, and as_of carries this group's real observation or computation clock. partial: some of the group's fields are served and some are missing. unknown: served, and this read has no clock for it, so no age may be inferred. untracked: 0xinsider does not track this group for this subject, by design. unavailable: the group could not be served. New values may be added; treat one you do not recognize as unknown. fresh means the group is tracked and clocked, not that it is inside any particular tolerance: compare as_of against your own. */
-    status: "fresh" | "partial" | "unknown" | "untracked" | "unavailable";
+    /** fresh: served, as_of carries this group's real observation or computation clock, and that clock is no older than max_age_s when the group carries one. stale: served and clocked, but as_of is older than max_age_s, so the writer has missed a refresh its schedule promises. partial: some of the group's fields are served and some are missing. unknown: served, and this read has no clock for it, so no age may be inferred. untracked: 0xinsider does not track this group for this subject, by design. unavailable: the group could not be served. New values may be added; treat one you do not recognize as unknown. Neither fresh nor stale is a tolerance for your use: compare as_of against your own. */
+    status: "fresh" | "stale" | "partial" | "unknown" | "untracked" | "unavailable";
     /** When this group's values were observed or computed. Omitted whenever the read cannot measure it, and never filled with the serialization time, the cache time, or another group's clock. */
     as_of?: string;
     /** Why the status is not fresh. Omitted when it is. */
     reason?: string;
+    /** The longest gap in seconds this group's writer leaves between refreshes on its schedule: the age past which the group reads stale instead of fresh. Omitted when the writer keeps no schedule its clock could fall behind (a clock stamped once, only on a change, or when a reader asks), and such a group is never stale. It is the writer's promise, not a tolerance for your use. */
+    max_age_s?: number;
 };
 /** The full Max-only Edge Hunter board. Defaults cover all sports and esports with B grade floor, 48-hour horizon and at most 30 rows; common selections, legacy category, min_grade and limit narrow that projection. No pagination or ETag. Rows add frozen market_context discovery metadata. */
 export type EdgeHunterBoard = {
@@ -566,7 +595,7 @@ export type EdgeHunterObservation = {
     /** 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";
     /** Which evaluation place in its sport the row took this refresh. most_held: a wider_holder place for up to 8 markets per sport kicking off within 24 hours, most graded holders first, kept until kickoff while the holder page still shows a card or could not be read; also every in_play row, whose places go most graded holders first. soonest_kickoff: a wider_holder place among the sport's 8 soonest kickoffs, which is not kept. emerging_pile rows carry their source wider_holder row's value. Filter on most_held to keep the most-held selection. most_held_48h: every row of an admission=most_held_48h response, which is that opt-in selection (up to 8 markets per sport within 48 hours, most graded holders first, recomputed every refresh), including a market a default place also evaluates; it never appears on a default response. */
-    admitted_by: "most_held" | "soonest_kickoff" | "most_held_48h";
+    admitted_by: "most_held" | "soonest_kickoff" | "most_held_48h" | "most_held_48h_by_type";
     /** Always true. This row must not be routed to an order executor. */
     observation_only: true;
     /**
@@ -604,7 +633,7 @@ export type EdgeHunterObservation = {
     provider_read_source: "cached" | "live";
     /** True only when the provider page read for each outcome token listed every holder of that token. Observation collection reads one 100-row page per token; a token with more holders stays incomplete. False means holder counts and dollar totals measure the observed positive-holder subset. sharp_pct describes that observed subset and is not a lower bound on the full-population percentage. Incomplete scans 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. A wider_holder or emerging_pile row whose holder read did not finish in the current pass may reuse that market's last pregame holder page for up to 15 minutes; an in_play row may reuse its last in-play page, read after the provider reported the game live and never before that market's own kickoff, for up to 10 minutes. Both ages are counted when the snapshot is computed. Either reuse carries that page's original time here and provider_read_source cached. A pregame market more than an hour before kickoff reuses its last page the same way until that page is 10 minutes old, and only then is read again. Once that market's own kickoff has passed, an in_play row with provider_read_source cached, a warm hit or a reuse, never carries a page read before it. Null, malformed, future, or stale holder time fails in-play closed. */
+    /** Proven provider holder observation time. A warm cache hit uses only the original provider completion time from its companion metadata, never cache-read time. A wider_holder or emerging_pile row whose holder read did not finish or failed in the current pass may reuse that market's last pregame holder page for up to 15 minutes; an in_play row may reuse its last in-play page, read after the provider reported the game live and never before that market's own kickoff, for up to 10 minutes. Both ages are counted when the snapshot is computed. Either reuse carries that page's original time here and provider_read_source cached. A pregame market more than an hour before kickoff reuses its last page the same way until that page is 10 minutes old, and only then is read again; while that market has had no trade since the page, it keeps reusing the page until it is 30 minutes old. Once that market's own kickoff has passed, an in_play row with provider_read_source cached, a warm hit or a reuse, never carries a page read before it. 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";
@@ -649,14 +678,14 @@ export type EdgeHunterObservationDeparture = {
     /** Canonical sport bucket the departed card carried. */
     category: "Basketball" | "Football" | "Baseball" | "Hockey" | "MMA" | "Boxing" | "Soccer" | "Cricket" | "Golf" | "Tennis" | "Esports" | "Racing" | "Table Tennis" | "Pickleball";
     /** The departed card's admitted_by: most_held_48h on an admission=most_held_48h response. */
-    admitted_by: "most_held" | "soonest_kickoff" | "most_held_48h";
+    admitted_by: "most_held" | "soonest_kickoff" | "most_held_48h" | "most_held_48h_by_type";
     /** Kickoff the departed card carried, in UTC. The entry leaves the list once it passes. */
     game_start_time: string;
     /** The departed card's observed_at: when its last evaluation finished. */
     last_observed_at: string;
     /** snapshot_as_of of the first snapshot of this selection without the card. */
     departed_at: string;
-    /** Why the market has no card: its terminal in this selection's funnel in the snapshot it left, and while that terminal reports a read that did not finish (holder_deadline_unavailable, provider_unavailable, holder_computation_unavailable, internal_unclassified), the terminal of each later snapshot until one answers; an answered reason never changes. primary_slate_candidate: the market joined the funded slate, which view=signals covers. capacity_limited: it lost its evaluation place without another outcome. missing_stored_market: the market was no longer in the stored market universe. Any other value means what it means in the funnel, for example split_holder_pile, no_current_graded_holder or resolved. */
+    /** Why the market has no card: its terminal in this selection's funnel in the snapshot it left, and while that terminal reports a read that did not finish (holder_deadline_unavailable, provider_unavailable, holder_computation_unavailable, internal_unclassified), the terminal of each later snapshot until one answers; an answered reason stays, except as view=signals starts or stops listing the market. primary_slate_candidate: view=signals lists the market. While the entry stays, a later snapshot that read view=signals and no longer excludes the market replaces it with that snapshot's terminal, one that excludes the market replaces any other reason with it, and one with signals_as_of null leaves it as it is. capacity_limited: it lost its evaluation place without another outcome. missing_stored_market: the market was no longer in the stored market universe. Any other value means what it means in the funnel, for example split_holder_pile, no_current_graded_holder or resolved. */
     reason: EdgeHunterObservationTerminalReason;
 };
 /** Full Edge Hunter observations list envelope. Required degradation_reasons explains the source-generation verdict; required coverage distinguishes source input, intentional capacity exclusions, source emissions, incomplete holder scans, selection and the returned page. The view literal distinguishes advanced collections, including empty pages. */
@@ -679,11 +708,13 @@ export type EdgeHunterObservationsResponse = {
     /** Normalized axes requested with a selector or category; omitted on an unselected default read. */
     selection?: EdgeHunterSelection;
     /** Echoes the opt-in admission rule a request named; omitted on a default read. When present, data, funnel, coverage, degraded and degradation_reasons describe that selection, not the default one. */
-    admission?: "most_held_48h";
-    /** cohort=wider_holder only, for the default selection and for admission=most_held_48h: markets that had a wider_holder card in an earlier snapshot of the same selection, have none in this one, and have not kicked off. Newest departed_at first. An entry stays until the game_start_time it carries passes, and leaves as soon as the market has a card again; while it stays only a reason that reports an unfinished read changes (see reason), and a later departure of the same market is a new entry. Filtered by the same category and selectors as data, and identical on every page of one snapshot. At most 336 entries; when more are open, the oldest departures leave first. An empty array means no card of this selection is departed. Omitted on in_play and emerging_pile, and on a snapshot that could not establish its departures, never reported as an empty array. Tracking that restarts after its record is lost starts empty. */
+    admission?: "most_held_48h" | "most_held_48h_by_type";
+    /** cohort=wider_holder only, for the default selection and for admission=most_held_48h: markets that had a wider_holder card in an earlier snapshot of the same selection, have none in this one, and have not kicked off. Newest departed_at first. An entry stays until the game_start_time it carries passes, and leaves as soon as the market has a card again; while it stays, its reason changes only while it reports an unfinished read or when view=signals starts or stops listing the market (see reason), and a later departure of the same market is a new entry. Filtered by the same category and selectors as data, and identical on every page of one snapshot. At most 336 entries; when more are open, the oldest departures leave first. An empty array means no card of this selection is departed. Omitted on in_play and emerging_pile, and on a snapshot that could not establish its departures, never reported as an empty array. Tracking that restarts after its record is lost starts empty. */
     departures?: EdgeHunterObservationDeparture[];
+    /** The ranked_at of the view=signals snapshot whose listed markets this snapshot excluded from wider_holder as primary_slate_candidate. The refresh that computed this snapshot read it as it started, so it can be one refresh older than the view=signals snapshot a reader sees at the same moment. null when no view=signals snapshot could be read: that refresh excluded no market, and the funnel counts no primary_slate_candidate. Omitted on an unmappable legacy category, which reads no generation. */
+    signals_as_of?: string | null;
 };
-/** Closed 25-value terminal-reason vocabulary for the accountable Edge Hunter 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. */
+/** Closed 25-value terminal-reason vocabulary for the accountable Edge Hunter 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 a holder read sent to the provider that failed, with no reusable holder page; holder_deadline_unavailable is holder cache/provider absolute-deadline exhaustion or a holder read local capacity never sent, with no reusable holder page. */
 export type EdgeHunterObservationTerminalReason = "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 provider outcome in fixed YES/NO order, including its frozen token identity and independently observed quote. Null current_price means no verified current quote is available. */
 export type EdgeHunterOutcome = {
@@ -703,6 +734,8 @@ export type EdgeHunterParticipant = {
     headshot_revision?: number;
     tour?: string;
     name: string;
+    logo_mark_light?: boolean;
+    logo_mark_measured?: boolean;
 };
 export type EdgeHunterPrice = {
     /** Provider probability as a decimal string. Keep its precision until display. */
@@ -878,15 +911,15 @@ export type EdgeHunterSportFunnelReport = {
     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. */
+    /** Whether every configured upcoming-board scope completed as available. False with board_upcoming_configured=false means not applicable. When board_upcoming_configured is true and this flag is false, read board_upcoming_status for the cause (unknown means no cause was recorded, which no computed snapshot reports): the board_source_unavailable and board_deadline_unavailable terminals are assigned only to already-started rows (the live half) and are structurally 0 for the upcoming source, so they never explain this flag. */
     board_upcoming_available: boolean;
-    /** Why the upcoming-board source is (un)available. Board supply is one canonical-sport union: the bare category owns live truth and every configured composed league scope contributes upcoming rows; folded leagues without a configured board (currently NCAAB and CFL) are not in the upcoming union. available: every configured scope completed truthfully (a successful empty schedule still counts). capacity_limited: provider pagination or a configured upcoming cache published an intentionally bounded complete-event prefix; those rows are excluded from diagnostic-universe input and must not be treated as a complete upcoming universe. Cache-bound prefixes are limited to an exact 5,000,000-byte final envelope. source_unavailable: composition failed before a truthful union; resolved scope readers turn half failures into cold_unavailable, so fresh producers are whole-union identity reconciliation or a registry contract failure and carry zero rows. cold_unavailable: every scope completed but at least one reported its upcoming half unavailable because no servable entry was inside the stale-serve bound and the background warm did not land in time; it is not by itself proof of a provider outage. deadline_unavailable: an internal configured-scope deadline or the outer bounded fair wave expired. An internal deadline may retain healthy bare-category or sibling-scope rows; the outer wave records zero rows. These upcoming fields do not describe league live-membership availability. If the bare-category live scope fails, all live rows are dropped even when a league scope completed, because the bare category is the sole live-truth owner. not_configured: no upcoming scope applies to the sport. unknown: 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. */
+    /** Why the upcoming-board source is (un)available. Board supply is one canonical-sport union: the bare category owns live truth and every configured composed league scope contributes upcoming rows; folded leagues without a configured board (currently CFL) are not in the upcoming union. available: every configured scope completed truthfully (a successful empty schedule still counts). capacity_limited: provider pagination or a configured upcoming cache published an intentionally bounded complete-event prefix; those rows are excluded from diagnostic-universe input and must not be treated as a complete upcoming universe. Cache-bound prefixes are limited to an exact 5,000,000-byte final envelope. source_unavailable: composition failed before a truthful union; resolved scope readers turn half failures into cold_unavailable, so fresh producers are whole-union identity reconciliation or a registry contract failure and carry zero rows. cold_unavailable: every scope completed but at least one reported its upcoming half unavailable because no servable entry was inside the stale-serve bound and the background warm did not land in time; it is not by itself proof of a provider outage. deadline_unavailable: an internal configured-scope deadline or the outer bounded fair wave expired. An internal deadline may retain healthy bare-category or sibling-scope rows; the outer wave records zero rows. These upcoming fields do not describe league live-membership availability. If the bare-category live scope fails, all live rows are dropped even when a league scope completed, because the bare category is the sole live-truth owner. not_configured: no upcoming scope applies to the sport. unknown: no cause was recorded; every computed snapshot reports a concrete status, so none reads unknown. board_upcoming_available is exactly board_upcoming_status == available. */
     board_upcoming_status: "unknown" | "not_configured" | "available" | "capacity_limited" | "source_unavailable" | "cold_unavailable" | "deadline_unavailable";
-    /** Configured upcoming scopes that did not complete as available. Values are category, a provider league tag slug (nfl, cfb, nba, wnba, euroleague-basketball, nhl, mls, valorant, league-of-legends, counter-strike-2, or dota-2), registry when the compiled scope/projection contract drifted, union when cross-scope identity reconciliation failed, or wave when the outer fair-wave deadline expired before scope-level evidence returned. Empty means no unavailable upcoming scope was identified; this includes healthy/not-configured rows and a legacy cached row. Observation league scopes are upcoming-only and perform no live-membership read. */
-    board_upcoming_unavailable_scopes: ("category" | "nfl" | "cfb" | "nba" | "wnba" | "euroleague-basketball" | "nhl" | "mls" | "valorant" | "league-of-legends" | "counter-strike-2" | "dota-2" | "registry" | "union" | "wave")[];
+    /** Configured upcoming scopes that did not complete as available. Values are category, a provider league tag slug (nfl, cfb, nba, wnba, euroleague-basketball, ncaa-basketball, cwbb, nhl, mls, valorant, league-of-legends, counter-strike-2, or dota-2), registry when the compiled scope/projection contract drifted, union when cross-scope identity reconciliation failed, or wave when the outer fair-wave deadline expired before scope-level evidence returned. Empty means no unavailable upcoming scope was identified; this includes healthy/not-configured rows and a legacy cached row. Observation league scopes are upcoming-only and perform no live-membership read. */
+    board_upcoming_unavailable_scopes: ("category" | "nfl" | "cfb" | "nba" | "wnba" | "euroleague-basketball" | "ncaa-basketball" | "cwbb" | "nhl" | "mls" | "valorant" | "league-of-legends" | "counter-strike-2" | "dota-2" | "registry" | "union" | "wave")[];
     /** Stored-universe rows plus provider-board rows missing from storage. */
     input: number;
-    /** Sparse counts over the closed 25-value terminal vocabulary: outside_horizon, resolved, provider_closed, provider_excluded, invalid_market, missing_token, missing_stored_market, not_provider_live, board_source_unavailable, board_deadline_unavailable, primary_slate_candidate, zero_indexed_holder_research, capacity_limited, provider_unavailable, holder_deadline_unavailable, holder_computation_unavailable, holder_scan_incomplete, no_current_graded_holder, split_holder_pile, price_unavailable, wider_holder_emitted, in_play_emitted, in_play_stale_observed, in_play_directional_unavailable, or internal_unclassified. primary_slate_candidate means 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. */
+    /** Sparse counts over the closed 25-value terminal vocabulary: outside_horizon, resolved, provider_closed, provider_excluded, invalid_market, missing_token, missing_stored_market, not_provider_live, board_source_unavailable, board_deadline_unavailable, primary_slate_candidate, zero_indexed_holder_research, capacity_limited, provider_unavailable, holder_deadline_unavailable, holder_computation_unavailable, holder_scan_incomplete, no_current_graded_holder, split_holder_pile, price_unavailable, wider_holder_emitted, in_play_emitted, in_play_stale_observed, in_play_directional_unavailable, or internal_unclassified. primary_slate_candidate means the view=signals snapshot named by signals_as_of lists the market at its widest selection (horizon_hours=48, min_grade=B, no selector), so it is not a wider_holder candidate; when no view=signals snapshot could be read (signals_as_of null), no market takes it. capacity_limited is intentional bounded provider-work admission, is fully accounted here, and does not itself set degraded=true. board_source_unavailable means a completed board source was unavailable; board_deadline_unavailable means live-board work missed either an internal configured-scope deadline or the outer fair-wave deadline; provider_unavailable means a holder read sent to the provider failed and the market had no reusable holder page; holder_deadline_unavailable means holder cache/provider work missed the absolute request deadline, or local capacity never sent the holder read, and the market had no reusable holder page; holder_computation_unavailable means post-holder provider or DB-backed price/metadata evaluation was unavailable. */
     terminals: Record<string, number>;
     /** Sum of every sparse terminal count. */
     terminal_total: number;
@@ -928,7 +961,6 @@ export type EventReplayMeta = {
     /** 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_s?: number;
     /** Advisory request weight (relative compute cost). 1 for simple reads; higher for heavier endpoints. Not a credit/price. */
     cost: number;
     replay: {
@@ -1130,7 +1162,7 @@ export type ExportCompleteness = {
     sync_coverage: number;
 };
 export type ExportCounts = {
-    /** Daily P&L rows. The daily P&L covers every market of the wallet. */
+    /** The days in the export file's pnl section, the wallet's sports and esports realized P&L by UTC day: the file's export_metadata.pnl_rows, at most its earliest 3650 days. 0 while source_range.pnl_series_status is pending, and 0 with it ready for a wallet that traded no sports or esports market. */
     pnl_days: number;
     /** The wallet's sports and esports markets: the rows of the export's markets section, before its 50,000-row cap. */
     exported_markets: number;
@@ -1174,21 +1206,28 @@ export type ExportJobReadyData = {
     data_as_of: string | null;
 };
 export type ExportSourceRange = {
+    /** The first UTC day in the export file's pnl section, the wallet's sports and esports realized P&L by day: the file's export_metadata.pnl_date_from. Null when that section has no day, including while pnl_series_status is pending. */
     first_pnl_date: string | null;
+    /** The last UTC day in the export file's pnl section: the file's export_metadata.pnl_date_to. Null when that section has no day. */
     last_pnl_date: string | null;
+    /** Whether the export file's pnl section holds the wallet's sports and esports day series, the file's export_metadata.pnl_series_status. pending means 0xinsider has not computed the series yet: the dates are null and counts.pnl_days is 0, which then never means the wallet has no day. A wallet that traded no sports or esports market is ready with null dates and counts.pnl_days 0: it never gets a series, and with nothing stored completeness.status is empty (since 2026-10-29, #30620, #30657). */
+    pnl_series_status: "ready" | "pending";
     /** The latest trade in the wallet's sports and esports markets. Null when it has none. */
     latest_trade_at: string | null;
     /** Same instant as latest_trade_at: the latest activity of the markets the export holds. */
     latest_market_activity_at: string | null;
 };
 export type ExportVolumeReconciliation = {
-    /** Verified full-history both-sides USD cash volume across every market of the wallet. Null without coverage. */
+    /**
+     * Deprecated (#30499): always null since 2026-10-29. It held Polymarket's volume across every market of the wallet, which reconciles nothing against the sports and esports exported_activity_volume; the key stays so existing V1 clients keep parsing. Read exported_activity_volume for the wallet's sports and esports volume.
+     * @deprecated
+     */
     provider_lifetime_volume: number | null;
-    /** Cash in USD, buys and sells, in sports and esports markets, summed over the daily P&L rows this export carries (their total_volume, from the fills 0xinsider stores for the wallet). Never Polymarket's share count. Null when any of those rows has no volume: a sum over the other days would be a partial subtotal. A wallet whose stored history 0xinsider has not rebuilt yet still sums cash across every market, and is null once it has a day from 2026-10-23 on. */
+    /** Volume in USD, buys and sells, in sports and esports markets, each fill's size times its price with fees excluded, summed over the wallet's stored daily volume rows (from the fills 0xinsider stores for the wallet): the export file's summary.volume_reconciliation.exported_activity_volume, not the sum of its pnl[].total_volume, which is null on a day the trade rollups do not cover. Never Polymarket's share count. Null when any of those rows has no volume: a sum over the other days would be a partial subtotal. */
     exported_activity_volume: number | null;
     /** Cost basis in USD summed over the wallet's sports and esports markets, the markets section of the export. */
     exported_market_cost_basis: number;
-    /** Always null. provider_lifetime_volume covers every market and exported_activity_volume sports and esports markets only, so their difference measures nothing; the field stays so existing clients keep parsing the object. */
+    /** Always null. provider_lifetime_volume covered every market and exported_activity_volume sports and esports markets only, so their difference measured nothing; the field stays so existing clients keep parsing the object. */
     provider_activity_volume_gap: number | null;
     /** Always null, for the same reason as provider_activity_volume_gap. */
     activity_volume_coverage: number | null;
@@ -1200,10 +1239,10 @@ export type FreshnessFailure = {
     actual_age_s?: number;
     /** The oldest stored data-quality clock used to calculate actual_age_s, when one is available. */
     as_of?: string;
-    /** The trader body's whole-response data-quality status. Only fresh can satisfy max_age_s. */
-    data_quality_status: "fresh" | "partial" | "unknown" | "untracked" | "unavailable";
+    /** The trader body's whole-response data-quality status. Only fresh or stale can satisfy max_age_s: the ceiling replaces each writer's own budget, so a stale body inside it is answered. */
+    data_quality_status: "fresh" | "stale" | "partial" | "unknown" | "untracked" | "unavailable";
 };
-/** One sports or esports game: both sides, its schedule, provider status, linked Polymarket markets and their available provider moneyline price states. Assembled from the same provider-first live and upcoming projections the site's boards use, with no request-time provider fan-out. */
+/** One sports or esports game: both sides, its schedule, provider status, its winner markets (the moneyline, or the soccer 1X2 legs) with their available provider moneyline price states and liquidity, and the game's traded volume. The event's other markets are on GET /api/v1/games/{event_slug}/markets. Assembled from the same provider-first live and upcoming projections the site's boards use, with no request-time provider fan-out. */
 export type Game = {
     object: "game";
     /** The game's identity, for example mlb-mil-cin-2026-06-22. The same key the live_sports_updated webhook pulse carries and the same key /api/v1/games/{event_slug} takes. */
@@ -1225,12 +1264,17 @@ export type Game = {
     series_format?: string;
     /** Whether this read includes a market classified as paying on a draw, including soccer's independent 1X2 draw leg. Read this instead of assuming a two-outcome moneyline. */
     draw_offered: boolean;
-    /** Every market this read linked to the game, ordered by condition_id. */
+    /** The game's winner markets the sports board binds to its sides (the moneyline, or a soccer game's three 1X2 legs), ordered by condition_id. Spreads, totals, period lines and props are on GET /api/v1/games/{event_slug}/markets. */
     markets: GameMarket[];
     freshness: GameFreshness;
     coverage: GameCoverage;
     /** The game's page on 0xinsider. */
     url: string;
+    sharp_money?: GameSharpMoney;
+    /** The game's traded volume, the figure the sports board carries for it, with its source, basis, unit and observation clock. A client can rank or filter games by volume.value. Omitted when the board carries no volume for the game, and on a finished game read from its stored record (freshness.source stored); never 0 in place of a missing figure. */
+    volume?: GameVolume;
+    /** A tennis game's tournament edition: its tier, city and country, venue time zone and official dates, from 0xinsider's reviewed registry, the same facts the game's page states. Omitted outside tennis, on a finished game read from its stored record (freshness.source stored), and when the registry holds no single edition for the game's competition label, players' tour and kickoff; never a guessed value. */
+    tournament?: GameTournament;
 };
 /** One side of the game. */
 export type GameCompetitor = {
@@ -1247,7 +1291,7 @@ export type GameCompetitor = {
 };
 /** What this game's read actually supplied, so a client branches on coverage instead of on a missing key. */
 export type GameCoverage = {
-    /** available when a live-score frame supplied this game's scores. */
+    /** available when a live-score frame supplied a score for this game. A game no live-score feed has reported yet, as most scheduled games are, reads unavailable. */
     scores: "available" | "unavailable";
     /** provider_ids when every side carries a provider id, labels when only the provider's names identify them, unavailable when neither exists. Do not join on names when this reads labels. */
     competitors: "provider_ids" | "labels" | "unavailable";
@@ -1256,15 +1300,15 @@ export type GameCoverage = {
 };
 /** How current this game's facts are. Independent per source: the board half that produced the game, and the live-score frame that produced its scores. */
 export type GameFreshness = {
-    /** Which board half produced this game. */
-    source: "live" | "upcoming";
+    /** What produced this game: live or upcoming, the board half that carried it, or stored, the stored record of a finished game that has left the board (GET /api/v1/games/{event_slug}, and GET /api/v1/games with a finished status). */
+    source: "live" | "upcoming" | "stored";
     /** Whether that half returned a truthful source body for this read. */
     source_status: "ok" | "unavailable";
     /** Whether that half had a source body at all. not_applicable means the sport has no configured source for that half. */
     source_availability: "available" | "unavailable" | "not_applicable";
-    /** Freshness of the cached source body, never inferred from the response clock or the row count. */
+    /** Freshness of the cached source body, never inferred from the response clock or the row count. not_applicable for a stored game, whose record is final. */
     source_freshness: "fresh" | "stale" | "unknown" | "not_applicable";
-    /** The source body's data vintage. Omitted when the read has no vintage anchor, which is not age zero. */
+    /** The source body's data vintage. Omitted when the read has no vintage anchor, which is not age zero. For a stored game, the later of its last live-score write and its last leg settlement. */
     source_observed_at?: string;
     /** Age of source_observed_at in seconds, capped at 600. Omitted past the cap or with no anchor. */
     source_age_seconds?: number;
@@ -1275,6 +1319,22 @@ export type GameFreshness = {
     /** The provider's own frame clock. Omitted when the frame carries none. */
     scores_source_at?: string;
 };
+/** One market of a game holders batch: GET /api/v1/market/{condition_id}/holders unfiltered and cut to the batch limit. */
+export type GameHoldersItem = {
+    /** The roster's top holders by current value, at most limit. */
+    data: MarketHolder[];
+    /** More graded holders than limit: page them on GET /api/v1/market/{condition_id}/holders. */
+    has_more: boolean;
+    /** Graded holders in the roster, across every page. */
+    total: number;
+    market: MarketHoldersMarket;
+    scan: MarketHoldersScan;
+    totals: MarketHoldersTotals;
+    /** When this roster was computed. A cached roster is at most 60 seconds old. */
+    computed_at: string;
+    /** true when the roster came from the 60-second roster cache. */
+    cached: boolean;
+};
 /** One Polymarket market linked to this game. */
 export type GameMarket = {
     /** The mkt_-prefixed market id every other V1 response uses. */
@@ -1297,6 +1357,17 @@ export type GameMarket = {
     outcome_token_ids?: string[];
     /** Default provider moneyline state. Omitted when this market has no classified moneyline projection; incomplete and invalid projections remain explicit. */
     prices?: GameMarketPrices;
+    /** Polymarket's reported liquidity for this market. Omitted when the provider read carried none, and on a finished game read from its stored record; never 0 in place of a missing figure. */
+    liquidity?: GameMarketLiquidity;
+};
+/** One market's liquidity as Polymarket reports it (Gamma liquidityNum), verbatim. Polymarket documents it only as reported market liquidity, with no unit. It describes the market's resting order book, not traded volume. */
+export type GameMarketLiquidity = {
+    /** The provider's figure at full precision. */
+    value: number;
+    /** Always gamma: the Polymarket Gamma API. */
+    source: "gamma";
+    /** When 0xinsider read the sports board body this figure came from, never a provider-authored timestamp. Omitted when that read has no clock. */
+    observed_at?: string;
 };
 /** How the existing sports-board writer bound prices to competitors. */
 export type GameMarketPriceBindingProvenance = "provider_ids" | "exact_labels" | "containment_labels" | "elimination";
@@ -1357,28 +1428,164 @@ export type GameMarketProviderPrices = GameMarketPricePaired | GameMarketPriceIn
 export type GamesCoverage = {
     /** Canonical sport buckets served, sorted. */
     sports: string[];
-    /** League tags served, sorted. EuroLeague is euroleague under the Basketball sport bucket. */
+    /** League tags served, sorted. EuroLeague is euroleague, NCAA men's college basketball cbb and NCAA women's college basketball cwbb, all under the Basketball sport bucket. */
     leagues: string[];
     /** Scopes whose source half was unavailable for this read, as <sport>:<half>. Empty means every scope answered. */
     sources_unavailable: string[];
 };
+/** Event-level sharp money for one game. Every aggregate field is null unless status is computed; null means unknown, never zero. */
+export type GameSharpMoney = {
+    allocation: "exact" | "degraded" | null;
+    computed_at: string | null;
+    event_slug: string;
+    holders_partial: boolean | null;
+    lifecycle: "live" | "settled" | "indeterminate" | null;
+    money_as_of: string | null;
+    object: string;
+    outcomes: ({
+        is_leader: boolean;
+        label: string;
+        pct: number;
+        side: "home" | "draw" | "away";
+        usd: number;
+        wallets: {
+            a: number;
+            b: number;
+            s: number;
+        };
+    })[];
+    status: "computed" | "not_computed" | "unavailable";
+    total_usd: number | null;
+    trader_count: number | null;
+    unallocated_usd: number | null;
+    verdict: {
+        kind: "no_sharp_money";
+    } | {
+        kind: "all_on";
+        label: string;
+    } | {
+        kind: "split";
+    } | {
+        kind: "leans";
+        label: string;
+        pct: number;
+    } | {
+        kind: "unavailable";
+    } | {
+        divergence_pts: number;
+        kind: "leans_over_price";
+        label: string;
+    } | {
+        kind: "no_clear_lean";
+    } | {
+        kind: "withheld";
+    } | null;
+};
 /** Where the game is in its own life, as the provider reports it. A postponement, a cancellation and a suspension each keep their own state, so a client can tell a game that will be played later from one that never will be. */
 export type GameStatus = {
-    /** scheduled: kickoff is ahead or the provider still calls it scheduled. live: the provider reports it in play. paused: halftime or a provider-reported break. ended: the provider reported a final, an award or a forfeit. postponed, cancelled, suspended, delayed: the provider's own verdict, kept distinct. unknown: no provider state reached this read. A kickoff in the past is never read as live on its own. */
+    /** scheduled: kickoff is ahead, or the provider still lists the game open and neither in play nor ended. With no live-score frame a game stays scheduled past its kickoff until the provider says otherwise. live: the provider reports it in play. paused: halftime or a provider-reported break. ended: the provider reported a final, an award or a forfeit. postponed, cancelled, suspended, delayed: the provider's own verdict, kept distinct. A tennis match that the provider still lists in play, with no live score feed and no change of period or score for 3 hours, also reads suspended. unknown: no provider state reached this read. A kickoff in the past is never read as live on its own. */
     state: "scheduled" | "live" | "paused" | "ended" | "postponed" | "cancelled" | "suspended" | "delayed" | "unknown";
-    /** The provider status folded onto one vocabulary across leagues. unknown means the provider sent a value this API has no meaning for; provider_status keeps that value verbatim. Omitted when no live-score frame carries a status. */
+    /** The provider status folded onto one vocabulary across leagues. unknown means the provider sent a value this API has no meaning for; provider_status keeps that value verbatim. Omitted when no live-score frame carries a status, as for a listed game no live-score feed has reported yet. */
     match_status?: "scheduled" | "in_progress" | "halftime" | "penalty_shootout" | "delayed" | "suspended" | "final" | "final_overtime" | "final_shootout" | "awarded" | "forfeit" | "not_necessary" | "postponed" | "cancelled" | "unknown";
-    /** The provider's status string, verbatim. Omitted when the provider sent none. */
+    /** The live-score feed's status string, verbatim. Omitted when no live-score frame carries one. This API never puts a label of its own here, such as Scheduled for a listed game. */
     provider_status?: string;
     /** The provider's period label, for example Q3, End Q2 or T5. Omitted when the provider sent none. */
     period?: string;
     /** The game clock as the provider spells it, never reformatted. Omitted when the provider sent none. */
     clock?: string;
-    /** Whether the game is in play. It is the provider's own in-play flag, except that a game the provider reports suspended (period SUS) or rescheduled to a later kickoff reads false. Omitted when no live-score frame exists, which is not the same as false. */
+    /** Whether the game is in play. It is the provider's own in-play flag, except that three cases read false: a game the provider reports suspended (period SUS), a game rescheduled to a later kickoff, and a tennis match that the provider still lists in play with no live score feed and no change of period or score for 3 hours. 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;
 };
+/** The tennis tournament edition a game belongs to, curated from official ATP, WTA and ITF pages (source_urls), never from Polymarket, which supplies the competition label and tour only. Selected by the game's provider competition label, the one tour both players carry, and the kickoff's day at the venue. A fact no official page states is omitted. */
+export type GameTournament = {
+    /** The provider competition label that selected this edition, verbatim, for example "Erste Bank Open, Qualification". */
+    label: string;
+    /** The edition's tour. */
+    tour: "atp" | "wta" | "itf";
+    /** The match's draw. qualification when the provider competition label carries Polymarket's qualifying mark (", Qualification", which 0xinsider also applies when Polymarket flags an ATP Challenger qualifying fixture); main for an unmarked ATP or WTA label. Omitted for an unmarked ITF label: Polymarket gives an ITF qualifying match the main draw's label. */
+    draw?: "main" | "qualification";
+    /** The edition's verified category, for example "ATP Masters 1000", "ATP Challenger 50", "WTA 1000" or "ITF M25". Omitted when no official page states it. */
+    tier?: string;
+    /** The verified venue city and country. Omitted when no official page states it. */
+    location?: GameTournamentLocation;
+    /** The venue's IANA time zone, for example "Europe/Rome". Format the venue's local time with it; it carries the daylight-saving rules. Omitted when the venue is unverified. */
+    timezone?: string;
+    /** The year of the edition. */
+    edition_year: number;
+    /** The edition's first official day, inclusive (YYYY-MM-DD). A qualifying match can be played up to two days before it. */
+    starts_on: string;
+    /** The edition's last official day, inclusive (YYYY-MM-DD). */
+    ends_on: string;
+    /** The official tournament, tour, federation or time-zone pages the facts were taken from. */
+    source_urls: string[];
+    /** When those pages were checked: a catalogue verification date, not a score or price clock. */
+    checked_on: string;
+};
+/** A verified tournament venue. */
+export type GameTournamentLocation = {
+    city: string;
+    country: string;
+    /** ISO 3166-1 alpha-2, for example "IT". */
+    country_code: string;
+};
+/** One fill in a game, as the game page's activity list shows it. */
+export type GameTrade = {
+    /** Stable fill identity: {transaction_hash}:{token_id}:{wallet}:{shares}. Deduplicate on it across polls. */
+    id: string;
+    /** When the fill happened, to the second. */
+    traded_at: string;
+    /** The provider's side of the fill. */
+    side: "BUY" | "SELL";
+    /** The traded outcome's label; null when the provider named none. */
+    outcome: string | null;
+    /** 0 for the first (Yes) outcome token, 1 for the second (No); null when the provider did not say. */
+    outcome_index: number | null;
+    /** Fill price, 0 to 1. */
+    price: number;
+    /** Shares filled. */
+    shares: number;
+    /** USDC notional of the fill. */
+    size_usd: number;
+    /** The signed handicap the fill's side carries on a spread line, for example -1.5 or 1.5; null off spreads. */
+    point: number | null;
+    trader: {
+        /** Lowercase proxy wallet. */
+        address: string;
+        /** The name the site shows: the 0xinsider username, else the provider's name or pseudonym, else the shortened address. */
+        display_name: string;
+        /** The trader's grade today; null for an ungraded or untracked wallet. */
+        grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+    };
+    market: {
+        /** The market's v1 id, mkt_ plus the condition_id. */
+        id: string;
+        /** The raw provider condition_id. */
+        condition_id: string;
+        /** The market's question. */
+        title: string | null;
+        /** The market's page slug. */
+        slug: string | null;
+        /** The market's name within the game, for example Draw, O/U 2.5, First to Score: CD Guadalajara, Game 2: Any Player Quadra Kill. */
+        line_label: string | null;
+    };
+};
+/** A game's traded volume as Polymarket reports it, read by the sports board with no request-time provider call. A one-side taker share count, the number Polymarket's own pages print behind a dollar sign, not the cash that changed hands. */
+export type GameVolume = {
+    /** The volume at full precision, in unit. */
+    value: number;
+    /** taker_shares: cumulative one-side taker volume in shares. One share pays $1 at settlement, so this is not cash traded. Omitted only on a figure observed before units were recorded; never assume cash. */
+    unit?: "taker_shares";
+    /** game_lines: the game volume Polymarket's game page states, summed over the game's own lines. event_total: the whole event's volume, stated when no game volume was readable. The two can differ in either direction. Omitted when the basis is unknown. */
+    basis?: "game_lines" | "event_total";
+    /** The Polymarket API the figure was read from: polymarket_data (the Data API's live volume) or gamma (the Gamma API). */
+    source: "polymarket_data" | "gamma";
+    /** When 0xinsider read the figure from the provider, never a provider-authored timestamp. Omitted when no read time is held for it. */
+    observed_at?: string;
+    /** How long after observed_at 0xinsider treats the figure as current: 60 or 300 by source and basis, or 3600 for an older figure kept because a later read of the same total was lower or missing (a cumulative volume never falls). */
+    fresh_for_seconds: number;
+};
 /** Current category evidence, independent of the global grade. Pick of the Day stamps only the served display roster; frozen entry snapshots remain unchanged. */
 export type HolderCategoryEvidence = {
     status: "live" | "insufficient" | "stale" | "unknown" | "degraded";
@@ -1405,9 +1612,20 @@ export type LargeExportPolicy = {
         /** How long a finished export is retained before expiry. */
         retention: string;
     };
-    direct_streaming: Record<string, unknown>;
-    async_job: Record<string, unknown>;
-    rate_limit: Record<string, unknown>;
+    direct_streaming: {
+        available_when: string;
+        backpressure: string;
+        chunk_size_rows: number;
+    };
+    async_job: {
+        available_when: string;
+        status_values: string[];
+        retention: string;
+    };
+    rate_limit: {
+        daily_cap_per_user: number;
+        per_address_hourly_cap: number;
+    };
 };
 export type LargePosition = {
     /** Composite prefixed ID `pos_<wallet>:<condition_id>:<outcome_index>`. */
@@ -1465,9 +1683,16 @@ export type LargePosition = {
         address: string;
         username?: string;
         grade?: "S" | "A" | "B" | "C" | "D" | "F";
+        /** Sports and esports win rate as a ratio from 0 to 1 (0.62 means 62%): wins over the decided sports and esports markets on the wallet's record, the same figure as pnl.in_scope.win_rate on GET /api/v1/trader/{address}. Since 2026-10-27 it no longer counts other markets (#29953). Absent when the wallet has no record or no decided market. */
         win_rate?: number;
-        /** Polymarket's net total P&L for the wallet in USD: native Polymarket position P&L across all markets, fees included, plus credited maker and taker rebates. The 0xinsider profile's Total P&L is this figure unless the wallet has a published correction for neg-risk conversions, which GET /api/v1/trader/{address} serves as pnl.correction; the profile then shows pnl.correction.net_total. Distinct from this position's position_unrealized_pnl. Omitted when the wallet has no native accounting snapshot. */
+        /**
+         * Deprecated since 2026-10-27 and never sent. It was Polymarket's net total P&L over every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29953). Read trader.in_scope_realized_pnl.
+         * @deprecated
+         */
         pnl?: number;
+        /** The wallet's realized P&L in USD on sports and esports markets, the figure the 0xinsider profile shows: the record behind pnl.in_scope.realized_pnl on GET /api/v1/trader/{address}, to cents. Distinct from this position's position_unrealized_pnl. For a graded wallet it is read from the latest grading pass, so it can trail that figure until the next pass. Omitted until 0xinsider has computed the wallet's record (#29953). */
+        in_scope_realized_pnl?: number;
+        /** Sports and esports markets on the wallet's record, pnl.in_scope.markets on GET /api/v1/trader/{address}. Since 2026-10-27 it no longer counts other markets (#29953). Absent when the wallet has no record. */
         markets_traded?: number;
     };
     market: {
@@ -1521,7 +1746,7 @@ export type LargeTrade = {
         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;
+        grade?: "S" | "A" | "B" | "C" | "D" | "F";
         /** 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. */
@@ -1603,29 +1828,73 @@ export type LeaderboardEntry = {
     id: string;
     address: string;
     username?: string;
-    grade?: string;
+    grade?: "S" | "A" | "B" | "C" | "D" | "F";
     /** Hot-streak tier (trailing-7d cross-sectional percentile); a separate axis from the all-time grade. Omitted when there is no recent activity. */
     streak_tier?: "hot" | "rising" | "neutral" | "cooling" | "cold";
     score?: number;
-    /** Polymarket's all-time leaderboard P&L in USD, from Polymarket's latest observation of this wallet on its all-time leaderboard (dated by the leaderboard_pnl data_quality group). Omitted when that leaderboard has no current observation ranking the wallet; 0xinsider requests one, and never serves an older stored figure in its place. Includes unrealized open positions. Kept for back-compat. Not the profile's Total P&L, which GET /api/v1/trader/{address} serves as pnl.net_total; the two can differ by a wide margin. Prefer realized_pnl for the banked figure. */
+    /**
+     * Deprecated since 2026-10-27 and never sent. It was Polymarket's all-time leaderboard P&L, which covered every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29971). Read in_scope.realized_pnl.
+     * @deprecated
+     */
     pnl?: number;
-    /** Native realized P&L plus credited maker and taker rebates in USD, with fees already included. The exact numeric value is truncated toward zero to cents before JSON conversion. Omitted when the wallet has no native snapshot or the snapshot has no net realized value; never filled from another P&L basis. */
+    /**
+     * Deprecated since 2026-10-27 and never sent. It was native Polymarket realized P&L over every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29971). Read in_scope.realized_pnl.
+     * @deprecated
+     */
     realized_pnl?: number;
-    /** The 0xinsider correction to Polymarket's P&L for neg-risk conversions. Present only when one is published; realized_pnl keeps Polymarket's own figure and pnl_correction.realized adds the amount to it. Since 2026-10-22 the grade and the ranking read the sports and esports share of the corrected figure. net_total is omitted here. */
+    /**
+     * Deprecated since 2026-10-27 and never sent. It was the neg-risk conversion correction to the wallet-wide realized_pnl (#29971). Its sports and esports part is inside in_scope.realized_pnl.
+     * @deprecated
+     */
     pnl_correction?: PnlCorrection;
-    /** Full-history both-sides USD cash volume from a verified Polymarket user-volume observation. Omitted without coverage. */
+    /**
+     * Deprecated since 2026-10-27 and never sent. It was full-history USD cash volume over every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29971).
+     * @deprecated
+     */
     volume?: number;
+    /** Sports and esports markets on the wallet's record, the same count as in_scope.markets. Since 2026-10-27 (#29971); before, it counted every Polymarket market. Sent exactly when in_scope is. */
     markets_traded?: number;
-    /** The wallet's win rate across ALL categories, not the filtered one. ?category= decides WHICH wallets are listed (the wallet must be ranked in that category); it does not rescope this field, so a soccer-filtered list still reports each wallet's overall rate. For a per-category record use GET /api/v1/trader/{address}/categories. in_scope.win_rate is the sports and esports rate. */
+    /** The wallet's sports and esports win rate, in_scope.win_rate rounded to four places. Since 2026-10-27 (#29971); before, it covered every Polymarket market. ?category= decides WHICH wallets are listed (the wallet must be ranked in that category); it does not rescope this field. For a per-category record use GET /api/v1/trader/{address}/categories. Omitted when in_scope is omitted or has no win rate. */
     win_rate?: number;
-    /** Additive (#27859): the wallet's sports and esports record, the same object as GET /api/v1/trader/{address} pnl.in_scope, as of the leaderboard's last refresh. The 0xinsider leaderboard page shows and sorts by in_scope.realized_pnl and in_scope.win_rate. Omitted until 0xinsider has computed the wallet's record; absent means not computed yet, never zero. pnl, realized_pnl and win_rate stay wallet-wide. */
+    /** Additive (#27859): the wallet's sports and esports record, the same object as GET /api/v1/trader/{address} pnl.in_scope, as of the leaderboard's last refresh. The 0xinsider leaderboard page shows and sorts by in_scope.realized_pnl and in_scope.win_rate. Omitted until 0xinsider has computed the wallet's record; absent means not computed yet, never zero. */
     in_scope?: TraderPnlInScope;
+    /** Additive (#32270): the wallet's edge over the price paid on its sports and esports markets, the figures the 0xinsider leaderboard page's Edge column states for the row. sort=edge orders by price_edge.edge. Omitted when the wallet has no settled sports or esports market of $20 or more at a known entry price. */
+    price_edge?: LeaderboardPriceEdge;
     /** Observed trading style identifier. New rows use two_sided, category_focused, high_activity, diversified, mixed, or unclassified, counted over the wallet's sports and esports markets only. Historical identifiers remain readable during normal reclassification; style does not predict skill or intent. */
     strategy_type?: string;
     /** Provider platform. Always polymarket. */
     platform: "polymarket";
+    /** When the wallet last traded: its most recent recorded trade, as of the leaderboard row's last refresh, which re-reads it hourly, so a new trade can take about an hour to show. It agrees with the activity filter: every wallet listed under activity=inactive last traded more than 30 days ago. Since 2026-11-02 (#32322); before, it carried the time 0xinsider last synced the wallet, usually within the past week whether or not the wallet traded. Omitted when the wallet has no recorded trade. */
     last_active?: string;
 };
+export type LeaderboardLeagues = {
+    leagues: {
+        category: string;
+        name: string;
+        ranked_traders: number;
+        slug: string;
+        sport: string;
+        total_traders: number;
+    }[];
+    min_ranked: number;
+    min_resolved: number;
+    refreshed_at: string;
+};
+/** Edge over the price paid (#32270): how often the side a wallet bought won, minus the average price it paid, over its settled sports and esports markets of $20 or more at a known entry price. Probabilities throughout: edge 0.12 is 12 percentage points. A wallet buying at 99 cents that wins every market has an edge of about 0.01. A market bought on both sides counts by its shares: the winning side's share of the shares bought is its hit, the cost over those shares its price. */
+export type LeaderboardPriceEdge = {
+    /** Settled sports and esports markets of $20 or more at a known entry price that the edge is measured over. */
+    markets: number;
+    /** Share of those markets whose bought side won, 0-1. */
+    hit_rate: number;
+    /** Mean entry price paid, 0-1. */
+    avg_price: number;
+    /** hit_rate minus avg_price, full precision. The value sort=edge orders by. */
+    edge: number;
+    /** Whether the edge ranks. ranked: at least 30 such markets, and the share of the decided ones that made money at settlement within 10 points of the win rate over the same markets. too_few_markets: fewer than 30. sample_mismatch: that share is more than 10 points away, so these markets do not describe the wallet's record. Only a ranked edge with no hold orders on sort=edge. */
+    status: "ranked" | "too_few_markets" | "sample_mismatch";
+    /** Why the leaderboard does not rank a ranked edge. record_incomplete: the wallet's stored sports and esports record shows more profit than Polymarket reports for it, so some losing markets are likely missing. Omitted when nothing holds the edge, and always omitted unless status is ranked. */
+    hold?: "record_incomplete";
+};
 /** One side's score line inside a `live_sports_updated` pulse. */
 export type LiveSportsScoreEntry = {
     /** Team name, ordered for the league (away first where the league reads that way). */
@@ -1706,7 +1975,7 @@ export type MarketFlow = {
             id: string;
             address: string;
             username: string | null;
-            grade: string | null;
+            grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
             side: "YES" | "NO";
             /** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for this outcome; null when unavailable (e.g. unsynced markets). */
             token_id: string | null;
@@ -1737,7 +2006,7 @@ export type MarketFlow = {
             id: string;
             address: string;
             username: string | null;
-            grade: string | null;
+            grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
             side: "YES" | "NO";
             /** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for this outcome; null when unavailable (e.g. unsynced markets). */
             token_id: string | null;
@@ -1771,21 +2040,21 @@ export type MarketHolder = {
     other_outcome_shares?: number;
     /** The wallet's last recorded trade anywhere, null when unknown. */
     last_traded_at: string | null;
-    /** This wallet's win rate in the market's canonical category (`market.category`): the share of its resolved markets in that category whose realized P&L closed positive, as a 0..1 fraction. Present only with `category_win_rate_status` = `measured`. The same read `GET /api/v1/trader/{address}/categories` serves per wallet. */
+    /** This wallet's win rate in the market's canonical category (`market.category`): the share of its settled markets in that category (it closed its position by selling out, or the market resolved) whose realized P&L closed positive, as a 0..1 fraction. Present only with `category_win_rate_status` = `measured`. The same read `GET /api/v1/trader/{address}/categories` serves per wallet. */
     category_win_rate?: number;
-    /** The two counts `category_win_rate` is the ratio of, from the same row: `wins / decided` equals the rate. Every resolved Polymarket market the wallet traded in the market's canonical category, at any position size, rebuilt daily. Present only with `category_win_rate_status` = `measured`. */
+    /** The two counts `category_win_rate` is the ratio of, from the same row: `wins / decided` equals the rate. Every settled Polymarket market the wallet traded (it closed its position by selling out, or the market resolved) in the market's canonical category, at any position size, rebuilt daily. Present only with `category_win_rate_status` = `measured`. */
     category_win_record?: {
-        /** Resolved markets in the category that this wallet closed with a profit. */
+        /** Settled markets in the category that this wallet closed with a profit. */
         wins: number;
-        /** Resolved markets in the category that this wallet closed with a profit or a loss. A market resolved at zero realized P&L is in neither count. */
+        /** Settled markets in the category that this wallet closed with a profit or a loss. A market resolved at zero realized P&L is in neither count. */
         decided: number;
     };
-    /** The wallet's average entry price in the market's canonical category, as a 0..1 fraction of $1 (0.98 is 98 cents). Its sample is the wallet's settled markets in that category of $20 or more where it bought one side at a known price, so it can differ from the `category_win_record` sample. A wallet that buys near-certain outcomes wins almost every time, so read the win rate beside this price. Present only with `category_win_rate_status` = `measured`, and only when that sample has at least 5 markets. When `category_win_rate_game` is present the price is still the `Esports` category's: there is no per-game price. Absent otherwise and on payloads predating the field. */
+    /** The wallet's average entry price in the market's canonical category, as a 0..1 fraction of $1 (0.98 is 98 cents). Its sample is the wallet's markets in that category that resolved to a winning side, of $20 or more where it bought one side at a known price, so it can differ from the `category_win_record` sample. A wallet that buys near-certain outcomes wins almost every time, so read the win rate beside this price. Present only with `category_win_rate_status` = `measured`, and only when that sample has at least 5 markets. When `category_win_rate_game` is present the price is still the whole `category` bucket's: this field has no per-game or per-league price. Absent otherwise and on payloads predating the field. */
     category_avg_price?: number;
-    /** For an esports market, the game `category_win_rate` and `category_win_record` were measured in: `LoL`, `CS2`, `Dota 2`, `Valorant`, `Call of Duty`, `Honor of Kings`, `Mobile Legends: Bang Bang`, `Overwatch`, `Rainbow Six Siege`, `Rocket League` or `StarCraft II`. Present only when the wallet's record in that game clears the 5-resolved-market floor, in which case the rate and record are the game's rather than the `Esports` bucket's. Absent when the rate is the bucket's (the wallet's game history is under the floor), on every non-esports market, and beside every non-measured status. Label the rate with this when present and with the market's `category` otherwise. */
+    /** Where `category_win_rate` and `category_win_record` were measured: for an esports market the game (`LoL`, `CS2`, `Dota 2`, `Valorant`, `Call of Duty`, `Honor of Kings`, `Mobile Legends: Bang Bang`, `Overwatch`, `Rainbow Six Siege`, `Rocket League` or `StarCraft II`), and for a market in a registered league that league, by the name Pick of the Day uses for it (`NBA`, `NFL`, `NHL`, `MLB`, `UFC`, `ATP`, `WTA`, `LaLiga`, `Premier League`, `Serie A`, `UEFA Champions League`, `MLS` and the other registered leagues). Present only when the wallet's record there clears the 5-settled-market floor, in which case the rate and record are the game's or league's rather than the whole `category` bucket's. Absent when the rate is the bucket's (the wallet's history there is under the floor, or the competition is not a registered league), on every other market, and beside every non-measured status. Label the rate with this when present and with the market's `category` otherwise. */
     category_win_rate_game?: string;
-    /** Why `category_win_rate` is present or absent: `measured` (rate present), `not_enough_data` (under the floor of 5 decided markets in the category), or `unavailable` (the market has no canonical category, or the read failed; retry later). Always present on this route. */
-    category_win_rate_status: "measured" | "not_enough_data" | "unavailable";
+    /** Why `category_win_rate` is present or absent: `measured` (rate present), `not_enough_data` (under the floor of 5 decided markets in the category), or `unavailable` (the market has no canonical category, or the read failed; retry later). Never `untracked`: this route lists S, A and B wallets only, all on file. Always present on this route. */
+    category_win_rate_status: "measured" | "not_enough_data" | "unavailable" | "untracked";
     category_evidence?: HolderCategoryEvidence;
     /** Whole days since this wallet's first trade, rounded down (3.6 days reads 3), so it changes once a day, not on every request. The five badge fields are present together, only for a wallet that draws at least one badge. */
     wallet_age_days?: number | null;
@@ -1830,6 +2099,15 @@ export type MarketHoldersSideGrades = {
     a: number;
     b: number;
 };
+/** Polymarket currentValue in USD per grade on one side, over the same wallets as that side's usd total. Each value is rounded to the cent after summing, so s + a + b can differ from the side total by up to 2 cents. */
+export type MarketHoldersSideGradeUsd = {
+    /** USD held by S-grade wallets netting this side. */
+    s: number;
+    /** USD held by A-grade wallets netting this side. */
+    a: number;
+    /** USD held by B-grade wallets netting this side. */
+    b: number;
+};
 /** Roster totals BEFORE any `outcome` or `min_grade` filter, so a page always knows the whole market it was cut from. */
 export type MarketHoldersTotals = {
     /** Distinct graded wallets with net exposure; a two-sided wallet counts once. */
@@ -1844,6 +2122,10 @@ export type MarketHoldersTotals = {
     no_usd: number;
     yes_grades: MarketHoldersSideGrades;
     no_grades: MarketHoldersSideGrades;
+    /** yes_usd split by grade: where the S, A and B money on YES sits. */
+    yes_grade_usd: MarketHoldersSideGradeUsd;
+    /** no_usd split by grade: where the S, A and B money on NO sits. */
+    no_grade_usd: MarketHoldersSideGradeUsd;
 };
 export type MarketSearchResult = {
     id: string;
@@ -1855,6 +2137,7 @@ export type MarketSearchResult = {
     platform: "polymarket" | null;
     /** closed once Polymarket has closed trading or the market has resolved; active otherwise. The same rule labels a market on markets/search, markets/explore and market/{condition_id}/snapshot. */
     status: "active" | "closed";
+    event_slug?: string;
 };
 export type MarketSnapshot = {
     market: {
@@ -1949,9 +2232,149 @@ export type MarketSnapshotTrust = {
     current_price: TrustMetadata;
     spread_bps: TrustMetadata;
 };
+export type MarketTopHolder = {
+    /** 1-based position on this outcome, by shares. */
+    rank: number;
+    /** `trd_`-prefixed trader id, accepted by `GET /api/v1/trader/{address}`. */
+    trader_id: string;
+    /** Lowercased proxy wallet. */
+    address: string;
+    /** The wallet's display name; null when it shows none. */
+    name: string | null;
+    /** All-time trader grade, S to F. Null for a wallet 0xinsider has not graded: this route lists every holder whatever its grade. */
+    grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+    /** Shares held on this outcome. */
+    shares: number;
+    /** Polymarket's current value of this position, in USD. Null when the provider served none. */
+    current_value_usd: number | null;
+    /** Average price paid for the shares still held, as a 0..1 fraction of $1. Null when the provider served none. */
+    avg_entry_price: number | null;
+    /** Shares on the other outcome when the wallet holds both; the wallet is then listed on both sides. Absent when it is one-sided. */
+    other_outcome_shares?: number;
+    /** Polymarket's realized P&L of this position (sells and redemptions), in USD. Null when the provider served no economics for the row. */
+    position_realized_pnl: number | null;
+    /** Polymarket's mark-to-market P&L of the shares still held, in USD. On a resolved market the mark is the settlement price. */
+    position_unrealized_pnl: number | null;
+    /** `position_realized_pnl` plus `position_unrealized_pnl`, in USD. */
+    position_total_pnl: number | null;
+    /** The wallet's realized P&L on sports and esports markets, in USD, the figure on its 0xinsider profile. Null until 0xinsider has computed the record, never 0 in its place, and null for every row when `profiles_status` is `unavailable`. */
+    in_scope_realized_pnl: number | null;
+    /** The wallet's volume traded on sports and esports markets, in USD. Null under the same rule as `in_scope_realized_pnl`. */
+    in_scope_volume: number | null;
+    /** The wallet's stored trading-style label (see Wallet trading styles); null when it has none. */
+    strategy_type: string | null;
+    /** The wallet's last recorded trade anywhere, null when unknown. */
+    last_traded_at: string | null;
+    /** This wallet's win rate in the market's canonical category (`market.category`): the share of its settled markets in that category (it closed its position by selling out, or the market resolved) whose realized P&L closed positive, as a 0..1 fraction. Present only with `category_win_rate_status` = `measured`. The same read `GET /api/v1/trader/{address}/categories` serves per wallet. */
+    category_win_rate?: number;
+    /** The two counts `category_win_rate` is the ratio of, from the same row: `wins / decided` equals the rate. Every settled Polymarket market the wallet traded (it closed its position by selling out, or the market resolved) in the market's canonical category, at any position size, rebuilt daily. Present only with `category_win_rate_status` = `measured`. */
+    category_win_record?: {
+        /** Settled markets in the category that this wallet closed with a profit. */
+        wins: number;
+        /** Settled markets in the category that this wallet closed with a profit or a loss. A market resolved at zero realized P&L is in neither count. */
+        decided: number;
+    };
+    /** The wallet's average entry price in the market's canonical category, as a 0..1 fraction of $1 (0.98 is 98 cents). Its sample is the wallet's markets in that category that resolved to a winning side, of $20 or more where it bought one side at a known price, so it can differ from the `category_win_record` sample. A wallet that buys near-certain outcomes wins almost every time, so read the win rate beside this price. Present only with `category_win_rate_status` = `measured`, and only when that sample has at least 5 markets. When `category_win_rate_game` is present the price is still the whole `category` bucket's: this field has no per-game or per-league price. Absent otherwise and on payloads predating the field. */
+    category_avg_price?: number;
+    /** Where `category_win_rate` and `category_win_record` were measured: for an esports market the game (`LoL`, `CS2`, `Dota 2`, `Valorant`, `Call of Duty`, `Honor of Kings`, `Mobile Legends: Bang Bang`, `Overwatch`, `Rainbow Six Siege`, `Rocket League` or `StarCraft II`), and for a market in a registered league that league, by the name Pick of the Day uses for it (`NBA`, `NFL`, `NHL`, `MLB`, `UFC`, `ATP`, `WTA`, `LaLiga`, `Premier League`, `Serie A`, `UEFA Champions League`, `MLS` and the other registered leagues). Present only when the wallet's record there clears the 5-settled-market floor, in which case the rate and record are the game's or league's rather than the whole `category` bucket's. Absent when the rate is the bucket's (the wallet's history there is under the floor, or the competition is not a registered league), on every other market, and beside every non-measured status. Label the rate with this when present and with the market's `category` otherwise. */
+    category_win_rate_game?: string;
+    /** Why `category_win_rate` is present or absent: `measured` (rate present), `not_enough_data` (the wallet is on file and under the floor of 5 decided markets in the category), `untracked` (0xinsider has no record of the wallet, so nothing was measured; `grade`, `in_scope_realized_pnl` and `in_scope_volume` are null too), or `unavailable` (a read failed; retry later). Absent when the market has no canonical category. */
+    category_win_rate_status?: "measured" | "not_enough_data" | "unavailable" | "untracked";
+    /** Whole days since this wallet's first trade, rounded down (3.6 days reads 3), so it changes once a day, not on every request. The five badge fields are present together, only for a wallet that draws at least one badge. */
+    wallet_age_days?: number | null;
+    /** True when the wallet's first trade was under 30 days ago. */
+    is_new_wallet?: boolean;
+    /** Distinct markets the wallet has traded. */
+    markets_traded?: number | null;
+    /** True when the wallet is flagged as automated. */
+    is_bot?: boolean;
+    /** The wallet's X handle without the @, when linked. */
+    x_username?: string | null;
+};
+export type MarketTopHolders = {
+    market: MarketHoldersMarket;
+    /** The largest YES holders, by shares, up to `limit`. */
+    yes: MarketTopHolder[];
+    /** The largest NO holders, by shares, up to `limit`. */
+    no: MarketTopHolder[];
+    totals: MarketTopHoldersTotals;
+    /** `unavailable` when the wallet record read failed: `in_scope_realized_pnl`, `in_scope_volume` and `strategy_type` are then null for every row because they were not read, not because they are unknown. */
+    profiles_status: "available" | "unavailable";
+    /** When the daily pass behind the rows' category win records began. Absent when the market has no category or the read answered no row. */
+    category_records_as_of?: string;
+    /** When this holder sample was built. */
+    computed_at?: string;
+    /** When Polymarket's holder board behind this sample was fetched: up to 120 s before `computed_at` on an open market. Absent on a resolved market, whose sample reads no live board, and when the fetch stamp could not be read. */
+    positions_as_of?: string;
+    /** `true` when this is the market's last sample, served after its 30 s window while a refresh runs; `positions_as_of` is then at most 300 s old. Read again in a few seconds for the refreshed sample. Always `false` on a resolved market. */
+    source_stale: boolean;
+};
+export type MarketTopHoldersTotals = {
+    /** Holders in the YES sample, before `limit`. Equal to `sample_cap` means that many or more. */
+    yes_count: number;
+    /** Holders in the NO sample, before `limit`. */
+    no_count: number;
+    /** Shares summed over the YES sample. */
+    yes_shares: number;
+    /** Shares summed over the NO sample. */
+    no_shares: number;
+    /** The most holders the sample keeps per outcome (100). */
+    sample_cap: number;
+};
+/** One market's net buyers and net sellers over a 24h or 7d window, as the market page's wallets in/out panel shows a Pro viewer. */
+export type MarketWalletsInOut = {
+    /** The market's raw provider condition id. */
+    condition_id: string;
+    /** The window the nets are summed over: 24h or 7d. */
+    window: string;
+    /** The window's inclusive start; null only when the bounds are unknown. */
+    window_start: string | null;
+    /** The window's inclusive end, the read's clock; null only when the bounds are unknown. */
+    window_end: string | null;
+    /** Totals over every wallet that traded the market in the window, not only the listed 50. */
+    summary: {
+        /** Wallets with a positive net in the window. */
+        wallets_in: number;
+        /** Wallets with a negative net in the window. */
+        wallets_out: number;
+        /** The sum of every wallet's net, in USD. A fully rotated wallet nets zero and is on neither side. */
+        net_usd: number;
+    };
+    /** Wallets whose net is positive, largest first, at most 25. */
+    net_buyers: ({
+        /** Lowercase proxy wallet. */
+        address: string;
+        /** The name the site shows: the 0xinsider username, else the shortened address. */
+        display_name: string;
+        /** Today's grade; null for an ungraded or untracked wallet. */
+        grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+        /** Buys minus sells in the window, both outcomes, in USD: the matched notional, fees excluded. */
+        net_usd: number;
+        /** Fills in the window. */
+        trades: number;
+        /** The wallet's newest trade on any market, at or before window_end; null when unknown. */
+        last_traded_at: string | null;
+    })[];
+    /** Wallets whose net is negative, most negative first, at most 25. */
+    net_sellers: ({
+        /** Lowercase proxy wallet. */
+        address: string;
+        /** The name the site shows: the 0xinsider username, else the shortened address. */
+        display_name: string;
+        /** Today's grade; null for an ungraded or untracked wallet. */
+        grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+        /** Buys minus sells in the window, both outcomes, in USD: the matched notional, fees excluded. */
+        net_usd: number;
+        /** Fills in the window. */
+        trades: number;
+        /** The wallet's newest trade on any market, at or before window_end; null when unknown. */
+        last_traded_at: string | null;
+    })[];
+};
 export type McpJsonRpcError = {
     jsonrpc: "2.0";
-    id: string | number | null;
+    /** The request's id, or null when the request could not be parsed. Omitted on the answer to an unsolicited response message. */
+    id?: string | number | null;
     error: {
         code: number;
         message: string;
@@ -1980,21 +2403,21 @@ export type PickHolder = {
     shares: number;
     /** USD entry value of this wallet's position: `shares` times the pick's frozen `backed_price`. An entry valuation, never a live balance or the provider's current value. Omitted when the holder snapshot has no valid price. */
     entry_value_usd?: number;
-    /** This wallet's win rate in the pick's canonical category bucket (the pick's `category` field, e.g. Basketball -- label the rate with it, never with the narrower `display_category` league, except when `category_win_rate_game` is present, in which case the rate is that game's and is labelled with it): the share of the wallet's resolved markets in that category whose realized P&L closed positive, as a 0..1 fraction. Present only with `category_win_rate_status` = `measured`, on `display_holders` entries, and only when the wallet clears the resolved-market floor; recomputed at serve time from the current category read model, not frozen with the pick. Absent on `holders` entries, legacy rows, and payloads predating the field. */
+    /** This wallet's win rate in the pick's canonical category bucket (the pick's `category` field, e.g. Basketball -- label the rate with it, never with the narrower `display_category` league, except when `category_win_rate_game` is present, in which case the rate is that game's or league's and is labelled with it): the share of the wallet's settled markets in that category (it closed its position by selling out, or the market resolved) whose realized P&L closed positive, as a 0..1 fraction. Present only with `category_win_rate_status` = `measured`, on `display_holders` entries, and only when the wallet clears the settled-market floor; recomputed at serve time from the current category read model, not frozen with the pick. Absent on `holders` entries, legacy rows, and payloads predating the field. */
     category_win_rate?: number;
-    /** The two counts `category_win_rate` is the ratio of, read from the same row: `wins / decided` equals the rate. Counts every resolved Polymarket market the wallet traded in the pick's canonical category (or in its game, when `category_win_rate_game` is present), at any position size; the counts are rebuilt daily. Present only with `category_win_rate_status` = `measured`; absent otherwise and on payloads predating the field. */
+    /** The two counts `category_win_rate` is the ratio of, read from the same row: `wins / decided` equals the rate. Counts every settled Polymarket market the wallet traded (it closed its position by selling out, or the market resolved) in the pick's canonical category (or in its game or league, when `category_win_rate_game` is present), at any position size; the counts are rebuilt daily. Present only with `category_win_rate_status` = `measured`; absent otherwise and on payloads predating the field. */
     category_win_record?: {
-        /** Resolved markets in the category that this wallet closed with a profit. */
+        /** Settled markets in the category that this wallet closed with a profit. */
         wins: number;
-        /** Resolved markets in the category that this wallet closed with a profit or a loss. A market resolved at zero realized P&L is in neither count. */
+        /** Settled markets in the category that this wallet closed with a profit or a loss. A market resolved at zero realized P&L is in neither count. */
         decided: number;
     };
-    /** The wallet's average entry price in the pick's canonical category, as a 0..1 fraction of $1 (0.98 is 98 cents). Its sample is the wallet's settled markets in that category of $20 or more where it bought one side at a known price, so it can differ from the `category_win_record` sample. A wallet that buys near-certain outcomes wins almost every time, so read the win rate beside this price. Present only with `category_win_rate_status` = `measured`, and only when that sample has at least 5 markets. When `category_win_rate_game` is present the price is still the `Esports` category's: there is no per-game price. Absent otherwise and on payloads predating the field. */
+    /** The wallet's average entry price in the pick's canonical category, as a 0..1 fraction of $1 (0.98 is 98 cents). Its sample is the wallet's markets in that category that resolved to a winning side, of $20 or more where it bought one side at a known price, so it can differ from the `category_win_record` sample. A wallet that buys near-certain outcomes wins almost every time, so read the win rate beside this price. Present only with `category_win_rate_status` = `measured`, and only when that sample has at least 5 markets. When `category_win_rate_game` is present the price is still the whole `category` bucket's: this field has no per-game or per-league price. Absent otherwise and on payloads predating the field. */
     category_avg_price?: number;
-    /** For an esports pick, the game `category_win_rate` and `category_win_record` were measured in, by the same name the pick's `display_category` uses for it: `LoL`, `CS2`, `Dota 2`, `Valorant`, `Call of Duty`, `Honor of Kings`, `Mobile Legends: Bang Bang`, `Overwatch`, `Rainbow Six Siege`, `Rocket League` or `StarCraft II`. Present only when the wallet's record in that game clears the 5-resolved-market floor, in which case the rate and record are the game's rather than the `Esports` bucket's. Absent when the rate is the bucket's (the wallet's game history is under the floor), on every non-esports pick, beside every non-measured status, and on payloads predating the field. Label the rate with this when present and with `category` otherwise. */
+    /** Where `category_win_rate` and `category_win_record` were measured, by the same name the pick's `display_category` uses for it: for an esports pick the game (`LoL`, `CS2`, `Dota 2`, `Valorant`, `Call of Duty`, `Honor of Kings`, `Mobile Legends: Bang Bang`, `Overwatch`, `Rainbow Six Siege`, `Rocket League` or `StarCraft II`), and for a pick in a registered league that league (`NBA`, `NFL`, `NHL`, `MLB`, `UFC`, `ATP`, `WTA`, `LaLiga`, `Premier League`, `Serie A`, `UEFA Champions League`, `MLS` and the other registered leagues). Present only when the wallet's record there clears the 5-settled-market floor, in which case the rate and record are the game's or league's rather than the whole `category` bucket's. Absent when the rate is the bucket's (the wallet's history there is under the floor, or the competition is not a registered league), on every other pick, beside every non-measured status, and on payloads predating the field. Label the rate with this when present and with `category` otherwise. */
     category_win_rate_game?: string;
-    /** Why `category_win_rate` is present or absent on a `display_holders` entry: `measured` (rate present), `not_enough_data` (the wallet is below the resolved-market floor of 5 in the category), or `unavailable` (the annotation read failed; retry later). Absent entirely on `holders` entries, legacy rows, and payloads predating the field -- absence means the roster was never annotated, not a small sample. */
-    category_win_rate_status?: "measured" | "not_enough_data" | "unavailable";
+    /** Why `category_win_rate` is present or absent on a `display_holders` entry: `measured` (rate present), `not_enough_data` (the wallet is below the settled-market floor of 5 in the category), or `unavailable` (the annotation read failed; retry later). Never `untracked`: every recorded holder is a graded wallet 0xinsider has on file. Absent entirely on `holders` entries, legacy rows, and payloads predating the field -- absence means the roster was never annotated, not a small sample. */
+    category_win_rate_status?: "measured" | "not_enough_data" | "unavailable" | "untracked";
     /** Whole days since this wallet's first trade, rounded down (3.6 days reads 3), so it changes once a day, not on every request, and the pick's ETag holds between requests. Stamped at serve time from the wallet's current trader record, never frozen with the pick. The five badge fields are present together, and only for a wallet that carries at least one badge; all absent means no badge, or a body cached before the fields shipped. */
     wallet_age_days?: number | null;
     /** True when the wallet's first trade was under 30 days ago. Stamped at serve time from the wallet's current trader record, never frozen with the pick. The five badge fields are present together, and only for a wallet that carries at least one badge; all absent means no badge, or a body cached before the fields shipped. */
@@ -2141,9 +2564,9 @@ export type PickOfTheDay = {
         grade: string | null;
         /** The canonical sport bucket the win rate was measured over (for example Basketball). Can be BROADER than the pick's display_category, which names an exact league such as NBA — label the rate with this field, never with display_category. */
         canonical_category: string;
-        /** Share of the trader’s resolved markets in canonical_category with positive realized P&L, as a 0..1 fraction. Null when not measured. This is a trader statistic, not the pick’s probability of winning. */
+        /** Share of the trader’s settled markets in canonical_category (closed by selling out, or resolved) with positive realized P&L, as a 0..1 fraction. Null when not measured. This is a trader statistic, not the pick’s probability of winning. */
         win_rate: number | null;
-        /** Number of resolved markets behind win_rate; null when not measured. */
+        /** Number of settled markets behind win_rate; null when not measured. */
         n_resolved: number | null;
         /** Recorded Polymarket position value on the backed outcome, in USD. It can change after this snapshot. */
         position_usd: number;
@@ -2569,14 +2992,411 @@ export type PickOfTheDayNoEntitledPicks = {
     message: string;
     /** Rank-ordered entitled selections that have not released. Every row retains release_at and kickoff; unauthorized scheduled ranks appear only in identity-free locked_picks. */
     scheduled_picks?: ScheduledPickSlot[];
-    /** Entitled published picks whose holder proof is unreadable, ordered by rank. Unauthorized ranks appear only in locked_picks and cannot trigger proof warming. Read retry_at for the next read. */
-    proof_pending_picks?: ProofPendingPickSlot[];
     /**
      * Deprecated (#24157): always null. No replacement lineage was ever recorded in this field; the key stays so existing V1 clients keep parsing. Identify a pick by pick_id.
      * @deprecated
      */
     supersedes_pick_id: string | null;
 };
+export type PickOfTheDayStats = {
+    categories: {
+        canonical_category?: string;
+        clv_avg_display?: string;
+        clv_avg_pct?: number;
+        clv_avg_pp?: number;
+        clv_avg_pp_display?: string;
+        clv_measured: number;
+        edge_display?: string;
+        edge_pp?: number;
+        key: string;
+        label: string;
+        losses: number;
+        net_profit_display?: string;
+        net_profit_usd?: number;
+        pending: number;
+        picks: number;
+        priced_decided: number;
+        priced_in_display?: string;
+        priced_in_pct?: number;
+        roi_display?: string;
+        roi_pct?: number;
+        settled: number;
+        small_sample: boolean;
+        staked_usd: number;
+        unit_score?: number;
+        unit_score_display?: string;
+        void: number;
+        win_rate_display?: string;
+        win_rate_pct?: number;
+        wins: number;
+    }[];
+    days: ({
+        date: string;
+        losses: number;
+        net_profit_display?: string;
+        net_profit_usd?: number;
+        pending: number;
+        picks: number;
+        sweep?: "win" | "loss";
+        unit_score?: number;
+        unit_score_display?: string;
+        void: number;
+        wins: number;
+    })[];
+    hit_rate: PickOfTheDayHitRate;
+    market_expectations: {
+        as_of_date: string;
+        price_basis: string;
+        timezone: string;
+        windows: ({
+            clv_avg_display: string | null;
+            clv_avg_pct: number | null;
+            clv_avg_pp: number | null;
+            clv_avg_pp_display: string | null;
+            clv_measured: number;
+            clv_missing: number;
+            expected_wins: number | null;
+            expected_wins_display: string | null;
+            from_date: string | null;
+            key: string;
+            label: string;
+            numeric_unavailable: boolean;
+            priced_decided: number;
+            through_date: string;
+            units: number | null;
+            units_display: string | null;
+            units_z: number | null;
+            units_z_display: string | null;
+            unpriced_decided: number;
+            wins: number;
+            wins_z: number | null;
+            wins_z_display: string | null;
+        })[];
+    };
+    market_types: {
+        canonical_category?: string;
+        clv_avg_display?: string;
+        clv_avg_pct?: number;
+        clv_avg_pp?: number;
+        clv_avg_pp_display?: string;
+        clv_measured: number;
+        edge_display?: string;
+        edge_pp?: number;
+        key: string;
+        label: string;
+        losses: number;
+        net_profit_display?: string;
+        net_profit_usd?: number;
+        pending: number;
+        picks: number;
+        priced_decided: number;
+        priced_in_display?: string;
+        priced_in_pct?: number;
+        roi_display?: string;
+        roi_pct?: number;
+        settled: number;
+        small_sample: boolean;
+        staked_usd: number;
+        unit_score?: number;
+        unit_score_display?: string;
+        void: number;
+        win_rate_display?: string;
+        win_rate_pct?: number;
+        wins: number;
+    }[];
+    months: {
+        canonical_category?: string;
+        clv_avg_display?: string;
+        clv_avg_pct?: number;
+        clv_avg_pp?: number;
+        clv_avg_pp_display?: string;
+        clv_measured: number;
+        edge_display?: string;
+        edge_pp?: number;
+        key: string;
+        label: string;
+        losses: number;
+        net_profit_display?: string;
+        net_profit_usd?: number;
+        pending: number;
+        picks: number;
+        priced_decided: number;
+        priced_in_display?: string;
+        priced_in_pct?: number;
+        roi_display?: string;
+        roi_pct?: number;
+        settled: number;
+        small_sample: boolean;
+        staked_usd: number;
+        unit_score?: number;
+        unit_score_display?: string;
+        void: number;
+        win_rate_display?: string;
+        win_rate_pct?: number;
+        wins: number;
+    }[];
+    outcome_stats: {
+        concentration: {
+            positive_wins: number;
+            remaining_valued_decided: number;
+            removed_wins: number;
+            roi_without_top_wins_display: string | null;
+            roi_without_top_wins_pct: number | null;
+            target_wins: number;
+            top_wins_share_display: string | null;
+            top_wins_share_pct: number | null;
+            valued_decided: number;
+        };
+        drawdown: {
+            completed_days: number;
+            current_days_below_peak: number | null;
+            current_drawdown_display: string | null;
+            current_drawdown_units: number | null;
+            days_below_peak: number | null;
+            excluded_days: number;
+            from_date: string | null;
+            longest_days_below_peak: number | null;
+            longest_recovery_days: number | null;
+            max_drawdown_display: string | null;
+            max_drawdown_units: number | null;
+            peak_date: string | null;
+            peak_net_profit_usd: number | null;
+            through_date: string | null;
+        };
+        profit_factor: {
+            display: string | null;
+            gross_loss_usd: number | null;
+            gross_profit_usd: number | null;
+            state: "empty" | "measured" | "no_losses" | "numeric_unavailable";
+            value: number | null;
+            valued_decided: number;
+        };
+        rolling: ({
+            from_date: string | null;
+            losses: number;
+            roi_display: string | null;
+            roi_pct: number | null;
+            through_date: string | null;
+            units: number | null;
+            units_display: string | null;
+            valued_decided: number;
+            win_rate_display: string | null;
+            win_rate_pct: number | null;
+            window_size: number;
+            wins: number;
+        })[];
+    };
+    price_bands: {
+        canonical_category?: string;
+        clv_avg_display?: string;
+        clv_avg_pct?: number;
+        clv_avg_pp?: number;
+        clv_avg_pp_display?: string;
+        clv_measured: number;
+        edge_display?: string;
+        edge_pp?: number;
+        key: string;
+        label: string;
+        losses: number;
+        net_profit_display?: string;
+        net_profit_usd?: number;
+        pending: number;
+        picks: number;
+        priced_decided: number;
+        priced_in_display?: string;
+        priced_in_pct?: number;
+        roi_display?: string;
+        roi_pct?: number;
+        settled: number;
+        small_sample: boolean;
+        staked_usd: number;
+        unit_score?: number;
+        unit_score_display?: string;
+        void: number;
+        win_rate_display?: string;
+        win_rate_pct?: number;
+        wins: number;
+    }[];
+    records: {
+        best_day?: {
+            date: string;
+            date_display: string;
+            losses: number;
+            net_profit_display: string;
+            net_profit_usd: number;
+            picks: number;
+            wins: number;
+        };
+        biggest_win?: {
+            category: string;
+            date: string;
+            date_display: string;
+            matchup: string;
+            net_profit_display: string;
+            net_profit_usd: number;
+        };
+        longest_losing_day_streak?: {
+            days: number;
+            end_date: string;
+            net_profit_display: string;
+            net_profit_usd: number;
+            range_display: string;
+            start_date: string;
+        };
+        longest_winning_day_streak?: {
+            days: number;
+            end_date: string;
+            net_profit_display: string;
+            net_profit_usd: number;
+            range_display: string;
+            start_date: string;
+        };
+        sweeps: {
+            clean_sweeps: number;
+            latest_clean_sweep?: {
+                date: string;
+                date_display: string;
+                losses: number;
+                wins: number;
+            };
+            latest_wipeout?: {
+                date: string;
+                date_display: string;
+                losses: number;
+                wins: number;
+            };
+            min_decided: number;
+            wipeouts: number;
+        };
+        winning_days?: {
+            flat: number;
+            losing: number;
+            settled: number;
+            winning: number;
+            winning_pct: number;
+            winning_pct_display: string;
+        };
+        worst_day?: {
+            date: string;
+            date_display: string;
+            losses: number;
+            net_profit_display: string;
+            net_profit_usd: number;
+            picks: number;
+            wins: number;
+        };
+    };
+    sports: {
+        canonical_category?: string;
+        clv_avg_display?: string;
+        clv_avg_pct?: number;
+        clv_avg_pp?: number;
+        clv_avg_pp_display?: string;
+        clv_measured: number;
+        edge_display?: string;
+        edge_pp?: number;
+        key: string;
+        label: string;
+        losses: number;
+        net_profit_display?: string;
+        net_profit_usd?: number;
+        pending: number;
+        picks: number;
+        priced_decided: number;
+        priced_in_display?: string;
+        priced_in_pct?: number;
+        roi_display?: string;
+        roi_pct?: number;
+        settled: number;
+        small_sample: boolean;
+        staked_usd: number;
+        unit_score?: number;
+        unit_score_display?: string;
+        void: number;
+        win_rate_display?: string;
+        win_rate_pct?: number;
+        wins: number;
+    }[];
+    streaks: {
+        current?: number;
+        current_day?: number;
+        current_day_display?: string;
+        current_display?: string;
+        longest_loss: number;
+        longest_win: number;
+    };
+    tiers: {
+        canonical_category?: string;
+        clv_avg_display?: string;
+        clv_avg_pct?: number;
+        clv_avg_pp?: number;
+        clv_avg_pp_display?: string;
+        clv_measured: number;
+        edge_display?: string;
+        edge_pp?: number;
+        key: string;
+        label: string;
+        losses: number;
+        net_profit_display?: string;
+        net_profit_usd?: number;
+        pending: number;
+        picks: number;
+        priced_decided: number;
+        priced_in_display?: string;
+        priced_in_pct?: number;
+        roi_display?: string;
+        roi_pct?: number;
+        settled: number;
+        small_sample: boolean;
+        staked_usd: number;
+        unit_score?: number;
+        unit_score_display?: string;
+        void: number;
+        win_rate_display?: string;
+        win_rate_pct?: number;
+        wins: number;
+    }[];
+    total_sides: {
+        canonical_category?: string;
+        clv_avg_display?: string;
+        clv_avg_pct?: number;
+        clv_avg_pp?: number;
+        clv_avg_pp_display?: string;
+        clv_measured: number;
+        edge_display?: string;
+        edge_pp?: number;
+        key: string;
+        label: string;
+        losses: number;
+        net_profit_display?: string;
+        net_profit_usd?: number;
+        pending: number;
+        picks: number;
+        priced_decided: number;
+        priced_in_display?: string;
+        priced_in_pct?: number;
+        roi_display?: string;
+        roi_pct?: number;
+        settled: number;
+        small_sample: boolean;
+        staked_usd: number;
+        unit_score?: number;
+        unit_score_display?: string;
+        void: number;
+        win_rate_display?: string;
+        win_rate_pct?: number;
+        wins: number;
+    }[];
+    voids: {
+        backed_price?: number;
+        backed_side?: string;
+        category?: string;
+        matchup?: string;
+        pick_date: string;
+        pick_id: string;
+        pick_rank: number;
+    }[];
+};
 /** A settled uncommitted pick's market, side and price. The same eight fields as PickOfTheDayCommitmentPayload, in the same key order, so a settled pick's side and price sit under payload whatever the entry's state. It is NOT a commitment: no hash was taken over it before the game, and it proves nothing about when the pick was made. */
 export type PickOfTheDayUncommittedPayload = {
     /** Frozen pre-game price of the backed side, 0..1, as the plain decimal text of the stored NUMERIC at full stored precision, trailing zeros included -- rendered exactly as the commitment payload renders it. */
@@ -2623,7 +3443,7 @@ export type PickSportsTeam = {
     label: string | null;
     /** Abbreviated team label (e.g. "POR"). */
     short_label: string | null;
-    /** Full team or competitor name (e.g. "Portugal national football team"). */
+    /** The name to show for this team or competitor, the same on every surface (e.g. "UCF Knights", "Oklahoma City Thunder", "Portugal"). `label` keeps the market outcome's own spelling. */
     full_name: string | null;
     /** Provider team identifier (Polymarket /teams id). */
     provider_id: number | null;
@@ -2650,6 +3470,10 @@ export type PickSportsTeam = {
     headshot_revision?: number;
     /** Optional latest retrieved ATP/WTA singles rank for this player. Absent for unranked, ambiguous, doubles, expired, or unavailable identities. This is not rank at match time. */
     ranking?: TennisRanking;
+    /** True when artwork measurements show that the team mark disappears on a white background and needs a dark plate there: the light-background twin of logo_mark_dark. Vendored crest verdicts are tied to the exact asset bytes; provider artwork is measured on white by the teams sync. Always sent; false when no current measurement marks the logo light. */
+    logo_mark_light: boolean;
+    /** True when logo_mark_dark and logo_mark_light are both measurements of this exact logo URL, so their false means the mark is legible on that background. Every vendored crest is measured; a provider logo is measured once the teams sync has scored it, usually within a few hourly cycles of first appearing. Always sent; false while the logo is not measured yet. */
+    logo_mark_measured: boolean;
 };
 export type PlatformCapabilities = {
     grade: PlatformCapabilityStatus;
@@ -2686,7 +3510,7 @@ export type PnlCorrection = {
     amount: number;
     /** Polymarket's net realized P&L plus amount. Since 2026-10-22 the grade reads this figure's sports and esports share. Omitted when Polymarket's figure is. */
     realized?: number;
-    /** Polymarket's net total P&L plus amount: the 0xinsider profile's Total P&L. Omitted when Polymarket's figure is, and on leaderboard entries. */
+    /** Polymarket's net total P&L over every Polymarket market of the wallet, plus amount. Omitted when Polymarket's figure is, and on leaderboard entries. */
     net_total?: number;
     /** The newest measurement among the measured markets. */
     as_of: string;
@@ -2729,10 +3553,16 @@ export type Position = {
         address: string;
         username?: string;
         grade?: "S" | "A" | "B" | "C" | "D" | "F";
-        /** Win rate as a ratio from 0 to 1 (0.62 means 62%), the same scale as stats.win_rate on GET /api/v1/trader/{address}. Absent when unknown. */
+        /** Sports and esports win rate as a ratio from 0 to 1 (0.62 means 62%): wins over the decided sports and esports markets on the wallet's record, the same figure as pnl.in_scope.win_rate and stats.win_rate on GET /api/v1/trader/{address}. Since 2026-10-27 it no longer counts other markets (#29953). Absent when the wallet has no record or no decided market. */
         win_rate?: number;
-        /** Polymarket's net total P&L for the wallet in USD: native Polymarket position P&L across all markets, fees included, plus credited maker and taker rebates (trader_trading_pnl.net_total_pnl). The 0xinsider profile's Total P&L is this figure unless the wallet has a published correction for neg-risk conversions, which GET /api/v1/trader/{address} serves as pnl.correction; the profile then shows pnl.correction.net_total. Not the Polymarket leaderboard figure, which GET /api/v1/trader/{address} still serves as pnl.total. Omitted when the wallet has no native accounting snapshot; the leaderboard figure is never substituted. */
+        /**
+         * Deprecated since 2026-10-27 and never sent. It was Polymarket's net total P&L over every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29953). Read trader.in_scope_realized_pnl.
+         * @deprecated
+         */
         pnl?: number;
+        /** The wallet's realized P&L in USD on sports and esports markets, the figure the 0xinsider profile shows: the record behind pnl.in_scope.realized_pnl on GET /api/v1/trader/{address}, to cents. For a graded wallet it is read from the latest grading pass, so it can trail that figure until the next pass. Omitted until 0xinsider has computed the wallet's record (#29953). */
+        in_scope_realized_pnl?: number;
+        /** Sports and esports markets on the wallet's record, pnl.in_scope.markets on GET /api/v1/trader/{address}. Since 2026-10-27 it no longer counts other markets (#29953). Absent when the wallet has no record. */
         markets?: number;
         /** Days since the wallet's first-seen time. For a wallet 0xinsider first recorded on or after March 21, 2026, that is when 0xinsider recorded it. For a wallet recorded earlier, it is usually the wallet's first Polymarket activity, so the age can run to years. It is not the wallet's on-chain age or the time of its first trade. Absent when the first-seen time is unknown. */
         wallet_age_days?: number;
@@ -2871,7 +3701,7 @@ export type ReportPayload = {
         /** Trader pseudonym, when no display name is known. */
         pseudonym: string | null;
         /** Trader grade (S-F) at snapshot time. */
-        trader_grade: string | null;
+        trader_grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
     })[] | null;
     top_whale_trades: ({
         /** Provider outcome label for the traded side. */
@@ -2899,11 +3729,19 @@ export type ReportPayload = {
         /** Trader pseudonym, when no display name is known. */
         pseudonym: string | null;
         /** Trader grade (S-F) at snapshot time. */
-        trader_grade: string | null;
+        trader_grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+    })[] | null;
+    categories: ({
+        category: string | null;
+        large_trade_count: number | null;
+        whale_trade_count: number | null;
+        category_volume: number | 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;
+    grade_distribution: ({
+        grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+        count: number | null;
+    })[] | null;
     /** Which markets the report counts. sports_and_esports for a period that ends on or after 2026-10-21: totals, categories, top trades and the grade cohort cover sports and esports markets only. all_markets for an earlier period, whose stored report keeps every Polymarket market it published. */
     market_scope: "all_markets" | "sports_and_esports";
 };
@@ -2927,6 +3765,60 @@ export type ReportSourceRange = {
     end_date: string;
     timezone: "UTC";
 };
+export type ResolutionReport = {
+    accuracy: number | null;
+    all_wallets_accuracy: number | null;
+    all_wallets_right: number | null;
+    all_wallets_wrong: number | null;
+    date: string | null;
+    generated_at: string | null;
+    grade_basis: "at_resolution" | "current" | null;
+    market_scope: "all_markets" | "sports_and_esports";
+    markets?: ({
+        all_wallets_right: boolean | null;
+        category: string | null;
+        condition_id: string | null;
+        confidence: number | null;
+        event_slug: string | null;
+        out_of_product_scope: boolean;
+        outcome_no: string | null;
+        outcome_yes: string | null;
+        report_at: string;
+        smart_consensus: string | null;
+        smart_right: boolean | null;
+        smart_trader_count: number | null;
+        time_basis: "polymarket_gamma_closed_time" | "observed_resolution";
+        title: string | null;
+        total_smart_pnl: number | null;
+        traders: ({
+            address: string | null;
+            correct: boolean | null;
+            cost: number | null;
+            grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+            last_traded_at: string | null;
+            pnl: number | null;
+            side: string | null;
+            username: string | null;
+        })[];
+        weighted_no: number | null;
+        weighted_yes: number | null;
+        winning_outcome: number | null;
+    })[];
+    markets_without_smart_positions: number | null;
+    no_consensus: number | null;
+    positions_grade_unknown: number | null;
+    positions_without_side: number | null;
+    smart_money_right: number | null;
+    smart_money_wrong: number | null;
+    source_updates_pending: boolean;
+    time_basis_counts: {
+        observed_resolution: number;
+        polymarket_gamma_closed_time: number;
+    } | null;
+    total_resolved: number | null;
+    total_smart_pnl: number | null;
+    with_smart_positions: number | null;
+};
 export type ResponseMeta = {
     /** Unique request ID (req_ prefix). The same value as the X-Request-Id response header, the request's usage accounting row and its log lines. */
     request_id: string;
@@ -3091,6 +3983,50 @@ export type SnapshotState = {
     /** When this body's source read started, the clock finality is judged on. null for a body stored before that clock was recorded. */
     source_read_started_at: string | null;
 };
+export type SportLeaderboard = {
+    as_of: string | null;
+    category: string | null;
+    edge_average: number | null;
+    league: {
+        name: string;
+        ranked_traders: number;
+        slug: string;
+    } | null;
+    limit: number;
+    min_resolved: number;
+    rows: ({
+        address: string;
+        cost: number | null;
+        edge_hold: "category_loss" | "record_incomplete" | null;
+        edge_skill: number | null;
+        grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+        id: string;
+        last_category_trade_at: string | null;
+        losses: number;
+        n_resolved: number;
+        platform: "polymarket";
+        pnl: number | null;
+        price_edge: {
+            avg_price: number;
+            edge: number;
+            edge_lower: number;
+            hit_rate: number;
+            markets: number;
+            status: "ranked" | "too_few_markets" | "sample_mismatch";
+        } | null;
+        rank: number;
+        roi: number | null;
+        username: string | null;
+        volume: number | null;
+        win_rate: number | null;
+        win_rate_wilson_lb: number | null;
+        wins: number;
+    })[];
+    sort: "edge" | "pnl" | "win_rate";
+    sport: string;
+    total_traders: number;
+    volume_scope: "sports_and_esports";
+};
 export type SuspiciousTrade = {
     /** Prefixed ID (rf_...). */
     id: string;
@@ -3145,7 +4081,7 @@ export type SuspiciousTradeFlaggedData = {
     /** Fill price of the flagged trade. */
     price: number;
 };
-/** Optional current-game tennis facts from API-Tennis, aligned with live_score.scores display order. These facts have their own revision and expiry; Polymarket remains the source of sets, match status, period, and the outer live-score revision. New observations require corroborated identity, current set/games, and live state. Cached responses and replayed frames may still carry expired facts, so clients must enforce expires_at. */
+/** Optional current-game tennis facts from API-Tennis, aligned with live_score.scores display order. These facts have their own revision and expiry; Polymarket remains the source of sets, match status, period, and the outer live-score revision. New observations require corroborated identity, current set/games, and live state. Where Polymarket publishes no score (tennis doubles, whose live_score reads one 0-0 set throughout), the group binds on both pairs' names, the tour, the date and API-Tennis's live flag, and carries set_games, the provider's set score for the match. Cached responses and replayed frames may still carry expired facts, so clients must enforce expires_at. */
 export type TennisPoints = {
     source: "api_tennis";
     /** API-Tennis match ID. This is not a Polymarket market or event ID. */
@@ -3162,10 +4098,12 @@ export type TennisPoints = {
     observed_at: string;
     /** Stop displaying the point group at this instant, even if the enclosing score remains fresh. The group expires 30 seconds after observed_at. */
     expires_at: string;
-    /** Current set number. Display points only while this matches the enclosing scoreboard. */
+    /** Current set number. Display points only while this matches the enclosing scoreboard, unless set_games is present. */
     set_number: number;
-    /** Current-set games in first/second order. Display points only while these match the enclosing scoreboard. */
+    /** Current-set games in first/second order. Display points only while these match the enclosing scoreboard, unless set_games is present. */
     games: number[];
+    /** API-Tennis games in every listed set, first set first, each in first/second order. Present only when Polymarket publishes no score for the match (tennis doubles): display these as the set score, and discard the group once live_score carries a nonzero game. A deciding match tie-break is listed as games, for example 9-5. Omitted for every other match. */
+    set_games?: number[][];
 };
 /** A provider-reported ATP/WTA singles rank with independent retrieval and expiry clocks. API-Tennis provides no ranking publication date. Retrieval time does not establish when the tour published the ranking. */
 export type TennisRanking = {
@@ -3195,29 +4133,52 @@ export type Trader = {
     forecast_evidence?: number;
     rank?: number;
     pnl: {
-        /** Polymarket's all-time leaderboard P&L in USD, from Polymarket's latest observation of this wallet on its all-time leaderboard (dated by the leaderboard_pnl data_quality group). Omitted when that leaderboard has no current observation ranking the wallet; 0xinsider requests one, and never serves an older stored figure in its place. Kept for provider parity and back-compat. Not the profile's Total P&L and not realized plus unrealized: it can differ from net_total by a wide margin. Read net_total for the figure the 0xinsider profile shows. */
+        /**
+         * Deprecated since 2026-10-27 and never sent. It was Polymarket's all-time leaderboard P&L, which covered every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29830). Read pnl.in_scope.realized_pnl.
+         * @deprecated
+         */
         total?: number;
-        /** Polymarket's net total P&L in USD: native Polymarket position P&L, with fees already included, plus credited maker and taker rebates (trader_trading_pnl.net_total_pnl). Truncated toward zero to cents before conversion to a JSON number. Omitted when the wallet has no native accounting snapshot; pnl.total is never substituted. The 0xinsider profile's Total P&L is this figure unless pnl.correction is present, then pnl.correction.net_total. */
+        /**
+         * Deprecated since 2026-10-27 and never sent. It was Polymarket's net total P&L over every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29830). Read pnl.in_scope.realized_pnl.
+         * @deprecated
+         */
         net_total?: number;
-        /** The 0xinsider correction to Polymarket's P&L for neg-risk conversions. Present only when one is published; pnl.net_total and pnl.realized keep Polymarket's own figures, and correction.net_total and correction.realized add the amount to them. */
+        /**
+         * Deprecated since 2026-10-27 and never sent. It was the neg-risk conversion correction to the wallet-wide pnl.net_total and pnl.realized (#29830). Its sports and esports part is inside pnl.in_scope.realized_pnl.
+         * @deprecated
+         */
         correction?: PnlCorrection;
-        /** true while 0xinsider is still checking some of the wallet's converted neg-risk markets with a sports or esports event (not yet measured, measured and not yet checked for transfers, or its latest reads keep failing), so the correction may change, or arrive where none is published yet. Omitted otherwise. */
+        /** true while 0xinsider is still checking some of the wallet's converted neg-risk markets with a sports or esports event (not yet measured, measured and not yet checked for transfers, or its latest reads keep failing), so the correction's part inside pnl.in_scope.realized_pnl may change, or arrive where none is published yet. Omitted otherwise. */
         correction_pending?: boolean;
-        /** For pnl.realized, expand=trust marks a matching native accounting snapshot as computed: native Polymarket realized P&L plus credited maker and taker rebates, with fees already included. The exact numeric value is truncated toward zero to cents before conversion to a JSON number. Without a matching native accounting snapshot, pnl.realized is omitted and its trust metadata is unavailable. Raw total P&L is never substituted for realized P&L. */
+        /**
+         * Deprecated since 2026-10-27 and never sent. It was native Polymarket realized P&L over every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29830). Read pnl.in_scope.realized_pnl.
+         * @deprecated
+         */
         realized?: number;
+        /** Unrealized (mark-to-market) P&L in USD of the wallet's open positions on its synced sports and esports markets: Polymarket's cashPnl, current value minus cost, summed over the positions still held, from the open-position aggregate (dated by the positions data_quality group). It is the same figure as position_summary.unrealized_mtm on GET /api/v1/trader/{address}/context. It leaves out the realized P&L of partial sells on those markets, which pnl.in_scope.realized_pnl already counts; until 2026-11-02 (#32459) it added it, so pnl.in_scope.realized_pnl plus pnl.unrealized counted those sells twice. Each open position's market is judged when the aggregate is read (#32119), so a stored position on a market of another category (one that moved out of sports and esports, or one stored before its category was known) is left out. Before 2026-10-27 (#29366) it covered every Polymarket market. */
         unrealized?: number;
-        /** Additive lossless counterpart. Omitted when the trusted native realized-P&L source is unavailable; existing numeric fields keep their display-safe v1 semantics. */
+        /**
+         * Deprecated since 2026-10-27 and never sent: its one member was the lossless counterpart of the retired pnl.realized (#29830).
+         * @deprecated
+         */
         exact?: TraderPnlExact;
-        /** Additive (#27311): the wallet's sports and esports record, the figure the 0xinsider profile headlines. Omitted until 0xinsider has computed the wallet's record; absent means not computed yet, never zero. The other pnl fields stay Polymarket's wallet-wide figures. */
+        /** Additive (#27311): the wallet's sports and esports record, the figure the 0xinsider profile headlines, dated by the sports_record data_quality group. Omitted until 0xinsider has computed the wallet's record; absent means not computed yet, never zero. Also omitted for a wallet that traded no sports or esports market, which never gets a record: then stats.markets_traded is 0 and the sports_record group is partial with owner traders.last_synced (since 2026-10-29, #30589, #30657). Also omitted for a wallet that trades only combos and holds no single sports or esports market: the record counts single markets, so it has none, stats.markets_traded and stats.win_rate are omitted, and the sports_record group is partial with owner traders.last_synced (since 2026-10-29, #30637). Since 2026-10-27 it is the wallet's only P&L figure besides pnl.unrealized (#29830). */
         in_scope?: TraderPnlInScope;
     };
+    /** Sports and esports markets only since 2026-10-27 (#29830): markets_traded and win_rate come from the wallet's sports and esports record (pnl.in_scope), and total_volume from its stored trade days. A wallet that traded no sports or esports market never gets a record: markets_traded is 0 and win_rate is omitted (since 2026-10-29, #30589, #30657). A wallet that trades only combos has no record either: both are omitted (since 2026-10-29, #30637). */
     stats: {
+        /** Sports and esports markets the wallet traded, any status: pnl.in_scope.markets, dated by the sports_record data_quality group. Omitted until the record is computed. 0 for a wallet that traded no sports or esports market, which never gets a record: at its last completed sync Polymarket counted no market for it, or the sync read its Polymarket positions and found no sports or esports market; none is stored, and no Polymarket sports or esports board lists it; the sports_record group then carries the sync clock (since 2026-10-29, #30589; the second case since #30657). Omitted for a wallet that trades only combos and holds no single sports or esports market, which has no record (since 2026-10-29, #30637). Counted every Polymarket market before 2026-10-27. */
         markets_traded?: number;
+        /** Won over decided sports and esports markets, 0 to 1: pnl.in_scope.win_rate truncated to four places, dated by the sports_record data_quality group. Omitted until the record is computed, while the wallet has no decided sports or esports market, for a wallet that traded no sports or esports market (#30589, #30657), and for one that trades only combos (#30637). Counted every Polymarket market before 2026-10-27. */
         win_rate?: number;
+        /**
+         * Deprecated since 2026-10-27 and never sent. It counted mark-to-market days over every Polymarket market of the wallet (#29830). Read stats.all.win_days and stats.all.loss_days from GET /api/v1/trader/{address}/pnl, which count sports and esports days.
+         * @deprecated
+         */
         daily_win_rate?: number;
-        /** Full-history both-sides USD cash volume from Polymarket user-volume. Omitted without a verified observation; never leaderboard shares. Its observation time is published as the volume group in data_quality and as trust.total_volume.freshness.as_of, both trader_usd_volume.observed_at; synced_at is a different clock and is never a substitute for it. */
+        /** Sports and esports USD volume, all time: the sum of every stored trade day's in-scope volume (trader_trade_daily_rollups.in_scope_volume_total), the profile's Volume traded. Dated by the volume data_quality group, which carries the trader sync clock. 0 for a synced wallet with no stored trade day. Omitted before the wallet's first completed sync and while any stored day's in-scope volume is not computed yet, so a partial sum is never served. Polymarket's full-history wallet-wide volume before 2026-10-27 (#29830). */
         total_volume?: number;
-        /** Additive lossless counterpart to `total_volume`. Omitted when the verified provider observation is unavailable. */
+        /** Additive lossless counterpart to `total_volume`, present exactly when it is. */
         exact?: TraderStatsExact;
     };
     strategy?: {
@@ -3228,7 +4189,10 @@ export type Trader = {
     };
     /** Per-category rank context when expand=categories is requested. Values include available rank, category totals, performance and record counts; scaled_total_pnl is a legacy alias of total_pnl. Its measurement basis and update timing differ from the plain record returned by GET /api/v1/trader/{address}/categories, so the two need not agree. Use this for rank context and that route for the plain record. Sports and esports only (#28761): keys are sports and esports categories, and a category outside them is omitted, as on that route. The inner key-set is intentionally unconstrained and may contain additional compatibility fields. */
     category_strengths?: Record<string, unknown>;
-    /** Curated advanced risk/performance metrics (expand=quant_metrics or expand[]=quant_metrics). Omitted unless expanded and backed by a computed row strictly under six hours old; a missing row, NULL computed_at, or age of exactly six hours or more is stale and omitted. Provider-input changes may intentionally lag inside the bounded six-hour window. When present, all listed fields are present (each is a number or null); null means insufficient trade history and must not be treated as 0. The fixed field shape is unchanged. */
+    /**
+     * Deprecated since 2026-10-27 and never sent. These advanced risk and performance metrics covered every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29589). expand=quant_metrics is still accepted and adds nothing. For the sports and esports record read pnl.in_scope here, and GET /api/v1/trader/{address}/pnl for its daily series. The member shape below is what the object held before; it is kept so existing type declarations still compile.
+     * @deprecated
+     */
     quant_metrics?: {
         /** Trader smart score on a 0..100 display scale; higher is stronger. Null when unavailable. */
         smart_score: number | null;
@@ -3249,11 +4213,13 @@ export type Trader = {
         /** Cross-sectional percentile rank of edge consistency versus all traders, 0-100. null when insufficient history. */
         consistency_percentile: number | null;
     };
+    /** When the wallet last traded: its most recent recorded trade, the same value the leaderboard entry's last_active carries (which re-reads it hourly). A cached body (meta.cached true) can lag a new trade by up to 60 seconds. No data_quality group dates it: the value is itself a trade time. Since 2026-11-02 (#32324); before, it carried the time 0xinsider last synced the wallet, the same value as synced_at. Omitted when the wallet has no recorded trade. */
     last_active?: string;
+    /** When 0xinsider last completed a sync of the wallet (traders.last_synced), dated by the sync data_quality group. Not when the wallet traded: read last_active for that. */
     synced_at?: string;
     /** synced, unknown, or pending. */
     sync_status?: string;
-    /** Data age and coverage for this trader body. Always present. Its six groups are sync (traders.last_synced, covering pnl.net_total, pnl.realized, stats.markets_traded, stats.win_rate, stats.daily_win_rate, last_active, synced_at and sync_status), ranking (trader_rankings.computed_at, covering grade, score, streak_tier, forecast_score and forecast_evidence), leaderboard_rank (leaderboard_rank_refresh_state.completed_at, the completion time of the latest fully completed global rank refresh, covering rank), volume (trader_usd_volume.observed_at, covering stats.total_volume) and positions (trader_position_snapshots.last_refreshed_at with traders.last_synced as fallback, covering pnl.unrealized, the open-position aggregate) and leaderboard_pnl (trader_profile_provider_snapshots.observed_at, covering pnl.total: unavailable when Polymarket's all-time leaderboard has no current observation ranking the wallet). The positions clock is the latest successful /positions snapshot when one exists, otherwise the last completed trader sync; it does not date closed or native accounting values. A rank or position value remains unknown or unavailable when its clock or value is absent. For an unknown wallet every group is unavailable. If the open-position read itself fails, positions is unavailable with a reason that says so, pnl.unrealized is absent, and the body is answered fresh (meta.cached false) and is not kept for later callers. */
+    /** Data age and coverage for this trader body. Always present. Its six groups are sync (traders.last_synced, covering synced_at and sync_status; it covered last_active until 2026-11-02, #32324, and no group covers last_active now, since the value is itself a trade time), sports_record (trader_product_scope_records.computed_at, covering pnl.in_scope, stats.markets_traded and stats.win_rate: unavailable until the wallet's sports and esports record is computed, partial while it has no decided sports or esports market; for a wallet that traded no sports or esports market, which never gets a record, partial with owner traders.last_synced, as of the completed sync that found none, stats.markets_traded 0 and pnl.in_scope and stats.win_rate omitted, since 2026-10-29, #30589, #30657; for a wallet that trades only combos and holds no single sports or esports market, partial with owner traders.last_synced and all three omitted, since 2026-10-29, #30637), ranking (trader_rankings.computed_at, covering grade, score, streak_tier, forecast_score and forecast_evidence), leaderboard_rank (leaderboard_rank_refresh_state.completed_at, the completion time of the latest fully completed global rank refresh, covering rank), volume (traders.last_synced, covering stats.total_volume, the sum of the trade days the sync stores: unavailable before the first completed sync and while a stored day's sports and esports volume is not computed) and positions (trader_position_snapshots.last_refreshed_at with traders.last_synced as fallback, covering pnl.unrealized, the open-position aggregate). Since 2026-10-27 (#29830) there is no leaderboard_pnl group, and volume is dated by the sync clock instead of trader_usd_volume.observed_at. The positions clock is the latest successful /positions snapshot when one exists, otherwise the last completed trader sync. A rank or position value remains unknown or unavailable when its clock or value is absent. For an unknown wallet every group is unavailable. If the open-position read itself fails, positions is unavailable with a reason that says so, pnl.unrealized is absent, and the body is answered fresh (meta.cached false) and is not kept for later callers. */
     data_quality: DataQuality;
     /** Field-level trust metadata. Present only when expand=trust or expand[]=trust is requested. */
     trust?: TraderTrust;
@@ -3291,31 +4257,37 @@ export type TraderCategoryRecords = {
 };
 export type TraderContext = {
     trader: Trader;
-    /** Aggregate position and P&L coverage for the trader. Counts all Polymarket markets, not only sports and esports. Omitted entirely (key absent, never null) when the trader is not in the local database or native net economics is unavailable. Realized fields remain numbers when present, including a genuine zero. */
+    /** Aggregate position and P&L coverage for the trader, over its synced markets. markets_open, unrealized_mtm and cost_basis_locked cover the open positions on sports and esports markets, each market judged when the summary is read (#32119). markets_synced, markets_resolved and the resolved win figures count every stored market: since 2026-10-27 (#29366) those are mostly sports and esports markets, but a market that moved out of sports and esports, or one stored before its category was known, stays in them, and sync_coverage counts every category on both sides. markets_total, total_realized_pnl and synced_realized_pnl still cover every Polymarket market of the wallet. Omitted entirely (key absent, never null) when the trader is not in the local database or native net economics is unavailable. Realized fields remain numbers when present, including a genuine zero. */
     position_summary?: {
-        /** Provider markets_traded count when known; null when the provider total is unavailable. */
+        /** Polymarket's count of the markets the wallet traded, every category, when known; null when the provider total is unavailable. */
         markets_total: number | null;
         /** Markets with locally synced position rows. */
         markets_synced: number;
-        /** Synced markets that have resolved. */
+        /** Markets outside sports and esports that the wallet traded and whose synced rows 0xinsider deleted, counted when they were deleted (from 2026-10-27, #29366); 0 when none were. Not in markets_synced or any other count here; sync_coverage adds it to markets_synced so both sides of that ratio count every category. */
+        markets_pruned: number;
+        /** Markets outside sports and esports that the wallet first traded since 2026-10-26, which 0xinsider does not store, counted as the wallet syncs (#30165); 0 when none are. Not in markets_synced, markets_pruned or any other count here; sync_coverage adds it with markets_pruned to markets_synced. */
+        markets_unstored: number;
+        /** Combo markets the wallet traded, as maker or taker, counted from the combo fills 0xinsider indexes from the chain (#30218); 0 when it traded none. Polymarket counts each combo as one market in markets_total, and no position read lists one, so a combo is in no other count here; sync_coverage adds it with markets_pruned and markets_unstored to markets_synced. */
+        markets_combo: number;
+        /** Synced markets the wallet has settled: it closed its position by selling out, or the market resolved. Its P&L there is final. */
         markets_resolved: number;
-        /** Synced markets still open with residual value (open positions with current value > 0). */
+        /** Synced sports and esports markets still open with residual value (open positions with current value > 0); a stored market of another category is left out (#32119). */
         markets_open: number;
-        /** markets_synced divided by markets_total when the provider total is known (capped at 1.0); 0.0-1.0. When markets_total is unknown or not positive (null, 0, or negative), this is 1.0 if any markets are synced (else 0.0), so cross-check markets_total before treating 1.0 as full coverage. */
+        /** markets_synced plus markets_pruned plus markets_unstored plus markets_combo, divided by markets_total when the provider total is known (capped at 1.0); 0.0-1.0. Both sides count every category: no Polymarket count of a wallet's sports and esports markets exists, so the ratio does not estimate one. When markets_total is unknown or not positive (null, 0, or negative), this is 1.0 if that sum is positive (else 0.0), so cross-check markets_total before treating 1.0 as full coverage. */
         sync_coverage: number;
-        /** Native net realized P&L (USD) including credited rebates, minus the stored realized component of open positions with positive current value. Rebates are credited to the account, not to a position, so every credited rebate stays in this figure. NUMERIC arithmetic precedes conversion to a JSON number. */
+        /** Native net realized P&L (USD) over every Polymarket market of the wallet, including credited rebates, minus the stored realized component of synced open positions with positive current value. Rebates are credited to the account, not to a position, so every credited rebate stays in this figure. NUMERIC arithmetic precedes conversion to a JSON number. */
         synced_realized_pnl: number;
-        /** Native net realized P&L (USD) including credited rebates, read directly from the accounting snapshot. Position sync_coverage is separate from this accounting basis. */
+        /** Native net realized P&L (USD) over every Polymarket market of the wallet, including credited rebates, read directly from the accounting snapshot. For the sports and esports figure read trader.pnl.in_scope.realized_pnl. Position sync_coverage is separate from this accounting basis. */
         total_realized_pnl: number;
-        /** Mark-to-market unrealized P&L (USD) on open positions. */
+        /** Mark-to-market unrealized P&L (USD) on open positions in synced sports and esports markets (#32119): Polymarket's cashPnl summed over the positions still held, without the realized P&L of partial sells. The same figure as trader.pnl.unrealized, in this body and on GET /api/v1/trader/{address}, since 2026-11-02 (#32459). */
         unrealized_mtm: number;
-        /** Cost basis (USD) currently tied up in open positions. */
+        /** Cost basis (USD) currently tied up in open positions in synced sports and esports markets (#32119). */
         cost_basis_locked: number;
-        /** Win rate as a percentage (0-100): resolved_wins over resolved_decided. A resolved market that settled at exactly zero realized P&L (a void, a refund, a fully hedged position) is neither a win nor a loss and is not in the denominator, the same rule the leaderboard applies; null when no resolved market was decided. It is the rule of trader.stats.win_rate, read from the synced rows at request time; stats.win_rate is the stored figure the profile shows, refreshed by each sync and a few minutes after a closed-history write. context.md prints one Market win rate: this one when position_summary is present, else stats.win_rate. */
+        /** Win rate as a percentage (0-100): resolved_wins over resolved_decided. A settled market that closed at exactly zero realized P&L (a void, a refund, a fully hedged position) is neither a win nor a loss and is not in the denominator, the same rule the leaderboard applies; null when no resolved market was decided. It is the rule of trader.stats.win_rate, read from the synced rows at request time; stats.win_rate is the stored figure the profile shows, refreshed by each sync and a few minutes after a closed-history write. context.md prints one Market win rate, stats.win_rate. */
         resolved_win_rate: number | null;
-        /** Resolved markets that settled at positive realized P&L: the win-rate numerator. Additive; null only on a summary cached before the field existed. */
+        /** Settled markets that closed at positive realized P&L: the win-rate numerator. Additive; null only on a summary cached before the field existed. */
         resolved_wins: number | null;
-        /** Resolved markets that settled at a non-zero realized P&L: the win-rate denominator. At most markets_resolved; the difference is markets settled at exactly zero or with an unknown P&L. Additive; null only on a summary cached before the field existed. */
+        /** Settled markets that closed at a non-zero realized P&L: the win-rate denominator. At most markets_resolved; the difference is markets settled at exactly zero or with an unknown P&L. Additive; null only on a summary cached before the field existed. */
         resolved_decided: number | null;
         /** RFC3339 freshness of the served OPEN-position data: the trader's latest /positions snapshot, else the last completed sync. The snapshot advances ONLY open positions, so read this as the open-position freshness clock -- the resolved/closed aggregates on this same summary (markets_resolved, resolved_win_rate) advance only on a full sync. The value is the /positions snapshot instant when one exists, so it is typically at or just before the trader-level last sync on a normal sync, and can be AFTER it while the active-view loop refreshes open positions between full syncs. This clock does not establish native accounting freshness. Always present on the wire (serialized as JSON null when the trader has neither a snapshot nor a sync); never omitted. */
         as_of: string | null;
@@ -3379,7 +4351,7 @@ export type TraderExportJob = {
     object: "trader_export_job";
     data: {
         job_id: number;
-        /** 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. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
+        /** queued: waiting for a worker. A running job reads queued again, with error saying why, when its worker restarts for a deploy (the next worker claims it within seconds) or stops without handing it back (requeued within a minute of its 30-minute lease lapsing); it starts again from the beginning. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the reconciler reads the object back within a minute, retries a failed readback an hour later, 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. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
         status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled";
         format: "json" | "ndjson" | "csv";
         /** Trade rows the file holds: trades in the wallet's sports and esports markets, counted in the file's own read snapshot. Null until the worker has read the snapshot (queued, and early in running); a job accepted before 2026-10-22 can carry the earlier all-markets estimate until its file is read. */
@@ -3410,7 +4382,7 @@ export type TraderExportJob = {
         cancel_requested_at: string | null;
         /** When the job reached cancelled; null until then. */
         cancelled_at: string | null;
-        /** Worker claims so far. */
+        /** Worker claims so far. A claim handed back when its worker restarts for a deploy is not counted, so attempt steps back by one when the job reads queued again for that reason. */
         attempt: number;
         /** The job fails when attempt reaches this. */
         max_attempts: number;
@@ -3444,7 +4416,7 @@ export type TraderExportPositionWatermark = {
 };
 export type TraderExportSnapshot = {
     address: string;
-    /** The markets the export file's trades and markets sections hold: sports and esports markets only. counts.exported_markets, counts.estimated_trade_rows, counts.estimated_size_mb, reconciliation.exported_market_cost_basis and source_range.latest_trade_at and latest_market_activity_at describe those markets, and reconciliation.exported_activity_volume is the cash the wallet traded in sports and esports markets. The pnl dates, pnl_days and completeness cover every market of the wallet. */
+    /** The markets the export file's trades and markets sections hold: sports and esports markets only. counts.exported_markets, counts.estimated_trade_rows, counts.estimated_size_mb, reconciliation.exported_market_cost_basis and source_range.latest_trade_at and latest_market_activity_at describe those markets, and reconciliation.exported_activity_volume is the cash the wallet traded in sports and esports markets. source_range.first_pnl_date, last_pnl_date and pnl_series_status and counts.pnl_days describe the file's pnl section, the wallet's sports and esports realized P&L by day. completeness.sync_coverage is the wallet's stored markets (its sports and esports markets since 2026-10-27, #29366) plus the markets of other categories whose rows were deleted and counted (position_summary.markets_pruned on the context) and those first traded since 2026-10-26, which are not stored and are counted as the wallet syncs (position_summary.markets_unstored, #30165) and its combo markets, which Polymarket counts and no position read lists (position_summary.markets_combo, #30218), over Polymarket's count of every market it traded: both sides count every category, so a fully synced wallet reads 1.0 and complete. A wallet with nothing stored and no pnl day is empty whatever its coverage. */
     product_scope: "sports_esports_v1";
     generated_at: string;
     source_range: ExportSourceRange;
@@ -3525,11 +4497,11 @@ export type TraderPnl = {
             drawdown: number | null;
         } | null;
     };
-    /** RFC3339 served-freshness clock: when the wallet's sports and esports record, which this series is read from, was last computed; null while series_status is pending. Always present, so read it as a value that can be null rather than a key that can be missing. */
+    /** RFC3339 served-freshness clock: when the wallet's sports and esports record, which this series is read from, was last computed, or, for a wallet that traded no sports or esports market (#30589, #30657) or trades only combos (#30637) and so has no record, its last completed sync; null while series_status is pending. Always present, so read it as a value that can be null rather than a key that can be missing. */
     freshness_at: string | null;
-    /** `ready` when the series is served; an empty one is a wallet with no sports or esports day. `pending` when the wallet's sports and esports record does not carry the daily series yet: every section is empty, realized is null, and the empty sections never mean zero. Retry later. */
+    /** `ready` when the series is served; an empty one is a wallet with no sports or esports day, or one that traded no sports or esports market (#30589, #30657) or trades only combos (#30637). `pending` when the wallet's sports and esports record does not carry the daily series yet: every section is empty, realized is null, and the empty sections never mean zero. Retry later. */
     series_status: "ready" | "pending";
-    /** How the daily series adds up to the wallet's Sports P&L, full precision: dated_pnl + undated_pnl = realized_pnl. null while series_status is pending. */
+    /** How the daily series adds up to the wallet's Sports P&L, full precision: dated_pnl + undated_pnl = realized_pnl. null while series_status is pending, and for a wallet that traded no sports or esports market or trades only combos, which has no record (#30589, #30657, #30637). */
     realized: {
         /** The rule behind realized_pnl, the same basis as pnl.in_scope.basis on GET /api/v1/trader/{address}. */
         basis: "polymarket_sports_esports_v1" | "sports_esports_split_v1";
@@ -3545,7 +4517,7 @@ export type TraderPnl = {
         date: string;
         /** Sports and esports markets this wallet traded on this UTC day, counted from the fills 0xinsider stores for it. Omitted on a day whose stored fills include a market outside sports and esports (stored before October 2026), where the count would include it, and on a day above 20 times the wallet's median day. */
         markets_traded?: number;
-        /** Cash in USD this wallet traded on this UTC day in sports and esports markets, buys and sells, summed from the fills 0xinsider stores for it. Not Polymarket's share count, and not the full-history stats.total_volume on GET /api/v1/trader/{address}, which covers every market. Omitted on a day with realized P&L and no stored sports or esports fill, and, with markets_traded, on a day above 20 times the wallet's median day. */
+        /** Volume in USD this wallet traded on this UTC day in sports and esports markets, buys and sells: each fill's size times its price, fees excluded, the measure of Polymarket user-volume `volume_usdc`, summed from the fills 0xinsider stores for it. A day stored before 2026-10-27 counts the cash each fill moved, fee included, until it is recomputed. Not Polymarket's share count, and not the full-history stats.total_volume on GET /api/v1/trader/{address}, which covers every market. Omitted on a day with realized P&L and no stored sports or esports fill, and, with markets_traded, on a day above 20 times the wallet's median day. */
         total_volume?: number;
         /** Running sum of daily_change through this day. */
         cumulative_profit?: number;
@@ -3629,12 +4601,12 @@ export type TraderPnl = {
         drawdown: number;
     }[];
 };
-/** Lossless counterparts for trader P&L values. The object is omitted when no trusted native realized-P&L snapshot is available. */
+/** Deprecated since 2026-10-27 and never sent: pnl.exact held the lossless counterpart of the retired wallet-wide pnl.realized (#29830). The member shape below is what the object held before; it is kept so existing type declarations still compile. */
 export type TraderPnlExact = {
     /** Native Polymarket realized P&L plus credited maker and taker rebates, with fees included, from the trusted matching `trader_trading_pnl.net_realized_pnl` snapshot. */
     realized: ExactDecimal;
 };
-/** A wallet's sports and esports record (#27311). basis names the rule behind realized_pnl (#29370): polymarket_sports_esports_v1 is Polymarket's own realized P&L for the wallet in its sports and esports categories, plus the wallet's maker and taker rebates apportioned by its sports and esports share of its Polymarket volume (by cost while Polymarket reports no overall volume) and the in-scope part of any published pnl.correction; sports_esports_split_v1, used until both of the wallet's category figures are confirmed, is Polymarket's published realized P&L (pnl.realized plus any published pnl.correction) split into the part earned on sports and esports markets, with fees, refunds and rebates apportioned by cost. Refreshed after each wallet sync and each read of Polymarket's category leaderboards; as_of dates the market counts. */
+/** A wallet's sports and esports record (#27311). basis names the rule behind realized_pnl (#29370): polymarket_sports_esports_v1 is Polymarket's own realized P&L for the wallet in its sports and esports categories, plus the wallet's maker and taker rebates apportioned by its sports and esports share of its Polymarket volume (by cost while Polymarket reports no overall volume) and the in-scope part of any published neg-risk conversion correction; sports_esports_split_v1, used until both of the wallet's category figures are confirmed, is Polymarket's published wallet-wide realized P&L (with any published correction) split into the part earned on sports and esports markets, with fees, refunds and rebates apportioned by cost. Refreshed after each wallet sync and each read of Polymarket's category leaderboards; as_of dates the market counts. */
 export type TraderPnlInScope = {
     /** The rule behind realized_pnl: polymarket_sports_esports_v1 (Polymarket's sports and esports category figures plus apportioned rebates) or sports_esports_split_v1 (the published realized figure split by cost). A new value means the rule changed; compare figures only within one basis. */
     basis: string;
@@ -3642,18 +4614,18 @@ export type TraderPnlInScope = {
     realized_pnl: number | null;
     /** Sports and esports markets the wallet has traded, any status. */
     markets: number;
-    /** Of those, the markets that have resolved. */
+    /** Of those, the settled markets: the wallet closed its position by selling out, or the market resolved. Its P&L there is final. */
     markets_resolved: number;
     /** Share of decided sports and esports markets the wallet won, 0 to 1. null with no decided market. */
     win_rate: number | null;
-    /** The wallet's markets outside sports and esports, which 0xinsider no longer lists. */
+    /** The wallet's markets outside sports and esports, which 0xinsider no longer lists: those it still stores, those whose rows it deleted and counted, and those of other categories first traded since 2026-10-26, which it does not store and counts as the wallet syncs (#30165). */
     markets_out_of_scope: number;
     /** When the record behind these figures was computed. */
     as_of: string;
 };
-/** Lossless counterparts for trader statistics. The object is omitted when the verified provider observation is unavailable. */
+/** Lossless counterparts for trader statistics. The object is present exactly when stats.total_volume is. */
 export type TraderStatsExact = {
-    /** stats.total_volume as an exact decimal: full-history both-sides cash volume in USD, Polymarket user-volume `volume_usdc`, from the verified `trader_usd_volume` observation. Never Polymarket's share count. */
+    /** stats.total_volume as an exact decimal: the sports and esports USD volume, the sum of every stored trade day's `trader_trade_daily_rollups.in_scope_volume_total` (#29830). Polymarket's full-history wallet-wide user volume before 2026-10-27. */
     total_volume: ExactDecimal;
 };
 /** `trader_synced` data: a tracked wallet finished a sync pass and has a fresh grade. The deprecated spelling `whale_trader_synced` delivers the same object until its sunset on 2027-02-01 (#29352). */
@@ -3665,15 +4637,25 @@ export type TraderSyncedData = {
 };
 /** Field-level trust metadata returned only when GET /api/v1/trader/{address} includes expand=trust. */
 export type TraderTrust = {
+    /** Since 2026-10-27 always not_computed: pnl.total is retired and never sent (#29830). The key stays so the object keeps its shape. */
     total_pnl: TrustMetadata;
+    /** Since 2026-10-27 always not_computed: pnl.realized and pnl.exact are retired and never sent (#29830). The key stays so the object keeps its shape. */
     realized_pnl: TrustMetadata;
+    /** Since 2026-10-27 always not_computed: pnl.net_total is retired and never sent (#29830). The key stays so the object keeps its shape. */
     net_total_pnl: TrustMetadata;
-    /** Present only with pnl.correction: a computed value owned by trader_pnl_corrections, dated by the newest measurement behind it. */
+    /**
+     * Deprecated since 2026-10-27 and never sent: it was present only with pnl.correction, which is retired (#29830).
+     * @deprecated
+     */
     pnl_correction?: TrustMetadata;
     unrealized_pnl: TrustMetadata;
+    /** Computed, owned by trader_product_scope_records (markets) and dated by the record's computed_at, since 2026-10-27 (#29830). For a wallet that traded no sports or esports market, which never gets a record, owned by traders (last_synced), the completed sync that found none, and dated by it, since 2026-10-29 (#30589, #30657; owned by traders (markets_traded) until #30657). */
     markets_traded: TrustMetadata;
+    /** Computed, owned by trader_product_scope_records (win_rate) and dated by the record's computed_at, since 2026-10-27 (#29830). */
     win_rate: TrustMetadata;
+    /** Since 2026-10-27 always not_computed: stats.daily_win_rate is retired and never sent (#29830). The key stays so the object keeps its shape. */
     daily_win_rate: TrustMetadata;
+    /** Computed, owned by trader_trade_daily_rollups (in_scope_volume_total) and dated by traders.last_synced, since 2026-10-27 (#29830). */
     total_volume: TrustMetadata;
     grade: TrustMetadata;
     score: TrustMetadata;
@@ -3714,9 +4696,17 @@ export type TrendingWallet = {
     grade?: "S" | "A" | "B" | "C" | "D" | "F";
     /** Hot-streak tier (trailing-7d cross-sectional percentile). Omitted when there is no recent activity. */
     streak_tier?: "hot" | "rising" | "neutral" | "cooling" | "cold";
-    /** Polymarket's net total P&L for the wallet in USD: native Polymarket position P&L across all markets, fees included, plus credited maker and taker rebates (trader_trading_pnl.net_total_pnl). The 0xinsider profile's Total P&L is this figure unless pnl_correction is present, then pnl_correction.net_total. Context only: it does not affect the ranking, which follows trending_pnl_usd. Omitted when the wallet is not in the 0xinsider database or has no native accounting snapshot; the Polymarket leaderboard all-time figure is never substituted. */
+    /** Additive (#29971): the wallet's sports and esports realized P&L in USD, the same figure as pnl.in_scope.realized_pnl on GET /api/v1/trader/{address} and the 0xinsider profile's Sports P&L, as of the board's last rebuild. Context only: it does not affect the ranking, which follows trending_pnl_usd. Omitted when the wallet is not in the 0xinsider database or has no sports and esports record yet: absent means not computed, never zero. */
+    in_scope_realized_pnl?: number;
+    /**
+     * Deprecated since 2026-10-27 and never sent. It was Polymarket's net total P&L over every Polymarket market of the wallet, and wallet figures cover sports and esports markets only (#29971). Read in_scope_realized_pnl.
+     * @deprecated
+     */
     all_time_pnl_usd?: number;
-    /** The 0xinsider correction to Polymarket's P&L for neg-risk conversions. Present only when one is published; all_time_pnl_usd keeps Polymarket's own figure and pnl_correction.net_total is the profile's Total P&L. */
+    /**
+     * Deprecated since 2026-10-27 and never sent. It was the neg-risk conversion correction to the wallet-wide all_time_pnl_usd (#29971). Its sports and esports part is inside in_scope_realized_pnl.
+     * @deprecated
+     */
     pnl_correction?: PnlCorrection;
     all_time_score?: number;
     last_synced?: string;
@@ -3984,7 +4974,7 @@ export type WhaleDatasetJob = {
     object: "whale_dataset_job";
     data: {
         job_id: number;
-        /** 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. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
+        /** queued: waiting for a worker. A running job reads queued again, with error saying why, when its worker restarts for a deploy (the next worker claims it within seconds) or stops without handing it back (requeued within a minute of its 30-minute lease lapsing); it starts again from the beginning. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the reconciler reads the object back within a minute, retries a failed readback an hour later, 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. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
         status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled";
         format: "ndjson";
         total_trades: number | null;
@@ -4013,7 +5003,7 @@ export type WhaleDatasetJob = {
         cancel_requested_at: string | null;
         /** When the job reached cancelled; null until then. */
         cancelled_at: string | null;
-        /** Worker claims so far. */
+        /** Worker claims so far. A claim handed back when its worker restarts for a deploy is not counted, so attempt steps back by one when the job reads queued again for that reason. */
         attempt: number;
         /** The job fails when attempt reaches this. */
         max_attempts: number;
@@ -4091,7 +5081,7 @@ export interface OperationData {
     batchGetTraders: BatchTraderItem[];
     cancelTraderExport: {
         job_id: number;
-        /** 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. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
+        /** queued: waiting for a worker. A running job reads queued again, with error saying why, when its worker restarts for a deploy (the next worker claims it within seconds) or stops without handing it back (requeued within a minute of its 30-minute lease lapsing); it starts again from the beginning. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the reconciler reads the object back within a minute, retries a failed readback an hour later, 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. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
         status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled";
         format: "json" | "ndjson" | "csv";
         /** Trade rows the file holds: trades in the wallet's sports and esports markets, counted in the file's own read snapshot. Null until the worker has read the snapshot (queued, and early in running); a job accepted before 2026-10-22 can carry the earlier all-markets estimate until its file is read. */
@@ -4122,7 +5112,7 @@ export interface OperationData {
         cancel_requested_at: string | null;
         /** When the job reached cancelled; null until then. */
         cancelled_at: string | null;
-        /** Worker claims so far. */
+        /** Worker claims so far. A claim handed back when its worker restarts for a deploy is not counted, so attempt steps back by one when the job reads queued again for that reason. */
         attempt: number;
         /** The job fails when attempt reaches this. */
         max_attempts: number;
@@ -4142,7 +5132,7 @@ export interface OperationData {
     };
     cancelWhaleDataset: {
         job_id: number;
-        /** 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. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
+        /** queued: waiting for a worker. A running job reads queued again, with error saying why, when its worker restarts for a deploy (the next worker claims it within seconds) or stops without handing it back (requeued within a minute of its 30-minute lease lapsing); it starts again from the beginning. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the reconciler reads the object back within a minute, retries a failed readback an hour later, 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. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
         status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled";
         format: "ndjson";
         total_trades: number | null;
@@ -4171,7 +5161,7 @@ export interface OperationData {
         cancel_requested_at: string | null;
         /** When the job reached cancelled; null until then. */
         cancelled_at: string | null;
-        /** Worker claims so far. */
+        /** Worker claims so far. A claim handed back when its worker restarts for a deploy is not counted, so attempt steps back by one when the job reads queued again for that reason. */
         attempt: number;
         /** The job fails when attempt reaches this. */
         max_attempts: number;
@@ -4208,7 +5198,8 @@ export interface OperationData {
     getAccountIdentity: {
         user_id: number;
         credential_id: number;
-        credential_kind: "api_key" | "oauth_grant";
+        /** The kind of credential that made the request: api_key is a full-access developer key, oauth_grant an OAuth access token, integration_key a named integration key with fixed scopes created on https://0xinsider.com/developers. Before integration_key was added, these keys reported oauth_grant. */
+        credential_kind: "api_key" | "oauth_grant" | "integration_key";
         /** The credential is currently valid; revoked, expired or unknown credentials are rejected. */
         credential_status: "active";
         entitlement: {
@@ -4216,10 +5207,11 @@ export interface OperationData {
             /** When paid data access is lapsed, the caller should renew the subscription; otherwise null. */
             recovery_action: "renew_subscription" | null;
         };
-        /** Approved OAuth scopes; null for full developer-key access. */
+        /** The scopes an OAuth grant or integration key carries; null for full developer-key access. */
         scopes: string[] | null;
     };
     getApiDiscovery: ApiDiscovery;
+    getCategoryLeaderboard: CategoryLeader[];
     getCombo: ComboDetail;
     getCombosSummary: CombosSummary;
     getCoverage: Platforms;
@@ -4227,6 +5219,8 @@ export interface OperationData {
     getEdgeHunter: EdgeHunterBoard | EdgeHunterRankedSignal[] | EdgeHunterObservation[];
     getEventReplaySince: EventReplayEvent[];
     getGame: Game;
+    getGameHolders: BatchGameHoldersItem[];
+    getGameSharpMoney: GameSharpMoney;
     getHealth: {
         status: "ok" | "degraded" | "down" | "maintenance";
         db: boolean;
@@ -4257,15 +5251,20 @@ export interface OperationData {
     getMarketHolders: MarketHolder[];
     getMarketIntel: MarketFlow;
     getMarketSnapshot: MarketSnapshot;
+    getMarketTopHolders: MarketTopHolders;
+    getMarketWalletsInOut: MarketWalletsInOut;
     getMonthlyReportSnapshot: ReportSnapshot;
     getPickOfTheDay: PickOfTheDay | PickOfTheDayNoEntitledPicks;
     getPickOfTheDayArchive: PickOfTheDayArchive;
     getPickOfTheDayLedger: PickOfTheDayLedger;
     getPickOfTheDayLedgerEntry: PickOfTheDayLedgerEntry;
+    getPickOfTheDayStats: PickOfTheDayStats;
     getPlatforms: Platforms;
     getPositionTimeline: PositionTimelineEvent[];
     getPositionTimelineById: PositionTimelineEvent[];
     getReports: ReportSnapshot;
+    getResolutionReport: ResolutionReport;
+    getSportLeaderboard: SportLeaderboard;
     getStream: string;
     getSuspiciousTrade: SuspiciousTrade;
     getTrader: Trader;
@@ -4275,7 +5274,7 @@ export interface OperationData {
     getTraderExportSnapshot: TraderExportSnapshot;
     getTraderExportStatus: {
         job_id: number;
-        /** 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. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
+        /** queued: waiting for a worker. A running job reads queued again, with error saying why, when its worker restarts for a deploy (the next worker claims it within seconds) or stops without handing it back (requeued within a minute of its 30-minute lease lapsing); it starts again from the beginning. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the reconciler reads the object back within a minute, retries a failed readback an hour later, 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. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
         status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled";
         format: "json" | "ndjson" | "csv";
         /** Trade rows the file holds: trades in the wallet's sports and esports markets, counted in the file's own read snapshot. Null until the worker has read the snapshot (queued, and early in running); a job accepted before 2026-10-22 can carry the earlier all-markets estimate until its file is read. */
@@ -4306,7 +5305,7 @@ export interface OperationData {
         cancel_requested_at: string | null;
         /** When the job reached cancelled; null until then. */
         cancelled_at: string | null;
-        /** Worker claims so far. */
+        /** Worker claims so far. A claim handed back when its worker restarts for a deploy is not counted, so attempt steps back by one when the job reads queued again for that reason. */
         attempt: number;
         /** The job fails when attempt reaches this. */
         max_attempts: number;
@@ -4369,7 +5368,7 @@ export interface OperationData {
     getWeeklyReportSnapshot: ReportSnapshot;
     getWhaleDatasetStatus: {
         job_id: number;
-        /** 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. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
+        /** queued: waiting for a worker. A running job reads queued again, with error saying why, when its worker restarts for a deploy (the next worker claims it within seconds) or stops without handing it back (requeued within a minute of its 30-minute lease lapsing); it starts again from the beginning. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the reconciler reads the object back within a minute, retries a failed readback an hour later, 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. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
         status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled";
         format: "ndjson";
         total_trades: number | null;
@@ -4398,7 +5397,7 @@ export interface OperationData {
         cancel_requested_at: string | null;
         /** When the job reached cancelled; null until then. */
         cancelled_at: string | null;
-        /** Worker claims so far. */
+        /** Worker claims so far. A claim handed back when its worker restarts for a deploy is not counted, so attempt steps back by one when the job reads queued again for that reason. */
         attempt: number;
         /** The job fails when attempt reaches this. */
         max_attempts: number;
@@ -4418,8 +5417,43 @@ export interface OperationData {
         filters: WhaleDatasetFilters;
     };
     getWhaleTrade: LargeTradeDetail;
+    listCategoryLeaders: CategoryLeader[];
     listComboFills: ComboFill[];
+    listGameMarkets: ({
+        condition_id: string;
+        event_slug: string;
+        group_item_title?: string;
+        id: string;
+        line?: number;
+        line_outcome_index?: number;
+        negative_risk?: boolean;
+        outcomes: {
+            index: number;
+            label?: string;
+            token_id?: string;
+        }[];
+        platform?: string;
+        slug?: string;
+        sports_market_type?: string;
+        status: string;
+        title?: string;
+        sharp_money?: {
+            money_as_of: string | null;
+            outcomes: {
+                index: number;
+                usd: number;
+                wallets: {
+                    a: number;
+                    b: number;
+                    s: number;
+                };
+            }[];
+            status: "computed" | "not_computed" | "unavailable";
+            trader_count: number | null;
+        };
+    })[];
     listGames: Game[];
+    listGameTrades: GameTrade[];
     listInsiderRadar: SuspiciousTrade[];
     listLargePositions: LargePosition[];
     listLargeTradeCounterpartyExecutions: CounterpartyAnalysis;
@@ -4427,6 +5461,7 @@ export interface OperationData {
     listLargeTradeHistory: LargeTrade[];
     listLargeTrades: LargeTrade[];
     listLeaderboard: LeaderboardEntry[];
+    listLeaderboardLeagues: LeaderboardLeagues;
     listPositions: Position[];
     listSharpMoneyFlows: SmartMoneyFlowMarket[];
     listSmartMoneyFlows: SmartMoneyFlowMarket[];
@@ -4448,7 +5483,7 @@ export interface OperationData {
     searchMarkets: MarketSearchResult[];
     submitTraderExport: {
         job_id: number;
-        /** 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. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
+        /** queued: waiting for a worker. A running job reads queued again, with error saying why, when its worker restarts for a deploy (the next worker claims it within seconds) or stops without handing it back (requeued within a minute of its 30-minute lease lapsing); it starts again from the beginning. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the reconciler reads the object back within a minute, retries a failed readback an hour later, 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. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
         status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled";
         format: "json" | "ndjson" | "csv";
         /** Trade rows the file holds: trades in the wallet's sports and esports markets, counted in the file's own read snapshot. Null until the worker has read the snapshot (queued, and early in running); a job accepted before 2026-10-22 can carry the earlier all-markets estimate until its file is read. */
@@ -4479,7 +5514,7 @@ export interface OperationData {
         cancel_requested_at: string | null;
         /** When the job reached cancelled; null until then. */
         cancelled_at: string | null;
-        /** Worker claims so far. */
+        /** Worker claims so far. A claim handed back when its worker restarts for a deploy is not counted, so attempt steps back by one when the job reads queued again for that reason. */
         attempt: number;
         /** The job fails when attempt reaches this. */
         max_attempts: number;
@@ -4499,7 +5534,7 @@ export interface OperationData {
     };
     submitWhaleDataset: {
         job_id: number;
-        /** 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. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
+        /** queued: waiting for a worker. A running job reads queued again, with error saying why, when its worker restarts for a deploy (the next worker claims it within seconds) or stops without handing it back (requeued within a minute of its 30-minute lease lapsing); it starts again from the beginning. running: the worker is streaming rows. reconcile_required: the upload finished but the storage completion answer was lost; the reconciler reads the object back within a minute, retries a failed readback an hour later, 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. cancel_requested: the owner cancelled a running job (POST /api/v1/trader/{address}/export/cancel); the worker stops at its next safe point and the job reads cancelled. cancelled: terminal; the owner cancelled the job and no file was published; submit a new export. A job that has not reached ready by expires_at reads failed with error 'export expired before completion'. failed, cancelled and expired rows stay readable for 48 hours, then the job answers 404. */
         status: "queued" | "running" | "ready" | "failed" | "reconcile_required" | "expired" | "cancel_requested" | "cancelled";
         format: "ndjson";
         total_trades: number | null;
@@ -4528,7 +5563,7 @@ export interface OperationData {
         cancel_requested_at: string | null;
         /** When the job reached cancelled; null until then. */
         cancelled_at: string | null;
-        /** Worker claims so far. */
+        /** Worker claims so far. A claim handed back when its worker restarts for a deploy is not counted, so attempt steps back by one when the job reads queued again for that reason. */
         attempt: number;
         /** The job fails when attempt reaches this. */
         max_attempts: number;
@@ -4583,6 +5618,16 @@ export interface OperationQuery {
     };
     getAccountIdentity: Record<string, never>;
     getApiDiscovery: Record<string, never>;
+    getCategoryLeaderboard: {
+        /** Keep wallets that traded in the category within this window. all (the default) keeps every ranked wallet. */
+        active_within?: "all" | "7d" | "30d" | "90d";
+        /** Independent events a wallet needs in the category to be listed. The site offers 0, 50, 100 and 250. Clamped to 0..1000000. */
+        min_events?: number;
+        /** Maximum number of leaders to return. Out-of-range values are clamped to 1..100. */
+        limit?: number;
+        /** Opaque cel_ pagination cursor from a prior response. It binds the lower-bound/independent-event/wallet boundary to the committed category-skill ranking and to the slug, active_within and min_events of the request that issued it; a cursor from another filter is 400 on cursor, and one issued before the ranking refreshed is 400 with error.reason=cursor_expired. */
+        cursor?: string;
+    };
     getCombo: Record<string, never>;
     getCombosSummary: Record<string, never>;
     getCoverage: Record<string, never>;
@@ -4595,10 +5640,10 @@ export interface OperationQuery {
         view?: "board" | "signals" | "observations";
         /** Legacy canonical bucket alias, now accepted in every view. Provider aliases canonicalize: NFL reaches Football and EPL reaches Soccer. Use leagues for a league-specific selection. An unmappable non-sport category returns an empty result and echoes category non_sport. Combines with other selection axes using AND. */
         category?: string;
-        /** Required for view=observations; wider_holder, in_play or emerging_pile. Rejected for board and signals. wider_holder covers pregame markets outside the funded slate. A market that enters the slate leaves wider_holder; view=signals lists it only while its holder pile leans to one side, its backed side has a holder at or above min_grade and its kickoff is within horizon_hours, and otherwise neither view lists it. Each refresh evaluates at most 8 markets per sport and cohort, wider_holder by soonest kickoff (most graded holders first among equal kickoffs) and in_play by most graded holders, so a market among a sport's 8 soonest stays evaluated until its game starts. wider_holder also evaluates up to 8 more markets per sport that kick off within 24 hours, most graded holders first, so the most-held markets appear up to a day before kickoff. Each of these keeps its place in later refreshes until its game starts while its holder page still shows a card or could not be read, so a more-held market waits for a free place instead of displacing it. Each row's admitted_by names its place, most_held or soonest_kickoff. The rest count in coverage.capacity_limited_markets. Emerging pile is a wider-holder projection with sharp_pct in [0.75,0.85), complete holder scans and future kickoff, not an independent population or arrival history. */
+        /** Required for view=observations; wider_holder, in_play or emerging_pile. Rejected for board and signals. wider_holder covers pregame markets that view=signals does not list at its widest selection (horizon_hours=48, min_grade=B, no selector), so until kickoff a market is read in one view or the other. A market view=signals lists leaves wider_holder as primary_slate_candidate, and is a wider_holder candidate again in the first refresh after view=signals stops listing it; signals_as_of names the view=signals snapshot each refresh read. Each refresh evaluates at most 8 markets per sport and cohort, wider_holder by soonest kickoff (most graded holders first among equal kickoffs) and in_play by most graded holders, so a market among a sport's 8 soonest stays evaluated until its game starts. wider_holder also evaluates up to 8 more markets per sport that kick off within 24 hours, most graded holders first, so the most-held markets appear up to a day before kickoff. Each of these keeps its place in later refreshes until its game starts while its holder page still shows a card or could not be read, so a more-held market waits for a free place instead of displacing it. Each row's admitted_by names its place, most_held or soonest_kickoff. The rest count in coverage.capacity_limited_markets. Emerging pile is a wider-holder projection with sharp_pct in [0.75,0.85), complete holder scans and future kickoff, not an independent population or arrival history. */
         cohort?: "wider_holder" | "in_play" | "emerging_pile";
-        /** Opt-in admission rule for view=observations with cohort=wider_holder; rejected for every other view and cohort. most_held_48h returns the most-held selection instead of the default one: per sport, up to 8 wider_holder markets kicking off within 48 hours, most graded holders first, then most volume, then soonest kickoff, at most 4 per event. It is recomputed every refresh and keeps no place, so a more-held market displaces a less-held one; funded-slate markets stay excluded. Every row carries admitted_by most_held_48h, including a market the default selection also evaluates, and the response echoes admission. funnel, coverage, degraded and degradation_reasons describe this selection: a wider_holder candidate it did not take counts as capacity_limited. Its markets that no default place covers are read after every default market, at most once per 10 minutes, so a row can rest on a holder page up to 15 minutes old (holder_snapshot_at). Omit for the default selection. Cursors and ETags bind it. */
-        admission?: "most_held_48h";
+        /** Opt-in admission rule for view=observations with cohort=wider_holder; rejected for every other view and cohort. most_held_48h returns the most-held selection instead of the default one: per sport, up to 8 wider_holder markets kicking off within 48 hours, most graded holders first, then most volume, then soonest kickoff, at most 4 per event. It is recomputed every refresh and keeps no place, so a more-held market displaces a less-held one; markets view=signals lists stay excluded. Every row carries admitted_by most_held_48h, including a market the default selection also evaluates, and the response echoes admission. funnel, coverage, degraded and degradation_reasons describe this selection: a wider_holder candidate it did not take counts as capacity_limited. Its markets that no default place covers are read after every default market, at most once per 10 minutes, so a row can rest on a holder page up to 15 minutes old (holder_snapshot_at). most_held_48h_by_type requires market_types and runs the same rule within each named type: per sport and market_context.market_type, up to 8 markets (4 per event), most graded holders first, then volume, then soonest kickoff, so a type whose markets hold fewer wallets than team-win markets still gets its own places. Its rows carry admitted_by most_held_48h_by_type and it has no departures. Its markets no other selection read are read after every default and most_held_48h market, at most once per 10 minutes. A market type not asked for in the last 30 minutes answers 503 read_model_warming with Retry-After 45 s while the next refresh computes it. Omit for the default selection. Cursors and ETags bind it. */
+        admission?: "most_held_48h" | "most_held_48h_by_type";
         /** Board and signals: S, A or B, default B. Requires a piled-side holder at the selected grade floor or better, without removing other holders. Rejected for observations. */
         min_grade?: "S" | "A" | "B";
         /** Board row cap defaults to 30 and clamps integer values to 1..30; total counts selected admitted rows before the cap. Signals and observations page size defaults to 20 and clamps to 1..100. */
@@ -4641,6 +5686,13 @@ export interface OperationQuery {
         expand?: "trade"[];
     };
     getGame: Record<string, never>;
+    getGameHolders: {
+        /** 1 to 25 condition_id values of this game's markets, comma-separated. The key may also repeat (condition_ids=a&condition_ids=b). A raw provider condition_id or the mkt_-prefixed market id. */
+        condition_ids: string[];
+        /** Holders per market. Out-of-range values are clamped to 1..100. */
+        limit?: number;
+    };
+    getGameSharpMoney: Record<string, never>;
     getHealth: Record<string, never>;
     getInsiderRadarFlag: Record<string, never>;
     getLargeTrade: Record<string, never>;
@@ -4677,14 +5729,26 @@ export interface OperationQuery {
         /** Include trust metadata for current_price and spread_bps. Repeatable: trust. */
         expand?: "trust"[];
     };
+    getMarketTopHolders: {
+        /** Maximum holders per outcome. Out-of-range values are clamped to 1..100. `totals` covers the whole sample whatever the limit. */
+        limit?: number;
+    };
+    getMarketWalletsInOut: {
+        /** The window the nets are summed over, ending at the read's clock: 24h (the default) or 7d. */
+        window?: "24h" | "7d";
+    };
     getMonthlyReportSnapshot: {
         /** UTC report month in YYYY-MM format. A month that ends before 2024-03-01, the first day report data covers, or starts after tomorrow UTC returns 400 bad_request with error.param=month. */
         month: string;
     };
-    getPickOfTheDay: Record<string, never>;
+    getPickOfTheDay: {
+        /** A product day (America/New_York) in YYYY-MM-DD format, on or before today. Omit it, or send today, for the current read. A past day with no published pick returns 404 not_found with error.param=date; a date after today, or a value that is not a date, returns 400 bad_request with error.param=date. */
+        date?: string;
+    };
     getPickOfTheDayArchive: Record<string, never>;
     getPickOfTheDayLedger: Record<string, never>;
     getPickOfTheDayLedgerEntry: Record<string, never>;
+    getPickOfTheDayStats: Record<string, never>;
     getPlatforms: Record<string, never>;
     getPositionTimeline: {
         /** Market condition_id. One timeline per (trader, market). */
@@ -4708,6 +5772,20 @@ export interface OperationQuery {
         /** Period token for the granularity. daily: UTC date YYYY-MM-DD. weekly: ISO week YYYY-WW for a durable canonical snapshot, or a from,to YYYY-MM-DD pair for an exact ephemeral range limited to 31 inclusive UTC days. A wider explicit range returns 400 invalid_query. monthly: UTC month YYYY-MM. A period that ends before 2024-03-01, the first day report data covers, or starts after tomorrow UTC returns 400 bad_request with error.param=period. */
         period: string;
     };
+    getResolutionReport: {
+        /** UTC report date in YYYY-MM-DD format, no later than today UTC. Any other value returns 400 bad_request with error.param=date. */
+        date: string;
+        /** `totals` returns the counts without `markets`. Any other value than full or totals returns 400 bad_request with error.param=view. */
+        view?: "full" | "totals";
+    };
+    getSportLeaderboard: {
+        /** A league slug of the sport, for example premier-league or cs2, from GET /api/v1/leaderboard/leagues. Omit it for the sport board. */
+        league?: string;
+        /** Ranking axis. Any other value returns 400 bad_request with error.param=sort. */
+        sort?: "edge" | "pnl" | "win_rate";
+        /** Rows to return from the top of the board. Out-of-range values are clamped to 1..100. */
+        limit?: number;
+    };
     getStream: {
         /** Query-string fallback for the Last-Event-ID resume cursor when the client cannot set the request header. Numeric cluster-shared sequence id; non-numeric or absent attaches live with no replay. A future or expired id emits resync. */
         last_event_id?: string;
@@ -4726,11 +5804,11 @@ export interface OperationQuery {
     };
     getSuspiciousTrade: Record<string, never>;
     getTrader: {
-        /** Backward-compatible alias for expand. Repeatable: strategy, categories, quant_metrics, trust. */
+        /** Backward-compatible alias for expand. Repeatable: strategy, categories, trust. quant_metrics is accepted and returns nothing since 2026-10-27. */
         "expand[]"?: ("strategy" | "categories" | "quant_metrics" | "trust")[];
-        /** Include heavy fields and trust metadata. Repeatable: strategy, categories, quant_metrics, trust. */
+        /** Include heavy fields and trust metadata. Repeatable: strategy, categories, trust. quant_metrics is accepted and returns nothing since 2026-10-27. */
         expand?: ("strategy" | "categories" | "quant_metrics" | "trust")[];
-        /** Opt into a whole-response freshness ceiling in seconds. The server returns 200 only when data_quality.status is fresh and data_quality.as_of is no older than this value; otherwise it returns 409 with error.reason=freshness_ceiling_unsatisfied. No refresh or alternate read is attempted. */
+        /** Opt into a whole-response freshness ceiling in seconds. The server returns 200 only when data_quality.status is fresh or stale and data_quality.as_of is no older than this value; otherwise it returns 409 with error.reason=freshness_ceiling_unsatisfied. No refresh or alternate read is attempted. */
         max_age_s?: number;
     };
     getTraderCategoryRecords: {
@@ -4771,6 +5849,7 @@ export interface OperationQuery {
     };
     getWhaleDatasetStatus: Record<string, never>;
     getWhaleTrade: Record<string, never>;
+    listCategoryLeaders: Record<string, never>;
     listComboFills: {
         /** CSV of pending, won, or lost; all clears the filter. Unknown results appear only in unfiltered lists. */
         result?: string;
@@ -4795,21 +5874,45 @@ export interface OperationQuery {
         /** Offset for ranked largest or payout ordering; use returned next_offset. */
         offset?: number;
     };
+    listGameMarkets: {
+        /** Comma-separated provider market types to keep, case-insensitive: spreads, totals, points, first_half_totals. Omitted keeps every type. An unknown type returns an empty page, not a 400; families lists the event's types. */
+        sports_market_type?: string;
+        /** active, closed or all. closed means the provider closed the market or it resolved. */
+        status?: "active" | "closed" | "all";
+        /** Page size. Out-of-range values are clamped to 1..100. */
+        limit?: number;
+        /** Opaque gmk_v1_ cursor from next_cursor, sent with the same filters. It pins the page position (sports_market_type, line, condition_id), not a snapshot. A cursor this endpoint did not issue returns 400 with error.param=cursor. */
+        cursor?: string;
+        /** sharp_money adds each row's sharp_money: the game page's per-line split, side USD and S, A and B wallet counts per outcome. One read for the event whatever the page size; the request costs 5 instead of 2. Pro and Max. Repeatable: sharp_money. */
+        expand?: "sharp_money"[];
+        /** Backward-compatible alias for expand. Repeatable: sharp_money. */
+        "expand[]"?: "sharp_money"[];
+    };
     listGames: {
         /** Canonical sport bucket, case-insensitive, with - and _ read as a space: table-tennis and Table Tennis are the same bucket. Omit for every covered sport. A bucket this deployment does not serve returns an empty page. */
         sport?: string;
-        /** League tag, case-insensitive, as coverage.leagues spells it: nfl, epl, cs2, euroleague. EuroLeague games use sport=Basketball and league=euroleague. Omit for every league inside the selected sports. */
+        /** League tag, case-insensitive, as coverage.leagues spells it: nfl, epl, cs2, euroleague, cbb, cwbb. EuroLeague games use sport=Basketball and league=euroleague; NCAA men's and women's college basketball games use sport=Basketball with league=cbb and league=cwbb. Omit for every league inside the selected sports. */
         league?: string;
-        /** Keep only games in this state. A value outside the enum returns an empty page. */
+        /** Keep only games in this state. ended, cancelled and postponed also list finished games that have left the live board, read from their stored records, for kickoffs within starts_after..starts_before (default: the 7 days before now). Without status, or with any other state, the list is the live and upcoming board. A value outside the enum returns an empty page. */
         status?: "scheduled" | "live" | "paused" | "ended" | "postponed" | "cancelled" | "suspended" | "delayed" | "unknown";
-        /** RFC 3339 instant. Keep only games whose kickoff is at or after it. Games with no published kickoff are excluded whenever either bound is set. */
+        /** RFC 3339 instant. Keep only games whose kickoff is at or after it. Games with no published kickoff are excluded whenever either bound is set. With a finished status, the stored games' look-back starts here; omitted, it starts 7 days before starts_before, and nothing caps an earlier value. */
         starts_after?: string;
         /** RFC 3339 instant. Keep only games whose kickoff is at or before it. Must be at or after starts_after. */
         starts_before?: string;
+        /** Which games to read. all, the default, lists the whole covered catalog, which can start with games the provider still holds open weeks after kickoff. now lists what is on now: every game the provider reports in play (live or paused), plus any other game whose kickoff was at most 3 hours ago or is still to come; ended, postponed and cancelled games are left out, and a game with no published kickoff stays and sorts last. Combines with every other filter. A value other than all or now returns 400 invalid_query with error.param=window. */
+        window?: "all" | "now";
         /** Page size. Out-of-range values are clamped to 1..100. */
         limit?: number;
-        /** Opaque gms_v1_ cursor from next_cursor. It pins the page position (kickoff and event_slug), not a snapshot: the catalog is live, so a game added or removed between pages moves with it. A cursor this endpoint did not issue returns 400 with error.param=cursor. */
+        /** Opaque gms_v1_ cursor from next_cursor. It pins the page position (kickoff and event_slug), not a snapshot: the catalog is live, so a game added or removed between pages moves with it. With a finished status, a page that spent its read budget carries a cursor past everything it read, which may be past the last game it returned. A cursor this endpoint did not issue returns 400 with error.param=cursor. */
         cursor?: string;
+        /** Backward-compatible alias for expand. Repeatable: sharp_money. */
+        "expand[]"?: "sharp_money"[];
+        /** sharp_money adds each game's sharp_money, the GameSharpMoney object GET /api/v1/games/{event_slug}/sharp-money returns, read from the sport board's cached aggregate: one board read per sport on the page, never a per-game compute. A game the board did not evaluate carries status not_computed (read the per-game route for it); a sport whose aggregate could not be read carries status unavailable while the rest of the page is served. Adds 3 to the request cost. Repeatable. */
+        expand?: "sharp_money"[];
+    };
+    listGameTrades: {
+        /** Newest fills to return. Out-of-range values are clamped to 1..200. */
+        limit?: number;
     };
     listInsiderRadar: {
         /** Maximum number of radar flags to return. Out-of-range values are clamped to 1..100. */
@@ -4832,7 +5935,7 @@ export interface OperationQuery {
         min_size?: number;
         /** One RFC 4180 CSV record of exact current provider-backed market_canonical.category values. Legacy unquoted lists such as NBA,WNBA remain valid; values containing commas, quotes, or newlines are CSV-quoted. Matching is case-insensitive. Malformed quoted input fails closed as one unknown exact category. A value outside sports and esports returns 400 bad_request with param=category (#27305), as on GET /api/v1/markets/explore. */
         category?: string;
-        /** Minimum trader grade. */
+        /** Minimum trader grade. Matched against the trader.grade each row returns, the wallet's current grade, so every row listed shows a grade at or above this floor. */
         min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
         /** Scope to one market. Accepts the raw provider condition_id or the mkt_-prefixed market id (round-trips a value from a list response). Must be 0x followed by 64 hexadecimal characters after any mkt_ prefix is stripped; any other value returns 400. Polymarket-only; an unknown but well-formed id returns []. A market outside sports and esports returns 404 not_found with error.reason=market_out_of_scope (#27305). */
         condition_id?: string;
@@ -4880,6 +5983,8 @@ export interface OperationQuery {
         min_market_volume_share?: number;
         /** Order of the returned page. recent is newest first and is the default. market_volume_share ranks by each trade's share of its market's traded volume, biggest first, with a trade whose share is unavailable last. That ranking reads from, or the last 30 days when from is omitted, for the same reason. A cursor is bound to the order it was minted in, so a continuation cannot cross from one order into the other. */
         sort?: "recent" | "market_volume_share";
+        /** Only the large trades in one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them. Matched case-insensitively. Newest first only (sort=market_volume_share answers 400), and cannot be combined with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
+        event_slug?: string;
     };
     listLargeTrades: {
         /** Maximum number of recent large trades to return. Out-of-range values are clamped to 1..100. */
@@ -4900,17 +6005,28 @@ export interface OperationQuery {
         sort?: "recent" | "market_volume_share";
         /** Return only the trades recorded after this one. Pass the id of a large trade this API returned (wt_<n>, or the bare integer). The answer keeps the list shape and newest-first order, and next_cursor pages within it. After means commit order: a trade recorded late with an earlier traded_at is still returned, and a trade whose write has not committed yet is returned on a later poll, never skipped. To poll, send the id of the first trade on the first page of your last answer that had trades, with If-None-Match set to the ETag you last received; when nothing new was recorded the answer is 304 with an empty body. A late trade can come back once, so deduplicate on id. Only with sort=recent. An id that names no trade, or one more than 10000 trades behind the newest, answers 400 with error.param since; request the list without since and continue from its first trade. */
         since?: string;
+        /** Only this market's large trades: an exact raw provider condition_id. The page is read from the market's own index, newest first, and pages with cursor; it cannot be combined with since or with event_slug (400). An unknown market returns an empty list. */
+        condition_id?: string;
+        /** Only the large trades in one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them. Matched case-insensitively. Newest first only (sort=market_volume_share answers 400), pages with cursor, and cannot be combined with since or with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
+        event_slug?: string;
     };
     listLeaderboard: {
         /** Maximum number of ranked traders to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
-        /** Opaque lbv1_ pagination cursor from a prior response. It binds the finite score/address boundary to the committed leaderboard generation and the effective category/strategy filters; legacy, malformed, non-finite, and unsupported-version cursors are rejected. */
+        /** Opaque lbv1_ pagination cursor from a prior response. It binds the finite score/address boundary to the committed leaderboard generation and the effective category/strategy filters, and on a sorted page to its sort, dir and activity. A cursor from another sort or dir is a 400 bad_request on cursor; one from another activity, category, strategy or generation is cursor_expired. Legacy, malformed, non-finite, and unsupported-version cursors are rejected. */
         cursor?: string;
         /** Filter by category: a sport or esports bucket. Values are matched to canonical category buckets: league values fold into their sport (NBA and NCAAB into Basketball, NFL into Football). Mapped buckets are case-insensitive; passthrough buckets (Cricket, Sports) match case-sensitively against the provider-native bucket key, so use exact casing. Sports and esports only (#27306): a category outside them returns 400 bad_request with param category and names the accepted buckets. */
         category?: string;
-        /** Filter by observed trading style. Current styles: two_sided, category_focused, high_activity, diversified, mixed, unclassified. Current styles count the wallet's sports and esports markets only. The original ten archetype identifiers remain accepted for historical rows until normal reclassification. Style describes recorded behavior; grade measures performance. */
-        strategy?: "accumulator" | "algo_trader" | "arbitrageur" | "category_focused" | "directional" | "diversified" | "event_driven" | "high_activity" | "market_maker" | "mixed" | "momentum" | "scalper" | "speculator" | "swing_trader" | "two_sided" | "unclassified";
-    };
+        /** Filter by observed trading style. Current styles: two_sided, category_focused, high_activity, diversified, mixed, unclassified. Current styles count the wallet's sports and esports markets only. The ten archetype keys retired on 2026-10-01 (accumulator, algo_trader, arbitrageur, directional, event_driven, market_maker, momentum, scalper, speculator, swing_trader) are still accepted and match no wallet. Style describes recorded behavior; grade measures performance. */
+        strategy?: "category_focused" | "diversified" | "high_activity" | "mixed" | "two_sided" | "unclassified";
+        /** Order of the list, the sort columns of the site's leaderboard (/skill-leaderboard). rank (default) is the board's own order, the rank the site and the trader profile show. grade orders by score. volume orders by sports and esports USD volume, the figure GET /api/v1/trader/{address} serves as stats.total_volume. predictions orders by markets_traded. pnl orders by in_scope.realized_pnl. win_rate orders by win_rate among wallets with at least 5 decided sports and esports markets; a wallet with fewer sorts as having none. edge orders by price_edge.edge among wallets whose price_edge.status is ranked and that carry no price_edge.hold; any other wallet sorts as having none. The site's Edge column ranks those same wallets by their edge pulled toward the sports and esports average, a figure the API does not send, so the two orders can differ. A wallet without the value sorts as the lowest, so last in the natural direction and first with the direction reversed. Ties fall to address ascending. With ?category= a sort still orders by these whole-record figures; the category only decides which wallets are listed. Since 2026-11-02 (#32237; edge, #32270). */
+        sort?: "rank" | "grade" | "volume" | "predictions" | "pnl" | "win_rate" | "edge";
+        /** Direction of sort. Omitted, each sort reads in its natural direction: rank 1 first for rank (asc), largest first for every other sort (desc). The opposite value reverses the list. Since 2026-11-02 (#32237). */
+        dir?: "asc" | "desc";
+        /** Limit the list to wallets by recent trading, the site leaderboard's split. active: the wallet's last trade, as its current grade recorded it and aged to today, is 30 days old or less. inactive: older than 30 days, or no trade on record. all (default): every ranked wallet. Since 2026-11-02 (#32237). */
+        activity?: "all" | "active" | "inactive";
+    };
+    listLeaderboardLeagues: Record<string, never>;
     listPositions: {
         /** Maximum number of current positions to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
@@ -4948,6 +6064,10 @@ export interface OperationQuery {
         min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
         /** Optional post-aggregate flow direction filter. */
         direction?: "YES" | "NO";
+        /** Only this market's flow: an exact raw provider condition_id. Cannot be combined with event_slug (400). An unknown market returns an empty list. */
+        condition_id?: string;
+        /** Only the markets of one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them, ranked as the unfiltered list ranks. Matched case-insensitively; cannot be combined with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
+        event_slug?: string;
     };
     listSmartMoneyFlows: {
         /** Lookback window for grade-filtered whale flow aggregation. */
@@ -4964,6 +6084,10 @@ export interface OperationQuery {
         min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
         /** Optional post-aggregate flow direction filter. */
         direction?: "YES" | "NO";
+        /** Only this market's flow: an exact raw provider condition_id. Cannot be combined with event_slug (400). An unknown market returns an empty list. */
+        condition_id?: string;
+        /** Only the markets of one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them, ranked as the unfiltered list ranks. Matched case-insensitively; cannot be combined with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
+        event_slug?: string;
     };
     listSuspiciousTrades: {
         /** Maximum number of suspicious trades to return. Out-of-range values are clamped to 1..100. */
@@ -5036,6 +6160,8 @@ export interface OperationQuery {
         min_market_volume_share?: number;
         /** Order of the returned page. recent is newest first and is the default. market_volume_share ranks by each trade's share of its market's traded volume, biggest first, with a trade whose share is unavailable last. That ranking reads from, or the last 30 days when from is omitted, for the same reason. A cursor is bound to the order it was minted in, so a continuation cannot cross from one order into the other. */
         sort?: "recent" | "market_volume_share";
+        /** Only the large trades in one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them. Matched case-insensitively. Newest first only (sort=market_volume_share answers 400), and cannot be combined with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
+        event_slug?: string;
     };
     listWhaleTrades: {
         /** Maximum number of recent large trades to return. Out-of-range values are clamped to 1..100. */
@@ -5056,6 +6182,10 @@ export interface OperationQuery {
         sort?: "recent" | "market_volume_share";
         /** Return only the trades recorded after this one. Pass the id of a large trade this API returned (wt_<n>, or the bare integer). The answer keeps the list shape and newest-first order, and next_cursor pages within it. After means commit order: a trade recorded late with an earlier traded_at is still returned, and a trade whose write has not committed yet is returned on a later poll, never skipped. To poll, send the id of the first trade on the first page of your last answer that had trades, with If-None-Match set to the ETag you last received; when nothing new was recorded the answer is 304 with an empty body. A late trade can come back once, so deduplicate on id. Only with sort=recent. An id that names no trade, or one more than 10000 trades behind the newest, answers 400 with error.param since; request the list without since and continue from its first trade. */
         since?: string;
+        /** Only this market's large trades: an exact raw provider condition_id. The page is read from the market's own index, newest first, and pages with cursor; it cannot be combined with since or with event_slug (400). An unknown market returns an empty list. */
+        condition_id?: string;
+        /** Only the large trades in one game: every market of the game behind this event slug, the moneyline, spreads, totals and props, as GET /api/v1/games/{event_slug}/trades reads them. Matched case-insensitively. Newest first only (sort=market_volume_share answers 400), pages with cursor, and cannot be combined with since or with condition_id (400). An unknown slug answers 404 not_found with error.param event_slug. */
+        event_slug?: string;
     };
     prepareWebhookSecret: Record<string, never>;
     redeliverWebhookDelivery: Record<string, never>;
@@ -5069,7 +6199,7 @@ export interface OperationQuery {
         limit?: number;
     };
     searchMarkets: {
-        /** Search query. Must be 1-512 characters before whitespace trimming and non-empty after trimming. */
+        /** Search query. Must be 2-512 characters before whitespace trimming and hold at least 2 letters or digits after trimming; a query with fewer letters or digits (a, 7, ?) returns 400 bad_request with param q (#32309). */
         q: string;
         /** Maximum number of matching markets to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
@@ -5120,6 +6250,10 @@ export interface OperationPath {
     exploreMarkets: Record<string, never>;
     getAccountIdentity: Record<string, never>;
     getApiDiscovery: Record<string, never>;
+    getCategoryLeaderboard: {
+        /** The category slug, for example soccer, basketball, tennis or esports, as GET /api/v1/leaderboard/categories lists it lowercased. Matched case-insensitively. */
+        slug: string;
+    };
     getCombo: {
         /** Combo identifier: 0x followed by 62 lowercase hex characters. This differs from a binary market condition ID. */
         condition_id: string;
@@ -5133,6 +6267,14 @@ export interface OperationPath {
         /** The game's event slug, for example nfl-buf-nyj-2026-09-22. Matched case-insensitively. */
         event_slug: string;
     };
+    getGameHolders: {
+        /** The game's event slug from GET /api/v1/games, for example nba-bos-orl-2026-11-01. Matched case-insensitively. */
+        event_slug: string;
+    };
+    getGameSharpMoney: {
+        /** The game's event slug, for example nba-bos-orl-2026-11-01. Matched case-insensitively; the response carries the canonical slug. */
+        event_slug: string;
+    };
     getHealth: Record<string, never>;
     getInsiderRadarFlag: {
         /** Raw whale_alerts.id or rf_-prefixed radar flag id. */
@@ -5166,6 +6308,14 @@ export interface OperationPath {
         /** Market condition ID. Accepts the raw provider-backed condition_id returned by /api/v1/markets/search or /api/v1/markets/explore, or the mkt_-prefixed market.id emitted by V1 responses. */
         condition_id: string;
     };
+    getMarketTopHolders: {
+        /** Market condition ID. Accepts the raw provider-backed condition_id returned by /api/v1/markets/search or the mkt_-prefixed market.id emitted by V1 responses. */
+        condition_id: string;
+    };
+    getMarketWalletsInOut: {
+        /** Market condition ID. Accepts the raw provider-backed condition_id returned by /api/v1/markets/search or /api/v1/markets/explore, or the mkt_-prefixed market.id emitted by V1 responses. */
+        condition_id: string;
+    };
     getMonthlyReportSnapshot: Record<string, never>;
     getPickOfTheDay: Record<string, never>;
     getPickOfTheDayArchive: Record<string, never>;
@@ -5174,6 +6324,7 @@ export interface OperationPath {
         /** Stable positive pick row id as canonical decimal text. */
         pick_id: string;
     };
+    getPickOfTheDayStats: Record<string, never>;
     getPlatforms: Record<string, never>;
     getPositionTimeline: {
         /** Trader identity: 0x... wallet address, username, trd_-prefixed trader id, bare integer traders.id, or @username. Resolved with precedence @username -> wallet -> trd_ -> integer -> username (a leading @ forces a username lookup, for all-digit usernames); wallet matching is case-insensitive. */
@@ -5184,6 +6335,11 @@ export interface OperationPath {
         trader: string;
     };
     getReports: Record<string, never>;
+    getResolutionReport: Record<string, never>;
+    getSportLeaderboard: {
+        /** The sport slug, for example soccer, basketball, football or esports. Matched case-insensitively. A league or title alias such as nba, epl or cs2 reads its sport's board, and the body's sport is that board's slug; pass league for one league's board. */
+        sport: string;
+    };
     getStream: Record<string, never>;
     getSuspiciousTrade: {
         /** Raw whale_alerts.id or rf_-prefixed suspicious trade id. */
@@ -5241,8 +6397,17 @@ export interface OperationPath {
         /** Raw whale_alerts.id or wt_-prefixed whale trade id. */
         id: string;
     };
+    listCategoryLeaders: Record<string, never>;
     listComboFills: Record<string, never>;
+    listGameMarkets: {
+        /** The event slug from GET /api/v1/games, GET /api/v1/games/{event_slug} or a markets/search result's event_slug, for example nba-bos-orl-2026-11-01. Matched case-insensitively. */
+        event_slug: string;
+    };
     listGames: Record<string, never>;
+    listGameTrades: {
+        /** The game's event slug, for example nfl-buf-nyj-2026-09-22. Matched case-insensitively. */
+        event_slug: string;
+    };
     listInsiderRadar: Record<string, never>;
     listLargePositions: Record<string, never>;
     listLargeTradeCounterpartyExecutions: {
@@ -5258,6 +6423,7 @@ export interface OperationPath {
     listLargeTradeHistory: Record<string, never>;
     listLargeTrades: Record<string, never>;
     listLeaderboard: Record<string, never>;
+    listLeaderboardLeagues: Record<string, never>;
     listPositions: Record<string, never>;
     listSharpMoneyFlows: Record<string, never>;
     listSmartMoneyFlows: Record<string, never>;
@@ -5342,10 +6508,10 @@ export interface OperationBody {
     createMcpJsonRpcResponse: {
         /** JSON-RPC protocol version; this server accepts 2.0. */
         jsonrpc: "2.0";
-        /** Request identifier echoed exactly in one JSON-RPC response; supported notifications omit it and receive an empty HTTP 202. */
-        id?: string | number | null;
+        /** Request identifier, a string or a number, echoed exactly in one JSON-RPC response; a notification omits it and receives an empty HTTP 202. A null id answers HTTP 400 with JSON-RPC error -32600. */
+        id?: string | number;
         /** MCP method to invoke. */
-        method: "initialize" | "notifications/initialized" | "notifications/cancelled" | "ping" | "tools/list" | "tools/call";
+        method: "initialize" | "notifications/initialized" | "notifications/cancelled" | "ping" | "tools/list" | "tools/call" | "server/discover";
         /** Method-specific MCP parameters. */
         params?: Record<string, unknown>;
     };
@@ -5355,6 +6521,7 @@ export interface OperationBody {
     exploreMarkets: never;
     getAccountIdentity: never;
     getApiDiscovery: never;
+    getCategoryLeaderboard: never;
     getCombo: never;
     getCombosSummary: never;
     getCoverage: never;
@@ -5362,6 +6529,8 @@ export interface OperationBody {
     getEdgeHunter: never;
     getEventReplaySince: never;
     getGame: never;
+    getGameHolders: never;
+    getGameSharpMoney: never;
     getHealth: never;
     getInsiderRadarFlag: never;
     getLargeTrade: never;
@@ -5371,15 +6540,20 @@ export interface OperationBody {
     getMarketHolders: never;
     getMarketIntel: never;
     getMarketSnapshot: never;
+    getMarketTopHolders: never;
+    getMarketWalletsInOut: never;
     getMonthlyReportSnapshot: never;
     getPickOfTheDay: never;
     getPickOfTheDayArchive: never;
     getPickOfTheDayLedger: never;
     getPickOfTheDayLedgerEntry: never;
+    getPickOfTheDayStats: never;
     getPlatforms: never;
     getPositionTimeline: never;
     getPositionTimelineById: never;
     getReports: never;
+    getResolutionReport: never;
+    getSportLeaderboard: never;
     getStream: never;
     getSuspiciousTrade: never;
     getTrader: never;
@@ -5396,8 +6570,11 @@ export interface OperationBody {
     getWeeklyReportSnapshot: never;
     getWhaleDatasetStatus: never;
     getWhaleTrade: never;
+    listCategoryLeaders: never;
     listComboFills: never;
+    listGameMarkets: never;
     listGames: never;
+    listGameTrades: never;
     listInsiderRadar: never;
     listLargePositions: never;
     listLargeTradeCounterpartyExecutions: never;
@@ -5405,6 +6582,7 @@ export interface OperationBody {
     listLargeTradeHistory: never;
     listLargeTrades: never;
     listLeaderboard: never;
+    listLeaderboardLeagues: never;
     listPositions: never;
     listSharpMoneyFlows: never;
     listSmartMoneyFlows: never;
@@ -5510,6 +6688,15 @@ export interface OperationResponse {
         data: OperationData["getApiDiscovery"];
         meta: ResponseMeta;
     };
+    getCategoryLeaderboard: {
+        object: "list";
+        data: OperationData["getCategoryLeaderboard"];
+        has_more: boolean;
+        next_cursor?: string;
+        /** Wallets in the category whose edge lower bound is above zero, Wallets in the full walk across every page: those in the category, under this request's active_within and min_events, whose edge lower bound is above zero. The same on every page. */
+        total?: number;
+        meta: ResponseMeta;
+    };
     getCombo: ComboResponse;
     getCombosSummary: CombosSummaryResponse;
     getCoverage: {
@@ -5537,6 +6724,16 @@ export interface OperationResponse {
         as_of: string;
         meta: ResponseMeta;
     };
+    getGameHolders: {
+        object: "game_holders_batch";
+        data: OperationData["getGameHolders"];
+        meta: BatchResponseMeta;
+    };
+    getGameSharpMoney: {
+        object: "game_sharp_money";
+        data: OperationData["getGameSharpMoney"];
+        meta: ResponseMeta;
+    };
     getHealth: {
         object: "health";
         data: OperationData["getHealth"];
@@ -5586,6 +6783,16 @@ export interface OperationResponse {
         data: OperationData["getMarketSnapshot"];
         meta: ResponseMeta;
     };
+    getMarketTopHolders: {
+        object: "market_top_holders";
+        data: OperationData["getMarketTopHolders"];
+        meta: ResponseMeta;
+    };
+    getMarketWalletsInOut: {
+        object: "market_wallets_in_out";
+        data: OperationData["getMarketWalletsInOut"];
+        meta: ResponseMeta;
+    };
     getMonthlyReportSnapshot: {
         object: "report_snapshot";
         data: OperationData["getMonthlyReportSnapshot"];
@@ -5611,6 +6818,11 @@ export interface OperationResponse {
         data: OperationData["getPickOfTheDayLedgerEntry"];
         meta: ResponseMeta;
     };
+    getPickOfTheDayStats: {
+        object: "pick_of_the_day_stats";
+        data: OperationData["getPickOfTheDayStats"];
+        meta: ResponseMeta;
+    };
     getPlatforms: {
         object: "platforms";
         data: OperationData["getPlatforms"];
@@ -5639,6 +6851,16 @@ export interface OperationResponse {
         data: OperationData["getReports"];
         meta: ResponseMeta;
     };
+    getResolutionReport: {
+        object: "resolution_report";
+        data: OperationData["getResolutionReport"];
+        meta: ResponseMeta;
+    };
+    getSportLeaderboard: {
+        object: "sport_leaderboard";
+        data: OperationData["getSportLeaderboard"];
+        meta: ResponseMeta;
+    };
     getStream: string;
     getSuspiciousTrade: {
         object: "suspicious_trade";
@@ -5699,18 +6921,52 @@ export interface OperationResponse {
         data: OperationData["getWhaleTrade"];
         meta: ResponseMeta;
     };
+    listCategoryLeaders: {
+        object: "list";
+        data: OperationData["listCategoryLeaders"];
+        has_more: boolean;
+        next_cursor?: string;
+        /** Number of rows returned: up to three per category. */
+        total?: number;
+        meta: ResponseMeta;
+    };
     listComboFills: ComboFillsResponse;
+    listGameMarkets: {
+        data: OperationData["listGameMarkets"];
+        event_slug: string;
+        families: {
+            active: number;
+            markets: number;
+            sports_market_type?: string;
+        }[];
+        has_more: boolean;
+        meta: ResponseMeta;
+        next_cursor?: string;
+        object: string;
+    };
     listGames: {
         object: "list";
         data: OperationData["listGames"];
         has_more: boolean;
         /** Pass as cursor for the next page. Present only when has_more is true. */
         next_cursor?: string;
-        /** When this read assembled the catalog. Per-source vintage is on each game's freshness. */
+        /** When this read assembled the catalog; with status ended, cancelled or postponed, when it read the stored records. Per-source vintage is on each game's freshness. */
         as_of: string;
         coverage: GamesCoverage;
         meta: ResponseMeta;
     };
+    listGameTrades: {
+        object: "list";
+        /** Newest first. */
+        data: OperationData["listGameTrades"];
+        /** Always false: the list is the game's newest limit fills, not a walk. Poll again for newer fills. */
+        has_more: boolean;
+        /** The game the rows were read for, lowercased. */
+        event_slug: string;
+        /** true when the rows are the game's last complete read, served while its refresh runs. Read again in a few seconds for the live rows. */
+        source_stale: boolean;
+        meta: ResponseMeta;
+    };
     listInsiderRadar: {
         object: "list";
         data: OperationData["listInsiderRadar"];
@@ -5771,6 +7027,11 @@ export interface OperationResponse {
         total?: number;
         meta: ResponseMeta;
     };
+    listLeaderboardLeagues: {
+        object: "leaderboard_leagues";
+        data: OperationData["listLeaderboardLeagues"];
+        meta: ResponseMeta;
+    };
     listPositions: {
         object: "list";
         data: OperationData["listPositions"];