pmxt-core 2.37.0 → 2.37.2

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:02:19.502Z
+ * Generated at: 2026-05-03T09:26:01.700Z
  * 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:02:19.502Z
+ * Generated at: 2026-05-03T09:26:01.700Z
  * 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.
@@ -317,51 +318,68 @@ class KalshiWebSocket {
         }
     }
     async watchOrderBook(ticker) {
-        // Ensure connection
-        if (!this.isConnected) {
-            await this.connect();
+        if (this.isTerminated) {
+            throw new Error(`WebSocket terminated, cannot watch ${ticker}`);
         }
-        // Subscribe if not already subscribed
+        // Track the subscription regardless of connection state.
+        // When (re)connected, the open handler resubscribes automatically.
         if (!this.subscribedOrderBookTickers.has(ticker)) {
             this.subscribedOrderBookTickers.add(ticker);
+        }
+        // Attempt connection — if it fails, scheduleReconnect handles recovery.
+        // The resolver will be fulfilled once the connection is (re)established
+        // and data arrives.
+        if (!this.isConnected) {
+            this.connect().catch(() => {
+                // Connection failed — scheduleReconnect is already queued via the
+                // close handler, so we intentionally swallow here. The pending
+                // resolver will be resolved when data arrives on the next connection.
+            });
+        }
+        else {
+            // Already connected — ensure subscription message is sent
             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) {
-        // Ensure connection
-        if (!this.isConnected) {
-            await this.connect();
+        if (this.isTerminated) {
+            throw new Error("WebSocket terminated, cannot watch orderbooks");
         }
-        // Determine which tickers are actually new (not yet subscribed)
+        // Track subscriptions regardless of connection state.
         const newTickers = tickers.filter((t) => !this.subscribedOrderBookTickers.has(t));
-        // Add all new tickers to the subscription set
         for (const t of newTickers) {
             this.subscribedOrderBookTickers.add(t);
         }
-        // Send ONE subscribe message with only the new tickers
-        if (newTickers.length > 0) {
+        // Attempt connection — if it fails, scheduleReconnect handles recovery.
+        if (!this.isConnected) {
+            this.connect().catch(() => {
+                // Swallow — scheduleReconnect will retry. Resolvers stay pending.
+            });
+        }
+        else if (newTickers.length > 0) {
             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, []);
             }
             this.orderBookResolvers.get(ticker).push({
                 resolve: (book) => {
-                    // Unwrap PromiseLike if needed, but in practice it is always OrderBook
                     Promise.resolve(book).then((b) => resolve([ticker, b]));
                 },
                 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;
@@ -369,22 +387,27 @@ class KalshiWebSocket {
         return result;
     }
     async watchTrades(ticker) {
-        // Ensure connection
-        if (!this.isConnected) {
-            await this.connect();
+        if (this.isTerminated) {
+            throw new Error(`WebSocket terminated, cannot watch trades for ${ticker}`);
         }
-        // Subscribe if not already subscribed
         if (!this.subscribedTradeTickers.has(ticker)) {
             this.subscribedTradeTickers.add(ticker);
+        }
+        if (!this.isConnected) {
+            this.connect().catch(() => {
+                // Swallow — scheduleReconnect will retry. Resolvers stay pending.
+            });
+        }
+        else {
             this.subscribeToTrades([ticker]);
         }
-        // Return a promise that resolves on the next trade
-        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:02:19.560Z
+ * Generated at: 2026-05-03T09:26:01.746Z
  * 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:02:19.560Z
+ * Generated at: 2026-05-03T09:26:01.746Z
  * 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:02:19.578Z
+ * Generated at: 2026-05-03T09:26:01.759Z
  * 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:02:19.578Z
+ * Generated at: 2026-05-03T09:26:01.759Z
  * 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:02:19.583Z
+ * Generated at: 2026-05-03T09:26:01.764Z
  * 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:02:19.583Z
+ * Generated at: 2026-05-03T09:26:01.764Z
  * 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.
@@ -248,38 +249,54 @@ class OpinionWebSocket {
      * Returns a promise that resolves on the next orderbook update.
      */
     async watchOrderBook(marketId) {
-        if (!this.isConnected) {
-            await this.connect();
+        if (this.isTerminated) {
+            throw new Error(`WebSocket terminated, cannot watch market ${marketId}`);
         }
         if (!this.subscribedDepthMarketIds.has(marketId)) {
             this.subscribedDepthMarketIds.add(marketId);
+        }
+        if (!this.isConnected) {
+            this.connect().catch(() => {
+                // Swallow — scheduleReconnect will retry. Resolvers stay pending.
+            });
+        }
+        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.
      * Returns a promise that resolves on the next trade.
      */
     async watchTrades(marketId) {
-        if (!this.isConnected) {
-            await this.connect();
+        if (this.isTerminated) {
+            throw new Error(`WebSocket terminated, cannot watch trades for market ${marketId}`);
         }
         if (!this.subscribedTradeMarketIds.has(marketId)) {
             this.subscribedTradeMarketIds.add(marketId);
+        }
+        if (!this.isConnected) {
+            this.connect().catch(() => {
+                // Swallow — scheduleReconnect will retry. Resolvers stay pending.
+            });
+        }
+        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:02:19.515Z
+ * Generated at: 2026-05-03T09:26:01.707Z
  * 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:02:19.515Z
+ * Generated at: 2026-05-03T09:26:01.707Z
  * 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:02:19.531Z
+ * Generated at: 2026-05-03T09:26:01.724Z
  * 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:02:19.531Z
+ * Generated at: 2026-05-03T09:26:01.724Z
  * 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:02:19.529Z
+ * Generated at: 2026-05-03T09:26:01.720Z
  * 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:02:19.529Z
+ * Generated at: 2026-05-03T09:26:01.720Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketGammaSpec = {

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:02:19.570Z
+ * Generated at: 2026-05-03T09:26:01.752Z
  * 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:02:19.570Z
+ * Generated at: 2026-05-03T09:26:01.752Z
  * 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/server/ws-handler.js

@@ -34,6 +34,10 @@ function subscriptionKey(msg) {
 /**
  * Start a streaming loop for a single-ticker watch method
  * (watchOrderBook, watchTrades).
+ *
+ * The exchange layer owns connection lifecycle — watchOrderBook() blocks until
+ * data arrives, transparently handling reconnection. This loop is a simple
+ * consumer that only terminates on abort or fatal errors.
  */
 async function streamSingle(exchange, method, args, id, ws, signal) {
     const symbol = typeof args[0] === "string" ? args[0] : String(args[0]);
@@ -56,14 +60,18 @@ async function streamSingle(exchange, method, args, id, ws, signal) {
                     : "Unknown streaming error";
             const code = err instanceof errors_1.BaseError ? err.code : undefined;
             sendError(ws, id, message, code);
-            // Brief pause before retry to avoid tight error loops
-            await new Promise((r) => setTimeout(r, 1000));
+            // Fatal error from exchange (terminated, auth failure, etc.) — stop streaming.
+            // The exchange layer handles transient reconnection internally and should
+            // never throw for recoverable connection drops.
+            break;
         }
     }
 }
 /**
  * Start a streaming loop for the batch watchOrderBooks method.
  * Each update is sent as an individual data message per symbol.
+ *
+ * Same lifecycle contract as streamSingle — the exchange owns reconnection.
  */
 async function streamBatch(exchange, method, args, id, ws, signal) {
     const ids = Array.isArray(args[0]) ? args[0] : [];
@@ -87,7 +95,8 @@ async function streamBatch(exchange, method, args, id, ws, signal) {
                     : "Unknown streaming error";
             const code = err instanceof errors_1.BaseError ? err.code : undefined;
             sendError(ws, id, message, code);
-            await new Promise((r) => setTimeout(r, 1000));
+            // Fatal error — stop streaming. Exchange handles transient reconnection.
+            break;
         }
     }
 }

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.0",
+  "version": "2.37.2",
   "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.0,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.0,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.2,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.2,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",