pmxt-core 2.46.14 → 2.48.0

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

@@ -1,5 +1,5 @@
-import { EventFetchParams, ExchangeCredentials, HistoryFilterParams, MarketFilterParams, MyTradesParams, OHLCVParams, OrderHistoryParams, PredictionMarketExchange, TradesParams } from '../../BaseExchange';
-import { Balance, BuiltOrder, CreateOrderParams, Order, OrderBook, Position, PriceCandle, Trade, UnifiedEvent, UnifiedMarket, UserTrade } from '../../types';
+import { EventFetchParams, ExchangeCredentials, HistoryFilterParams, MarketFilterParams, MyTradesParams, OHLCVParams, OrderHistoryParams, PredictionMarketExchange, SeriesFetchParams, TradesParams } from '../../BaseExchange';
+import { Balance, BuiltOrder, CreateOrderParams, Order, OrderBook, Position, PriceCandle, Trade, UnifiedEvent, UnifiedMarket, UnifiedSeries, UserTrade } from '../../types';
 import { KalshiWebSocketConfig } from './websocket';
 export type { KalshiWebSocketConfig };
 export interface KalshiExchangeOptions {
@@ -23,6 +23,7 @@ export declare class KalshiExchange extends PredictionMarketExchange {
     private ensureAuth;
     protected fetchMarketsImpl(params?: MarketFilterParams): Promise<UnifiedMarket[]>;
     protected fetchEventsImpl(params: EventFetchParams): Promise<UnifiedEvent[]>;
+    protected fetchSeriesImpl(params: SeriesFetchParams): Promise<UnifiedSeries[]>;
     fetchEventsPage(params?: EventFetchParams): Promise<{
         events: UnifiedEvent[];
         cursor: string | null;

package/dist/exchanges/kalshi/index.js

@@ -118,6 +118,39 @@ class KalshiExchange extends BaseExchange_1.PredictionMarketExchange {
             .filter((e) => e !== null)
             .slice(0, limit);
     }
+    async fetchSeriesImpl(params) {
+        const rawList = await this.fetcher.fetchRawSeriesList();
+        // If a specific series id is requested, fetch its events and attach them.
+        // We still iterate the full list so filters apply uniformly.
+        let eventsById = null;
+        if (params.id) {
+            const rawEvents = await this.fetcher.fetchRawEvents({ series: params.id });
+            const normalizedEvents = rawEvents
+                .map((raw) => this.normalizer.normalizeEvent(raw))
+                .filter((e) => e !== null);
+            eventsById = new Map([[params.id, normalizedEvents]]);
+        }
+        const normalized = rawList.map((raw) => {
+            const events = eventsById?.get(raw.ticker);
+            return this.normalizer.normalizeSeries(raw, events);
+        });
+        // Client-side filters
+        let filtered = normalized;
+        if (params.id) {
+            filtered = filtered.filter((s) => s.id === params.id);
+        }
+        else if (params.slug) {
+            filtered = filtered.filter((s) => s.ticker === params.slug || s.slug === params.slug);
+        }
+        if (params.query) {
+            const lowerQuery = params.query.toLowerCase();
+            filtered = filtered.filter((s) => s.title.toLowerCase().includes(lowerQuery));
+        }
+        if (params.recurrence) {
+            filtered = filtered.filter((s) => s.recurrence === params.recurrence);
+        }
+        return filtered;
+    }
     async fetchEventsPage(params = {}) {
         const page = await this.fetcher.fetchRawEventPage(params);
         const query = (params?.query || '').toLowerCase();

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

@@ -1,12 +1,13 @@
 import { OHLCVParams } from '../../BaseExchange';
-import { UnifiedMarket, UnifiedEvent, PriceCandle, OrderBook, Trade, UserTrade, Position, Balance } from '../../types';
+import { UnifiedMarket, UnifiedEvent, UnifiedSeries, PriceCandle, OrderBook, Trade, UserTrade, Position, Balance } from '../../types';
 import { IExchangeNormalizer } from '../interfaces';
-import { KalshiRawEvent, KalshiRawMarket, KalshiRawCandlestick, KalshiRawTrade, KalshiRawFill, KalshiRawOrder, KalshiRawPosition, KalshiRawOrderBookFp } from './fetcher';
+import { KalshiRawEvent, KalshiRawMarket, KalshiRawCandlestick, KalshiRawTrade, KalshiRawFill, KalshiRawOrder, KalshiRawPosition, KalshiRawOrderBookFp, KalshiRawSeries } from './fetcher';
 export declare class KalshiNormalizer implements IExchangeNormalizer<KalshiRawEvent, KalshiRawEvent> {
     normalizeMarket(raw: KalshiRawEvent): UnifiedMarket | null;
     normalizeMarketsFromEvent(rawEvent: KalshiRawEvent): UnifiedMarket[];
     normalizeRawMarket(event: KalshiRawEvent, market: KalshiRawMarket): UnifiedMarket | null;
     normalizeEvent(raw: KalshiRawEvent): UnifiedEvent | null;
+    normalizeSeries(raw: KalshiRawSeries, events?: UnifiedEvent[]): UnifiedSeries;
     normalizeOHLCV(rawCandles: KalshiRawCandlestick[], params: OHLCVParams): PriceCandle[];
     normalizeOrderBook(raw: {
         orderbook_fp: KalshiRawOrderBookFp;

package/dist/exchanges/kalshi/normalizer.js

@@ -3,7 +3,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.KalshiNormalizer = void 0;
 exports.sortRawEvents = sortRawEvents;
 const market_utils_1 = require("../../utils/market-utils");
+const metadata_1 = require("../../utils/metadata");
 const price_1 = require("./price");
+// Raw Kalshi fields already promoted to first-class Unified columns — excluded
+// from sourceMetadata so we capture only what the unified shape would drop.
+const KALSHI_PROMOTED_EVENT_KEYS = [
+    'event_ticker', 'title', 'markets', 'category', 'image_url', 'tags',
+];
+const KALSHI_PROMOTED_SERIES_KEYS = [
+    'ticker', 'title', 'tags', 'frequency', 'category',
+];
+const KALSHI_PROMOTED_MARKET_KEYS = [
+    'ticker', 'title', 'rules_primary', 'rules_secondary', 'expiration_time',
+    'volume_24h_fp', 'volume_24h', 'volume', 'volume_fp',
+    'liquidity_dollars', 'liquidity', 'open_interest_fp', 'open_interest',
+    'status', 'last_price_dollars', 'previous_price_dollars',
+    'yes_ask_dollars', 'yes_bid_dollars', 'last_price', 'yes_ask', 'yes_bid',
+];
 class KalshiNormalizer {
     normalizeMarket(raw) {
         // This normalizes a single-market event. For multi-market events, use normalizeMarketsFromEvent.
@@ -92,6 +108,11 @@ class KalshiNormalizer {
             category: event.category,
             tags: unifiedTags,
             status: this.cleanLabel(market.status) || undefined,
+            // series_ticker/series_title live on the parent event, not the raw
+            // market, and aren't promoted to a column — attach them here so
+            // markets are queryable by series. event_ticker is omitted (already
+            // promoted to eventId).
+            sourceMetadata: (0, metadata_1.buildSourceMetadata)(market, KALSHI_PROMOTED_MARKET_KEYS, { series_ticker: event.series_ticker, series_title: event.series_title }),
         };
         (0, market_utils_1.addBinaryOutcomes)(um);
         return um;
@@ -114,6 +135,20 @@ class KalshiNormalizer {
             image: raw.image_url ?? undefined,
             category: raw.category,
             tags: raw.tags || [],
+            // Keeps non-promoted event fields (series_ticker, series_title,
+            // sub_title, strike_period, ...); raw markets array is promoted.
+            sourceMetadata: (0, metadata_1.buildSourceMetadata)(raw, KALSHI_PROMOTED_EVENT_KEYS),
+        };
+    }
+    normalizeSeries(raw, events) {
+        return {
+            id: raw.ticker,
+            ticker: raw.ticker,
+            title: (typeof raw.title === 'string' && raw.title.trim()) ? raw.title.trim() : raw.ticker,
+            recurrence: (typeof raw.frequency === 'string' && raw.frequency.trim()) ? raw.frequency.trim() : null,
+            url: `https://kalshi.com/events?series=${raw.ticker}`,
+            events: events ?? undefined,
+            sourceMetadata: (0, metadata_1.buildSourceMetadata)(raw, KALSHI_PROMOTED_SERIES_KEYS),
         };
     }
     normalizeOHLCV(rawCandles, params) {

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

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/limitless/Limitless.yaml
- * Generated at: 2026-05-26T15:22:20.044Z
+ * Generated at: 2026-05-30T13:35:15.569Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const limitlessApiSpec: {

package/dist/exchanges/limitless/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.limitlessApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/limitless/Limitless.yaml
- * Generated at: 2026-05-26T15:22:20.044Z
+ * Generated at: 2026-05-30T13:35:15.569Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.limitlessApiSpec = {

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

@@ -13,6 +13,7 @@ export interface LimitlessExchangeOptions {
 export declare class LimitlessExchange extends PredictionMarketExchange {
     protected readonly capabilityOverrides: {
         fetchOrder: false;
+        fetchSeries: false;
     };
     private auth?;
     private client?;

package/dist/exchanges/limitless/index.js

@@ -22,6 +22,7 @@ const logger_1 = require("../../utils/logger");
 class LimitlessExchange extends BaseExchange_1.PredictionMarketExchange {
     capabilityOverrides = {
         fetchOrder: false,
+        fetchSeries: false,
     };
     auth;
     client;
@@ -146,6 +147,10 @@ class LimitlessExchange extends BaseExchange_1.PredictionMarketExchange {
         return marketsAfterOffset.slice(0, limit);
     }
     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);
         return rawEvents
             .map((raw) => this.normalizer.normalizeEvent(raw))

package/dist/exchanges/limitless/normalizer.js

@@ -2,6 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LimitlessNormalizer = void 0;
 const utils_1 = require("./utils");
+const metadata_1 = require("../../utils/metadata");
+// Raw Limitless event fields already promoted to first-class Unified columns —
+// excluded from sourceMetadata so we capture only what the unified shape drops.
+const LIMITLESS_PROMOTED_EVENT_KEYS = [
+    'slug', 'title', 'question', 'description',
+    'logo',
+    'categories', 'tags',
+    'markets',
+];
 // Limitless uses USDC with 6 decimals
 const USDC_DECIMALS = 6;
 const USDC_SCALE = Math.pow(10, USDC_DECIMALS);
@@ -47,6 +56,7 @@ class LimitlessNormalizer {
             image: raw.logo || `https://limitless.exchange/api/og?slug=${raw.slug}`,
             category: raw.categories?.[0],
             tags: raw.tags || [],
+            sourceMetadata: (0, metadata_1.buildSourceMetadata)(raw, LIMITLESS_PROMOTED_EVENT_KEYS),
         };
     }
     normalizeOHLCV(rawPrices, params) {

package/dist/exchanges/limitless/utils.js

@@ -5,7 +5,23 @@ exports.mapMarketToUnified = mapMarketToUnified;
 exports.mapIntervalToFidelity = mapIntervalToFidelity;
 exports.paginateLimitlessMarkets = paginateLimitlessMarkets;
 const market_utils_1 = require("../../utils/market-utils");
+const metadata_1 = require("../../utils/metadata");
 exports.DEFAULT_LIMITLESS_API_URL = 'https://api.limitless.exchange';
+// Raw Limitless market fields already promoted to first-class Unified columns —
+// excluded from sourceMetadata so we capture only what the unified shape drops.
+// Also excludes __pmxt* internal injection keys (not raw vendor data).
+const LIMITLESS_PROMOTED_MARKET_KEYS = [
+    'slug', 'title', 'question', 'description',
+    'tokens', 'prices',
+    'expirationTimestamp',
+    'volumeFormatted', 'volume',
+    'logo',
+    'categories', 'tags',
+    'expired', 'status',
+    'markets',
+    '__pmxtEventId', '__pmxtEventTitle', '__pmxtEventDescription',
+    '__pmxtCategories', '__pmxtTags',
+];
 function mapMarketToUnified(market, context = {}) {
     if (!market)
         return null;
@@ -76,6 +92,7 @@ function mapMarketToUnified(market, context = {}) {
         category: market.categories?.[0] || resolvedContext.categories?.[0],
         tags: market.tags || resolvedContext.tags || [],
         status,
+        sourceMetadata: (0, metadata_1.buildSourceMetadata)(market, LIMITLESS_PROMOTED_MARKET_KEYS),
     };
     (0, market_utils_1.addBinaryOutcomes)(um);
     return um;

package/dist/exchanges/metaculus/fetchEvents.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetchEvents = fetchEvents;
 const utils_1 = require("./utils");
 const errors_1 = require("./errors");
+const metadata_1 = require("../../utils/metadata");
 const BATCH_SIZE = 100;
 const MAX_PAGES = 200;
 /**
@@ -72,6 +73,7 @@ function postToEvent(post) {
                 : post.projects.category[0]?.name
             : undefined,
         tags: markets[0]?.tags ?? [],
+        sourceMetadata: (0, metadata_1.buildSourceMetadata)(post, utils_1.METACULUS_PROMOTED_EVENT_KEYS),
     };
 }
 /**
@@ -141,6 +143,10 @@ async function fetchEventBySlug(slug, callApi) {
     return [];
 }
 async function fetchEvents(params, callApi) {
+    // Venue does not expose a series concept; honoring `params.series` by returning [] rather than ignoring the filter.
+    if (params.series !== undefined) {
+        return [];
+    }
     try {
         // Direct lookup by slug (post ID, tournament slug, or url_title)
         if (params.slug) {

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/metaculus/utils.d.ts

@@ -1,4 +1,5 @@
 import { UnifiedMarket } from "../../types";
+export declare const METACULUS_PROMOTED_EVENT_KEYS: readonly ["id", "slug", "url_title", "title", "question", "group_of_questions", "projects", "status"];
 /**
  * Base URL passed to parseOpenApiSpec to override the spec's servers[0].url.
  * The generated api.ts already has "https://www.metaculus.com/api" as its server URL,
@@ -23,7 +24,7 @@ export declare function mapStatus(status: string): "active" | "closed";
  * @param eventId   Optional parent event ID (tournament slug) to override
  *                  the value derived from post.projects.tournament.
  */
-export declare function mapMarketToUnified(post: any, eventId?: string): UnifiedMarket | null;
+export declare function mapMarketToUnified(post: any, eventId?: string, groupPostId?: number): UnifiedMarket | null;
 /**
  * Convert a raw Metaculus post into one or more `UnifiedMarket` objects.
  *

package/dist/exchanges/metaculus/utils.js

@@ -1,10 +1,38 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_BASE_URL = void 0;
+exports.DEFAULT_BASE_URL = exports.METACULUS_PROMOTED_EVENT_KEYS = void 0;
 exports.mapStatus = mapStatus;
 exports.mapMarketToUnified = mapMarketToUnified;
 exports.expandPost = expandPost;
 const market_utils_1 = require("../../utils/market-utils");
+const metadata_1 = require("../../utils/metadata");
+// Raw Metaculus Post fields already promoted to first-class UnifiedMarket columns
+// — excluded from sourceMetadata so we capture only what the unified shape drops.
+const METACULUS_PROMOTED_MARKET_KEYS = [
+    // identity / slug
+    'id', 'slug', 'url_title',
+    // title
+    'title',
+    // description lives inside question / group_of_questions — those are excluded below
+    // resolution timing -> resolutionDate
+    'scheduled_resolve_time', 'scheduled_close_time', 'actual_close_time',
+    // forecaster count -> liquidity / openInterest
+    'nr_forecasters',
+    // child objects whose fields are promoted individually
+    'question', 'group_of_questions',
+    // project sub-tree fields that map to image / category / tags / eventId
+    'projects',
+    // status -> mapStatus
+    'status',
+];
+// Raw Metaculus Post fields already promoted to first-class UnifiedEvent columns.
+exports.METACULUS_PROMOTED_EVENT_KEYS = [
+    'id', 'slug', 'url_title',
+    'title',
+    'question', 'group_of_questions',
+    'projects',
+    'status',
+];
 /**
  * Base URL passed to parseOpenApiSpec to override the spec's servers[0].url.
  * The generated api.ts already has "https://www.metaculus.com/api" as its server URL,
@@ -185,7 +213,7 @@ function buildOutcomes(question, postId, medianProb) {
  * @param eventId   Optional parent event ID (tournament slug) to override
  *                  the value derived from post.projects.tournament.
  */
-function mapMarketToUnified(post, eventId) {
+function mapMarketToUnified(post, eventId, groupPostId) {
     if (!post || !post.id)
         return null;
     // Group-of-questions posts have no top-level question -- they must be
@@ -240,6 +268,7 @@ function mapMarketToUnified(post, eventId) {
         image: post.projects?.default_project?.header_image ?? undefined,
         category,
         tags,
+        sourceMetadata: (0, metadata_1.buildSourceMetadata)(post, METACULUS_PROMOTED_MARKET_KEYS, groupPostId !== undefined ? { group_post_id: groupPostId } : undefined),
     };
     (0, market_utils_1.addBinaryOutcomes)(um);
     return um;
@@ -281,7 +310,7 @@ function mapGroupPostToMarkets(post, eventId) {
             actual_close_time: subQuestion.actual_close_time ?? post.actual_close_time,
             status: post.status,
         };
-        const market = mapMarketToUnified(syntheticPost, groupEventId);
+        const market = mapMarketToUnified(syntheticPost, groupEventId, Number(parentPostId));
         if (market) {
             // Tag each outcome with the parent group post ID for traceability
             for (const outcome of market.outcomes) {

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-26T15:22:20.057Z
+ * Generated at: 2026-05-30T13:35:15.586Z
  * 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-26T15:22:20.057Z
+ * Generated at: 2026-05-30T13:35:15.586Z
  * 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/myriad/normalizer.js

@@ -2,8 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MyriadNormalizer = void 0;
 const market_utils_1 = require("../../utils/market-utils");
+const metadata_1 = require("../../utils/metadata");
 const price_1 = require("./price");
 const utils_1 = require("./utils");
+// Raw Myriad fields already promoted to first-class Unified columns — excluded
+// from sourceMetadata so we capture only what the unified shape would drop.
+const MYRIAD_PROMOTED_MARKET_KEYS = [
+    'id', 'networkId', 'title', 'description', 'slug', 'imageUrl',
+    'expiresAt', 'volume24h', 'volume', 'liquidity', 'eventId',
+    'topics', 'outcomes', 'state',
+];
+const MYRIAD_PROMOTED_EVENT_KEYS = [
+    'id', 'title', 'markets',
+];
 function selectTimeframe(interval) {
     switch (interval) {
         case '1m':
@@ -45,6 +56,7 @@ class MyriadNormalizer {
             image: raw.imageUrl,
             tags: raw.topics || [],
             status,
+            sourceMetadata: (0, metadata_1.buildSourceMetadata)(raw, MYRIAD_PROMOTED_MARKET_KEYS),
         };
         (0, market_utils_1.addBinaryOutcomes)(um);
         return um;
@@ -97,6 +109,8 @@ class MyriadNormalizer {
                 ? markets.reduce((sum, m) => sum + (m.volume ?? 0), 0)
                 : undefined,
             url: `https://myriad.markets`,
+            // Keeps non-promoted question fields; raw markets array is promoted.
+            sourceMetadata: (0, metadata_1.buildSourceMetadata)(raw, MYRIAD_PROMOTED_EVENT_KEYS),
         };
     }
     normalizeOHLCV(raw, params, outcomeId) {

package/dist/exchanges/myriad/utils.js

@@ -6,6 +6,17 @@ exports.mapStatusToMyriad = mapStatusToMyriad;
 exports.mapMarketToUnified = mapMarketToUnified;
 exports.mapQuestionToEvent = mapQuestionToEvent;
 const market_utils_1 = require("../../utils/market-utils");
+const metadata_1 = require("../../utils/metadata");
+// Raw Myriad fields already promoted to first-class Unified columns — excluded
+// from sourceMetadata so we capture only what the unified shape would drop.
+const MYRIAD_PROMOTED_MARKET_KEYS = [
+    'id', 'networkId', 'title', 'description', 'slug', 'imageUrl',
+    'expiresAt', 'volume24h', 'volume', 'liquidity', 'eventId',
+    'topics', 'outcomes', 'state',
+];
+const MYRIAD_PROMOTED_EVENT_KEYS = [
+    'id', 'title', 'markets',
+];
 exports.DEFAULT_BASE_URL = 'https://api-v2.myriadprotocol.com';
 // Mainnet network IDs
 exports.NETWORKS = {
@@ -76,6 +87,7 @@ function mapMarketToUnified(market) {
         url: `https://myriad.markets/markets/${market.slug || market.id}`,
         image: market.imageUrl,
         tags: market.topics || [],
+        sourceMetadata: (0, metadata_1.buildSourceMetadata)(market, MYRIAD_PROMOTED_MARKET_KEYS),
     };
     (0, market_utils_1.addBinaryOutcomes)(um);
     return um;
@@ -98,6 +110,8 @@ function mapQuestionToEvent(question) {
         volume24h: markets.reduce((sum, m) => sum + m.volume24h, 0),
         volume: markets.some(m => m.volume !== undefined) ? markets.reduce((sum, m) => sum + (m.volume ?? 0), 0) : undefined,
         url: `https://myriad.markets`,
+        // Keeps non-promoted question fields; raw markets array is promoted.
+        sourceMetadata: (0, metadata_1.buildSourceMetadata)(question, MYRIAD_PROMOTED_EVENT_KEYS),
     };
     return unifiedEvent;
 }

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-26T15:22:20.063Z
+ * Generated at: 2026-05-30T13:35:15.591Z
  * 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-26T15:22:20.063Z
+ * Generated at: 2026-05-30T13:35:15.591Z
  * 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[];