@0xinsider/mcp 2.9.1 → 2.10.1

package/README.md

@@ -228,9 +228,9 @@ hand. Markers are not used here because an HTML comment inside a table breaks it
 |------|-------------|
 | `get_trader` | Look up a trader by wallet address or username — grade, P&L, win rate, strategy, quant metrics |
 | `batch_get_traders` | Look up 1-25 traders in one call with per-item results and batch-item quota |
-| `get_whale_trades` | Recent large trades with a 0-1 review score (`review_score`; `signal_score` is its deprecated spelling) and persisted suspicion facts; filterable by size/category/grade/suspicious_only |
+| `get_whale_trades` | Recent large trades with a 0-1 review score (`review_score`; `signal_score` is its deprecated spelling) and persisted suspicion facts; filterable by size/category/grade/suspicious_only/min_market_volume_share, sortable by `market_volume_share` |
 | `get_whale_trade` | Read one whale trade by wt_ ID or raw whale_alerts.id, including persisted suspicion facts |
-| `get_whale_trades_history` | Replay historical whale trades with cursor, market, trader, category, grade, suspicious_only, platform, and time filters |
+| `get_whale_trades_history` | Replay historical whale trades with cursor, market, trader, category, grade, suspicious_only, platform, market-share, and time filters, sortable by `market_volume_share` |
 | `get_leaderboard` | Top-ranked traders (S/A/B grades) with optional category/strategy filters |
 | `search_markets` | Search prediction markets by keyword, with cursor pagination (`cursor`, `has_more`, `next_cursor`) |
 | `explore_markets` | Browse whale-active markets with facets and grouped discovery entries |
@@ -241,7 +241,7 @@ hand. Markers are not used here because an HTML comment inside a table breaks it
 | `get_sharp_money_flows` | Ranked sharp-money flow discovery across markets (timeframe, category, platform, min-grade, direction filters) |
 | `get_smart_money_flows` | Deprecated alias of `get_sharp_money_flows` (byte-identical); kept for backward compatibility |
 | `get_market_snapshot` | Live market-card snapshot with outcomes, liquidity, sports context, and freshness state |
-| `get_positions` | Current positions with trader, market, value, side, P&L, and freshness context |
+| `get_positions` | Current positions with trader, market, value, side, P&L, and freshness context; a `consistency=snapshot` page carries its `snapshot` (`as_of`, `expires_at`, `row_count`) |
 | `get_position_timeline` | Per-market trader fills with running amount and average entry price |
 | `get_position_timeline_by_id` | Per-market trader fills using an internal trader ID alias |
 | `get_suspicious_trades` | Stored trades whose recorded suspicion score meets the live flag threshold (`severity=watch` returns none: no live watch policy exists) |

package/dist/constants.d.ts

@@ -2,7 +2,7 @@ export declare const API_BASE_URL = "https://api.0xinsider.com";
 export declare const SITE_URL = "https://0xinsider.com";
 export declare const DEVELOPERS_URL = "https://0xinsider.com/developers";
 export declare const PRICING_URL = "https://0xinsider.com/pricing";
