@0xinsider/mcp 3.5.0 → 3.6.1

package/README.md

@@ -37,6 +37,17 @@ as are the official Rust client ([`0xinsider-rust`](https://github.com/0xinsider
 crate `oxinsider`) and the Node.js and TypeScript client
 ([`0xinsider-node`](https://github.com/0xinsider/0xinsider-node), `@0xinsider/sdk`).
 
+## Pick of the Day
+
+`get_pick_of_the_day` and its archive use the account's published access. Pro opens
+five selections in total: the designated free selection plus the first four other
+selections in publication order. Max opens every available daily selection, up to
+twenty. Use each stable `pick_id` and preserve the returned order.
+
+For an automated entry from a current pick, require a matching, unexpired returned
+authorization and honor its maximum price and any stricter local limits. Quote a
+current executable book for the actual stake. An authorization does not guarantee a fill.
+
 ## Upgrade to 3.5.0
 
 Version 3.5 adds ten tools for `/api/v1` reads that had none:
@@ -249,6 +260,8 @@ Any client that supports stdio transport:
 
 Set `OXINSIDER_API_KEY` in the process environment before starting the stdio server. Do not pass the key as a command-line argument.
 
+The stdio server answers each client in the protocol revision it opens with: the `2026-07-28` revision, or, as before, an `initialize` handshake at any revision from `2024-10-07` through `2025-11-25`.
+
 Need the command list? Run:
 
 ```bash

package/dist/constants.d.ts

@@ -1,7 +1,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 VERSION = "3.5.0";
+export declare const VERSION = "3.6.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.js

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

package/dist/prompts/index.d.ts

@@ -1,3 +1,3 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer } from "@modelcontextprotocol/server";
 export declare function registerPrompts(server: McpServer): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoHvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAGzD,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoHvD"}

package/dist/prompts/index.js

@@ -3,9 +3,9 @@ export function registerPrompts(server) {
     server.registerPrompt("analyze_trader", {
         title: "Analyze Trader",
         description: "Deep analysis of a prediction market trader — performance, strategy, risk profile, and actionable insights",
-        argsSchema: {
+        argsSchema: z.object({
             address: z.string().describe("Ethereum wallet address (0x...) or trader username"),
-        },
+        }),
     }, ({ address }) => ({
         messages: [{
                 role: "user",
@@ -26,9 +26,9 @@ Provide:
     server.registerPrompt("market_report", {
         title: "Market Report",
         description: "Sharp money flow report for a prediction market — who's buying, who's selling, and what it means",
-        argsSchema: {
+        argsSchema: z.object({
             query: z.string().describe("Market name or topic to search for"),
-        },
+        }),
     }, ({ query }) => ({
         messages: [{
                 role: "user",
@@ -87,12 +87,12 @@ Present findings as:
     server.registerPrompt("market_review", {
         title: "Market Review",
         description: marketReviewDescription,
-        argsSchema: marketReviewArgs,
+        argsSchema: z.object(marketReviewArgs),
     }, marketReview);
     server.registerPrompt("trading_signals", {
         title: "Market Review (deprecated alias)",
         description: `Deprecated alias of market_review (#16311), kept live. ${marketReviewDescription}`,
-        argsSchema: marketReviewArgs,
+        argsSchema: z.object(marketReviewArgs),
     }, marketReview);
 }
 //# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,MAAM,CAAC,cAAc,CACnB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,4GAA4G;QACzH,UAAU,EAAE;YACV,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;SACnF;KACF,EACD,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAChB,QAAQ,EAAE,CAAC;gBACT,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,sDAAsD,OAAO;;;;;;;;8FAQiB;iBACrF;aACF,CAAC;KACH,CAAC,CACH,CAAC;IAEF,MAAM,CAAC,cAAc,CACnB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,kGAAkG;QAC/G,UAAU,EAAE;YACV,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;SACjE;KACF,EACD,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE,CAAC;gBACT,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kEAAkE,KAAK;;;;;;;;;;;;wHAYiC;iBAC/G;aACF,CAAC;KACH,CAAC,CACH,CAAC;IAEF,6EAA6E;IAC7E,yEAAyE;IACzE,4EAA4E;IAC5E,yCAAyC;IACzC,MAAM,gBAAgB,GAAG;QACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2FAA2F,CAAC;QACnI,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;KAC/G,CAAC;IACF,MAAM,uBAAuB,GAC3B,4EAA4E,CAAC;IAC/E,MAAM,YAAY,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAiD,EAAE,EAAE;QAC3F,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,mCAAmC,MAAM,GAAG,CAAC,CAAC,CAAC,oCAAoC,CAAC;QAC7G,MAAM,cAAc,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,QAAQ,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,OAAO;YACL,QAAQ,EAAE,CAAC;oBACT,IAAI,EAAE,MAAe;oBACrB,OAAO,EAAE;wBACP,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,UAAU,OAAO,GAAG,cAAc;;;KAG7C,MAAM,CAAC,CAAC,CAAC,uCAAuC,CAAC,CAAC,CAAC,gDAAgD,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,QAAQ,WAAW,CAAC,CAAC,CAAC,EAAE;;8CAE3G,QAAQ,CAAC,CAAC,CAAC,kBAAkB,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE;;;;;;;yGAOc;qBAChG;iBACF,CAAC;SACH,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,CAAC,cAAc,CACnB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,uBAAuB;QACpC,UAAU,EAAE,gBAAgB;KAC7B,EACD,YAAY,CACb,CAAC;IAEF,MAAM,CAAC,cAAc,CACnB,iBAAiB,EACjB;QACE,KAAK,EAAE,kCAAkC;QACzC,WAAW,EAAE,0DAA0D,uBAAuB,EAAE;QAChG,UAAU,EAAE,gBAAgB;KAC7B,EACD,YAAY,CACb,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"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"}

package/dist/resources/index.d.ts

@@ -1,4 +1,4 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer } from "@modelcontextprotocol/server";
 import { ApiClient } from "../client.js";
 export declare function registerResources(server: McpServer, client: ApiClient): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EACL,SAAS,EAIV,MAAM,cAAc,CAAC;AAmBtB,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAmL5E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,EACL,SAAS,EAIV,MAAM,cAAc,CAAC;AAmBtB,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAmL5E"}

