@0xinsider/mcp 2.14.4 → 2.14.5

package/dist/sdk/schema.d.ts

@@ -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;
@@ -391,6 +581,7 @@ export type ExploreGroup = {
     category: string | null;
     /** Markets in the event cluster, ranked by volume with condition_id as the tie-breaker. The selected representative is retained within the 12-market cap. */
     markets: ExploreMarket[];
+    /** The volume of the group's highest-volume market, which is markets[0]: the same figure as that market's volume, Polymarket's cumulative taker volume in shares rather than cash. Null when unavailable. */
     rep_volume: number | null;
     /** Canonical key since #16304; rep_whales is its deprecated spelling, emitted beside it with the same value. */
     rep_large_trades: number | null;
@@ -412,6 +603,7 @@ export type ExploreMarket = {
     platform: "polymarket" | null;
     /** closed once Polymarket has closed trading or the market has resolved; active otherwise. The same rule labels a market on markets/search, markets/explore and market/{condition_id}/snapshot. */
     status: "active" | "closed";
+    /** Polymarket's traded-volume figure for the market, as last stored: cumulative taker volume in shares, each counted at its $1 settlement value, not the cash that changed hands (100 shares bought at $0.40 add 100, not 40). It can lag Polymarket's current figure. sort=volume orders by it. Null when unavailable. */
     volume: number | null;
     liquidity: number | null;
     /** Canonical key since #16304 (Polymarket's noun is large trade); whale_trade_count is its deprecated spelling, emitted beside it with the same value. */
@@ -672,7 +864,7 @@ export type GameMarketProviderPrices = GameMarketPricePaired | GameMarketPriceIn
 export type GamesCoverage = {
     /** Canonical sport buckets served, sorted. */
     sports: string[];
-    /** League tags served, sorted. */
+    /** League tags served, sorted. EuroLeague is euroleague under the Basketball sport bucket. */
     leagues: string[];
     /** Scopes whose source half was unavailable for this read, as <sport>:<half>. Empty means every scope answered. */
     sources_unavailable: string[];
@@ -781,7 +973,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 +1016,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 +1077,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's all-time leaderboard P&L in USD, from Polymarket's latest observation of this wallet on its all-time leaderboard (dated by the leaderboard_pnl data_quality group). Omitted when that leaderboard has no current observation ranking the wallet; 0xinsider requests one, and never serves an older stored figure in its place. Includes unrealized open positions. Kept for back-compat. Not the profile's Total P&L, which GET /api/v1/trader/{address} serves as pnl.net_total; the two can differ by a wide margin. Prefer realized_pnl for the banked figure. */
     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;
@@ -1109,9 +1301,13 @@ export type MarketSnapshot = {
     })[];
     liquidity: {
         source: string;
+        /** Polymarket's traded-volume figure for the market, as last stored: cumulative taker volume in shares, each counted at its $1 settlement value, not the cash that changed hands (100 shares bought at $0.40 add 100, not 40). It can lag Polymarket's current figure. The name ends in _usd because Polymarket prints this figure with a dollar sign; it is a share count. Null when unavailable. */
         volume_usd: number | null;
         liquidity_usd: number | null;
+        /** Polymarket's taker volume over the 24 hours before volume_24h_as_of, in shares, each counted at its $1 settlement value, not the cash that changed hands (100 shares bought at $0.40 add 100, not 40). The name ends in _usd because Polymarket prints volume with a dollar sign; it is a share count. Null when Polymarket does not report one: it omits the figure on closed markets and on open markets with no trades in the last 24 hours. */
         volume_24h_usd: number | null;
+        /** When 0xinsider read volume_24h_usd from Polymarket; the figure covers the 24 hours before this time. Null exactly when volume_24h_usd is null. */
+        volume_24h_as_of: string | null;
         /** Always null. Polymarket snapshot prices come from outcome top-of-book midpoints. */
         last_price: number | null;
     };
@@ -1264,7 +1460,7 @@ export type PickOfTheDay = {
     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";
@@ -1369,8 +1565,6 @@ export type PickOfTheDay = {
     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. */
@@ -1448,7 +1642,7 @@ export type PickOfTheDayArchiveEntry = {
     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. */
+    /** 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;
@@ -1891,8 +2085,9 @@ export type Position = {
         address: string;
         username?: string;
         grade?: "S" | "A" | "B" | "C" | "D" | "F";
-        /** Percentage 0-100. */
+        /** Win rate as a ratio from 0 to 1 (0.62 means 62%), the same scale as stats.win_rate on GET /api/v1/trader/{address}. Absent when unknown. */
         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;
@@ -1929,7 +2124,7 @@ export type PositionTimelineEvent = {
     id: string;
     /** ISO 8601 timestamp of the on-chain fill. */
     event_timestamp: string;
-    /** From the taker's perspective. */
+    /** The wallet's own side of this fill: buy or sell. */
     action: "buy" | "sell";
     outcome_side: "yes" | "no";
     /** The Polymarket CLOB token id (ERC1155 asset id, decimal string) for this outcome; null when unavailable (e.g. unsynced markets). */
@@ -1970,7 +2165,7 @@ export type PotdEntryAuthorization = {
     /** 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. */
+/** One ranked pre-game sports market where graded sharp money is piled on one side, with required-status category evidence from partial forward-observed Polymarket fills. */
 export type PreGameSide = {
     /** The side profitable wallets hold, as a provider-backed display label. Canonical spelling of piled_side (#16310), same value: when provider group context is unavailable it may remain a bare Yes/No/Over/Under, so do not use it alone as participant identity. */
     side: string | null;
@@ -2023,7 +2218,7 @@ export type PreGameSide = {
      * @deprecated
      */
     smart_score: number | null;
-    /** Market volume (USD). */
+    /** Polymarket's traded-volume figure for the market: cumulative taker volume in shares, the number Polymarket's market pages print with a dollar sign. Each share counts at its $1 settlement value, so this is not the cash that changed hands: 100 shares bought at $0.40 add 100, not 40. Null when unavailable. */
     volume: number | null;
     /** Aggregate recent flow direction on the market; null when unavailable. */
     net_side: "BUY" | "SELL" | null;
@@ -2046,7 +2241,7 @@ export type PreGameSide = {
     /** 1-based rank within the (min_grade-filtered) ranked result. */
     rank: number;
 };
-/** Shadow-only category evidence over the full uncapped piled-side S/A/B holder allocation. It never changes signal membership, ordering, routing, or sizing. */
+/** Category evidence over the full uncapped piled-side S/A/B holder allocation. It never changes signal membership, ordering, routing, or sizing. */
 export type PreGameSideCategorySkill = {
     status: "live" | "insufficient" | "stale" | "unknown" | "degraded";
     model_version: string;
@@ -2128,7 +2323,7 @@ export type PreGameSideObservation = {
      * @deprecated
      */
     smart_score: number;
-    /** Strictly positive stored market volume in USD. Missing, zero, or non-finite volume terminates as invalid_market and is never emitted as an observation. */
+    /** Strictly positive stored market volume: Polymarket's cumulative taker volume in shares, each counted at its $1 settlement value rather than the cash that changed hands (the same figure as volume on GET /api/v1/sports/pre-game-sides). Missing, zero, or non-finite volume terminates as invalid_market and is never emitted as an observation. */
     volume: number;
     /**
      * Recorded conviction score; higher values indicate stronger conviction.
@@ -2167,8 +2362,8 @@ export type PreGameSideSportFunnelReport = {
     board_upcoming_available: boolean;
     /** Why the upcoming-board source is (un)available. Board supply is one canonical-sport union: the bare category owns live truth and every configured composed league scope contributes upcoming rows; folded leagues without a configured board (currently NCAAB and CFL) are not in the upcoming union. available: every configured scope completed truthfully (a successful empty schedule still counts). capacity_limited: provider pagination or a configured upcoming cache published an intentionally bounded complete-event prefix; those rows are excluded from diagnostic-universe input and must not be treated as a complete upcoming universe. Cache-bound prefixes are limited to 3,000 rows or an exact 5,000,000-byte final envelope. source_unavailable: composition failed before a truthful union; resolved scope readers turn half failures into cold_unavailable, so fresh producers are whole-union identity reconciliation or a registry contract failure and carry zero rows. cold_unavailable: every scope completed but at least one reported its upcoming half unavailable because no servable entry was inside the stale-serve bound and the background warm did not land in time; it is not by itself proof of a provider outage. deadline_unavailable: an internal configured-scope deadline or the outer bounded fair wave expired. An internal deadline may retain healthy bare-category or sibling-scope rows; the outer wave records zero rows. These upcoming fields do not describe league live-membership availability. If the bare-category live scope fails, all live rows are dropped even when a league scope completed, because the bare category is the sole live-truth owner. not_configured: no upcoming scope applies to the sport. unknown: exactly one cause -- a snapshot cached before this field existed whose legacy flags recorded an unavailable-but-configured half without saying why. Every freshly computed snapshot reports a concrete status, and a legacy available or not-configured row is reconstructed exactly, so unknown self-clears within one TTL. board_upcoming_available is exactly board_upcoming_status == available. */
     board_upcoming_status: "unknown" | "not_configured" | "available" | "capacity_limited" | "source_unavailable" | "cold_unavailable" | "deadline_unavailable";
-    /** Configured upcoming scopes that did not complete as available. Values are category, a provider league tag slug (nfl, cfb, nba, wnba, nhl, mls, valorant, league-of-legends, counter-strike-2, or dota-2), registry when the compiled scope/projection contract drifted, union when cross-scope identity reconciliation failed, or wave when the outer fair-wave deadline expired before scope-level evidence returned. Empty means no unavailable upcoming scope was identified; this includes healthy/not-configured rows and a legacy cached row. Observation league scopes are upcoming-only and perform no live-membership read. */
-    board_upcoming_unavailable_scopes: ("category" | "nfl" | "cfb" | "nba" | "wnba" | "nhl" | "mls" | "valorant" | "league-of-legends" | "counter-strike-2" | "dota-2" | "registry" | "union" | "wave")[];
+    /** Configured upcoming scopes that did not complete as available. Values are category, a provider league tag slug (nfl, cfb, nba, wnba, euroleague-basketball, nhl, mls, valorant, league-of-legends, counter-strike-2, or dota-2), registry when the compiled scope/projection contract drifted, union when cross-scope identity reconciliation failed, or wave when the outer fair-wave deadline expired before scope-level evidence returned. Empty means no unavailable upcoming scope was identified; this includes healthy/not-configured rows and a legacy cached row. Observation league scopes are upcoming-only and perform no live-membership read. */
+    board_upcoming_unavailable_scopes: ("category" | "nfl" | "cfb" | "nba" | "wnba" | "euroleague-basketball" | "nhl" | "mls" | "valorant" | "league-of-legends" | "counter-strike-2" | "dota-2" | "registry" | "union" | "wave")[];
     /** Stored-universe rows plus provider-board rows missing from storage. */
     input: number;
     /** Sparse counts over the closed 25-value terminal vocabulary: outside_horizon, resolved, provider_closed, provider_excluded, invalid_market, missing_token, missing_stored_market, not_provider_live, board_source_unavailable, board_deadline_unavailable, primary_slate_candidate, zero_indexed_holder_research, capacity_limited, provider_unavailable, holder_deadline_unavailable, holder_computation_unavailable, holder_scan_incomplete, no_current_graded_holder, split_holder_pile, price_unavailable, wider_holder_emitted, in_play_emitted, in_play_stale_observed, in_play_directional_unavailable, or internal_unclassified. primary_slate_candidate means exact admission by the funded route's raw shared signals query before provider/holder enrichment; recent-flow rows rejected by its event, bucket, or total caps remain eligible for wider_holder measurement. capacity_limited is intentional bounded provider-work admission, is fully accounted here, and does not itself set degraded=true. board_source_unavailable means a completed board source was unavailable; board_deadline_unavailable means live-board work missed either an internal configured-scope deadline or the outer fair-wave deadline; provider_unavailable means an attempted holder-provider read failed; holder_deadline_unavailable means holder cache/provider work missed the absolute request deadline; holder_computation_unavailable means post-holder provider or DB-backed price/metadata evaluation was unavailable. */
@@ -2325,7 +2520,7 @@ export type ResponseMeta = {
     };
     /** SHA-256 of the funded signal membership/order/rank/cursor vector immediately before category-skill enrichment. Sports-edge-signals only. */
     category_skill_base_payload_hash?: string;
-    /** 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. */
+    /** Independent SHA-256 recomputation over the same base fields immediately after category-skill enrichment. Equality with category_skill_base_payload_hash proves category-skill enrichment did not change funded inputs. Sports-edge-signals only. */
     category_skill_enriched_base_payload_hash?: string;
 };
 /** 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. */
@@ -2505,7 +2700,10 @@ export type Trader = {
     forecast_evidence?: number;
     rank?: number;
     pnl: {
+        /** Polymarket's all-time leaderboard P&L in USD, from Polymarket's latest observation of this wallet on its all-time leaderboard (dated by the leaderboard_pnl data_quality group). Omitted when that leaderboard has no current observation ranking the wallet; 0xinsider requests one, and never serves an older stored figure in its place. Kept for provider parity and back-compat. Not the profile's Total P&L and not realized plus unrealized: it can differ from net_total by a wide margin. Read net_total for the figure the 0xinsider profile shows. */
         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;
@@ -2537,7 +2735,7 @@ export type Trader = {
     quant_metrics?: {
         /** 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. */
+        /** 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 largest loss on one settled market exceeds 30% of the capital the wallet deployed across all its positions, -10 if edge is inconsistent; result clamped to 0-100. Higher means easier to follow. null when insufficient history. */
         copy_score: number | null;
         /** Sharpe ratio over the trailing 30 days (risk-adjusted return; higher is better). Magnitude can be large for small samples. null when insufficient history. */
         sharpe_30d: number | null;
@@ -2558,7 +2756,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 six groups are sync (traders.last_synced, covering pnl.net_total, pnl.realized, stats.markets_traded, stats.win_rate, stats.daily_win_rate, last_active, synced_at and sync_status), ranking (trader_rankings.computed_at, covering grade, score, streak_tier, forecast_score and forecast_evidence), leaderboard_rank (leaderboard_rank_refresh_state.completed_at, the completion time of the latest fully completed global rank refresh, covering rank), volume (trader_usd_volume.observed_at, covering stats.total_volume) and positions (trader_position_snapshots.last_refreshed_at with traders.last_synced as fallback, covering pnl.unrealized, the open-position aggregate) and leaderboard_pnl (trader_profile_provider_snapshots.observed_at, covering pnl.total: unavailable when Polymarket's all-time leaderboard has no current observation ranking the wallet). The positions clock is the latest successful /positions snapshot when one exists, otherwise the last completed trader sync; it does not date closed or native accounting values. A rank or position value remains unknown or unavailable when its clock or value is absent. For an unknown wallet every group is unavailable. If the open-position read itself fails, positions is unavailable with a reason that says so, pnl.unrealized is absent, and the body is answered fresh (meta.cached false) and is not kept for later callers. */
     data_quality: DataQuality;
     /** Field-level trust metadata. Present only when expand=trust or expand[]=trust is requested. */
     trust?: TraderTrust;
@@ -2921,6 +3119,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;
@@ -2965,6 +3164,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;
@@ -3421,6 +3621,8 @@ export interface OperationData {
         scopes: string[] | null;
     };
     getApiDiscovery: ApiDiscovery;
+    getCombo: ComboDetail;
+    getCombosSummary: CombosSummary;
     getCoverage: Platforms;
     getDailyReportSnapshot: ReportSnapshot;
     getEventReplaySince: EventReplayEvent[];
@@ -3613,6 +3815,7 @@ export interface OperationData {
         filters: WhaleDatasetFilters;
     };
     getWhaleTrade: LargeTradeDetail;
+    listComboFills: ComboFill[];
     listGames: Game[];
     listInsiderRadar: SuspiciousTrade[];
     listLargePositions: LargePosition[];
@@ -3779,6 +3982,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. */
@@ -3933,10 +4138,34 @@ 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;
-        /** League tag, case-insensitive, as coverage.leagues spells it: nfl, epl, cs2. Omit for every league inside the selected sports. */
+        /** League tag, case-insensitive, as coverage.leagues spells it: nfl, epl, cs2, euroleague. EuroLeague games use sport=Basketball and league=euroleague. Omit for every league inside the selected sports. */
         league?: string;
         /** Keep only games in this state. A value outside the enum returns an empty page. */
         status?: "scheduled" | "live" | "paused" | "ended" | "postponed" | "cancelled" | "suspended" | "delayed" | "unknown";
@@ -4060,7 +4289,7 @@ export interface OperationQuery {
         min_size?: number;
         /** Exact match against provider-backed market_canonical.category. */
         category?: string;
-        /** Scope to one market. Accepts the raw provider condition_id or the mkt_-prefixed market id emitted by V1 responses. Combine with min_size=0 for every reconciled position in that market; an unknown id returns []. */
+        /** Scope to one market. Accepts the raw provider condition_id or the mkt_-prefixed market id emitted by V1 responses. Combine with min_size=0 for every reconciled position in that market; an unknown id or a resolved market returns []. */
         condition_id?: string;
         /** Scope to one wallet or a book of wallets (repeatable, up to 25 per request; comma-separated values inside one occurrence also work). Each value is a wallet address, a known username, or a trd_-prefixed trader id, resolved like /api/v1/trader/{address}. The response keeps the board's order and cursor, so pages of a book interleave wallets by current_value_usd. An address this API has never tracked returns its mirror rows or an empty list; a username or trader id that resolves to nothing is a 404 naming wallet; more than 25 values is a 400. min_size defaults to 0 when wallet is present. */
         wallet?: string[];
@@ -4302,6 +4531,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>;
@@ -4417,6 +4651,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>;
@@ -4534,6 +4769,8 @@ export interface OperationBody {
     exploreMarkets: never;
     getAccountIdentity: never;
     getApiDiscovery: never;
+    getCombo: never;
+    getCombosSummary: never;
     getCoverage: never;
     getDailyReportSnapshot: never;
     getEventReplaySince: never;
@@ -4572,6 +4809,7 @@ export interface OperationBody {
     getWeeklyReportSnapshot: never;
     getWhaleDatasetStatus: never;
     getWhaleTrade: never;
+    listComboFills: never;
     listGames: never;
     listInsiderRadar: never;
     listLargePositions: never;
@@ -4687,6 +4925,8 @@ export interface OperationResponse {
         data: OperationData["getApiDiscovery"];
         meta: ResponseMeta;
     };
+    getCombo: ComboResponse;
+    getCombosSummary: CombosSummaryResponse;
     getCoverage: {
         object: "platforms";
         data: OperationData["getCoverage"];
@@ -4873,6 +5113,7 @@ export interface OperationResponse {
         data: OperationData["getWhaleTrade"];
         meta: ResponseMeta;
     };
+    listComboFills: ComboFillsResponse;
     listGames: {
         object: "list";
         data: OperationData["listGames"];