@0xinsider/mcp 3.13.0 → 3.14.0

package/dist/sdk/schema.d.ts

@@ -1336,6 +1336,10 @@ export type GameFreshness = {
     scores_observed_at?: string;
     /** The provider's own frame clock. Omitted when the frame carries none. */
     scores_source_at?: string;
+    /** Seconds since this game's last Sports WebSocket frame. The esports feed resends an unchanged series about every 20 seconds, so this dates the feed's last frame, not the last score change. Omitted when no Sports WebSocket frame dates the score, which is not age zero: a score read from the provider's event listing is re-read on a cadence whether or not the game moved. */
+    scores_age_seconds?: number;
+    /** Whether this game's score and clock are current, judged on how often this league's feed sends a frame, and independent of source_freshness, which dates the board: a board can be seconds old while one game's frame is frozen. not_applicable outside play (scheduled, final, postponed, cancelled), at halftime and in a break between periods (a period of HT or End ...). stale when the last frame is older than the bound measured for its state: 180 seconds for a running soccer half before stoppage time (the provider sends a frame each match minute); 120 seconds for an in-progress cs2 or lol series (the feed resends each running series about every 20 seconds, so fresh means the provider resent it, not that the map score moved); 600 seconds for a running period of men's and women's college basketball (league cbb, cwbb) and NHL hockey (nhl), whose feeds send no frame while the clock is stopped for a timeout or review. fresh within the bound. unknown otherwise: no dated frame, soccer stoppage time, a period clock at 00:00, End OT in women's college basketball (the end of the third quarter, after which the provider sends no frame until the final), tennis (frames land on points and stop for changeovers and breaks), and every league with no measured bound, including the NBA and NFL. */
+    scores_freshness: "fresh" | "stale" | "unknown" | "not_applicable";
 };
 /** One market of a game holders batch: GET /api/v1/market/{condition_id}/holders unfiltered and cut to the batch limit. */
 export type GameHoldersItem = {
@@ -1379,6 +1383,21 @@ export type GameMarket = {
     prices?: GameMarketPrices;
     /** Polymarket's reported liquidity for this market. Omitted when the provider read carried none, and on a finished game read from its stored record; never 0 in place of a missing figure. */
     liquidity?: GameMarketLiquidity;
+    /** How Polymarket's oracle settled or is settling this market, the block GET /api/v1/games/{event_slug}/markets serves, from the same per-game store. Always present on GET /api/v1/games/{event_slug}; on GET /api/v1/games only with expand=settlement. It never waits for Polymarket: a game not read lately reads status unavailable while its read starts. */
+    settlement?: {
+        expected_settlement_time: string | null;
+        observed_at: string | null;
+        oracle_status: string | null;
+        payouts: number[] | null;
+        proposed_answer: "outcome_0" | "outcome_1" | "split" | "too_early" | null;
+        resolved_at: string | null;
+        result: "outcome" | "split" | null;
+        settled: boolean | null;
+        settlement_time_basis: string | null;
+        status: "observed" | "not_posed" | "unavailable";
+        was_disputed: boolean | null;
+        winning_outcome_index: number | null;
+    };
 };
 /** One market's liquidity as Polymarket reports it (Gamma liquidityNum), verbatim. Polymarket documents it only as reported market liquidity, with no unit. It describes the market's resting order book, not traded volume. */
 export type GameMarketLiquidity = {
@@ -2260,6 +2279,21 @@ export type MarketSnapshot = {
     };
     /** Price and spread trust metadata. Present only when expand=trust or expand[]=trust is requested. */
     trust?: MarketSnapshotTrust;
+    /** How Polymarket's oracle settled or is settling this market, the block GET /api/v1/games/{event_slug}/markets serves, read from the store of the market's event (a child event's market: its game's). It never waits for Polymarket: with nothing stored it reads status unavailable while the read starts. market.market_result stays null; read settlement.result. */
+    settlement: {
+        expected_settlement_time: string | null;
+        observed_at: string | null;
+        oracle_status: string | null;
+        payouts: number[] | null;
+        proposed_answer: "outcome_0" | "outcome_1" | "split" | "too_early" | null;
+        resolved_at: string | null;
+        result: "outcome" | "split" | null;
+        settled: boolean | null;
+        settlement_time_basis: string | null;
+        status: "observed" | "not_posed" | "unavailable";
+        was_disputed: boolean | null;
+        winning_outcome_index: number | null;
+    };
 };
 export type MarketSnapshotFreshness = {
     status: "fresh" | "stale" | "available" | "not_live" | "unavailable";
@@ -6298,11 +6332,21 @@ export interface OperationData {
         line?: number;
         line_outcome_index?: number;
         negative_risk?: boolean;
-        outcomes: {
+        outcomes: ({
             index: number;
             label?: string;
             token_id?: string;
-        }[];
+            quote?: {
+                best_ask: number | null;
+                best_bid: number | null;
+                book_observed_at: string | null;
+                price: number | null;
+                price_basis: "midpoint" | "last_trade" | null;
+                price_observed_at: string | null;
+                status: "observed" | "no_orderbook" | "unavailable";
+                book_unavailable_reason: "cache_miss" | "stream_capacity" | "no_orderbook" | "missing_provider_token_id" | null;
+            };
+        })[];
         platform?: string;
         slug?: string;
         sports_market_type?: string;
@@ -6322,6 +6366,42 @@ export interface OperationData {
             status: "computed" | "not_computed" | "unavailable";
             trader_count: number | null;
         };
+        settlement: {
+            expected_settlement_time: string | null;
+            observed_at: string | null;
+            oracle_status: string | null;
+            payouts: number[] | null;
+            proposed_answer: "split" | "too_early" | "outcome_0" | "outcome_1" | null;
+            resolved_at: string | null;
+            result: "outcome" | "split" | null;
+            settled: boolean | null;
+            settlement_time_basis: string | null;
+            status: "observed" | "not_posed" | "unavailable";
+            was_disputed: boolean | null;
+            winning_outcome_index: number | null;
+        };
+        trading_terms?: {
+            fee_schedule: {
+                exponent: number | null;
+                rate: number | null;
+                rebate_rate: number | null;
+                taker_only: boolean | null;
+            } | null;
+            fees_enabled: boolean | null;
+            observed_at: string | null;
+            reward_allocations: ({
+                end_date: string | null;
+                rewards_amount: number | null;
+                rewards_daily_rate: number | null;
+                start_date: string | null;
+            })[] | null;
+            rewards_max_spread: number | null;
+            rewards_min_size: number | null;
+            seconds_delay: number | null;
+            status: "observed" | "not_listed" | "unavailable";
+            tick_size: number | null;
+            min_order_size_shares: number | null;
+        };
     })[];
     listGames: Game[];
     listGameTrades: GameTrade[];
@@ -6539,7 +6619,7 @@ export interface OperationQuery {
         series_slugs?: string[];
     };
     getEventReplaySince: {
-        /** Opaque event replay cursor returned as next_cursor by a prior response. The cursor maps to the global (whale_alerts.inserted_xid, whale_alerts.id) commit-order position, is valid across backend replicas, and is bound to the filter set the walk ran with (trader, condition_id, min_grade, min_size): presenting it under different filters answers 400 bad_request with error.reason cursor_expired, and the walk restarts without a cursor. Cursors issued before 2026-09-22 (id-only) stay accepted and are bound to no filters. Omit to fetch the latest durable public suffix. */
+        /** Opaque event replay cursor returned as next_cursor by a prior response. The cursor maps to the global (whale_alerts.inserted_xid, whale_alerts.id) commit-order position, is valid across backend replicas, and is bound to every filter the walk ran with (trader, condition_id, min_grade, min_grade_at_trade, min_size; expand is not a filter): presenting it under different filters, including a switch between min_grade and min_grade_at_trade, answers 400 bad_request with error.reason cursor_expired, and the walk restarts without a cursor. Cursors issued before 2026-09-22 (id-only) stay accepted and are bound to no filters. Omit to fetch the latest durable public suffix. */
         cursor?: string;
         /** Maximum durable public whale-trade events to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
@@ -6776,15 +6856,15 @@ export interface OperationQuery {
         limit?: number;
         /** Opaque gmk_v1_ cursor from next_cursor, sent with the same filters. It pins the page position (sports_market_type, line, condition_id), not a snapshot. A cursor this endpoint did not issue returns 400 with error.param=cursor. */
         cursor?: string;
-        /** sharp_money adds each row's sharp_money: the game page's per-line split, side USD and S, A and B wallet counts per outcome. One read for the event whatever the page size; the request costs 5 instead of 2. Pro and Max. Repeatable: sharp_money. */
-        expand?: "sharp_money"[];
-        /** Backward-compatible alias for expand. Repeatable: sharp_money. */
-        "expand[]"?: "sharp_money"[];
+        /** sharp_money adds each row's sharp_money: the game page's per-line split, side USD and S, A and B wallet counts per outcome. One read for the event whatever the page size; the request costs 5 instead of 2. Pro and Max. quotes adds each outcome's quote: the cached display price and best bid and ask, each with its observation time, in one cache read for the page; it adds 1 to the cost, on every plan. trading_terms adds each row's fee schedule, reward settings and allocations, order delay, tick and minimum order size in shares from its Gamma record, with the read's time; it adds 1 to the cost, on every plan. Repeatable: sharp_money, quotes, trading_terms. */
+        expand?: ("sharp_money" | "quotes" | "trading_terms")[];
+        /** Backward-compatible alias for expand. Repeatable: sharp_money, quotes, trading_terms. */
+        "expand[]"?: ("sharp_money" | "quotes" | "trading_terms")[];
     };
     listGames: {
         /** Canonical sport bucket, case-insensitive, with - and _ read as a space: table-tennis and Table Tennis are the same bucket. Omit for every covered sport. A bucket this deployment does not serve returns an empty page. */
         sport?: string;
-        /** League tag, case-insensitive, as coverage.leagues spells it: nfl, epl, cs2, euroleague, cbb, cwbb. EuroLeague games use sport=Basketball and league=euroleague; NCAA men's and women's college basketball games use sport=Basketball with league=cbb and league=cwbb. Omit for every league inside the selected sports. */
+        /** League tag, case-insensitive, as this list's coverage.leagues spells it (GET /api/v1/coverage lists no leagues): nfl, epl, cs2, euroleague, cbb, cwbb. EuroLeague games use sport=Basketball and league=euroleague; NCAA men's and women's college basketball games use sport=Basketball with league=cbb and league=cwbb. Omit for every league inside the selected sports. */
         league?: string;
         /** Keep only games in this state. ended, cancelled and postponed also list finished games that have left the live board, read from their stored records, for kickoffs within starts_after..starts_before (default: the 7 days before now). Without status, or with any other state, the list is the live and upcoming board. A value outside the enum returns an empty page. */
         status?: "scheduled" | "live" | "paused" | "ended" | "postponed" | "cancelled" | "suspended" | "delayed" | "unknown";
@@ -6798,10 +6878,10 @@ export interface OperationQuery {
         limit?: number;
         /** Opaque gms_v1_ cursor from next_cursor. It pins the page position (kickoff and event_slug), not a snapshot: the catalog is live, so a game added or removed between pages moves with it. With a finished status, a page that spent its read budget carries a cursor past everything it read, which may be past the last game it returned. A cursor this endpoint did not issue returns 400 with error.param=cursor. */
         cursor?: string;
-        /** Backward-compatible alias for expand. Repeatable: sharp_money. */
-        "expand[]"?: "sharp_money"[];
-        /** sharp_money adds each game's sharp_money, the GameSharpMoney object GET /api/v1/games/{event_slug}/sharp-money returns, read from the sport board's cached aggregate: one board read per sport on the page, never a per-game compute. A game the board did not evaluate carries status not_computed (read the per-game route for it); a sport whose aggregate could not be read carries status unavailable while the rest of the page is served. Adds 3 to the request cost. Repeatable. */
-        expand?: "sharp_money"[];
+        /** Backward-compatible alias for expand. Repeatable: sharp_money, settlement. */
+        "expand[]"?: ("sharp_money" | "settlement")[];
+        /** sharp_money adds each game's sharp_money, the GameSharpMoney object GET /api/v1/games/{event_slug}/sharp-money returns, read from the sport board's cached aggregate: one board read per sport on the page, never a per-game compute. A game the board did not evaluate carries status not_computed (read the per-game route for it); a sport whose aggregate could not be read carries status unavailable while the rest of the page is served. Pro and Max only; adds 3 to the request cost. settlement adds settlement to each winner market, the GameMarketSettlement block GET /api/v1/games/{event_slug}/markets serves, from the same per-game store. It never waits for Polymarket: a game not read lately carries status unavailable and its read starts, so a read a moment later may answer. Every plan; adds 2 to the request cost. Repeatable; the two combine. */
+        expand?: ("sharp_money" | "settlement")[];
     };
     listGameTrades: {
         /** Newest fills to return. Out-of-range values are clamped to 1..200. */