pmxt-core 2.42.5 → 2.43.0

package/dist/exchanges/polymarket/utils.js

@@ -18,8 +18,11 @@ function mapMarketToUnified(event, market, options = {}) {
     let outcomeLabels = [];
     let outcomePrices = [];
     try {
-        outcomeLabels = typeof market.outcomes === 'string' ? JSON.parse(market.outcomes) : (market.outcomes || []);
-        outcomePrices = typeof market.outcomePrices === 'string' ? JSON.parse(market.outcomePrices) : (market.outcomePrices || []);
+        // Polymarket returns "null" (string) for resolved markets whose prices
+        // have been cleared. JSON.parse("null") returns JS null, which bypasses
+        // the || [] fallback, so we null-coalesce after parsing.
+        outcomeLabels = (typeof market.outcomes === 'string' ? JSON.parse(market.outcomes) : market.outcomes) || [];
+        outcomePrices = (typeof market.outcomePrices === 'string' ? JSON.parse(market.outcomePrices) : market.outcomePrices) || [];
     }
     catch (e) {
         console.warn(`Error parsing outcomes for market ${market.id}:`, e);
@@ -27,7 +30,7 @@ function mapMarketToUnified(event, market, options = {}) {
     // Extract CLOB token IDs for granular operations
     let clobTokenIds = [];
     try {
-        clobTokenIds = typeof market.clobTokenIds === 'string' ? JSON.parse(market.clobTokenIds) : (market.clobTokenIds || []);
+        clobTokenIds = (typeof market.clobTokenIds === 'string' ? JSON.parse(market.clobTokenIds) : market.clobTokenIds) || [];
     }
     catch (e) {
         console.warn(`Error parsing clobTokenIds for market ${market.id}:`, e);
@@ -122,10 +125,11 @@ function mapIntervalToFidelity(interval) {
 }
 /**
  * Fetch all results from Gamma API using parallel pagination for best DX.
- * Polymarket Gamma API has a hard limit of 500 results per request.
+ * Polymarket Gamma API silently clamps responses to 100 items per request
+ * and rejects offsets above 10,000.
  */
 async function paginateParallel(url, params, http, maxResults = 10000) {
-    const PAGE_SIZE = 500;
+    const PAGE_SIZE = 100;
     const initialLimit = Math.min(params.limit || PAGE_SIZE, PAGE_SIZE);
     // 1. Fetch the first page to see if we even need more
     const firstPageResponse = await http.get(url, {
@@ -137,11 +141,16 @@ async function paginateParallel(url, params, http, maxResults = 10000) {
         return firstPage;
     }
     // 2. Determine how many more pages to fetch
-    const targetLimit = params.limit || maxResults;
+    // Gamma rejects offsets above 10,000, so cap enumerable results at ~10,100.
+    const MAX_OFFSET = 10000;
+    const targetLimit = Math.min(params.limit || maxResults, MAX_OFFSET + PAGE_SIZE);
     const numPages = Math.ceil(targetLimit / PAGE_SIZE);
     const offsets = [];
     for (let i = 1; i < numPages; i++) {
-        offsets.push(i * PAGE_SIZE);
+        const offset = i * PAGE_SIZE;
+        if (offset > MAX_OFFSET)
+            break;
+        offsets.push(offset);
     }
     // 3. Fetch remaining pages in parallel
     const remainingPages = await Promise.all(offsets.map(async (offset) => {

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

@@ -46,7 +46,7 @@ export declare class PolymarketUSExchange extends PredictionMarketExchange {
     private slugFromId;
     protected fetchMarketsImpl(params?: MarketFetchParams): Promise<UnifiedMarket[]>;
     protected fetchEventsImpl(params: EventFetchParams): Promise<UnifiedEvent[]>;
-    fetchOrderBook(outcomeId: string): Promise<OrderBook>;
+    fetchOrderBook(outcomeId: string, _limit?: number, _params?: Record<string, any>): Promise<OrderBook>;
     fetchBalance(_address?: string): Promise<Balance[]>;
     fetchPositions(_address?: string): Promise<Position[]>;
     fetchMyTrades(params?: MyTradesParams): Promise<UserTrade[]>;
@@ -62,7 +62,7 @@ export declare class PolymarketUSExchange extends PredictionMarketExchange {
      * method calls `requireAuth()` up front.
      */
     private ensureWs;
-    watchOrderBook(outcomeId: string, _limit?: number): Promise<OrderBook>;
+    watchOrderBook(outcomeId: string, _limit?: number, _params?: Record<string, any>): Promise<OrderBook>;
     watchTrades(outcomeId: string, _address?: string, _since?: number, _limit?: number): Promise<Trade[]>;
     close(): Promise<void>;
 }

package/dist/exchanges/polymarket_us/index.js

@@ -166,7 +166,7 @@ class PolymarketUSExchange extends BaseExchange_1.PredictionMarketExchange {
             return events;
         });
     }
-    async fetchOrderBook(outcomeId) {
+    async fetchOrderBook(outcomeId, _limit, _params) {
         return this.run(async () => {
             const slug = this.slugFromId(outcomeId);
             const book = await this.client.markets.book(slug);
@@ -321,7 +321,7 @@ class PolymarketUSExchange extends BaseExchange_1.PredictionMarketExchange {
         }
         return this.wsWrapper;
     }
-    async watchOrderBook(outcomeId, _limit) {
+    async watchOrderBook(outcomeId, _limit, _params = {}) {
         return this.run(() => this.ensureWs().watchOrderBook(outcomeId));
     }
     async watchTrades(outcomeId, _address, _since, _limit) {

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-19T21:15:09.983Z
+ * Generated at: 2026-05-22T18:51:26.907Z
  * 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-19T21:15:09.983Z
+ * Generated at: 2026-05-22T18:51:26.907Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

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

@@ -27,7 +27,7 @@ export declare class ProbableExchange extends PredictionMarketExchange {
      * @returns The UnifiedEvent, or null if not found
      */
     getEventBySlug(slug: string): Promise<UnifiedEvent | null>;
-    fetchOrderBook(outcomeId: string): Promise<OrderBook>;
+    fetchOrderBook(outcomeId: string, _limit?: number, _params?: Record<string, any>): Promise<OrderBook>;
     fetchOHLCV(outcomeId: string, params: OHLCVParams): Promise<PriceCandle[]>;
     fetchMyTrades(params?: MyTradesParams): Promise<UserTrade[]>;
     fetchTrades(outcomeId: string, params: TradesParams | HistoryFilterParams): Promise<Trade[]>;
@@ -46,6 +46,6 @@ export declare class ProbableExchange extends PredictionMarketExchange {
     fetchOpenOrders(marketId?: string): Promise<Order[]>;
     fetchPositions(): Promise<Position[]>;
     fetchBalance(): Promise<Balance[]>;
-    watchOrderBook(outcomeId: string, limit?: number): Promise<OrderBook>;
+    watchOrderBook(outcomeId: string, limit?: number, _params?: Record<string, any>): Promise<OrderBook>;
     close(): Promise<void>;
 }

package/dist/exchanges/probable/index.js

@@ -116,7 +116,7 @@ class ProbableExchange extends BaseExchange_1.PredictionMarketExchange {
         }
         return event;
     }
-    async fetchOrderBook(outcomeId) {
+    async fetchOrderBook(outcomeId, _limit, _params) {
         const raw = await this.fetcher.fetchRawOrderBook(outcomeId);
         return this.normalizer.normalizeOrderBook(raw, outcomeId);
     }
@@ -362,7 +362,7 @@ class ProbableExchange extends BaseExchange_1.PredictionMarketExchange {
     // --------------------------------------------------------------------------
     // WebSocket Streaming (public, no auth needed)
     // --------------------------------------------------------------------------
-    async watchOrderBook(outcomeId, limit) {
+    async watchOrderBook(outcomeId, limit, _params = {}) {
         if (!this.ws) {
             this.ws = new websocket_1.ProbableWebSocket(this.wsConfig);
         }

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

@@ -18,7 +18,7 @@ export declare class SmarketsExchange extends PredictionMarketExchange {
     private requireAuth;
     protected fetchMarketsImpl(params?: MarketFilterParams): Promise<UnifiedMarket[]>;
     protected fetchEventsImpl(params: EventFetchParams): Promise<UnifiedEvent[]>;
-    fetchOrderBook(outcomeId: string): Promise<OrderBook>;
+    fetchOrderBook(outcomeId: string, _limit?: number, _params?: Record<string, any>): Promise<OrderBook>;
     fetchTrades(outcomeId: string, params: TradesParams | HistoryFilterParams): Promise<Trade[]>;
     fetchBalance(): Promise<Balance[]>;
     fetchMyTrades(params?: MyTradesParams): Promise<UserTrade[]>;

package/dist/exchanges/smarkets/index.js

@@ -158,7 +158,7 @@ class SmarketsExchange extends BaseExchange_1.PredictionMarketExchange {
             .filter((e) => e !== null)
             .slice(0, limit);
     }
-    async fetchOrderBook(outcomeId) {
+    async fetchOrderBook(outcomeId, _limit, _params) {
         const raw = await this.fetcher.fetchRawOrderBook(outcomeId);
         return this.normalizer.normalizeOrderBook(raw, outcomeId);
     }

package/dist/router/Router.d.ts

@@ -8,7 +8,7 @@ export declare class Router extends PredictionMarketExchange {
     get name(): string;
     protected fetchMarketsImpl(params?: MarketFetchParams): Promise<UnifiedMarket[]>;
     protected fetchEventsImpl(params?: EventFetchParams): Promise<UnifiedEvent[]>;
-    fetchOrderBook(outcomeId: string, side?: 'yes' | 'no'): Promise<OrderBook>;
+    fetchOrderBook(outcomeId: string, limit?: number, params?: Record<string, any>): Promise<OrderBook>;
     fetchMarketMatches(params?: FetchMarketMatchesParams): Promise<MatchResult[]>;
     /**
      * Browse mode: fetch all matched market pairs from the catalog.

package/dist/router/Router.js

@@ -70,12 +70,12 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
     // -----------------------------------------------------------------------
     // Unified orderbook (cross-exchange merge)
     // -----------------------------------------------------------------------
-    async fetchOrderBook(outcomeId, side) {
+    async fetchOrderBook(outcomeId, limit, params) {
         const exchangeNames = Object.keys(this.exchanges);
         if (exchangeNames.length === 0) {
             throw new Error('Router requires exchange instances for fetchOrderBook. Pass exchanges in RouterOptions.');
         }
-        const resolvedSide = side ?? 'yes';
+        const resolvedSide = params?.side ?? 'yes';
         // Find identity matches across venues
         const matches = await this.fetchMarketMatches({
             marketId: outcomeId,
@@ -93,7 +93,7 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
             if (!outcome)
                 continue;
             fetchPromises.push(exchange
-                .fetchOrderBook(outcome.outcomeId, resolvedSide)
+                .fetchOrderBook(outcome.outcomeId, undefined, { side: resolvedSide })
                 .then((book) => ({ book, venue: venueName, error: null }))
                 .catch((error) => ({ book: null, venue: venueName, error })));
         }
@@ -102,7 +102,7 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
             if (matchedVenues.has(name))
                 continue;
             fetchPromises.push(exchange
-                .fetchOrderBook(outcomeId, resolvedSide)
+                .fetchOrderBook(outcomeId, undefined, { side: resolvedSide })
                 .then((book) => ({ book, venue: name, error: null }))
                 .catch((error) => ({ book: null, venue: name, error })));
         }

package/dist/router/e2e-orderbook.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/router/e2e-orderbook.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * E2E test for Router.fetchOrderBook — run with:
+ *   npx ts-node src/router/e2e-orderbook.ts
+ *
+ * Requires PMXT_API_KEY in env.
+ */
+const Router_1 = require("./Router");
+const polymarket_1 = require("../exchanges/polymarket");
+const limitless_1 = require("../exchanges/limitless");
+async function main() {
+    const apiKey = process.env.PMXT_API_KEY;
+    if (!apiKey) {
+        console.error('Set PMXT_API_KEY');
+        process.exit(1);
+    }
+    const polymarket = new polymarket_1.PolymarketExchange({});
+    const limitless = new limitless_1.LimitlessExchange({});
+    const router = new Router_1.Router({
+        apiKey,
+        exchanges: { polymarket, limitless },
+    });
+    // Morocco FIFA World Cup market on Polymarket
+    const marketId = 'f017596d-4d53-49d5-a7d6-36ed9c37fdc4';
+    console.log('Fetching unified orderbook for Morocco (Polymarket + Limitless)...');
+    console.log(`Input market ID: ${marketId}`);
+    console.log('---');
+    const book = await router.fetchOrderBook(marketId, undefined, { side: 'yes' });
+    console.log(`Bids: ${book.bids.length} levels`);
+    console.log(`Asks: ${book.asks.length} levels`);
+    console.log('Top 5 bids:', book.bids.slice(0, 5));
+    console.log('Top 5 asks:', book.asks.slice(0, 5));
+    // Verify we got data from BOTH exchanges
+    // Polymarket top bid was 0.016, Limitless had 0.002
+    // If merged correctly, we should see both
+    const hasPoly = book.bids.some((b) => b.price === 0.016);
+    const hasLimitless = book.bids.some((b) => b.price === 0.002);
+    console.log('---');
+    console.log(`Has Polymarket levels: ${hasPoly}`);
+    console.log(`Has Limitless levels: ${hasLimitless}`);
+    if (hasPoly && hasLimitless) {
+        console.log('SUCCESS: Merged orderbook contains levels from both exchanges');
+    }
+    else if (!hasPoly && hasLimitless) {
+        console.log('PARTIAL: Only Limitless book (source market fetch failed)');
+    }
+    else if (hasPoly && !hasLimitless) {
+        console.log('PARTIAL: Only Polymarket book (matched market fetch failed)');
+    }
+    else {
+        console.log('FAIL: No data from either exchange');
+    }
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

package/dist/server/method-verbs.json

@@ -93,12 +93,27 @@
         "optional": false
       },
       {
-        "name": "side",
-        "kind": "string",
+        "name": "limit",
+        "kind": "number",
+        "optional": true
+      },
+      {
+        "name": "params",
+        "kind": "object",
         "optional": true
       }
     ]
   },
+  "fetchOrderBooks": {
+    "verb": "post",
+    "args": [
+      {
+        "name": "outcomeIds",
+        "kind": "unknown",
+        "optional": false
+      }
+    ]
+  },
   "fetchTrades": {
     "verb": "get",
     "args": [
@@ -306,6 +321,11 @@
         "name": "limit",
         "kind": "number",
         "optional": true
+      },
+      {
+        "name": "params",
+        "kind": "object",
+        "optional": true
       }
     ]
   },
@@ -321,6 +341,11 @@
         "name": "limit",
         "kind": "number",
         "optional": true
+      },
+      {
+        "name": "params",
+        "kind": "object",
+        "optional": true
       }
     ]
   },

package/dist/server/openapi.yaml

@@ -641,10 +641,10 @@ paths:
           schema:
             type: string
         - in: query
-          name: side
+          name: limit
           required: false
           schema:
-            type: string
+            type: number
       responses:
         '200':
           description: Fetch Order Book response
@@ -657,9 +657,49 @@ paths:
                     properties:
                       data:
                         $ref: '#/components/schemas/OrderBook'
+      description: Fetch the order book (bids/asks) for a specific outcome.
+  '/api/{exchange}/fetchOrderBooks':
+    post:
+      summary: Fetch Order Books
+      operationId: fetchOrderBooks
+      parameters:
+        - $ref: '#/components/parameters/ExchangeParam'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              title: FetchOrderBooksRequest
+              type: object
+              properties:
+                args:
+                  type: array
+                  maxItems: 1
+                  items:
+                    type: array
+                    items:
+                      type: string
+                  minItems: 1
+                credentials:
+                  $ref: '#/components/schemas/ExchangeCredentials'
+              required:
+                - args
+      responses:
+        '200':
+          description: Fetch Order Books response
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: '#/components/schemas/BaseResponse'
+                  - type: object
+                    properties:
+                      data:
+                        type: object
+                        additionalProperties:
+                          $ref: '#/components/schemas/OrderBook'
       description: >-
-        Fetch the current order book (bids/asks) for a specific outcome. Essential for calculating spread, depth, and
-        execution prices.
+        Batch variant of {@link fetchOrderBook}. Fetches order books for multiple outcomes in a single request where the
+        exchange supports it.
   '/api/{exchange}/fetchTrades':
     get:
       summary: Fetch Trades
@@ -2473,6 +2513,9 @@ components:
           - metaculus
           - smarkets
           - polymarket_us
+          - gemini-titan
+          - hyperliquid
+          - mock
           - router
       required: true
       description: The prediction market exchange to target.
@@ -2737,6 +2780,9 @@ components:
         timestamp:
           type: number
           description: Unix timestamp in milliseconds when the snapshot was taken.
+        datetime:
+          type: string
+          description: ISO 8601 datetime string of the snapshot (CCXT-compatible).
       required:
         - bids
         - asks

package/dist/types.d.ts

@@ -119,6 +119,8 @@ export interface OrderBook {
     asks: OrderLevel[];
     /** Unix timestamp in milliseconds when the snapshot was taken. */
     timestamp?: number;
+    /** ISO 8601 datetime string of the snapshot (CCXT-compatible). */
+    datetime?: string;
 }
 export interface Trade {
     /** The unique identifier for this trade. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxt-core",
-  "version": "2.42.5",
+  "version": "2.43.0",
   "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.42.5,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.42.5,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.43.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.43.0,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",