pmxt-core 2.44.5 → 2.44.6

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

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/kalshi/Kalshi.yaml
- * Generated at: 2026-05-25T10:52:11.681Z
+ * Generated at: 2026-05-25T13:34:08.496Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const kalshiApiSpec: {

package/dist/exchanges/kalshi/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.kalshiApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/kalshi/Kalshi.yaml
- * Generated at: 2026-05-25T10:52:11.681Z
+ * Generated at: 2026-05-25T13:34:08.496Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.kalshiApiSpec = {

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

@@ -30,13 +30,20 @@ export interface KalshiRawMarket {
 export interface KalshiRawEvent {
     event_ticker: string;
     title: string;
+    sub_title?: string;
     image_url?: string;
     category?: string;
     tags?: string[];
     series_ticker?: string;
+    series_title?: string;
+    mutually_exclusive?: boolean;
     markets?: KalshiRawMarket[];
     [key: string]: unknown;
 }
+interface KalshiSeriesInfo {
+    title?: string;
+    tags?: string[];
+}
 export interface KalshiRawEventPage {
     events: KalshiRawEvent[];
     cursor?: string | null;
@@ -146,10 +153,13 @@ export declare class KalshiFetcher implements IExchangeFetcher<KalshiRawEvent, K
     }>;
     fetchRawOrders(queryParams: Record<string, any>): Promise<KalshiRawOrder[]>;
     fetchRawHistoricalOrders(queryParams: Record<string, any>): Promise<KalshiRawOrder[]>;
-    fetchRawSeriesMap(): Promise<Map<string, string[]>>;
+    fetchRawSeriesMap(): Promise<Map<string, KalshiSeriesInfo>>;
     fetchRawEventByTicker(eventTicker: string): Promise<KalshiRawEvent[]>;
     private fetchRawEventsDefault;
+    private enrichEventsWithSeriesList;
+    private enrichEventsWithSeriesMap;
     private fetchActiveEvents;
     private fetchAllWithStatus;
     private fetchPageWithStatus;
 }
+export {};

package/dist/exchanges/kalshi/fetcher.js

@@ -65,16 +65,16 @@ class KalshiFetcher {
                     this.fetchAllWithStatus('closed'),
                     this.fetchAllWithStatus('settled'),
                 ]);
-                return [...openEvents, ...closedEvents, ...settledEvents];
+                return this.enrichEventsWithSeriesList([...openEvents, ...closedEvents, ...settledEvents]);
             }
             else if (status === 'closed' || status === 'inactive') {
                 const [closedEvents, settledEvents] = await Promise.all([
                     this.fetchAllWithStatus('closed'),
                     this.fetchAllWithStatus('settled'),
                 ]);
-                return [...closedEvents, ...settledEvents];
+                return this.enrichEventsWithSeriesList([...closedEvents, ...settledEvents]);
             }
