@0xinsider/sdk 0.17.0 → 0.19.0

package/dist/schema.d.ts

@@ -76,7 +76,7 @@ export type ApiError = {
         /** The recommended next request instant (RFC3339), always in the future. Present on every retryable error: `pick_not_released`, `rate_limited`, `rate_limit_unavailable`, and `read_model_warming`. Omitted otherwise. The absolute twin of `Retry-After`; prefer the header for the sleep duration. For `pick_not_released`, the earliest of the next scheduled release, the next automatic selector attempt, the operating-window start, or about 60 seconds. See that response. */
         retry_at?: string;
         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. */
+        /** 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 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. */
         reason?: "cursor_expired" | "unknown_endpoint" | "pick_not_released" | "trader_not_tracked" | "read_model_warming" | "database_unavailable" | "request_accounting_unavailable" | "idempotency_in_progress" | "webhook_delivery_in_progress" | "webhook_secret_rotation_not_prepared" | "webhook_secret_rotation_overlap_active" | "sandbox_api_key" | "api_key_in_query" | "subscription_inactive" | "monthly_quota_exceeded" | "invalid_query" | "unknown_query_parameter" | "invalid_path" | "invalid_body" | "unsupported_media_type" | "payload_too_large" | "method_not_allowed" | "ip_rate_limited" | "ip_throttled" | "export_expired" | "freshness_ceiling_unsatisfied";
     };
     meta: ResponseMeta;
