pmxt-core 2.46.14 → 2.48.0

package/dist/exchanges/opinion/normalizer.js

@@ -2,8 +2,24 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpinionNormalizer = void 0;
 const market_utils_1 = require("../../utils/market-utils");
+const metadata_1 = require("../../utils/metadata");
 const utils_1 = require("./utils");
 // ---------------------------------------------------------------------------
+// Raw Opinion fields already promoted to first-class Unified columns — omit
+// from sourceMetadata so we capture only what the unified shape would drop.
+// ---------------------------------------------------------------------------
+// Fields promoted on a market or child-market payload.
+const OPINION_PROMOTED_MARKET_KEYS = [
+    'marketId', 'marketTitle', 'rules', 'slug',
+    'volume', 'volume24h', 'cutoffAt',
+    'yesTokenId', 'noTokenId',
+];
+// Fields promoted on the parent (event-level) payload.
+const OPINION_PROMOTED_EVENT_KEYS = [
+    'marketId', 'marketTitle', 'rules', 'slug',
+    'volume', 'volume24h', 'childMarkets',
+];
+// ---------------------------------------------------------------------------
 // Opinion Trade Normalizer
 // ---------------------------------------------------------------------------
 class OpinionNormalizer {
@@ -43,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)
@@ -63,6 +95,9 @@ class OpinionNormalizer {
             volume24h,
             volume: totalVolume,
             url: `https://www.opinion.trade/market/${raw.slug || raw.marketId}`,
+            // collection carries series/recurring identifier (title, symbol,
+            // frequency, current period, next periods) — not a unified column.
+            sourceMetadata: (0, metadata_1.buildSourceMetadata)(raw, OPINION_PROMOTED_EVENT_KEYS, raw.collection ? { collection: raw.collection } : undefined),
         };
     }
     // -- OHLCV ----------------------------------------------------------------
@@ -247,6 +282,7 @@ class OpinionNormalizer {
             volume: (0, utils_1.parseNumStr)(raw.volume),
             liquidity: 0,
             url: `https://www.opinion.trade/market/${raw.slug || raw.marketId}`,
+            sourceMetadata: (0, metadata_1.buildSourceMetadata)(raw, OPINION_PROMOTED_MARKET_KEYS),
         };
         (0, market_utils_1.addBinaryOutcomes)(market);
         return market;
@@ -289,6 +325,12 @@ class OpinionNormalizer {
             volume: (0, utils_1.parseNumStr)(child.volume),
             liquidity: 0,
             url: `https://www.opinion.trade/market/${child.slug || child.marketId}`,
+            // parentMarketId links the child back to its categorical parent;
+            // collection carries the series/recurring context from the parent.
+            sourceMetadata: (0, metadata_1.buildSourceMetadata)(child, OPINION_PROMOTED_MARKET_KEYS, {
+                parentMarketId: parent.marketId,
+                ...(parent.collection ? { collection: parent.collection } : {}),
+            }),
         };
         (0, market_utils_1.addBinaryOutcomes)(market);
         return market;

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-26T15:22:20.013Z
+ * Generated at: 2026-05-30T13:35:15.531Z
  * 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-26T15:22:20.013Z
+ * Generated at: 2026-05-30T13:35:15.531Z
  * 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-26T15:22:20.026Z
+ * Generated at: 2026-05-30T13:35:15.544Z
  * 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-26T15:22:20.026Z
+ * Generated at: 2026-05-30T13:35:15.544Z
  * 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-26T15:22:20.024Z
+ * Generated at: 2026-05-30T13:35:15.542Z
  * 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-26T15:22:20.024Z
+ * Generated at: 2026-05-30T13:35:15.542Z
  * 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

@@ -1,7 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PolymarketNormalizer = void 0;
+const metadata_1 = require("../../utils/metadata");
 const utils_1 = require("./utils");