-export declare const VERSION = "2.9.1";
+export declare const VERSION = "2.10.1";
 export declare const PACKAGE_NAME = "@0xinsider/mcp";
 export declare const SERVER_NAME = "0xinsider";
 export declare const API_KEY_ENV_VAR = "OXINSIDER_API_KEY";

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,8BAA8B,CAAC;AACxD,eAAO,MAAM,QAAQ,0BAA0B,CAAC;AAChD,eAAO,MAAM,cAAc,qCAA2B,CAAC;AACvD,eAAO,MAAM,WAAW,kCAAwB,CAAC;AAcjD,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,eAAO,MAAM,YAAY,mBAAmB,CAAC;AAC7C,eAAO,MAAM,WAAW,cAAc,CAAC;AACvC,eAAO,MAAM,eAAe,sBAAsB,CAAC;AACnD,eAAO,MAAM,eAAe,sBAAsB,CAAC;AACnD,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,eAAO,MAAM,YAAY,YAAI,IAAI,mBAAwB,CAAC;AAU1D,eAAO,MAAM,eAAe,KAAK,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,8BAA8B,CAAC;AACxD,eAAO,MAAM,QAAQ,0BAA0B,CAAC;AAChD,eAAO,MAAM,cAAc,qCAA2B,CAAC;AACvD,eAAO,MAAM,WAAW,kCAAwB,CAAC;AAcjD,eAAO,MAAM,OAAO,WAAW,CAAC;AAEhC,eAAO,MAAM,YAAY,mBAAmB,CAAC;AAC7C,eAAO,MAAM,WAAW,cAAc,CAAC;AACvC,eAAO,MAAM,eAAe,sBAAsB,CAAC;AACnD,eAAO,MAAM,eAAe,sBAAsB,CAAC;AACnD,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,eAAO,MAAM,YAAY,YAAI,IAAI,mBAAwB,CAAC;AAU1D,eAAO,MAAM,eAAe,KAAK,CAAC"}

package/dist/constants.js

@@ -15,7 +15,7 @@ export const PRICING_URL = `${SITE_URL}/pricing`;
 // flow runs `cd mcp && npm ci` from a clean checkout, where `web/node_modules` need not
 // exist.
 // generated-package-version:start
-export const VERSION = "2.9.1";
+export const VERSION = "2.10.1";
 // generated-package-version:end
 export const PACKAGE_NAME = "@0xinsider/mcp";
 export const SERVER_NAME = "0xinsider";

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,2BAA2B,CAAC;AACxD,MAAM,CAAC,MAAM,QAAQ,GAAG,uBAAuB,CAAC;AAChD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,QAAQ,aAAa,CAAC;AACvD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,QAAQ,UAAU,CAAC;AACjD,mCAAmC;AACnC,EAAE;AACF,sFAAsF;AACtF,uFAAuF;AACvF,wFAAwF;AACxF,4EAA4E;AAC5E,sFAAsF;AACtF,yFAAyF;AACzF,oFAAoF;AACpF,uFAAuF;AACvF,wFAAwF;AACxF,SAAS;AACT,kCAAkC;AAClC,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAC/B,gCAAgC;AAChC,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAC7C,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,YAAY,CAAU,CAAC;AAE1D,oDAAoD;AACpD,EAAE;AACF,gFAAgF;AAChF,yFAAyF;AACzF,wFAAwF;AACxF,qFAAqF;AACrF,4EAA4E;AAC5E,iCAAiC;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAClC,+BAA+B"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,2BAA2B,CAAC;AACxD,MAAM,CAAC,MAAM,QAAQ,GAAG,uBAAuB,CAAC;AAChD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,QAAQ,aAAa,CAAC;AACvD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,QAAQ,UAAU,CAAC;AACjD,mCAAmC;AACnC,EAAE;AACF,sFAAsF;AACtF,uFAAuF;AACvF,wFAAwF;AACxF,4EAA4E;AAC5E,sFAAsF;AACtF,yFAAyF;AACzF,oFAAoF;AACpF,uFAAuF;AACvF,wFAAwF;AACxF,SAAS;AACT,kCAAkC;AAClC,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC;AAChC,gCAAgC;AAChC,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAC7C,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,YAAY,CAAU,CAAC;AAE1D,oDAAoD;AACpD,EAAE;AACF,gFAAgF;AAChF,yFAAyF;AACzF,wFAAwF;AACxF,qFAAqF;AACrF,4EAA4E;AAC5E,iCAAiC;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAClC,+BAA+B"}

package/dist/sdk/schema.d.ts

