pmxt-core 2.47.0 → 2.48.1

package/dist/exchanges/metaculus/index.d.ts

@@ -37,6 +37,9 @@ import { UnifiedMarket, UnifiedEvent, CreateOrderParams, Order } from "../../typ
  * | Continuous/numeric/date | Yes (read-only HIGHER/LOWER) | No (requires 201-point CDF) |
  */
 export declare class MetaculusExchange extends PredictionMarketExchange {
+    protected readonly capabilityOverrides: {
+        fetchSeries: false;
+    };
     private readonly apiToken?;
     private readonly baseUrl;
     constructor(credentials?: ExchangeCredentials);

package/dist/exchanges/metaculus/index.js

@@ -48,6 +48,9 @@ const cancelOrder_1 = require("./cancelOrder");
  * | Continuous/numeric/date | Yes (read-only HIGHER/LOWER) | No (requires 201-point CDF) |
  */
 class MetaculusExchange extends BaseExchange_1.PredictionMarketExchange {
+    capabilityOverrides = {
+        fetchSeries: false,
+    };
     apiToken;
     baseUrl;
     constructor(credentials) {

package/dist/exchanges/myriad/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/myriad/myriad.yaml
- * Generated at: 2026-05-30T12:19:28.221Z
+ * Generated at: 2026-05-30T14:04:36.439Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const myriadApiSpec: {

package/dist/exchanges/myriad/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.myriadApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/myriad/myriad.yaml
- * Generated at: 2026-05-30T12:19:28.221Z
+ * Generated at: 2026-05-30T14:04:36.439Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.myriadApiSpec = {

package/dist/exchanges/myriad/index.d.ts

@@ -10,6 +10,7 @@ export declare class MyriadExchange extends PredictionMarketExchange {
         fetchBalance: "emulated";
         watchOrderBook: "emulated";
         watchTrades: "emulated";
+        fetchSeries: false;
     };
     private auth?;
     private ws?;

package/dist/exchanges/myriad/index.js

@@ -23,6 +23,7 @@ class MyriadExchange extends BaseExchange_1.PredictionMarketExchange {
         fetchBalance: 'emulated',
         watchOrderBook: 'emulated',
         watchTrades: 'emulated',
+        fetchSeries: false,
     };
     auth;
     ws;
@@ -76,6 +77,10 @@ class MyriadExchange extends BaseExchange_1.PredictionMarketExchange {
             .filter((m) => m !== null);
     }
     async fetchEventsImpl(params) {
+        // Venue does not expose a series concept; honoring `params.series` by
+        // returning [] rather than ignoring the filter.
+        if (params.series !== undefined)
+            return [];
         const rawQuestions = await this.fetcher.fetchRawEvents(params);
         return rawQuestions
             .map((raw) => this.normalizer.normalizeEvent(raw))

package/dist/exchanges/opinion/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/opinion/opinion-openapi.yaml
- * Generated at: 2026-05-30T12:19:28.226Z
+ * Generated at: 2026-05-30T14:04:36.444Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const opinionApiSpec: {

package/dist/exchanges/opinion/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.opinionApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/opinion/opinion-openapi.yaml
- * Generated at: 2026-05-30T12:19:28.226Z
+ * Generated at: 2026-05-30T14:04:36.444Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.opinionApiSpec = {

package/dist/exchanges/opinion/index.d.ts

@@ -1,5 +1,5 @@
-import { PredictionMarketExchange, MarketFilterParams, OHLCVParams, ExchangeCredentials, EventFetchParams, MyTradesParams, OrderHistoryParams } from '../../BaseExchange';
-import { UnifiedMarket, UnifiedEvent, PriceCandle, OrderBook, Trade, Order, Position, UserTrade, CreateOrderParams, BuiltOrder } from '../../types';
+import { PredictionMarketExchange, MarketFilterParams, OHLCVParams, ExchangeCredentials, EventFetchParams, SeriesFetchParams, MyTradesParams, OrderHistoryParams } from '../../BaseExchange';
+import { UnifiedMarket, UnifiedEvent, UnifiedSeries, PriceCandle, OrderBook, Trade, Order, Position, UserTrade, CreateOrderParams, BuiltOrder } from '../../types';
 import { OpinionWebSocketConfig } from './websocket';
 export type { OpinionWebSocketConfig };
 export interface OpinionExchangeOptions {
@@ -15,12 +15,16 @@ export declare class OpinionExchange extends PredictionMarketExchange {
     private readonly normalizer;
     private ws?;
     private readonly outcomeToMarketId;
+    protected readonly capabilityOverrides: {
+        fetchSeries: "emulated";
+    };
     constructor(options?: ExchangeCredentials | OpinionExchangeOptions);
     get name(): string;
     protected sign(_method: string, _path: string, _params: Record<string, any>): Record<string, string>;
     protected mapImplicitApiError(error: any): any;
     protected fetchMarketsImpl(params?: MarketFilterParams): Promise<UnifiedMarket[]>;
     protected fetchEventsImpl(params: EventFetchParams): Promise<UnifiedEvent[]>;
+    protected fetchSeriesImpl(params: SeriesFetchParams): Promise<UnifiedSeries[]>;
     fetchOHLCV(outcomeId: string, params: OHLCVParams): Promise<PriceCandle[]>;
     fetchOrderBook(outcomeId: string, _limit?: number, _params?: Record<string, any>): Promise<OrderBook>;
     fetchMyTrades(params?: MyTradesParams): Promise<UserTrade[]>;

package/dist/exchanges/opinion/index.js

@@ -60,6 +60,9 @@ class OpinionExchange extends BaseExchange_1.PredictionMarketExchange {
     ws;
     // Maps outcomeId (token ID) → numeric marketId for WebSocket subscriptions
     outcomeToMarketId = new Map();
+    capabilityOverrides = {
+        fetchSeries: 'emulated',
+    };
     constructor(options) {
         let credentials;
         let walletAddress;
@@ -154,9 +157,15 @@ class OpinionExchange extends BaseExchange_1.PredictionMarketExchange {
         const rawEvents = await this.fetcher.fetchRawEvents(params);
         const limit = params.limit || 250000;
         const query = (params.query || '').toLowerCase();
-        const filtered = query
+        let filtered = query
             ? rawEvents.filter((raw) => (raw.marketTitle || '').toLowerCase().includes(query))
             : rawEvents;
+        // Client-side series filter: keep only events whose collection symbol
+        // matches the requested series identifier.
+        if (params.series) {
+            const seriesId = params.series;
+            filtered = filtered.filter((raw) => raw.collection?.symbol === seriesId);
+        }
         const events = filtered
             .map((raw) => this.normalizer.normalizeEvent(raw))
             .filter((e) => e !== null)
@@ -165,6 +174,50 @@ class OpinionExchange extends BaseExchange_1.PredictionMarketExchange {
         await this.enrichPrices(allMarkets);
         return events;
     }
+    async fetchSeriesImpl(params) {
+        // Opinion has no dedicated /series endpoint. Derive the catalog by
+        // fetching all markets and grouping by collection.symbol.
+        const rawMarkets = await this.fetcher.fetchRawMarkets();
+        // Build a map from collection.symbol -> { collection, rawEvents[] }
+        const seriesMap = new Map();
+        for (const raw of rawMarkets) {
+            if (!raw.collection)
+                continue;
+            const sym = raw.collection.symbol;
+            const existing = seriesMap.get(sym);
+            if (existing) {
+                existing.raws.push(raw);
+            }
+            else {
+                seriesMap.set(sym, { collection: raw.collection, raws: [raw] });
+            }
+        }
+        let entries = Array.from(seriesMap.values());
+        // Apply params.id filter
+        if (params.id) {
+            entries = entries.filter((e) => e.collection.symbol === params.id);
+        }
+        // Apply params.query filter (title match)
+        if (params.query) {
+            const lowerQuery = params.query.toLowerCase();
+            entries = entries.filter((e) => e.collection.title.toLowerCase().includes(lowerQuery));
+        }
+        // Apply params.recurrence filter
+        if (params.recurrence) {
+            const recurrence = params.recurrence;
+            entries = entries.filter((e) => e.collection.frequency === recurrence);
+        }
+        return entries.map((e) => {
+            let events;
+            // When fetching by id, populate the events field.
+            if (params.id) {
+                events = e.raws
+                    .map((raw) => this.normalizer.normalizeEvent(raw))
+                    .filter((ev) => ev !== null);
+            }
+            return this.normalizer.normalizeSeries(e.collection, events);
+        });
+    }
     async fetchOHLCV(outcomeId, params) {
         const rawPoints = await this.fetcher.fetchRawOHLCV(outcomeId, params);
         return this.normalizer.normalizeOHLCV({ history: rawPoints }, params);

package/dist/exchanges/opinion/normalizer.d.ts

@@ -1,10 +1,16 @@
 import { OHLCVParams } from '../../BaseExchange';
-import { UnifiedMarket, UnifiedEvent, PriceCandle, OrderBook, Trade, UserTrade, Position, Order } from '../../types';
+import { UnifiedMarket, UnifiedEvent, UnifiedSeries, PriceCandle, OrderBook, Trade, UserTrade, Position, Order } from '../../types';
 import { IExchangeNormalizer } from '../interfaces';
-import { OpinionRawMarket, OpinionRawOrderBook, OpinionRawPricePoint, OpinionRawLatestPrice, OpinionRawUserTrade, OpinionRawPosition, OpinionRawOrder } from './fetcher';
+import { OpinionRawMarket, OpinionRawCollection, OpinionRawOrderBook, OpinionRawPricePoint, OpinionRawLatestPrice, OpinionRawUserTrade, OpinionRawPosition, OpinionRawOrder } from './fetcher';
 export declare class OpinionNormalizer implements IExchangeNormalizer<OpinionRawMarket, OpinionRawMarket> {
     normalizeMarket(raw: OpinionRawMarket): UnifiedMarket | null;
     normalizeMarketsFromEvent(raw: OpinionRawMarket): UnifiedMarket[];
+    /**
+     * Produce a UnifiedSeries from an Opinion `collection` object.
+     * `id` is the canonical series identifier (collection.symbol).
+     * `events` is optionally injected by the caller when doing a single-id lookup.
+     */
+    normalizeSeries(raw: OpinionRawCollection, events?: UnifiedEvent[]): UnifiedSeries;
     normalizeEvent(raw: OpinionRawMarket): UnifiedEvent | null;
     normalizeOHLCV(raw: {
         history: OpinionRawPricePoint[];

package/dist/exchanges/opinion/normalizer.js

@@ -59,6 +59,22 @@ class OpinionNormalizer {
         }
         return results;
     }
+    // -- Series ---------------------------------------------------------------
+    /**
+     * Produce a UnifiedSeries from an Opinion `collection` object.
+     * `id` is the canonical series identifier (collection.symbol).
+     * `events` is optionally injected by the caller when doing a single-id lookup.
+     */
+    normalizeSeries(raw, events) {
+        return {
+            id: raw.symbol,
+            ticker: raw.symbol,
+            title: raw.title,
+            recurrence: raw.frequency || null,
+            events,
+            sourceMetadata: (0, metadata_1.buildSourceMetadata)(raw, ['title', 'symbol', 'frequency']),
+        };
+    }
     // -- Events ---------------------------------------------------------------
     normalizeEvent(raw) {
         if (!raw)

package/dist/exchanges/polymarket/api-clob.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketClobAPI.yaml
- * Generated at: 2026-05-30T12:19:28.174Z
+ * Generated at: 2026-05-30T14:04:36.368Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const polymarketClobSpec: {

package/dist/exchanges/polymarket/api-clob.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.polymarketClobSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketClobAPI.yaml
- * Generated at: 2026-05-30T12:19:28.174Z
+ * Generated at: 2026-05-30T14:04:36.368Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketClobSpec = {

package/dist/exchanges/polymarket/api-data.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/Polymarket_Data_API.yaml
- * Generated at: 2026-05-30T12:19:28.190Z
+ * Generated at: 2026-05-30T14:04:36.391Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const polymarketDataSpec: {

package/dist/exchanges/polymarket/api-data.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.polymarketDataSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/Polymarket_Data_API.yaml
- * Generated at: 2026-05-30T12:19:28.190Z
+ * Generated at: 2026-05-30T14:04:36.391Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketDataSpec = {

package/dist/exchanges/polymarket/api-gamma.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketGammaAPI.yaml
- * Generated at: 2026-05-30T12:19:28.188Z
+ * Generated at: 2026-05-30T14:04:36.385Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const polymarketGammaSpec: {

package/dist/exchanges/polymarket/api-gamma.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.polymarketGammaSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketGammaAPI.yaml
- * Generated at: 2026-05-30T12:19:28.188Z
+ * Generated at: 2026-05-30T14:04:36.385Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketGammaSpec = {

package/dist/exchanges/polymarket/index.d.ts

@@ -1,8 +1,8 @@
-import { EventFetchParams, ExchangeCredentials, HistoryFilterParams, MarketFilterParams, MyTradesParams, OHLCVParams, PredictionMarketExchange, TradesParams } from '../../BaseExchange';
+import { EventFetchParams, ExchangeCredentials, HistoryFilterParams, MarketFilterParams, MyTradesParams, OHLCVParams, PredictionMarketExchange, SeriesFetchParams, TradesParams } from '../../BaseExchange';
 import { SubscribedAddressSnapshot, SubscriptionOption } from '../../subscriber/base';
 import { buildPolymarketTradesActivity, POLYMARKET_DEFAULT_SUBSCRIPTION } from '../../subscriber/external/goldsky';
 import { WatcherConfig } from '../../subscriber/watcher';
-import { Balance, BuiltOrder, CreateOrderParams, Order, OrderBook, Position, PriceCandle, Trade, UnifiedEvent, UnifiedMarket, UserTrade } from '../../types';
+import { Balance, BuiltOrder, CreateOrderParams, Order, OrderBook, Position, PriceCandle, Trade, UnifiedEvent, UnifiedMarket, UnifiedSeries, UserTrade } from '../../types';
 import { PolymarketWebSocketConfig, UserChannelCallback, UserChannelEvent, PolymarketUserChannelCreds } from './websocket';
 export type { PolymarketWebSocketConfig, WatcherConfig, UserChannelCallback, UserChannelEvent, PolymarketUserChannelCreds };
 export { POLYMARKET_DEFAULT_SUBSCRIPTION, buildPolymarketTradesActivity };
@@ -11,6 +11,9 @@ export interface PolymarketExchangeOptions {
     websocket?: PolymarketWebSocketConfig;
 }
 export declare class PolymarketExchange extends PredictionMarketExchange {
+    protected readonly capabilityOverrides: {
+        fetchSeries: true;
+    };
     private auth?;
     private wsConfig?;
     private cachedApiCreds?;
@@ -60,6 +63,14 @@ export declare class PolymarketExchange extends PredictionMarketExchange {
     protected mapImplicitApiError(error: any): any;
     protected fetchMarketsImpl(params?: MarketFilterParams): Promise<UnifiedMarket[]>;
     protected fetchEventsImpl(params: EventFetchParams): Promise<UnifiedEvent[]>;
+    /**
+     * Resolve a series id or slug string to a numeric Gamma series id.
+     * If the value is already numeric, returns it unchanged.
+     * Otherwise, calls `listSeries` with the value as `slug` and returns the
+     * first matching series id.
+     */
+    private resolveSeriesId;
+    protected fetchSeriesImpl(params: SeriesFetchParams): Promise<UnifiedSeries[]>;
     /**
      * Ensure authentication is initialized before trading operations.
      */

package/dist/exchanges/polymarket/index.js

@@ -20,6 +20,9 @@ const fetcher_1 = require("./fetcher");
 const normalizer_1 = require("./normalizer");
 const websocket_1 = require("./websocket");
 class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
+    capabilityOverrides = {
+        fetchSeries: true,
+    };
     auth;
     wsConfig;
     cachedApiCreds;
@@ -555,12 +558,58 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
             const events = await this.callApi('listEvents', queryParams);
             return (events || []).map((event) => this.normalizer.normalizeEvent(event)).filter((e) => e !== null);
         }
+        if (params.series) {
+            const seriesId = await this.resolveSeriesId(params.series);
+            const events = await this.callApi('listEvents', { series_id: seriesId });
+            return (events || []).map((event) => this.normalizer.normalizeEvent(event)).filter((e) => e !== null);
+        }
         const rawEvents = await this.fetcher.fetchRawEvents(params);
         return rawEvents
             .map((raw) => this.normalizer.normalizeEvent(raw))
             .filter((e) => e !== null)
             .slice(0, params.limit || 250000);
     }
+    /**
+     * Resolve a series id or slug string to a numeric Gamma series id.
+     * If the value is already numeric, returns it unchanged.
+     * Otherwise, calls `listSeries` with the value as `slug` and returns the
+     * first matching series id.
+     */
+    async resolveSeriesId(seriesValue) {
+        const numericId = Number(seriesValue);
+        if (Number.isInteger(numericId) && numericId > 0) {
+            return numericId;
+        }
+        // Slug path: look up via listSeries
+        const results = await this.callApi('listSeries', { slug: [seriesValue] });
+        const first = Array.isArray(results) ? results[0] : undefined;
+        if (!first || first.id == null) {
+            throw new Error(`Polymarket: no series found for slug "${seriesValue}"`);
+        }
+        return Number(first.id);
+    }
+    async fetchSeriesImpl(params) {
+        if (params.id) {
+            const raw = await this.callApi('getSeries', { id: params.id });
+            if (!raw || raw.id == null)
+                return [];
+            return [this.normalizer.normalizeSeries(raw)];
+        }
+        const queryParams = {};
+        if (params.slug)
+            queryParams['slug'] = [params.slug];
+        if (params.recurrence)
+            queryParams['recurrence'] = params.recurrence;
+        const results = await this.callApi('listSeries', queryParams);
+        const list = Array.isArray(results) ? results : [];
+        const normalized = list.map((raw) => this.normalizer.normalizeSeries(raw));
+        if (params.query) {
+            const lowerQuery = params.query.toLowerCase();
+            return normalized.filter((s) => (s.title || '').toLowerCase().includes(lowerQuery) ||
+                (s.description || '').toLowerCase().includes(lowerQuery));
+        }
+        return normalized;
+    }
     /**
      * Ensure authentication is initialized before trading operations.
      */

package/dist/exchanges/polymarket/normalizer.d.ts

@@ -1,5 +1,5 @@
 import { OHLCVParams } from '../../BaseExchange';
-import { UnifiedMarket, UnifiedEvent, PriceCandle, OrderBook, Trade, UserTrade, Position } from '../../types';
+import { UnifiedMarket, UnifiedEvent, UnifiedSeries, PriceCandle, OrderBook, Trade, UserTrade, Position } from '../../types';
 import { IExchangeNormalizer } from '../interfaces';
 import { PolymarketRawEvent, PolymarketRawOHLCVPoint, PolymarketRawOrderBook, PolymarketRawTrade, PolymarketRawPosition } from './fetcher';
 export declare class PolymarketNormalizer implements IExchangeNormalizer<PolymarketRawEvent, PolymarketRawEvent> {
@@ -8,6 +8,7 @@ export declare class PolymarketNormalizer implements IExchangeNormalizer<Polymar
         useQuestionAsCandidateFallback?: boolean;
     }): UnifiedMarket[];
     normalizeEvent(raw: PolymarketRawEvent): UnifiedEvent | null;
+    normalizeSeries(raw: Record<string, unknown>): UnifiedSeries;
     normalizeOHLCV(raw: {
         history: PolymarketRawOHLCVPoint[];
     }, params: OHLCVParams): PriceCandle[];

package/dist/exchanges/polymarket/normalizer.js

@@ -11,6 +11,12 @@ const POLYMARKET_PROMOTED_EVENT_KEYS = [
     // 'markets' is the child-markets array — promoted to UnifiedEvent.markets
     'markets',
 ];
+// Raw Polymarket Gamma series fields promoted to first-class UnifiedSeries columns.
+const POLYMARKET_PROMOTED_SERIES_KEYS = [
+    'id', 'ticker', 'slug', 'title', 'description', 'image', 'recurrence',
+    // 'events' is promoted to UnifiedSeries.events
+    'events',
+];
 class PolymarketNormalizer {
     normalizeMarket(raw) {
         if (!raw)
@@ -57,6 +63,33 @@ class PolymarketNormalizer {
             sourceMetadata: (0, metadata_1.buildSourceMetadata)(raw, POLYMARKET_PROMOTED_EVENT_KEYS),
         };
     }
+    normalizeSeries(raw) {
+        const id = String(raw['id'] ?? '');
+        const slug = typeof raw['slug'] === 'string' ? raw['slug'] : undefined;
+        const ticker = typeof raw['ticker'] === 'string' ? raw['ticker'] : undefined;
+        const title = typeof raw['title'] === 'string' ? raw['title'] : (slug ?? id);
+        const description = raw['description'] != null ? String(raw['description']) : null;
+        const recurrence = raw['recurrence'] != null ? String(raw['recurrence']) : null;
+        const image = raw['image'] != null ? String(raw['image']) : null;
+        const rawEvents = Array.isArray(raw['events']) ? raw['events'] : undefined;
+        const events = rawEvents !== undefined
+            ? rawEvents
+                .map((e) => this.normalizeEvent(e))
+                .filter((e) => e !== null)
+            : undefined;
+        return {
+            id,
+            ticker,
+            slug,
+            title,
+            description,
+            recurrence,
+            image,
+            url: slug != null ? `https://polymarket.com/series/${slug}` : null,
+            events,
+            sourceMetadata: (0, metadata_1.buildSourceMetadata)(raw, POLYMARKET_PROMOTED_SERIES_KEYS),
+        };
+    }
     normalizeOHLCV(raw, params) {
         const history = raw.history || [];
         const fidelity = (0, utils_1.mapIntervalToFidelity)(params.resolution);

package/dist/exchanges/polymarket_us/index.d.ts

@@ -13,8 +13,8 @@
  *    `cancelOrder(orderId)` does not. We maintain an in-memory cache mapping
  *    orderId -> marketSlug populated whenever we observe an order.
  */
-import { PredictionMarketExchange, ExchangeCredentials, MarketFetchParams, EventFetchParams, MyTradesParams } from '../../BaseExchange';
-import { UnifiedMarket, UnifiedEvent, OrderBook, Trade, UserTrade, Order, Position, Balance, CreateOrderParams, BuiltOrder } from '../../types';
+import { PredictionMarketExchange, ExchangeCredentials, MarketFetchParams, EventFetchParams, SeriesFetchParams, MyTradesParams } from '../../BaseExchange';
+import { UnifiedMarket, UnifiedEvent, UnifiedSeries, OrderBook, Trade, UserTrade, Order, Position, Balance, CreateOrderParams, BuiltOrder } from '../../types';
 export * from './config';
 export * from './price';
 export * from './errors';
@@ -46,6 +46,7 @@ export declare class PolymarketUSExchange extends PredictionMarketExchange {
     private slugFromId;
     protected fetchMarketsImpl(params?: MarketFetchParams): Promise<UnifiedMarket[]>;
     protected fetchEventsImpl(params: EventFetchParams): Promise<UnifiedEvent[]>;
+    protected fetchSeriesImpl(params: SeriesFetchParams): Promise<UnifiedSeries[]>;
     fetchOrderBook(outcomeId: string, _limit?: number, _params?: Record<string, any>): Promise<OrderBook>;
     fetchBalance(_address?: string): Promise<Balance[]>;
     fetchPositions(_address?: string): Promise<Position[]>;

package/dist/exchanges/polymarket_us/index.js

@@ -149,10 +149,33 @@ class PolymarketUSExchange extends BaseExchange_1.PredictionMarketExchange {
                 const resp = await this.client.events.retrieveBySlug(directSlug);
                 return resp.event ? [this.normalizer.normalizeEvent(resp.event)] : [];
             }
+            // When filtering by series, the SDK accepts seriesId as an array of
+            // numeric ids. The PMXT series param is a string (id or slug); we
+            // attempt numeric parsing first and fall back to slug resolution below.
+            let seriesIdFilter;
+            if (params?.series != null) {
+                const numericId = Number(params.series);
+                if (Number.isFinite(numericId) && numericId > 0) {
+                    seriesIdFilter = [numericId];
+                }
+                else {
+                    // Non-numeric: attempt to resolve the slug to a numeric series id
+                    // by listing series and finding a slug match.
+                    const slugResp = await this.client.series.list({ slug: [params.series] });
+                    const matched = slugResp.series?.[0];
+                    if (!matched) {
+                        // Unknown series slug — return empty rather than silently
+                        // ignoring the filter and returning all events.
+                        return [];
+                    }
+                    seriesIdFilter = [matched.id];
+                }
+            }
             const resp = await this.client.events.list({
                 active: true,
                 limit: params?.limit ?? 100,
                 offset: params?.offset ?? 0,
+                ...(seriesIdFilter !== undefined ? { seriesId: seriesIdFilter } : {}),
             });
             if (!resp.events) {
                 throw new Error('PolymarketUS events.list response missing required "events" field');
@@ -166,6 +189,40 @@ class PolymarketUSExchange extends BaseExchange_1.PredictionMarketExchange {
             return events;
         });
     }
+    async fetchSeriesImpl(params) {
+        return this.run(async () => {
+            // Direct lookup by numeric id
+            if (params?.id != null) {
+                const numericId = Number(params.id);
+                if (!Number.isFinite(numericId) || numericId <= 0) {
+                    return [];
+                }
+                const resp = await this.client.series.retrieve(numericId);
+                if (!resp.series) {
+                    throw new Error('PolymarketUS series.retrieve response missing required "series" field');
+                }
+                return [this.normalizer.normalizeSeries(resp.series)];
+            }
+            const listParams = { active: true };
+            if (params?.slug != null) {
+                listParams.slug = [params.slug];
+            }
+            if (params?.recurrence != null) {
+                listParams.recurrence = params.recurrence;
+            }
+            const resp = await this.client.series.list(listParams);
+            if (!resp.series) {
+                throw new Error('PolymarketUS series.list response missing required "series" field');
+            }
+            let series = resp.series.map(s => this.normalizer.normalizeSeries(s));
+            if (params?.query) {
+                const q = params.query.toLowerCase();
+                series = series.filter(s => s.title.toLowerCase().includes(q) ||
+                    (s.description || '').toLowerCase().includes(q));
+            }
+            return series;
+        });
+    }
     async fetchOrderBook(outcomeId, _limit, _params) {
         const resolved = await this.resolveOutcomeAlias(outcomeId, _params);
         outcomeId = resolved.outcomeId;

package/dist/exchanges/polymarket_us/normalizer.d.ts

@@ -1,6 +1,13 @@
-import type { Event as SdkEvent, MarketDetail, MarketBook, Order as SdkOrder, UserPosition, UserBalance, Activity } from 'polymarket-us';
-import { UnifiedMarket, UnifiedEvent, OrderBook, Order, Position, Balance, UserTrade } from '../../types';
+import type { Event as SdkEvent, MarketDetail, MarketBook, Order as SdkOrder, UserPosition, UserBalance, Activity, Series as SdkSeries } from 'polymarket-us';
+import { UnifiedMarket, UnifiedEvent, UnifiedSeries, OrderBook, Order, Position, Balance, UserTrade } from '../../types';
 export declare class PolymarketUSNormalizer {
+    /**
+     * Normalize a Polymarket US SDK Series into a UnifiedSeries.
+     *
+     * The SDK's Series type is exported as `Series` from `polymarket-us`;
+     * the `id` field is numeric and is stringified for the unified identifier.
+     */
+    normalizeSeries(raw: SdkSeries): UnifiedSeries;
     /**
      * Normalize a single MarketDetail into a UnifiedMarket.
      * The slug is the canonical PMXT marketId for Polymarket US.

package/dist/exchanges/polymarket_us/normalizer.js

@@ -9,6 +9,10 @@ const price_1 = require("./price");
 const POLYMARKET_US_PROMOTED_EVENT_KEYS = [
     'slug', 'title', 'description', 'category', 'tags', 'volume', 'markets',
 ];
+// Series fields promoted to first-class UnifiedSeries columns.
+const POLYMARKET_US_PROMOTED_SERIES_KEYS = [
+    'id', 'slug', 'title', 'description', 'recurrence',
+];
 // marketSides and outcomePrices feed the outcomes array and are therefore
 // treated as promoted. orderPriceMinTickSize maps to tickSize.
 const POLYMARKET_US_PROMOTED_MARKET_KEYS = [
@@ -193,6 +197,29 @@ function mapOrderStatus(state) {
 // Normalizer
 // ----------------------------------------------------------------------------
 class PolymarketUSNormalizer {
+    /**
+     * Normalize a Polymarket US SDK Series into a UnifiedSeries.
+     *
+     * The SDK's Series type is exported as `Series` from `polymarket-us`;
+     * the `id` field is numeric and is stringified for the unified identifier.
+     */
+    normalizeSeries(raw) {
+        const id = String(raw.id);
+        const slug = raw.slug || undefined;
+        const title = raw.title || slug || id;
+        const description = raw.description != null ? raw.description : null;
+        const recurrence = raw.recurrence != null ? raw.recurrence : null;
+        const url = slug != null ? `https://polymarket.us/series/${slug}` : null;
+        return {
+            id,
+            slug,
+            title,
+            description,
+            recurrence,
+            url,
+            sourceMetadata: (0, metadata_1.buildSourceMetadata)(raw, POLYMARKET_US_PROMOTED_SERIES_KEYS),
+        };
+    }
     /**
      * Normalize a single MarketDetail into a UnifiedMarket.
      * The slug is the canonical PMXT marketId for Polymarket US.

package/dist/exchanges/probable/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/probable/probable.yaml
- * Generated at: 2026-05-30T12:19:28.214Z
+ * Generated at: 2026-05-30T14:04:36.430Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const probableApiSpec: {

package/dist/exchanges/probable/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.probableApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/probable/probable.yaml
- * Generated at: 2026-05-30T12:19:28.214Z
+ * Generated at: 2026-05-30T14:04:36.430Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {