@0xinsider/sdk 0.40.0 → 0.42.0

package/dist/schema.d.ts

@@ -123,6 +123,14 @@ export type BatchGameHoldersItem = {
     data?: GameHoldersItem;
     error?: ApiErrorBody;
 };
+export type BatchMarketCloseItem = {
+    /** Zero-based request index. Duplicate inputs keep separate result rows. */
+    index: number;
+    input: string;
+    status: "ok" | "error";
+    data?: MarketClose;
+    error?: ApiErrorBody;
+};
 export type BatchMarketFlowItem = {
     /** Zero-based request index. Duplicate inputs keep separate result rows. */
     index: number;
@@ -489,6 +497,7 @@ export type CreateWebhookRequest = {
     url: string;
     event_types: WebhookEventType[];
     trade_filters?: LargeTradeSubscriptionFilters;
+    price_move_filters?: PriceMoveSubscriptionFilters;
 };
 export type CreateWebhookVerificationAttemptRequest = {
     /** The original one-time token returned by webhook creation or a URL change. Sent only in the request body and signed receiver challenge. */
@@ -1276,7 +1285,7 @@ export type Game = {
     /** Kickoff in UTC, as the provider supplied it. Omitted when the provider published none; coverage.schedule then reads unavailable. */
     scheduled_at?: string;
     status: GameStatus;
-    /** Both sides, in the provider's own order. For a team league the provider lists the home side first. Empty when the provider identified neither side. */
+    /** Both sides, in the provider's own order. That order states no home or away: Polymarket lists the away team first in US leagues and the home team first in soccer. Read a market's side for home and away. Empty when the provider identified neither side. */
     competitors: GameCompetitor[];
     /** The esports series length, for example Bo3. Omitted for everything else. */
     series_format?: string;
@@ -1296,7 +1305,7 @@ export type Game = {
 };
 /** One side of the game. */
 export type GameCompetitor = {
-    /** The competitor's name as the provider gives it. */
+    /** The team as its moneyline outcome names it, the same before, during and after the game (Jaguars, Penn). Where no outcome names the team, for example a soccer game's Yes/No win markets, the provider's full name (FC Bayern München). To identify a team, prefer provider_id. */
     name: string;
     /** The provider's league-scoped competitor id, as a string. Omitted when the provider has not identified this side; coverage.competitors then reads labels. */
     provider_id?: string;
@@ -1371,7 +1380,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. 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. */
+    /** Which side of the game this market's YES leg pays. home and away are the provider's own home/away designation of the team the YES leg names (Polymarket's teams[].ordering), never its place in competitors. 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 or the provider designates neither team home or away, 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;
@@ -1485,7 +1494,8 @@ export type GameSharpMoney = {
         is_leader: boolean;
         label: string;
         pct: number;
-        side: "home" | "draw" | "away";
+        /** The side the provider designates this outcome's team: home or away, by Polymarket's own home/away designation (teams[].ordering), never the outcome's place in this list; draw for a 1X2 draw. null when the provider designates neither team home or away; never inferred from order. */
+        side: "home" | "draw" | "away" | null;
         usd: number;
         wallets: {
             a: number;
@@ -1799,6 +1809,23 @@ export type LargeTrade = {
         /** Provider-backed market_canonical category. */
         category?: string;
     };
+    /** Closing line value against the market's stored close (GET /api/v1/market/{condition_id}/close). Always present; status says whether it is measured. */
+    clv: {
+        /** The CLV definition, clv@v1. */
+        basis_version: string;
+        /** The anchor pre_kickoff was judged against: the stored close's anchor, else the market's kickoff. */
+        close_anchor_at: string | null;
+        /** The traded outcome's closing price, 0 to 1, whenever a usable close is stored and the outcome is known, in play included. */
+        close_price: number | null;
+        /** Cents per share, positive when the trade beat the close: buy is (close_price - price) * 100, sell is (price - close_price) * 100. Gross of fees. Computed from the trade's exact stored price; price on the wire is rounded to 4 places, so a recomputation from it agrees within 0.005 cents. Set exactly when status is measured. */
+        clv_cents: number | null;
+        /** Whether the trade filled before close_anchor_at. null when the market has no anchor. */
+        pre_kickoff: boolean | null;
+        /** measured: clv_cents is set. in_play: traded at or after the close anchor (kickoff), no CLV is defined. pending: traded before kickoff and the market's close is not stored yet. unavailable: see unavailable_reason. */
+        status: "measured" | "in_play" | "pending" | "unavailable";
+        /** Set exactly when status is unavailable. The market's reasons (see MarketClose.unavailable_reason), plus anchor_stale (the kickoff moved after the close was captured) and outcome_unknown (the traded outcome is not known for this trade). */
+        unavailable_reason: "no_observation_in_lookback" | "provider_empty_window" | "provider_invalid_contract" | "capture_window_closed" | "no_game_start_time" | "not_one_sided_resolution" | "not_captured" | "close_token_mismatch" | "anchor_stale" | "outcome_unknown" | null;
+    };
 };
 export type LargeTradeDetail = LargeTrade & {
     counterparty_analysis: CounterpartyAnalysis;
@@ -2017,6 +2044,48 @@ export type MarketCandles = {
     /** One entry per present provider token (YES first, then NO); empty when no tokens have been fetched yet. */
     outcomes: OutcomeCandles[];
 };
+/** A market's stored closing line (#32517): Polymarket's price-history value for the last minute bucket ending at or before kickoff, read once after settlement and never recomputed. */
+export type MarketClose = {
+    /** true when game_start_time has moved more than lookback_seconds from close_anchor_at since capture; large trades on the market then carry no CLV. null without a stored row. */
+    anchor_stale: boolean | null;
+    /** Provider response contract version the value was read under. */
+    basis_version: string | null;
+    /** When the close was stored. Bookkeeping only. */
+    captured_at: string | null;
+    /** The instant the close was measured at: the kickoff when it was captured. Write-once; null when no close row is stored. */
+    close_anchor_at: string | null;
+    /** The field that supplied close_anchor_at, markets.game_start_time. */
+    close_anchor_source: string | null;
+    /** Polymarket condition id. */
+    condition_id: string;
+    /** The market's kickoff as stored now. */
+    game_start_time: string | null;
+    /** How far before the anchor the admitted bucket may start: 21600 (6 hours). */
+    lookback_seconds: number | null;
+    /** Bucket width: 60 (minute grain) or 3600 (hour grain, for a market read more than about six days after kickoff). */
+    observation_window_seconds: number | null;
+    /** Start of the provider bucket the close is. The bucket ends at observed_at + observation_window_seconds, at or before close_anchor_at. */
+    observed_at: string | null;
+    /** YES then NO when status is measured; empty otherwise. */
+    outcomes: ({
+        /** Closing price, 0 to 1, at full stored precision. */
+        close_price: number;
+        /** true on the NO leg: 1 minus the stored YES price, never a second read. */
+        derived_from_yes: boolean;
+        /** The outcome's label. */
+        outcome: string | null;
+        /** 0 is the YES leg, 1 the NO leg. */
+        outcome_index: number;
+        /** CLOB token id of the outcome. */
+        token_id: string | null;
+    })[];
+    /** Provider endpoint and grain, e.g. polymarket_data_v2_prices_history@minute-window-v1. */
+    price_source: string | null;
+    /** measured: outcomes carries the close. pending: no close is stored yet and the capture will still read the market. unavailable: no close will be served; see unavailable_reason. */
+    status: "measured" | "pending" | "unavailable";
+    /** Set exactly when status is unavailable. no_observation_in_lookback, provider_empty_window, provider_invalid_contract and capture_window_closed are the capture's own stored refusals; no_game_start_time: the market has no kickoff time; not_one_sided_resolution: it resolved to neither side; not_captured: the capture does not read it (no tracked buy before resolution, or kickoff over 30 days ago); close_token_mismatch: the close was read on a different YES token than the market carries now. */
+    unavailable_reason: "no_observation_in_lookback" | "provider_empty_window" | "provider_invalid_contract" | "capture_window_closed" | "no_game_start_time" | "not_one_sided_resolution" | "not_captured" | "close_token_mismatch" | "anchor_stale" | "outcome_unknown" | null;
+};
 export type MarketFlow = {
     market: {
         id: string;
@@ -2198,6 +2267,62 @@ export type MarketHoldersTotals = {
     /** no_usd split by grade: where the S, A and B money on NO sits. */
     no_grade_usd: MarketHoldersSideGradeUsd;
 };
+/** `market_price_moved` data, also the MarketPriceMoved frame on GET /api/v1/stream: a sports or esports market's outcome-0 midpoint moved a whole-cent level over one window. Prices are decimal strings at full precision. A missing value is null with its *_unavailable_reason. */
+export type MarketPriceMovedData = {
+    best_ask: string;
+    best_bid: string;
+    concurrent_sharp_flow: {
+        detected: boolean;
+        grade_floor: "S" | "A" | "B" | "C" | "D" | "F";
+        net_flow_usd: number;
+        ranked_large_trades: number;
+        /** Large trades on the market in the same window at any grade, ungraded wallets included. ranked_large_trades is the part of them at grade_floor or better. */
+        large_trades_in_window: number | null;
+    } | null;
+    concurrent_sharp_flow_unavailable_reason: "read_failed" | null;
+    condition_id: string;
+    detected_at: string;
+    direction: "up" | "down";
+    event_slug: string | null;
+    from_price: string;
+    game_state: {
+        clock: string | null;
+        ended: boolean;
+        live: boolean | null;
+        period: string | null;
+        scores: LiveSportsScoreEntry[];
+        status: string | null;
+        updated_at: string;
+    } | null;
+    game_state_unavailable_reason: "no_event_slug" | "no_game_state" | "read_failed" | null;
+    gap_before: boolean;
+    label: string | null;
+    league: string | null;
+    level_cents: number;
+    market_slug: string | null;
+    move_cents: string;
+    observed_at: string | null;
+    outcome_index: number;
+    /** Where the game stood at detected_at. in_play: its live state reports it live. pre_game: its live state is neither live nor ended, or it has no live state yet and the market's scheduled start (the games endpoints' scheduled_at) is after detected_at. unknown: neither holds or the live state could not be read; game_state_unavailable_reason says why. */
+    phase: "pre_game" | "in_play" | "unknown";
+    previous_level_cents: number;
+    source: string;
+    spread_cents: string;
+    to_price: string;
+    window_seconds: number;
+    window_start: string;
+    /** Why book_depth_within_2c is null, and null when it is present. no_book: no full order book has arrived for the market since tracking began, only quotes. book_changed: the best bid or ask moved after the latest full book, so its depth belongs to another top. band_not_covered: the latest full book shows no level beyond 2 cents from the midpoint on at least one side, so that side's sum could be cut short. */
+    book_depth_unavailable_reason: "no_book" | "book_changed" | "band_not_covered" | null;
+    /** USD resting within 2 cents of outcome 0's midpoint on each side at detected_at, or null with book_depth_unavailable_reason. */
+    book_depth_within_2c: {
+        /** USD resting on asks priced at or below the midpoint plus 0.02 (price times size), as a decimal string. */
+        ask_usd: string;
+        /** USD resting on bids priced at or above the midpoint minus 0.02 (price times size), as a decimal string. */
+        bid_usd: string;
+        /** When we received the full order book the sums come from. Its best bid and ask are the event's best_bid and best_ask; deeper levels may have changed since. */
+        book_observed_at: string;
+    } | null;
+};
 export type MarketSearchResult = {
     id: string;
     condition_id: string;
@@ -2265,7 +2390,7 @@ 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. 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 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. A score entry's side (home or away) is the provider's home/away designation of that team, omitted when the provider gives none; the order of scores states no side. 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;
         };
@@ -3056,8 +3181,6 @@ export type PickOfTheDayLedgerOpenedEntry = {
     supersedes_pick_id: string | null;
     /** Explicit proof provenance: 1 retains historic eight-field canonical JSON; 2 binds stable pick_id and version without pick_rank. */
     commitment_version: 1 | 2;
-    /** How the pick was chosen: auto by the selection algorithm, manual by an operator (102 published picks from 2026-06-23 to 2026-10-15; none since). Outside the hashed payload, so it moves no commitment. */
-    selected_by: "auto" | "manual";
 };
 /** 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 = {
@@ -3090,8 +3213,6 @@ export type PickOfTheDayLedgerSealedEntry = {
     supersedes_pick_id: string | null;
     /** Explicit proof provenance: 1 retains historic eight-field canonical JSON; 2 binds stable pick_id and version without pick_rank. */
     commitment_version: 1 | 2;
-    /** How the pick was chosen: auto by the selection algorithm, manual by an operator (102 published picks from 2026-06-23 to 2026-10-15; none since). Outside the hashed payload, so it moves no commitment. */
-    selected_by: "auto" | "manual";
 };
 /** 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 = {
@@ -3130,8 +3251,6 @@ export type PickOfTheDayLedgerUncommittedEntry = {
      * @deprecated
      */
     supersedes_pick_id: string | null;
-    /** How the pick was chosen: auto by the selection algorithm, manual by an operator (102 published picks from 2026-06-23 to 2026-10-15; none since). Outside the hashed payload, so it moves no commitment. */
-    selected_by: "auto" | "manual";
 };
 /** 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 = {
@@ -3556,37 +3675,6 @@ export type PickOfTheDayStats = {
         pick_id: string;
         pick_rank: number;
     }[];
-    selections: {
-        canonical_category?: string;
-        clv_avg_display?: string;
-        clv_avg_pct?: number;
-        clv_avg_pp?: number;
-        clv_avg_pp_display?: string;
-        clv_measured: number;
-        edge_display?: string;
-        edge_pp?: number;
-        key: string;
-        label: string;
-        losses: number;
-        net_profit_display?: string;
-        net_profit_usd?: number;
-        pending: number;
-        picks: number;
-        priced_decided: number;
-        priced_in_display?: string;
-        priced_in_pct?: number;
-        roi_display?: string;
-        roi_pct?: number;
-        settled: number;
-        small_sample: boolean;
-        staked_usd: number;
-        unit_score?: number;
-        unit_score_display?: string;
-        void: number;
-        win_rate_display?: string;
-        win_rate_pct?: number;
-        wins: number;
-    }[];
 };
 /** The stats with `view=summary` or `sections`: only the named sections, listed in `sections`. `view=summary` names every section except `series`, `days`, `categories`, `months` and `voids`. */
 export type PickOfTheDayStatsSections = {
@@ -4027,37 +4115,6 @@ export type PickOfTheDayStatsSections = {
         pick_id: string;
         pick_rank: number;
     }[];
-    selections?: {
-        canonical_category?: string;
-        clv_avg_display?: string;
-        clv_avg_pct?: number;
-        clv_avg_pp?: number;
-        clv_avg_pp_display?: string;
-        clv_measured: number;
-        edge_display?: string;
-        edge_pp?: number;
-        key: string;
-        label: string;
-        losses: number;
-        net_profit_display?: string;
-        net_profit_usd?: number;
-        pending: number;
-        picks: number;
-        priced_decided: number;
-        priced_in_display?: string;
-        priced_in_pct?: number;
-        roi_display?: string;
-        roi_pct?: number;
-        settled: number;
-        small_sample: boolean;
-        staked_usd: number;
-        unit_score?: number;
-        unit_score_display?: string;
-        void: number;
-        win_rate_display?: string;
-        win_rate_pct?: number;
-        wins: number;
-    }[];
 };
 /** 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 = {
@@ -4302,6 +4359,25 @@ export type PotdEntryAuthorization = {
     /** Authorization expiry timestamp. Existing grants do not extend; an expired authorization cannot authorize a new automated entry. */
     expires_at: string;
 };
+/** Settings for market_price_moved: required when event_types includes it, refused (400) when it does not. A PATCH without it keeps the stored settings; removing the event clears them. A subscription receives at most one delivery per market per window: the one level step whose (previous_level_cents, level_cents] holds min_move_cents. */
+export type PriceMoveSubscriptionFilters = {
+    /** Move threshold in whole cents of outcome 0's midpoint. */
+    min_move_cents: number;
+    /** The window the move is measured over. */
+    window_seconds: 60 | 120 | 300 | 900;
+    /** One market only. Raw or mkt_-prefixed. */
+    condition_id?: string;
+    /** One Polymarket event (game) only. */
+    event_slug?: string;
+    /** Event slug league prefixes such as nba or epl, matched case-insensitively; any one matches. */
+    league?: string[];
+    /** Game phase when the move was detected. any includes unknown. */
+    phase: "any" | "pre_game" | "in_play";
+    /** Deliver only moves with concurrent_sharp_flow.detected true. */
+    require_concurrent_sharp_flow: boolean;
+    /** Deliver only moves whose book_depth_within_2c is known and holds at least this many USD on each side. A move with book_depth_within_2c null does not match. */
+    min_book_usd_within_2c?: number;
+};
 /** One PUBLISHED same-day pick whose holder proof is not readable yet: its stable slot rank, the release and kickoff instants, and the instant before which a retry cannot succeed. Every item in `picks` carries its full required shape, so a pick that cannot meet it is listed here instead of being served with missing fields or a synthetic zero. */
 export type ProofPendingPickSlot = {
     /**
@@ -4969,6 +5045,53 @@ export type TraderCategoryRecords = {
     /** One entry per canonical category with at least one decided market, ordered by decided descending then category. A category with no decided market is omitted. The Esports entry carries its per-game records in games. */
     records: TraderCategoryRecord[];
 };
+/** Closing line value over one wallet's large trades in a window (#32517). */
+export type TraderClv = {
+    /** Wallet address, lowercase. */
+    address: string;
+    /** The CLV definition, clv@v1, each trade's clv.basis_version. */
+    basis_version: string;
+    /** The category filter as sent, or null. */
+    category: string | null;
+    /** The window's trades that carry no CLV, by clv.status. */
+    excluded: {
+        in_play: number;
+        pending: number;
+        unavailable: number;
+    };
+    /** Window start, inclusive. */
+    from: string;
+    /** trd_-prefixed trader id. */
+    id: string;
+    /** Large trades in the window, every status. */
+    large_trades: number;
+    /** Figures over the trades whose clv.status is measured. */
+    measured: {
+        /** Normal 95% interval on market_mean_clv_cents from the markets' sample deviation, as low and high. null below two markets. */
+        market_ci95_cents: {
+            high: number;
+            low: number;
+        } | null;
+        /** Mean over markets of each market's mean clv_cents. null with no measured trade. */
+        market_mean_clv_cents: number | null;
+        /** Distinct markets among them. */
+        markets: number;
+        /** Plain mean of clv_cents. null with no measured trade. */
+        mean_clv_cents: number | null;
+        /** Share of measured trades with clv_cents > 0, 0 to 1. null with no measured trade. */
+        share_beat_close: number | null;
+        /** Their summed size in USDC. */
+        size_usd: number;
+        /** Mean of clv_cents weighted by each trade's size_usd. null with no measured trade. */
+        stake_weighted_clv_cents: number | null;
+        /** Large trades with clv.status measured. */
+        trades: number;
+    };
+    /** Size floor in USDC, as /large-trades/history reads it. */
+    min_size: number;
+    /** Window end, exclusive. */
+    to: string;
+};
 export type TraderContext = {
     trader: Trader;
     /** Aggregate position and P&L coverage for the trader, over its synced markets. markets_open, unrealized_mtm and cost_basis_locked cover the open positions on sports and esports markets, each market judged when the summary is read (#32119). markets_synced, markets_resolved and the resolved win figures count every stored market: since 2026-10-27 (#29366) those are mostly sports and esports markets, but a market that moved out of sports and esports, or one stored before its category was known, stays in them, and sync_coverage counts every category on both sides. markets_total, total_realized_pnl and synced_realized_pnl still cover every Polymarket market of the wallet. Omitted entirely (key absent, never null) when the trader is not in the local database or native net economics is unavailable. Realized fields remain numbers when present, including a genuine zero. */
@@ -5607,6 +5730,7 @@ export type UpdateWebhookRequest = {
     url?: string;
     event_types?: WebhookEventType[];
     trade_filters?: LargeTradeSubscriptionFilters;
+    price_move_filters?: PriceMoveSubscriptionFilters;
     enabled?: boolean;
 };
 export type Usage = {
@@ -5703,6 +5827,8 @@ export type WebhookEndpoint = {
     url: string;
     event_types: WebhookEventType[];
     trade_filters: LargeTradeSubscriptionFilters;
+    /** The market_price_moved settings; null unless that event is subscribed. */
+    price_move_filters: PriceMoveSubscriptionFilters | null;
     status: WebhookStatus;
     verified_at: string | null;
     verification_token_expires_at: string;
@@ -5725,7 +5851,7 @@ export type WebhookEventDescriptor = {
     /** active: the event has a firing producer callsite. dormant: advertised and subscribable, but does not yet enqueue any delivery. */
     status: "active" | "dormant";
 };
-export type WebhookEventType = "large_trade_inserted_v2" | "large_trades_inserted" | "whale_trades_inserted" | "live_sports_updated" | "trader_synced" | "whale_trader_synced" | "large_positions_updated" | "wallet_grade_changed" | "suspicious_trade_flagged" | "insider_radar_flag_raised" | "sharp_money_flow_detected" | "smart_money_flow_detected" | "export_job_ready" | "export_job_failed" | "export_job_expired" | "export_job_cancelled";
+export type WebhookEventType = "large_trade_inserted_v2" | "large_trades_inserted" | "whale_trades_inserted" | "live_sports_updated" | "trader_synced" | "whale_trader_synced" | "large_positions_updated" | "wallet_grade_changed" | "suspicious_trade_flagged" | "insider_radar_flag_raised" | "sharp_money_flow_detected" | "smart_money_flow_detected" | "export_job_ready" | "export_job_failed" | "export_job_expired" | "export_job_cancelled" | "market_price_moved";
 export type WebhookRetryPolicy = {
     max_attempts: 8;
     terminal_status: "dead_letter";
@@ -5898,6 +6024,23 @@ export type WhaleDatasetTrade = {
     /** Stored source trade identity. */
     trade_event_id: string;
     source_trade_ingested_at: string | null;
+    /** Closing line value: the clv object of the same trade on /api/v1/large-trades, judged at the generation's selected_at from close states read inside the same snapshot. A pending row can be measured in a later generation. The close is stored once (GET /api/v1/market/{condition_id}/close), so a measured clv_cents changes only if the market's kickoff or YES token changes afterwards, which makes it unavailable (anchor_stale, close_token_mismatch). */
+    clv: {
+        /** The CLV definition, clv@v1. */
+        basis_version: string;
+        /** The anchor pre_kickoff was judged against: the stored close's anchor, else the market's kickoff. */
+        close_anchor_at: string | null;
+        /** The traded outcome's closing price, 0 to 1, whenever a usable close is stored and the outcome is known, in play included. */
+        close_price: number | null;
+        /** Cents per share, positive when the trade beat the close: buy is (close_price - price) * 100, sell is (price - close_price) * 100. Gross of fees. Computed from the exact stored price this row carries, so a recomputation from price and close_price agrees to the stored digits. Set exactly when status is measured. */
+        clv_cents: number | null;
+        /** Whether the trade filled before close_anchor_at. null when the market has no anchor. */
+        pre_kickoff: boolean | null;
+        /** measured: clv_cents is set. in_play: traded at or after the close anchor (kickoff), no CLV is defined. pending: traded before kickoff and the market's close is not stored yet. unavailable: see unavailable_reason. */
+        status: "measured" | "in_play" | "pending" | "unavailable";
+        /** Set exactly when status is unavailable. The market's reasons (see MarketClose.unavailable_reason), plus anchor_stale (the kickoff moved after the close was captured) and outcome_unknown (the traded outcome is not known for this trade). */
+        unavailable_reason: "no_observation_in_lookback" | "provider_empty_window" | "provider_invalid_contract" | "capture_window_closed" | "no_game_start_time" | "not_one_sided_resolution" | "not_captured" | "close_token_mismatch" | "anchor_stale" | "outcome_unknown" | null;
+    };
 };
 /**
  * The `data` payload of each webhook event type, from the document's
@@ -5913,6 +6056,7 @@ export interface WebhookEventData {
     large_trade_inserted_v2: LargeTradeInsertedV2Data;
     large_trades_inserted: LargeTradesInsertedData;
     live_sports_updated: LiveSportsUpdatedData;
+    market_price_moved: MarketPriceMovedData;
     sharp_money_flow_detected: SharpMoneyFlowDetectedData;
     smart_money_flow_detected: SharpMoneyFlowDetectedData;
     suspicious_trade_flagged: SuspiciousTradeFlaggedData;
@@ -5928,6 +6072,7 @@ export interface WebhookEventData {
  */
 export interface OperationData {
     activateWebhookSecret: WebhookEndpoint;
+    batchGetMarketClose: BatchMarketCloseItem[];
     batchGetMarketFlow: BatchMarketFlowItem[];
     batchGetMarketIntel: BatchMarketFlowItem[];
     batchGetTraders: BatchTraderItem[];
@@ -6098,6 +6243,7 @@ export interface OperationData {
     getInsiderRadarFlag: SuspiciousTrade;
     getLargeTrade: LargeTradeDetail;
     getMarketCandles: MarketCandles;
+    getMarketClose: MarketClose;
     getMarketContextMarkdown: string;
     getMarketFlow: MarketFlow;
     getMarketHolders: MarketHolder[];
@@ -6174,6 +6320,7 @@ export interface OperationData {
     getSuspiciousTrade: SuspiciousTrade;
     getTrader: Trader;
     getTraderCategoryRecords: TraderCategoryRecords;
+    getTraderClv: TraderClv;
     getTraderContext: TraderContext;
     getTraderContextMarkdown: string;
     getTraderExportSnapshot: TraderExportSnapshot;
@@ -6539,6 +6686,7 @@ export interface OperationData {
 /** Each operation's documented query parameters. */
 export interface OperationQuery {
     activateWebhookSecret: Record<string, never>;
+    batchGetMarketClose: Record<string, never>;
     batchGetMarketFlow: Record<string, never>;
     batchGetMarketIntel: Record<string, never>;
     batchGetTraders: Record<string, never>;
@@ -6657,6 +6805,7 @@ export interface OperationQuery {
         /** Inclusive upper bound as a URL-decoded unix timestamp in seconds; points after this timestamp are omitted. If from is also present, from must be less than or equal to to. */
         to?: number;
     };
+    getMarketClose: Record<string, never>;
     getMarketContextMarkdown: Record<string, never>;
     getMarketFlow: {
         /** Lookback window for whale flow aggregation. */
@@ -6715,10 +6864,10 @@ export interface OperationQuery {
     getPickOfTheDayStats: {
         /** full (default) is every section. summary returns view, sections and every section except the five that grow with the record: series, days, categories, months and voids. In summary and sections bodies hit_rate carries no series; series is its own top-level section. Ignored when sections is sent. Any other value returns 400 bad_request with error.param=view. */
         view?: "full" | "summary";
-        /** Exactly the sections to return, in the body's order whatever the request order. Repeatable and comma-separated: hit_rate, series, market_expectations, outcome_stats, days, categories, sports, tiers, selections, months, price_bands, market_types, total_sides, streaks, records, voids. The body names them in sections and carries view=sections. An unrecognized name returns 400 bad_request with error.param=sections rather than being ignored. */
-        sections?: ("hit_rate" | "series" | "market_expectations" | "outcome_stats" | "days" | "categories" | "sports" | "tiers" | "selections" | "months" | "price_bands" | "market_types" | "total_sides" | "streaks" | "records" | "voids")[];
+        /** Exactly the sections to return, in the body's order whatever the request order. Repeatable and comma-separated: hit_rate, series, market_expectations, outcome_stats, days, categories, sports, tiers, months, price_bands, market_types, total_sides, streaks, records, voids. The body names them in sections and carries view=sections. An unrecognized name returns 400 bad_request with error.param=sections rather than being ignored. */
+        sections?: ("hit_rate" | "series" | "market_expectations" | "outcome_stats" | "days" | "categories" | "sports" | "tiers" | "months" | "price_bands" | "market_types" | "total_sides" | "streaks" | "records" | "voids")[];
         /** Backward-compatible bracket alias for sections, for clients that emit array keys. Repeatable and comma-separated, with the same names. */
-        "sections[]"?: ("hit_rate" | "series" | "market_expectations" | "outcome_stats" | "days" | "categories" | "sports" | "tiers" | "selections" | "months" | "price_bands" | "market_types" | "total_sides" | "streaks" | "records" | "voids")[];
+        "sections[]"?: ("hit_rate" | "series" | "market_expectations" | "outcome_stats" | "days" | "categories" | "sports" | "tiers" | "months" | "price_bands" | "market_types" | "total_sides" | "streaks" | "records" | "voids")[];
     };
     getPlatforms: Record<string, never>;
     getPositionTimeline: {
@@ -6774,6 +6923,12 @@ export interface OperationQuery {
         wallet?: string;
         /** Filter LargeTradeInsertedV2 frames to trades at or above this USD notional. Positive decimal with at most six places; other event types are excluded when set. */
         min_size?: string;
+        /** Filter MarketPriceMoved frames to these event slug league prefixes (comma-separated, case-insensitive, e.g. nba,epl). Other event types are excluded when set. */
+        league?: string;
+        /** Filter MarketPriceMoved frames to the one level step per market and window that crosses this threshold, in whole cents (2 to 50): previous_level_cents < min_move_cents <= level_cents, the market_price_moved webhook rule. Other event types are excluded when set. */
+        min_move_cents?: number;
+        /** Filter MarketPriceMoved frames to moves measured over this window. Other event types are excluded when set. */
+        window_seconds?: 60 | 120 | 300 | 900;
     };
     getSuspiciousTrade: Record<string, never>;
     getTrader: {
@@ -6788,6 +6943,16 @@ export interface OperationQuery {
         /** Filter to one canonical category, matched through the same rollup every other category surface uses: soccer, EPL and champions league all reach Soccer, every esports label folds into Esports, and football is AMERICAN football and reaches Football. A filter that reaches Esports returns the Esports record with all of its games; a game is not a filter of its own, so ask for esports and read games. A sports or esports category the wallet has no record in answers 200 with an empty records array, never 404. Sports and esports only (#27311): a category outside them, or a value that reaches no category, returns 400 bad_request with param category and names the accepted buckets. The word sports, in any casing, matches every sport but Esports, the provider's catch-all Sports category (cycling, lacrosse) included: use esports for Esports alone, or omit category for both (#32657). */
         category?: string;
     };
+    getTraderClv: {
+        /** Inclusive RFC3339 lower bound on the trade time. Defaults to 90 days before to. */
+        from?: string;
+        /** Exclusive RFC3339 upper bound on the trade time. Defaults to now; must be after from, and at most 366 days after it. */
+        to?: string;
+        /** Minimum trade size in USD. The capture floor was 3,000 USD before 2026-07-06 and 10,000 USD from then (1,000 USD in earnings markets), so 10000 gives one size rule across the whole archive. From 2026-09-23 a fill must also be at least 0.1% of its market's recorded traded volume (Polymarket's own share count); rows written before that date were not re-filtered. */
+        min_size?: number;
+        /** Filter by market category (case-insensitive). A canonical bucket name (e.g. Basketball) matches every provider member that folds into it (NBA, WNBA, NCAAB); a raw provider value also resolves to its bucket. Sports and esports only (#27430): a category outside them returns 400 bad_request with param category and names the accepted buckets. The word sports, in any casing, matches every sport but Esports, the provider's catch-all Sports category (cycling, lacrosse) included: use esports for Esports alone, or omit category for both (#32657). */
+        category?: string;
+    };
     getTraderContext: Record<string, never>;
     getTraderContextMarkdown: Record<string, never>;
     getTraderExportSnapshot: Record<string, never>;
@@ -7207,6 +7372,7 @@ export interface OperationPath {
         /** Webhook endpoint id owned by the authenticated API key user. */
         id: number;
     };
+    batchGetMarketClose: Record<string, never>;
     batchGetMarketFlow: Record<string, never>;
     batchGetMarketIntel: Record<string, never>;
     batchGetTraders: Record<string, never>;
@@ -7269,6 +7435,10 @@ export interface OperationPath {
         /** Market condition ID. Accepts the raw provider-backed condition_id returned by /api/v1/markets/search or /api/v1/markets/explore, or the mkt_-prefixed market.id emitted by V1 responses. */
         condition_id: string;
     };
+    getMarketClose: {
+        /** Market condition ID. Accepts the raw provider-backed condition_id returned by /api/v1/markets/search or /api/v1/markets/explore, or the mkt_-prefixed market.id emitted by V1 responses. */
+        condition_id: string;
+    };
     getMarketContextMarkdown: {
         /** Market condition ID. Accepts the raw provider-backed condition_id returned by /api/v1/markets/search or /api/v1/markets/explore, or the mkt_-prefixed market.id emitted by V1 responses. */
         condition_id: string;
@@ -7334,6 +7504,10 @@ export interface OperationPath {
         /** Wallet address (0x...), username, or trd_-prefixed trader id. */
         address: string;
     };
+    getTraderClv: {
+        /** Wallet address (0x...), username, or trd_-prefixed trader id. */
+        address: string;
+    };
     getTraderContext: {
         /** Ethereum wallet address (0x...), known trader username, or trd_-prefixed trader ID emitted by this API. */
         address: string;
@@ -7466,6 +7640,10 @@ export interface OperationPath {
 /** Each operation's JSON request body; `never` when it takes none. */
 export interface OperationBody {
     activateWebhookSecret: never;
+    batchGetMarketClose: {
+        /** Market condition IDs (raw or mkt_-prefixed) to resolve in input order. */
+        condition_ids: string[];
+    };
     batchGetMarketFlow: {
         /** Market condition IDs to resolve in input order. */
         condition_ids: string[];
@@ -7516,6 +7694,7 @@ export interface OperationBody {
     getInsiderRadarFlag: never;
     getLargeTrade: never;
     getMarketCandles: never;
+    getMarketClose: never;
     getMarketContextMarkdown: never;
     getMarketFlow: never;
     getMarketHolders: never;
@@ -7539,6 +7718,7 @@ export interface OperationBody {
     getSuspiciousTrade: never;
     getTrader: never;
     getTraderCategoryRecords: never;
+    getTraderClv: never;
     getTraderContext: never;
     getTraderContextMarkdown: never;
     getTraderExportSnapshot: never;
@@ -7606,6 +7786,11 @@ export interface OperationResponse {
         data: OperationData["activateWebhookSecret"];
         meta: ResponseMeta;
     };
+    batchGetMarketClose: {
+        object: "market_close_batch";
+        data: OperationData["batchGetMarketClose"];
+        meta: BatchResponseMeta;
+    };
     batchGetMarketFlow: {
         object: "market_flow_batch";
         data: OperationData["batchGetMarketFlow"];
@@ -7735,6 +7920,11 @@ export interface OperationResponse {
         data: OperationData["getMarketCandles"];
         meta: ResponseMeta;
     };
+    getMarketClose: {
+        object: "market_close";
+        data: OperationData["getMarketClose"];
+        meta: ResponseMeta;
+    };
     getMarketContextMarkdown: string;
     getMarketFlow: {
         object: "market_flow";
@@ -7858,6 +8048,11 @@ export interface OperationResponse {
         data: OperationData["getTraderCategoryRecords"];
         meta: ResponseMeta;
     };
+    getTraderClv: {
+        object: "trader_clv";
+        data: OperationData["getTraderClv"];
+        meta: ResponseMeta;
+    };
     getTraderContext: {
         object: "trader_context";
         data: OperationData["getTraderContext"];