@@ -87,10 +87,10 @@ 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 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. */
+    /** 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 03:00 America/New_York 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. */
+    /** 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 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. */
     reason?: "cursor_expired" | "unknown_endpoint" | "pick_not_released" | "trader_not_tracked" | "read_model_warming" | "database_unavailable" | "request_accounting_unavailable" | "idempotency_in_progress" | "webhook_delivery_in_progress" | "webhook_secret_rotation_not_prepared" | "webhook_secret_rotation_overlap_active" | "sandbox_api_key" | "api_key_in_query" | "subscription_inactive" | "monthly_quota_exceeded" | "invalid_query" | "unknown_query_parameter" | "invalid_path" | "invalid_body" | "unsupported_media_type" | "payload_too_large" | "method_not_allowed" | "ip_rate_limited" | "ip_throttled" | "export_expired" | "freshness_ceiling_unsatisfied";
 };
 export type BatchMarketFlowItem = {
@@ -171,6 +171,196 @@ export type CategorySkillV2 = {
     edge_lower_95: number | null;
     brier_event_avg: number | null;
 };
+export type Combo = {
+    /** Combo identifier: 0x followed by 62 lowercase hex characters. This differs from a binary market condition ID. */
+    condition_id: string;
+    leg_count: number | null;
+    prepared_at: string | null;
+    /** Whether the preparation event has been indexed. */
+    legs_known: boolean;
+    legs: ComboLeg[];
+    window: ComboWindowStats | null;
+    totals: ComboTotals | null;
+    /** Result of the YES conjunction, independent of the wallet side or its P&L. */
+    status: "pending" | "won" | "lost" | "unknown";
+    /** Reason the conjunction result cannot be verified, when unknown. */
+    status_reason: string | null;
+};
+export type ComboCoverage = {
+    state: "paused" | "uninitialized" | "stale" | "backfilling" | "live";
+    ingest_enabled: boolean;
+    cursors: ComboCoverageCursor[];
+    max_lag_blocks: number | null;
+    oldest_cursor_update: string | null;
+    lifecycle_lag_blocks: number | null;
+    lifecycle_backfilling: boolean;
+    /** Time the coverage state was evaluated; not a market-price timestamp. */
+    computed_at: string;
+};
+export type ComboCoverageCursor = {
+    /** Indexed contract. */
+    contract: string;
+    last_block: number;
+    seed_block: number;
+    seed_origin: string;
+    chain_finalized_block: number | null;
+    lag_blocks: number | null;
+    updated_at: string;
+};
+/** One combo with its newest 100 fills and all-time lifecycle totals. Paid API callers receive full access. */
+export type ComboDetail = {
+    access: "full";
+    combo: Combo;
+    fills: ComboFill[];
+    lifecycle: ComboLifecycleStats | null;
+    coverage: ComboCoverage;
+};
+export type ComboFill = {
+    /** Stable fill identity. */
+    id: string;
+    block_number: number;
+    log_index: number;
+    block_timestamp: string;
+    tx_hash: string;
+    /** Taker wallet address. */
+    trader: string | null;
+    trader_name: string | null;
+    trader_grade: "S" | "A" | "B" | "C" | "D" | "F" | null;
+    /** Recorded wallet-wide trade time. */
+    last_traded_at: string | null;
+    action: "buy" | "sell";
+    /** Combo identifier: 0x followed by 62 lowercase hex characters. This differs from a binary market condition ID. */
+    condition_id: string;
+    /** 0 is YES, 1 is NO. */
+    outcome_index: number;
+    /** Exact decimal string from the stored chain or SQL value; preserve precision until display. */
+    shares: string;
+    /** Exact decimal string from the stored chain or SQL value; preserve precision until display. */
+    collateral_usdc: string;
+    /** Execution price for the traded outcome; null for a zero-share event. */
+    price: string | null;
+    /** Execution price normalized to YES. */
+    price_yes: string | null;
+    /** Exact decimal string from the stored chain or SQL value; preserve precision until display. */
+    fee_usdc: string;
+    leg_count: number | null;
+    /** Result of the YES conjunction, independent of the wallet side or its P&L. */
+    status: "pending" | "won" | "lost" | "unknown";
+    status_reason: string | null;
+    won_legs: number;
+    /** Shares per dollar at execution; not a forecast or guaranteed return. */
+    payout_multiplier: string | null;
+    legs: ComboLeg[];
+};
+export type ComboFillsResponse = {
+    object: "list";
+    data: ComboFill[];
+    sort: "recent" | "largest" | "payout";
+    window: "24h" | "7d" | "all";
+    limit: number;
+    coverage: ComboCoverage;
+    /** A continuation is available based on page fullness. Its next page may be empty. */
+    has_more: boolean;
+    /** Exclusive block_number:log_index continuation for recent ordering. */
+    next_cursor?: string;
+    /** 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;
+    outcome_index: number;
+    module_id: number;
+    state: "pending" | "won" | "lost" | "void" | "unknown";
+    market: ComboLegMarket | null;
+};
+export type ComboLegMarket = {
+    /** Source of the leg facts. */
+    source: "markets" | "provider";
+    /** Full binary CTF condition ID for this leg. */
+    condition_id: string;
+    title: string | null;
+    slug: string | null;
+    event_slug: string | null;
+    /** Provider-resolved URL including the referral tag. */
+    polymarket_url?: string;
+    outcome_label: string | null;
+    image: string | null;
+    category: string | null;
+    /** Provider outcome index; negative sentinels describe void or unresolved states. */
+    winning_outcome: number | null;
+    resolved_at: string | null;
+    /** A closed market may still have no terminal outcome. */
+    market_closed: boolean | null;
+    /** Stored daily price for this leg outcome token; not a live quote. */
+    pick_price_daily: number | null;
+    /** Observation time of the stored daily price. */
+    pick_price_as_of: string | null;
+    /** Whole days since the stored daily bucket. */
+    pick_price_age_days: number | null;
+    /** Unmodified provider leg status when available. */
+    provider_leg_status: string | null;
+};
+export type ComboLifecycleStats = {
+    splits: number;
+    merges: number;
+    redeems: number;
+    compresses: number;
+    /** Exact decimal string from the stored chain or SQL value; preserve precision until display. */
+    split_usdc: string;
+    /** Exact decimal string from the stored chain or SQL value; preserve precision until display. */
+    merge_usdc: string;
+    /** Exact decimal string from the stored chain or SQL value; preserve precision until display. */
+    redeemed_shares: string;
+    /** Exact decimal string from the stored chain or SQL value; preserve precision until display. */
+    redeemed_usdc: string;
+    /** Exact decimal string from the stored chain or SQL value; preserve precision until display. */
+    compressed_usdc: string;
+    last_event_at: string;
+};
+export type ComboLiveCount = {
+    /** Traded combos whose YES conjunction remains pending. */
+    count: number;
+    /** Time the count was computed; check its age before using it. */
+    computed_at: string;
+};
+export type ComboResponse = {
+    object: "combo";
+    data: ComboDetail;
+    meta: ResponseMeta;
+};
+/** Stored live combo count. Null means the first count is unavailable, never zero. */
+export type CombosSummary = {
+    live: ComboLiveCount | null;
+};
+export type CombosSummaryResponse = {
+    object: "combos_summary";
+    data: CombosSummary;
+    meta: ResponseMeta;
+};
+export type ComboTotals = {
+    fills: number;
+    /** Exact decimal string from the stored chain or SQL value; preserve precision until display. */
+    volume_usdc: string;
+    /** Exact decimal string from the stored chain or SQL value; preserve precision until display. */
+    largest_fill_usdc: string;
+    first_fill_at: string;
+    last_fill_at: string;
+    /** Last taker execution normalized to YES; not a current quote. */
+    last_fill_price_yes: string | null;
+    last_fill_outcome_index: number;
+    last_fill_action: "buy" | "sell";
+};
+export type ComboWindowStats = {
+    fills: number;
+    /** Exact decimal string from the stored chain or SQL value; preserve precision until display. */
+    volume_usdc: string;
+    distinct_traders: number;
+    /** Exact decimal string from the stored chain or SQL value; preserve precision until display. */
+    largest_fill_usdc: string;
+};
 export type ContentSearchResult = {
     /** Backend-owned stable editorial content identifier. */
     content_id: string;
@@ -538,7 +728,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[];
@@ -602,7 +792,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;
@@ -781,7 +971,7 @@ export type LargePosition = {
         username?: string;
         grade?: "S" | "A" | "B" | "C" | "D" | "F";
         win_rate?: number;
-        /** Trader lifetime realized P&L across all markets. */
+        /** The wallet's Total P&L in USD, the figure its 0xinsider profile shows: native Polymarket position P&L across all markets, fees included, plus credited maker and taker rebates. Distinct from this position's position_unrealized_pnl. Omitted when the wallet has no native accounting snapshot. */
         pnl?: number;
         markets_traded?: number;
     };
@@ -824,7 +1014,7 @@ export type LargeTrade = {
     suspicion_score: number | null;
     /** Persisted scorer track. Null when a legacy row has no stored track label. */
     suspicion_track: "whale" | "fresh_conviction" | "sliced_position" | null;
-    /** This fill's size relative to its market: size_usd divided by a market volume figure recorded at or after the trade, so the value always falls between 0 and 1 inclusive. A $10,000 fill is 0.00005 of a $200M market and 0.125 of an $80,000 one, which size_usd alone cannot distinguish. Absent when no volume figure recorded at or after the trade is available; never 0 as a stand-in and never capped at 1, because a denominator we cannot trust publishes nothing rather than a trimmed number. A market's volume keeps growing, so the same trade reports a smaller share as the market trades on. */
+    /** This fill's size relative to its market: its share count (size_usd / price) divided by the shares the market has traded, Polymarket's recorded volume, which counts shares rather than dollars, as observed at or after the trade, so the value always falls between 0 and 1 inclusive. A 20,000-share fill is 0.00005 of a market that has traded 400M shares and 0.125 of one that has traded 160,000, which size_usd alone cannot distinguish. Absent when no volume figure recorded at or after the trade is available, or when that figure is smaller than the fill; never 0 as a stand-in and never capped at 1, because a denominator we cannot trust publishes nothing rather than a trimmed number. A market's volume keeps growing, so the same trade reports a smaller share as the market trades on. */
     market_volume_share?: number;
     trader: {
         id: string;
@@ -885,7 +1075,7 @@ export type LeaderboardEntry = {
     /** 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;
-    /** All-time P&L in USD (total_pnl), including unrealized open positions. Kept for back-compat; prefer realized_pnl for the banked figure. */
+    /** Polymarket leaderboard all-time P&L in USD (traders.total_pnl), including 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. */
     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. Wallets without a native snapshot retain their historical stored realized P&L. Omitted when the native snapshot has no net realized value. */
     realized_pnl?: number;
@@ -1120,8 +1310,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: {
@@ -1211,8 +1403,39 @@ export type PickHolder = {
     /** 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;
 };
+/** 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;
@@ -1225,17 +1448,17 @@ export type PickOfTheDay = {
     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;
     /** 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. */
+    /** Frozen public presentation category. Tennis uses the provider-verified ATP or WTA tour, including Wimbledon and doubles; unknown tours retain Tennis. Every men's and women's cricket competition uses Cricket. Other sports use the curated league, esports title or soccer competition label, then the provider series name without its season year, then category when no competition is known. The canonical category and measured cohort are unchanged: an esports title still uses the pooled Esports category. 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;
@@ -1305,7 +1528,7 @@ export type PickOfTheDay = {
     sharp_pct?: number;
     /** Recorded market-implied probability as a 0..1 fraction when available. */
     market_pct?: number;
-    /** Optional recorded specialist facts. These describe the trader and do not disclose selection decisions. Present only on a full response when available. */
+    /** 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?: {
         /** Trader wallet address. */
         address: string;
@@ -1328,16 +1551,14 @@ export type PickOfTheDay = {
     };
     /** Public V1 S/A wallet count on the backed side, equal to sharp_wallet_count. */
     traders?: number;
-    /** Recorded backed-side sharp-money value in USD when available. */
+    /** 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 holder display projection. Historical rows retain their recorded display shape. */
+    /** Bounded S/A holder display projection. Newly certified picks include only publication-certified wallets; historical rows retain their recorded display shape. */
     holders?: PickHolder[];
-    /** Optional complete holder display roster. Each entry carries ordinary trader and recorded position facts. */
+    /** 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[];
     /** 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;
     /** Required truthful thesis. With at least one profitable-wallet holder: Profitable wallets hold {pick_outcome_label}[, led by a grade-{top_grade} trader]. Without holder backing: 0xInsider's Pick of the Day is {pick_outcome_label}. Wallet counts are not appended. */
     thesis?: string;
     /** Canonical web market URL. */
@@ -1352,10 +1573,17 @@ export type PickOfTheDay = {
     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[];
     /** 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. */
@@ -1364,11 +1592,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;
 };
@@ -1400,13 +1630,13 @@ 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 (07: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 picks publish from 03:00 America/New_York on pick_date. 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;
-    /** 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. */
+    category?: string;
+    /** Frozen public presentation category. Tennis uses the provider-verified ATP or WTA tour, including Wimbledon and doubles; unknown tours retain Tennis. Every men's and women's cricket competition uses Cricket. Other sports use the curated league, esports title or soccer competition label, then the provider series name without its season year, then category when no competition is known. The canonical category and measured cohort are unchanged: an esports title still uses the pooled Esports category. Optional for mixed-version client compatibility. */
     display_category?: string;
     /** Provider (Polymarket Gamma) market thumbnail URL (markets.image); omitted (not null) when the market has no image. Public regardless of the backed-side gate, so present for pending rows too. */
     image_url?: string;
@@ -1450,6 +1680,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. */
@@ -1632,7 +1866,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). */
@@ -1648,8 +1882,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. */
@@ -1663,7 +1895,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). */
@@ -1678,9 +1910,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. */
@@ -1696,6 +1928,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. */
@@ -1746,9 +2002,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;
@@ -1758,8 +2014,6 @@ export type PickSportsTeam = {
     score: string | null;
     /** Tennis player headshot URL, served same-origin. Present only for a tennis competitor the headshot resolver matched; absent for team sports and for unmatched players, where `logo` stays the fallback. */
     headshot?: string;
-    /** 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;
     /** Tennis tour this competitor belongs to. Present for every tennis entry whether or not `headshot` resolved, so a consumer can tell a tennis player with no photo from a non-tennis team. Absent for every other sport. Only `atp` and `wta` name a gender; the ITF World Tennis Tour runs men's and women's events and the provider does not say which, so `itf` means tennis with gender unknown. */
     tour?: "atp" | "wta" | "itf";
     /** Per-set score cells for this side, in set order. Backend-owned: render these rather than parsing `score`. Omitted entirely when the provider score is not a structured multi-set match or could not be parsed, so an absent array and an empty one carry the same meaning. */
@@ -1767,6 +2021,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;
+    /** 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;
@@ -1823,6 +2081,7 @@ export type Position = {
         grade?: "S" | "A" | "B" | "C" | "D" | "F";
         /** Percentage 0-100. */
         win_rate?: number;
+        /** The wallet's Total P&L in USD, the figure its 0xinsider profile shows: native Polymarket position P&L across all markets, fees included, plus credited maker and taker rebates (trader_trading_pnl.net_total_pnl). 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. */
         pnl?: number;
         markets?: number;
         wallet_age_days?: number;
@@ -1877,11 +2136,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;
 };
-/** Returned entry permission bound to the named market, token and outcome. Honor max_entry_price and expires_at, and check a current executable order book for the actual stake. This snapshot does not guarantee current liquidity, execution or positive expected value. */
+/** 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;
@@ -1889,13 +2149,14 @@ export type PotdEntryAuthorization = {
     category: string;
     /** Exact provider parent event ID, or provider event ID when no parent exists. */
     canonical_event_id: string;
-    /** Returned maximum entry price as an exact decimal string. Honor this bound; fees are excluded. This is not a 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;
-    /** Authorization expiry. An expired authorization cannot authorize a new automated entry. */
+    /** 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. */
@@ -2256,14 +2517,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;
@@ -2383,6 +2644,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;
@@ -2398,7 +2694,10 @@ export type Trader = {
     forecast_evidence?: number;
     rank?: number;
     pnl: {
+        /** Polymarket leaderboard all-time P&L in USD (traders.total_pnl), 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. */
         total?: number;
+        /** The profile's 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). The same figure the 0xinsider profile, search, live feed, portfolio and watchlist show. 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. */
+        net_total?: number;
         /** 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. */
         realized?: number;
         unrealized?: number;
@@ -2451,7 +2750,7 @@ export type Trader = {
     synced_at?: string;
     /** synced, unknown, or pending. */
     sync_status?: string;
-    /** Data age and coverage for this trader body. Always present. Its five groups are sync (traders.last_synced, covering pnl.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). 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 five groups are sync (traders.last_synced, covering pnl.total, 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). 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_quality: DataQuality;
     /** Field-level trust metadata. Present only when expand=trust or expand[]=trust is requested. */
     trust?: TraderTrust;
@@ -2680,7 +2979,7 @@ export type TraderGradeAt = {
         observed_at: string;
         /** Upper bound: a later snapshot confirmed the observation was committed. This is not an exact commit timestamp. */
         published_by: string;
-        /** Writer-proven model family, such as grading-v4. Null when unknown. */
+        /** Writer-proven model family, such as grading. Null when unknown. */
         model_version: string | null;
         /** Exact writer build SHA when recorded. Null on old and non-model observations. */
         model_build_sha: string | null;
@@ -2814,6 +3113,7 @@ export type TraderStatsExact = {
 export type TraderTrust = {
     total_pnl: TrustMetadata;
     realized_pnl: TrustMetadata;
+    net_total_pnl: TrustMetadata;
     unrealized_pnl: TrustMetadata;
     markets_traded: TrustMetadata;
     win_rate: TrustMetadata;
@@ -2858,6 +3158,7 @@ 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";
+    /** The wallet's all-time Total P&L in USD, the figure its 0xinsider profile shows: native Polymarket position P&L across all markets, fees included, plus credited maker and taker rebates (trader_trading_pnl.net_total_pnl). 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. */
     all_time_pnl_usd?: number;
     all_time_score?: number;
     last_synced?: string;
@@ -2924,11 +3225,11 @@ 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;
-            /** Requests Pro includes per UTC calendar month. */
+            /** Requests the account's plan includes per UTC calendar month: 500,000 for Pro, 2,000,000 for Max. */
             limit: number;
             remaining: number;
             /** Unix seconds: the first instant of the next UTC calendar month. */
@@ -2939,8 +3240,10 @@ export type Usage = {
             binding: boolean;
             /** Pay as you go is on: requests over the quota keep answering and bill on a monthly invoice, up to ceiling. */
             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. */
+            /** The most requests this account is admitted in a UTC calendar month once enforcement has begun: limit, or four times limit with pay as you go on (2,000,000 for Pro). 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;
@@ -3312,6 +3615,8 @@ export interface OperationData {
         scopes: string[] | null;
     };
     getApiDiscovery: ApiDiscovery;
+    getCombo: ComboDetail;
+    getCombosSummary: CombosSummary;
     getCoverage: Platforms;
     getDailyReportSnapshot: ReportSnapshot;
     getEventReplaySince: EventReplayEvent[];
@@ -3347,7 +3652,7 @@ export interface OperationData {
     getMarketIntel: MarketFlow;
     getMarketSnapshot: MarketSnapshot;
     getMonthlyReportSnapshot: ReportSnapshot;
-    getPickOfTheDay: PickOfTheDay;
+    getPickOfTheDay: PickOfTheDay | PickOfTheDayNoEntitledPicks;
     getPickOfTheDayArchive: PickOfTheDayArchive;
     getPickOfTheDayLedger: PickOfTheDayLedger;
     getPickOfTheDayLedgerEntry: PickOfTheDayLedgerEntry;
@@ -3429,11 +3734,11 @@ 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;
-            /** Requests Pro includes per UTC calendar month. */
+            /** Requests the account's plan includes per UTC calendar month: 500,000 for Pro, 2,000,000 for Max. */
             limit: number;
             remaining: number;
             /** Unix seconds: the first instant of the next UTC calendar month. */
@@ -3444,8 +3749,10 @@ export interface OperationData {
             binding: boolean;
             /** Pay as you go is on: requests over the quota keep answering and bill on a monthly invoice, up to ceiling. */
             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. */
+            /** The most requests this account is admitted in a UTC calendar month once enforcement has begun: limit, or four times limit with pay as you go on (2,000,000 for Pro). 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;
@@ -3502,6 +3809,7 @@ export interface OperationData {
         filters: WhaleDatasetFilters;
     };
     getWhaleTrade: LargeTradeDetail;
+    listComboFills: ComboFill[];
     listGames: Game[];
     listInsiderRadar: SuspiciousTrade[];
     listLargePositions: LargePosition[];
@@ -3668,6 +3976,8 @@ export interface OperationQuery {
     };
     getAccountIdentity: Record<string, never>;
     getApiDiscovery: Record<string, never>;
+    getCombo: Record<string, never>;
+    getCombosSummary: Record<string, never>;
     getCoverage: Record<string, never>;
     getDailyReportSnapshot: {
         /** UTC report date in YYYY-MM-DD format, from 2024-03-01 (the first day report data covers) through tomorrow UTC. Any other date returns 400 bad_request with error.param=date. */
@@ -3715,7 +4025,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: {
@@ -3822,6 +4132,30 @@ export interface OperationQuery {
     };
     getWhaleDatasetStatus: Record<string, never>;
     getWhaleTrade: Record<string, never>;
+    listComboFills: {
+        /** CSV of pending, won, or lost; all clears the filter. Unknown results appear only in unfiltered lists. */
+        result?: string;
+        /** CSV of 2, 3, 4, or 5+; all clears the filter. A combo matches any named pick count. */
+        legs?: string;
+        /** Minimum collateral in whole USDC. */
+        min_stake?: number;
+        /** 0 disables the filter; otherwise use 2..1000000. Minimum shares per dollar at execution. */
+        min_multiplier?: number;
+        /** CSV of S, A, B, C, D, F; all clears the filter. Ungraded wallets do not match. */
+        grades?: string;
+        /** CSV of nfl, ncaaf, nba, wnba, baseball, hockey, soccer, tennis, table-tennis, esports, mma, boxing, golf, cricket, f1, pickleball; all clears the filter. Matches when any leg belongs to a selected sport. */
+        sports?: string;
+        /** Recent is newest first; largest ranks collateral; payout ranks buy-fill shares and excludes sells. */
+        sort?: "recent" | "largest" | "payout";
+        /** Defaults to all for recent and 24h for largest or payout. */
+        window?: "24h" | "7d" | "all";
+        /** Page size. Integer values outside the range are clamped to 1..200. */
+        limit?: number;
+        /** Exclusive block_number:log_index cursor for recent only; send the returned next_cursor unchanged. */
+        cursor?: string;
+        /** Offset for ranked largest or payout ordering; use returned next_offset. */
+        offset?: number;
+    };
     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;
@@ -4191,6 +4525,11 @@ export interface OperationPath {
     exploreMarkets: Record<string, never>;
     getAccountIdentity: Record<string, never>;
     getApiDiscovery: Record<string, never>;
+    getCombo: {
+        /** Combo identifier: 0x followed by 62 lowercase hex characters. This differs from a binary market condition ID. */
+        condition_id: string;
+    };
+    getCombosSummary: Record<string, never>;
     getCoverage: Record<string, never>;
     getDailyReportSnapshot: Record<string, never>;
     getEventReplaySince: Record<string, never>;
@@ -4306,6 +4645,7 @@ export interface OperationPath {
         /** Raw whale_alerts.id or wt_-prefixed whale trade id. */
         id: string;
     };
+    listComboFills: Record<string, never>;
     listGames: Record<string, never>;
     listInsiderRadar: Record<string, never>;
     listLargePositions: Record<string, never>;
@@ -4423,6 +4763,8 @@ export interface OperationBody {
     exploreMarkets: never;
     getAccountIdentity: never;
     getApiDiscovery: never;
+    getCombo: never;
+    getCombosSummary: never;
     getCoverage: never;
     getDailyReportSnapshot: never;
     getEventReplaySince: never;
@@ -4461,6 +4803,7 @@ export interface OperationBody {
     getWeeklyReportSnapshot: never;
     getWhaleDatasetStatus: never;
     getWhaleTrade: never;
+    listComboFills: never;
     listGames: never;
     listInsiderRadar: never;
     listLargePositions: never;
@@ -4576,6 +4919,8 @@ export interface OperationResponse {
         data: OperationData["getApiDiscovery"];
         meta: ResponseMeta;
     };
+    getCombo: ComboResponse;
+    getCombosSummary: CombosSummaryResponse;
     getCoverage: {
         object: "platforms";
         data: OperationData["getCoverage"];
@@ -4762,6 +5107,7 @@ export interface OperationResponse {
         data: OperationData["getWhaleTrade"];
         meta: ResponseMeta;
     };
+    listComboFills: ComboFillsResponse;
     listGames: {
         object: "list";
         data: OperationData["listGames"];