@0xinsider/mcp 3.6.1 → 3.7.0

package/dist/product-cli/operations.js

@@ -0,0 +1,222 @@
+import { API_CLIENT_OPERATIONS, READ_ONLY_POST_OPERATIONS, } from "#sdk";
+/**
+ * Checked against the SDK's generated `OperationQuery` at compile time in both
+ * directions: a name the operation does not document fails, and so does a
+ * documented name left out, reported as `Property 'missing' is missing`. When
+ * the OpenAPI document adds or removes a query parameter, the SDK types move
+ * and `npm run check-types` names the row to change here.
+ */
+function completeQueryTable(table) {
+    return table;
+}
+// The SDK registry carries no runtime query metadata, so this is the CLI's one
+// copy of it. Operation ids, methods and paths still come from
+// `API_CLIENT_OPERATIONS`; nothing here restates them.
+const QUERY_PARAMETERS = completeQueryTable({
+    batchGetMarketFlow: [],
+    batchGetTraders: [],
+    exploreMarkets: ["q", "category", "status", "platform", "sort", "limit", "cursor"],
+    getAccountIdentity: [],
+    getApiDiscovery: [],
+    getCombo: [],
+    getCombosSummary: [],
+    getCoverage: [],
+    getDailyReportSnapshot: ["date"],
+    getEdgeHunter: [
+        "view",
+        "kind",
+        "sports",
+        "leagues",
+        "market_types",
+        "condition_ids",
+        "event_slugs",
+        "series_slugs",
+        "category",
+        "cohort",
+        "admission",
+        "min_grade",
+        "horizon_hours",
+        "limit",
+        "cursor",
+    ],
+    getEventReplaySince: ["trader", "condition_id", "min_grade", "min_size", "expand", "limit", "cursor"],
+    getGame: [],
+    getHealth: [],
+    getLargeTrade: [],
+    getMarketCandles: ["resolution", "from", "to"],
+    getMarketContextMarkdown: [],
+    getMarketFlow: ["timeframe"],
+    getMarketHolders: ["outcome", "min_grade", "limit", "cursor"],
+    getMarketSnapshot: ["expand"],
+    getMonthlyReportSnapshot: ["month"],
+    getPickOfTheDay: [],
+    getPickOfTheDayArchive: [],
+    getPickOfTheDayLedger: [],
+    getPickOfTheDayLedgerEntry: [],
+    getPositionTimeline: ["condition_id", "limit", "cursor"],
+    getPositionTimelineById: ["condition_id", "limit", "cursor"],
+    getReports: ["granularity", "period"],
+    getStream: ["last_event_id", "seq", "event", "condition_id", "min_grade", "wallet", "min_size"],
+    getSuspiciousTrade: [],
+    getTrader: ["expand", "max_age_s"],
+    getTraderCategoryRecords: ["category"],
+    getTraderContext: [],
+    getTraderContextMarkdown: [],
+    getTraderExportSnapshot: [],
+    getTraderExportStatus: ["job_id"],
+    getTraderGradeAt: ["as_of"],
+    getTraderPnl: ["from", "to", "sections"],
+    getUsage: [],
+    getWebhook: [],
+    getWebhookVerificationAttempt: [],
+    getWeeklyReportSnapshot: ["week", "from", "to"],
+    getWhaleDatasetStatus: [],
+    listComboFills: [
+        "result",
+        "legs",
+        "min_stake",
+        "min_multiplier",
+        "grades",
+        "sports",
+        "sort",
+        "window",
+        "limit",
+        "cursor",
+        "offset",
+    ],
+    listGames: ["sport", "league", "status", "starts_after", "starts_before", "limit", "cursor"],
+    listLargePositions: ["condition_id", "category", "min_grade", "min_size", "limit", "cursor"],
+    listLargeTradeCounterpartyExecutions: ["snapshot_id", "limit", "cursor"],
+    listLargeTradeCounterpartyMakers: ["snapshot_id", "limit", "cursor"],
+    listLargeTradeHistory: [
+        "condition_id",
+        "trader",
+        "category",
+        "platform",
+        "min_grade",
+        "min_size",
+        "min_market_volume_share",
+        "suspicious_only",
+        "from",
+        "to",
+        "sort",
+        "limit",
+        "cursor",
+    ],
+    listLargeTrades: [
+        "category",
+        "min_grade",
+        "min_size",
+        "min_market_volume_share",
+        "suspicious_only",
+        "since",
+        "sort",
+        "limit",
+        "cursor",
+    ],
+    listLeaderboard: ["category", "strategy", "limit", "cursor"],
+    listPositions: [
+        "wallet",
+        "condition_id",
+        "category",
+        "side",
+        "min_grade",
+        "min_size",
+        "consistency",
+        "limit",
+        "cursor",
+    ],
+    listSharpMoneyFlows: [
+        "timeframe",
+        "category",
+        "platform",
+        "min_grade",
+        "direction",
+        "limit",
+        "cursor",
+    ],
+    listSuspiciousTrades: ["min_suspicion", "severity", "mode", "limit", "cursor"],
+    listTrendingWallets: ["window", "limit", "cursor"],
+    listWebhookDeliveries: ["limit", "cursor"],
+    listWebhookEvents: [],
+    listWebhooks: [],
+    searchContent: ["q", "limit"],
+    searchMarkets: ["q", "status", "category", "limit", "cursor"],
+});
+/**
+ * Reads the MCP catalog serves (`backend/src/mcp/tools/contract.rs`) on a
+ * path the general rule below excludes. None changes state, and neither
+ * webhook read returns the signing secret: the OpenAPI document returns it
+ * only on create and rotation.
+ */
+const CATALOG_READS = new Set([
+    "listWebhooks",
+    "getWebhook",
+    "getTraderExportSnapshot",
+]);
+const READ_ONLY_POSTS = new Set(READ_ONLY_POST_OPERATIONS);
+const EXCLUDED_PATH = /\/(webhooks|stream|mcp)(\/|$)|\/export(\/|$)|\.md$/;
+/**
+ * Whether `api call` may run an operation: a JSON GET outside webhook
+ * administration, streams, MCP, exports and Markdown, one of the catalog
+ * reads above, or a read-only POST batch. Every other write stays refused.
+ */
+export function isCliCallable(operation) {
+    if (READ_ONLY_POSTS.has(operation.operationId))
+        return true;
+    if (operation.method !== "GET" || "kind" in operation)
+        return false;
+    return CATALOG_READS.has(operation.operationId) || !EXCLUDED_PATH.test(operation.path);
+}
+export function pathParameters(path) {
+    return [...path.matchAll(/\{([^}]+)\}/g)].flatMap((match) => match[1] === undefined ? [] : [match[1]]);
+}
+function isTabled(operationId) {
+    return Object.hasOwn(QUERY_PARAMETERS, operationId);
+}
+/** Every operation `api call` accepts, in registry order. */
+export function cliOperations(commandFor) {
+    return API_CLIENT_OPERATIONS.filter(isCliCallable).map((operation) => ({
+        operation_id: operation.operationId,
+        method: operation.method,
+        path: operation.path,
+        path_parameters: pathParameters(operation.path),
+        query_parameters: isTabled(operation.operationId)
+            ? QUERY_PARAMETERS[operation.operationId]
+            : [],
+        body: operation.method !== "GET",
+        command: commandFor(operation.operationId),
+    }));
+}
+function distance(a, b) {
+    let previous = Array.from({ length: b.length + 1 }, (_, index) => index);
+    for (let i = 1; i <= a.length; i++) {
+        const current = [i];
+        for (let j = 1; j <= b.length; j++) {
+            const substitution = (previous[j - 1] ?? 0) + (a[i - 1] === b[j - 1] ? 0 : 1);
+            current.push(Math.min((previous[j] ?? 0) + 1, (current[j - 1] ?? 0) + 1, substitution));
+        }
+        previous = current;
+    }
+    return previous[b.length] ?? 0;
+}
+// `getGames` should find `listGames`, whose noun matches, as well as `getGame`.
+const VERB = /^(get|list|search|explore|batch|fetch|read|show)(?=[A-Z])/;
+function noun(id) {
+    return id.replace(VERB, "").toLowerCase();
+}
+/** Up to 3 callable ids closest to an unknown one, nearest first. */
+export function suggestOperations(input, candidates) {
+    const wanted = input.toLowerCase();
+    const wantedNoun = noun(input);
+    return candidates
+        .map((id) => ({
+        id,
+        score: Math.min(distance(wanted, id.toLowerCase()), distance(wantedNoun, noun(id))),
+    }))
+        .filter(({ score }) => score <= Math.max(2, Math.floor(wanted.length / 4)))
+        .sort((a, b) => a.score - b.score || a.id.localeCompare(b.id))
+        .slice(0, 3)
+        .map(({ id }) => id);
+}
+//# sourceMappingURL=operations.js.map

