pmxtjs 2.34.3 → 2.35.2

package/dist/generated/src/models/FetchEventsPaginated200Response.js

@@ -0,0 +1,54 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * PMXT Sidecar API
+ * A unified local sidecar API for prediction markets (Polymarket, Kalshi, Limitless). This API acts as a JSON-RPC-style gateway. Each endpoint corresponds to a specific method on the generic exchange implementation.
+ *
+ * The version of the OpenAPI document: 0.4.4
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instanceOfFetchEventsPaginated200Response = instanceOfFetchEventsPaginated200Response;
+exports.FetchEventsPaginated200ResponseFromJSON = FetchEventsPaginated200ResponseFromJSON;
+exports.FetchEventsPaginated200ResponseFromJSONTyped = FetchEventsPaginated200ResponseFromJSONTyped;
+exports.FetchEventsPaginated200ResponseToJSON = FetchEventsPaginated200ResponseToJSON;
+exports.FetchEventsPaginated200ResponseToJSONTyped = FetchEventsPaginated200ResponseToJSONTyped;
+const ErrorDetail_1 = require("./ErrorDetail");
+const PaginatedEventsResult_1 = require("./PaginatedEventsResult");
+/**
+ * Check if a given object implements the FetchEventsPaginated200Response interface.
+ */
+function instanceOfFetchEventsPaginated200Response(value) {
+    return true;
+}
+function FetchEventsPaginated200ResponseFromJSON(json) {
+    return FetchEventsPaginated200ResponseFromJSONTyped(json, false);
+}
+function FetchEventsPaginated200ResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'success': json['success'] == null ? undefined : json['success'],
+        'error': json['error'] == null ? undefined : (0, ErrorDetail_1.ErrorDetailFromJSON)(json['error']),
+        'data': json['data'] == null ? undefined : (0, PaginatedEventsResult_1.PaginatedEventsResultFromJSON)(json['data']),
+    };
+}
+function FetchEventsPaginated200ResponseToJSON(json) {
+    return FetchEventsPaginated200ResponseToJSONTyped(json, false);
+}
+function FetchEventsPaginated200ResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'success': value['success'],
+        'error': (0, ErrorDetail_1.ErrorDetailToJSON)(value['error']),
+        'data': (0, PaginatedEventsResult_1.PaginatedEventsResultToJSON)(value['data']),
+    };
+}

package/dist/generated/src/models/PaginatedEventsResult.d.ts

@@ -0,0 +1,45 @@
+/**
+ * PMXT Sidecar API
+ * A unified local sidecar API for prediction markets (Polymarket, Kalshi, Limitless). This API acts as a JSON-RPC-style gateway. Each endpoint corresponds to a specific method on the generic exchange implementation.
+ *
+ * The version of the OpenAPI document: 0.4.4
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+import type { UnifiedEvent } from './UnifiedEvent';
+/**
+ * Shape returned by fetchEventsPaginated
+ * @export
+ * @interface PaginatedEventsResult
+ */
+export interface PaginatedEventsResult {
+    /**
+     * The page of unified events
+     * @type {Array<UnifiedEvent>}
+     * @memberof PaginatedEventsResult
+     */
+    data: Array<UnifiedEvent>;
+    /**
+     * Total number of events in the snapshot
+     * @type {number}
+     * @memberof PaginatedEventsResult
+     */
+    total: number;
+    /**
+     * Cursor to pass to the next call, or undefined if this is the last page
+     * @type {string}
+     * @memberof PaginatedEventsResult
+     */
+    nextCursor?: string;
+}
+/**
+ * Check if a given object implements the PaginatedEventsResult interface.
+ */
+export declare function instanceOfPaginatedEventsResult(value: object): value is PaginatedEventsResult;
+export declare function PaginatedEventsResultFromJSON(json: any): PaginatedEventsResult;
+export declare function PaginatedEventsResultFromJSONTyped(json: any, ignoreDiscriminator: boolean): PaginatedEventsResult;
+export declare function PaginatedEventsResultToJSON(json: any): PaginatedEventsResult;
+export declare function PaginatedEventsResultToJSONTyped(value?: PaginatedEventsResult | null, ignoreDiscriminator?: boolean): any;

package/dist/generated/src/models/PaginatedEventsResult.js

