pmxt-core 2.36.1 → 2.37.1

package/dist/BaseExchange.d.ts

@@ -460,10 +460,14 @@ export declare abstract class PredictionMarketExchange {
      * Fetch the current order book (bids/asks) for a specific outcome.
      * Essential for calculating spread, depth, and execution prices.
      *
-     * @param id - The Outcome ID (outcomeId)
+     * @param id - The Outcome ID (outcomeId) or market slug
+     * @param side - Optional 'yes' or 'no' to explicitly indicate the
+     *   outcome side. Required for exchanges where the API returns a
+     *   single orderbook per market (e.g. Limitless) and the caller
+     *   passes a slug instead of a token ID.
      * @returns Current order book with bids and asks
      */
-    fetchOrderBook(id: string): Promise<OrderBook>;
+    fetchOrderBook(id: string, side?: 'yes' | 'no'): Promise<OrderBook>;
     /**
      * Fetch raw trade history for a specific outcome.
      *

package/dist/BaseExchange.js

@@ -406,10 +406,14 @@ class PredictionMarketExchange {
      * Fetch the current order book (bids/asks) for a specific outcome.
      * Essential for calculating spread, depth, and execution prices.
      *
-     * @param id - The Outcome ID (outcomeId)
+     * @param id - The Outcome ID (outcomeId) or market slug
+     * @param side - Optional 'yes' or 'no' to explicitly indicate the
+     *   outcome side. Required for exchanges where the API returns a
+     *   single orderbook per market (e.g. Limitless) and the caller
+     *   passes a slug instead of a token ID.
      * @returns Current order book with bids and asks
      */
-    async fetchOrderBook(id) {
+    async fetchOrderBook(id, side) {
         throw new Error("Method fetchOrderBook not implemented.");
     }
     /**

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-03T08:52:44.008Z
+ * Generated at: 2026-05-03T09:04:43.064Z
  * 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-03T08:52:44.008Z
+ * Generated at: 2026-05-03T09:04:43.064Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.kalshiApiSpec = {

package/dist/exchanges/kalshi/websocket.js

@@ -317,13 +317,26 @@ 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
@@ -335,18 +348,21 @@ class KalshiWebSocket {
         });
     }
     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
@@ -356,7 +372,6 @@ class KalshiWebSocket {
             }
             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,
@@ -369,16 +384,20 @@ 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) => {
             if (!this.tradeResolvers.has(ticker)) {
                 this.tradeResolvers.set(ticker, []);

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-03T08:52:44.066Z
+ * Generated at: 2026-05-03T09:04:43.109Z
  * 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-03T08:52:44.066Z
+ * Generated at: 2026-05-03T09:04:43.109Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.limitlessApiSpec = {

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

@@ -28,7 +28,7 @@ export declare class LimitlessExchange extends PredictionMarketExchange {
     protected fetchMarketsImpl(params?: MarketFetchParams): Promise<UnifiedMarket[]>;
     protected fetchEventsImpl(params: EventFetchParams): Promise<UnifiedEvent[]>;
     fetchOHLCV(id: string, params: OHLCVParams): Promise<PriceCandle[]>;
-    fetchOrderBook(id: string): Promise<OrderBook>;
+    fetchOrderBook(id: string, side?: 'yes' | 'no'): Promise<OrderBook>;
     private isNoOutcome;
     fetchTrades(id: string, params: TradesParams | HistoryFilterParams): Promise<Trade[]>;
     fetchMyTrades(params?: MyTradesParams): Promise<UserTrade[]>;

package/dist/exchanges/limitless/index.js

@@ -129,14 +129,14 @@ class LimitlessExchange extends BaseExchange_1.PredictionMarketExchange {
         const rawPrices = await this.fetcher.fetchRawOHLCV(slug, params);
         return this.normalizer.normalizeOHLCV(rawPrices, params);
     }
-    async fetchOrderBook(id) {
+    async fetchOrderBook(id, side) {
         const slug = await this.resolveSlug(id);
         const rawOrderBook = await this.fetcher.fetchRawOrderBook(slug);
         const orderBook = this.normalizer.normalizeOrderBook(rawOrderBook, id);
         // The Limitless API always returns the Yes-side order book regardless
         // of which token is queried. If the caller asked for the No token,
         // flip: noBid = 1 - yesAsk, noAsk = 1 - yesBid.
-        const isNoToken = await this.isNoOutcome(id, slug);
+        const isNoToken = side === 'no' || (!side && await this.isNoOutcome(id, slug));
         if (isNoToken) {
             return {
                 bids: orderBook.asks.map((level) => ({ price: 1 - level.price, size: level.size }))

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-03T08:52:44.082Z
+ * Generated at: 2026-05-03T09:04:43.127Z
  * 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-03T08:52:44.082Z
+ * Generated at: 2026-05-03T09:04:43.127Z
  * 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-03T08:52:44.089Z
+ * Generated at: 2026-05-03T09:04:43.132Z
  * 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-03T08:52:44.089Z
+ * Generated at: 2026-05-03T09:04:43.132Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.opinionApiSpec = {

package/dist/exchanges/opinion/websocket.js

@@ -248,11 +248,18 @@ 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) => {
@@ -267,11 +274,18 @@ class OpinionWebSocket {
      * 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) => {

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-03T08:52:44.016Z
+ * Generated at: 2026-05-03T09:04:43.075Z
  * 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-03T08:52:44.016Z
+ * Generated at: 2026-05-03T09:04:43.075Z
  * 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-03T08:52:44.040Z
+ * Generated at: 2026-05-03T09:04:43.088Z
  * 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-03T08:52:44.040Z
+ * Generated at: 2026-05-03T09:04:43.088Z
  * 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-03T08:52:44.035Z
+ * Generated at: 2026-05-03T09:04:43.086Z
  * 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-03T08:52:44.035Z
+ * Generated at: 2026-05-03T09:04:43.086Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketGammaSpec = {

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-03T08:52:44.075Z
+ * Generated at: 2026-05-03T09:04:43.115Z
  * 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-03T08:52:44.075Z
+ * Generated at: 2026-05-03T09:04:43.115Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

package/dist/server/method-verbs.json

@@ -85,12 +85,17 @@
     ]
   },
   "fetchOrderBook": {
-    "verb": "get",
+    "verb": "post",
     "args": [
       {
         "name": "id",
         "kind": "string",
         "optional": false
+      },
+      {
+        "name": "side",
+        "kind": "unknown",
+        "optional": true
       }
     ]
   },

package/dist/server/openapi.yaml

@@ -630,16 +630,33 @@ paths:
                           $ref: '#/components/schemas/PriceCandle'
       description: Fetch historical OHLCV (candlestick) price data for a specific market outcome.
   '/api/{exchange}/fetchOrderBook':
-    get:
+    post:
       summary: Fetch Order Book
       operationId: fetchOrderBook
       parameters:
         - $ref: '#/components/parameters/ExchangeParam'
-        - in: query
-          name: id
-          required: true
-          schema:
-            type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              title: FetchOrderBookRequest
+              type: object
+              properties:
+                args:
+                  type: array
+                  minItems: 1
+                  maxItems: 2
+                  items:
+                    oneOf:
+                      - type: string
+                      - type: string
+                        enum:
+                          - 'yes'
+                          - 'no'
+                credentials:
+                  $ref: '#/components/schemas/ExchangeCredentials'
+              required:
+                - args
       responses:
         '200':
           description: Fetch Order Book response

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxt-core",
-  "version": "2.36.1",
+  "version": "2.37.1",
   "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.36.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.36.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.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",
     "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",