pmxtjs 2.47.0 → 2.48.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, 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.js';
+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.js';
 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/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, FetchEventsPaginated200ResponseFromJSON, FetchMarket200ResponseFromJSON, FetchMarketMatches200ResponseFromJSON, FetchMarkets200ResponseFromJSON, FetchMarketsPaginated200ResponseFromJSON, FetchMatchedMarkets200ResponseFromJSON, FetchMyTrades200ResponseFromJSON, FetchOHLCV200ResponseFromJSON, FetchOpenOrders200ResponseFromJSON, FetchOrderBook200ResponseFromJSON, FetchOrderBooks200ResponseFromJSON, FetchOrderBooksRequestToJSON, FetchPositions200ResponseFromJSON, FetchTrades200ResponseFromJSON, FilterEventsRequestToJSON, FilterMarketsRequestToJSON, GetExecutionPrice200ResponseFromJSON, GetExecutionPriceDetailed200ResponseFromJSON, GetExecutionPriceDetailedRequestToJSON, GetExecutionPriceRequestToJSON, HealthCheck200ResponseFromJSON, LoadMarkets200ResponseFromJSON, LoadMarketsRequestToJSON, SubmitOrderRequestToJSON, } from '../models/index.js';
+import { BaseResponseFromJSON, BuildOrder200ResponseFromJSON, BuildOrderRequestToJSON, CancelOrderRequestToJSON, CloseRequestToJSON, CompareMarketPrices200ResponseFromJSON, CompareMarketPricesRequestToJSON, CreateOrder200ResponseFromJSON, CreateOrderRequestToJSON, FetchArbitrage200ResponseFromJSON, FetchBalance200ResponseFromJSON, FetchEvent200ResponseFromJSON, FetchEventMatches200ResponseFromJSON, FetchEvents200ResponseFromJSON, FetchEventsPaginated200ResponseFromJSON, FetchMarket200ResponseFromJSON, FetchMarketMatches200ResponseFromJSON, FetchMarkets200ResponseFromJSON, FetchMarketsPaginated200ResponseFromJSON, FetchMatchedMarkets200ResponseFromJSON, FetchMyTrades200ResponseFromJSON, FetchOHLCV200ResponseFromJSON, FetchOpenOrders200ResponseFromJSON, FetchOrderBook200ResponseFromJSON, FetchOrderBooks200ResponseFromJSON, FetchOrderBooksRequestToJSON, FetchPositions200ResponseFromJSON, FetchSeries200ResponseFromJSON, FetchTrades200ResponseFromJSON, FilterEventsRequestToJSON, FilterMarketsRequestToJSON, GetExecutionPrice200ResponseFromJSON, GetExecutionPriceDetailed200ResponseFromJSON, GetExecutionPriceDetailedRequestToJSON, GetExecutionPriceRequestToJSON, HealthCheck200ResponseFromJSON, LoadMarkets200ResponseFromJSON, LoadMarketsRequestToJSON, SubmitOrderRequestToJSON, } from '../models/index.js';
 /**
  *
  */
@@ -356,6 +356,9 @@ export 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'];
         }
@@ -475,6 +478,9 @@ export 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'];
         }
@@ -1242,6 +1248,34 @@ export 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) => 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
@@ -2164,6 +2198,27 @@ export const FetchRelatedMarketsSortEnum = {
     Volume: 'volume',
     PriceDifference: 'priceDifference'
 };
+/**
+ * @export
+ */
+export const 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/esm/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/esm/generated/src/models/EventFetchParams.js

@@ -60,6 +60,7 @@ export 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 : EventFilterCriteriaFromJSON(json['filter']),
         'category': json['category'] == null ? undefined : json['category'],
         'tags': json['tags'] == null ? undefined : json['tags'],
@@ -82,6 +83,7 @@ export function EventFetchParamsToJSONTyped(value, ignoreDiscriminator = false)
         'searchIn': value['searchIn'],
         'eventId': value['eventId'],
         'slug': value['slug'],
+        'series': value['series'],
         'filter': EventFilterCriteriaToJSON(value['filter']),
         'category': value['category'],
         'tags': value['tags'],

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

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

@@ -0,0 +1,66 @@
+/* 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 UnifiedSeries interface.
+ */
+export function instanceOfUnifiedSeries(value) {
+    if (!('id' in value) || value['id'] === undefined)
+        return false;
+    if (!('title' in value) || value['title'] === undefined)
+        return false;
+    return true;
+}
+export function UnifiedSeriesFromJSON(json) {
+    return UnifiedSeriesFromJSONTyped(json, false);
+}
+export 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(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'],
+    };
+}
+export function UnifiedSeriesToJSON(json) {
+    return UnifiedSeriesToJSONTyped(json, false);
+}
+export 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(UnifiedEventToJSON)),
+        'url': value['url'],
+        'image': value['image'],
+        'sourceExchange': value['sourceExchange'],
+        'sourceMetadata': value['sourceMetadata'],
+    };
+}

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

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

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

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

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

@@ -111,6 +111,10 @@ function convertEvent(raw) {
     const markets = 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,
@@ -692,6 +696,34 @@ export class Exchange {
             throw new 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 fromServerError(body.error);
+                }
+                throw new 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 PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to fetchSeries: ${error}`);
+        }
+    }
     async fetchMarket(params) {
         await this.initPromise;
         try {

package/dist/esm/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)
  */