-            return this.fetchAllWithStatus('open');
+            return this.enrichEventsWithSeriesList(await this.fetchAllWithStatus('open'));
         }
         catch (error) {
             throw errors_1.kalshiErrorMapper.mapError(error);
@@ -92,7 +92,9 @@ class KalshiFetcher {
             if (status === 'settled')
                 apiStatus = 'settled';
             const limit = Math.max(1, Math.floor(params.limit || BATCH_SIZE));
-            return this.fetchPageWithStatus(apiStatus, limit, params.cursor);
+            const page = await this.fetchPageWithStatus(apiStatus, limit, params.cursor);
+            await this.enrichEventsWithSeriesList(page.events);
+            return page;
         }
         catch (error) {
             throw errors_1.kalshiErrorMapper.mapError(error);
@@ -217,8 +219,11 @@ class KalshiFetcher {
             const seriesList = data.series || [];
             const map = new Map();
             for (const series of seriesList) {
-                if (series.tags && series.tags.length > 0) {
-                    map.set(series.ticker, series.tags);
+                if (series.ticker) {
+                    map.set(series.ticker, {
+                        title: typeof series.title === 'string' ? series.title : undefined,
+                        tags: Array.isArray(series.tags) ? series.tags : undefined,
+                    });
                 }
             }
             return map;
@@ -237,20 +242,24 @@ class KalshiFetcher {
         const event = data.event;
         if (!event)
             return [];
-        // Enrich with series tags
+        // Enrich with series metadata. The series title helps the normalizer
+        // avoid polluted event titles on multi-market futures.
         if (event.series_ticker) {
             try {
                 const seriesData = await this.ctx.callApi('GetSeries', {
                     series_ticker: event.series_ticker,
                 });
                 const series = seriesData.series;
+                if (typeof series?.title === 'string' && series.title.trim()) {
+                    event.series_title = series.title.trim();
+                }
                 if (series?.tags?.length > 0 && (!event.tags || event.tags.length === 0)) {
                     event.tags = series.tags;
                 }
             }
             catch (err) {
-                // Non-critical — tags are enrichment only.
-                logger_1.logger.warn('kalshi: series tag fetch failed', {
+                // Non-critical — series metadata is enrichment only.
+                logger_1.logger.warn('kalshi: series metadata fetch failed', {
                     series_ticker: event.series_ticker,
                     error: err instanceof Error ? err.message : String(err),
                 });
@@ -275,14 +284,7 @@ class KalshiFetcher {
             this.fetchActiveEvents(fetchLimit, apiStatus),
             this.fetchRawSeriesMap(),
         ]);
-        // Enrich events with series tags
-        for (const event of allEvents) {
-            if (event.series_ticker && fetchedSeriesMap.has(event.series_ticker)) {
-                if (!event.tags || event.tags.length === 0) {
-                    event.tags = fetchedSeriesMap.get(event.series_ticker);
-                }
-            }
-        }
+        this.enrichEventsWithSeriesMap(allEvents, fetchedSeriesMap);
         if (fetchLimit >= 1000 && useCache) {
             this.cachedEvents = allEvents;
             this.cachedSeriesMap = fetchedSeriesMap;
@@ -290,6 +292,36 @@ class KalshiFetcher {
         }
         return allEvents;
     }
+    async enrichEventsWithSeriesList(events) {
+        if (events.length === 0)
+            return events;
+        try {
+            const seriesMap = await this.fetchRawSeriesMap();
+            this.enrichEventsWithSeriesMap(events, seriesMap);
+        }
+        catch (err) {
+            // Non-critical — callers can still normalize the venue-native title.
+            logger_1.logger.warn('kalshi: series list enrichment failed', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        return events;
+    }
+    enrichEventsWithSeriesMap(events, seriesMap) {
+        for (const event of events) {
+            if (!event.series_ticker)
+                continue;
+            const seriesInfo = seriesMap.get(event.series_ticker);
+            if (!seriesInfo)
+                continue;
+            if (seriesInfo.title) {
+                event.series_title = seriesInfo.title;
+            }
+            if (seriesInfo.tags?.length && (!event.tags || event.tags.length === 0)) {
+                event.tags = seriesInfo.tags;
+            }
+        }
+    }
     async fetchActiveEvents(targetMarketCount, status = 'open') {
         let allEvents = [];
         let totalMarketCount = 0;

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

@@ -21,6 +21,18 @@ export declare class KalshiNormalizer implements IExchangeNormalizer<KalshiRawEv
     }): Balance[];
     private mapOrderStatus;
     private deriveEventDescription;
+    private deriveEventTitle;
+    private shouldUseSeriesTitle;
+    private deriveCommonEventTitle;
+    private extractEventTitleFromMarketTitle;
+    private composeSeriesTitle;
+    private ensureWinnerTitle;
+    private hasResolutionTerm;
+    private extractEventTitlePrefix;
+    private extractResolutionTerm;
+    private hasWinVerb;
+    private normalizeTitleText;
+    private escapeRegExp;
     private deriveOutcomeLabel;
     private cleanLabel;
     private templateRule;

package/dist/exchanges/kalshi/normalizer.js

@@ -102,7 +102,7 @@ class KalshiNormalizer {
         const markets = this.normalizeMarketsFromEvent(raw);
         return {
             id: raw.event_ticker,
-            title: raw.title,
+            title: this.deriveEventTitle(raw),
             description: this.deriveEventDescription(raw.markets || []),
             slug: raw.event_ticker,
             markets,
@@ -299,6 +299,130 @@ class KalshiNormalizer {
         }
         return texts[0];
     }
+    deriveEventTitle(event) {
+        const rawTitle = this.cleanLabel(event.title) || event.event_ticker;
+        const seriesTitle = this.cleanLabel(event.series_title);
+        const markets = event.markets || [];
+        if (!seriesTitle || !this.shouldUseSeriesTitle(event, markets)) {
+            return rawTitle;
+        }
+        return this.composeSeriesTitle(seriesTitle, this.deriveCommonEventTitle(event, markets));
+    }
+    shouldUseSeriesTitle(event, markets) {
+        if (event.mutually_exclusive !== true)
+            return false;
+        if (markets.length < 4)
+            return false;
+        const rawTitle = this.cleanLabel(event.title);
+        if (!rawTitle)
+            return false;
+        const titleLooksScoped = /(?:\bvs\.?\b|\bversus\b|:)/i.test(rawTitle);
+        if (!titleLooksScoped)
+            return false;
+        const candidateLabels = markets
+            .map((market) => this.deriveOutcomeLabel(market))
+            .filter((label) => label != null && label.length >= 3);
+        if (candidateLabels.length < 4)
+            return false;
+        const normalizedTitle = this.normalizeTitleText(rawTitle);
+        const containedLabels = new Set();
+        for (const label of candidateLabels) {
+            const normalizedLabel = this.normalizeTitleText(label);
+            if (normalizedLabel && normalizedTitle.includes(normalizedLabel)) {
+                containedLabels.add(normalizedLabel);
+            }
+        }
+        return containedLabels.size >= 2;
+    }
+    deriveCommonEventTitle(event, markets) {
+        const eventTitlePrefix = this.extractEventTitlePrefix(event.title);
+        if (eventTitlePrefix) {
+            if (this.hasWinVerb(eventTitlePrefix))
+                return 'Winner';
+            if (this.hasResolutionTerm(eventTitlePrefix))
+                return eventTitlePrefix;
+        }
+        const candidates = new Map();
+        for (const market of markets) {
+            const marketTitle = this.cleanLabel(market.title);
+            if (!marketTitle)
+                continue;
+            const outcomeLabel = this.deriveOutcomeLabel(market);
+            const candidate = this.extractEventTitleFromMarketTitle(marketTitle, outcomeLabel);
+            if (!candidate)
+                continue;
+            candidates.set(candidate, (candidates.get(candidate) ?? 0) + 1);
+        }
+        let best = null;
+        let bestCount = 0;
+        for (const [candidate, count] of candidates.entries()) {
+            if (count > bestCount) {
+                best = candidate;
+                bestCount = count;
+            }
+        }
+        return best;
+    }
+    extractEventTitleFromMarketTitle(title, outcomeLabel) {
+        const escapedOutcome = outcomeLabel ? this.escapeRegExp(outcomeLabel) : '[^?]+?';
+        const winPattern = new RegExp(`^Will (?:the )?${escapedOutcome} win (?:the )?(.+?)\\??$`, 'i');
+        const winMatch = title.match(winPattern);
+        if (winMatch?.[1]) {
+            return this.ensureWinnerTitle(winMatch[1].trim());
+        }
+        const plainWinnerMatch = title.match(/^(.+? Winner)\??$/i);
+        if (plainWinnerMatch?.[1])
+            return plainWinnerMatch[1].trim();
+        const championMatch = title.match(/^(.+? Champion(?:ship)?)\??$/i);
+        if (championMatch?.[1])
+            return championMatch[1].trim();
+        return null;
+    }
+    composeSeriesTitle(seriesTitle, commonTitle) {
+        if (!commonTitle)
+            return seriesTitle;
+        let title = seriesTitle;
+        const year = commonTitle.match(/^\s*(20\d{2})\b/)?.[1];
+        if (year && !new RegExp(`\\b${year}\\b`).test(title)) {
+            title = `${year} ${title}`;
+        }
+        if (this.hasResolutionTerm(title)) {
+            return title;
+        }
+        const resolutionTerm = this.extractResolutionTerm(commonTitle);
+        if (resolutionTerm) {
+            return `${title} ${resolutionTerm}`;
+        }
+        return title;
+    }
+    ensureWinnerTitle(title) {
+        if (this.hasResolutionTerm(title))
+            return title;
+        return `${title} Winner`;
+    }
+    hasResolutionTerm(title) {
+        return /\b(winner|champion|championship|nominee|nomination|election|finals?|cup|award)\b/i.test(title);
+    }
+    extractEventTitlePrefix(title) {
+        const match = title.match(/^(.+?)(?:\s*:\s*|\s+[-\u2013\u2014]\s+)(.+)$/u);
+        const prefix = match?.[1]?.trim();
+        if (prefix && this.normalizeTitleText(prefix) === 'series winner')
+            return null;
+        return prefix || null;
+    }
+    extractResolutionTerm(title) {
+        const match = title.match(/\b(Winner|Champion|Championship|Nominee|Nomination|Election|Finals?|Cup|Award)\b\s*$/i);
+        return match?.[1] || null;
+    }
+    hasWinVerb(title) {
+        return /\bwin(?:s|ning)?\b/i.test(title);
+    }
+    normalizeTitleText(value) {
+        return value.toLowerCase().replace(/[^\p{L}\p{N}]+/gu, ' ').trim();
+    }
+    escapeRegExp(value) {
+        return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
     deriveOutcomeLabel(market) {
         const yesSubtitle = this.cleanLabel(market.yes_sub_title);
         if (yesSubtitle)

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-25T10:52:11.722Z
+ * Generated at: 2026-05-25T13:34:08.535Z
  * 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-25T10:52:11.722Z
+ * Generated at: 2026-05-25T13:34:08.535Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.limitlessApiSpec = {

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-25T10:52:11.733Z
+ * Generated at: 2026-05-25T13:34:08.546Z
  * 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-25T10:52:11.733Z
+ * Generated at: 2026-05-25T13:34:08.546Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.myriadApiSpec = {

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-25T10:52:11.737Z
+ * Generated at: 2026-05-25T13:34:08.549Z
  * 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-25T10:52:11.737Z
+ * Generated at: 2026-05-25T13:34:08.549Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.opinionApiSpec = {

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-25T10:52:11.689Z
+ * Generated at: 2026-05-25T13:34:08.504Z
  * 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-25T10:52:11.689Z
+ * Generated at: 2026-05-25T13:34:08.504Z
  * 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-25T10:52:11.704Z
+ * Generated at: 2026-05-25T13:34:08.517Z
  * 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-25T10:52:11.704Z
+ * Generated at: 2026-05-25T13:34:08.517Z
  * 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-25T10:52:11.701Z
+ * Generated at: 2026-05-25T13:34:08.515Z
  * 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-25T10:52:11.701Z
+ * Generated at: 2026-05-25T13:34:08.515Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketGammaSpec = {

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-25T10:52:11.728Z
+ * Generated at: 2026-05-25T13:34:08.541Z
  * 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-25T10:52:11.728Z
+ * Generated at: 2026-05-25T13:34:08.541Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxt-core",
-  "version": "2.44.5",
+  "version": "2.44.6",
   "description": "pmxt is a unified prediction market data API. The ccxt for prediction markets.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -29,8 +29,8 @@
     "test": "jest -c jest.config.js",
     "server": "tsx watch src/server/index.ts",
     "server:prod": "node dist/server/index.js",
-    "generate:sdk:python": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g python -o ../sdks/python/generated --package-name pmxt_internal --additional-properties=projectName=pmxt-internal,packageVersion=2.44.5,library=urllib3",
-    "generate:sdk:typescript": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g typescript-fetch -o ../sdks/typescript/generated --additional-properties=npmName=pmxtjs,npmVersion=2.44.5,supportsES6=true,typescriptThreePlus=true && node ../sdks/typescript/scripts/fix-generated.js",
+    "generate:sdk:python": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g python -o ../sdks/python/generated --package-name pmxt_internal --additional-properties=projectName=pmxt-internal,packageVersion=2.44.6,library=urllib3",
+    "generate:sdk:typescript": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g typescript-fetch -o ../sdks/typescript/generated --additional-properties=npmName=pmxtjs,npmVersion=2.44.6,supportsES6=true,typescriptThreePlus=true && node ../sdks/typescript/scripts/fix-generated.js",
     "fetch:openapi": "node scripts/fetch-openapi-specs.js",
     "extract:jsdoc": "node ../scripts/extract-jsdoc.js",
     "generate:docs": "npm run extract:jsdoc && node ../scripts/generate-api-docs.js",