package/dist/resources/index.js

@@ -16,8 +16,8 @@ export function registerResources(server, client) {
     server.registerResource("api-docs", "oxinsider://docs/api", {
         description: "Complete 0xinsider API reference — endpoints, authentication, rate limits, response format",
         mimeType: "text/markdown",
-    }, async (_uri, extra) => {
-        const signal = composeSignals(DEFAULT_REQUEST_TIMEOUT_MS, extra.signal);
+    }, async (_uri, ctx) => {
+        const signal = composeSignals(DEFAULT_REQUEST_TIMEOUT_MS, ctx.mcpReq.signal);
         let response;
         try {
             response = await fetch(`${SITE_URL}/llms-full.txt`, signal === undefined ? {} : { signal });
@@ -53,7 +53,7 @@ export function registerResources(server, client) {
                     {
                         uri: "oxinsider://docs/api",
                         mimeType: "text/plain",
-                        text: documentationReadError(error, signal, extra.signal, response?.status),
+                        text: documentationReadError(error, signal, ctx.mcpReq.signal, response?.status),
                     },
                 ],
             };
@@ -63,8 +63,8 @@ export function registerResources(server, client) {
     server.registerResource("agent-instructions", "oxinsider://docs/agents", {
         description: "Decision tree and best practices for AI agents using the 0xinsider API",
         mimeType: "text/markdown",
-    }, async (_uri, extra) => {
-        const signal = composeSignals(DEFAULT_REQUEST_TIMEOUT_MS, extra.signal);
+    }, async (_uri, ctx) => {
+        const signal = composeSignals(DEFAULT_REQUEST_TIMEOUT_MS, ctx.mcpReq.signal);
         let response;
         try {
             response = await fetch(`${SITE_URL}/agents.md`, signal === undefined ? {} : { signal });
@@ -100,7 +100,7 @@ export function registerResources(server, client) {
                     {
                         uri: "oxinsider://docs/agents",
                         mimeType: "text/plain",
-                        text: documentationReadError(error, signal, extra.signal, response?.status),
+                        text: documentationReadError(error, signal, ctx.mcpReq.signal, response?.status),
                     },
                 ],
             };
@@ -110,10 +110,10 @@ export function registerResources(server, client) {
     server.registerResource("leaderboard", "oxinsider://data/leaderboard", {
         description: "Current top 20 prediction market traders by composite score (grades S/A/B)",
         mimeType: "application/json",
-    }, async (_uri, extra) => {
+    }, async (_uri, ctx) => {
         try {
             const response = await client.request("/api/v1/leaderboard", { limit: 20 }, undefined, {
-                signal: extra.signal,
+                signal: ctx.mcpReq.signal,
             });
             return {
                 contents: [
@@ -142,10 +142,10 @@ export function registerResources(server, client) {
     server.registerResource("whale-trades", "oxinsider://data/whale-trades", {
         description: "Latest 20 whale trades (>$5000) from graded prediction market traders",
         mimeType: "application/json",
-    }, async (_uri, extra) => {
+    }, async (_uri, ctx) => {
         try {
             const response = await client.request("/api/v1/whale-trades", { limit: 20 }, undefined, {
-                signal: extra.signal,
+                signal: ctx.mcpReq.signal,
             });
             return {
                 contents: [

package/dist/resources/index.js.map

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

package/dist/sdk/client.d.ts

@@ -1604,7 +1604,7 @@ export declare class OxinsiderApiClient {
         data: OperationData["getMarketHolders"];
         has_more: boolean;
         next_cursor?: string;
-        total?: number;
+        total: number;
         market: import("./schema.js").MarketHoldersMarket;
         scan: import("./schema.js").MarketHoldersScan;
         totals: import("./schema.js").MarketHoldersTotals;

package/dist/sdk/schema.d.ts

@@ -87,7 +87,7 @@ export type ApiErrorBody = {
     message: string;
     doc_url?: string;
     param?: string;
-    /** The recommended next retry instant (RFC3339). Present on every retryable error (reason=pick_not_released, code=rate_limited including reason=monthly_quota_exceeded, code=rate_limit_unavailable, reason=read_model_warming) and omitted otherwise. Always in the future. For pick_not_released: before the 03:00 America/New_York operating-window start, before a selected pick's stored release, or after a skipped day, it names the automatic system's next boundary. While no candidate exists in the live window it normally names the persisted next automatic selector attempt. Every value is advisory and can change before release. When the automatic schedule is absent/due or a pick is overdue it degrades to ~60s. Schedule one request and do not poll. Prefer Retry-After for the duration because it is immune to client clock skew. */
+    /** The recommended next retry instant (RFC3339). Present on every retryable error (reason=pick_not_released, code=rate_limited including reason=monthly_quota_exceeded, code=rate_limit_unavailable, reason=read_model_warming) and omitted otherwise. Always in the future. For pick_not_released, the recommendation is advisory and can change before a pick becomes available. Schedule the next request from the returned value instead of inferring a release schedule or polling. Prefer Retry-After for the duration because it is immune to client clock skew. */
     retry_at?: string;
     freshness?: FreshnessFailure;
     /** ADDITIVE (#7209). The specific, actionable cause behind `code`, when there is one more specific than the code itself. `code` keeps its published values, so existing clients are unaffected; new clients branch on `reason`. Omitted when the code already says everything we know. pick_not_released: no Pick of the Day is published for the current product day; schedule one request against retry_at instead of polling. unknown_endpoint: the PATH is not a route on this API -- read GET /api/v1, do not retry. trader_not_tracked: the wallet is real and the URL is right, but the trader is not on the warm sync tier (the wallets we sync most often) -- stop asking for this wallet. cursor_expired: pagination went stale mid-walk -- re-request the first page and continue. read_model_warming: the requested endpoint cannot serve its read model yet; exact causes are endpoint-specific and can include a cold or contended refresh or a dependency that prevented refresh. database_unavailable: the API's database or its connection pool is temporarily unreachable (a connection-class failure, not a query fault); code stays rate_limit_unavailable, nothing is rate-limited, retry after Retry-After / retry_at. idempotency_in_progress: retain the exact Idempotency-Key and request body, then retry shortly. webhook_delivery_in_progress: retry the URL or signing-secret configuration change after the destination's active request completes. request_accounting_unavailable: accounting capacity is unavailable before the handler executes; retry after Retry-After / retry_at. sandbox_api_key: the credential is a sandbox key (oxi_sk_test_) from POST /api/v1/agents/register, which only the sandbox server accepts -- call the sandbox base URL with it, or get a live key or OAuth access token; do not retry it here. api_key_in_query: the key was sent as a ?token= query parameter, which no route reads because URLs land in logs and history; the key itself was not checked -- resend it as Authorization: Bearer. subscription_inactive: the key is valid but the account's Pro subscription has lapsed (402 subscription_required); permanent until a person reactivates at https://0xinsider.com/billing, which the message names -- stop retrying on a schedule and surface the link. The key owner is emailed once per lapse. monthly_quota_exceeded: the account has used the requests its plan includes for the UTC calendar month (429 rate_limited); retry_at and Retry-After name the first of next month, the only retry that can succeed, and the message names https://0xinsider.com/developers, where pay as you go for requests over the quota is turned on. The X-Monthly-Quota-Limit, X-Monthly-Quota-Remaining and X-Monthly-Quota-Reset headers on every authenticated response say how close the account is. invalid_query, invalid_path, invalid_body (400 bad_request, #16146): a query parameter, a path segment or the JSON body did not parse or does not fit the route's schema, so no handler ran; param names the field when the parser named one (a query key, a path segment, a JSON path such as traders[0], or body); fix the request, never retry it as sent. unsupported_media_type (415 bad_request, param content-type): send the body with Content-Type: application/json. payload_too_large (413 bad_request, param body): the body is over 1048576 bytes. method_not_allowed (405 bad_request): the path is a route but not with this method; the Allow header names the methods it serves. ip_rate_limited (429 rate_limited, #16380): the per-address budget every caller behind one IP shares, counted before authentication, is spent; not the key's own window, and the RateLimit-* headers describe that bucket. ip_throttled (429 rate_limited): the address is in a cooldown after sustained over-limit traffic; Retry-After is minutes to days, and a request before it does not shorten the cooldown. max_plan_required (403 forbidden, #23085): the key is valid and its account is on Pro, but the route is part of Max (GET /api/v1/edge-hunter); every Pro route keeps working with the same key, so do not disable it. The message names https://0xinsider.com/pricing, where the account upgrades; a retry never clears it. endpoint_retired (410): this legacy sports endpoint no longer serves data. Migrate to GET /api/v1/edge-hunter; retrying the retired path cannot succeed. */
@@ -1933,7 +1933,7 @@ export type PickHolder = {
     /** The wallet's X handle from its Polymarket profile, normalized to 1-15 characters of [A-Za-z0-9_] with no `@`. Link it as `https://x.com/<handle>`. Stamped at serve time from the wallet's current trader record, never frozen with the pick. The five badge fields are present together, and only for a wallet that carries at least one badge; all absent means no badge, or a body cached before the fields shipped. */
     x_username?: string | null;
 };
-/** Recorded lead wallet facts, available only on full newly certified picks. Position and category history are frozen at publication; they are not live balances or pick win probabilities. */
+/** Recorded lead wallet facts on a full response when available. Position and category history are frozen at publication; they are not live balances or pick win probabilities. */
 export type PickLeadBacker = {
     /** Lead trader wallet address. */
     address: string;
@@ -1988,7 +1988,7 @@ export type PickOfTheDay = {
     display_category?: string;
     /** Provider platform. Always polymarket. */
     platform?: "polymarket";
-    /** The pick's stored release instant. Qualified automatic selections are due immediately; explicitly scheduled selections retain their stored time. Final checks, worker or claim delay can make the actual publication later. */
+    /** The pick's stored release instant. Use the returned timestamp; published_at records when publication occurred. */
     release_at?: string;
     /** True only before the pick's stored release instant (a pre-release embargo flag); effectively always false on a served, already-published pick. To detect that the backed game has kicked off, use `game_started`. */
     is_locked?: boolean;
@@ -2058,7 +2058,7 @@ export type PickOfTheDay = {
     sharp_pct?: number;
     /** Recorded market-implied probability as a 0..1 fraction when available. */
     market_pct?: number;
-    /** Optional legacy recorded specialist facts. These describe the trader and do not disclose selection decisions. Present only on a full response when available; newly certified picks use lead_backer instead. */
+    /** Optional recorded specialist facts on a full response. These describe the trader, not the pick's win probability. Omitted when no recorded specialist is available. */
     qualifying_expert?: {
         /** Trader wallet address. */
         address: string;
@@ -2081,15 +2081,15 @@ export type PickOfTheDay = {
     };
     /** Public V1 S/A wallet count on the backed side, equal to sharp_wallet_count. */
     traders?: number;
-    /** Recorded backed-side position value in USD when available. Newly certified picks sum only publication-certified wallet positions; legacy rows retain their recorded value. */
+    /** Recorded aggregate backed-side position value in USD when available, not a live balance or entry cost. The display_holders roster can include additional wallets; use the returned aggregate rather than summing that roster. */
     backed_sharp_usd?: number;
-    /** Bounded S/A holder display projection. Newly certified picks include only publication-certified wallets; historical rows retain their recorded display shape. */
+    /** Bounded S/A holder display projection from the recorded snapshot. Historical rows retain their recorded display shape. */
     holders?: PickHolder[];
-    /** Optional complete holder display roster. Newly certified picks list the recorded lead first, then any verified supporters, then the other graded wallets that held the backed side at publication, ordered by shares; only the lead and supporters are verified, the other rows are gross holdings that may also hold the other side and are not counted in the wallet counts, holder_count or backed_sharp_usd. Legacy rows retain their recorded display shape. */
+    /** Optional recorded holder roster in display order, with lead_backer first when present. Preserve the returned order. The roster can include wallets outside the recorded count and aggregate fields; do not derive holder_count, wallet counts or backed_sharp_usd from its length or a sum. Position values are gross holdings on the backed outcome and can coexist with holdings on the other outcome. Historical rows retain their recorded display shape. */
     display_holders?: PickHolder[];
     /** S/A holder count for the public V1 compatibility projection. display_holders can include additional grades. */
     holder_count?: number;
-    /** Required truthful thesis. With at least one profitable-wallet holder: Profitable wallets hold {pick_outcome_label}[, led by a grade-{top_grade} trader]. Without holder backing: 0xInsider's Pick of the Day is {pick_outcome_label}. Wallet counts are not appended. */
+    /** Display-ready explanation of the recorded pick. Render the returned text rather than reconstructing it from holder counts or grades. */
     thesis?: string;
     /** Canonical web market URL. */
     market_url?: string;
@@ -2163,11 +2163,11 @@ export type PickOfTheDayArchiveEntry = {
      * @deprecated
      */
     pick_rank: number;
-    /** When this selection was published, as RFC3339 UTC. Use this instant for publication feeds and timelines; pick_date is the America/New_York product day, not a publication timestamp. Automatic picks publish from 03:00 America/New_York on pick_date. Absent only for historical rows whose publication instant is unknown. */
+    /** When this selection was published, as RFC3339 UTC. Use this instant for publication feeds and timelines; pick_date is the America/New_York product day, not a publication timestamp. Absent only for historical rows whose publication instant is unknown. */
     published_at?: string;
     /** Human-readable matchup (e.g. "Portugal vs. Uzbekistan"). */
     matchup?: string;
-    /** Frozen canonical calibration/report bucket (e.g. "Basketball", "MMA", or "Soccer"). Existing semantics are unchanged; presentation consumers should prefer display_category when present. */
+    /** Frozen canonical sport bucket (e.g. "Basketball", "MMA", or "Soccer"). Existing semantics are unchanged; presentation consumers should prefer display_category when present. */
     category?: string;
     /** Frozen public presentation category. Tennis uses the provider-verified ATP or WTA tour, including Wimbledon and doubles; unknown tours retain Tennis. Every men's and women's cricket competition uses Cricket. Other sports use the curated league, esports title or soccer competition label, then the provider series name without its season year, then category when no competition is known. The canonical category and measured cohort are unchanged: an esports title still uses the pooled Esports category. Optional for mixed-version client compatibility. */
     display_category?: string;
@@ -2175,7 +2175,7 @@ export type PickOfTheDayArchiveEntry = {
     image_url?: string;
     /** The backed side's outcome label. Omitted for a still-pending pick when the request is not from an authenticated Pro key. */
     pick_outcome_label?: string;
-    /** Best public V1-compatible S/A sharp-money grade on the backed side; a current B-only grade is omitted by the stable V1 adapter, while historical rows retain their frozen policy's grade. Omitted when no sharp-money wallet backs the pick, when a pending legacy proof has not yet upgraded, or when the stored holder policy is unknown-future or structurally invalid. Resolved legacy history remains supported. */
+    /** Recorded top grade on the backed side in the public V1 compatibility projection. Omitted when unavailable. Historical values remain recorded snapshots. */
     top_grade?: string;
     /** Settlement outcome of the backed side; 'pending' until the market resolves. */
     outcome: "pending" | "win" | "loss" | "void";
@@ -2387,7 +2387,7 @@ export type PickOfTheDayLedgerOpenedEntry = {
     outcome: "win" | "loss" | "void";
     /** Frozen matchup, for a reader. */
     matchup: string;
-    /** Frozen canonical sport bucket used for selection calibration (Basketball, MMA), not the exact public league identity; the archive owns that. */
+    /** Frozen canonical sport bucket (for example Basketball or MMA), not the exact public league identity; the archive owns that. */
     category: string;
     /** The pick's public page. */
     permalink: string;
@@ -2453,7 +2453,7 @@ export type PickOfTheDayLedgerUncommittedEntry = {
     outcome: "pending" | "win" | "loss" | "void";
     /** Frozen matchup, for a reader. */
     matchup?: string;
-    /** Frozen canonical sport bucket used for selection calibration (Basketball, MMA), not the exact public league identity; the archive owns that. */
+    /** Frozen canonical sport bucket (for example Basketball or MMA), not the exact public league identity; the archive owns that. */
     category?: string;
     /** When outcome was LAST written to a settled value, or null when that instant is unknown. It moves with a corrected market re-mapping an already-settled pick, while commitment_hash stays untouched -- which is how a mirror that keeps history sees a correction. */
     resolved_at: string | null;
@@ -2702,11 +2702,11 @@ export type PositionTimelineEvent = {
     /** Cumulative buy-weighted average of stored fills for this outcome, including older pages; not provider current-position avgPrice. Sells do not change this value. 0 when no stored buys have occurred yet. */
     running_avg_price: number;
 };
-/** Returned entry permission bound to the named market, token and outcome. New policy-8 grants allow five cents above the first reference ask, capped at 85 cents and floored to the provider tick; policy-7 grants retain their original two-cent allowance. Honor the immutable max_entry_price and expires_at, and quote a current executable book for the actual stake. The submitted order price must remain within the limit; fills may be lower. Fees are separate, and this grant does not guarantee liquidity, execution or positive expected value. */
+/** Returned entry permission bound to the named market, token and outcome. Honor the immutable max_entry_price and expires_at, and quote a current executable book for the actual stake. The submitted order price must remain within the returned limit; fills may be lower. Fees are separate, and this grant does not guarantee liquidity, execution or positive expected value. */
 export type PotdEntryAuthorization = {
     version: 1;
     authorization_id: string;
-    /** Entry allowance policy, independent of selection or feed policy. Policy 8 issues new grants at the first reference ask plus 0.05, capped at 0.85 and floored to the provider tick. Policy 7 retains its original plus-0.02 grant. Existing grants never rise or extend. */
+    /** Identifier for the policy recorded with this authorization. It does not replace the returned max_entry_price or expires_at. Existing grants retain their recorded values. */
     policy_version: 7 | 8;
     condition_id: string;
     token_id: string;
@@ -2717,12 +2717,12 @@ export type PotdEntryAuthorization = {
     canonical_event_id: string;
     /** Maximum authorized order price as an exact decimal string, excluding fees. Quote a current executable book for the actual stake and keep the submitted order price at or below this bound. Actual fills may be lower; this limit does not guarantee a fill or define fair probability. */
     max_entry_price: string;
-    /** Selected-token best ask at first issuance. The entry allowance uses this immutable reference, not the published pick price or a later quote. */
+    /** Selected-token best ask from the recorded reference book at issuance. This is a reference quote, not the authorized order-price limit; use max_entry_price for that limit. */
     reference_best_ask: string;
     reference_book_hash: string;
     reference_book_at: string;
     issued_at: string;
-    /** Original authorization expiry at the earlier requested or provider kickoff; never extended. An expired authorization cannot authorize a new automated entry. */
+    /** Authorization expiry timestamp. Existing grants do not extend; an expired authorization cannot authorize a new automated entry. */
     expires_at: string;
 };
 /** 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. */
@@ -2885,7 +2885,7 @@ export type ScheduledPickSlot = {
      * @deprecated
      */
     pick_rank: number;
-    /** The slot's stored release instant. Qualified automatic selections are due immediately; explicitly scheduled selections retain their stored time. The actual publication can follow final checks and worker delay. */
+    /** The slot's stored release instant. Use the returned timestamp; actual publication may occur later. */
     release_at: string;
     /** The backed game's current kickoff instant. */
     kickoff: string;
@@ -5414,7 +5414,7 @@ export interface OperationResponse {
         /** Absent on the last page. */
         next_cursor?: string;
         /** Holders matching the request's `outcome` and `min_grade` filters across every page. */
-        total?: number;
+        total: number;
         market: MarketHoldersMarket;
         scan: MarketHoldersScan;
         totals: MarketHoldersTotals;