pmxtjs 2.47.0 → 2.48.0

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, FetchEventsPaginated200Response, FetchMarket200Response, FetchMarketMatches200Response, FetchMarkets200Response, FetchMarketsPaginated200Response, FetchMatchedMarkets200Response, FetchMyTrades200Response, FetchOHLCV200Response, FetchOpenOrders200Response, FetchOrderBook200Response, FetchOrderBooks200Response, FetchOrderBooksRequest, FetchPositions200Response, FetchTrades200Response, FilterEventsRequest, FilterMarketsRequest, GetExecutionPrice200Response, GetExecutionPriceDetailed200Response, GetExecutionPriceDetailedRequest, GetExecutionPriceRequest, HealthCheck200Response, LoadMarkets200Response, LoadMarketsRequest, MarketFilterCriteria, SubmitOrderRequest, UnifiedEvent, UnifiedMarket } 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, FetchMatchedMarkets200Response, FetchMyTrades200Response, FetchOHLCV200Response, FetchOpenOrders200Response, FetchOrderBook200Response, FetchOrderBooks200Response, FetchOrderBooksRequest, FetchPositions200Response, FetchSeries200Response, FetchTrades200Response, FilterEventsRequest, FilterMarketsRequest, GetExecutionPrice200Response, GetExecutionPriceDetailed200Response, GetExecutionPriceDetailedRequest, GetExecutionPriceRequest, HealthCheck200Response, LoadMarkets200Response, LoadMarketsRequest, MarketFilterCriteria, SubmitOrderRequest, UnifiedEvent, UnifiedMarket } from '../models/index';
 export interface BuildOrderOperationRequest {
     exchange: BuildOrderOperationExchangeEnum;
     buildOrderRequest?: BuildOrderRequest;
@@ -69,6 +69,7 @@ export interface FetchEventRequest {
     searchIn?: FetchEventSearchInEnum;
     eventId?: string;
     slug?: string;
+    series?: string;
     filter?: EventFilterCriteria;
     category?: string;
     tags?: Array<string>;
@@ -96,6 +97,7 @@ export interface FetchEventsRequest {
     searchIn?: FetchEventsSearchInEnum;
     eventId?: string;
     slug?: string;
+    series?: string;
     filter?: EventFilterCriteria;
     category?: string;
     tags?: Array<string>;
@@ -243,6 +245,9 @@ export interface FetchRelatedMarketsRequest {
     minDifference?: number;
     sort?: FetchRelatedMarketsSortEnum;
 }
+export interface FetchSeriesRequest {
+    exchange: FetchSeriesExchangeEnum;
+}
 export interface FetchTradesRequest {
     exchange: FetchTradesExchangeEnum;
     outcomeId: string;
@@ -552,6 +557,16 @@ export declare class DefaultApi extends runtime.BaseAPI {
      * Find Related Markets
      */
     fetchRelatedMarkets(requestParameters: FetchRelatedMarketsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CompareMarketPrices200Response>;
+    /**
+     * Fetch the recurring series (fourth tier above Event -> Market -> Outcome) that this venue exposes. Returns an empty array on venues without a series concept (Limitless, Smarkets, Probable, Metaculus, Baozi, Hyperliquid, SuiBets, Polymarket US). - `params.id` -> a single matching series with its events populated where supported. - no params -> the full list, typically without nested events for payload size.
+     * Fetch Series
+     */
+    fetchSeriesRaw(requestParameters: FetchSeriesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FetchSeries200Response>>;
+    /**
+     * Fetch the recurring series (fourth tier above Event -> Market -> Outcome) that this venue exposes. Returns an empty array on venues without a series concept (Limitless, Smarkets, Probable, Metaculus, Baozi, Hyperliquid, SuiBets, Polymarket US). - `params.id` -> a single matching series with its events populated where supported. - no params -> the full list, typically without nested events for payload size.
+     * Fetch Series
+     */
+    fetchSeries(requestParameters: FetchSeriesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchSeries200Response>;
     /**
      * Fetch raw trade history for a specific outcome.
      * Fetch Trades
@@ -1358,6 +1373,28 @@ export declare const FetchRelatedMarketsSortEnum: {
     readonly PriceDifference: "priceDifference";
 };
 export type FetchRelatedMarketsSortEnum = typeof FetchRelatedMarketsSortEnum[keyof typeof FetchRelatedMarketsSortEnum];
+/**
+ * @export
+ */
+export declare const FetchSeriesExchangeEnum: {
+    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 GeminiTitan: "gemini-titan";
+    readonly Hyperliquid: "hyperliquid";
+    readonly Suibets: "suibets";
+    readonly Mock: "mock";
+    readonly Router: "router";
+};
+export type FetchSeriesExchangeEnum = typeof FetchSeriesExchangeEnum[keyof typeof FetchSeriesExchangeEnum];
 /**
  * @export
  */

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

@@ -47,7 +47,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FetchRelatedMarketsExchangeEnum = exports.FetchPositionsExchangeEnum = exports.FetchOrderBooksOperationExchangeEnum = exports.FetchOrderBookSideEnum = exports.FetchOrderBookExchangeEnum = exports.FetchOrderExchangeEnum = exports.FetchOpenOrdersExchangeEnum = exports.FetchOHLCVExchangeEnum = exports.FetchMyTradesExchangeEnum = exports.FetchMatchedPricesRelationsEnum = exports.FetchMatchedPricesExchangeEnum = exports.FetchMatchedMarketsRelationsEnum = exports.FetchMatchedMarketsExchangeEnum = exports.FetchMarketsPaginatedExchangeEnum = exports.FetchMarketsSearchInEnum = exports.FetchMarketsStatusEnum = exports.FetchMarketsSortEnum = exports.FetchMarketsExchangeEnum = exports.FetchMarketMatchesSortEnum = exports.FetchMarketMatchesRelationEnum = exports.FetchMarketMatchesExchangeEnum = exports.FetchMarketSearchInEnum = exports.FetchMarketStatusEnum = exports.FetchMarketSortEnum = exports.FetchMarketExchangeEnum = exports.FetchHedgesSortEnum = 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.SubmitOrderOperationExchangeEnum = exports.LoadMarketsOperationExchangeEnum = exports.GetExecutionPriceDetailedOperationExchangeEnum = exports.GetExecutionPriceOperationExchangeEnum = exports.FilterMarketsOperationExchangeEnum = exports.FilterEventsOperationExchangeEnum = exports.FetchTradesExchangeEnum = exports.FetchRelatedMarketsSortEnum = exports.FetchRelatedMarketsRelationEnum = void 0;
+exports.SubmitOrderOperationExchangeEnum = exports.LoadMarketsOperationExchangeEnum = exports.GetExecutionPriceDetailedOperationExchangeEnum = exports.GetExecutionPriceOperationExchangeEnum = exports.FilterMarketsOperationExchangeEnum = exports.FilterEventsOperationExchangeEnum = exports.FetchTradesExchangeEnum = exports.FetchSeriesExchangeEnum = exports.FetchRelatedMarketsSortEnum = exports.FetchRelatedMarketsRelationEnum = void 0;
 const runtime = __importStar(require("../runtime"));
 const index_1 = require("../models/index");
 /**
@@ -393,6 +393,9 @@ class DefaultApi extends runtime.BaseAPI {
         if (requestParameters['slug'] != null) {
             queryParameters['slug'] = requestParameters['slug'];
         }
+        if (requestParameters['series'] != null) {
+            queryParameters['series'] = requestParameters['series'];
+        }
         if (requestParameters['filter'] != null) {
             queryParameters['filter'] = requestParameters['filter'];
         }
@@ -512,6 +515,9 @@ class DefaultApi extends runtime.BaseAPI {
         if (requestParameters['slug'] != null) {
             queryParameters['slug'] = requestParameters['slug'];
         }
+        if (requestParameters['series'] != null) {
+            queryParameters['series'] = requestParameters['series'];
+        }
         if (requestParameters['filter'] != null) {
             queryParameters['filter'] = requestParameters['filter'];
         }
@@ -1279,6 +1285,34 @@ class DefaultApi extends runtime.BaseAPI {
         const response = await this.fetchRelatedMarketsRaw(requestParameters, initOverrides);
         return await response.value();
     }
+    /**
+     * Fetch the recurring series (fourth tier above Event -> Market -> Outcome) that this venue exposes. Returns an empty array on venues without a series concept (Limitless, Smarkets, Probable, Metaculus, Baozi, Hyperliquid, SuiBets, Polymarket US). - `params.id` -> a single matching series with its events populated where supported. - no params -> the full list, typically without nested events for payload size.
+     * Fetch Series
+     */
+    async fetchSeriesRaw(requestParameters, initOverrides) {
+        if (requestParameters['exchange'] == null) {
+            throw new runtime.RequiredError('exchange', 'Required parameter "exchange" was null or undefined when calling fetchSeries().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        let urlPath = `/api/{exchange}/fetchSeries`;
+        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.FetchSeries200ResponseFromJSON)(jsonValue));
+    }
+    /**
+     * Fetch the recurring series (fourth tier above Event -> Market -> Outcome) that this venue exposes. Returns an empty array on venues without a series concept (Limitless, Smarkets, Probable, Metaculus, Baozi, Hyperliquid, SuiBets, Polymarket US). - `params.id` -> a single matching series with its events populated where supported. - no params -> the full list, typically without nested events for payload size.
+     * Fetch Series
+     */
+    async fetchSeries(requestParameters, initOverrides) {
+        const response = await this.fetchSeriesRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
     /**
      * Fetch raw trade history for a specific outcome.
      * Fetch Trades
@@ -2202,6 +2236,27 @@ exports.FetchRelatedMarketsSortEnum = {
     Volume: 'volume',
     PriceDifference: 'priceDifference'
 };
+/**
+ * @export
+ */
+exports.FetchSeriesExchangeEnum = {
+    Polymarket: 'polymarket',
+    Kalshi: 'kalshi',
+    KalshiDemo: 'kalshi-demo',
+    Limitless: 'limitless',
+    Probable: 'probable',
+    Baozi: 'baozi',
+    Myriad: 'myriad',
+    Opinion: 'opinion',
+    Metaculus: 'metaculus',
+    Smarkets: 'smarkets',
+    PolymarketUs: 'polymarket_us',
+    GeminiTitan: 'gemini-titan',
+    Hyperliquid: 'hyperliquid',
+    Suibets: 'suibets',
+    Mock: 'mock',
+    Router: 'router'
+};
 /**
  * @export
  */

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

@@ -70,6 +70,12 @@ export interface EventFetchParams {
      * @memberof EventFetchParams
      */
     slug?: string;
+    /**
+     * Filter events by their parent series. Accepts the venue-native series id / ticker / slug (e.g. Kalshi `"KXATPMATCH"`, Polymarket `"wta"`). Passed through to the vendor where supported, otherwise applied to `sourceMetadata` after fetch.
+     * @type {string}
+     * @memberof EventFetchParams
+     */
+    series?: string;
     /**
      * Optional client-side filter applied after fetching
      * @type {EventFilterCriteria}

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

@@ -68,6 +68,7 @@ function EventFetchParamsFromJSONTyped(json, ignoreDiscriminator) {
         'searchIn': json['searchIn'] == null ? undefined : json['searchIn'],
         'eventId': json['eventId'] == null ? undefined : json['eventId'],
         'slug': json['slug'] == null ? undefined : json['slug'],
+        'series': json['series'] == null ? undefined : json['series'],
         'filter': json['filter'] == null ? undefined : (0, EventFilterCriteria_1.EventFilterCriteriaFromJSON)(json['filter']),
         'category': json['category'] == null ? undefined : json['category'],
         'tags': json['tags'] == null ? undefined : json['tags'],
@@ -90,6 +91,7 @@ function EventFetchParamsToJSONTyped(value, ignoreDiscriminator = false) {
         'searchIn': value['searchIn'],
         'eventId': value['eventId'],
         'slug': value['slug'],
+        'series': value['series'],
         'filter': (0, EventFilterCriteria_1.EventFilterCriteriaToJSON)(value['filter']),
         'category': value['category'],
         'tags': value['tags'],

package/dist/generated/src/models/FetchSeries200Response.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 { UnifiedSeries } from './UnifiedSeries';
+/**
+ *
+ * @export
+ * @interface FetchSeries200Response
+ */
+export interface FetchSeries200Response {
+    /**
+     *
+     * @type {boolean}
+     * @memberof FetchSeries200Response
+     */
+    success?: boolean;
+    /**
+     *
+     * @type {ErrorDetail}
+     * @memberof FetchSeries200Response
+     */
+    error?: ErrorDetail;
+    /**
+     *
+     * @type {Array<UnifiedSeries>}
+     * @memberof FetchSeries200Response
+     */
+    data?: Array<UnifiedSeries>;
+}
+/**
+ * Check if a given object implements the FetchSeries200Response interface.
+ */
+export declare function instanceOfFetchSeries200Response(value: object): value is FetchSeries200Response;
+export declare function FetchSeries200ResponseFromJSON(json: any): FetchSeries200Response;
+export declare function FetchSeries200ResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): FetchSeries200Response;
+export declare function FetchSeries200ResponseToJSON(json: any): FetchSeries200Response;
+export declare function FetchSeries200ResponseToJSONTyped(value?: FetchSeries200Response | null, ignoreDiscriminator?: boolean): any;

package/dist/generated/src/models/FetchSeries200Response.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.instanceOfFetchSeries200Response = instanceOfFetchSeries200Response;
+exports.FetchSeries200ResponseFromJSON = FetchSeries200ResponseFromJSON;
+exports.FetchSeries200ResponseFromJSONTyped = FetchSeries200ResponseFromJSONTyped;
+exports.FetchSeries200ResponseToJSON = FetchSeries200ResponseToJSON;
+exports.FetchSeries200ResponseToJSONTyped = FetchSeries200ResponseToJSONTyped;
+const ErrorDetail_1 = require("./ErrorDetail");
+const UnifiedSeries_1 = require("./UnifiedSeries");
+/**
+ * Check if a given object implements the FetchSeries200Response interface.
+ */
+function instanceOfFetchSeries200Response(value) {
+    return true;
+}
+function FetchSeries200ResponseFromJSON(json) {
+    return FetchSeries200ResponseFromJSONTyped(json, false);
+}
+function FetchSeries200ResponseFromJSONTyped(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 : (json['data'].map(UnifiedSeries_1.UnifiedSeriesFromJSON)),
+    };
+}
+function FetchSeries200ResponseToJSON(json) {
+    return FetchSeries200ResponseToJSONTyped(json, false);
+}
+function FetchSeries200ResponseToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'success': value['success'],
+        'error': (0, ErrorDetail_1.ErrorDetailToJSON)(value['error']),
+        'data': value['data'] == null ? undefined : (value['data'].map(UnifiedSeries_1.UnifiedSeriesToJSON)),
+    };
+}

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

@@ -0,0 +1,95 @@
+/**
+ * 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';
+/**
+ * A recurring grouping of events on a venue — the fourth tier above Event -> Market -> Outcome. Examples: Kalshi `KXATPMATCH` (every ATP tennis match), Polymarket `wta` (every WTA match), Opinion's daily `collection`. Series only exists where the venue exposes a recurring-event concept; venues without one return an empty array from `fetchSeries`.
+ * @export
+ * @interface UnifiedSeries
+ */
+export interface UnifiedSeries {
+    /**
+     * Stable venue-native series identifier (e.g. "KXATPMATCH" on Kalshi, "atp" on Polymarket Gamma, numeric Gamma id).
+     * @type {string}
+     * @memberof UnifiedSeries
+     */
+    id: string;
+    /**
+     * Venue-native ticker, when distinct from `id`.
+     * @type {string}
+     * @memberof UnifiedSeries
+     */
+    ticker?: string;
+    /**
+     * Venue-native slug.
+     * @type {string}
+     * @memberof UnifiedSeries
+     */
+    slug?: string;
+    /**
+     * Human-readable series title (e.g. "ATP Match Winner", "WTA").
+     * @type {string}
+     * @memberof UnifiedSeries
+     */
+    title: string;
+    /**
+     *
+     * @type {string}
+     * @memberof UnifiedSeries
+     */
+    description?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof UnifiedSeries
+     */
+    recurrence?: string | null;
+    /**
+     * Child events. Populated when fetched by id; the list form usually omits this to keep payloads small.
+     * @type {Array<UnifiedEvent>}
+     * @memberof UnifiedSeries
+     */
+    events?: Array<UnifiedEvent>;
+    /**
+     *
+     * @type {string}
+     * @memberof UnifiedSeries
+     */
+    url?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof UnifiedSeries
+     */
+    image?: string | null;
+    /**
+     * The exchange this series originates from. Populated by the Router.
+     * @type {string}
+     * @memberof UnifiedSeries
+     */
+    sourceExchange?: string;
+    /**
+     * Raw venue-specific fields not promoted to first-class columns.
+     * @type {{ [key: string]: any; }}
+     * @memberof UnifiedSeries
+     */
+    sourceMetadata?: {
+        [key: string]: any;
+    };
+}
+/**
+ * Check if a given object implements the UnifiedSeries interface.
+ */
+export declare function instanceOfUnifiedSeries(value: object): value is UnifiedSeries;
+export declare function UnifiedSeriesFromJSON(json: any): UnifiedSeries;
+export declare function UnifiedSeriesFromJSONTyped(json: any, ignoreDiscriminator: boolean): UnifiedSeries;
+export declare function UnifiedSeriesToJSON(json: any): UnifiedSeries;
+export declare function UnifiedSeriesToJSONTyped(value?: UnifiedSeries | null, ignoreDiscriminator?: boolean): any;

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

@@ -0,0 +1,73 @@
+"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.instanceOfUnifiedSeries = instanceOfUnifiedSeries;
+exports.UnifiedSeriesFromJSON = UnifiedSeriesFromJSON;
+exports.UnifiedSeriesFromJSONTyped = UnifiedSeriesFromJSONTyped;
+exports.UnifiedSeriesToJSON = UnifiedSeriesToJSON;
+exports.UnifiedSeriesToJSONTyped = UnifiedSeriesToJSONTyped;
+const UnifiedEvent_1 = require("./UnifiedEvent");
+/**
+ * Check if a given object implements the UnifiedSeries interface.
+ */
+function instanceOfUnifiedSeries(value) {
+    if (!('id' in value) || value['id'] === undefined)
+        return false;
+    if (!('title' in value) || value['title'] === undefined)
+        return false;
+    return true;
+}
+function UnifiedSeriesFromJSON(json) {
+    return UnifiedSeriesFromJSONTyped(json, false);
+}
+function UnifiedSeriesFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'id': json['id'],
+        'ticker': json['ticker'] == null ? undefined : json['ticker'],
+        'slug': json['slug'] == null ? undefined : json['slug'],
+        'title': json['title'],
+        'description': json['description'] == null ? undefined : json['description'],
+        'recurrence': json['recurrence'] == null ? undefined : json['recurrence'],
+        'events': json['events'] == null ? undefined : (json['events'].map(UnifiedEvent_1.UnifiedEventFromJSON)),
+        'url': json['url'] == null ? undefined : json['url'],
+        'image': json['image'] == null ? undefined : json['image'],
+        'sourceExchange': json['sourceExchange'] == null ? undefined : json['sourceExchange'],
+        'sourceMetadata': json['sourceMetadata'] == null ? undefined : json['sourceMetadata'],
+    };
+}
+function UnifiedSeriesToJSON(json) {
+    return UnifiedSeriesToJSONTyped(json, false);
+}
+function UnifiedSeriesToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'id': value['id'],
+        'ticker': value['ticker'],
+        'slug': value['slug'],
+        'title': value['title'],
+        'description': value['description'],
+        'recurrence': value['recurrence'],
+        'events': value['events'] == null ? undefined : (value['events'].map(UnifiedEvent_1.UnifiedEventToJSON)),
+        'url': value['url'],
+        'image': value['image'],
+        'sourceExchange': value['sourceExchange'],
+        'sourceMetadata': value['sourceMetadata'],
+    };
+}

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

@@ -58,6 +58,7 @@ export * from './FetchOrderBookParams';
 export * from './FetchOrderBooks200Response';
 export * from './FetchOrderBooksRequest';
 export * from './FetchPositions200Response';
+export * from './FetchSeries200Response';
 export * from './FetchTrades200Response';
 export * from './FilterEventsRequest';
 export * from './FilterEventsRequestArgsInner';
@@ -99,4 +100,5 @@ export * from './Trade';
 export * from './TradesParams';
 export * from './UnifiedEvent';
 export * from './UnifiedMarket';
+export * from './UnifiedSeries';
 export * from './UserTrade';

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

@@ -76,6 +76,7 @@ __exportStar(require("./FetchOrderBookParams"), exports);
 __exportStar(require("./FetchOrderBooks200Response"), exports);
 __exportStar(require("./FetchOrderBooksRequest"), exports);
 __exportStar(require("./FetchPositions200Response"), exports);
+__exportStar(require("./FetchSeries200Response"), exports);
 __exportStar(require("./FetchTrades200Response"), exports);
 __exportStar(require("./FilterEventsRequest"), exports);
 __exportStar(require("./FilterEventsRequestArgsInner"), exports);
@@ -117,4 +118,5 @@ __exportStar(require("./Trade"), exports);
 __exportStar(require("./TradesParams"), exports);
 __exportStar(require("./UnifiedEvent"), exports);
 __exportStar(require("./UnifiedMarket"), exports);
+__exportStar(require("./UnifiedSeries"), exports);
 __exportStar(require("./UserTrade"), exports);

package/dist/index.d.ts

@@ -27,6 +27,7 @@ export { Router } from "./pmxt/router.js";
 export { ServerManager } from "./pmxt/server-manager.js";
 export { HOSTED_URL, LOCAL_URL, ENV, resolvePmxtBaseUrl } from "./pmxt/constants.js";
 export { MarketList } from "./pmxt/models.js";
+export type { UnifiedSeries } from "./pmxt/models.js";
 export type * from "./pmxt/models.js";
 export * from "./pmxt/errors.js";
 declare function stopServer(): Promise<void>;

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, EventFetchParams, EventFilterCriteria, EventFilterFunction, ExecutionPriceResult, FetchOrderBookParams, MarketFetchParams, MarketFilterCriteria, MarketFilterFunction, MarketOutcome, MyTradesParams, Order, OrderBook, OrderHistoryParams, PaginatedMarketsResult, Position, PriceCandle, SubscribedAddressSnapshot, SubscriptionOption, Trade, UnifiedEvent, UnifiedMarket, UserTrade, FirehoseEvent } from "./models.js";
+import { Balance, BuiltOrder, CreateOrderParams, EventFetchParams, EventFilterCriteria, EventFilterFunction, ExecutionPriceResult, FetchOrderBookParams, MarketFetchParams, MarketFilterCriteria, MarketFilterFunction, MarketOutcome, MyTradesParams, Order, OrderBook, OrderHistoryParams, PaginatedMarketsResult, Position, SeriesFetchParams, PriceCandle, SubscribedAddressSnapshot, SubscriptionOption, Trade, UnifiedEvent, UnifiedMarket, UnifiedSeries, UserTrade, FirehoseEvent } from "./models.js";
 import { ServerManager } from "./server-manager.js";
 /**
  * Base exchange client options.
@@ -178,6 +178,7 @@ export declare abstract class Exchange {
     fetchMarkets(params?: MarketFetchParams): Promise<UnifiedMarket[]>;
     fetchMarketsPaginated(params?: any): Promise<PaginatedMarketsResult>;
     fetchEvents(params?: EventFetchParams): Promise<UnifiedEvent[]>;
+    fetchSeries(params?: SeriesFetchParams): Promise<UnifiedSeries[]>;
     fetchMarket(params?: MarketFetchParams): Promise<UnifiedMarket>;
     fetchEvent(params?: EventFetchParams): Promise<UnifiedEvent>;
     fetchOrderBook(outcomeId: string | MarketOutcome, limit?: number, params?: FetchOrderBookParams): Promise<OrderBook | OrderBook[]>;

package/dist/pmxt/client.js

@@ -114,6 +114,10 @@ function convertEvent(raw) {
     const markets = models_js_1.MarketList.from((raw.markets || []).map(convertMarket));
     return { ...raw, markets };
 }
+function convertSeries(raw) {
+    const events = Array.isArray(raw.events) ? raw.events.map(convertEvent) : undefined;
+    return { ...raw, ...(events !== undefined ? { events } : {}) };
+}
 function convertSubscriptionSnapshot(raw) {
     return {
         ...raw,
@@ -695,6 +699,34 @@ class Exchange {
             throw new errors_js_1.PmxtError(`Failed to fetchEvents: ${error}`);
         }
     }
+    async fetchSeries(params) {
+        await this.initPromise;
+        try {
+            const args = [];
+            if (params !== undefined)
+                args.push(params);
+            const response = await this.fetchWithRetry(`${this.resolveBaseUrl()}/api/${this.exchangeName}/fetchSeries`, {
+                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.map(convertSeries);
+        }
+        catch (error) {
+            if (error instanceof errors_js_1.PmxtError)
+                throw error;
+            throw new errors_js_1.PmxtError(`Failed to fetchSeries: ${error}`);
+        }
+    }
     async fetchMarket(params) {
         await this.initPromise;
         try {

package/dist/pmxt/models.d.ts

@@ -371,6 +371,24 @@ export interface CreateOrderParams {
 }
 /** Alias matching the core MarketFetchParams name. */
 export type MarketFetchParams = MarketFilterParams;
+/**
+ * Parameters for fetching series.
+ * Venues without a recurring-event concept return an empty array regardless of the filters.
+ */
+export interface SeriesFetchParams {
+    /** Direct lookup by venue-native series id (e.g. "KXATPMATCH" on Kalshi, "atp" on Polymarket Gamma). When set, the result includes events where the venue supports it. */
+    id?: string;
+    /** Lookup by series slug (e.g. "wta", "nfl"). */
+    slug?: string;
+    /** Keyword search across series title / description. */
+    query?: string;
+    /** Filter by recurrence cadence ('daily', 'weekly', 'annual', ...). */
+    recurrence?: string;
+    /** Maximum number of results to return. */
+    limit?: number;
+    /** Pagination offset. */
+    offset?: number;
+}
 /**
  * Parameters for fetching OHLCV candle data.
  */
@@ -475,6 +493,35 @@ export declare class MarketList extends Array<UnifiedMarket> {
      */
     match(query: string, searchIn?: ('title' | 'description' | 'category' | 'tags' | 'outcomes')[]): UnifiedMarket;
 }
+/**
+ * A recurring grouping of events on a venue — the tier above Event.
+ * Examples: Kalshi "KXATPMATCH" (every ATP match), Polymarket "wta" (every WTA match).
+ * Venues without a recurring-event concept return an empty array from fetchSeries.
+ */
+export interface UnifiedSeries {
+    /** Stable venue-native series identifier. */
+    id: string;
+    /** Venue-native ticker, when distinct from id. */
+    ticker?: string;
+    /** Venue-native slug. */
+    slug?: string;
+    /** Human-readable series title. */
+    title: string;
+    /** Long-form series description. */
+    description?: string | null;
+    /** Recurrence cadence the venue reports ('daily', 'weekly', 'annual', ...). */
+    recurrence?: string | null;
+    /** Child events. Populated when fetched by id; the list form usually omits this. */
+    events?: UnifiedEvent[];
+    /** Canonical venue URL for the series. */
+    url?: string | null;
+    /** Venue-hosted image. */
+    image?: string | null;
+    /** The exchange this series originates from. Populated by the Router. */
+    sourceExchange?: string;
+    /** Raw venue-specific fields not promoted to first-class columns. */
+    sourceMetadata?: Record<string, unknown>;
+}
 /**
  * A grouped collection of related markets (e.g., "Who will be Fed Chair?" contains multiple candidate markets)
  */