pmxt-core 2.34.3 → 2.35.0

package/dist/BaseExchange.d.ts

@@ -273,6 +273,15 @@ export interface PaginatedMarketsResult {
     /** Cursor to pass to the next call, or undefined if this is the last page */
     nextCursor?: string;
 }
+/** Shape returned by fetchEventsPaginated */
+export interface PaginatedEventsResult {
+    /** The page of unified events */
+    data: UnifiedEvent[];
+    /** Total number of events in the snapshot */
+    total: number;
+    /** Cursor to pass to the next call, or undefined if this is the last page */
+    nextCursor?: string;
+}
 export declare abstract class PredictionMarketExchange {
     [key: string]: any;
     verbose: boolean;
@@ -301,6 +310,7 @@ export declare abstract class PredictionMarketExchange {
     private _throttler;
     private _snapshotTTL;
     private _snapshot?;
+    private _eventSnapshot?;
     private apiDescriptors;
     constructor(credentials?: ExchangeCredentials, options?: ExchangeOptions);
     private _rateLimit;
@@ -365,6 +375,27 @@ export declare abstract class PredictionMarketExchange {
         cursor?: string;
         filter?: MarketFilterCriteria;
     }): Promise<PaginatedMarketsResult>;
+    /**
+     * Paginated variant of {@link fetchEvents}.
+     *
+     * On the first call (no `cursor`), all events are fetched from the exchange
+     * and cached in an in-memory snapshot. A cursor is returned along with the
+     * first page. Subsequent calls with that cursor serve additional pages
+     * directly from the cached snapshot -- no additional API calls are made.
+     *
+     * The snapshot is invalidated after `snapshotTTL` ms (configured via `ExchangeOptions`
+     * in the constructor). A request using a cursor from an expired snapshot throws
+     * `'Cursor has expired'`.
+     *
+     * @param params.limit      - Page size (default: return all events)
+     * @param params.cursor     - Opaque cursor returned by a previous call
+     * @returns PaginatedEventsResult with data, total, and optional nextCursor
+     */
+    fetchEventsPaginated(params?: {
+        limit?: number;
+        cursor?: string;
+        filter?: EventFilterCriteria;
+    }): Promise<PaginatedEventsResult>;
     /**
      * Fetch events with optional keyword search.
      * Events group related markets together (e.g., "Who will be Fed Chair?" contains multiple candidate markets).

package/dist/BaseExchange.js

@@ -46,6 +46,7 @@ class PredictionMarketExchange {
     // Snapshot state for cursor-based pagination
     _snapshotTTL;
     _snapshot;
+    _eventSnapshot;
     apiDescriptors = [];
     constructor(credentials, options) {
         this.credentials = credentials;
@@ -254,6 +255,61 @@ class PredictionMarketExchange {
         const nextCursor = limit < markets.length ? `${this._snapshot.id}:${limit}` : undefined;
         return { data: applyFilter(slice), total: markets.length, nextCursor };
     }
+    /**
+     * Paginated variant of {@link fetchEvents}.
+     *
+     * On the first call (no `cursor`), all events are fetched from the exchange
+     * and cached in an in-memory snapshot. A cursor is returned along with the
+     * first page. Subsequent calls with that cursor serve additional pages
+     * directly from the cached snapshot -- no additional API calls are made.
+     *
+     * The snapshot is invalidated after `snapshotTTL` ms (configured via `ExchangeOptions`
+     * in the constructor). A request using a cursor from an expired snapshot throws
+     * `'Cursor has expired'`.
+     *
+     * @param params.limit      - Page size (default: return all events)
+     * @param params.cursor     - Opaque cursor returned by a previous call
+     * @returns PaginatedEventsResult with data, total, and optional nextCursor
+     */
+    async fetchEventsPaginated(params) {
+        const limit = params?.limit;
+        const cursor = params?.cursor;
+        const filter = params?.filter;
+        const applyFilter = (events) => filter ? this.filterEvents(events, filter) : events;
+        if (cursor) {
+            const sep = cursor.indexOf(':');
+            const snapshotId = cursor.substring(0, sep);
+            const offset = parseInt(cursor.substring(sep + 1), 10);
+            if (!this._eventSnapshot ||
+                this._eventSnapshot.id !== snapshotId ||
+                (this._snapshotTTL > 0 && Date.now() - this._eventSnapshot.takenAt > this._snapshotTTL)) {
+                throw new Error('Cursor has expired');
+            }
+            const events = this._eventSnapshot.events;
+            const slice = limit !== undefined ? events.slice(offset, offset + limit) : events.slice(offset);
+            const nextOffset = offset + slice.length;
+            const nextCursor = nextOffset < events.length ? `${snapshotId}:${nextOffset}` : undefined;
+            return { data: applyFilter(slice), total: events.length, nextCursor };
+        }
+        // No cursor -- (re)fetch snapshot
+        if (!this._eventSnapshot ||
+            this._snapshotTTL === 0 ||
+            Date.now() - this._eventSnapshot.takenAt > this._snapshotTTL) {
+            const events = await this.fetchEventsImpl({});
+            this._eventSnapshot = {
+                events,
+                takenAt: Date.now(),
+                id: Math.random().toString(36).slice(2),
+            };
+        }
+        const events = this._eventSnapshot.events;
+        if (!limit) {
+            return { data: applyFilter(events), total: events.length, nextCursor: undefined };
+        }
+        const slice = events.slice(0, limit);
+        const nextCursor = limit < events.length ? `${this._eventSnapshot.id}:${limit}` : undefined;
+        return { data: applyFilter(slice), total: events.length, nextCursor };
+    }
     /**
      * Fetch events with optional keyword search.
      * Events group related markets together (e.g., "Who will be Fed Chair?" contains multiple candidate markets).

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-04-24T12:14:13.697Z
+ * Generated at: 2026-04-24T17:30:19.664Z
  * 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-04-24T12:14:13.697Z
+ * Generated at: 2026-04-24T17:30:19.664Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.kalshiApiSpec = {

package/dist/exchanges/kalshi/index.js

@@ -105,7 +105,7 @@ class KalshiExchange extends BaseExchange_1.PredictionMarketExchange {
     }
     async fetchEventsImpl(params) {
         const rawEvents = await this.fetcher.fetchRawEvents(params);
-        const limit = params?.limit || 10000;
+        const limit = params?.limit || 250000;
         const query = (params?.query || '').toLowerCase();
         const filtered = query
             ? rawEvents.filter((event) => (event.title || '').toLowerCase().includes(query))

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-04-24T12:14:13.734Z
+ * Generated at: 2026-04-24T17:30:19.700Z
  * 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-04-24T12:14:13.734Z
+ * Generated at: 2026-04-24T17:30:19.700Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.limitlessApiSpec = {

package/dist/exchanges/limitless/fetcher.js

@@ -211,7 +211,7 @@ class LimitlessFetcher {
         return markets;
     }
     async fetchRawEventsDefault(params) {
-        const limit = params?.limit || 10000;
+        const limit = params?.limit || 250000;
         let page = 1;
         const pageSize = 25;
         const MAX_PAGES = 40;

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-04-24T12:14:13.746Z
+ * Generated at: 2026-04-24T17:30:19.712Z
  * 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-04-24T12:14:13.746Z
+ * Generated at: 2026-04-24T17:30:19.712Z
  * 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-04-24T12:14:13.751Z
+ * Generated at: 2026-04-24T17:30:19.717Z
  * 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-04-24T12:14:13.751Z
+ * Generated at: 2026-04-24T17:30:19.717Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.opinionApiSpec = {

package/dist/exchanges/opinion/index.js

@@ -148,7 +148,7 @@ class OpinionExchange extends BaseExchange_1.PredictionMarketExchange {
     }
     async fetchEventsImpl(params) {
         const rawEvents = await this.fetcher.fetchRawEvents(params);
-        const limit = params.limit || 10000;
+        const limit = params.limit || 250000;
         const query = (params.query || '').toLowerCase();
         const filtered = query
             ? rawEvents.filter((raw) => (raw.marketTitle || '').toLowerCase().includes(query))

package/dist/exchanges/opinion/normalizer.js

@@ -30,8 +30,14 @@ class OpinionNormalizer {
         // Categorical: each child market becomes a separate UnifiedMarket
         const children = raw.childMarkets || [];
         const results = [];
+        const parentVolume24h = (0, utils_1.parseNumStr)(raw.volume24h);
+        const totalChildVolume = children.reduce((sum, c) => sum + (0, utils_1.parseNumStr)(c.volume), 0);
         for (const child of children) {
-            const market = this.normalizeChildMarket(child, raw);
+            const childVolume = (0, utils_1.parseNumStr)(child.volume);
+            const childVolume24h = totalChildVolume > 0
+                ? (childVolume / totalChildVolume) * parentVolume24h
+                : 0;
+            const market = this.normalizeChildMarket(child, raw, childVolume24h);
             if (market)
                 results.push(market);
         }
@@ -202,7 +208,7 @@ class OpinionNormalizer {
         (0, market_utils_1.addBinaryOutcomes)(market);
         return market;
     }
-    normalizeChildMarket(child, parent) {
+    normalizeChildMarket(child, parent, volume24h = 0) {
         if (!child)
             return null;
         const marketId = String(child.marketId);
@@ -230,8 +236,8 @@ class OpinionNormalizer {
             title: child.marketTitle || '',
             description: child.rules || '',
             outcomes: [yesOutcome, noOutcome],
-            resolutionDate: new Date((0, utils_1.toMillis)(child.cutoffAt || parent.cutoffAt)),
-            volume24h: 0, // child markets do not have volume24h
+            resolutionDate: new Date((0, utils_1.toMillis)(child.cutoffAt)),
+            volume24h,
             volume: (0, utils_1.parseNumStr)(child.volume),
             liquidity: 0,
             url: `https://opinion.trade/market/${child.marketId}`,

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-04-24T12:14:13.704Z
+ * Generated at: 2026-04-24T17:30:19.671Z
  * 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-04-24T12:14:13.704Z
+ * Generated at: 2026-04-24T17:30:19.671Z
  * 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-04-24T12:14:13.717Z
+ * Generated at: 2026-04-24T17:30:19.683Z
  * 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-04-24T12:14:13.717Z
+ * Generated at: 2026-04-24T17:30:19.683Z
  * 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-04-24T12:14:13.715Z
+ * Generated at: 2026-04-24T17:30:19.681Z
  * 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-04-24T12:14:13.715Z
+ * Generated at: 2026-04-24T17:30:19.681Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketGammaSpec = {

package/dist/exchanges/polymarket/fetcher.js

@@ -284,7 +284,7 @@ class PolymarketFetcher {
     // Private helpers -- Events
     // ------------------------------------------------------------------------
     async fetchRawEventsSearch(params) {
-        const limit = params.limit || 10000;
+        const limit = params.limit || 25000;
         let sortParam = 'volume';
         if (params.sort === 'newest')
             sortParam = 'startDate';
@@ -339,7 +339,7 @@ class PolymarketFetcher {
         }).slice(0, limit);
     }
     async fetchRawEventsDefault(params) {
-        const limit = params.limit || 10000;
+        const limit = params.limit || 25000;
         const status = params.status || 'active';
         let sortParam = 'volume';
         if (params.sort === 'newest')

package/dist/exchanges/polymarket/index.js

@@ -516,7 +516,7 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
         return rawEvents
             .map((raw) => this.normalizer.normalizeEvent(raw))
             .filter((e) => e !== null)
-            .slice(0, params.limit || 10000);
+            .slice(0, params.limit || 250000);
     }
     /**
      * Ensure authentication is initialized before trading operations.

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-04-24T12:14:13.739Z
+ * Generated at: 2026-04-24T17:30:19.705Z
  * 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-04-24T12:14:13.739Z
+ * Generated at: 2026-04-24T17:30:19.705Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

package/dist/exchanges/smarkets/index.js

@@ -148,7 +148,7 @@ class SmarketsExchange extends BaseExchange_1.PredictionMarketExchange {
     }
     async fetchEventsImpl(params) {
         const rawEvents = await this.fetcher.fetchRawEvents(params);
-        const limit = params?.limit || 10000;
+        const limit = params?.limit || 250000;
         const query = (params?.query || '').toLowerCase();
         const filtered = query
             ? rawEvents.filter((event) => (event.event.name || '').toLowerCase().includes(query))

package/dist/server/method-verbs.json

@@ -29,6 +29,16 @@
       }
     ]
   },
+  "fetchEventsPaginated": {
+    "verb": "get",
+    "args": [
+      {
+        "name": "params",
+        "kind": "object",
+        "optional": true
+      }
+    ]
+  },
   "fetchEvents": {
     "verb": "get",
     "args": [

package/dist/server/openapi.yaml

@@ -214,6 +214,45 @@ paths:
         previous call slice directly from the cached snapshot — no additional API calls are made. The snapshot is
         invalidated after `snapshotTTL` ms (configured via `ExchangeOptions` in the constructor). A request using a
         cursor from an expired snapshot throws `'Cursor has expired'`.
+  '/api/{exchange}/fetchEventsPaginated':
+    get:
+      summary: Fetch Events Paginated
+      operationId: fetchEventsPaginated
+      parameters:
+        - $ref: '#/components/parameters/ExchangeParam'
+        - in: query
+          name: limit
+          required: false
+          schema:
+            type: number
+        - in: query
+          name: cursor
+          required: false
+          schema:
+            type: string
+        - in: query
+          name: filter
+          required: false
+          schema:
+            $ref: '#/components/schemas/EventFilterCriteria'
+      responses:
+        '200':
+          description: Fetch Events Paginated response
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: '#/components/schemas/BaseResponse'
+                  - type: object
+                    properties:
+                      data:
+                        $ref: '#/components/schemas/PaginatedEventsResult'
+      description: >-
+        Paginated variant of {@link fetchEvents}. On the first call (no `cursor`), all events are fetched from the
+        exchange and cached in an in-memory snapshot. A cursor is returned along with the first page. Subsequent calls
+        with that cursor serve additional pages directly from the cached snapshot -- no additional API calls are made.
+        The snapshot is invalidated after `snapshotTTL` ms (configured via `ExchangeOptions` in the constructor). A
+        request using a cursor from an expired snapshot throws `'Cursor has expired'`.
   '/api/{exchange}/fetchEvents':
     get:
       summary: Fetch Events
@@ -2323,6 +2362,24 @@ components:
       required:
         - data
         - total
+    PaginatedEventsResult:
+      type: object
+      description: Shape returned by fetchEventsPaginated
+      properties:
+        data:
+          type: array
+          items:
+            $ref: '#/components/schemas/UnifiedEvent'
+          description: The page of unified events
+        total:
+          type: number
+          description: Total number of events in the snapshot
+        nextCursor:
+          type: string
+          description: 'Cursor to pass to the next call, or undefined if this is the last page'
+      required:
+        - data
+        - total
     MarketFilterParams:
       type: object
       properties:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxt-core",
-  "version": "2.34.3",
+  "version": "2.35.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.34.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.34.3,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.35.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.35.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",