@@ -0,0 +1,57 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * PMXT Sidecar API
+ * A unified local sidecar API for prediction markets (Polymarket, Kalshi, Limitless). This API acts as a JSON-RPC-style gateway. Each endpoint corresponds to a specific method on the generic exchange implementation.
+ *
+ * The version of the OpenAPI document: 0.4.4
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instanceOfPaginatedEventsResult = instanceOfPaginatedEventsResult;
+exports.PaginatedEventsResultFromJSON = PaginatedEventsResultFromJSON;
+exports.PaginatedEventsResultFromJSONTyped = PaginatedEventsResultFromJSONTyped;
+exports.PaginatedEventsResultToJSON = PaginatedEventsResultToJSON;
+exports.PaginatedEventsResultToJSONTyped = PaginatedEventsResultToJSONTyped;
+const UnifiedEvent_1 = require("./UnifiedEvent");
+/**
+ * Check if a given object implements the PaginatedEventsResult interface.
+ */
+function instanceOfPaginatedEventsResult(value) {
+    if (!('data' in value) || value['data'] === undefined)
+        return false;
+    if (!('total' in value) || value['total'] === undefined)
+        return false;
+    return true;
+}
+function PaginatedEventsResultFromJSON(json) {
+    return PaginatedEventsResultFromJSONTyped(json, false);
+}
+function PaginatedEventsResultFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'data': (json['data'].map(UnifiedEvent_1.UnifiedEventFromJSON)),
+        'total': json['total'],
+        'nextCursor': json['nextCursor'] == null ? undefined : json['nextCursor'],
+    };
+}
+function PaginatedEventsResultToJSON(json) {
+    return PaginatedEventsResultToJSONTyped(json, false);
+}
+function PaginatedEventsResultToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'data': (value['data'].map(UnifiedEvent_1.UnifiedEventToJSON)),
+        'total': value['total'],
+        'nextCursor': value['nextCursor'],
+    };
+}

package/dist/generated/src/models/index.d.ts

@@ -29,6 +29,7 @@ export * from './FetchEvent200Response';
 export * from './FetchEventMatches200Response';
 export * from './FetchEventMatchesParams';
 export * from './FetchEvents200Response';
+export * from './FetchEventsPaginated200Response';
 export * from './FetchMarket200Response';
 export * from './FetchMarketMatches200Response';
 export * from './FetchMarketMatchesParams';
@@ -69,6 +70,7 @@ export * from './Order';
 export * from './OrderBook';
 export * from './OrderHistoryParams';
 export * from './OrderLevel';
+export * from './PaginatedEventsResult';
 export * from './PaginatedMarketsResult';
 export * from './Position';
 export * from './PriceCandle';

package/dist/generated/src/models/index.js

@@ -47,6 +47,7 @@ __exportStar(require("./FetchEvent200Response"), exports);
 __exportStar(require("./FetchEventMatches200Response"), exports);
 __exportStar(require("./FetchEventMatchesParams"), exports);
 __exportStar(require("./FetchEvents200Response"), exports);
+__exportStar(require("./FetchEventsPaginated200Response"), exports);
 __exportStar(require("./FetchMarket200Response"), exports);
 __exportStar(require("./FetchMarketMatches200Response"), exports);
 __exportStar(require("./FetchMarketMatchesParams"), exports);
@@ -87,6 +88,7 @@ __exportStar(require("./Order"), exports);
 __exportStar(require("./OrderBook"), exports);
 __exportStar(require("./OrderHistoryParams"), exports);
 __exportStar(require("./OrderLevel"), exports);
+__exportStar(require("./PaginatedEventsResult"), exports);
 __exportStar(require("./PaginatedMarketsResult"), exports);
 __exportStar(require("./Position"), exports);
 __exportStar(require("./PriceCandle"), exports);

package/dist/pmxt/client.d.ts

@@ -5,7 +5,7 @@
  * OpenAPI client, matching the Python API exactly.
  */
 import { Configuration, DefaultApi, ExchangeCredentials } from "../generated/src/index.js";