package/dist/product-cli/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../src/product-cli/operations.ts"],"names":[],"mappings":"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"}

package/dist/prompts/index.js

@@ -11,13 +11,13 @@ export function registerPrompts(server) {
                 role: "user",
                 content: {
                     type: "text",
-                    text: `Analyze the prediction market trader identified by ${address}. Use the get_trader tool with all expand fields (strategy, categories, quant_metrics) to get comprehensive data.
+                    text: `Analyze the prediction market trader identified by ${address}. Use the get_trader tool with the strategy and categories expand fields to get comprehensive data.
 
 Provide:
 1. **Overview** — Grade, score, rank, and what tier they fall in
 2. **P&L Analysis** — Total, realized vs unrealized, recent trends (7d/30d)
 3. **Strategy** — What type of trader they are and how they operate
-4. **Risk Profile** — copy_score and smart_score (0-100), Sharpe (7d/30d), profit_factor, and edge_consistency interpretation
+4. **Risk Profile** — the sports and esports record in pnl.in_scope (realized P&L, settled markets, win rate) and what it says about consistency
 5. **Category Strengths** — Where they perform best/worst
 6. **Key Takeaway** — One-paragraph summary of whether this trader is worth following and why`,
                 },

package/dist/sdk/client.d.ts

@@ -115,7 +115,9 @@ export interface ApiUnsupportedOperation {
  * `scripts/check-sdk-openapi-drift.mjs`, which also checks every row's kind
  * against the spec. Do not add a row without a matching spec operation, and
  * do not remove a spec operation without removing its row. A redirect-only
- * operation belongs in `REDIRECT_OPERATIONS` below, not here.
+ * operation belongs in `REDIRECT_OPERATIONS` below, not here, and a
+ * deprecated alias this client no longer wraps belongs in
+ * `UNSUPPORTED_OPERATIONS` (#29350).
  */
 export declare const API_CLIENT_OPERATIONS: readonly [{
     readonly method: "GET";
@@ -273,36 +275,11 @@ export declare const API_CLIENT_OPERATIONS: readonly [{
     readonly path: "/api/v1/large-trades/{id}";
     readonly operationId: "getLargeTrade";
     readonly auth: "bearer";
-}, {
-    readonly method: "GET";
-    readonly path: "/api/v1/whale-trades";
-    readonly operationId: "listWhaleTrades";
-    readonly auth: "bearer";
-}, {
-    readonly method: "GET";
-    readonly path: "/api/v1/whale-trades/history";
-    readonly operationId: "listWhaleTradeHistory";
-    readonly auth: "bearer";
-}, {
-    readonly method: "GET";
-    readonly path: "/api/v1/whale-trades/{id}/counterparties/executions";
-    readonly operationId: "listWhaleTradeCounterpartyExecutions";
-    readonly auth: "bearer";
-}, {
-    readonly method: "GET";
-    readonly path: "/api/v1/whale-trades/{id}/counterparties/executions/{execution_id}/makers";
-    readonly operationId: "listWhaleTradeCounterpartyMakers";
-    readonly auth: "bearer";
 }, {
     readonly method: "GET";
     readonly path: "/api/v1/content/search";
     readonly operationId: "searchContent";
     readonly auth: "bearer";
-}, {
-    readonly method: "GET";
-    readonly path: "/api/v1/whale-trades/{id}";
-    readonly operationId: "getWhaleTrade";
-    readonly auth: "bearer";
 }, {
     readonly method: "GET";
     readonly path: "/api/v1/leaderboard";
@@ -318,11 +295,6 @@ export declare const API_CLIENT_OPERATIONS: readonly [{
     readonly path: "/api/v1/markets/explore";
     readonly operationId: "exploreMarkets";
     readonly auth: "bearer";
-}, {
-    readonly method: "GET";
-    readonly path: "/api/v1/markets/smart-money-flows";
-    readonly operationId: "listSmartMoneyFlows";
-    readonly auth: "bearer";
 }, {
     readonly method: "GET";
     readonly path: "/api/v1/markets/sharp-money-flows";
@@ -333,11 +305,6 @@ export declare const API_CLIENT_OPERATIONS: readonly [{
     readonly path: "/api/v1/coverage";
     readonly operationId: "getCoverage";
     readonly auth: "none";
-}, {
-    readonly method: "GET";
-    readonly path: "/api/v1/platforms";
-    readonly operationId: "getPlatforms";
-    readonly auth: "none";
 }, {
     readonly method: "GET";
     readonly path: "/api/v1/market/{condition_id}/holders";
@@ -348,21 +315,11 @@ export declare const API_CLIENT_OPERATIONS: readonly [{
     readonly path: "/api/v1/market/{condition_id}/flow";
     readonly operationId: "getMarketFlow";
     readonly auth: "bearer";
-}, {
-    readonly method: "GET";
-    readonly path: "/api/v1/market/{condition_id}/intel";
-    readonly operationId: "getMarketIntel";
-    readonly auth: "bearer";
 }, {
     readonly method: "POST";
     readonly path: "/api/v1/markets/flow/batch";
     readonly operationId: "batchGetMarketFlow";
     readonly auth: "bearer";
-}, {
-    readonly method: "POST";
-    readonly path: "/api/v1/markets/intel/batch";
-    readonly operationId: "batchGetMarketIntel";
-    readonly auth: "bearer";
 }, {
     readonly method: "GET";
     readonly path: "/api/v1/market/{condition_id}/snapshot";
@@ -389,16 +346,6 @@ export declare const API_CLIENT_OPERATIONS: readonly [{
     readonly path: "/api/v1/suspicious-trades/{id}";
     readonly operationId: "getSuspiciousTrade";
     readonly auth: "bearer";
-}, {
-    readonly method: "GET";
-    readonly path: "/api/v1/insider-radar";
-    readonly operationId: "listInsiderRadar";
-    readonly auth: "bearer";
-}, {
-    readonly method: "GET";
-    readonly path: "/api/v1/insider-radar/{id}";
-    readonly operationId: "getInsiderRadarFlag";
-    readonly auth: "bearer";
 }, {
     readonly method: "GET";
     readonly path: "/api/v1/events/feed/since";
@@ -597,9 +544,67 @@ export declare const REDIRECT_OPERATIONS: readonly [{
 /**
  * Published operations this client deliberately does not wrap, with the
  * reason. The drift check requires every remaining spec operation to be
- * accounted for here, so "unsupported" is always a stated decision.
+ * accounted for here, so "unsupported" is always a stated decision. An
+ * operation that still answers 200 may appear here only while the spec marks
+ * it `deprecated`: 0.32.0 dropped the September rename aliases (#29350), whose
+ * paths stay live until their 2027-02-01 sunset (#29351).
  */
 export declare const UNSUPPORTED_OPERATIONS: readonly [{
+    readonly method: "GET";
+    readonly path: "/api/v1/whale-trades";
+    readonly operationId: "listWhaleTrades";
+    readonly reason: "Deprecated alias (#16304), sunset 2027-02-01: use listLargeTrades().";
+}, {
+    readonly method: "GET";
+    readonly path: "/api/v1/whale-trades/history";
+    readonly operationId: "listWhaleTradeHistory";
+    readonly reason: "Deprecated alias (#16304), sunset 2027-02-01: use listLargeTradeHistory().";
+}, {
+    readonly method: "GET";
+    readonly path: "/api/v1/whale-trades/{id}";
+    readonly operationId: "getWhaleTrade";
+    readonly reason: "Deprecated alias (#16304), sunset 2027-02-01: use getLargeTrade().";
+}, {
+    readonly method: "GET";
+    readonly path: "/api/v1/whale-trades/{id}/counterparties/executions";
+    readonly operationId: "listWhaleTradeCounterpartyExecutions";
+    readonly reason: 'Deprecated alias (#16304), sunset 2027-02-01: use call("listLargeTradeCounterpartyExecutions").';
+}, {
+    readonly method: "GET";
+    readonly path: "/api/v1/whale-trades/{id}/counterparties/executions/{execution_id}/makers";
+    readonly operationId: "listWhaleTradeCounterpartyMakers";
+    readonly reason: 'Deprecated alias (#16304), sunset 2027-02-01: use call("listLargeTradeCounterpartyMakers").';
+}, {
+    readonly method: "GET";
+    readonly path: "/api/v1/markets/smart-money-flows";
+    readonly operationId: "listSmartMoneyFlows";
+    readonly reason: "Deprecated alias (#16308), sunset 2027-02-01: use listSharpMoneyFlows().";
+}, {
+    readonly method: "GET";
+    readonly path: "/api/v1/platforms";
+    readonly operationId: "getPlatforms";
+    readonly reason: "Deprecated alias (#16315), sunset 2027-02-01: use getCoverage().";
+}, {
+    readonly method: "GET";
+    readonly path: "/api/v1/market/{condition_id}/intel";
+    readonly operationId: "getMarketIntel";
+    readonly reason: "Deprecated alias (#16312), sunset 2027-02-01: use getMarketFlow().";
+}, {
+    readonly method: "POST";
+    readonly path: "/api/v1/markets/intel/batch";
+    readonly operationId: "batchGetMarketIntel";
+    readonly reason: "Deprecated alias (#16312), sunset 2027-02-01: use batchGetMarketFlow().";
+}, {
+    readonly method: "GET";
+    readonly path: "/api/v1/insider-radar";
+    readonly operationId: "listInsiderRadar";
+    readonly reason: "Deprecated alias (#16301), sunset 2027-02-01: use listSuspiciousTrades().";
+}, {
+    readonly method: "GET";
+    readonly path: "/api/v1/insider-radar/{id}";
+    readonly operationId: "getInsiderRadarFlag";
+    readonly reason: "Deprecated alias (#16301), sunset 2027-02-01: use getSuspiciousTrade().";
+}, {
     readonly method: "GET";
     readonly path: "/api/v1/sports/pre-game-sides";
     readonly operationId: "listPreGameSides";
@@ -640,15 +645,14 @@ export declare const IDEMPOTENT_WRITE_OPERATIONS: readonly ["createWebhookVerifi
 export type IdempotentWriteOperationId = (typeof IDEMPOTENT_WRITE_OPERATIONS)[number];
 /**
  * POST operations that read and never write (#16182): the batch lookups.
- * `POST /api/v1/traders/batch` and `POST /api/v1/markets/flow/batch` (with its
- * deprecated alias `POST /api/v1/markets/intel/batch`) resolve
+ * `POST /api/v1/traders/batch` and `POST /api/v1/markets/flow/batch` resolve
  * their inputs and store nothing (`backend/src/api_v1/handlers/batch.rs`), so
  * a repeat cannot duplicate a side effect. Each attempt is one request
  * against the account's quota and one reservation of batch item units, which
  * is exactly what a retried GET costs, so they are retried like a GET. Every
  * other POST, PATCH or DELETE is retried only as a keyed write above.
  */
-export declare const READ_ONLY_POST_OPERATIONS: readonly ["batchGetTraders", "batchGetMarketFlow", "batchGetMarketIntel"];
+export declare const READ_ONLY_POST_OPERATIONS: readonly ["batchGetTraders", "batchGetMarketFlow"];
 /**
  * Writes whose repeat converges on the state the first one reached, so a
  * retry cannot repeat a side effect and needs no `Idempotency-Key` (#16254).
@@ -807,9 +811,8 @@ export declare function assertTrustedBaseUrl(baseUrl: string): URL;
  */
 export declare function resolveApiUrl(baseUrl: string, path: string): URL;
 /**
- * One signal that aborts on the deadline OR when the caller's signal aborts.
- * Uses native composition where available. The manual fallback removes both
- * source listeners when either source aborts.
+ * One signal that aborts on the deadline OR when the caller's signal aborts,
+ * composed with `AbortSignal.any`, which every supported Node release has.
  */
 export declare function composeSignals(timeoutMs: number | null, caller?: AbortSignal): AbortSignal | undefined;
 /**
@@ -869,8 +872,12 @@ export type EdgeHunterBoardParams = EdgeHunterSelectionParams & Pick<OperationQu
 export type EdgeHunterSignalsParams = EdgeHunterSelectionParams & Pick<OperationQuery["getEdgeHunter"], "limit" | "cursor" | "horizon_hours" | "min_grade"> & {
     view: "signals";
 };
-/** Full observation evidence; cohort is required, including for empty pages. */
-export type EdgeHunterObservationsParams = EdgeHunterSelectionParams & Pick<OperationQuery["getEdgeHunter"], "limit" | "cursor"> & {
+/**
+ * Full observation evidence; cohort is required, including for empty pages.
+ * admission "most_held_48h" (cohort "wider_holder" only) opts in to the
+ * most-held selection; the read then requires the server to echo it.
+ */
+export type EdgeHunterObservationsParams = EdgeHunterSelectionParams & Pick<OperationQuery["getEdgeHunter"], "limit" | "cursor" | "admission"> & {
     view: "observations";
     cohort: NonNullable<OperationQuery["getEdgeHunter"]["cohort"]>;
 };
@@ -1109,7 +1116,7 @@ export interface ListParams {
     [key: string]: ApiQueryValue;
 }
 /** `GET /api/v1/leaderboard` -> parameters -> strategy (`web/public/api/v1/openapi.json`). */
-export declare const LEADERBOARD_STRATEGIES: readonly ["accumulator", "algo_trader", "arbitrageur", "category_focused", "directional", "diversified", "event_driven", "high_activity", "market_maker", "mixed", "momentum", "scalper", "speculator", "swing_trader", "two_sided", "unclassified"];
+export declare const LEADERBOARD_STRATEGIES: readonly ["category_focused", "diversified", "high_activity", "mixed", "two_sided", "unclassified"];
 export type LeaderboardStrategy = (typeof LEADERBOARD_STRATEGIES)[number];
 /**
  * Query parameters for `GET /api/v1/leaderboard`, from the operation
@@ -1124,27 +1131,16 @@ export type TrendingWalletsParams = OperationQuery["listTrendingWallets"];
 export type LargeTradeListParams = OperationQuery["listLargeTrades"];
 /** Query parameters of the V1 historical large-trade replay (#16304). */
 export type LargeTradeHistoryParams = OperationQuery["listLargeTradeHistory"];
-/** @deprecated Use {@link LargeTradeListParams} (#16304). */
-export type WhaleTradeListParams = OperationQuery["listWhaleTrades"];
-/** @deprecated Use {@link LargeTradeHistoryParams} (#16304). */
-export type WhaleTradeHistoryParams = OperationQuery["listWhaleTradeHistory"];
 /** Query parameters of `GET /api/v1/positions`. */
 export type PositionsListParams = OperationQuery["listPositions"];
 /** Query parameters of `GET /api/v1/combos/fills`. */
 export type ComboFillsParams = OperationQuery["listComboFills"];
 /** Query parameters of `GET /api/v1/large-positions`. */
 export type LargePositionsListParams = OperationQuery["listLargePositions"];
-/** Query parameters of the sharp-money flows read and its legacy alias. */
+/** Query parameters of `GET /api/v1/markets/sharp-money-flows`. */
 export type SharpMoneyFlowsParams = OperationQuery["listSharpMoneyFlows"];
 /** Query parameters of `GET /api/v1/suspicious-trades`: `min_suspicion` and `severity`, not a grade. */
 export type SuspiciousTradesListParams = OperationQuery["listSuspiciousTrades"];
-/**
- * @deprecated Use `SuspiciousTradesListParams`; the Insider Radar spelling of
- * this contract was renamed to suspicious trades in #16301. The deprecated
- * `GET /api/v1/insider-radar` takes the same parameters, so this stays an
- * alias with no retirement date.
- */
-export type InsiderRadarListParams = SuspiciousTradesListParams;
 /** Query parameters of `GET /api/v1/markets/explore`. */
 export type ExploreMarketsParams = OperationQuery["exploreMarkets"];
 /**
@@ -1386,12 +1382,6 @@ export declare class OxinsiderApiClient {
      * (`POST /api/v1/markets/flow/batch`); `meta` is the batch's own.
      */
     batchGetMarketFlow(body: OperationBody["batchGetMarketFlow"], options?: ConvenienceOptions): Promise<OperationResult<"batchGetMarketFlow">>;
-    /**
-     * @deprecated Use {@link batchGetMarketFlow} (#16312); calls the deprecated
-     * `POST /api/v1/markets/intel/batch`, whose envelope keeps
-     * `object: "market_intel_batch"`.
-     */
-    batchGetMarketIntel(body: OperationBody["batchGetMarketIntel"], options?: ConvenienceOptions): Promise<OperationResult<"batchGetMarketIntel">>;
     listLeaderboard(params?: LeaderboardListParams, options?: ConvenienceOptions): Promise<Omit<{
         object: "list";
         data: OperationData["listLeaderboard"];
@@ -1442,30 +1432,6 @@ export declare class OxinsiderApiClient {
     }, "meta"> & {
         meta: ClientMeta<import("./schema.js").LargeTradeHistoryMeta>;
     }>;
-    /** @deprecated Use {@link listLargeTrades} (#16304); calls the deprecated `/api/v1/whale-trades`. */
-    listWhaleTrades(params?: WhaleTradeListParams, options?: ConvenienceOptions): Promise<Omit<{
-        object: "list";
-        data: OperationData["listWhaleTrades"];
-        data_quality: import("./schema.js").DataQuality;
-        has_more: boolean;
-        next_cursor?: string;
-        total?: number;
-        meta: ResponseMeta;
-    }, "meta"> & {
-        meta: ClientMeta<ResponseMeta>;
-    }>;
-    /** @deprecated Use {@link listLargeTradeHistory} (#16304); calls the deprecated `/api/v1/whale-trades/history`. */
-    listWhaleTradeHistory(params?: WhaleTradeHistoryParams, options?: ConvenienceOptions): Promise<Omit<{
-        object: "list";
-        data: OperationData["listWhaleTradeHistory"];
-        data_quality: import("./schema.js").DataQuality;
-        has_more: boolean;
-        next_cursor?: string;
-        total?: number;
-        meta: import("./schema.js").LargeTradeHistoryMeta;
-    }, "meta"> & {
-        meta: ClientMeta<import("./schema.js").LargeTradeHistoryMeta>;
-    }>;
     listPositions(params?: PositionsListParams, options?: ConvenienceOptions): Promise<Omit<{
         object: "list";
         data: OperationData["listPositions"];
@@ -1506,21 +1472,6 @@ export declare class OxinsiderApiClient {
     }, "meta"> & {
         meta: ClientMeta<ResponseMeta>;
     }>;
-    /**
-     * @deprecated Use {@link listSharpMoneyFlows} (#16308). Kept live; it calls
-     * the deprecated `/api/v1/markets/smart-money-flows`, whose responses carry
-     * `Deprecation` and a `Link rel="successor-version"`.
-     */
-    listSmartMoneyFlows(params?: OperationQuery["listSmartMoneyFlows"], options?: ConvenienceOptions): Promise<Omit<{
-        object: "list";
-        data: OperationData["listSmartMoneyFlows"];
-        has_more: boolean;
-        next_cursor?: string;
-        total?: number;
-        meta: ResponseMeta;
-    }, "meta"> & {
-        meta: ClientMeta<ResponseMeta>;
-    }>;
     /**
      * List covered games: both sides with their provider ids and live scores, the
      * UTC kickoff, the provider's own status, and every linked Polymarket market
@@ -1584,18 +1535,12 @@ export declare class OxinsiderApiClient {
     }>;
     /** One market's flow and top positions (`GET /api/v1/market/{condition_id}/flow`). */
     getMarketFlow(conditionId: OperationPath["getMarketFlow"]["condition_id"], options?: Omit<OperationRequestOptions<"getMarketFlow">, "path">): Promise<OperationResult<"getMarketFlow">>;
-    /**
-     * @deprecated Use {@link getMarketFlow} (#16312); calls the deprecated
-     * `GET /api/v1/market/{condition_id}/intel`, whose envelope keeps
-     * `object: "market_intel"`.
-     */
-    getMarketIntel(conditionId: OperationPath["getMarketIntel"]["condition_id"], options?: Omit<OperationRequestOptions<"getMarketIntel">, "path">): Promise<OperationResult<"getMarketIntel">>;
     getMarketSnapshot(conditionId: OperationPath["getMarketSnapshot"]["condition_id"], options?: Omit<OperationRequestOptions<"getMarketSnapshot">, "path">): Promise<OperationResult<"getMarketSnapshot">>;
     /**
      * One page of a market's graded (S/A/B) holder roster from a complete
      * provider holder scan: the list a Pick of the Day shows, for any market.
      * `params.outcome` (`yes` | `no` | `all`), `params.min_grade` (`S` | `A` |
-     * `B`), `params.limit` and `params.cursor` (`mh_` prefix). The page carries
+     * `B`), `params.limit` and `params.cursor` (the previous page's opaque `next_cursor`). The page carries
      * the `market`, `scan` and roster `totals` beside `data`; `total` is the
      * count matching the filters across every page.
      */
@@ -1636,32 +1581,7 @@ export declare class OxinsiderApiClient {
     }, "meta"> & {
         meta: ClientMeta<ResponseMeta>;
     }>;
-    /**
-     * @deprecated Use `getSuspiciousTrade()`; renamed in #16301. This method
-     * keeps calling the deprecated `GET /api/v1/insider-radar/{id}`, which stays
-     * live with no retirement date and still answers `object: "radar_flag"`, so
-     * an integration branching on that envelope keeps working.
-     */
-    getInsiderRadarFlag(id: OperationPath["getInsiderRadarFlag"]["id"], options?: ConvenienceOptions): Promise<OperationResult<"getInsiderRadarFlag">>;
-    /**
-     * @deprecated Use `listSuspiciousTrades()`; renamed in #16301. This method
-     * keeps calling the deprecated `GET /api/v1/insider-radar`, which stays live
-     * with no retirement date and answers with `Deprecation` plus a `Link
-     * rel="successor-version"` header.
-     */
-    listInsiderRadar(params?: InsiderRadarListParams, options?: ConvenienceOptions): Promise<Omit<{
-        object: "list";
-        data: OperationData["listInsiderRadar"];
-        has_more: boolean;
-        next_cursor?: string;
-        total?: number;
-        meta: ResponseMeta;
-    }, "meta"> & {
-        meta: ClientMeta<ResponseMeta>;
-    }>;
     getLargeTrade(id: OperationPath["getLargeTrade"]["id"], options?: ConvenienceOptions): Promise<OperationResult<"getLargeTrade">>;
-    /** @deprecated Use {@link getLargeTrade} (#16304); calls the deprecated `/api/v1/whale-trades/{id}`. */
-    getWhaleTrade(id: OperationPath["getWhaleTrade"]["id"], options?: ConvenienceOptions): Promise<OperationResult<"getWhaleTrade">>;
     /**
      * Cancel a submitted export (`POST /api/v1/trader/{address}/export/cancel`, #16254).
      *
@@ -1734,11 +1654,6 @@ export declare class OxinsiderApiClient {
      * Public: needs no API key.
      */
     getCoverage(options?: ConvenienceOptions): Promise<OperationResult<"getCoverage">>;
-    /**
-     * @deprecated Use {@link getCoverage} (#16315); calls the deprecated
-     * `GET /api/v1/platforms`, which serves the same body.
-     */
-    getPlatforms(options?: ConvenienceOptions): Promise<OperationResult<"getPlatforms">>;
     getAccountIdentity(options?: ConvenienceOptions): Promise<OperationResult<"getAccountIdentity">>;
     /**
      * One wallet's context as Markdown, ready to paste into a model prompt