@okx_ai/okx-trade-mcp 1.3.6 → 1.3.8-beta.1

package/dist/index.js

@@ -2475,6 +2475,7 @@ var MODULES = [
   "event",
   "news",
   "smartmoney",
+  "outcomes",
   ...EARN_SUB_MODULE_IDS,
   ...BOT_SUB_MODULE_IDS,
   "skills"
@@ -8049,6 +8050,706 @@ function registerSmartmoneyTools() {
   ];
   return tools;
 }
+function toNum(v) {
+  if (v === void 0 || v === null || v === "") return void 0;
+  const n = Number(v);
+  return Number.isFinite(n) ? n : void 0;
+}
+function decimalPlaces(v) {
+  if (v === void 0 || v === null || v === "") return 0;
+  const s = String(v);
+  const dot = s.indexOf(".");
+  return dot < 0 ? 0 : s.length - dot - 1;
+}
+function fmtFixed(n, places) {
+  return n.toFixed(places);
+}
+function deriveTickerView(ticker, outcome) {
+  const bidNum = toNum(ticker.bidPx);
+  const askNum = toNum(ticker.askPx);
+  const lastStr = ticker.last !== void 0 ? String(ticker.last) : void 0;
+  const bidPlaces = decimalPlaces(ticker.bidPx);
+  const askPlaces = decimalPlaces(ticker.askPx);
+  const maxPlaces = Math.max(bidPlaces, askPlaces);
+  const bidStr = bidNum !== void 0 ? fmtFixed(bidNum, bidPlaces) : void 0;
+  const askStr = askNum !== void 0 ? fmtFixed(askNum, askPlaces) : void 0;
+  const view = { last: lastStr, bidPx: bidStr, askPx: askStr };
+  if (bidNum !== void 0 && askNum !== void 0) {
+    view.midpoint = fmtFixed((bidNum + askNum) / 2, maxPlaces);
+    view.spread = fmtFixed(askNum - bidNum, maxPlaces);
+  }
+  if (outcome !== void 0 && askNum !== void 0) {
+    const outcomeLower = outcome.toLowerCase();
+    if (outcomeLower === "yes") {
+      view.derivedPrice = fmtFixed(askNum, askPlaces);
+    } else if (outcomeLower === "no") {
+      view.derivedPrice = fmtFixed(1 - askNum, askPlaces);
+    }
+  }
+  return view;
+}
+var PATH_EVENTS = "/api/v5/predictions/events";
+var PATH_EVENTS_SEARCH = "/api/v5/predictions/events/search";
+var PATH_MARKETS = "/api/v5/predictions/markets";
+var PATH_BALANCE = "/api/v5/predictions/balance";
+var PATH_ORDERS = "/api/v5/predictions/orders";
+var PATH_POSITIONS = "/api/v5/predictions/positions";
+var PATH_TRADES = "/api/v5/predictions/trades";
+var PATH_TICKER = "/api/v5/market/ticker";
+var PATH_CANDLES = "/api/v5/market/candles";
+var PATH_PM_BOOKS = "/api/v5/market/pm-books";
+var OUTCOMES_RPS = 10;
+function requireString2(args, key, label) {
+  const v = readString(args, key);
+  if (!v) throw new Error(`${label} is required`);
+  return v;
+}
+function pathSegment(id) {
+  return encodeURIComponent(id);
+}
+async function runBatchQuery(ids, fn) {
+  if (ids.length === 0) {
+    throw new Error("At least one ID is required");
+  }
+  const results = await Promise.allSettled(ids.map((id) => fn(id)));
+  return results.map((result, i) => {
+    const id = ids[i];
+    if (result.status === "fulfilled") {
+      return { id, data: result.value };
+    }
+    const errMsg = result.reason instanceof Error ? result.reason.message : String(result.reason);
+    return { id, error: errMsg };
+  });
+}
+function registerOutcomesTools() {
+  const tools = [
+    /* ================================================================ */
+    /*  DATA MODULE (7)                                                 */
+    /* ================================================================ */
+    /* D1. List events */
+    {
+      name: "outcomes_get_events",
+      title: "List Prediction Events",
+      module: "outcomes",
+      description: "List available prediction (binary outcomes) events on OKX, optionally filtered by status, category, tag, league, sort, or cursor. Use when: discovering events to trade on. Default limit 20. See also: `outcomes_get_trending_events` (no args, server-chosen trending events), `outcomes_search_events` (keyword search).",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          status: { type: "string", description: "Filter by event status, e.g. `active` | `closed` | `settled`." },
+          category: { type: "string", description: "Event category, e.g. `crypto` | `sports` | `politics`." },
+          tag: { type: "string", description: "Event tag for further classification." },
+          league: { type: "string", description: "League / competition name for sports events." },
+          sort: { type: "string", description: "Sort key, e.g. `trending` | `newest`." },
+          cursor: { type: "string", description: "Pagination cursor from previous response." },
+          limit: { type: "integer", minimum: 1, maximum: 100, default: 20, description: "Max results (default 20)." }
+        }
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const response = await context.client.privateGet(
+          PATH_EVENTS,
+          compactObject({
+            status: readString(args, "status"),
+            category: readString(args, "category"),
+            tag: readString(args, "tag"),
+            league: readString(args, "league"),
+            sort: readString(args, "sort"),
+            cursor: readString(args, "cursor"),
+            limit: readNumber(args, "limit") ?? 20
+          }),
+          privateRateLimit("outcomes_get_events", OUTCOMES_RPS)
+        );
+        return normalizeResponse(response);
+      }
+    },
+    /* D2. Get event detail */
+    {
+      name: "outcomes_get_event_detail",
+      title: "Get Prediction Event Detail",
+      module: "outcomes",
+      description: "Get full detail of a single prediction event by its ID, including description, resolution criteria, and linked markets. Use when: inspecting a specific event before trading.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          id: { type: "string", description: "Event ID, e.g. from `outcomes_get_events` results." }
+        },
+        required: ["id"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const id = requireString2(args, "id", "Event ID");
+        const response = await context.client.privateGet(
+          `${PATH_EVENTS}/${pathSegment(id)}`,
+          {},
+          privateRateLimit("outcomes_get_event_detail", OUTCOMES_RPS)
+        );
+        return normalizeResponse(response);
+      }
+    },
+    /* D3. Get event markets */
+    {
+      name: "outcomes_get_event_markets",
+      title: "Get Markets for a Prediction Event",
+      module: "outcomes",
+      description: "Get all tradable markets for a prediction event. Each market corresponds to a binary outcome (YES/NO). Use when: listing which outcomes are available to trade for an event. See also: `outcomes_get_market_detail` (single market by market ID).",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          id: { type: "string", description: "Event ID." }
+        },
+        required: ["id"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const id = requireString2(args, "id", "Event ID");
+        const response = await context.client.privateGet(
+          `${PATH_EVENTS}/${pathSegment(id)}/markets`,
+          {},
+          privateRateLimit("outcomes_get_event_markets", OUTCOMES_RPS)
+        );
+        return normalizeResponse(response);
+      }
+    },
+    /* D4. Get market detail */
+    {
+      name: "outcomes_get_market_detail",
+      title: "Get Prediction Market Detail",
+      module: "outcomes",
+      description: "Get full detail of a single prediction market by its market ID (e.g. current probability, settlement info, linked event). Use when: inspecting a specific binary market before placing an order.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          id: { type: "string", description: "Market ID." }
+        },
+        required: ["id"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const id = requireString2(args, "id", "Market ID");
+        const response = await context.client.privateGet(
+          `${PATH_MARKETS}/${pathSegment(id)}`,
+          {},
+          privateRateLimit("outcomes_get_market_detail", OUTCOMES_RPS)
+        );
+        return normalizeResponse(response);
+      }
+    },
+    /* D5. Trending events (alias of events, server defaults sort) */
+    {
+      name: "outcomes_get_trending_events",
+      title: "Get Trending Prediction Events",
+      module: "outcomes",
+      description: "Get trending prediction events \u2014 server-selected, most-active events. Equivalent to `outcomes_get_events` with no sort parameter; the server applies its trending algorithm. Use when: user asks for 'what's hot / trending' in predictions. See also: `outcomes_get_events` (full filter support).",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          cursor: { type: "string", description: "Pagination cursor." },
+          limit: { type: "integer", minimum: 1, maximum: 100, default: 20, description: "Max results (default 20)." }
+        }
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const response = await context.client.privateGet(
+          PATH_EVENTS,
+          compactObject({
+            cursor: readString(args, "cursor"),
+            limit: readNumber(args, "limit") ?? 20
+          }),
+          privateRateLimit("outcomes_get_trending_events", OUTCOMES_RPS)
+        );
+        return normalizeResponse(response);
+      }
+    },
+    /* D6. Get ticker */
+    {
+      name: "outcomes_get_ticker",
+      title: "Get Prediction Asset Ticker",
+      module: "outcomes",
+      description: "Get the current ticker (last traded price, best bid/ask, volume) for a prediction market asset ID. Use when: checking the latest price for a prediction market instrument. Returns the full raw ticker \u2014 use `outcomes_get_market_price` for outcome-derived pricing.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          assetId: { type: "string", description: "Prediction asset instrument ID, e.g. `BTC-USD-PRED`." }
+        },
+        required: ["assetId"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const assetId = readString(args, "assetId") ?? "";
+        const response = await context.client.privateGet(
+          PATH_TICKER,
+          { instId: assetId },
+          privateRateLimit("outcomes_get_ticker", OUTCOMES_RPS)
+        );
+        return normalizeResponse(response);
+      }
+    },
+    /* D7. Get candles */
+    {
+      name: "outcomes_get_candles",
+      title: "Get Prediction Asset Candles",
+      module: "outcomes",
+      description: "Get OHLCV candlestick data for a prediction asset. OKX pagination convention: `after` returns candles with timestamp BEFORE the cursor; `before` returns candles AFTER. Use when: charting or analysing price history of a prediction market instrument.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          assetId: { type: "string", description: "Prediction asset instrument ID." },
+          bar: { type: "string", enum: ["1m", "5m", "15m", "30m", "1H", "4H", "1D"], description: "Candlestick bar size (default `1m`)." },
+          after: { type: "string", description: "Pagination cursor \u2014 returns candles with ts BEFORE this value." },
+          before: { type: "string", description: "Pagination cursor \u2014 returns candles with ts AFTER this value." },
+          limit: { type: "integer", minimum: 1, maximum: 300, default: 100, description: "Max candles (default 100)." }
+        },
+        required: ["assetId"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const assetId = readString(args, "assetId") ?? "";
+        const response = await context.client.privateGet(
+          PATH_CANDLES,
+          compactObject({
+            instId: assetId,
+            bar: readString(args, "bar"),
+            after: readString(args, "after"),
+            before: readString(args, "before"),
+            limit: readNumber(args, "limit") ?? 100
+          }),
+          privateRateLimit("outcomes_get_candles", OUTCOMES_RPS)
+        );
+        return normalizeResponse(response);
+      }
+    },
+    /* ================================================================ */
+    /*  SEARCH MODULE (1)                                               */
+    /* ================================================================ */
+    /* S1. Search events */
+    {
+      name: "outcomes_search_events",
+      title: "Search Prediction Events",
+      module: "outcomes",
+      description: "Search prediction events by keyword. Returns events matching the keyword in title, description, or tags. Use when: user asks about a specific topic (e.g. 'Will BTC hit 100k?', 'US election'). See also: `outcomes_get_events` (full browse), `outcomes_get_trending_events` (trending).",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          keyword: { type: "string", description: "Search keyword." },
+          cursor: { type: "string", description: "Pagination cursor." },
+          limit: { type: "integer", minimum: 1, maximum: 100, default: 20, description: "Max results (default 20)." }
+        },
+        required: ["keyword"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const response = await context.client.privateGet(
+          PATH_EVENTS_SEARCH,
+          compactObject({
+            keyword: readString(args, "keyword"),
+            cursor: readString(args, "cursor"),
+            limit: readNumber(args, "limit") ?? 20
+          }),
+          privateRateLimit("outcomes_search_events", OUTCOMES_RPS)
+        );
+        return normalizeResponse(response);
+      }
+    },
+    /* ================================================================ */
+    /*  CLOB MODULE (8)                                                 */
+    /*  6 of these call /api/v5/market/ticker with client-side derive.  */
+    /*  2 (book/books) call /api/v5/market/pm-books.                   */
+    /* ================================================================ */
+    /* C1. Market price (single) */
+    {
+      name: "outcomes_get_market_price",
+      title: "Get Prediction Market Price",
+      module: "outcomes",
+      description: "Get the derived trading price for a binary prediction market outcome (YES or NO side). Internally fetches the ticker and derives the best-ask for the specified outcome. Use `outcome=yes` for YES side, `outcome=no` for NO side. See also: `outcomes_get_market_prices` (batch), `outcomes_get_market_midpoint` (mid price).",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          mktId: { type: "string", description: "Market instrument ID." },
+          outcome: { type: "string", enum: ["yes", "no"], description: "Which outcome side: `yes` or `no`." }
+        },
+        required: ["mktId"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const mktId = readString(args, "mktId") ?? "";
+        const outcome = readString(args, "outcome");
+        const response = await context.client.privateGet(
+          PATH_TICKER,
+          { instId: mktId },
+          privateRateLimit("outcomes_get_market_price", OUTCOMES_RPS)
+        );
+        const normalized = normalizeResponse(response);
+        const ticker = Array.isArray(normalized.data) && normalized.data.length > 0 ? normalized.data[0] : {};
+        const view = deriveTickerView(ticker, outcome);
+        return { ...normalized, data: { ...ticker, ...view } };
+      }
+    },
+    /* C2. Market prices (batch) */
+    {
+      name: "outcomes_get_market_prices",
+      title: "Get Prediction Market Prices (Batch)",
+      module: "outcomes",
+      description: "Get derived trading prices for multiple prediction market IDs in parallel. Per-row error isolation: if any single market fails, only that row has an `error` field; the rest succeed normally. See also: `outcomes_get_market_price` (single market), `outcomes_get_market_midpoints` (batch midpoints).",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          ids: { type: "array", items: { type: "string" }, description: "List of market instrument IDs." },
+          outcome: { type: "string", enum: ["yes", "no"], description: "Outcome side for price derivation." }
+        },
+        required: ["ids"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const ids = Array.isArray(args["ids"]) ? args["ids"] : [];
+        const outcome = readString(args, "outcome");
+        const rows = await runBatchQuery(ids, async (id) => {
+          const response = await context.client.privateGet(
+            PATH_TICKER,
+            { instId: id },
+            privateRateLimit("outcomes_get_market_prices", OUTCOMES_RPS)
+          );
+          const normalized = normalizeResponse(response);
+          const ticker = Array.isArray(normalized.data) && normalized.data.length > 0 ? normalized.data[0] : {};
+          return { ...ticker, ...deriveTickerView(ticker, outcome) };
+        });
+        return {
+          endpoint: PATH_TICKER,
+          requestTime: (/* @__PURE__ */ new Date()).toISOString(),
+          data: rows
+        };
+      }
+    },
+    /* C3. Market midpoint (single) */
+    {
+      name: "outcomes_get_market_midpoint",
+      title: "Get Prediction Market Midpoint",
+      module: "outcomes",
+      description: "Get the midpoint price for a prediction market: (bidPx + askPx) / 2. Use when: estimating the fair mid-market price. See also: `outcomes_get_market_midpoints` (batch), `outcomes_get_market_spread` (bid-ask spread).",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          mktId: { type: "string", description: "Market instrument ID." }
+        },
+        required: ["mktId"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const mktId = readString(args, "mktId") ?? "";
+        const response = await context.client.privateGet(
+          PATH_TICKER,
+          { instId: mktId },
+          privateRateLimit("outcomes_get_market_midpoint", OUTCOMES_RPS)
+        );
+        const normalized = normalizeResponse(response);
+        const ticker = Array.isArray(normalized.data) && normalized.data.length > 0 ? normalized.data[0] : {};
+        const view = deriveTickerView(ticker, void 0);
+        return { ...normalized, data: { ...ticker, ...view } };
+      }
+    },
+    /* C4. Market midpoints (batch) */
+    {
+      name: "outcomes_get_market_midpoints",
+      title: "Get Prediction Market Midpoints (Batch)",
+      module: "outcomes",
+      description: "Get midpoint prices for multiple prediction markets in parallel. Per-row error isolation. See also: `outcomes_get_market_midpoint` (single), `outcomes_get_market_spreads` (batch spreads).",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          ids: { type: "array", items: { type: "string" }, description: "List of market instrument IDs." }
+        },
+        required: ["ids"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const ids = Array.isArray(args["ids"]) ? args["ids"] : [];
+        const rows = await runBatchQuery(ids, async (id) => {
+          const response = await context.client.privateGet(
+            PATH_TICKER,
+            { instId: id },
+            privateRateLimit("outcomes_get_market_midpoints", OUTCOMES_RPS)
+          );
+          const normalized = normalizeResponse(response);
+          const ticker = Array.isArray(normalized.data) && normalized.data.length > 0 ? normalized.data[0] : {};
+          return { ...ticker, ...deriveTickerView(ticker, void 0) };
+        });
+        return {
+          endpoint: PATH_TICKER,
+          requestTime: (/* @__PURE__ */ new Date()).toISOString(),
+          data: rows
+        };
+      }
+    },
+    /* C5. Market spread (single) */
+    {
+      name: "outcomes_get_market_spread",
+      title: "Get Prediction Market Spread",
+      module: "outcomes",
+      description: "Get the bid-ask spread for a prediction market: askPx - bidPx. Use when: assessing liquidity or trading cost. See also: `outcomes_get_market_spreads` (batch), `outcomes_get_market_midpoint` (midpoint price).",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          mktId: { type: "string", description: "Market instrument ID." }
+        },
+        required: ["mktId"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const mktId = readString(args, "mktId") ?? "";
+        const response = await context.client.privateGet(
+          PATH_TICKER,
+          { instId: mktId },
+          privateRateLimit("outcomes_get_market_spread", OUTCOMES_RPS)
+        );
+        const normalized = normalizeResponse(response);
+        const ticker = Array.isArray(normalized.data) && normalized.data.length > 0 ? normalized.data[0] : {};
+        const view = deriveTickerView(ticker, void 0);
+        return { ...normalized, data: { ...ticker, ...view } };
+      }
+    },
+    /* C6. Market spreads (batch) */
+    {
+      name: "outcomes_get_market_spreads",
+      title: "Get Prediction Market Spreads (Batch)",
+      module: "outcomes",
+      description: "Get bid-ask spreads for multiple prediction markets in parallel. Per-row error isolation. See also: `outcomes_get_market_spread` (single), `outcomes_get_market_midpoints` (batch midpoints).",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          ids: { type: "array", items: { type: "string" }, description: "List of market instrument IDs." }
+        },
+        required: ["ids"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const ids = Array.isArray(args["ids"]) ? args["ids"] : [];
+        const rows = await runBatchQuery(ids, async (id) => {
+          const response = await context.client.privateGet(
+            PATH_TICKER,
+            { instId: id },
+            privateRateLimit("outcomes_get_market_spreads", OUTCOMES_RPS)
+          );
+          const normalized = normalizeResponse(response);
+          const ticker = Array.isArray(normalized.data) && normalized.data.length > 0 ? normalized.data[0] : {};
+          return { ...ticker, ...deriveTickerView(ticker, void 0) };
+        });
+        return {
+          endpoint: PATH_TICKER,
+          requestTime: (/* @__PURE__ */ new Date()).toISOString(),
+          data: rows
+        };
+      }
+    },
+    /* C7. Order book (single) */
+    {
+      name: "outcomes_get_order_book",
+      title: "Get Prediction Market Order Book",
+      module: "outcomes",
+      description: "Get the CLOB order book (bids and asks) for a prediction market. Use when: examining market depth before a limit order. See also: `outcomes_get_order_books` (batch).",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          mktId: { type: "string", description: "Market instrument ID." },
+          sz: { type: "integer", minimum: 1, maximum: 400, description: "Order book depth (levels to return)." }
+        },
+        required: ["mktId"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const mktId = readString(args, "mktId") ?? "";
+        const sz = readNumber(args, "sz");
+        const response = await context.client.privateGet(
+          PATH_PM_BOOKS,
+          compactObject({ instId: mktId, sz }),
+          privateRateLimit("outcomes_get_order_book", OUTCOMES_RPS)
+        );
+        return normalizeResponse(response);
+      }
+    },
+    /* C8. Order books (batch) */
+    {
+      name: "outcomes_get_order_books",
+      title: "Get Prediction Market Order Books (Batch)",
+      module: "outcomes",
+      description: "Get CLOB order books for multiple prediction markets in parallel. Per-row error isolation. See also: `outcomes_get_order_book` (single).",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          ids: { type: "array", items: { type: "string" }, description: "List of market instrument IDs." },
+          sz: { type: "integer", minimum: 1, maximum: 400, description: "Order book depth per market." }
+        },
+        required: ["ids"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const ids = Array.isArray(args["ids"]) ? args["ids"] : [];
+        const sz = readNumber(args, "sz");
+        const rows = await runBatchQuery(ids, async (id) => {
+          const response = await context.client.privateGet(
+            PATH_PM_BOOKS,
+            compactObject({ instId: id, sz }),
+            privateRateLimit("outcomes_get_order_books", OUTCOMES_RPS)
+          );
+          const normalized = normalizeResponse(response);
+          return Array.isArray(normalized.data) && normalized.data.length > 0 ? normalized.data[0] : normalized.data;
+        });
+        return {
+          endpoint: PATH_PM_BOOKS,
+          requestTime: (/* @__PURE__ */ new Date()).toISOString(),
+          data: rows
+        };
+      }
+    },
+    /* ================================================================ */
+    /*  ACCOUNT MODULE (5)                                              */
+    /* ================================================================ */
+    /* A1. Account balance */
+    {
+      name: "outcomes_get_account_balance",
+      title: "Get Predictions Account Balance",
+      module: "outcomes",
+      description: "Get the balance of the user's predictions account (collateral available for trading binary outcomes). Use when: checking how much is available to bet on prediction markets.",
+      isWrite: false,
+      inputSchema: { type: "object", properties: {} },
+      handler: async (_rawArgs, context) => {
+        const response = await context.client.privateGet(
+          PATH_BALANCE,
+          {},
+          privateRateLimit("outcomes_get_account_balance", OUTCOMES_RPS)
+        );
+        return normalizeResponse(response);
+      }
+    },
+    /* A2. Order detail */
+    {
+      name: "outcomes_get_order_detail",
+      title: "Get Prediction Order Detail",
+      module: "outcomes",
+      description: "Get full detail of a single prediction order by order ID (status, fill info, timestamps). Use when: checking whether a specific order was filled. Also reachable via `okx outcomes clob order {ID}` (CLI alias).",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          id: { type: "string", description: "Order ID." }
+        },
+        required: ["id"]
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const id = requireString2(args, "id", "Order ID");
+        const response = await context.client.privateGet(
+          `${PATH_ORDERS}/${pathSegment(id)}`,
+          {},
+          privateRateLimit("outcomes_get_order_detail", OUTCOMES_RPS)
+        );
+        return normalizeResponse(response);
+      }
+    },
+    /* A3. Account orders */
+    {
+      name: "outcomes_get_account_orders",
+      title: "List Prediction Account Orders",
+      module: "outcomes",
+      description: "List the user's prediction orders, optionally filtered by status (`open` | `closed`, default `open`) and paginated. Use when: reviewing pending or historical orders. Also reachable via `okx outcomes clob orders` (CLI alias).",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          status: { type: "string", enum: ["open", "closed"], default: "open", description: "Order status filter (default `open`)." },
+          cursor: { type: "string", description: "Pagination cursor." },
+          limit: { type: "integer", minimum: 1, maximum: 100, default: 20, description: "Max results (default 20)." }
+        }
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const response = await context.client.privateGet(
+          PATH_ORDERS,
+          compactObject({
+            status: readString(args, "status") ?? "open",
+            cursor: readString(args, "cursor"),
+            limit: readNumber(args, "limit") ?? 20
+          }),
+          privateRateLimit("outcomes_get_account_orders", OUTCOMES_RPS)
+        );
+        return normalizeResponse(response);
+      }
+    },
+    /* A4. Account positions */
+    {
+      name: "outcomes_get_account_positions",
+      title: "List Prediction Account Positions",
+      module: "outcomes",
+      description: "List the user's prediction positions, optionally filtered by status (`open` | `closed`, default `open`), market ID, or limit. The MCP schema enum enforces valid status values at the boundary; server-side mapping of unknown values to `open` is a defensive fallback only. Use when: checking which prediction markets the user currently holds positions in.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          status: { type: "string", enum: ["open", "closed"], default: "open", description: "Position status filter (default `open`)." },
+          market: { type: "string", description: "Optional market instrument ID to filter by." },
+          cursor: { type: "string", description: "Pagination cursor." },
+          limit: { type: "integer", minimum: 1, maximum: 100, default: 20, description: "Max results (default 20)." }
+        }
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const response = await context.client.privateGet(
+          PATH_POSITIONS,
+          compactObject({
+            status: readString(args, "status") ?? "open",
+            market: readString(args, "market"),
+            cursor: readString(args, "cursor"),
+            limit: readNumber(args, "limit") ?? 20
+          }),
+          privateRateLimit("outcomes_get_account_positions", OUTCOMES_RPS)
+        );
+        return normalizeResponse(response);
+      }
+    },
+    /* A5. Account trades */
+    {
+      name: "outcomes_get_account_trades",
+      title: "List Prediction Account Trades",
+      module: "outcomes",
+      description: "List the user's prediction trade fills (executed trades), paginated. Use when: reviewing trading history on prediction markets. Also reachable via `okx outcomes clob trades` (CLI alias).",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          cursor: { type: "string", description: "Pagination cursor." },
+          limit: { type: "integer", minimum: 1, maximum: 100, default: 20, description: "Max results (default 20)." }
+        }
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const response = await context.client.privateGet(
+          PATH_TRADES,
+          compactObject({
+            cursor: readString(args, "cursor"),
+            limit: readNumber(args, "limit") ?? 20
+          }),
+          privateRateLimit("outcomes_get_account_trades", OUTCOMES_RPS)
+        );
+        return normalizeResponse(response);
+      }
+    }
+  ];
+  return tools;
+}
 function buildContractTradeTools(cfg) {
   const { prefix, module, label, instTypes, instIdExample, titleLabel } = cfg;
   const [defaultType, otherType] = instTypes;
@@ -11839,6 +12540,7 @@ function allToolSpecs() {
     ...registerBotTools(),
     ...registerAllEarnTools(),
     ...registerSmartmoneyTools(),
+    ...registerOutcomesTools(),
     ...registerAuditTools(),
     ...registerSkillsTools()
   ];
@@ -12397,7 +13099,7 @@ var _require = createRequire(import.meta.url);
 var pkg = _require("../package.json");
 var SERVER_NAME = "okx-trade-mcp";
 var SERVER_VERSION = pkg.version;
-var GIT_HASH = true ? "92abfa77" : "dev";
+var GIT_HASH = true ? "740ac6f1" : "dev";
 
 // src/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";