-import { Balance, BuiltOrder, CreateOrderParams, EventFilterCriteria, EventFilterFunction, ExecutionPriceResult, MarketFilterCriteria, MarketFilterFunction, MarketOutcome, Order, OrderBook, PaginatedMarketsResult, Position, PriceCandle, SubscribedAddressSnapshot, SubscriptionOption, Trade, UnifiedEvent, UnifiedMarket, UserTrade } from "./models.js";
+import { Balance, BuiltOrder, CreateOrderParams, EventFilterCriteria, EventFilterFunction, ExecutionPriceResult, MarketFilterCriteria, MarketFilterFunction, MarketOutcome, Order, OrderBook, PaginatedMarketsResult, PaginatedEventsResult, Position, PriceCandle, SubscribedAddressSnapshot, SubscriptionOption, Trade, UnifiedEvent, UnifiedMarket, UserTrade } from "./models.js";
 import { ServerManager } from "./server-manager.js";
 /**
  * Base exchange client options.
@@ -136,6 +136,7 @@ export declare abstract class Exchange {
     fetchMarkets(params?: any): Promise<UnifiedMarket[]>;
     fetchMarketsPaginated(params?: any): Promise<PaginatedMarketsResult>;
     fetchEvents(params?: any): Promise<UnifiedEvent[]>;
+    fetchEventsPaginated(params?: any): Promise<PaginatedEventsResult>;
     fetchMarket(params?: any): Promise<UnifiedMarket>;
     fetchEvent(params?: any): Promise<UnifiedEvent>;
     fetchOrderBook(id: string): Promise<OrderBook>;

package/dist/pmxt/client.js

@@ -614,6 +614,38 @@ class Exchange {
             throw new errors_js_1.PmxtError(`Failed to fetchEvents: ${error}`);
         }
     }
+    async fetchEventsPaginated(params) {
+        await this.initPromise;
+        try {
+            const args = [];
+            if (params !== undefined)
+                args.push(params);
+            const response = await this.fetchWithRetry(`${this.resolveBaseUrl()}/api/${this.exchangeName}/fetchEventsPaginated`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', ...this.getAuthHeaders() },
+                body: JSON.stringify({ args, credentials: this.getCredentials() }),
+            });
+            if (!response.ok) {
+                const body = await response.json().catch(() => ({}));
+                if (body.error && typeof body.error === "object") {
+                    throw (0, errors_js_1.fromServerError)(body.error);
+                }
+                throw new errors_js_1.PmxtError(body.error?.message || response.statusText);
+            }
+            const json = await response.json();
+            const data = this.handleResponse(json);
+            return {
+                data: (data.data || []).map(convertEvent),
+                total: data.total,
+                nextCursor: data.nextCursor,
+            };
+        }
+        catch (error) {
+            if (error instanceof errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to fetchEventsPaginated: ${error}`);
+        }
+    }
     async fetchMarket(params) {
         await this.initPromise;
         try {

package/dist/pmxt/models.d.ts

@@ -155,6 +155,17 @@ export interface PaginatedMarketsResult {
     /** Cursor for the next page (pass to fetchMarketsPaginated) */
     nextCursor?: string;
 }
+/**
+ * Result of a paginated event fetch.
+ */
+export interface PaginatedEventsResult {
+    /** The events for this page */
+    data: UnifiedEvent[];
+    /** Total number of events (if available) */
+    total?: number;
+    /** Cursor for the next page (pass to fetchEventsPaginated) */
+    nextCursor?: string;
+}
 /**
  * A historical trade.
  */

package/generated/.openapi-generator/FILES

@@ -34,6 +34,7 @@ docs/FetchEvent200Response.md
 docs/FetchEventMatches200Response.md
 docs/FetchEventMatchesParams.md
 docs/FetchEvents200Response.md
+docs/FetchEventsPaginated200Response.md
 docs/FetchMarket200Response.md
 docs/FetchMarketMatches200Response.md
 docs/FetchMarketMatchesParams.md
@@ -74,6 +75,7 @@ docs/Order.md
 docs/OrderBook.md
 docs/OrderHistoryParams.md
 docs/OrderLevel.md
+docs/PaginatedEventsResult.md
 docs/PaginatedMarketsResult.md
 docs/Position.md
 docs/PriceCandle.md
@@ -127,6 +129,7 @@ src/models/FetchEvent200Response.ts
 src/models/FetchEventMatches200Response.ts
 src/models/FetchEventMatchesParams.ts
 src/models/FetchEvents200Response.ts
+src/models/FetchEventsPaginated200Response.ts
 src/models/FetchMarket200Response.ts
 src/models/FetchMarketMatches200Response.ts
 src/models/FetchMarketMatchesParams.ts
@@ -167,6 +170,7 @@ src/models/Order.ts
 src/models/OrderBook.ts
 src/models/OrderHistoryParams.ts
 src/models/OrderLevel.ts
+src/models/PaginatedEventsResult.ts
 src/models/PaginatedMarketsResult.ts
 src/models/Position.ts
 src/models/PriceCandle.ts

package/generated/docs/DefaultApi.md

