pmxt-core 2.37.1 → 2.37.3

package/dist/exchanges/baozi/websocket.d.ts

@@ -1,13 +1,19 @@
 import { Connection } from '@solana/web3.js';
 import { OrderBook } from '../../types';
+export interface BaoziWebSocketConfig {
+    /** Timeout in ms for watch methods to receive data (default: 30000). 0 = no timeout. */
+    watchTimeoutMs?: number;
+}
 /**
  * Uses Solana's onAccountChange to watch market PDA updates.
  * When the account data changes (new bet placed), we re-parse
  * and emit a new synthetic order book.
  */
 export declare class BaoziWebSocket {
+    private config;
     private orderBookResolvers;
     private subscriptions;
+    constructor(config?: BaoziWebSocketConfig);
     watchOrderBook(connection: Connection, outcomeId: string): Promise<OrderBook>;
     private resolveOrderBook;
     close(connection: Connection): Promise<void>;

package/dist/exchanges/baozi/websocket.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaoziWebSocket = void 0;
 const web3_js_1 = require("@solana/web3.js");
+const watch_timeout_1 = require("../../utils/watch-timeout");
 const utils_1 = require("./utils");
 /**
  * Uses Solana's onAccountChange to watch market PDA updates.
@@ -9,8 +10,12 @@ const utils_1 = require("./utils");
  * and emit a new synthetic order book.
  */
 class BaoziWebSocket {
+    config;
     orderBookResolvers = new Map();
     subscriptions = new Map();
+    constructor(config = {}) {
+        this.config = config;
+    }
     async watchOrderBook(connection, outcomeId) {
         const marketPubkey = outcomeId.replace(/-YES$|-NO$|-\d+$/, '');
         const marketKey = new web3_js_1.PublicKey(marketPubkey);
@@ -45,12 +50,13 @@ class BaoziWebSocket {
             }, 'confirmed');
             this.subscriptions.set(marketPubkey, subId);
         }
-        return new Promise((resolve, reject) => {
+        const dataPromise = new Promise((resolve, reject) => {
             if (!this.orderBookResolvers.has(marketPubkey)) {
                 this.orderBookResolvers.set(marketPubkey, []);
             }
             this.orderBookResolvers.get(marketPubkey).push({ resolve, reject });
         });
+        return (0, watch_timeout_1.withWatchTimeout)(dataPromise, this.config.watchTimeoutMs ?? watch_timeout_1.DEFAULT_WATCH_TIMEOUT_MS, `watchOrderBook('${outcomeId}')`);
     }
     resolveOrderBook(marketPubkey, orderBook) {
         const resolvers = this.orderBookResolvers.get(marketPubkey);

package/dist/exchanges/kalshi/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/kalshi/Kalshi.yaml
- * Generated at: 2026-05-03T09:04:43.064Z
+ * Generated at: 2026-05-03T09:34:33.989Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const kalshiApiSpec: {

package/dist/exchanges/kalshi/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.kalshiApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/kalshi/Kalshi.yaml
- * Generated at: 2026-05-03T09:04:43.064Z
+ * Generated at: 2026-05-03T09:34:33.989Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.kalshiApiSpec = {

package/dist/exchanges/kalshi/websocket.d.ts

@@ -5,6 +5,8 @@ export interface KalshiWebSocketConfig {
     wsUrl?: string;
     /** Reconnection interval in milliseconds (default: 5000) */
     reconnectIntervalMs?: number;
+    /** Timeout in ms for watch methods to receive data (default: 30000). 0 = no timeout. */
+    watchTimeoutMs?: number;
 }
 /**
  * Kalshi WebSocket implementation for real-time order book and trade streaming.

package/dist/exchanges/kalshi/websocket.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KalshiWebSocket = void 0;
 const ws_1 = __importDefault(require("ws"));
+const watch_timeout_1 = require("../../utils/watch-timeout");
 /**
  * Kalshi WebSocket implementation for real-time order book and trade streaming.
  * Follows CCXT Pro-style async iterator pattern.
@@ -340,12 +341,13 @@ class KalshiWebSocket {
             this.subscribeToOrderbook([ticker]);
         }
         // Return a promise that resolves on the next orderbook update
-        return new Promise((resolve, reject) => {
+        const dataPromise = new Promise((resolve, reject) => {
             if (!this.orderBookResolvers.has(ticker)) {
                 this.orderBookResolvers.set(ticker, []);
             }
             this.orderBookResolvers.get(ticker).push({ resolve, reject });
         });
+        return (0, watch_timeout_1.withWatchTimeout)(dataPromise, this.config.watchTimeoutMs ?? watch_timeout_1.DEFAULT_WATCH_TIMEOUT_MS, `watchOrderBook('${ticker}')`);
     }
     async watchOrderBooks(tickers) {
         if (this.isTerminated) {
@@ -366,7 +368,7 @@ class KalshiWebSocket {
             this.subscribeToOrderbook(newTickers);
         }
         // Wait for all tickers to receive at least one snapshot/update
-        const entries = await Promise.all(tickers.map((ticker) => new Promise((resolve, reject) => {
+        const dataPromise = Promise.all(tickers.map((ticker) => new Promise((resolve, reject) => {
             if (!this.orderBookResolvers.has(ticker)) {
                 this.orderBookResolvers.set(ticker, []);
             }
@@ -377,6 +379,7 @@ class KalshiWebSocket {
                 reject,
             });
         })));
+        const entries = await (0, watch_timeout_1.withWatchTimeout)(dataPromise, this.config.watchTimeoutMs ?? watch_timeout_1.DEFAULT_WATCH_TIMEOUT_MS, `watchOrderBooks(${JSON.stringify(tickers)})`);
         const result = {};
         for (const [ticker, book] of entries) {
             result[ticker] = book;
@@ -398,12 +401,13 @@ class KalshiWebSocket {
         else {
             this.subscribeToTrades([ticker]);
         }
-        return new Promise((resolve, reject) => {
+        const dataPromise = new Promise((resolve, reject) => {
             if (!this.tradeResolvers.has(ticker)) {
                 this.tradeResolvers.set(ticker, []);
             }
             this.tradeResolvers.get(ticker).push({ resolve, reject });
         });
+        return (0, watch_timeout_1.withWatchTimeout)(dataPromise, this.config.watchTimeoutMs ?? watch_timeout_1.DEFAULT_WATCH_TIMEOUT_MS, `watchTrades('${ticker}')`);
     }
     async close() {
         this.isTerminated = true;

package/dist/exchanges/limitless/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/limitless/Limitless.yaml
- * Generated at: 2026-05-03T09:04:43.109Z
+ * Generated at: 2026-05-03T09:34:34.027Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const limitlessApiSpec: {

package/dist/exchanges/limitless/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.limitlessApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/limitless/Limitless.yaml
- * Generated at: 2026-05-03T09:04:43.109Z
+ * Generated at: 2026-05-03T09:34:34.027Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.limitlessApiSpec = {

package/dist/exchanges/myriad/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/myriad/myriad.yaml
- * Generated at: 2026-05-03T09:04:43.127Z
+ * Generated at: 2026-05-03T09:34:34.040Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const myriadApiSpec: {

package/dist/exchanges/myriad/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.myriadApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/myriad/myriad.yaml
- * Generated at: 2026-05-03T09:04:43.127Z
+ * Generated at: 2026-05-03T09:34:34.040Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.myriadApiSpec = {

package/dist/exchanges/opinion/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/opinion/opinion-openapi.yaml
- * Generated at: 2026-05-03T09:04:43.132Z
+ * Generated at: 2026-05-03T09:34:34.045Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const opinionApiSpec: {

package/dist/exchanges/opinion/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.opinionApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/opinion/opinion-openapi.yaml
- * Generated at: 2026-05-03T09:04:43.132Z
+ * Generated at: 2026-05-03T09:34:34.045Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.opinionApiSpec = {

package/dist/exchanges/opinion/websocket.d.ts

@@ -2,6 +2,8 @@ import { OrderBook, Trade } from "../../types";
 export interface OpinionWebSocketConfig {
     /** Reconnection interval in milliseconds (default: 5000) */
     reconnectIntervalMs?: number;
+    /** Timeout in ms for watch methods to receive data (default: 30000). 0 = no timeout. */
+    watchTimeoutMs?: number;
 }
 /**
  * Opinion Trade WebSocket implementation for real-time order book and trade streaming.

package/dist/exchanges/opinion/websocket.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpinionWebSocket = void 0;
 const ws_1 = __importDefault(require("ws"));
+const watch_timeout_1 = require("../../utils/watch-timeout");
 /**
  * Opinion Trade WebSocket implementation for real-time order book and trade streaming.
  * Follows CCXT Pro-style async iterator pattern.
@@ -262,12 +263,13 @@ class OpinionWebSocket {
         else {
             this.sendSubscribe("market.depth.diff", marketId);
         }
-        return new Promise((resolve, reject) => {
+        const dataPromise = new Promise((resolve, reject) => {
             if (!this.orderBookResolvers.has(marketId)) {
                 this.orderBookResolvers.set(marketId, []);
             }
             this.orderBookResolvers.get(marketId).push({ resolve, reject });
         });
+        return (0, watch_timeout_1.withWatchTimeout)(dataPromise, this.config.watchTimeoutMs ?? watch_timeout_1.DEFAULT_WATCH_TIMEOUT_MS, `watchOrderBook('${marketId}')`);
     }
     /**
      * Watch trade updates for a given binary market.
@@ -288,12 +290,13 @@ class OpinionWebSocket {
         else {
             this.sendSubscribe("market.last.trade", marketId);
         }
-        return new Promise((resolve, reject) => {
+        const dataPromise = new Promise((resolve, reject) => {
             if (!this.tradeResolvers.has(marketId)) {
                 this.tradeResolvers.set(marketId, []);
             }
             this.tradeResolvers.get(marketId).push({ resolve, reject });
         });
+        return (0, watch_timeout_1.withWatchTimeout)(dataPromise, this.config.watchTimeoutMs ?? watch_timeout_1.DEFAULT_WATCH_TIMEOUT_MS, `watchTrades('${marketId}')`);
     }
     /**
      * Close the WebSocket connection and reject all pending promises.

package/dist/exchanges/polymarket/api-clob.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketClobAPI.yaml
- * Generated at: 2026-05-03T09:04:43.075Z
+ * Generated at: 2026-05-03T09:34:33.994Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const polymarketClobSpec: {

package/dist/exchanges/polymarket/api-clob.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.polymarketClobSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketClobAPI.yaml
- * Generated at: 2026-05-03T09:04:43.075Z
+ * Generated at: 2026-05-03T09:34:33.994Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketClobSpec = {

package/dist/exchanges/polymarket/api-data.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/Polymarket_Data_API.yaml
- * Generated at: 2026-05-03T09:04:43.088Z
+ * Generated at: 2026-05-03T09:34:34.011Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const polymarketDataSpec: {

package/dist/exchanges/polymarket/api-data.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.polymarketDataSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/Polymarket_Data_API.yaml
- * Generated at: 2026-05-03T09:04:43.088Z
+ * Generated at: 2026-05-03T09:34:34.011Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketDataSpec = {

package/dist/exchanges/polymarket/api-gamma.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketGammaAPI.yaml
- * Generated at: 2026-05-03T09:04:43.086Z
+ * Generated at: 2026-05-03T09:34:34.007Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const polymarketGammaSpec: {

package/dist/exchanges/polymarket/api-gamma.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.polymarketGammaSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketGammaAPI.yaml
- * Generated at: 2026-05-03T09:04:43.086Z
+ * Generated at: 2026-05-03T09:34:34.007Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketGammaSpec = {

package/dist/exchanges/polymarket/fetcher.js

@@ -154,7 +154,9 @@ class PolymarketFetcher {
             // which the heuristic mapper mis-categorises as OrderNotFound.
             // Normalise to NotFound so all venues behave the same for order-book lookups.
             if (mapped instanceof errors_1.OrderNotFound) {
-                throw new errors_1.NotFound(`Order book not found: ${id}`, 'Polymarket');
+                throw new errors_1.NotFound(`Order book not found: ${id}. ` +
+                    `fetchOrderBook requires an outcome token ID (market.yes.outcomeId or market.no.outcomeId from fetchMarkets), ` +
+                    `not a market slug or condition ID.`, 'Polymarket');
             }
             throw mapped;
         }

package/dist/exchanges/polymarket/websocket.d.ts

@@ -15,6 +15,8 @@ export interface PolymarketWebSocketConfig {
     flushIntervalMs?: number;
     /** Watcher subscription configurations */
     watcherConfig?: WatcherConfig;
+    /** Timeout in ms for watch methods to receive data (default: 30000). 0 = no timeout. */
+    watchTimeoutMs?: number;
 }
 /**
  * Wrapper around @nevuamarkets/poly-websockets that provides CCXT Pro-style

package/dist/exchanges/polymarket/websocket.js

@@ -43,6 +43,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PolymarketWebSocket = void 0;
 const goldsky_1 = require("../../subscriber/external/goldsky");
 const watcher_1 = require("../../subscriber/watcher");
+const watch_timeout_1 = require("../../utils/watch-timeout");
 /**
  * Wrapper around @nevuamarkets/poly-websockets that provides CCXT Pro-style
  * watchOrderBook() and watchTrades() methods.
@@ -75,12 +76,13 @@ class PolymarketWebSocket {
             await this.manager.addSubscriptions([id]);
         }
         // Return a promise that resolves on the next orderbook update
-        return new Promise((resolve, reject) => {
+        const dataPromise = new Promise((resolve, reject) => {
             if (!this.orderBookResolvers.has(id)) {
                 this.orderBookResolvers.set(id, []);
             }
             this.orderBookResolvers.get(id).push({ resolve, reject });
         });
+        return (0, watch_timeout_1.withWatchTimeout)(dataPromise, this.config.watchTimeoutMs ?? watch_timeout_1.DEFAULT_WATCH_TIMEOUT_MS, `watchOrderBook('${id}')`);
     }
     async unwatchOrderBook(id) {
         if (!this.manager) {
@@ -108,12 +110,13 @@ class PolymarketWebSocket {
             await this.manager.addSubscriptions([id]);
         }
         // Return a promise that resolves on the next trade
-        return new Promise((resolve, reject) => {
+        const dataPromise = new Promise((resolve, reject) => {
             if (!this.tradeResolvers.has(id)) {
                 this.tradeResolvers.set(id, []);
             }
             this.tradeResolvers.get(id).push({ resolve, reject });
         });
+        return (0, watch_timeout_1.withWatchTimeout)(dataPromise, this.config.watchTimeoutMs ?? watch_timeout_1.DEFAULT_WATCH_TIMEOUT_MS, `watchTrades('${id}')`);
     }
     async watchAddress(address, types) {
         return this.watcher.watch(address, types);

package/dist/exchanges/polymarket_us/websocket.d.ts

@@ -16,16 +16,21 @@
 import type { PolymarketUS as PolymarketUSClient } from 'polymarket-us';
 import { OrderBook, Trade } from '../../types';
 import { PolymarketUSNormalizer } from './normalizer';
+export interface PolymarketUSWebSocketConfig {
+    /** Timeout in ms for watch methods to receive data (default: 30000). 0 = no timeout. */
+    watchTimeoutMs?: number;
+}
 export declare class PolymarketUSWebSocket {
     private readonly client;
     private readonly normalizer;
+    private readonly config;
     private socket;
     private initializationPromise?;
     private readonly bookSubscriptions;
     private readonly tradeSubscriptions;
     private readonly orderBookResolvers;
     private readonly tradeResolvers;
-    constructor(client: PolymarketUSClient, normalizer: PolymarketUSNormalizer);
+    constructor(client: PolymarketUSClient, normalizer: PolymarketUSNormalizer, config?: PolymarketUSWebSocketConfig);
     watchOrderBook(id: string): Promise<OrderBook>;
     watchTrades(id: string): Promise<Trade[]>;
     close(): Promise<void>;

package/dist/exchanges/polymarket_us/websocket.js

@@ -16,6 +16,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PolymarketUSWebSocket = void 0;
+const watch_timeout_1 = require("../../utils/watch-timeout");
 const price_1 = require("./price");
 function sideFromOrderSide(raw) {
     if (raw === 'ORDER_SIDE_BUY')
@@ -44,15 +45,17 @@ function slugFromId(id) {
 class PolymarketUSWebSocket {
     client;
     normalizer;
+    config;
     socket = null;
     initializationPromise;
     bookSubscriptions = new Set();
     tradeSubscriptions = new Set();
     orderBookResolvers = new Map();
     tradeResolvers = new Map();
-    constructor(client, normalizer) {
+    constructor(client, normalizer, config = {}) {
         this.client = client;
         this.normalizer = normalizer;
+        this.config = config;
     }
     async watchOrderBook(id) {
         const slug = slugFromId(id);
@@ -61,11 +64,12 @@ class PolymarketUSWebSocket {
             this.bookSubscriptions.add(slug);
             this.socket.subscribeMarketData(`book:${slug}`, [slug]);
         }
-        return new Promise((resolve, reject) => {
+        const dataPromise = new Promise((resolve, reject) => {
             const queue = this.orderBookResolvers.get(slug) ?? [];
             queue.push({ resolve, reject });
             this.orderBookResolvers.set(slug, queue);
         });
+        return (0, watch_timeout_1.withWatchTimeout)(dataPromise, this.config.watchTimeoutMs ?? watch_timeout_1.DEFAULT_WATCH_TIMEOUT_MS, `watchOrderBook('${id}')`);
     }
     async watchTrades(id) {
         const slug = slugFromId(id);
@@ -74,11 +78,12 @@ class PolymarketUSWebSocket {
             this.tradeSubscriptions.add(slug);
             this.socket.subscribeTrades(`trade:${slug}`, [slug]);
         }
-        return new Promise((resolve, reject) => {
+        const dataPromise = new Promise((resolve, reject) => {
             const queue = this.tradeResolvers.get(slug) ?? [];
             queue.push({ resolve, reject });
             this.tradeResolvers.set(slug, queue);
         });
+        return (0, watch_timeout_1.withWatchTimeout)(dataPromise, this.config.watchTimeoutMs ?? watch_timeout_1.DEFAULT_WATCH_TIMEOUT_MS, `watchTrades('${id}')`);
     }
     async close() {
         if (this.socket) {

package/dist/exchanges/probable/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/probable/probable.yaml
- * Generated at: 2026-05-03T09:04:43.115Z
+ * Generated at: 2026-05-03T09:34:34.033Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const probableApiSpec: {

package/dist/exchanges/probable/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.probableApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/probable/probable.yaml
- * Generated at: 2026-05-03T09:04:43.115Z
+ * Generated at: 2026-05-03T09:34:34.033Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

package/dist/exchanges/probable/websocket.d.ts

@@ -6,6 +6,8 @@ export interface ProbableWebSocketConfig {
     baseUrl?: string;
     /** Chain ID (default: 56 for BSC mainnet) */
     chainId?: number;
+    /** Timeout in ms for watch methods to receive data (default: 30000). 0 = no timeout. */
+    watchTimeoutMs?: number;
 }
 /**
  * Probable WebSocket implementation for real-time order book streaming.

package/dist/exchanges/probable/websocket.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProbableWebSocket = void 0;
+const watch_timeout_1 = require("../../utils/watch-timeout");
 /**
  * Probable WebSocket implementation for real-time order book streaming.
  * Uses the @prob/clob SDK's subscribePublicStream (no auth required).
@@ -42,12 +43,13 @@ class ProbableWebSocket {
             this.subscriptions.set(tokenId, sub);
         }
         // Return a promise that resolves on the next orderbook update
-        return new Promise((resolve, reject) => {
+        const dataPromise = new Promise((resolve, reject) => {
             if (!this.orderBookResolvers.has(tokenId)) {
                 this.orderBookResolvers.set(tokenId, []);
             }
             this.orderBookResolvers.get(tokenId).push({ resolve, reject });
         });
+        return (0, watch_timeout_1.withWatchTimeout)(dataPromise, this.config.watchTimeoutMs ?? watch_timeout_1.DEFAULT_WATCH_TIMEOUT_MS, `watchOrderBook('${tokenId}')`);
     }
     handleOrderBookUpdate(tokenId, data) {
         const bids = (data.bids || []).map((b) => ({

package/dist/utils/validation.js

@@ -12,7 +12,8 @@ function validateOutcomeId(id, context) {
     // Short numeric IDs are invalid for trading operations
     if (id.length < 10 && /^\d+$/.test(id)) {
         throw new errors_1.ValidationError(`Invalid outcome ID for ${context}: "${id}". ` +
-            `Numeric outcome IDs must be at least 10 digits. Please use the correct outcome ID.`, 'id');
+            `fetchOrderBook requires an outcome token ID, not a market slug or condition ID. ` +
+            `Use fetchMarkets to find the market, then pass market.yes.outcomeId or market.no.outcomeId.`, 'id');
     }
 }
 function validateIdFormat(id, context) {

package/dist/utils/watch-timeout.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Default timeout for watch methods (30 seconds).
+ *
+ * Generous enough for valid but illiquid markets, but prevents
+ * hanging forever on non-existing IDs.
+ */
+export declare const DEFAULT_WATCH_TIMEOUT_MS = 30000;
+/**
+ * Wrap a watch promise with a timeout that rejects if no data arrives.
+ *
+ * Used by all exchange WebSocket implementations to prevent indefinite
+ * hangs when subscribing to non-existing market IDs.
+ *
+ * @param promise  - The data promise (resolves when WS data arrives)
+ * @param timeoutMs - Maximum time to wait in milliseconds (0 = no timeout)
+ * @param label     - Human-readable label for the error message
+ */
+export declare function withWatchTimeout<T>(promise: Promise<T>, timeoutMs: number, label: string): Promise<T>;

package/dist/utils/watch-timeout.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_WATCH_TIMEOUT_MS = void 0;
+exports.withWatchTimeout = withWatchTimeout;
+/**
+ * Default timeout for watch methods (30 seconds).
+ *
+ * Generous enough for valid but illiquid markets, but prevents
+ * hanging forever on non-existing IDs.
+ */
+exports.DEFAULT_WATCH_TIMEOUT_MS = 30_000;
+/**
+ * Wrap a watch promise with a timeout that rejects if no data arrives.
+ *
+ * Used by all exchange WebSocket implementations to prevent indefinite
+ * hangs when subscribing to non-existing market IDs.
+ *
+ * @param promise  - The data promise (resolves when WS data arrives)
+ * @param timeoutMs - Maximum time to wait in milliseconds (0 = no timeout)
+ * @param label     - Human-readable label for the error message
+ */
+function withWatchTimeout(promise, timeoutMs, label) {
+    if (timeoutMs <= 0)
+        return promise;
+    let timer;
+    const timeoutPromise = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            reject(new Error(`${label}: timed out after ${timeoutMs}ms waiting for data. ` +
+                `The ID may not exist on this exchange.`));
+        }, timeoutMs);
+    });
+    return Promise.race([promise, timeoutPromise]).finally(() => {
+        clearTimeout(timer);
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxt-core",
-  "version": "2.37.1",
+  "version": "2.37.3",
   "description": "pmxt is a unified prediction market data API. The ccxt for prediction markets.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -29,8 +29,8 @@
     "test": "jest -c jest.config.js",
     "server": "tsx watch src/server/index.ts",
     "server:prod": "node dist/server/index.js",
-    "generate:sdk:python": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g python -o ../sdks/python/generated --package-name pmxt_internal --additional-properties=projectName=pmxt-internal,packageVersion=2.37.1,library=urllib3",
-    "generate:sdk:typescript": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g typescript-fetch -o ../sdks/typescript/generated --additional-properties=npmName=pmxtjs,npmVersion=2.37.1,supportsES6=true,typescriptThreePlus=true && node ../sdks/typescript/scripts/fix-generated.js",
+    "generate:sdk:python": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g python -o ../sdks/python/generated --package-name pmxt_internal --additional-properties=projectName=pmxt-internal,packageVersion=2.37.3,library=urllib3",
+    "generate:sdk:typescript": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g typescript-fetch -o ../sdks/typescript/generated --additional-properties=npmName=pmxtjs,npmVersion=2.37.3,supportsES6=true,typescriptThreePlus=true && node ../sdks/typescript/scripts/fix-generated.js",
     "fetch:openapi": "node scripts/fetch-openapi-specs.js",
     "extract:jsdoc": "node ../scripts/extract-jsdoc.js",
     "generate:docs": "npm run extract:jsdoc && node ../scripts/generate-api-docs.js",