+// Raw Polymarket Gamma event fields already promoted to first-class Unified
+// columns — excluded from sourceMetadata so we capture only what the unified
+// shape would otherwise drop.
+const POLYMARKET_PROMOTED_EVENT_KEYS = [
+    'id', 'slug', 'title', 'description', 'image', 'category', 'tags',
+    // '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)
@@ -40,6 +55,39 @@ class PolymarketNormalizer {
             image: raw.image || `https://polymarket.com/api/og?slug=${raw.slug}`,
             category: raw.category || raw.tags?.[0]?.label,
             tags: raw.tags?.map((t) => t.label) || [],
+            // Keeps non-promoted Gamma event fields (e.g. active, closed, and
+            // any other vendor fields not surfaced as first-class columns).
+            // NOTE: Polymarket "series" data lives on a separate Gamma /series
+            // endpoint — it is NOT present in the event payload and therefore
+            // requires a separate /series fetch+join to populate here.
+            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) {

package/dist/exchanges/polymarket/utils.js

@@ -6,7 +6,28 @@ exports.mapIntervalToFidelity = mapIntervalToFidelity;
 exports.paginateParallel = paginateParallel;
 exports.paginateSearchParallel = paginateSearchParallel;
 const market_utils_1 = require("../../utils/market-utils");
+const metadata_1 = require("../../utils/metadata");
 const logger_1 = require("../../utils/logger");
+// Raw Polymarket Gamma market fields already promoted to first-class Unified
+// columns — excluded from sourceMetadata so we capture only what the unified
+// shape would otherwise drop.
+const POLYMARKET_PROMOTED_MARKET_KEYS = [
+    'id', 'question', 'description',
+    // outcomes array and prices are promoted to UnifiedMarket.outcomes
+    'outcomes', 'outcomePrices', 'clobTokenIds',
+    // resolution date fields
+    'endDate', 'end_date_iso', 'endDateIso',
+    // volume, liquidity, openInterest
+    'volume24hr', 'volume_24h', 'volume', 'liquidity', 'rewards',
+    'openInterest', 'open_interest',
+    // image, slug, contractAddress, tickSize, status fields
+    'image', 'slug',
+    'orderPriceMinTickSize',
+    'conditionId',
+    'active', 'closed', 'archived',
+    // parent event back-reference — eventId already promoted to UnifiedMarket.eventId
+    'events',
+];
 exports.GAMMA_API_URL = process.env.POLYMARKET_GAMMA_URL || 'https://gamma-api.polymarket.com/events';
 exports.GAMMA_SEARCH_URL = process.env.POLYMARKET_GAMMA_SEARCH_URL || 'https://gamma-api.polymarket.com/public-search';
 exports.CLOB_API_URL = process.env.POLYMARKET_CLOB_URL || 'https://clob.polymarket.com';
@@ -109,6 +130,13 @@ function mapMarketToUnified(event, market, options = {}) {
         tickSize: market.orderPriceMinTickSize != null ? Number(market.orderPriceMinTickSize) : undefined,
         status,
         contractAddress: typeof market.conditionId === 'string' && market.conditionId.length > 0 ? market.conditionId : undefined,
+        // Keeps non-promoted Gamma market fields (e.g. groupItemTitle,
+        // oneDayPriceChange, and any other vendor fields not surfaced as
+        // first-class columns).
+        // NOTE: Polymarket "series" data lives on a separate Gamma /series
+        // endpoint — it is NOT present in the market payload and requires a
+        // separate /series fetch+join to populate here.
+        sourceMetadata: (0, metadata_1.buildSourceMetadata)(market, POLYMARKET_PROMOTED_MARKET_KEYS),
     };
     (0, market_utils_1.addBinaryOutcomes)(um);
     return um;

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

@@ -2,7 +2,24 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PolymarketUSNormalizer = void 0;
 const market_utils_1 = require("../../utils/market-utils");
+const metadata_1 = require("../../utils/metadata");
 const price_1 = require("./price");
+// Raw Polymarket US fields already promoted to first-class Unified columns —
+// excluded from sourceMetadata so we capture only what the unified shape drops.
+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 = [
+    'slug', 'question', 'title', 'description', 'category', 'tags',
+    'endDate', 'marketSides', 'outcomePrices', 'orderPriceMinTickSize',
+    'eventSlug', 'volume', 'liquidity',
+];
 // ----------------------------------------------------------------------------
 // Helpers
 // ----------------------------------------------------------------------------
@@ -180,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.
@@ -226,6 +266,7 @@ class PolymarketUSNormalizer {
             url: buildEventUrl(real.slug),
             category,
             tags,
+            sourceMetadata: (0, metadata_1.buildSourceMetadata)(real, POLYMARKET_US_PROMOTED_EVENT_KEYS),
         };
     }
     /**
@@ -259,6 +300,7 @@ class PolymarketUSNormalizer {
             tickSize: typeof market.orderPriceMinTickSize === 'number'
                 ? market.orderPriceMinTickSize
                 : undefined,
+            sourceMetadata: (0, metadata_1.buildSourceMetadata)(market, POLYMARKET_US_PROMOTED_MARKET_KEYS),
         };
         (0, market_utils_1.addBinaryOutcomes)(um);
         return um;

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-26T15:22:20.050Z
+ * Generated at: 2026-05-30T13:35:15.579Z
  * 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-26T15:22:20.050Z
+ * Generated at: 2026-05-30T13:35:15.579Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

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

@@ -2,6 +2,9 @@ import { PredictionMarketExchange, MarketFetchParams, EventFetchParams, Exchange
 import { UnifiedMarket, UnifiedEvent, OrderBook, PriceCandle, Trade, UserTrade, Order, Position, Balance, CreateOrderParams } from '../../types';
 import { ProbableWebSocketConfig } from './websocket';
 export declare class ProbableExchange extends PredictionMarketExchange {
+    protected readonly capabilityOverrides: {
+        fetchSeries: false;
+    };
     private auth?;
     private ws?;
     private wsConfig?;

package/dist/exchanges/probable/index.js

@@ -16,6 +16,9 @@ const normalizer_1 = require("./normalizer");
 const logger_1 = require("../../utils/logger");
 const BSC_USDT_ADDRESS = '0x55d398326f99059fF775485246999027B3197955';
 class ProbableExchange extends BaseExchange_1.PredictionMarketExchange {
+    capabilityOverrides = {
+        fetchSeries: false,
+    };
     auth;
     ws;
     wsConfig;
@@ -78,6 +81,10 @@ class ProbableExchange extends BaseExchange_1.PredictionMarketExchange {
         return filtered;
     }
     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 rawEvents = await this.fetcher.fetchRawEvents(params);
         const events = rawEvents
             .map((raw) => this.normalizer.normalizeEvent(raw))

package/dist/exchanges/probable/utils.js

@@ -5,6 +5,16 @@ exports.mapMarketToUnified = mapMarketToUnified;
 exports.mapEventToUnified = mapEventToUnified;
 exports.enrichMarketsWithPrices = enrichMarketsWithPrices;
 const market_utils_1 = require("../../utils/market-utils");
+const metadata_1 = require("../../utils/metadata");
+// Raw Probable fields already promoted to first-class Unified columns — omitted
+// from sourceMetadata so we capture only what the unified shape would drop.
+const PROBABLE_PROMOTED_EVENT_KEYS = [
+    'id', 'title', 'description', 'slug', 'icon', 'image', 'category', 'tags', 'markets',
+];
+const PROBABLE_PROMOTED_MARKET_KEYS = [
+    'id', 'question', 'title', 'description', 'slug', 'endDate',
+    'volume24hr', 'volume', 'liquidity', 'icon', 'category', 'tags', 'tokens', 'event_id',
+];
 exports.DEFAULT_BASE_URL = 'https://market-api.probable.markets';
 exports.SEARCH_PATH = '/public/api/v1/public-search/';
 exports.EVENTS_PATH = '/public/api/v1/events/';
@@ -53,6 +63,10 @@ function mapMarketToUnified(market, event) {
         image: market.icon || event?.icon || event?.image || undefined,
         category: event?.category || market.category || undefined,
         tags: market.tags || event?.tags || [],
+        sourceMetadata: (0, metadata_1.buildSourceMetadata)(market, PROBABLE_PROMOTED_MARKET_KEYS, 
+        // event_slug is not promoted to any first-class column — attach it so
+        // markets remain queryable by their parent event slug.
+        event ? { event_slug: event.slug } : undefined),
     };
     (0, market_utils_1.addBinaryOutcomes)(um);
     return um;
@@ -80,6 +94,9 @@ function mapEventToUnified(event) {
         image: event.icon || event.image || undefined,
         category: event.category || undefined,
         tags: event.tags || [],
+        // Captures non-promoted event fields; markets child array is already
+        // promoted to the unified markets column so it is excluded.
+        sourceMetadata: (0, metadata_1.buildSourceMetadata)(event, PROBABLE_PROMOTED_EVENT_KEYS),
     };
     return unifiedEvent;
 }

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

@@ -3,6 +3,7 @@ import { UnifiedMarket, UnifiedEvent, OrderBook, Trade, UserTrade, Balance, Orde
 export declare class SmarketsExchange extends PredictionMarketExchange {
     protected readonly capabilityOverrides: {
         fetchPositions: "emulated";
+        fetchSeries: false;
     };
     private auth?;
     private loginPromise;