@@ -16,6 +16,7 @@ All URIs are relative to *http://localhost:3847*
 | [**fetchEvent**](DefaultApi.md#fetchevent) | **GET** /api/{exchange}/fetchEvent | Fetch Event |
 | [**fetchEventMatches**](DefaultApi.md#fetcheventmatches) | **GET** /api/{exchange}/fetchEventMatches | Find Similar Events |
 | [**fetchEvents**](DefaultApi.md#fetchevents) | **GET** /api/{exchange}/fetchEvents | Fetch Events |
+| [**fetchEventsPaginated**](DefaultApi.md#fetcheventspaginated) | **GET** /api/{exchange}/fetchEventsPaginated | Fetch Events Paginated |
 | [**fetchHedges**](DefaultApi.md#fetchhedges) | **GET** /api/{exchange}/fetchHedges | Find Hedging Opportunities |
 | [**fetchMarket**](DefaultApi.md#fetchmarket) | **GET** /api/{exchange}/fetchMarket | Fetch Market |
 | [**fetchMarketMatches**](DefaultApi.md#fetchmarketmatches) | **GET** /api/{exchange}/fetchMarketMatches | Find Similar Markets |
@@ -991,6 +992,82 @@ No authorization required
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
+## fetchEventsPaginated
+
+> FetchEventsPaginated200Response fetchEventsPaginated(exchange, limit, cursor, filter)
+
+Fetch Events Paginated
+
+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\'`.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  DefaultApi,
+} from 'pmxtjs';
+import type { FetchEventsPaginatedRequest } from 'pmxtjs';
+
+async function example() {
+  console.log("🚀 Testing pmxtjs SDK...");
+  const api = new DefaultApi();
+
+  const body = {
+    // 'polymarket' | 'kalshi' | 'kalshi-demo' | 'limitless' | 'probable' | 'baozi' | 'myriad' | 'opinion' | 'metaculus' | 'smarkets' | 'polymarket_us' | 'router' | The prediction market exchange to target.
+    exchange: exchange_example,
+    // number (optional)
+    limit: 8.14,
+    // string (optional)
+    cursor: cursor_example,
+    // EventFilterCriteria (optional)
+    filter: ...,
+  } satisfies FetchEventsPaginatedRequest;
+
+  try {
+    const data = await api.fetchEventsPaginated(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **exchange** | `polymarket`, `kalshi`, `kalshi-demo`, `limitless`, `probable`, `baozi`, `myriad`, `opinion`, `metaculus`, `smarkets`, `polymarket_us`, `router` | The prediction market exchange to target. | [Defaults to `undefined`] [Enum: polymarket, kalshi, kalshi-demo, limitless, probable, baozi, myriad, opinion, metaculus, smarkets, polymarket_us, router] |
+| **limit** | `number` |  | [Optional] [Defaults to `undefined`] |
+| **cursor** | `string` |  | [Optional] [Defaults to `undefined`] |
+| **filter** | [](.md) |  | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**FetchEventsPaginated200Response**](FetchEventsPaginated200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Fetch Events Paginated response |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
 ## fetchHedges
 
 > CompareMarketPrices200Response fetchHedges(exchange, market, marketId, slug, url, relation, minConfidence, limit, includePrices)

package/generated/docs/FetchEventsPaginated200Response.md

@@ -0,0 +1,38 @@
+
+# FetchEventsPaginated200Response
+
+
+## Properties
+
+Name | Type
+------------ | -------------
+`success` | boolean
+`error` | [ErrorDetail](ErrorDetail.md)
+`data` | [PaginatedEventsResult](PaginatedEventsResult.md)
+
+## Example
+
+```typescript
+import type { FetchEventsPaginated200Response } from 'pmxtjs'
+
+// TODO: Update the object below with actual values
+const example = {
+  "success": true,
+  "error": null,
+  "data": null,
+} satisfies FetchEventsPaginated200Response
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as FetchEventsPaginated200Response
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/generated/docs/PaginatedEventsResult.md

@@ -0,0 +1,39 @@
+
+# PaginatedEventsResult
+
+Shape returned by fetchEventsPaginated
+
+## Properties
+
+Name | Type
+------------ | -------------
+`data` | [Array<UnifiedEvent>](UnifiedEvent.md)
+`total` | number
+`nextCursor` | string
+
+## Example
+
+```typescript
+import type { PaginatedEventsResult } from 'pmxtjs'
+
+// TODO: Update the object below with actual values
+const example = {
+  "data": null,
+  "total": null,
+  "nextCursor": null,
+} satisfies PaginatedEventsResult
+
+console.log(example)
+
+// Convert the instance to a JSON string
+const exampleJSON: string = JSON.stringify(example)
+console.log(exampleJSON)
+
+// Parse the JSON string back to an object
+const exampleParsed = JSON.parse(exampleJSON) as PaginatedEventsResult
+console.log(exampleParsed)
+```
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+

package/generated/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxtjs",
-  "version": "2.34.3",
+  "version": "2.35.2",
   "description": "OpenAPI client for pmxtjs",
   "author": "OpenAPI-Generator",
   "repository": {

package/generated/src/apis/DefaultApi.ts

@@ -30,6 +30,7 @@ import type {
   FetchEvent200Response,
   FetchEventMatches200Response,
   FetchEvents200Response,
+  FetchEventsPaginated200Response,
   FetchMarket200Response,
   FetchMarketMatches200Response,
   FetchMarkets200Response,
@@ -91,6 +92,8 @@ import {
     FetchEventMatches200ResponseToJSON,
     FetchEvents200ResponseFromJSON,
     FetchEvents200ResponseToJSON,
+    FetchEventsPaginated200ResponseFromJSON,
+    FetchEventsPaginated200ResponseToJSON,
     FetchMarket200ResponseFromJSON,
     FetchMarket200ResponseToJSON,
     FetchMarketMatches200ResponseFromJSON,
@@ -248,6 +251,13 @@ export interface FetchEventsRequest {
     tags?: Array<string>;
 }
 
+export interface FetchEventsPaginatedRequest {
+    exchange: FetchEventsPaginatedExchangeEnum;
+    limit?: number;
+    cursor?: string;
+    filter?: EventFilterCriteria;
+}
+
 export interface FetchHedgesRequest {
     exchange: FetchHedgesExchangeEnum;
     market?: UnifiedMarket;
@@ -1085,6 +1095,57 @@ export class DefaultApi extends runtime.BaseAPI {
         return await response.value();
     }
 
+    /**
+     * 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\'`.
+     * Fetch Events Paginated
+     */
+    async fetchEventsPaginatedRaw(requestParameters: FetchEventsPaginatedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FetchEventsPaginated200Response>> {
+        if (requestParameters['exchange'] == null) {
+            throw new runtime.RequiredError(
+                'exchange',
+                'Required parameter "exchange" was null or undefined when calling fetchEventsPaginated().'
+            );
+        }
+
+        const queryParameters: any = {};
+
+        if (requestParameters['limit'] != null) {
+            queryParameters['limit'] = requestParameters['limit'];
+        }
+
+        if (requestParameters['cursor'] != null) {
+            queryParameters['cursor'] = requestParameters['cursor'];
+        }
+
+        if (requestParameters['filter'] != null) {
+            queryParameters['filter'] = requestParameters['filter'];
+        }
+
+        const headerParameters: runtime.HTTPHeaders = {};
+
+
+        let urlPath = `/api/{exchange}/fetchEventsPaginated`;
+        urlPath = urlPath.replace(`{${"exchange"}}`, encodeURIComponent(String(requestParameters['exchange'])));
+
+        const response = await this.request({
+            path: urlPath,
+            method: 'GET',
+            headers: headerParameters,
+            query: queryParameters,
+        }, initOverrides);
+
+        return new runtime.JSONApiResponse(response, (jsonValue) => FetchEventsPaginated200ResponseFromJSON(jsonValue));
+    }
+
+    /**
+     * 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\'`.
+     * Fetch Events Paginated
+     */
+    async fetchEventsPaginated(requestParameters: FetchEventsPaginatedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchEventsPaginated200Response> {
+        const response = await this.fetchEventsPaginatedRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+
     /**
      * Find hedging opportunities across venues. Discovers subset/superset market relationships where one market\'s outcome implies another, enabling cross-venue hedging strategies with live prices.
      * Find Hedging Opportunities
@@ -2685,6 +2746,24 @@ export const FetchEventsSearchInEnum = {
     Both: 'both'
 } as const;
 export type FetchEventsSearchInEnum = typeof FetchEventsSearchInEnum[keyof typeof FetchEventsSearchInEnum];
+/**
+ * @export
+ */
+export const FetchEventsPaginatedExchangeEnum = {
+    Polymarket: 'polymarket',
+    Kalshi: 'kalshi',
+    KalshiDemo: 'kalshi-demo',
+    Limitless: 'limitless',
+    Probable: 'probable',
+    Baozi: 'baozi',
+    Myriad: 'myriad',
+    Opinion: 'opinion',
+    Metaculus: 'metaculus',
+    Smarkets: 'smarkets',
+    PolymarketUs: 'polymarket_us',
+    Router: 'router'
+} as const;
+export type FetchEventsPaginatedExchangeEnum = typeof FetchEventsPaginatedExchangeEnum[keyof typeof FetchEventsPaginatedExchangeEnum];
 /**
  * @export
  */