@0xinsider/mcp 2.13.0 → 2.14.2

package/dist/sdk/schema.d.ts

@@ -87,7 +87,7 @@ export type ApiErrorBody = {
     message: string;
     doc_url?: string;
     param?: string;
-    /** The recommended next retry instant (RFC3339). Present on every retryable error (reason=pick_not_released, code=rate_limited including reason=monthly_quota_exceeded, code=rate_limit_unavailable, reason=read_model_warming) and omitted otherwise. Always in the future. For pick_not_released: before the 11:00 UTC operating-window start, before a selected pick's stored release, or after a skipped day, it names the automatic system's next boundary. While no candidate exists in the live window it normally names the persisted next automatic selector attempt. Every value is advisory and can change before release. When the automatic schedule is absent/due or a pick is overdue it degrades to ~60s. Schedule one request and do not poll. Prefer Retry-After for the duration because it is immune to client clock skew. */
+    /** The recommended next retry instant (RFC3339). Present on every retryable error (reason=pick_not_released, code=rate_limited including reason=monthly_quota_exceeded, code=rate_limit_unavailable, reason=read_model_warming) and omitted otherwise. Always in the future. For pick_not_released: before the 07:00 UTC operating-window start, before a selected pick's stored release, or after a skipped day, it names the automatic system's next boundary. While no candidate exists in the live window it normally names the persisted next automatic selector attempt. Every value is advisory and can change before release. When the automatic schedule is absent/due or a pick is overdue it degrades to ~60s. Schedule one request and do not poll. Prefer Retry-After for the duration because it is immune to client clock skew. */
     retry_at?: string;
     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 outside the HOT/WARM sync tiers -- stop asking for this wallet. cursor_expired: pagination went stale mid-walk -- re-request the first page and continue. read_model_warming: the requested endpoint cannot serve its read model yet; exact causes are endpoint-specific and can include a cold or contended refresh or a dependency that prevented refresh. database_unavailable: the API's database or its connection pool is temporarily unreachable (a connection-class failure, not a query fault); code stays rate_limit_unavailable, nothing is rate-limited, retry after Retry-After / retry_at. idempotency_in_progress: retain the exact Idempotency-Key and request body, then retry shortly. webhook_delivery_in_progress: retry the URL or signing-secret configuration change after the destination's active request completes. request_accounting_unavailable: accounting capacity is unavailable before the handler executes; retry after Retry-After / retry_at. sandbox_api_key: the credential is a sandbox key (oxi_sk_test_) from POST /api/v1/agents/register, which only the sandbox server accepts -- call the sandbox base URL with it, or get a live key or OAuth access token; do not retry it here. api_key_in_query: the key was sent as a ?token= query parameter, which no route reads because URLs land in logs and history; the key itself was not checked -- resend it as Authorization: Bearer. subscription_inactive: the key is valid but the account's Pro subscription has lapsed (402 subscription_required); permanent until a person reactivates at https://0xinsider.com/billing, which the message names -- stop retrying on a schedule and surface the link. The key owner is emailed once per lapse. monthly_quota_exceeded: the account has used the requests Pro includes for the UTC calendar month (429 rate_limited); retry_at and Retry-After name the first of next month, the only retry that can succeed, and the message names https://0xinsider.com/developers, where pay as you go for requests over the quota is turned on. The X-Monthly-Quota-Limit, X-Monthly-Quota-Remaining and X-Monthly-Quota-Reset headers on every authenticated response say how close the account is. invalid_query, invalid_path, invalid_body (400 bad_request, #16146): a query parameter, a path segment or the JSON body did not parse or does not fit the route's schema, so no handler ran; param names the field when the parser named one (a query key, a path segment, a JSON path such as traders[0], or body); fix the request, never retry it as sent. unsupported_media_type (415 bad_request, param content-type): send the body with Content-Type: application/json. payload_too_large (413 bad_request, param body): the body is over 1048576 bytes. method_not_allowed (405 bad_request): the path is a route but not with this method; the Allow header names the methods it serves. ip_rate_limited (429 rate_limited, #16380): the per-address budget every caller behind one IP shares, counted before authentication, is spent; not the key's own window, and the RateLimit-* headers describe that bucket. ip_throttled (429 rate_limited): the address is in a cooldown after sustained over-limit traffic; Retry-After is minutes to days, and a request before it does not shorten the cooldown. */
@@ -254,6 +254,10 @@ export type CreateWebhookRequest = {
     event_types: WebhookEventType[];
     trade_filters?: LargeTradeSubscriptionFilters;
 };
+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. */
 export type DataQuality = {
     /** fresh when every group is fresh, unavailable when every group is unavailable, and partial in every other case. */
@@ -534,7 +538,7 @@ export type Game = {
     competitors: GameCompetitor[];
     /** The esports series length, for example Bo3. Omitted for everything else. */
     series_format?: string;
-    /** Whether one of this game's markets pays on a draw. Read this instead of assuming a two-outcome moneyline. */
+    /** 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. */
     markets: GameMarket[];
@@ -598,7 +602,7 @@ export type GameMarket = {
     slug?: string;
     /** The provider's own market type, for example moneyline or spread. Omitted when the provider sent none. Not an enum: the provider owns this vocabulary and adds to it. */
     sports_market_type?: string;
-    /** Which side of the game this market's YES leg pays. draw is a real value: a 1X2 market's third leg is not a competitor. Omitted when the provider ids do not classify the leg, which is not the same as other. */
+    /** Which side of the game this market's YES leg pays. Soccer 1X2 legs are explicitly classified as home, draw or away by the provider projection. draw is a real value, not a competitor. Omitted when the provider projection cannot classify the leg, which is not the same as other. */
     side?: "home" | "away" | "draw" | "other";
     /** The provider's label for the YES outcome. Omitted when the provider sent none. */
     outcome_yes?: string;
@@ -802,10 +806,10 @@ export type LargeTrade = {
     /** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for the traded outcome; null when unavailable (e.g. unsynced markets) and for a Polymarket trade recorded before 2026-04-02T00:00:00Z, where the traded side is unknown. */
     token_id: string | null;
     price: number;
-    /** Current 0.0–1.0 review score, computed at request time from the trade's size, the trader's win rate today, a bonus when a trader with a win rate above 55% trades at a price below 30¢, and the trade's age now. A higher score means read this trade first; it does not measure edge or predict an outcome. On a historical row it is today's view of the trade, not what a reader saw then; use recorded_review_score for that. Canonical since #16311; signal_score carries the same value. */
+    /** Current trade review score on a 0..1 scale; higher values indicate a stronger review signal. This is the current response value and can differ from the recorded score. Missing measurements remain unavailable. */
     review_score: number;
     /**
-     * Current 0.0–1.0 review score, computed at request time from the trader's win rate today and the trade's age now. Deprecated (#16311): `review_score` is the canonical spelling and carries the same value; this key stays on the wire.
+     * Deprecated alias of review_score with the same current value and 0..1 scale.
      * @deprecated
      */
     signal_score: number;
@@ -890,6 +894,7 @@ export type LeaderboardEntry = {
     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. */
     win_rate?: number;
+    /** Observed trading style identifier. New rows use two_sided, category_focused, high_activity, diversified, mixed, or unclassified. Historical identifiers remain readable during normal reclassification; style does not predict skill or intent. */
     strategy_type?: string;
     /** Provider platform. Always polymarket. */
     platform: "polymarket";
@@ -1115,8 +1120,10 @@ export type MarketSnapshot = {
         source: string;
         live_match_key?: string;
         live_league_key?: string;
-        /** Live-score period and elapsed may be omitted when unavailable (older responses use null). A score entry may omit full_name when it equals team; fall back to team. Distinct aliases and score admission markers are preserved. */
-        live_score?: Record<string, unknown>;
+        /** Live-score period and elapsed may be omitted when unavailable (older responses use null). A score entry may omit full_name when it equals team; fall back to team. Distinct aliases and score admission markers are preserved. For live esports, scores[].map_score retains an available pair through an update omitting both sides only within the same live map, series format and series totals. Map changes and final state follow current provider updates; absent detail remains unavailable. Optional tennis_points supplies independently sourced current-game points and serving side; absence means unavailable. Compatible unexpired tennis_points survives temporary supplemental snapshot unavailability or contention; expiry and set/game mismatch still clear it. */
+        live_score?: Record<string, unknown> & {
+            tennis_points?: TennisPoints;
+        };
         reason?: string;
     };
     freshness: {
@@ -1205,10 +1212,40 @@ export type PickHolder = {
     is_bot?: boolean;
     /** The wallet's X handle from its Polymarket profile, normalized to 1-15 characters of [A-Za-z0-9_] with no `@`. Link it as `https://x.com/<handle>`. 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. */
     x_username?: string | null;
-    category_evidence?: HolderCategoryEvidence;
+};
+/** Recorded lead wallet facts, available only on full newly certified picks. Position and category history are frozen at publication; they are not live balances or pick win probabilities. */
+export type PickLeadBacker = {
+    /** Lead trader wallet address. */
+    address: string;
+    /** Recorded provider display name. */
+    name: string | null;
+    /** Trader grade recorded at publication. */
+    grade: string;
+    /** Canonical sport of the recorded directional history. */
+    category: string;
+    /** Provider-reported position value on the backed outcome at publication, in USD. It is the gross value on that outcome and does not subtract shares the wallet held on the other outcome; see net_position_usd. It is not the entry cost or a live balance. */
+    position_usd: number;
+    /** Net value of the lead's position toward the backed outcome at publication, in USD: shares held on the backed outcome minus shares held on the other outcome of the same market, valued at the backed outcome's provider price at publication. Present only when the wallet also held the other outcome; absent for a one-sided position, whose net equals position_usd. It is not a live balance. */
+    net_position_usd?: number;
+    /** Start time of the provider position fetch used at publication. This conservative observation clock precedes completion; the position is not a live balance. */
+    position_observed_at: string;
+    /** Distinct directional events in the recorded category history. */
+    directional_event_count: number;
+    /** Events with strictly positive native terminal P&L in the same frozen category sample as directional_event_count, realized_pnl_usd and roi. Multiple market positions in one event contribute one combined event result. Zero-profit events remain in directional_event_count but do not increase this count. This is a recorded wallet result, not a market win rate or the pick's win probability. */
+    profitable_event_count: number;
+    /** Realized P&L over the recorded directional category sample, in USD. Excludes open positions and later changes. */
+    realized_pnl_usd: number;
+    /** Recorded entry basis of that directional sample, in USD; not a claim of complete trading costs or fees. */
+    entry_basis_usd: number;
+    /** Realized P&L divided by recorded entry basis, as a fraction: 0.10 means 10%. This is a wallet statistic, not a pick win probability. */
+    roi: number;
+    /** Peak-to-trough realized P&L drawdown after each event result in the recorded sample, in USD. Excludes intragame, unrealized, and account equity drawdown. */
+    max_realized_drawdown_usd: number;
+    /** Timestamp when the directional history evidence was recorded, separate from the provider position snapshot clock. */
+    recorded_at: string;
 };
 export type PickOfTheDay = {
-    /** Always 'full' for an authenticated Pro key. */
+    /** Full success containing entitled proof-readable picks. */
     state: "full";
     /** The pick's local publication date (YYYY-MM-DD). */
     pick_date?: string;
@@ -1217,21 +1254,21 @@ export type PickOfTheDay = {
      * @deprecated
      */
     pick_rank?: number;
-    /** The complete ranked picks for this product day, ordered by pick_rank. Thin days contain fewer items; the selector never fabricates rows. */
+    /** Published picks for this product day in the returned display order. Use pick_id for identity. */
     picks?: PickOfTheDay[];
     /** Number of items in `picks`: the proof-readable picks. Picks held in `proof_pending_picks` are not counted. */
     pick_count?: number;
-    /** Same-day picks selected but not yet released, ordered by pick_rank. Additive and optional: present only while at least one unreleased slot exists. Each slot exposes only its rank and schedule -- no market identity before release. Schedule the next read from the earliest release_at instead of polling. */
+    /** 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[];
     /** Human-readable matchup (e.g. "Portugal vs. Uzbekistan"). */
     matchup?: string;
-    /** Frozen canonical calibration/report bucket (e.g. "Basketball", "MMA", or "Soccer"). Existing semantics are unchanged; presentation consumers should prefer display_category when present. */
+    /** Recorded canonical sport category. Prefer display_category for the public competition label. */
     category?: string;
     /** Frozen public presentation category: the competition the Polymarket event belongs to. A curated label comes first -- an official league (e.g. "WNBA" or "UFC"), the esports title (e.g. "CS2", "LoL", "Dota 2" or "Valorant"), or a soccer competition (e.g. "LaLiga", "Premier League", "Serie A" or "UEFA Champions League"); any other competition carries the provider's own competition name without its season year (e.g. "UEFA Nations League", "ATP" or "Wimbledon"). It equals category only when the provider names no competition. An esports pick keeps the pooled "Esports" bucket in category, so a per-title label never implies a per-title measured cohort. Additive and optional for mixed-version client compatibility. */
     display_category?: string;
     /** Provider platform. Always polymarket. */
     platform?: "polymarket";
-    /** The pick's stored release instant. Normally the current provider kickoff minus one hour; an operator may override it. The actual publish instant can trail it because of worker or claim delay. */
+    /** The pick's stored release instant. Qualified automatic selections are due immediately; explicitly scheduled selections retain their stored time. Final checks, worker or claim delay can make the actual publication later. */
     release_at?: string;
     /** True only before the pick's stored release instant (a pre-release embargo flag); effectively always false on a served, already-published pick. To detect that the backed game has kicked off, use `game_started`. */
     is_locked?: boolean;
@@ -1251,23 +1288,19 @@ export type PickOfTheDay = {
     position?: string;
     /** One-line summary of which side sharp money is backing. Required on every item in `picks`: a current-day published pick whose required holder proof is not safely readable is listed in `proof_pending_picks` instead of being served with a partial success shape or a synthetic zero, and the route returns 503 read_model_warming only when no published pick has readable proof. */
     side_summary?: string;
-    /** Public V1 compatibility count of S/A sharp-money wallets on the backed side. The first-party/internal current policy counts S/A/B; historical rows retain their frozen policy's count. Required on every item in `picks`: a current-day published pick whose required holder proof is not safely readable is listed in `proof_pending_picks` instead of being served with a partial success shape or a synthetic zero, and the route returns 503 read_model_warming only when no published pick has readable proof. Canonical key since #16308; smart_wallet_count is its deprecated spelling, emitted beside it with the same value. */
+    /** S/A wallet count on the backed side in the public V1 compatibility projection. */
     sharp_wallet_count?: number;
     /**
-     * Deprecated spelling of sharp_wallet_count, emitted beside it with the same value and never removed. Public V1 compatibility count of S/A sharp-money wallets on the backed side. The first-party/internal current policy counts S/A/B; historical rows retain their frozen policy's count. Required on every item in `picks`: a current-day published pick whose required holder proof is not safely readable is listed in `proof_pending_picks` instead of being served with a partial success shape or a synthetic zero, and the route returns 503 read_model_warming only when no published pick has readable proof.
+     * Deprecated spelling of sharp_wallet_count with the same value.
      * @deprecated
      */
     smart_wallet_count?: number;
-    /** Best public V1-compatible S/A sharp-money grade on the backed side. The first-party/internal current policy can select B, but a current B-only grade is omitted by the stable V1 adapter. Historical rows retain their frozen policy's grade. A current-day published pick with pending legacy proof, unknown-future proof, or structurally invalid current-policy proof returns 503 before this success schema is served. Resolved legacy proof remains readable on both current-day and archive/history responses. */
+    /** Best recorded S/A grade in the public V1 compatibility projection. */
     top_grade?: string;
-    /** Deprecated (#7170): no longer populated for picks selected on/after the calibration-edge change; omitted (absent) for new picks (the field uses skip_serializing_if, so a null value is dropped from the JSON rather than serialized as null). Permanently frozen-legacy -- retained for historical picks, with no removal or replacement planned, so no v2 is implied. Historical picks may still carry a value. Legacy meaning: category win-rate edge as a fraction (the backed-side cohort's win rate in this category minus the non-market-maker category baseline, e.g. 0.09 = +9 points), paired with category_edge_sample. */
-    category_edge_pct?: number;
-    /** Deprecated (#7170): no longer populated for picks selected on/after the calibration-edge change; omitted (absent) for new picks (the field uses skip_serializing_if, so a null value is dropped from the JSON rather than serialized as null). Permanently frozen-legacy -- retained for historical picks, with no removal or replacement planned, so no v2 is implied. Historical picks may still carry a value. Legacy meaning: pooled count of resolved markets behind category_edge_pct (the headline's n). */
-    category_edge_sample?: number;
-    /** Recency-weighted graded-flow magnitude in USD; omitted when <= 0. Canonical key since #16308; smart_usd is its deprecated spelling, emitted beside it with the same value. */
+    /** Recorded sharp-money magnitude in USD when available. */
     sharp_usd?: number;
     /**
-     * Deprecated spelling of sharp_usd, emitted beside it with the same value and never removed. Recency-weighted graded-flow magnitude in USD; omitted when <= 0.
+     * Deprecated spelling of sharp_usd with the same value.
      * @deprecated
      */
     smart_usd?: number;
@@ -1301,67 +1334,40 @@ export type PickOfTheDay = {
     unit_score?: number;
     /** Backend-formatted signed unit score, present exactly when unit_score is present. */
     unit_score_display?: string;
-    /** First-party/internal backed-side sharp-money dollar consensus as a fraction 0..1: the share of current-policy sharp dollars on the backed side. Omitted on current public V1 rows when the B-inclusive value has no reconstructible S/A equivalent. A conviction signal, NOT a probability or expected-value claim. Frozen at generation. */
+    /** Recorded sharp-money share as a 0..1 fraction when available. This is not a winning probability. */
     sharp_pct?: number;
-    /** Market-implied probability of the backed side as a fraction 0..1 (equals backed_price), re-exposed alongside sharp_pct for the WHY breakdown. */
+    /** Recorded market-implied probability as a 0..1 fraction when available. */
     market_pct?: number;
-    /** First-party/internal consensus edge = sharp_pct - market_pct, the conviction-vs-price gap (how much more of the current-policy sharp money sits on this side than the price implies). Omitted on current public V1 rows when the B-inclusive value has no reconstructible S/A equivalent. This is NOT an expected-value or guaranteed edge. Omitted when either input is unavailable. */
-    consensus_edge_pct?: number;
-    /** First-party/internal team-directional commitment read at selection time: the fraction (0..1) of the backed side's current-policy graded sharp-money DOLLARS held by wallets read one-way rather than hedged: no opposite leg on this market worth at least 10% of the backed leg (Polymarket's own currentValue pair), and no opposing team across the game's markets where the wallet's synced legs are fresh. Current public V1 rows omit this B-inclusive read because its historical S/A equivalent is not reconstructed. A high value means the graded pile is really committed to this side; a low one means much of it is hedged or unreadable. Omitted when the read was not computed (a pick selected before the field existed, an ungroupable game, an empty graded pile, or a pile where no holder carried usable evidence) -- which is NOT the same as 0.0, a computed reading that classified holders and found none one-way. */
-    directional_confidence?: number;
-    /** Graded backed-side holders read as one-way-committed on this game. */
-    one_way_holder_count?: number;
-    /** Graded backed-side holders read as HEDGED across the game's markets. */
-    hedged_holder_count?: number;
-    /** The one-way holders' share of the backed-side graded dollars (the confidence's numerator). */
-    one_way_graded_usd?: number;
-    /** Backed-side graded dollars the confidence is measured against (its denominator). */
-    total_graded_usd?: number;
-    /** The qualifying category expert whose sport-specific record and real position earned this pick its top selection tier. The first-party/internal current policy admits S/A/B; public V1 exposes a compatible S/A expert and omits a current-policy B-grade expert: a candidate backed by one outranks every candidate without one. Present only on the full payload. Omitted when no wallet qualified on the backed side, on picks generated before the field existed, and on the first-party web teaser, which withholds all backed-side evidence. Frozen at SELECTION time — the wallet's position can move before the pick renders. */
+    /** Optional legacy recorded specialist facts. These describe the trader and do not disclose selection decisions. Present only on a full response when available; newly certified picks use lead_backer instead. */
     qualifying_expert?: {
-        /** Wallet address of the qualifying expert. */
+        /** Trader wallet address. */
         address: string;
         /** Provider display name, or null for an unnamed wallet. */
         name: string | null;
-        /** 0xinsider grade letter. The first-party/internal current Pick of the Day policy counts S, A, and B; public V1 exposes only the compatible S/A expert. */
+        /** Recorded trader grade. Public V1 preserves its S/A compatibility projection. */
         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 this wallet's resolved markets in canonical_category whose realized P&L came out positive, as a 0..1 fraction. Above 0.60 by construction for a source=v1 expert; null for an expert who qualified on the category-skill v2 definition only. Deliberately NOT phrased as "closed profitable": the metric counts realized P&L above zero, so a resolved winner the wallet never redeemed sits at zero and counts against it. */
+        /** 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. */
         win_rate: number | null;
-        /** Resolved markets in canonical_category behind win_rate. At least 10 by construction for a source=v1 expert; null with win_rate. */
+        /** Number of resolved markets behind win_rate; null when not measured. */
         n_resolved: number | null;
-        /** Current expert policy 10 does not require a category-skill v2 specialist in any sport; in every sport a specialist raises the candidate's rank tier rather than gating it. Standard specialists need a positive edge_lower_95 over enough independent events and enough net backing on the backed side; the floors are not published. Fresh healthy records below the shared model's live sample floor can qualify; stale, unknown and degraded records cannot. Historical records preserve which definition qualified the wallet: v1, the profitability rate (win_rate over n_resolved), or v2, the forward-only category-skill calibration edge (edge_lower_95 over independent_event_count). Absent on picks frozen before the v2 definition existed; read absence as v1. A Tennis pick frozen under gate policy v4 or later carries v2 only: a v1 rate stopped qualifying a tennis expert at v4. A Tennis pick frozen under an earlier policy can still carry v1 with a win rate. */
-        source?: "v1" | "v2";
-        /** 95% lower bound of the wallet's mean calibration edge over the market price in canonical_category, in probability units (0.08 is 8 points). Positive by construction for a v2 expert; present on a v1 expert only when the wallet also holds a live v2 row. */
-        edge_lower_95?: number;
-        /** Point estimate behind edge_lower_95. */
-        edge_mean?: number;
-        /** Independent canonical events behind the edge. At least 10 by construction for a v2 expert. */
-        independent_event_count?: number;
-        /** Polymarket's own currentValue for this wallet on the backed outcome, in USD, as of selection. At least 1000 by construction through gate policy v7; the standard floor is 500 from v8. From gate policy v5 the floor is read on the net: position_usd minus opposite_position_usd is at least that floor, and the pick re-verifies that net against the live holder snapshot when it is released. */
+        /** Recorded Polymarket position value on the backed outcome, in USD. It can change after this snapshot. */
         position_usd: number;
-        /** The same wallet's currentValue on the OTHER outcome of this market, in USD, as of selection. Present from gate policy v5, when the floor moved to net exposure; a wallet long both sides does not qualify. Absent on picks frozen before v5, which never read the leg. 0 is a measured one-way position, not an absence. */
+        /** Recorded position value on the other outcome of this market, in USD. Omitted when not recorded; zero is a measured value. */
         opposite_position_usd?: number;
-        /** When the skill read model behind the evidence was last rebuilt: trader_category_stats.computed_at for a source=v1 expert, category_skill_v2_current.as_of for a source=v2 expert. */
+        /** Timestamp of the recorded trader statistics. */
         stats_computed_at: string;
-        /** Present from expert policy 6. Current expert policy 10 retains the longshot requirement of live v2 only, with a positive lower bound over a large sample, large net backed value and no meaningful opposite value. Historical policy 6: a specialist required large net backed value, no meaningful opposite value, and either a live v2 positive lower bound over a large sample or a high v1 rate over enough resolved markets. Tennis requires v2. The floors are not published. */
-        lane?: "standard" | "longshot_specialist";
-        /** Answered, spread-gated, index-scoped backed probability frozen only on a specialist exception. */
-        lane_probability?: number;
-        /** Canonical provider probability pair branch; absent on standard experts. */
-        lane_probability_source?: "p";
-    };
-    trust?: PickTrust;
-    /** Public V1 S/A compatibility count on the backed side (equals the adapted sharp_wallet_count). The first-party/internal current policy counts S/A/B. Historical rows retain their frozen policy's count. */
+    };
+    /** Public V1 S/A wallet count on the backed side, equal to sharp_wallet_count. */
     traders?: number;
-    /** Raw backed-side sharp-money USD frozen at generation. This is the Sharp USD value, not the recency-weighted sharp_usd which decays. Omitted on current public V1 rows when the B-inclusive value has no reconstructible S/A equivalent. */
+    /** Recorded backed-side position value in USD when available. Newly certified picks sum only publication-certified wallet positions; legacy rows retain their recorded value. */
     backed_sharp_usd?: number;
-    /** Bounded S/A compatibility projection of the frozen sharp-money holders on the backed side. Current full payloads expose the complete S/A/B roster in display_holders; historical rows can retain their earlier frozen shape. */
+    /** Bounded S/A holder display projection. Newly certified picks include only publication-certified wallets; historical rows retain their recorded display shape. */
     holders?: PickHolder[];
-    /** Full-only complete provider-confirmed S/A/B holder roster for the current Pick of the Day backing policy. Omitted for teaser, no-pick, and historical rows whose frozen holder proof predates this policy. Each entry may additionally carry `category_win_rate` / `category_win_rate_status`: the wallet's win rate in the pick's canonical `category`, stamped at serve time from the current category read model (the same annotation the sports sharp-money chips carry). The bounded `holders` compatibility projection never carries these fields. */
+    /** Optional complete holder display roster. Newly certified picks list the recorded lead first, then any verified supporters, then the other graded wallets that held the backed side at publication, ordered by shares; only the lead and supporters are verified, the other rows are gross holdings that may also hold the other side and are not counted in the wallet counts, holder_count or backed_sharp_usd. Legacy rows retain their recorded display shape. */
     display_holders?: PickHolder[];
-    /** Exact S/A sharp-money proof count on the backed side. The current display_holders roster can be longer because it also carries B-grade sharp-money holders. */
+    /** S/A holder count for the public V1 compatibility projection. display_holders can include additional grades. */
     holder_count?: number;
     /** Optional editorial note attached to the pick. */
     editorial_note?: string;
@@ -1373,18 +1379,23 @@ export type PickOfTheDay = {
     polymarket_url?: string;
     /** The canonical /event game-page slug (one neutral page per game); omitted when the game has no neutral event page. */
     event_slug?: string;
-    /** Backend-resolved /event destination slug for this pick's source market; its absence is an authoritative no-link decision. */
-    event_link_slug?: string;
+    /** Backend-resolved /event destination slug for the source market. Omitted outside full responses; null is an authoritative no-link decision. */
+    event_link_slug?: string | null;
     /** Provider-first sports context for the pick's market (team logos, league branding, live score). Full-state only; omitted when the pick is not a team-sports market. */
     sports_context?: PickSportsContext;
     /** Risk disclaimer shown with every pick. */
     disclaimer?: string;
-    /** Published same-day picks whose holder proof is not readable yet, ordered by pick_rank. Additive and optional: present only while at least one such pick exists. While present, `picks` carries only the proof-readable picks and `pick_count` counts them. Schedule the next read from the earliest retry_at instead of polling. The route returns 503 read_model_warming only when no published pick has readable proof. */
+    /** 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[];
-    /** Frozen admission classification, full payload only. The specialist lane exempts two probability rejects and adds no rank bonus. Historical rows remain standard. */
-    selection_lane?: "standard" | "longshot_specialist";
-    /** Optional full-only authorization for newly issued policy-7 picks; omitted for legacy or unissued picks and teasers. It remains historical after expiry. */
+    /** Optional full-response entry authorization. Missing or expired authorization cannot authorize an automated entry. */
     entry_authorization?: PotdEntryAuthorization;
+    /** Unauthorized unresolved published or scheduled ranks. Contains no game, provider identity, price, or identifying clock. Pro may upgrade to Max to open these ranks. */
+    locked_picks?: {
+        pick_rank: number;
+        required_tier: "max";
+    }[];
+    /** Actionable status, including Upgrade to Max when only locked ranks are published. */
+    message?: string;
     /** Stable pick row identity as decimal text. Never use a quality rank as identity. */
     pick_id?: string;
     /** Compatibility release slot. No quality claim; historic scheduling order is retained. */
@@ -1393,11 +1404,13 @@ export type PickOfTheDay = {
     is_free_selection?: boolean;
     /** Replacement predecessor stable id; null when no lineage is recorded. */
     supersedes_pick_id: string | null;
+    /** Optional full-only lead wallet publication facts. Omitted on legacy picks or when the recorded evidence is unavailable. */
+    lead_backer?: PickLeadBacker;
 };
 export type PickOfTheDayArchive = {
-    /** Every published Pick of the Day, newest first by pick_date and then pick_rank within each product day. */
+    /** Published Pick of the Day selections that have not been withdrawn, newest first by pick_date and then pick_rank within each product day. Withdrawn rows stay excluded after settlement. */
     picks: PickOfTheDayArchiveEntry[];
-    /** One entry per product day that has a published pick, newest first, in the same order as picks. Each carries that day's net units, accumulated in the same backend pass and behind the same visibility gate as hit_rate.unit_score, so both cover the same population of picks. Re-adding the day totals reproduces hit_rate.unit_score to display precision rather than bit-for-bit, since that re-associates the floating-point sum. */
+    /** One entry per product day that has a published pick included in the archive, newest first, in the same order as picks. Each carries that day's net units, accumulated in the same backend pass and behind the same visibility gate as hit_rate.unit_score, so both cover the same population of picks. Re-adding the day totals reproduces hit_rate.unit_score to display precision rather than bit-for-bit, since that re-associates the floating-point sum. */
     days: PickOfTheDayArchiveDay[];
     hit_rate: PickOfTheDayHitRate;
 };
@@ -1429,12 +1442,12 @@ export type PickOfTheDayArchiveEntry = {
      * @deprecated
      */
     pick_rank?: number;
-    /** When this pick became public (RFC3339 UTC). pick_date above is the America/New_York product day, not an instant, so read this whenever you need a real time: reading the bare date as UTC midnight places it hours before the earliest instant a pick can drop (11:00 UTC on that date). A day's last pick can drop at 23:00 ET, which is the following UTC date. Omitted (not null) when the instant is unknown; additive and optional for mixed-version client compatibility. */
+    /** When this selection was published, as RFC3339 UTC. Use this instant for publication feeds and timelines; pick_date is the America/New_York product day, not a publication timestamp. Automatic qualification can begin at ET midnight. Absent only for historical rows whose publication instant is unknown. */
     published_at?: string;
     /** Human-readable matchup (e.g. "Portugal vs. Uzbekistan"). */
-    matchup: string;
+    matchup?: string;
     /** Frozen canonical calibration/report bucket (e.g. "Basketball", "MMA", or "Soccer"). Existing semantics are unchanged; presentation consumers should prefer display_category when present. */
-    category: string;
+    category?: string;
     /** Frozen public presentation category: the competition the Polymarket event belongs to. A curated label comes first -- an official league (e.g. "WNBA" or "UFC"), the esports title (e.g. "CS2", "LoL", "Dota 2" or "Valorant"), or a soccer competition (e.g. "LaLiga", "Premier League", "Serie A" or "UEFA Champions League"); any other competition carries the provider's own competition name without its season year (e.g. "UEFA Nations League", "ATP" or "Wimbledon"). It equals category only when the provider names no competition. An esports pick keeps the pooled "Esports" bucket in category, so a per-title label never implies a per-title measured cohort. Additive and optional for mixed-version client compatibility. */
     display_category?: string;
     /** Provider (Polymarket Gamma) market thumbnail URL (markets.image); omitted (not null) when the market has no image. Public regardless of the backed-side gate, so present for pending rows too. */
@@ -1479,6 +1492,10 @@ export type PickOfTheDayArchiveEntry = {
     unit_score?: number;
     /** Backend-formatted signed unit score, present exactly when unit_score is present. */
     unit_score_display?: string;
+    /** The account or paid tier needed to open this unresolved rank. */
+    required_tier?: "account" | "insider" | "max";
+    /** True for an unauthorized unresolved row. Game identity, category, image, publication clock and all backed facts are omitted. */
+    backed_side_locked?: boolean;
     /** Stable pick row identity as decimal text. Never use a quality rank as identity. */
     pick_id: string;
     /** Compatibility release slot. No quality claim; historic scheduling order is retained. */
@@ -1661,7 +1678,7 @@ export type PickOfTheDayLedgerOpenedEntry = {
     /** Explicit proof provenance: 1 retains historic eight-field canonical JSON; 2 binds stable pick_id and version without pick_rank. */
     commitment_version: 1 | 2;
 };
-/** A published pick that has not settled. Carries the commitment and nothing that states a side or a price: no nonce, no payload, no outcome. Publishable the instant the pick releases. */
+/** An unresolved published pick. Carries only date, rank, hash, algorithm, seal instant and permalink. Kickoff and game identity are withheld; seal time remains public commitment provenance. */
 export type PickOfTheDayLedgerSealedEntry = {
     state: "sealed";
     /** ET product day the pick belongs to (YYYY-MM-DD). */
@@ -1677,8 +1694,6 @@ export type PickOfTheDayLedgerSealedEntry = {
     commitment_algo: "sha256(canonical_json(payload)||nonce)";
     /** When the hash was frozen. Always strictly before kickoff: a pick that reaches kickoff unsealed stays unsealed forever, because a seal written after the game started would be a backdated proof. */
     sealed_at: string;
-    /** The frozen provider kickoff in the canonical payload form: whole seconds, UTC, literal Z. This exact string reappears inside payload.kickoff when the pick opens. */
-    kickoff: string;
     /** The pick's public page. */
     permalink: string;
     /** Stable pick row identity as decimal text. Never use a quality rank as identity. */
@@ -1692,7 +1707,7 @@ export type PickOfTheDayLedgerSealedEntry = {
     /** Explicit proof provenance: 1 retains historic eight-field canonical JSON; 2 binds stable pick_id and version without pick_rank. */
     commitment_version: 1 | 2;
 };
-/** A published pick with no commitment: it predates the scheme, or it reached kickoff unsealed. Nothing here is evidence of WHEN the pick was made. It is emitted rather than skipped, because a ledger with holes where the unprovable picks were would silently flatter the record. Once the pick settles, payload names its market, side and price, so the outcome can still be checked against the market's own resolution. */
+/** A pick without a commitment, retained so the record cannot omit unprovable entries. Unresolved entries omit game identity; once resolved, matchup, category and payload become public. Existing opened canonical payload bytes and hashes are unchanged. */
 export type PickOfTheDayLedgerUncommittedEntry = {
     state: "uncommitted";
     /** ET product day the pick belongs to (YYYY-MM-DD). */
@@ -1707,9 +1722,9 @@ export type PickOfTheDayLedgerUncommittedEntry = {
     /** How the pick settled, or pending. */
     outcome: "pending" | "win" | "loss" | "void";
     /** Frozen matchup, for a reader. */
-    matchup: string;
+    matchup?: string;
     /** Frozen canonical sport bucket used for selection calibration (Basketball, MMA), not the exact public league identity; the archive owns that. */
-    category: string;
+    category?: string;
     /** When outcome was LAST written to a settled value, or null when that instant is unknown. It moves with a corrected market re-mapping an already-settled pick, while commitment_hash stays untouched -- which is how a mirror that keeps history sees a correction. */
     resolved_at: string | null;
     /** The pick's market, side and price once it has settled; null while it is pending, and null for a settled pick whose stored row lacks one of these columns. Not hashed: nothing was committed over these values, which is what pre_commitment: true says. */
@@ -1725,6 +1740,30 @@ export type PickOfTheDayLedgerUncommittedEntry = {
     /** Replacement predecessor stable id; null when no lineage is recorded. */
     supersedes_pick_id: string | null;
 };
+/** A successful current-day entitlement response when only unauthorized ranks have published. It carries an empty pick set, identity-free locked ranks and an upgrade message. Selection IDs, game identity, prices and unauthorized clocks are absent. Any scheduled or proof-pending rows are entitled rows. */
+export type PickOfTheDayNoEntitledPicks = {
+    /** Only locked ranks are published for this account. */
+    state: "none";
+    /** Current product date in America/New_York (YYYY-MM-DD). */
+    pick_date: string;
+    /** Empty: no entitled proof-readable picks are returned. */
+    picks: PickOfTheDay[];
+    /** Zero entitled proof-readable picks. */
+    pick_count: 0;
+    /** Unauthorized unresolved published or scheduled ranks. Contains no game, provider identity, price, or identifying clock. Pro may upgrade to Max to open these ranks. */
+    locked_picks: {
+        pick_rank: number;
+        required_tier: "max";
+    }[];
+    /** Actionable status, including Upgrade to Max when only locked ranks are published. */
+    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[];
+    /** Null: the empty entitlement envelope has no selection lineage. */
+    supersedes_pick_id: null;
+};
 /** 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. */
@@ -1765,7 +1804,7 @@ export type PickSportsContext = {
     /** The two teams as a single whole-game label, joined "<home> – <away>" (en-dash) in provider display order (e.g. "Portugal – Uzbekistan"). Composed server-side from the provider team names (no title/slug parsing). Present when both teams resolve a name; omitted for single-subject, teamless, or non-two-team contexts. */
     matchup_title?: string;
 };
-/** A single sports team or competitor in a Pick of the Day market's sports context. Identity and score fields are provider-owned and nullable. The structured score fields (`sets`, `format`, `sets_won`) and the tennis fields (`headshot`, `tour`) are backend-owned and are OMITTED rather than null when they do not apply, so a consumer must treat an absent key and a null the same way. */
+/** A single sports team or competitor in a Pick of the Day market's sports context. Identity and score fields are provider-owned and nullable. The structured score fields (`sets`, `format`, `sets_won`) and the tennis fields (`headshot`, `headshot_revision`, `tour`) are backend-owned and are OMITTED rather than null when they do not apply, so a consumer must treat an absent key and a null the same way. */
 export type PickSportsTeam = {
     /** Team display label as it appears on the market outcome (e.g. "Portugal"). */
     label: string | null;
@@ -1775,9 +1814,9 @@ export type PickSportsTeam = {
     full_name: string | null;
     /** Provider team identifier (Polymarket /teams id). */
     provider_id: number | null;
-    /** Team crest or flag URL. Provider-owned for most teams (Polymarket /teams crest for clubs, country flag for national teams and tennis players). A club with a vendored crest carries it instead, served same-origin as a relative path (`/api/sports/team-logos/{league}/{abbr}.svg?v=<content hash>` or `.png`, resolve it against this server): every NFL and WNBA team, whose provider asset is a text tile, and the soccer clubs whose provider asset is an empty object. */
+    /** Team crest or flag URL. Official NFL (32), WNBA (15), NBA (30), NHL (32), and MLB (30) club crests use same-origin relative paths (`/api/sports/team-logos/{league}/{abbr}.svg?v=<content hash>`); resolve relative URLs against the API origin. Vendored soccer club crests use the same path with `.png`. Other teams use provider artwork, including country flags for national teams and tennis players. Novelty and national-team rows outside the vendored club sets retain provider artwork. */
     logo: string | null;
-    /** True when the team mark is dark enough to disappear on a dark background, measured from the artwork by the teams sync. Render a dark mark on a light plate. Always sent; false until the artwork has been measured. */
+    /** True when artwork measurements show that the team mark needs a light plate on a dark background. Vendored crest verdicts are tied to the exact asset bytes; provider artwork is measured by the teams sync. Always sent; false when no current measurement marks the logo dark. */
     logo_mark_dark: boolean;
     /** Team brand color as a hex string (provider-owned). */
     color: string | null;
@@ -1794,11 +1833,10 @@ export type PickSportsTeam = {
     format?: ScoreFormat;
     /** Completed sets won by this side. Present only when both sides expose the same set columns, so a partially parsed scoreline reports no tally rather than a misleading one. */
     sets_won?: number;
-};
-/** Field-level trust metadata for the full Pick of the Day payload. Present on the full shape only (omitted on the teaser and the no-pick state, because whether a specialist backs the pick is itself backed-side evidence). Unlike TraderTrust it is not gated behind expand=trust: it carries one member on an endpoint that returns a single object per day. */
-export type PickTrust = {
-    /** Provenance of the frozen qualifying category expert. source.kind=database with reconciliation.status=db_mirror means the evidence deserialized, still satisfies every frozen selection gate, and is being served. On that arm freshness.status is always not_live and never fresh, because this evidence is frozen at selection and never refreshed, so on an archived pick the as_of (the expert's own stats_computed_at) can be days or months old by design. source.kind=computed with reconciliation.status=not_applicable means the selector evaluated the backed side and nobody qualified -- a real negative. source.kind=computed with freshness.status=unknown and completeness.status=not_computed means the selector never evaluated this field, as on a pre-feature pick. source.kind=unavailable means the payload is malformed, violates a selection gate, or conflicts with its persisted status, or the public V1 adapter intentionally omitted a current-policy B-grade expert; read the reason before treating it as a negative. Do not read an omitted qualifying_expert as 'no specialist' without checking this field. */
-    qualifying_expert: TrustMetadata;
+    /** Optional monotonic photo revision for this tennis player, independent of the sports score revision. Legacy stored photos start at zero. Successful new or changed image bytes advance it; source checks and attribution changes do not. Compare only for the same tour and provider_id: a higher revision replaces the portrait, an equal revision may fill a missing portrait, and a lower revision must not replace a newer one. Absent when no photo resolved. */
+    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;
 };
 export type PlatformCapabilities = {
     grade: PlatformCapabilityStatus;
@@ -1909,11 +1947,12 @@ export type PositionTimelineEvent = {
     /** Cumulative buy-weighted average of stored fills for this outcome, including older pages; not provider current-position avgPrice. Sells do not change this value. 0 when no stored buys have occurred yet. */
     running_avg_price: number;
 };
-/** Policy-7 issuance binds one condition, selected token, outcome, canonical event and sport. Reuse the same authorization across public/private discovery and retries. Require a new account-size executable book and current market eligibility; this frozen reference does not prove current liquidity or positive expected value. Absence or expiry cannot authorize a new automated entry. */
+/** Returned entry permission bound to the named market, token and outcome. New policy-8 grants allow five cents above the first reference ask, capped at 85 cents and floored to the provider tick; policy-7 grants retain their original two-cent allowance. Honor the immutable max_entry_price and expires_at, and quote a current executable book for the actual stake. The submitted order price must remain within the limit; fills may be lower. Fees are separate, and this grant does not guarantee liquidity, execution or positive expected value. */
 export type PotdEntryAuthorization = {
     version: 1;
     authorization_id: string;
-    policy_version: 7;
+    /** Entry allowance policy, independent of selection or feed policy. Policy 8 issues new grants at the first reference ask plus 0.05, capped at 0.85 and floored to the provider tick. Policy 7 retains its original plus-0.02 grant. Existing grants never rise or extend. */
+    policy_version: 7 | 8;
     condition_id: string;
     token_id: string;
     outcome_index: 0 | 1;
@@ -1921,13 +1960,14 @@ export type PotdEntryAuthorization = {
     category: string;
     /** Exact provider parent event ID, or provider event ID when no parent exists. */
     canonical_event_id: string;
-    /** Immutable decimal limit: first fresh selected-token ask plus 0.02, floored to the provider tick below 1. Fees excluded. Never a calibrated fair probability. */
+    /** Maximum authorized order price as an exact decimal string, excluding fees. Quote a current executable book for the actual stake and keep the submitted order price at or below this bound. Actual fills may be lower; this limit does not guarantee a fill or define fair probability. */
     max_entry_price: string;
+    /** Selected-token best ask at first issuance. The entry allowance uses this immutable reference, not the published pick price or a later quote. */
     reference_best_ask: string;
     reference_book_hash: string;
     reference_book_at: string;
     issued_at: string;
-    /** Original provider kickoff ceiling. Never extended on retry. */
+    /** Original authorization expiry at the earlier requested or provider kickoff; never extended. An expired authorization cannot authorize a new automated entry. */
     expires_at: string;
 };
 /** One ranked pre-game sports market where graded sharp money is piled on one side, with required-status shadow category evidence from partial forward-observed Polymarket fills. */
@@ -1936,7 +1976,7 @@ export type PreGameSide = {
     side: string | null;
     /** UTC time at which the snapshot that ranked this row was computed. Canonical spelling of signal_created_at (#16310), same value. */
     ranked_at: string;
-    /** Grade-weighted holders times the share of their money on the side: (5*s + 4*a + 3*b) * sharp_pct. Canonical spelling of conviction_score (#16310), same value. */
+    /** Recorded side backing score; higher values indicate stronger backing. */
     backing_score: number;
     /** Signed share of graded money on the side, (yes_usd - no_usd)/(yes_usd + no_usd) in [-1, 1] (side-yes positive, side-no negative). Canonical spelling of smart_score (#16309, #16310), same value. */
     side_share: number | null;
@@ -1979,7 +2019,7 @@ export type PreGameSide = {
     /** Best grade present on the piled side; null when none. */
     top_grade: "S" | "A" | "B" | null;
     /**
-     * Canonical sharp-money score (yes_usd - no_usd)/(yes_usd + no_usd) in [-1, 1] (piled-yes positive, piled-no negative); a lower-order ranking tiebreak (after directional_rank_score and conviction_score). Deprecated (#16310): `side_share` is the canonical spelling and carries the same value; this key stays on the wire.
+     * Canonical sharp-money score (yes_usd - no_usd)/(yes_usd + no_usd) in [-1, 1] (piled-yes positive, piled-no negative). Deprecated (#16310): `side_share` is the canonical spelling and carries the same value; this key stays on the wire.
      * @deprecated
      */
     smart_score: number | null;
@@ -1988,7 +2028,7 @@ export type PreGameSide = {
     /** Aggregate recent flow direction on the market; null when unavailable. */
     net_side: "BUY" | "SELL" | null;
     /**
-     * Grade-weighted pile score (5*s + 4*a + 3*b) * sharp_pct; the raw conviction input to the ranking (see directional_rank_score). Deprecated (#16310): `backing_score` is the canonical spelling and carries the same value; this key stays on the wire.
+     * Recorded conviction score; higher values indicate stronger conviction.
      * @deprecated
      */
     conviction_score: number;
@@ -2000,7 +2040,7 @@ export type PreGameSide = {
     one_way_graded_usd: number | null;
     /** One-way fraction of the piled graded dollars, in [0, 1] -- the metric orthogonal to sharp_pct. Stale, unknown, hedged, and two-sided dollars dilute it toward zero (conservative). Null when the directional read was not computed or classified nobody. */
     directional_confidence: number | null;
-    /** The ranking key, descending: conviction_score * (1 + 0.25 * directional_confidence). Equals conviction_score when the directional read is null/zero, so signals without the read rank exactly as before. */
+    /** Recorded side ordering score; higher values sort first. */
     directional_rank_score: number;
     category_skill: PreGameSideCategorySkill;
     /** 1-based rank within the (min_grade-filtered) ranked result. */
@@ -2037,7 +2077,7 @@ export type PreGameSideFunnelReport = {
 export type PreGameSideObservation = {
     /** The side profitable wallets hold, as a provider-backed display label. Canonical spelling of piled_side (#16310), same value: when provider group context is unavailable it may remain a bare Yes/No/Over/Under, so do not use it alone as participant identity. */
     side: string | null;
-    /** Grade-weighted holder-pile score before directional enrichment. Canonical spelling of conviction_score (#16310), same value. */
+    /** Recorded side backing score; higher values indicate stronger backing. */
     backing_score: number;
     /** Signed share of graded money on the side, in [-1, 1]. Canonical spelling of smart_score (#16309, #16310), same value. */
     side_share: number;
@@ -2091,7 +2131,7 @@ export type PreGameSideObservation = {
     /** Strictly positive stored market volume in USD. Missing, zero, or non-finite volume terminates as invalid_market and is never emitted as an observation. */
     volume: number;
     /**
-     * Grade-weighted holder-pile score before directional enrichment. Deprecated (#16310): `backing_score` is the canonical spelling and carries the same value; this key stays on the wire.
+     * Recorded conviction score; higher values indicate stronger conviction.
      * @deprecated
      */
     conviction_score: number;
@@ -2107,7 +2147,7 @@ export type PreGameSideObservation = {
     hedged_holder_count: number | null;
     one_way_graded_usd: number | null;
     directional_confidence: number | null;
-    /** Default cohort ordering key: conviction_score * (1 + 0.25 * directional_confidence), or conviction_score when confidence is null. */
+    /** Recorded side ordering score; higher values sort first. */
     directional_rank_score: number;
     /** 1-based rank within this observation cohort and snapshot. */
     rank: number;
@@ -2288,14 +2328,14 @@ export type ResponseMeta = {
     /** Independent SHA-256 recomputation over the same base fields immediately after category-skill enrichment. Equality with category_skill_base_payload_hash proves shadow enrichment did not change funded inputs. Sports-edge-signals only. */
     category_skill_enriched_base_payload_hash?: string;
 };
-/** One same-day pick that is selected but not yet released: its stable slot rank plus the backend-owned release and kickoff instants. Deliberately minimal -- no matchup, category, platform, side, price, or holder fields exist on this shape before release. */
+/** An entitled same-day pick selected but not yet released: stable rank and backend-owned release/kickoff instants. No matchup, category, platform, side, price, or holder fields appear before release. Unauthorized scheduled ranks appear only in locked_picks. */
 export type ScheduledPickSlot = {
     /**
      * Deprecated compatibility daily release slot; use pick_id for identity and publication_order for scheduling.
      * @deprecated
      */
     pick_rank: number;
-    /** The slot's scheduled release instant, normally the current provider kickoff minus one hour. The actual publish can trail it by bounded worker delay. */
+    /** The slot's stored release instant. Qualified automatic selections are due immediately; explicitly scheduled selections retain their stored time. The actual publication can follow final checks and worker delay. */
     release_at: string;
     /** The backed game's current kickoff instant. */
     kickoff: string;
@@ -2415,6 +2455,41 @@ export type SuspiciousTrade = {
     /** Stored trade timestamp. */
     created_at: string;
 };
+/** 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. */
+export type TennisPoints = {
+    source: "api_tennis";
+    /** API-Tennis match ID. This is not a Polymarket market or event ID. */
+    match_key: number;
+    /** API-Tennis player IDs in the same first/second order as live_score.scores. These are not Polymarket team IDs. */
+    player_keys: number[];
+    /** Current-game point values in first/second order. Read strings, including A for advantage and numeric tiebreak points. Missing points are not zero. */
+    points: string[];
+    /** The serving player in live_score.scores display order. Omitted when API-Tennis does not identify the server. */
+    serving_side?: "first" | "second";
+    /** Orders only the tennis_points group for the same match. Never compare this with live_score.source_revision. */
+    source_revision: number;
+    /** When 0xinsider observed these API-Tennis facts. This is not a timestamp from the court. */
+    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. */
+    set_number: number;
+    /** Current-set games in first/second order. Display points only while these match the enclosing scoreboard. */
+    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 = {
+    /** Provider-reported singles rank. */
+    rank: number;
+    /** The player ranking tour. */
+    tour: "atp" | "wta";
+    /** The standings provider. */
+    source: "api_tennis";
+    /** Successful snapshot retrieval time in UTC, not ranking publication date. */
+    observed_at: string;
+    /** UTC deadline after which clients must hide this rank, including when an older game or pick response remains cached. */
+    expires_at: string;
+};
 export type Trader = {
     /** Prefixed ID (trd_...). */
     id: string;
@@ -2424,9 +2499,9 @@ export type Trader = {
     /** 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;
-    /** Capital-normalized forecasting score: the cohort percentile (0-100) of the EB-shrunk calibration edge. Omitted when the forecasting signal is unavailable; never replaced with zero. */
+    /** Optional forecast score on the documented display scale. Null when unavailable. */
     forecast_score?: number;
-    /** Share of forecast_score supported by the trader's own resolved-market record rather than the cohort prior: n / (n + 30). Omitted when forecast_score is unavailable. */
+    /** Optional measured forecast context. Missing values remain unavailable rather than being inferred. */
     forecast_evidence?: number;
     rank?: number;
     pnl: {
@@ -2451,15 +2526,16 @@ export type Trader = {
         exact?: TraderStatsExact;
     };
     strategy?: {
+        /** Observed trading style identifier. New rows use two_sided, category_focused, high_activity, diversified, mixed, or unclassified. Historical identifiers remain readable during normal reclassification; style does not predict skill or intent. */
         strategy_type?: string;
         description?: string;
         confidence?: number;
     };
-    /** Per-category performance breakdown (expand=categories or expand[]=categories). Omitted unless expanded. Object keyed by category name; each value is the precomputed trader_rankings.category_ranks payload (rank, total_in_category, total_pnl, scaled_total_pnl, n_markets, wins, losses, win_rate; scaled_total_pnl is a legacy alias that currently equals total_pnl). RANK BASIS: rank and total_in_category use the same hourly breakpoint publication; categories absent from that publication are omitted until a later publication includes them. Current trader performance values update separately, so this is not a frozen historical record. BASIS: the calibration sample, which admits a position only above a 20 USD notional floor and with a chosen-side entry price strictly inside (0,1), because the ranks and the calibration edge derived from it depend on both rules. That is a different sample from GET /api/v1/trader/{address}/categories, which counts every settled market at any size, and the two differ in both directions. Measured on production 2026-09-22 over the 122,497 wallet-category pairs with at least 20 decided markets on both bases: the floored rate was higher in 56.5% of pairs, lower in 34.5% and equal in 9.0%, median +0.6 points, p10 -4.6, p90 +9.8, and 14.0% of pairs differ by 10 points or more. The difference is not only small positions: on a 1-in-250 wallet sample the same day, admitted markets won 56.6% while markets dropped by the notional floor alone won 45.2% and markets dropped by the entry-price rule alone won 48.7%. n_markets counts every admitted market including the ones that resolved at exactly zero P&L, so it is not the denominator of win_rate: it differed from wins + losses in 15.8% of pairs with at least 5 decided markets. The two tables also run on different clocks, this one updated incrementally and that route rebuilt daily, so a same-day read can differ on timing alone. Use this for rank context and that route for the wallet's plain record. Pass-through DB JSON: keys and value shape are DB-owned, so the inner shape is intentionally unconstrained and may carry additional compatibility fields. */
+    /** 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. 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. */
     quant_metrics?: {
-        /** Composite skill score, 0-100. smart_score = clamp(0, 100, 30*sharpe_percentile_fraction + 20*profit_factor_percentile_fraction + 20*edge_consistency_percentile_fraction + 10*min(1, return_on_capital/2) + 10*equity_smoothness + 10*(1 - min(1, asset_concentration))). Higher is better. null when insufficient history. */
+        /** Trader smart score on a 0..100 display scale; higher is stronger. Null when unavailable. */
         smart_score: number | null;
         /** Copyability score, 0-100. Same base as smart_score minus penalties for traits that make a strategy hard to replicate: -20 if fewer than 50 markets traded, -15 if positions are highly concentrated, -15 if position sizing exceeds about 2x Kelly, -10 if the worst single-trade loss exceeds 30%, -10 if edge is inconsistent; result clamped to 0-100. Higher means easier to follow. null when insufficient history. */
         copy_score: number | null;
@@ -2955,7 +3031,7 @@ export type Usage = {
             reset_at: number;
             window_seconds: number;
         };
-        /** The monthly request quota (#16111): where the account stands against the requests Pro includes per UTC calendar month. Reading it here spends nothing. null only when the month's count could not be read for this response. */
+        /** The monthly request quota (#16111): where the account stands against the requests the current Pro or Max plan includes per UTC calendar month. Reading it here spends nothing. null only when the month's count could not be read for this response. */
         monthly_quota: {
             /** Admitted requests so far this UTC calendar month. */
             used: number;
@@ -2972,6 +3048,8 @@ export type Usage = {
             pay_as_you_go: boolean;
             /** The most requests this account is admitted in a UTC calendar month once enforcement has begun: limit, or 1,000,000 with pay as you go on. null for an admin account, which no number stops. Additive since 2026-09-22. */
             ceiling: number | null;
+            /** A historical usage price has not been reconciled to this plan allowance. Pay as you go remains unavailable until billing reconciliation. */
+            unavailable_reason?: "usage_price_reconciliation_required" | null;
         } | null;
     };
     meta: ResponseMeta;
@@ -3053,6 +3131,29 @@ export type WebhookVerification = {
     token: string;
     expires_at: string;
 };
+export type WebhookVerificationAttempt = {
+    id: string;
+    object: "webhook_verification_attempt";
+    webhook_id: number;
+    /** queued/running are pending consent. verified means the same endpoint revision answered 2xx and activated atomically. failed/cancelled/expired are terminal and do not restart on polling or replay. */
+    state: "queued" | "running" | "verified" | "failed" | "cancelled" | "expired";
+    /** Sanitized last observation. Null before an observation; queued retries may retain their previous failure outcome. */
+    outcome: "verified" | "target_rejected" | "challenge_timeout" | "transport_failed" | "receiver_rejected" | "token_expired" | "endpoint_changed" | "owner_revoked" | "attempts_exhausted" | "internal_error" | null;
+    attempt_count: number;
+    max_attempts: 4;
+    /** Earlier of the verification-token deadline and 15 minutes after admission. Activation is forbidden at or after this instant. */
+    expires_at: string;
+    /** Scheduled retry/admission time while queued; null while running or terminal. */
+    next_attempt_at: string | null;
+    /** Actual receiver HTTP status, when one arrived. No receiver response body or resolved address is returned. */
+    last_response_status: number | null;
+    started_at: string | null;
+    completed_at: string | null;
+    created_at: string;
+    updated_at: string;
+    /** Relative authorized API path for this attempt. Uses the same bearer credential as admission. */
+    status_url: string;
+};
 export type WhaleDatasetArtifactManifest = {
     /** Version of the artifact manifest contract. */
     manifest_version: string;
@@ -3302,6 +3403,7 @@ export interface OperationData {
         };
     };
     createWebhook: WebhookEndpoint;
+    createWebhookVerificationAttempt: WebhookVerificationAttempt;
     deleteWebhook: WebhookEndpoint;
     exploreMarkets: ExploreEntry[];
     getAccountIdentity: {
@@ -3354,7 +3456,7 @@ export interface OperationData {
     getMarketIntel: MarketFlow;
     getMarketSnapshot: MarketSnapshot;
     getMonthlyReportSnapshot: ReportSnapshot;
-    getPickOfTheDay: PickOfTheDay;
+    getPickOfTheDay: PickOfTheDay | PickOfTheDayNoEntitledPicks;
     getPickOfTheDayArchive: PickOfTheDayArchive;
     getPickOfTheDayLedger: PickOfTheDayLedger;
     getPickOfTheDayLedgerEntry: PickOfTheDayLedgerEntry;
@@ -3436,7 +3538,7 @@ export interface OperationData {
             reset_at: number;
             window_seconds: number;
         };
-        /** The monthly request quota (#16111): where the account stands against the requests Pro includes per UTC calendar month. Reading it here spends nothing. null only when the month's count could not be read for this response. */
+        /** The monthly request quota (#16111): where the account stands against the requests the current Pro or Max plan includes per UTC calendar month. Reading it here spends nothing. null only when the month's count could not be read for this response. */
         monthly_quota: {
             /** Admitted requests so far this UTC calendar month. */
             used: number;
@@ -3453,9 +3555,12 @@ export interface OperationData {
             pay_as_you_go: boolean;
             /** The most requests this account is admitted in a UTC calendar month once enforcement has begun: limit, or 1,000,000 with pay as you go on. null for an admin account, which no number stops. Additive since 2026-09-22. */
             ceiling: number | null;
+            /** A historical usage price has not been reconciled to this plan allowance. Pay as you go remains unavailable until billing reconciliation. */
+            unavailable_reason?: "usage_price_reconciliation_required" | null;
         } | null;
     };
     getWebhook: WebhookEndpoint;
+    getWebhookVerificationAttempt: WebhookVerificationAttempt;
     getWeeklyReportSnapshot: ReportSnapshot;
     getWhaleDatasetStatus: {
         job_id: number;
@@ -3654,6 +3759,7 @@ export interface OperationQuery {
     cancelWhaleDataset: Record<string, never>;
     createMcpJsonRpcResponse: Record<string, never>;
     createWebhook: Record<string, never>;
+    createWebhookVerificationAttempt: Record<string, never>;
     deleteWebhook: Record<string, never>;
     exploreMarkets: {
         /** Filter by market category (case-insensitive). A canonical bucket name (e.g. Basketball) matches every provider member that folds into it (NBA, WNBA, NCAAB); a raw provider value also resolves to its bucket. Facet values are returned as the canonical bucket. */
@@ -3720,7 +3826,7 @@ export interface OperationQuery {
         min_grade?: "S" | "A" | "B";
         /** Maximum holders per page. Out-of-range values are clamped to 1..100. */
         limit?: number;
-        /** Opaque pagination cursor from the previous response's next_cursor. It encodes a page of one shared roster, so it stays valid across the roster's refresh, but a page read after a refresh can repeat or skip a holder. */
+        /** Opaque pagination cursor from the previous response's next_cursor. New cursors carry an absolute next offset bound to normalized condition_id, outcome and effective min_grade, so limit can change without skipping or repeating rows on the same roster. Different market/filter bindings return 400 bad_request with param=cursor; omitted filters match all/B and mkt_-prefixed IDs match their raw condition_id. Legacy page-only cursors remain accepted without scheduled retirement and require their original limit; their next response emits the new format. A cursor remains valid across roster refreshes, which can still repeat or skip holders as the live roster changes. */
         cursor?: string;
     };
     getMarketIntel: {
@@ -3816,6 +3922,7 @@ export interface OperationQuery {
     };
     getUsage: Record<string, never>;
     getWebhook: Record<string, never>;
+    getWebhookVerificationAttempt: Record<string, never>;
     getWeeklyReportSnapshot: {
         /** UTC source-range start in YYYY-MM-DD format; required with to. Together with to, selects an exact ephemeral range of at most 31 inclusive UTC days. A start after tomorrow UTC returns 400 bad_request with error.param=from. */
         from?: string;
@@ -3939,8 +4046,8 @@ export interface OperationQuery {
         cursor?: string;
         /** Filter by category. Values are matched to canonical category buckets: political variants (Elections, Global Politics, U.S. Politics, ...) fold into Politics, Geopolitics stays distinct, Culture/Entertainment map to Pop Culture, Science maps to Science & Tech, and Finance/Business map to Stocks. Mapped buckets are case-insensitive; passthrough categories (Crypto, NBA, and the sports leagues) match case-sensitively against the provider-native bucket key, so use exact casing (e.g. Crypto, NBA). */
         category?: string;
-        /** Filter by ML-detected strategy type. Values come from backend/crates/analytics/src/trader_analysis/classification/decision_tree.rs and are matched exactly against ml_trader_category.primary_type. Values outside the declared enum return HTTP 400. */
-        strategy?: "accumulator" | "algo_trader" | "arbitrageur" | "directional" | "event_driven" | "market_maker" | "momentum" | "scalper" | "speculator" | "swing_trader";
+        /** Filter by observed trading style. Current styles: two_sided, category_focused, high_activity, diversified, mixed, unclassified. 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";
     };
     listPositions: {
         /** Maximum number of current positions to return. Out-of-range values are clamped to 1..100. */
@@ -4184,6 +4291,10 @@ export interface OperationPath {
     };
     createMcpJsonRpcResponse: Record<string, never>;
     createWebhook: Record<string, never>;
+    createWebhookVerificationAttempt: {
+        /** Webhook endpoint id owned by the authenticated API key user. */
+        id: number;
+    };
     deleteWebhook: {
         /** Webhook endpoint id owned by the authenticated API key user. */
         id: number;
@@ -4291,6 +4402,12 @@ export interface OperationPath {
         /** Webhook endpoint id owned by the authenticated API key user. */
         id: number;
     };
+    getWebhookVerificationAttempt: {
+        /** Webhook endpoint id owned by the authenticated API key user. */
+        id: number;
+        /** Verification attempt UUID returned by admission. Must belong to this webhook and account. */
+        attempt_id: string;
+    };
     getWeeklyReportSnapshot: Record<string, never>;
     getWhaleDatasetStatus: {
         /** Dataset job ID returned by submit; another owner or a trader export returns 404. */
@@ -4412,6 +4529,7 @@ export interface OperationBody {
         params?: Record<string, unknown>;
     };
     createWebhook: CreateWebhookRequest;
+    createWebhookVerificationAttempt: CreateWebhookVerificationAttemptRequest;
     deleteWebhook: never;
     exploreMarkets: never;
     getAccountIdentity: never;
@@ -4450,6 +4568,7 @@ export interface OperationBody {
     getTraderPnl: never;
     getUsage: never;
     getWebhook: never;
+    getWebhookVerificationAttempt: never;
     getWeeklyReportSnapshot: never;
     getWhaleDatasetStatus: never;
     getWhaleTrade: never;
@@ -4538,6 +4657,11 @@ export interface OperationResponse {
         data: OperationData["createWebhook"];
         meta: ResponseMeta;
     };
+    createWebhookVerificationAttempt: {
+        object: "webhook_verification_attempt";
+        data: OperationData["createWebhookVerificationAttempt"];
+        meta: ResponseMeta;
+    };
     deleteWebhook: {
         object: "webhook";
         data: OperationData["deleteWebhook"];
@@ -4733,6 +4857,11 @@ export interface OperationResponse {
         data: OperationData["getWebhook"];
         meta: ResponseMeta;
     };
+    getWebhookVerificationAttempt: {
+        object: "webhook_verification_attempt";
+        data: OperationData["getWebhookVerificationAttempt"];
+        meta: ResponseMeta;
+    };
     getWeeklyReportSnapshot: {
         object: "report_snapshot";
         data: OperationData["getWeeklyReportSnapshot"];