@@ -1169,9 +1169,13 @@ export type PickHolder = {
     name: string | null;
     /** All-time trader grade (S, A, B, C, D, F). */
     grade: string | null;
+    /** The wallet's most recent recorded trade time, stamped at serve time from its current trader record rather than frozen with the pick. Always sent; null when no trade time is recorded. */
+    last_traded_at: string | null;
     /** 0xinsider profile path segment this wallet links to: `@<username>` when that username resolves to this wallet alone, otherwise the lowercase wallet. Percent-encode the part after `@` and append to `https://0xinsider.com/profile/`. Stamped at serve time; absent on a body cached before the field shipped. */
     profile_segment?: string;
     shares: number;
+    /** USD entry value of this wallet's position: `shares` times the pick's frozen `backed_price`. An entry valuation, never a live balance or the provider's current value. Omitted when the holder snapshot has no valid price. */
+    entry_value_usd?: number;
     /** This wallet's win rate in the pick's canonical category bucket (the pick's `category` field, e.g. Basketball -- label the rate with it, never with the narrower `display_category` league, except when `category_win_rate_game` is present, in which case the rate is that game's and is labelled with it): the share of the wallet's resolved markets in that category whose realized P&L closed positive, as a 0..1 fraction. Present only with `category_win_rate_status` = `measured`, on `display_holders` entries, and only when the wallet clears the resolved-market floor; recomputed at serve time from the current category read model, not frozen with the pick. Absent on `holders` entries, legacy rows, and payloads predating the field. */
     category_win_rate?: number;
     /** The two counts `category_win_rate` is the ratio of, read from the same row: `wins / decided` equals the rate. Counts every resolved Polymarket market the wallet traded in the pick's canonical category (or in its game, when `category_win_rate_game` is present), at any position size; the counts are rebuilt daily. Present only with `category_win_rate_status` = `measured`; absent otherwise and on payloads predating the field. */
@@ -1224,6 +1228,8 @@ export type PickOfTheDay = {
     is_locked?: boolean;
     /** True once the backed game's kickoff has passed (kickoff <= now). When true the snapshotted pre-game price is no longer actionable. Absent for a legacy pick with no stored kickoff (treat as not-started). */
     game_started?: boolean;
+    /** Whether the backed game is over according to the cached live scoreboard, read at serve time. Tells a finished game from one still in play before `outcome` settles. Omitted when the pick has no event slug or no scoreboard is cached for it; absence is unknown, never false. */
+    game_ended?: boolean;
     /** Settlement outcome of the backed side; 'pending' until the market resolves. */
     outcome?: "pending" | "win" | "loss" | "void";
     /** Pre-formatted SETTLEMENT STATUS for display: "Win" / "Loss" / "Void" / "Pending" -- the outcome enum above as a label. Convenience only; outcome is the source value. NOTE: this is the win/loss STATUS, not the backed side. The backed side is pick_outcome_label ("Belgium (-2.5)") -- a different field answering a different question. */
@@ -1354,6 +1360,8 @@ export type PickOfTheDay = {
     thesis?: string;
     /** Canonical web market URL. */
     market_url?: string;
+    /** Where this pick's outbound Polymarket link lands: Polymarket's own redirect answer for `/event/<event_slug>`, carrying the referral tag. Omitted until that redirect has been resolved; link to the event page instead when it is absent. */
+    polymarket_url?: string;
     /** The canonical /event game-page slug (one neutral page per game); omitted when the game has no neutral event page. */
     event_slug?: string;
     /** Backend-resolved /event destination slug for this pick's source market; its absence is an authoritative no-link decision. */
@@ -1678,6 +1686,8 @@ export type PickSportsTeam = {
     provider_id: number | null;
     /** Team crest or flag URL. Provider-owned for most teams (Polymarket /teams crest for clubs, country flag for national teams and tennis players). A club with a vendored crest carries it instead, served same-origin as a relative path (`/api/sports/team-logos/{league}/{abbr}.svg?v=<content hash>` or `.png`, resolve it against this server): every NFL and WNBA team, whose provider asset is a text tile, and the soccer clubs whose provider asset is an empty object. */
     logo: string | null;
+    /** True when the team mark is dark enough to disappear on a dark background, measured from the artwork by the teams sync. Render a dark mark on a light plate. Always sent; false until the artwork has been measured. */
+    logo_mark_dark: boolean;
     /** Team brand color as a hex string (provider-owned). */
     color: string | null;
     /** Win-loss record as a display string (e.g. "12-4"). */
@@ -2344,7 +2354,7 @@ export type Trader = {
         sharpe_7d: number | null;
         /** Gross profit divided by gross loss; greater than 1 is profitable. Capped at 1000 when there are effectively no losses. null when insufficient history. */
         profit_factor: number | null;
-        /** Stability of the trader's edge over time, 0-1 (higher is more consistent). null when insufficient history. */
+        /** Share of the trader's last 30 days with realized P&L that closed positive, 0-1 (higher is more consistent). A day with no realized P&L is not one of them, so the window can span months. null below 10 such days; null never means 0. */
         edge_consistency: number | null;
         /** Cross-sectional percentile rank of the trader's Sharpe ratio versus all traders, 0-100. null when insufficient history. */
         sharpe_percentile: number | null;
@@ -3255,11 +3265,11 @@ export interface OperationQuery {
         status?: "active" | "closed" | "all";
         /** Filter by source platform. Explore is Polymarket-only; polymarket is the only supported value and the parameter is accepted for backward-compatibility but does not change the result set. */
         platform?: "polymarket";
-        /** Sort order for the discovery feed. */
-        sort?: "trending" | "hot" | "expiring" | "whales" | "volume" | "newest";
+        /** Sort order for the discovery feed. `large_trades` ranks by large-trade activity; `whales` is its deprecated spelling and selects the same order. */
+        sort?: "trending" | "hot" | "expiring" | "large_trades" | "whales" | "volume" | "newest";
         /** Opaque pagination cursor from the previous response. */
         cursor?: string;
-        /** Page size. */
+        /** Page size. Out-of-range values are clamped to 1..48. */
         limit?: number;
         /** Keyword search against market titles. At most 64 characters before whitespace trimming. */
         q?: string;
@@ -3268,13 +3278,13 @@ export interface OperationQuery {
     getApiDiscovery: Record<string, never>;
     getCoverage: Record<string, never>;
     getDailyReportSnapshot: {
-        /** UTC report date in YYYY-MM-DD format. */
+        /** 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. */
         date: 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. */
         cursor?: string;
-        /** Maximum durable public whale-trade events to return. */
+        /** Maximum durable public whale-trade events to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Only this wallet's trades: a wallet address, trd_-prefixed trader id or username resolved against the traders table. Bound to the cursor: a cursor issued under other filters answers 400 with error.reason cursor_expired. An unknown trader matches nothing and the walk still advances. */
         trader?: string;
@@ -3284,6 +3294,8 @@ export interface OperationQuery {
         min_grade?: "S" | "A" | "B" | "C" | "D" | "F";
         /** Only trades of at least this size in USD (compared in cents). Bound to the cursor. */
         min_size?: number;
+        /** Backward-compatible alias for expand. Repeatable: trade. */
+        "expand[]"?: "trade"[];
         /** Repeatable. trade adds the public trade read to every event (the object GET /api/v1/whale-trades/{id} returns for it), from one query per page, so a page of 100 events needs no per-event detail request. Not bound to the cursor: switch it on or off mid-walk. */
         expand?: "trade"[];
     };
@@ -3309,7 +3321,7 @@ export interface OperationQuery {
         outcome?: "yes" | "no" | "all";
         /** Narrow within the graded cohort: `S` keeps S, `A` keeps S and A, `B` (default) keeps S, A and B. `C`, `D` and `F` are rejected with 400: the route lists the S/A/B cohort only. The cohort is the wallet's current grade (`traders.latest_grade`), so no value here reaches a C, D, F or ungraded holder; those are counted only in `scan.wallet_count`. `min_grade=D` on GET /api/v1/positions does return C and D, which is one of the three reasons the two routes' counts differ for the same market. */
         min_grade?: "S" | "A" | "B";
-        /** Maximum holders per page. */
+        /** Maximum holders per page. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Opaque pagination cursor from the previous response's next_cursor. It encodes a page of one shared roster, so it stays valid across the roster's refresh, but a page read after a refresh can repeat or skip a holder. */
         cursor?: string;
@@ -3325,7 +3337,7 @@ export interface OperationQuery {
         expand?: "trust"[];
     };
     getMonthlyReportSnapshot: {
-        /** UTC report month in YYYY-MM format. */
+        /** UTC report month in YYYY-MM format. A month that ends before 2024-03-01, the first day report data covers, or starts after tomorrow UTC returns 400 bad_request with error.param=month. */
         month: string;
     };
     getPickOfTheDay: Record<string, never>;
@@ -3335,7 +3347,7 @@ export interface OperationQuery {
     getPositionTimeline: {
         /** Market condition_id. One timeline per (trader, market). */
         condition_id: string;
-        /** Maximum number of timeline events to return. */
+        /** Maximum number of timeline events to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response's next_cursor. */
         cursor?: string;
@@ -3343,7 +3355,7 @@ export interface OperationQuery {
     getPositionTimelineById: {
         /** Market condition_id. One timeline per (trader, market). */
         condition_id: string;
-        /** Maximum number of timeline events to return. */
+        /** Maximum number of timeline events to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response's next_cursor. */
         cursor?: string;
@@ -3351,7 +3363,7 @@ export interface OperationQuery {
     getReports: {
         /** Report granularity selector. */
         granularity: "daily" | "weekly" | "monthly";
-        /** Period token for the granularity. daily: UTC date YYYY-MM-DD. weekly: ISO week YYYY-WW for a durable canonical snapshot, or a from,to YYYY-MM-DD pair for an exact ephemeral range limited to 31 inclusive UTC days. A wider explicit range returns 400 invalid_query. monthly: UTC month YYYY-MM. */
+        /** Period token for the granularity. daily: UTC date YYYY-MM-DD. weekly: ISO week YYYY-WW for a durable canonical snapshot, or a from,to YYYY-MM-DD pair for an exact ephemeral range limited to 31 inclusive UTC days. A wider explicit range returns 400 invalid_query. monthly: UTC month YYYY-MM. A period that ends before 2024-03-01, the first day report data covers, or starts after tomorrow UTC returns 400 bad_request with error.param=period. */
         period: string;
     };
     getStream: {
@@ -3407,11 +3419,11 @@ export interface OperationQuery {
     getUsage: Record<string, never>;
     getWebhook: Record<string, never>;
     getWeeklyReportSnapshot: {
-        /** UTC source-range start in YYYY-MM-DD format; required with to. Together with to, selects an exact ephemeral range of at most 31 inclusive UTC days. */
+        /** UTC source-range start in YYYY-MM-DD format; required with to. Together with to, selects an exact ephemeral range of at most 31 inclusive UTC days. A start after tomorrow UTC returns 400 bad_request with error.param=from. */
         from?: string;
-        /** UTC source-range end in YYYY-MM-DD format; required with from. Together with from, selects an exact ephemeral range of at most 31 inclusive UTC days. */
+        /** UTC source-range end in YYYY-MM-DD format; required with from. Together with from, selects an exact ephemeral range of at most 31 inclusive UTC days. An end before 2024-03-01, the first day report data covers, returns 400 bad_request with error.param=to. */
         to?: string;
-        /** ISO week selector in YYYY-WW format; alternative to from/to. Selects a durable canonical snapshot. */
+        /** ISO week selector in YYYY-WW format; alternative to from/to. Selects a durable canonical snapshot. A week that ends before 2024-03-01, the first day report data covers, or starts after tomorrow UTC returns 400 bad_request with error.param=week. */
         week?: string;
     };
     getWhaleTrade: Record<string, never>;
@@ -3426,13 +3438,13 @@ export interface OperationQuery {
         starts_after?: string;
         /** RFC 3339 instant. Keep only games whose kickoff is at or before it. Must be at or after starts_after. */
         starts_before?: string;
-        /** Page size. */
+        /** Page size. Out-of-range values are clamped to 1..100. */
         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. A cursor this endpoint did not issue returns 400 with error.param=cursor. */
         cursor?: string;
     };
     listInsiderRadar: {
-        /** Maximum number of radar flags to return. */
+        /** Maximum number of radar flags to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response. */
         cursor?: string;
@@ -3444,7 +3456,7 @@ export interface OperationQuery {
         mode?: "live" | "stable";
     };
     listLargePositions: {
-        /** Maximum number of large positions to return. */
+        /** Maximum number of large positions to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Opaque pagination cursor from a previous response. */
         cursor?: string;
@@ -3462,7 +3474,7 @@ export interface OperationQuery {
         snapshot_id: string;
         /** Opaque cursor from the previous response's next_cursor. */
         cursor?: string;
-        /** Maximum number of counterparty execution rows to return. */
+        /** Maximum number of counterparty execution rows to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
     };
     listLargeTradeCounterpartyMakers: {
@@ -3470,11 +3482,11 @@ export interface OperationQuery {
         snapshot_id: string;
         /** Opaque cursor from the previous response's next_cursor. */
         cursor?: string;
-        /** Maximum number of maker rows to return. */
+        /** Maximum number of maker rows to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
     };
     listLargeTradeHistory: {
-        /** Maximum number of historical large trades to return. */
+        /** Maximum number of historical large trades to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response's next_cursor. Prefix: wth_. URL-encode when replaying as a query parameter. */
         cursor?: string;
@@ -3502,7 +3514,7 @@ export interface OperationQuery {
         sort?: "recent" | "market_volume_share";
     };
     listLargeTrades: {
-        /** Maximum number of recent large trades to return. */
+        /** Maximum number of recent large trades to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response's next_cursor. */
         cursor?: string;
@@ -3520,7 +3532,7 @@ export interface OperationQuery {
         sort?: "recent" | "market_volume_share";
     };
     listLeaderboard: {
-        /** Maximum number of ranked traders to return. */
+        /** Maximum number of ranked traders to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Opaque lbv1_ pagination cursor from a prior response. It binds the finite score/address boundary to the committed leaderboard generation and the effective category/strategy filters; legacy, malformed, non-finite, and unsupported-version cursors are rejected. */
         cursor?: string;
@@ -3530,7 +3542,7 @@ export interface OperationQuery {
         strategy?: "accumulator" | "algo_trader" | "arbitrageur" | "directional" | "event_driven" | "market_maker" | "momentum" | "scalper" | "speculator" | "swing_trader";
     };
     listPositions: {
-        /** Maximum number of current positions to return. */
+        /** Maximum number of current positions to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response's next_cursor. */
         cursor?: string;
@@ -3556,7 +3568,7 @@ export interface OperationQuery {
         cohort: "wider_holder" | "in_play" | "emerging_pile";
         /** Optional canonical sport bucket. Omitted or blank selects all registered sports. Raw provider categories resolve through the canonical taxonomy, including table-tennis or table tennis to Table Tennis and pickleball to Pickleball; a non-sport category returns an empty list. */
         category?: string;
-        /** Page size. */
+        /** Page size. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Server-authenticated opaque seo_v2_ cursor from next_cursor. Pins snapshot_as_of, cohort, rank, and condition_id; pre-deploy unsigned seo_ cursors are rejected, so clients must request the first page after this contract ships; emerging_pile cursors also pin the first-page projection_now cutoff so kickoff filtering cannot renumber continuation pages. Client edits fail closed; it cannot cross cohorts; a refreshed snapshot invalidates it with 400. */
         cursor?: string;
@@ -3564,7 +3576,7 @@ export interface OperationQuery {
     listPreGameSides: {
         /** Optional canonical sport bucket filter (e.g. Basketball, Tennis, Soccer). A raw provider value (NBA) resolves to its canonical bucket. A non-sport category returns an empty list. */
         category?: string;
-        /** Page size. */
+        /** Page size. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Opaque cursor from a previous response's next_cursor. Encodes the snapshot anchor plus the last row's directional_rank_score, conviction_score, smart_score and condition_id. A cursor from an expired snapshot returns 400. */
         cursor?: string;
@@ -3576,7 +3588,7 @@ export interface OperationQuery {
     listSharpMoneyFlows: {
         /** Lookback window for grade-filtered whale flow aggregation. */
         timeframe?: "1h" | "4h" | "24h" | "7d";
-        /** Page size. */
+        /** Page size. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Opaque cursor from previous response's next_cursor. Encodes the first-page as_of timestamp, normalized effective filters, ranking and aggregate collection revisions, plus the last row's absolute net flow and condition_id. A changed filter or collection returns cursor_expired; request the first page again. */
         cursor?: string;
@@ -3592,7 +3604,7 @@ export interface OperationQuery {
     listSmartMoneyFlows: {
         /** Lookback window for grade-filtered whale flow aggregation. */
         timeframe?: "1h" | "4h" | "24h" | "7d";
-        /** Page size. */
+        /** Page size. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Opaque cursor from previous response's next_cursor. Encodes the first-page as_of timestamp, normalized effective filters, ranking and aggregate collection revisions, plus the last row's absolute net flow and condition_id. A changed filter or collection returns cursor_expired; request the first page again. */
         cursor?: string;
@@ -3610,7 +3622,7 @@ export interface OperationQuery {
         cohort: "wider_holder" | "in_play" | "emerging_pile";
         /** Optional canonical sport bucket. Omitted or blank selects all registered sports. Raw provider categories resolve through the canonical taxonomy, including table-tennis or table tennis to Table Tennis and pickleball to Pickleball; a non-sport category returns an empty list. */
         category?: string;
-        /** Page size. */
+        /** Page size. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Server-authenticated opaque seo_v2_ cursor from next_cursor. Pins snapshot_as_of, cohort, rank, and condition_id; pre-deploy unsigned seo_ cursors are rejected, so clients must request the first page after this contract ships; emerging_pile cursors also pin the first-page projection_now cutoff so kickoff filtering cannot renumber continuation pages. Client edits fail closed; it cannot cross cohorts; a refreshed snapshot invalidates it with 400. */
         cursor?: string;
@@ -3618,7 +3630,7 @@ export interface OperationQuery {
     listSportsEdgeSignals: {
         /** Optional canonical sport bucket filter (e.g. Basketball, Tennis, Soccer). A raw provider value (NBA) resolves to its canonical bucket. A non-sport category returns an empty list. */
         category?: string;
-        /** Page size. */
+        /** Page size. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Opaque cursor from a previous response's next_cursor. Encodes the snapshot anchor plus the last row's directional_rank_score, conviction_score, smart_score and condition_id. A cursor from an expired snapshot returns 400. */
         cursor?: string;
@@ -3628,7 +3640,7 @@ export interface OperationQuery {
         min_grade?: "S" | "A" | "B";
     };
     listSuspiciousTrades: {
-        /** Maximum number of suspicious trades to return. */
+        /** Maximum number of suspicious trades to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response. */
         cursor?: string;
@@ -3640,7 +3652,7 @@ export interface OperationQuery {
         mode?: "live" | "stable";
     };
     listTrendingWallets: {
-        /** Polymarket's weekly leaderboard caps the ranked set at 50 wallets; requests above 50 still return at most 50. */
+        /** Polymarket's weekly leaderboard caps the ranked set at 50 wallets; requests above 50 still return at most 50. Out-of-range values are clamped to 1..50. */
         limit?: number;
         /** Opaque pagination cursor from a previous response, bound to its effective limit, window and ranked-board generation. A changed board or request scope returns error.reason=cursor_expired; legacy page-only cursors must restart from page one. */
         cursor?: string;
@@ -3660,7 +3672,7 @@ export interface OperationQuery {
         snapshot_id: string;
         /** Opaque cursor from the previous response's next_cursor. */
         cursor?: string;
-        /** Maximum number of counterparty execution rows to return. */
+        /** Maximum number of counterparty execution rows to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
     };
     listWhaleTradeCounterpartyMakers: {
@@ -3668,11 +3680,11 @@ export interface OperationQuery {
         snapshot_id: string;
         /** Opaque cursor from the previous response's next_cursor. */
         cursor?: string;
-        /** Maximum number of maker rows to return. */
+        /** Maximum number of maker rows to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
     };
     listWhaleTradeHistory: {
-        /** Maximum number of historical large trades to return. */
+        /** Maximum number of historical large trades to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response's next_cursor. Prefix: wth_. URL-encode when replaying as a query parameter. */
         cursor?: string;
@@ -3700,7 +3712,7 @@ export interface OperationQuery {
         sort?: "recent" | "market_volume_share";
     };
     listWhaleTrades: {
-        /** Maximum number of recent large trades to return. */
+        /** Maximum number of recent large trades to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response's next_cursor. */
         cursor?: string;
@@ -3725,13 +3737,13 @@ export interface OperationQuery {
     searchContent: {
         /** Search query. Must be 1-256 characters before whitespace trimming and non-empty after trimming. */
         q: string;
-        /** Maximum content items to return. */
+        /** Maximum content items to return. Out-of-range values are clamped to 1..50. */
         limit?: number;
     };
     searchMarkets: {
         /** Search query. Must be 1-512 characters before whitespace trimming and non-empty after trimming. */
         q: string;
-        /** Maximum number of matching markets to return. */
+        /** Maximum number of matching markets to return. Out-of-range values are clamped to 1..100. */
         limit?: number;
         /** Pagination cursor from previous response's next_cursor. */
         cursor?: string;
@@ -4389,7 +4401,8 @@ export interface OperationResponse {
         object: "list";
         data: OperationData["listPreGameSideObservations"];
         has_more: boolean;
-        next_cursor?: string;
+        /** Pass as cursor for the next page. Always sent; null on the last page. */
+        next_cursor: string | null;
         /** Completion time of the shared observation snapshot pinned by the cursor. */
         snapshot_as_of: string;
         /** True when an operational failure or unknown provider-board, holder, directional, reconciliation, or internal completeness state made this snapshot partial. This is snapshot-wide and can retain degradation that the funnel's one-terminal-per-input accounting cannot represent. Intentional bounded capacity_limited rows remain fully accounted in the funnel and do not by themselves set this field. */
@@ -4425,7 +4438,8 @@ export interface OperationResponse {
         object: "list";
         data: OperationData["listSportsEdgeObservations"];
         has_more: boolean;
-        next_cursor?: string;
+        /** Pass as cursor for the next page. Always sent; null on the last page. */
+        next_cursor: string | null;
         /** Completion time of the shared observation snapshot pinned by the cursor. */
         snapshot_as_of: string;
         /** True when an operational failure or unknown provider-board, holder, directional, reconciliation, or internal completeness state made this snapshot partial. This is snapshot-wide and can retain degradation that the funnel's one-terminal-per-input accounting cannot represent. Intentional bounded capacity_limited rows remain fully accounted in the funnel and do not by themselves set this field. */