pmxt-core 2.27.4 → 2.27.6

package/dist/BaseExchange.d.ts

@@ -3,24 +3,37 @@ import { SubscribedAddressSnapshot, SubscriptionOption } from './subscriber/base
 import { Balance, BuiltOrder, CandleInterval, CreateOrderParams, Order, OrderBook, Position, PriceCandle, Trade, UnifiedEvent, UnifiedMarket, UserTrade } from './types';
 import { ExecutionPriceResult } from './utils/math';
 export interface ApiEndpoint {
+    /** HTTP verb for the endpoint (e.g. GET, POST). */
     method: string;
+    /** URL path template, relative to the descriptor's baseUrl. */
     path: string;
+    /** Whether this endpoint requires authenticated credentials. */
     isPrivate?: boolean;
+    /** Identifier used to generate the implicit API method name. */
     operationId?: string;
 }
 export interface ApiDescriptor {
+    /** Base URL that all endpoint paths are resolved against. */
     baseUrl: string;
+    /** Map of endpoint key to endpoint definition used by the implicit API machinery. */
     endpoints: Record<string, ApiEndpoint>;
 }
 export interface ImplicitApiMethodInfo {
+    /** Generated method name exposed on the exchange instance. */
     name: string;
+    /** HTTP verb for the underlying endpoint. */
     method: string;
+    /** URL path template for the underlying endpoint. */
     path: string;
+    /** Whether the underlying endpoint requires authenticated credentials. */
     isPrivate: boolean;
 }
 export interface MarketFilterParams {
+    /** Maximum number of results to return */
     limit?: number;
+    /** Pagination offset — number of results to skip */
     offset?: number;
+    /** Sort order for results */
     sort?: 'volume' | 'liquidity' | 'newest';
     status?: 'active' | 'inactive' | 'closed' | 'all';
     searchIn?: 'title' | 'description' | 'both';
@@ -36,10 +49,14 @@ export interface MarketFetchParams extends MarketFilterParams {
 }
 export interface EventFetchParams {
     query?: string;
+    /** Maximum number of results to return */
     limit?: number;
+    /** Pagination offset — number of results to skip */
     offset?: number;
+    /** Sort order for results */
     sort?: 'volume' | 'liquidity' | 'newest';
     status?: 'active' | 'inactive' | 'closed' | 'all';
+    /** Where to search (default: 'title') */
     searchIn?: 'title' | 'description' | 'both';
     eventId?: string;
     slug?: string;
@@ -49,37 +66,53 @@ export interface EventFetchParams {
  */
 export interface HistoryFilterParams {
     resolution?: CandleInterval;
+    /** Start of the time range */
     start?: Date;
+    /** End of the time range */
     end?: Date;
+    /** Maximum number of results to return */
     limit?: number;
 }
 export interface OHLCVParams {
     resolution: CandleInterval;
+    /** Start of the time range */
     start?: Date;
+    /** End of the time range */
     end?: Date;
+    /** Maximum number of results to return */
     limit?: number;
 }
 /**
  * Parameters for fetching trade history. No resolution parameter - trades are discrete events.
  */
 export interface TradesParams {
+    /** Start of the time range */
     start?: Date;
+    /** End of the time range */
     end?: Date;
+    /** Maximum number of results to return */
     limit?: number;
 }
 export interface MyTradesParams {
     outcomeId?: string;
     marketId?: string;
+    /** Only return records after this date */
     since?: Date;
+    /** Only return records before this date */
     until?: Date;
+    /** Maximum number of results to return */
     limit?: number;
     cursor?: string;
 }
 export interface OrderHistoryParams {
     marketId?: string;
+    /** Only return records after this date */
     since?: Date;
+    /** Only return records before this date */
     until?: Date;
+    /** Maximum number of results to return */
     limit?: number;
+    /** Opaque pagination cursor from a previous response */
     cursor?: string;
 }
 export type MarketFilterCriteria = {
@@ -89,14 +122,17 @@ export type MarketFilterCriteria = {
         min?: number;
         max?: number;
     };
+    /** Filter by total (lifetime) volume range */
     volume?: {
         min?: number;
         max?: number;
     };
+    /** Filter by current liquidity range */
     liquidity?: {
         min?: number;
         max?: number;
     };
+    /** Filter by open interest range */
     openInterest?: {
         min?: number;
         max?: number;
@@ -123,6 +159,7 @@ export type EventFilterCriteria = {
     text?: string;
     searchIn?: ('title' | 'description' | 'category' | 'tags')[];
     category?: string;
+    /** Match events that have any of these tags */
     tags?: string[];
     marketCount?: {
         min?: number;
@@ -136,25 +173,45 @@ export type EventFilterCriteria = {
 export type EventFilterFunction = (event: UnifiedEvent) => boolean;
 export type ExchangeCapability = true | false | 'emulated';
 export interface ExchangeHas {
+    /** Whether this exchange supports fetching markets. */
     fetchMarkets: ExchangeCapability;
+    /** Whether this exchange supports fetching events. */
     fetchEvents: ExchangeCapability;
+    /** Whether this exchange supports fetching OHLCV candles. */
     fetchOHLCV: ExchangeCapability;
+    /** Whether this exchange supports fetching the order book. */
     fetchOrderBook: ExchangeCapability;
+    /** Whether this exchange supports fetching public trades. */
     fetchTrades: ExchangeCapability;
+    /** Whether this exchange supports creating orders. */
     createOrder: ExchangeCapability;
+    /** Whether this exchange supports cancelling orders. */
     cancelOrder: ExchangeCapability;
+    /** Whether this exchange supports fetching a single order by id. */
     fetchOrder: ExchangeCapability;
+    /** Whether this exchange supports fetching open orders. */
     fetchOpenOrders: ExchangeCapability;
+    /** Whether this exchange supports fetching account positions. */
     fetchPositions: ExchangeCapability;
+    /** Whether this exchange supports fetching account balances. */
     fetchBalance: ExchangeCapability;
+    /** Whether this exchange supports subscribing to an on-chain address for updates. */
     watchAddress: ExchangeCapability;
+    /** Whether this exchange supports unsubscribing from a watched address. */
     unwatchAddress: ExchangeCapability;
+    /** Whether this exchange supports streaming order book updates. */
     watchOrderBook: ExchangeCapability;
+    /** Whether this exchange supports streaming trade updates. */
     watchTrades: ExchangeCapability;
+    /** Whether this exchange supports fetching the authenticated user's trade history. */
     fetchMyTrades: ExchangeCapability;
+    /** Whether this exchange supports fetching closed orders. */
     fetchClosedOrders: ExchangeCapability;
+    /** Whether this exchange supports fetching all orders (open and closed). */
     fetchAllOrders: ExchangeCapability;
+    /** Whether this exchange supports building a signed order without submitting it. */
     buildOrder: ExchangeCapability;
+    /** Whether this exchange supports submitting a pre-built order. */
     submitOrder: ExchangeCapability;
 }
 /**
@@ -162,7 +219,9 @@ export interface ExchangeHas {
  */
 export interface ExchangeCredentials {
     apiKey?: string;
+    /** Standard API secret for HMAC-authenticated exchanges */
     apiSecret?: string;
+    /** Standard API passphrase for HMAC-authenticated exchanges */
     passphrase?: string;
     /** Metaculus: `Authorization: Token <apiToken>` for higher rate limits */
     apiToken?: string;
@@ -180,8 +239,11 @@ export interface ExchangeOptions {
 }
 /** Shape returned by fetchMarketsPaginated */
 export interface PaginatedMarketsResult {
+    /** The page of unified markets */
     data: UnifiedMarket[];
+    /** Total number of markets in the snapshot */
     total: number;
+    /** Cursor to pass to the next call, or undefined if this is the last page */
     nextCursor?: string;
 }
 export declare abstract class PredictionMarketExchange {

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-04-09T14:31:05.346Z
+ * Generated at: 2026-04-09T15:36:23.083Z
  * 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-04-09T14:31:05.346Z
+ * Generated at: 2026-04-09T15:36:23.083Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.kalshiApiSpec = {

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

@@ -21,5 +21,8 @@ export declare class KalshiNormalizer implements IExchangeNormalizer<KalshiRawEv
     }): Balance[];
     private mapOrderStatus;
     private deriveEventDescription;
+    private deriveOutcomeLabel;
+    private cleanLabel;
+    private templateRule;
 }
 export declare function sortRawEvents(events: any[], sort: string): any[];

package/dist/exchanges/kalshi/normalizer.js

@@ -34,10 +34,7 @@ class KalshiNormalizer {
         else if (market.yes_ask) {
             price = (0, price_1.fromKalshiCents)(market.yes_ask);
         }
-        let candidateName = null;
-        if (market.subtitle || market.yes_sub_title) {
-            candidateName = (market.subtitle || market.yes_sub_title);
-        }
+        const candidateName = this.deriveOutcomeLabel(market);
         let priceChange = 0;
         if (market.previous_price_dollars !== undefined && market.last_price_dollars !== undefined) {
             priceChange = market.last_price_dollars - market.previous_price_dollars;
@@ -261,27 +258,64 @@ class KalshiNormalizer {
             return '';
         if (texts.length === 1)
             return texts[0];
-        let prefix = texts[0];
-        for (const t of texts) {
-            while (!t.startsWith(prefix))
-                prefix = prefix.slice(0, -1);
-            if (!prefix)
-                break;
+        const templates = new Map();
+        for (const market of markets) {
+            const rawRule = typeof market?.rules_primary === 'string' ? market.rules_primary : '';
+            if (!rawRule)
+                continue;
+            const candidate = this.deriveOutcomeLabel(market);
+            const templated = this.templateRule(rawRule, candidate);
+            templates.set(templated, (templates.get(templated) ?? 0) + 1);
         }
-        const suffixCandidates = texts.map((t) => t.slice(prefix.length));
-        let suffix = suffixCandidates[0];
-        for (const t of suffixCandidates) {
-            while (!t.endsWith(suffix))
-                suffix = suffix.slice(1);
-            if (!suffix)
-                break;
+        // Only consider templates that actually contain the {x} placeholder so
+        // that a rule we failed to template (e.g. candidate name missing) can
+        // never win the vote and leak a specific name into the event description.
+        if (templates.size > 0) {
+            let bestTemplate = null;
+            let bestCount = 0;
+            for (const [template, count] of templates.entries()) {
+                if (!template.includes('{x}'))
+                    continue;
+                if (count > bestCount) {
+                    bestTemplate = template;
+                    bestCount = count;
+                }
+            }
+            if (bestTemplate)
+                return bestTemplate;
         }
-        if (prefix.length + suffix.length < 20)
-            return texts[0];
-        const variables = texts.map((t) => t.slice(prefix.length, suffix.length ? t.length - suffix.length : undefined));
-        if (new Set(variables).size === 1)
-            return texts[0];
-        return prefix + '{x}' + suffix;
+        return texts[0];
+    }
+    deriveOutcomeLabel(market) {
+        const yesSubtitle = this.cleanLabel(market.yes_sub_title);
+        if (yesSubtitle)
+            return yesSubtitle;
+        const subtitle = this.cleanLabel(market.subtitle);
+        if (subtitle)
+            return subtitle;
+        return null;
+    }
+    cleanLabel(value) {
+        if (typeof value !== 'string')
+            return null;
+        const trimmed = value.trim();
+        if (!trimmed)
+            return null;
+        // Some Kalshi markets use structural subtitles like ":: Democratic".
+        if (trimmed.startsWith('::'))
+            return null;
+        return trimmed;
+    }
+    templateRule(rule, candidateName) {
+        if (!candidateName)
+            return rule;
+        const escaped = candidateName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        // Unicode-aware word boundaries so non-ASCII candidate names (Jose,
+        // Muller, O'Brien, etc.) still template correctly. JavaScript's \b is
+        // ASCII-only and would silently fail on such names.
+        const matcher = new RegExp(`(?<![\\p{L}\\p{N}])${escaped}(?![\\p{L}\\p{N}])`, 'gu');
+        const replaced = rule.replace(matcher, '{x}');
+        return replaced === rule ? rule : replaced;
     }
 }
 exports.KalshiNormalizer = KalshiNormalizer;

package/dist/exchanges/kalshi/utils.js

@@ -18,11 +18,17 @@ function mapMarketToUnified(event, market) {
     else if (market.yes_ask) {
         price = (0, price_1.fromKalshiCents)(market.yes_ask);
     }
-    // Extract candidate name
-    let candidateName = null;
-    if (market.subtitle || market.yes_sub_title) {
-        candidateName = market.subtitle || market.yes_sub_title;
-    }
+    // Extract candidate name. Prefer explicit outcome subtitle and ignore
+    // structural labels such as ":: Democratic".
+    const cleanLabel = (value) => {
+        if (typeof value !== "string")
+            return null;
+        const trimmed = value.trim();
+        if (!trimmed || trimmed.startsWith("::"))
+            return null;
+        return trimmed;
+    };
+    const candidateName = cleanLabel(market.yes_sub_title) ?? cleanLabel(market.subtitle);
     // Calculate 24h change
     let priceChange = 0;
     if (market.previous_price_dollars !== undefined &&

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-04-09T14:31:05.395Z
+ * Generated at: 2026-04-09T15:36:23.133Z
  * 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-04-09T14:31:05.395Z
+ * Generated at: 2026-04-09T15:36:23.133Z
  * 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-04-09T14:31:05.411Z
+ * Generated at: 2026-04-09T15:36:23.142Z
  * 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-04-09T14:31:05.411Z
+ * Generated at: 2026-04-09T15:36:23.142Z
  * 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-04-09T14:31:05.416Z
+ * Generated at: 2026-04-09T15:36:23.147Z
  * 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-04-09T14:31:05.416Z
+ * Generated at: 2026-04-09T15:36:23.147Z
  * 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-04-09T14:31:05.354Z
+ * Generated at: 2026-04-09T15:36:23.092Z
  * 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-04-09T14:31:05.354Z
+ * Generated at: 2026-04-09T15:36:23.092Z
  * 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-04-09T14:31:05.372Z
+ * Generated at: 2026-04-09T15:36:23.112Z
  * 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-04-09T14:31:05.372Z
+ * Generated at: 2026-04-09T15:36:23.112Z
  * 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-04-09T14:31:05.369Z
+ * Generated at: 2026-04-09T15:36:23.107Z
  * 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-04-09T14:31:05.369Z
+ * Generated at: 2026-04-09T15:36:23.107Z
  * 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-04-09T14:31:05.402Z
+ * Generated at: 2026-04-09T15:36:23.137Z
  * 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-04-09T14:31:05.402Z
+ * Generated at: 2026-04-09T15:36:23.137Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {