pmxtjs 2.34.3 → 2.35.0

package/dist/esm/generated/src/apis/DefaultApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime.js';
-import type { BaseResponse, BuildOrder200Response, BuildOrderRequest, CancelOrderRequest, CloseRequest, CompareMarketPrices200Response, CompareMarketPricesRequest, CreateOrder200Response, CreateOrderRequest, EventFilterCriteria, FetchArbitrage200Response, FetchBalance200Response, FetchEvent200Response, FetchEventMatches200Response, FetchEvents200Response, FetchMarket200Response, FetchMarketMatches200Response, FetchMarkets200Response, FetchMarketsPaginated200Response, FetchMyTrades200Response, FetchOHLCV200Response, FetchOpenOrders200Response, FetchOrderBook200Response, FetchPositions200Response, FetchTrades200Response, FilterEventsRequest, FilterMarketsRequest, GetExecutionPrice200Response, GetExecutionPriceDetailed200Response, GetExecutionPriceDetailedRequest, GetExecutionPriceRequest, HealthCheck200Response, LoadMarkets200Response, LoadMarketsRequest, MarketFilterCriteria, SubmitOrderRequest, UnifiedEvent, UnifiedMarket, UnwatchAddressRequest, UnwatchOrderBookRequest, WatchAddress200Response, WatchAddressRequest, WatchOrderBookRequest, WatchTradesRequest } from '../models/index.js';
+import type { BaseResponse, BuildOrder200Response, BuildOrderRequest, CancelOrderRequest, CloseRequest, CompareMarketPrices200Response, CompareMarketPricesRequest, CreateOrder200Response, CreateOrderRequest, EventFilterCriteria, FetchArbitrage200Response, FetchBalance200Response, FetchEvent200Response, FetchEventMatches200Response, FetchEvents200Response, FetchEventsPaginated200Response, FetchMarket200Response, FetchMarketMatches200Response, FetchMarkets200Response, FetchMarketsPaginated200Response, FetchMyTrades200Response, FetchOHLCV200Response, FetchOpenOrders200Response, FetchOrderBook200Response, FetchPositions200Response, FetchTrades200Response, FilterEventsRequest, FilterMarketsRequest, GetExecutionPrice200Response, GetExecutionPriceDetailed200Response, GetExecutionPriceDetailedRequest, GetExecutionPriceRequest, HealthCheck200Response, LoadMarkets200Response, LoadMarketsRequest, MarketFilterCriteria, SubmitOrderRequest, UnifiedEvent, UnifiedMarket, UnwatchAddressRequest, UnwatchOrderBookRequest, WatchAddress200Response, WatchAddressRequest, WatchOrderBookRequest, WatchTradesRequest } from '../models/index.js';
 export interface BuildOrderOperationRequest {
     exchange: BuildOrderOperationExchangeEnum;
     buildOrderRequest?: BuildOrderRequest;
@@ -96,6 +96,12 @@ export interface FetchEventsRequest {
     category?: string;
     tags?: Array<string>;
 }
+export interface FetchEventsPaginatedRequest {
+    exchange: FetchEventsPaginatedExchangeEnum;
+    limit?: number;
+    cursor?: string;
+    filter?: EventFilterCriteria;
+}
 export interface FetchHedgesRequest {
     exchange: FetchHedgesExchangeEnum;
     market?: UnifiedMarket;
@@ -369,6 +375,16 @@ export declare class DefaultApi extends runtime.BaseAPI {
      * Fetch Events
      */
     fetchEvents(requestParameters: FetchEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchEvents200Response>;
+    /**
+     * 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
+     */
+    fetchEventsPaginatedRaw(requestParameters: FetchEventsPaginatedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FetchEventsPaginated200Response>>;
+    /**
+     * 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
+     */
+    fetchEventsPaginated(requestParameters: FetchEventsPaginatedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchEventsPaginated200Response>;
     /**
      * 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
@@ -910,6 +926,24 @@ export declare const FetchEventsSearchInEnum: {
     readonly Both: "both";
 };
 export type FetchEventsSearchInEnum = typeof FetchEventsSearchInEnum[keyof typeof FetchEventsSearchInEnum];
+/**
+ * @export
+ */
+export declare const FetchEventsPaginatedExchangeEnum: {
+    readonly Polymarket: "polymarket";
+    readonly Kalshi: "kalshi";
+    readonly KalshiDemo: "kalshi-demo";
+    readonly Limitless: "limitless";
+    readonly Probable: "probable";
+    readonly Baozi: "baozi";
+    readonly Myriad: "myriad";
+    readonly Opinion: "opinion";
+    readonly Metaculus: "metaculus";
+    readonly Smarkets: "smarkets";
+    readonly PolymarketUs: "polymarket_us";
+    readonly Router: "router";
+};
+export type FetchEventsPaginatedExchangeEnum = typeof FetchEventsPaginatedExchangeEnum[keyof typeof FetchEventsPaginatedExchangeEnum];
 /**
  * @export
  */

package/dist/esm/generated/src/apis/DefaultApi.js

@@ -12,7 +12,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime.js';
-import { BaseResponseFromJSON, BuildOrder200ResponseFromJSON, BuildOrderRequestToJSON, CancelOrderRequestToJSON, CloseRequestToJSON, CompareMarketPrices200ResponseFromJSON, CompareMarketPricesRequestToJSON, CreateOrder200ResponseFromJSON, CreateOrderRequestToJSON, FetchArbitrage200ResponseFromJSON, FetchBalance200ResponseFromJSON, FetchEvent200ResponseFromJSON, FetchEventMatches200ResponseFromJSON, FetchEvents200ResponseFromJSON, FetchMarket200ResponseFromJSON, FetchMarketMatches200ResponseFromJSON, FetchMarkets200ResponseFromJSON, FetchMarketsPaginated200ResponseFromJSON, FetchMyTrades200ResponseFromJSON, FetchOHLCV200ResponseFromJSON, FetchOpenOrders200ResponseFromJSON, FetchOrderBook200ResponseFromJSON, FetchPositions200ResponseFromJSON, FetchTrades200ResponseFromJSON, FilterEventsRequestToJSON, FilterMarketsRequestToJSON, GetExecutionPrice200ResponseFromJSON, GetExecutionPriceDetailed200ResponseFromJSON, GetExecutionPriceDetailedRequestToJSON, GetExecutionPriceRequestToJSON, HealthCheck200ResponseFromJSON, LoadMarkets200ResponseFromJSON, LoadMarketsRequestToJSON, SubmitOrderRequestToJSON, UnwatchAddressRequestToJSON, UnwatchOrderBookRequestToJSON, WatchAddress200ResponseFromJSON, WatchAddressRequestToJSON, WatchOrderBookRequestToJSON, WatchTradesRequestToJSON, } from '../models/index.js';
+import { BaseResponseFromJSON, BuildOrder200ResponseFromJSON, BuildOrderRequestToJSON, CancelOrderRequestToJSON, CloseRequestToJSON, CompareMarketPrices200ResponseFromJSON, CompareMarketPricesRequestToJSON, CreateOrder200ResponseFromJSON, CreateOrderRequestToJSON, FetchArbitrage200ResponseFromJSON, FetchBalance200ResponseFromJSON, FetchEvent200ResponseFromJSON, FetchEventMatches200ResponseFromJSON, FetchEvents200ResponseFromJSON, FetchEventsPaginated200ResponseFromJSON, FetchMarket200ResponseFromJSON, FetchMarketMatches200ResponseFromJSON, FetchMarkets200ResponseFromJSON, FetchMarketsPaginated200ResponseFromJSON, FetchMyTrades200ResponseFromJSON, FetchOHLCV200ResponseFromJSON, FetchOpenOrders200ResponseFromJSON, FetchOrderBook200ResponseFromJSON, FetchPositions200ResponseFromJSON, FetchTrades200ResponseFromJSON, FilterEventsRequestToJSON, FilterMarketsRequestToJSON, GetExecutionPrice200ResponseFromJSON, GetExecutionPriceDetailed200ResponseFromJSON, GetExecutionPriceDetailedRequestToJSON, GetExecutionPriceRequestToJSON, HealthCheck200ResponseFromJSON, LoadMarkets200ResponseFromJSON, LoadMarketsRequestToJSON, SubmitOrderRequestToJSON, UnwatchAddressRequestToJSON, UnwatchOrderBookRequestToJSON, WatchAddress200ResponseFromJSON, WatchAddressRequestToJSON, WatchOrderBookRequestToJSON, WatchTradesRequestToJSON, } from '../models/index.js';
 /**
  *
  */
@@ -491,6 +491,43 @@ export class DefaultApi extends runtime.BaseAPI {
         const response = await this.fetchEventsRaw(requestParameters, initOverrides);
         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, initOverrides) {
+        if (requestParameters['exchange'] == null) {
+            throw new runtime.RequiredError('exchange', 'Required parameter "exchange" was null or undefined when calling fetchEventsPaginated().');
+        }
+        const queryParameters = {};
+        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 = {};
+        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, initOverrides) {
+        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
@@ -1702,6 +1739,23 @@ export const FetchEventsSearchInEnum = {
     Description: 'description',
     Both: 'both'
 };
+/**
+ * @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'
+};
 /**
  * @export
  */

package/dist/esm/generated/src/models/FetchEventsPaginated200Response.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 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 { ErrorDetail } from './ErrorDetail.js';
+import type { PaginatedEventsResult } from './PaginatedEventsResult.js';
+/**
+ *
+ * @export
+ * @interface FetchEventsPaginated200Response
+ */
+export interface FetchEventsPaginated200Response {
+    /**
+     *
+     * @type {boolean}
+     * @memberof FetchEventsPaginated200Response
+     */
+    success?: boolean;
+    /**
+     *
+     * @type {ErrorDetail}
+     * @memberof FetchEventsPaginated200Response
+     */
+    error?: ErrorDetail;
+    /**
+     *
+     * @type {PaginatedEventsResult}
+     * @memberof FetchEventsPaginated200Response
+     */
+    data?: PaginatedEventsResult;
+}
+/**
+ * Check if a given object implements the FetchEventsPaginated200Response interface.
+ */
+export declare function instanceOfFetchEventsPaginated200Response(value: object): value is FetchEventsPaginated200Response;
+export declare function FetchEventsPaginated200ResponseFromJSON(json: any): FetchEventsPaginated200Response;
+export declare function FetchEventsPaginated200ResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): FetchEventsPaginated200Response;
+export declare function FetchEventsPaginated200ResponseToJSON(json: any): FetchEventsPaginated200Response;
+export declare function FetchEventsPaginated200ResponseToJSONTyped(value?: FetchEventsPaginated200Response | null, ignoreDiscriminator?: boolean): any;

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

@@ -0,0 +1,47 @@
+/* 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.
+ */
+import { ErrorDetailFromJSON, ErrorDetailToJSON, } from './ErrorDetail.js';
+import { PaginatedEventsResultFromJSON, PaginatedEventsResultToJSON, } from './PaginatedEventsResult.js';
+/**
+ * Check if a given object implements the FetchEventsPaginated200Response interface.
+ */
+export function instanceOfFetchEventsPaginated200Response(value) {
+    return true;
+}
+export function FetchEventsPaginated200ResponseFromJSON(json) {
+    return FetchEventsPaginated200ResponseFromJSONTyped(json, false);
+}
+export function FetchEventsPaginated200ResponseFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'success': json['success'] == null ? undefined : json['success'],
+        'error': json['error'] == null ? undefined : ErrorDetailFromJSON(json['error']),
+        'data': json['data'] == null ? undefined : PaginatedEventsResultFromJSON(json['data']),
+    };
+}
+export function FetchEventsPaginated200ResponseToJSON(json) {
+    return FetchEventsPaginated200ResponseToJSONTyped(json, false);
+}
+export function FetchEventsPaginated200ResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'success': value['success'],
+        'error': ErrorDetailToJSON(value['error']),
+        'data': PaginatedEventsResultToJSON(value['data']),
+    };
+}

package/dist/esm/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.js';
+/**
+ * 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/esm/generated/src/models/PaginatedEventsResult.js

@@ -0,0 +1,50 @@
+/* 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.
+ */
+import { UnifiedEventFromJSON, UnifiedEventToJSON, } from './UnifiedEvent.js';
+/**
+ * Check if a given object implements the PaginatedEventsResult interface.
+ */
+export function instanceOfPaginatedEventsResult(value) {
+    if (!('data' in value) || value['data'] === undefined)
+        return false;
+    if (!('total' in value) || value['total'] === undefined)
+        return false;
+    return true;
+}
+export function PaginatedEventsResultFromJSON(json) {
+    return PaginatedEventsResultFromJSONTyped(json, false);
+}
+export function PaginatedEventsResultFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'data': (json['data'].map(UnifiedEventFromJSON)),
+        'total': json['total'],
+        'nextCursor': json['nextCursor'] == null ? undefined : json['nextCursor'],
+    };
+}
+export function PaginatedEventsResultToJSON(json) {
+    return PaginatedEventsResultToJSONTyped(json, false);
+}
+export function PaginatedEventsResultToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'data': (value['data'].map(UnifiedEventToJSON)),
+        'total': value['total'],
+        'nextCursor': value['nextCursor'],
+    };
+}

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

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

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

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

package/dist/esm/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/esm/pmxt/client.js

@@ -611,6 +611,38 @@ export class Exchange {
             throw new 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 fromServerError(body.error);
+                }
+                throw new 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 PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to fetchEventsPaginated: ${error}`);
+        }
+    }
     async fetchMarket(params) {
         await this.initPromise;
         try {

package/dist/esm/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/dist/generated/src/apis/DefaultApi.d.ts

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { BaseResponse, BuildOrder200Response, BuildOrderRequest, CancelOrderRequest, CloseRequest, CompareMarketPrices200Response, CompareMarketPricesRequest, CreateOrder200Response, CreateOrderRequest, EventFilterCriteria, FetchArbitrage200Response, FetchBalance200Response, FetchEvent200Response, FetchEventMatches200Response, FetchEvents200Response, FetchMarket200Response, FetchMarketMatches200Response, FetchMarkets200Response, FetchMarketsPaginated200Response, FetchMyTrades200Response, FetchOHLCV200Response, FetchOpenOrders200Response, FetchOrderBook200Response, FetchPositions200Response, FetchTrades200Response, FilterEventsRequest, FilterMarketsRequest, GetExecutionPrice200Response, GetExecutionPriceDetailed200Response, GetExecutionPriceDetailedRequest, GetExecutionPriceRequest, HealthCheck200Response, LoadMarkets200Response, LoadMarketsRequest, MarketFilterCriteria, SubmitOrderRequest, UnifiedEvent, UnifiedMarket, UnwatchAddressRequest, UnwatchOrderBookRequest, WatchAddress200Response, WatchAddressRequest, WatchOrderBookRequest, WatchTradesRequest } from '../models/index';
+import type { BaseResponse, BuildOrder200Response, BuildOrderRequest, CancelOrderRequest, CloseRequest, CompareMarketPrices200Response, CompareMarketPricesRequest, CreateOrder200Response, CreateOrderRequest, EventFilterCriteria, FetchArbitrage200Response, FetchBalance200Response, FetchEvent200Response, FetchEventMatches200Response, FetchEvents200Response, FetchEventsPaginated200Response, FetchMarket200Response, FetchMarketMatches200Response, FetchMarkets200Response, FetchMarketsPaginated200Response, FetchMyTrades200Response, FetchOHLCV200Response, FetchOpenOrders200Response, FetchOrderBook200Response, FetchPositions200Response, FetchTrades200Response, FilterEventsRequest, FilterMarketsRequest, GetExecutionPrice200Response, GetExecutionPriceDetailed200Response, GetExecutionPriceDetailedRequest, GetExecutionPriceRequest, HealthCheck200Response, LoadMarkets200Response, LoadMarketsRequest, MarketFilterCriteria, SubmitOrderRequest, UnifiedEvent, UnifiedMarket, UnwatchAddressRequest, UnwatchOrderBookRequest, WatchAddress200Response, WatchAddressRequest, WatchOrderBookRequest, WatchTradesRequest } from '../models/index';
 export interface BuildOrderOperationRequest {
     exchange: BuildOrderOperationExchangeEnum;
     buildOrderRequest?: BuildOrderRequest;
@@ -96,6 +96,12 @@ export interface FetchEventsRequest {
     category?: string;
     tags?: Array<string>;
 }
+export interface FetchEventsPaginatedRequest {
+    exchange: FetchEventsPaginatedExchangeEnum;
+    limit?: number;
+    cursor?: string;
+    filter?: EventFilterCriteria;
+}
 export interface FetchHedgesRequest {
     exchange: FetchHedgesExchangeEnum;
     market?: UnifiedMarket;
@@ -369,6 +375,16 @@ export declare class DefaultApi extends runtime.BaseAPI {
      * Fetch Events
      */
     fetchEvents(requestParameters: FetchEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchEvents200Response>;
+    /**
+     * 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
+     */
+    fetchEventsPaginatedRaw(requestParameters: FetchEventsPaginatedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FetchEventsPaginated200Response>>;
+    /**
+     * 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
+     */
+    fetchEventsPaginated(requestParameters: FetchEventsPaginatedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchEventsPaginated200Response>;
     /**
      * 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
@@ -910,6 +926,24 @@ export declare const FetchEventsSearchInEnum: {
     readonly Both: "both";
 };
 export type FetchEventsSearchInEnum = typeof FetchEventsSearchInEnum[keyof typeof FetchEventsSearchInEnum];
+/**
+ * @export
+ */
+export declare const FetchEventsPaginatedExchangeEnum: {
+    readonly Polymarket: "polymarket";
+    readonly Kalshi: "kalshi";
+    readonly KalshiDemo: "kalshi-demo";
+    readonly Limitless: "limitless";
+    readonly Probable: "probable";
+    readonly Baozi: "baozi";
+    readonly Myriad: "myriad";
+    readonly Opinion: "opinion";
+    readonly Metaculus: "metaculus";
+    readonly Smarkets: "smarkets";
+    readonly PolymarketUs: "polymarket_us";
+    readonly Router: "router";
+};
+export type FetchEventsPaginatedExchangeEnum = typeof FetchEventsPaginatedExchangeEnum[keyof typeof FetchEventsPaginatedExchangeEnum];
 /**
  * @export
  */

package/dist/generated/src/apis/DefaultApi.js

@@ -46,8 +46,8 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SubmitOrderOperationExchangeEnum = exports.LoadMarketsOperationExchangeEnum = exports.GetExecutionPriceDetailedOperationExchangeEnum = exports.GetExecutionPriceOperationExchangeEnum = exports.FilterMarketsOperationExchangeEnum = exports.FilterEventsOperationExchangeEnum = exports.FetchTradesExchangeEnum = exports.FetchPositionsExchangeEnum = exports.FetchOrderBookExchangeEnum = exports.FetchOrderExchangeEnum = exports.FetchOpenOrdersExchangeEnum = exports.FetchOHLCVResolutionEnum = exports.FetchOHLCVExchangeEnum = exports.FetchMyTradesExchangeEnum = exports.FetchMatchesRelationEnum = exports.FetchMatchesExchangeEnum = exports.FetchMarketsPaginatedExchangeEnum = exports.FetchMarketsSearchInEnum = exports.FetchMarketsStatusEnum = exports.FetchMarketsSortEnum = exports.FetchMarketsExchangeEnum = exports.FetchMarketMatchesRelationEnum = exports.FetchMarketMatchesExchangeEnum = exports.FetchMarketSearchInEnum = exports.FetchMarketStatusEnum = exports.FetchMarketSortEnum = exports.FetchMarketExchangeEnum = exports.FetchHedgesRelationEnum = exports.FetchHedgesExchangeEnum = exports.FetchEventsSearchInEnum = exports.FetchEventsStatusEnum = exports.FetchEventsSortEnum = exports.FetchEventsExchangeEnum = exports.FetchEventMatchesRelationEnum = exports.FetchEventMatchesExchangeEnum = exports.FetchEventSearchInEnum = exports.FetchEventStatusEnum = exports.FetchEventSortEnum = exports.FetchEventExchangeEnum = exports.FetchClosedOrdersExchangeEnum = exports.FetchBalanceExchangeEnum = exports.FetchArbitrageRelationsEnum = exports.FetchArbitrageExchangeEnum = exports.FetchAllOrdersExchangeEnum = exports.CreateOrderOperationExchangeEnum = exports.CompareMarketPricesOperationExchangeEnum = exports.CloseOperationExchangeEnum = exports.CancelOrderOperationExchangeEnum = exports.BuildOrderOperationExchangeEnum = exports.DefaultApi = void 0;
-exports.WatchTradesOperationExchangeEnum = exports.WatchOrderBookOperationExchangeEnum = exports.WatchAddressOperationExchangeEnum = exports.UnwatchOrderBookOperationExchangeEnum = exports.UnwatchAddressOperationExchangeEnum = void 0;
+exports.LoadMarketsOperationExchangeEnum = exports.GetExecutionPriceDetailedOperationExchangeEnum = exports.GetExecutionPriceOperationExchangeEnum = exports.FilterMarketsOperationExchangeEnum = exports.FilterEventsOperationExchangeEnum = exports.FetchTradesExchangeEnum = exports.FetchPositionsExchangeEnum = exports.FetchOrderBookExchangeEnum = exports.FetchOrderExchangeEnum = exports.FetchOpenOrdersExchangeEnum = exports.FetchOHLCVResolutionEnum = exports.FetchOHLCVExchangeEnum = exports.FetchMyTradesExchangeEnum = exports.FetchMatchesRelationEnum = exports.FetchMatchesExchangeEnum = exports.FetchMarketsPaginatedExchangeEnum = exports.FetchMarketsSearchInEnum = exports.FetchMarketsStatusEnum = exports.FetchMarketsSortEnum = exports.FetchMarketsExchangeEnum = exports.FetchMarketMatchesRelationEnum = exports.FetchMarketMatchesExchangeEnum = exports.FetchMarketSearchInEnum = exports.FetchMarketStatusEnum = exports.FetchMarketSortEnum = exports.FetchMarketExchangeEnum = exports.FetchHedgesRelationEnum = exports.FetchHedgesExchangeEnum = exports.FetchEventsPaginatedExchangeEnum = exports.FetchEventsSearchInEnum = exports.FetchEventsStatusEnum = exports.FetchEventsSortEnum = exports.FetchEventsExchangeEnum = exports.FetchEventMatchesRelationEnum = exports.FetchEventMatchesExchangeEnum = exports.FetchEventSearchInEnum = exports.FetchEventStatusEnum = exports.FetchEventSortEnum = exports.FetchEventExchangeEnum = exports.FetchClosedOrdersExchangeEnum = exports.FetchBalanceExchangeEnum = exports.FetchArbitrageRelationsEnum = exports.FetchArbitrageExchangeEnum = exports.FetchAllOrdersExchangeEnum = exports.CreateOrderOperationExchangeEnum = exports.CompareMarketPricesOperationExchangeEnum = exports.CloseOperationExchangeEnum = exports.CancelOrderOperationExchangeEnum = exports.BuildOrderOperationExchangeEnum = exports.DefaultApi = void 0;
+exports.WatchTradesOperationExchangeEnum = exports.WatchOrderBookOperationExchangeEnum = exports.WatchAddressOperationExchangeEnum = exports.UnwatchOrderBookOperationExchangeEnum = exports.UnwatchAddressOperationExchangeEnum = exports.SubmitOrderOperationExchangeEnum = void 0;
 const runtime = __importStar(require("../runtime"));
 const index_1 = require("../models/index");
 /**
@@ -528,6 +528,43 @@ class DefaultApi extends runtime.BaseAPI {
         const response = await this.fetchEventsRaw(requestParameters, initOverrides);
         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, initOverrides) {
+        if (requestParameters['exchange'] == null) {
+            throw new runtime.RequiredError('exchange', 'Required parameter "exchange" was null or undefined when calling fetchEventsPaginated().');
+        }
+        const queryParameters = {};
+        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 = {};
+        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) => (0, index_1.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, initOverrides) {
+        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
@@ -1740,6 +1777,23 @@ exports.FetchEventsSearchInEnum = {
     Description: 'description',
     Both: 'both'
 };
+/**
+ * @export
+ */
+exports.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'
+};
 /**
  * @export
  */

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

@@ -0,0 +1,46 @@
+/**
+ * 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 { ErrorDetail } from './ErrorDetail';
+import type { PaginatedEventsResult } from './PaginatedEventsResult';
+/**
+ *
+ * @export
+ * @interface FetchEventsPaginated200Response
+ */
+export interface FetchEventsPaginated200Response {
+    /**
+     *
+     * @type {boolean}
+     * @memberof FetchEventsPaginated200Response
+     */
+    success?: boolean;
+    /**
+     *
+     * @type {ErrorDetail}
+     * @memberof FetchEventsPaginated200Response
+     */
+    error?: ErrorDetail;
+    /**
+     *
+     * @type {PaginatedEventsResult}
+     * @memberof FetchEventsPaginated200Response
+     */
+    data?: PaginatedEventsResult;
+}
+/**
+ * Check if a given object implements the FetchEventsPaginated200Response interface.
+ */
+export declare function instanceOfFetchEventsPaginated200Response(value: object): value is FetchEventsPaginated200Response;
+export declare function FetchEventsPaginated200ResponseFromJSON(json: any): FetchEventsPaginated200Response;
+export declare function FetchEventsPaginated200ResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): FetchEventsPaginated200Response;
+export declare function FetchEventsPaginated200ResponseToJSON(json: any): FetchEventsPaginated200Response;
+export declare function FetchEventsPaginated200ResponseToJSONTyped(value?: FetchEventsPaginated200Response | null, ignoreDiscriminator?: boolean): any;