pmxt-core 2.33.4 → 2.34.0

package/dist/BaseExchange.d.ts

@@ -2,7 +2,7 @@ import { AxiosInstance } from 'axios';
 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';
-import type { FetchMatchesParams, FetchEventMatchesParams, FetchArbitrageParams, MatchResult, EventMatchResult, PriceComparison, ArbitrageOpportunity } from './router/types';
+import type { FetchMarketMatchesParams, FetchMatchesParams, FetchEventMatchesParams, FetchArbitrageParams, MatchResult, EventMatchResult, PriceComparison, ArbitrageOpportunity } from './router/types';
 export interface ApiEndpoint {
     /** HTTP verb for the endpoint (e.g. GET, POST). */
     method: string;
@@ -229,6 +229,8 @@ export interface ExchangeHas {
     /** Whether this exchange supports submitting a pre-built order. */
     submitOrder: ExchangeCapability;
     /** Whether this exchange supports fetching cross-venue market matches. */
+    fetchMarketMatches: ExchangeCapability;
+    /** @deprecated Use {@link fetchMarketMatches} instead. */
     fetchMatches: ExchangeCapability;
     /** Whether this exchange supports fetching cross-venue event matches. */
     fetchEventMatches: ExchangeCapability;
@@ -576,6 +578,10 @@ export declare abstract class PredictionMarketExchange {
      * @param params - Match filter parameters (marketId, relation, minConfidence, etc.)
      * @returns Array of matched markets with relation and confidence
      */
+    fetchMarketMatches(params: FetchMarketMatchesParams): Promise<MatchResult[]>;
+    /**
+     * @deprecated Use {@link fetchMarketMatches} instead.
+     */
     fetchMatches(params: FetchMatchesParams): Promise<MatchResult[]>;
     /**
      * Find the same or related event on other venues. Given an event on one venue, discover semantically equivalent events across every other venue PMXT ingests — including market-level match details for each child market.

package/dist/BaseExchange.js

@@ -769,8 +769,15 @@ class PredictionMarketExchange {
      * @param params - Match filter parameters (marketId, relation, minConfidence, etc.)
      * @returns Array of matched markets with relation and confidence
      */
+    async fetchMarketMatches(params) {
+        throw new Error("Method fetchMarketMatches not implemented.");
+    }
+    /**
+     * @deprecated Use {@link fetchMarketMatches} instead.
+     */
     async fetchMatches(params) {
-        throw new Error("Method fetchMatches not implemented.");
+        console.warn('[pmxt] fetchMatches is deprecated, use fetchMarketMatches instead');
+        return this.fetchMarketMatches(params);
     }
     /**
      * Find the same or related event on other venues. Given an event on one venue, discover semantically equivalent events across every other venue PMXT ingests — including market-level match details for each child market.
@@ -934,7 +941,7 @@ class PredictionMarketExchange {
         'watchAddress', 'unwatchAddress', 'watchOrderBook',
         'unwatchOrderBook', 'watchTrades', 'fetchMyTrades',
         'fetchClosedOrders', 'fetchAllOrders', 'buildOrder', 'submitOrder',
-        'fetchMatches', 'fetchEventMatches', 'compareMarketPrices',
+        'fetchMarketMatches', 'fetchMatches', 'fetchEventMatches', 'compareMarketPrices',
         'fetchHedges', 'fetchArbitrage',
     ];
     // Compile-time exhaustiveness check: fails tsc if a key exists in
@@ -947,7 +954,7 @@ class PredictionMarketExchange {
         unwatchAddress: true, watchOrderBook: true, unwatchOrderBook: true,
         watchTrades: true, fetchMyTrades: true, fetchClosedOrders: true,
         fetchAllOrders: true, buildOrder: true, submitOrder: true,
-        fetchMatches: true, fetchEventMatches: true, compareMarketPrices: true,
+        fetchMarketMatches: true, fetchMatches: true, fetchEventMatches: true, compareMarketPrices: true,
         fetchHedges: true, fetchArbitrage: true,
     };
     /**
@@ -959,6 +966,7 @@ class PredictionMarketExchange {
     static _capabilityDelegates = {
         fetchMarkets: 'fetchMarketsImpl',
         fetchEvents: 'fetchEventsImpl',
+        fetchMatches: 'fetchMarketMatches',
     };
     /**
      * Derive the capability map by comparing this instance's prototype chain

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-23T08:37:08.985Z
+ * Generated at: 2026-04-23T12:27:49.664Z
  * 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-23T08:37:08.985Z
+ * Generated at: 2026-04-23T12:27:49.664Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.kalshiApiSpec = {

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

@@ -16,6 +16,9 @@ export interface KalshiRawMarket {
     volume?: number;
     liquidity?: number;
     open_interest?: number;
+    volume_24h_fp?: string;
+    volume_fp?: string;
+    open_interest_fp?: string;
     close_time?: string;
     [key: string]: unknown;
 }

package/dist/exchanges/kalshi/normalizer.js

@@ -72,10 +72,10 @@ class KalshiNormalizer {
             description: market.rules_primary || market.rules_secondary || '',
             outcomes,
             resolutionDate: new Date(market.expiration_time),
-            volume24h: Number(market.volume_24h || market.volume || 0),
-            volume: Number(market.volume || 0),
+            volume24h: parseFloat(market.volume_24h_fp ?? '') || Number(market.volume_24h || market.volume || 0),
+            volume: parseFloat(market.volume_fp ?? '') || Number(market.volume || 0),
             liquidity: Number(market.liquidity || 0),
-            openInterest: Number(market.open_interest || 0),
+            openInterest: parseFloat(market.open_interest_fp ?? '') || Number(market.open_interest || 0),
             url: `https://kalshi.com/events/${event.event_ticker}`,
             category: event.category,
             tags: unifiedTags,
@@ -321,10 +321,10 @@ class KalshiNormalizer {
 exports.KalshiNormalizer = KalshiNormalizer;
 // -- Event sorting utility (exported for fetchEvents) -------------------------
 function eventVolume(event) {
-    return (event.markets || []).reduce((sum, m) => sum + Number(m.volume || 0), 0);
+    return (event.markets || []).reduce((sum, m) => sum + (parseFloat(m.volume_fp ?? '') || Number(m.volume || 0)), 0);
 }
 function eventLiquidity(event) {
-    return (event.markets || []).reduce((sum, m) => sum + Number(m.open_interest || m.liquidity || 0), 0);
+    return (event.markets || []).reduce((sum, m) => sum + (parseFloat(m.open_interest_fp ?? '') || Number(m.open_interest || m.liquidity || 0)), 0);
 }
 function eventNewest(event) {
     const times = (event.markets || [])

package/dist/exchanges/kalshi/utils.js

@@ -73,10 +73,10 @@ function mapMarketToUnified(event, market) {
         description: market.rules_primary || market.rules_secondary || "",
         outcomes: outcomes,
         resolutionDate: new Date(market.expiration_time),
-        volume24h: Number(market.volume_24h || market.volume || 0),
-        volume: Number(market.volume || 0),
-        liquidity: Number(market.liquidity || 0), // Kalshi 'liquidity' might need specific mapping if available, otherwise 0 to avoid conflation
-        openInterest: Number(market.open_interest || 0),
+        volume24h: parseFloat(market.volume_24h_fp ?? '') || Number(market.volume_24h || market.volume || 0),
+        volume: parseFloat(market.volume_fp ?? '') || Number(market.volume || 0),
+        liquidity: Number(market.liquidity || 0),
+        openInterest: parseFloat(market.open_interest_fp ?? '') || Number(market.open_interest || 0),
         url: `https://kalshi.com/events/${event.event_ticker}`,
         category: event.category,
         tags: unifiedTags,

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-23T08:37:09.032Z
+ * Generated at: 2026-04-23T12:27:49.703Z
  * 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-23T08:37:09.032Z
+ * Generated at: 2026-04-23T12:27:49.703Z
  * 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-23T08:37:09.045Z
+ * Generated at: 2026-04-23T12:27:49.714Z
  * 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-23T08:37:09.045Z
+ * Generated at: 2026-04-23T12:27:49.714Z
  * 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-23T08:37:09.051Z
+ * Generated at: 2026-04-23T12:27:49.719Z
  * 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-23T08:37:09.051Z
+ * Generated at: 2026-04-23T12:27:49.719Z
  * 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-23T08:37:08.994Z
+ * Generated at: 2026-04-23T12:27:49.670Z
  * 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-23T08:37:08.994Z
+ * Generated at: 2026-04-23T12:27:49.670Z
  * 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-23T08:37:09.010Z
+ * Generated at: 2026-04-23T12:27:49.686Z
  * 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-23T08:37:09.010Z
+ * Generated at: 2026-04-23T12:27:49.686Z
  * 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-23T08:37:09.007Z
+ * Generated at: 2026-04-23T12:27:49.684Z
  * 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-23T08:37:09.007Z
+ * Generated at: 2026-04-23T12:27:49.684Z
  * 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-23T08:37:09.039Z
+ * Generated at: 2026-04-23T12:27:49.709Z
  * 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-23T08:37:09.039Z
+ * Generated at: 2026-04-23T12:27:49.709Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

package/dist/exchanges/probable/utils.js

@@ -38,7 +38,18 @@ function mapMarketToUnified(market, event) {
         volume: Number(market.volume || 0),
         liquidity: Number(market.liquidity || 0),
         openInterest: 0,
-        url: `https://probable.markets/markets/${market.market_slug || market.slug || market.id}`,
+        url: (() => {
+            const eventSlug = event?.slug || market._parentEvent?.slug;
+            const marketId = market.id;
+            if (eventSlug) {
+                return `https://probable.markets/event/${eventSlug}?market=${marketId}`;
+            }
+            const eventId = event?.id || market.event_id;
+            if (eventId) {
+                return `https://probable.markets/event/${eventId}?market=${marketId}`;
+            }
+            return `https://probable.markets/event/?market=${marketId}`;
+        })(),
         image: market.icon || event?.icon || event?.image || undefined,
         category: event?.category || market.category || undefined,
         tags: market.tags || event?.tags || [],
@@ -65,7 +76,7 @@ function mapEventToUnified(event) {
         markets,
         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://probable.markets/events/${event.slug || event.id}`,
+        url: `https://probable.markets/event/${event.slug || event.id}`,
         image: event.icon || event.image || undefined,
         category: event.category || undefined,
         tags: event.tags || [],

package/dist/router/Router.d.ts

@@ -1,15 +1,25 @@
 import { PredictionMarketExchange, type MarketFetchParams, type EventFetchParams } from '../BaseExchange';
 import type { UnifiedMarket, UnifiedEvent } from '../types';
-import type { RouterOptions, MatchResult, EventMatchResult, PriceComparison, ArbitrageOpportunity, FetchMatchesParams, FetchEventMatchesParams, FetchArbitrageParams } from './types';
+import type { RouterOptions, MatchResult, EventMatchResult, PriceComparison, ArbitrageOpportunity, FetchMarketMatchesParams, FetchMatchesParams, FetchEventMatchesParams, FetchArbitrageParams } from './types';
 export declare class Router extends PredictionMarketExchange {
     private readonly client;
     constructor(options: RouterOptions);
     get name(): string;
     protected fetchMarketsImpl(params?: MarketFetchParams): Promise<UnifiedMarket[]>;
     protected fetchEventsImpl(params?: EventFetchParams): Promise<UnifiedEvent[]>;
+    fetchMarketMatches(params: FetchMarketMatchesParams): Promise<MatchResult[]>;
+    /** @deprecated Use {@link fetchMarketMatches} instead. */
     fetchMatches(params: FetchMatchesParams): Promise<MatchResult[]>;
     fetchEventMatches(params: FetchEventMatchesParams): Promise<EventMatchResult[]>;
-    compareMarketPrices(params: FetchMatchesParams): Promise<PriceComparison[]>;
-    fetchHedges(params: FetchMatchesParams): Promise<PriceComparison[]>;
+    compareMarketPrices(params: FetchMarketMatchesParams): Promise<PriceComparison[]>;
+    fetchHedges(params: FetchMarketMatchesParams): Promise<PriceComparison[]>;
     fetchArbitrage(params?: FetchArbitrageParams): Promise<ArbitrageOpportunity[]>;
+    /**
+     * Bulk arbitrage via `GET /v0/arbitrage`. One round-trip.
+     */
+    private fetchArbitrageBulk;
+    /**
+     * Legacy N+1 fallback: fetch markets, then fetch matches per-market.
+     */
+    private fetchArbitrageFallback;
 }

package/dist/router/Router.js

@@ -38,7 +38,10 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
     // -----------------------------------------------------------------------
     // Cross-exchange market matches
     // -----------------------------------------------------------------------
-    async fetchMatches(params) {
+    async fetchMarketMatches(params) {
+        if (params.market && !params.marketId) {
+            params = { ...params, marketId: params.market.marketId };
+        }
         const response = await this.client.getMarketMatches(params);
         const matches = response.matches ?? [];
         return matches.map((m) => ({
@@ -50,10 +53,18 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
             bestAsk: m.market?.bestAsk ?? null,
         }));
     }
+    /** @deprecated Use {@link fetchMarketMatches} instead. */
+    async fetchMatches(params) {
+        console.warn('[pmxt] fetchMatches is deprecated, use fetchMarketMatches instead');
+        return this.fetchMarketMatches(params);
+    }
     // -----------------------------------------------------------------------
     // Cross-exchange event matches
     // -----------------------------------------------------------------------
     async fetchEventMatches(params) {
+        if (params.event && !params.eventId) {
+            params = { ...params, eventId: params.event.id };
+        }
         const response = await this.client.getEventMatches(params);
         return response.matches ?? [];
     }
@@ -61,7 +72,10 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
     // Price comparison: identity matches with live prices
     // -----------------------------------------------------------------------
     async compareMarketPrices(params) {
-        const matches = await this.fetchMatches({
+        if (params.market && !params.marketId) {
+            params = { ...params, marketId: params.market.marketId };
+        }
+        const matches = await this.fetchMarketMatches({
             ...params,
             relation: 'identity',
             includePrices: true,
@@ -80,7 +94,10 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
     // Hedging: subset/superset matches with live prices
     // -----------------------------------------------------------------------
     async fetchHedges(params) {
-        const matches = await this.fetchMatches({
+        if (params.market && !params.marketId) {
+            params = { ...params, marketId: params.market.marketId };
+        }
+        const matches = await this.fetchMarketMatches({
             ...params,
             includePrices: true,
         });
@@ -97,57 +114,104 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
         }));
     }
     // -----------------------------------------------------------------------
-    // Arbitrage: scan identity matches for price spreads
+    // Arbitrage: scan matches for price spreads
     // -----------------------------------------------------------------------
     async fetchArbitrage(params) {
+        // Try the dedicated bulk endpoint first (single DB query).
+        try {
+            return await this.fetchArbitrageBulk(params);
+        }
+        catch {
+            // Dedicated endpoint not available — fall back to N+1 approach.
+            return this.fetchArbitrageFallback(params);
+        }
+    }
+    /**
+     * Bulk arbitrage via `GET /v0/arbitrage`. One round-trip.
+     */
+    async fetchArbitrageBulk(params) {
+        const query = {};
+        const relations = params?.relations ?? ['identity'];
+        query.relations = relations.join(',');
+        if (params?.minSpread !== undefined)
+            query.minSpread = String(params.minSpread);
+        if (params?.category)
+            query.category = params.category;
+        if (params?.limit !== undefined)
+            query.limit = String(params.limit);
+        const res = await this.client.getArbitrage(query);
+        const items = res.data ?? [];
+        return items.map((r) => ({
+            marketA: r.marketA,
+            marketB: r.marketB,
+            spread: r.spread ?? 0,
+            buyVenue: r.buyVenue ?? '',
+            sellVenue: r.sellVenue ?? '',
+            buyPrice: r.buyPrice ?? 0,
+            sellPrice: r.sellPrice ?? 0,
+            relation: r.relation,
+            confidence: r.confidence,
+        }));
+    }
+    /**
+     * Legacy N+1 fallback: fetch markets, then fetch matches per-market.
+     */
+    async fetchArbitrageFallback(params) {
         const minSpread = params?.minSpread ?? 0;
         const limit = params?.limit ?? 50;
+        const relations = params?.relations ?? ['identity'];
         const markets = await this.fetchMarkets({
             category: params?.category,
             limit,
         });
         const opportunities = [];
         for (const market of markets) {
-            const matches = await this.fetchMatches({
-                marketId: market.marketId,
-                relation: 'identity',
-                includePrices: true,
-            });
-            if (matches.length === 0)
-                continue;
-            const sourceAsk = market.outcomes[0]?.price ?? null;
-            const sourceBid = sourceAsk;
-            const sourceVenue = market.sourceExchange ?? '';
-            for (const match of matches) {
-                const matchBid = match.bestBid;
-                const matchAsk = match.bestAsk;
-                const matchVenue = match.market.sourceExchange ?? '';
-                if (sourceAsk !== null && matchBid !== null) {
-                    const spread = matchBid - sourceAsk;
-                    if (spread >= minSpread) {
-                        opportunities.push({
-                            marketA: market,
-                            marketB: match.market,
-                            spread,
-                            buyVenue: sourceVenue,
-                            sellVenue: matchVenue,
-                            buyPrice: sourceAsk,
-                            sellPrice: matchBid,
-                        });
+            for (const relation of relations) {
+                const matches = await this.fetchMarketMatches({
+                    marketId: market.marketId,
+                    relation,
+                    includePrices: true,
+                });
+                if (matches.length === 0)
+                    continue;
+                const sourceAsk = market.outcomes[0]?.price ?? null;
+                const sourceBid = sourceAsk;
+                const sourceVenue = market.sourceExchange ?? '';
+                for (const match of matches) {
+                    const matchBid = match.bestBid;
+                    const matchAsk = match.bestAsk;
+                    const matchVenue = match.market.sourceExchange ?? '';
+                    if (sourceAsk !== null && matchBid !== null) {
+                        const spread = matchBid - sourceAsk;
+                        if (spread >= minSpread) {
+                            opportunities.push({
+                                marketA: market,
+                                marketB: match.market,
+                                spread,
+                                buyVenue: sourceVenue,
+                                sellVenue: matchVenue,
+                                buyPrice: sourceAsk,
+                                sellPrice: matchBid,
+                                relation: match.relation,
+                                confidence: match.confidence,
+                            });
+                        }
                     }
-                }
-                if (matchAsk !== null && sourceBid !== null) {
-                    const spread = sourceBid - matchAsk;
-                    if (spread >= minSpread) {
-                        opportunities.push({
-                            marketA: match.market,
-                            marketB: market,
-                            spread,
-                            buyVenue: matchVenue,
-                            sellVenue: sourceVenue,
-                            buyPrice: matchAsk,
-                            sellPrice: sourceBid,
-                        });
+                    if (matchAsk !== null && sourceBid !== null) {
+                        const spread = sourceBid - matchAsk;
+                        if (spread >= minSpread) {
+                            opportunities.push({
+                                marketA: match.market,
+                                marketB: market,
+                                spread,
+                                buyVenue: matchVenue,
+                                sellVenue: sourceVenue,
+                                buyPrice: matchAsk,
+                                sellPrice: sourceBid,
+                                relation: match.relation,
+                                confidence: match.confidence,
+                            });
+                        }
                     }
                 }
             }

package/dist/router/Router.test.js

@@ -21,7 +21,7 @@ describe('Router', () => {
             expect(() => new Router_1.Router({ apiKey: 'key' })).not.toThrow();
         });
     });
-    describe('fetchMatches', () => {
+    describe('fetchMarketMatches', () => {
         it('returns matches from the API using marketId', async () => {
             const mockApiResponse = [
                 {
@@ -32,7 +32,7 @@ describe('Router', () => {
                 },
             ];
             clientInstance.getMarketMatches = jest.fn().mockResolvedValue({ matches: mockApiResponse });
-            const result = await router.fetchMatches({ marketId: 'm1', relation: 'identity' });
+            const result = await router.fetchMarketMatches({ marketId: 'm1', relation: 'identity' });
             expect(clientInstance.getMarketMatches).toHaveBeenCalledWith({ marketId: 'm1', relation: 'identity' });
             expect(result[0].confidence).toBe(0.95);
             expect(result[0].bestBid).toBe(0.60);
@@ -40,15 +40,33 @@ describe('Router', () => {
         });
         it('accepts slug as identifier', async () => {
             clientInstance.getMarketMatches = jest.fn().mockResolvedValue({ matches: [] });
-            await router.fetchMatches({ slug: 'btc-100k' });
+            await router.fetchMarketMatches({ slug: 'btc-100k' });
             expect(clientInstance.getMarketMatches).toHaveBeenCalledWith({ slug: 'btc-100k' });
         });
         it('returns empty array when no matches', async () => {
             clientInstance.getMarketMatches = jest.fn().mockResolvedValue({});
-            const result = await router.fetchMatches({ marketId: 'm1' });
+            const result = await router.fetchMarketMatches({ marketId: 'm1' });
             expect(result).toEqual([]);
         });
     });
+    describe('fetchMatches (deprecated)', () => {
+        it('delegates to fetchMarketMatches and logs deprecation warning', async () => {
+            const mockApiResponse = [
+                {
+                    market: { marketId: 'k1', sourceExchange: 'kalshi', bestBid: 0.60, bestAsk: 0.65 },
+                    relation: 'identity',
+                    confidence: 0.95,
+                    reasoning: 'Same resolution condition.',
+                },
+            ];
+            clientInstance.getMarketMatches = jest.fn().mockResolvedValue({ matches: mockApiResponse });
+            const warnSpy = jest.spyOn(console, 'warn').mockImplementation(() => { });
+            const result = await router.fetchMatches({ marketId: 'm1' });
+            expect(warnSpy).toHaveBeenCalledWith('[pmxt] fetchMatches is deprecated, use fetchMarketMatches instead');
+            expect(result[0].confidence).toBe(0.95);
+            warnSpy.mockRestore();
+        });
+    });
     describe('fetchEventMatches', () => {
         it('returns event matches from the API', async () => {
             const mockMatches = [
@@ -139,6 +157,7 @@ describe('Router', () => {
     });
     describe('capabilities', () => {
         it('reports matching methods as supported', () => {
+            expect(router.has.fetchMarketMatches).toBe(true);
             expect(router.has.fetchMatches).toBe(true);
             expect(router.has.fetchEventMatches).toBe(true);
             expect(router.has.compareMarketPrices).toBe(true);

package/dist/router/client.d.ts

@@ -6,6 +6,7 @@ export declare class PmxtApiClient {
     getEventMatches(params: FetchEventMatchesParams): Promise<any>;
     searchMarkets(params?: RouterMarketSearchParams): Promise<any>;
     searchEvents(params?: RouterEventSearchParams): Promise<any>;
+    getArbitrage(query?: Record<string, string>): Promise<any>;
     private request;
     private mapError;
 }

package/dist/router/client.js

@@ -85,6 +85,10 @@ class PmxtApiClient {
         const res = await this.request('GET', '/v0/events', query);
         return res.data;
     }
+    async getArbitrage(query) {
+        const res = await this.request('GET', '/v0/arbitrage', query);
+        return res.data;
+    }
     // -----------------------------------------------------------------------
     // Internal
     // -----------------------------------------------------------------------

package/dist/router/types.d.ts

@@ -33,8 +33,14 @@ export interface ArbitrageOpportunity {
     sellVenue: string;
     buyPrice: number;
     sellPrice: number;
+    /** The set-theoretic relation between the two markets (e.g. identity, subset). */
+    relation?: MatchRelation;
+    /** Match confidence score (0.0 to 1.0). */
+    confidence?: number;
 }
-export interface FetchMatchesParams {
+export interface FetchMarketMatchesParams {
+    /** Pass a UnifiedMarket directly instead of marketId/slug/url. */
+    market?: UnifiedMarket;
     marketId?: string;
     slug?: string;
     url?: string;
@@ -43,7 +49,11 @@ export interface FetchMatchesParams {
     limit?: number;
     includePrices?: boolean;
 }
+/** @deprecated Use {@link FetchMarketMatchesParams} instead. */
+export type FetchMatchesParams = FetchMarketMatchesParams;
 export interface FetchEventMatchesParams {
+    /** Pass a UnifiedEvent directly instead of eventId/slug. */
+    event?: UnifiedEvent;
     eventId?: string;
     slug?: string;
     relation?: MatchRelation;
@@ -55,6 +65,8 @@ export interface FetchArbitrageParams {
     minSpread?: number;
     category?: string;
     limit?: number;
+    /** Comma-separated relation types to include (default: 'identity'). */
+    relations?: MatchRelation[];
 }
 export interface RouterMarketSearchParams {
     query?: string;

package/dist/server/method-verbs.json

@@ -358,6 +358,16 @@
     "verb": "post",
     "args": []
   },
+  "fetchMarketMatches": {
+    "verb": "get",
+    "args": [
+      {
+        "name": "params",
+        "kind": "object",
+        "optional": false
+      }
+    ]
+  },
   "fetchMatches": {
     "verb": "get",
     "args": [

package/dist/server/openapi.yaml

@@ -1464,12 +1464,19 @@ paths:
       description: >-
         Close all WebSocket connections and clean up resources. Call this when you're done streaming to properly release
         connections.
-  '/api/{exchange}/fetchMatches':
+  '/api/{exchange}/fetchMarketMatches':
     get:
       summary: Find Similar Markets
-      operationId: fetchMatches
+      operationId: fetchMarketMatches
       parameters:
         - $ref: '#/components/parameters/ExchangeParam'
+        - in: query
+          name: market
+          required: false
+          schema:
+            allOf:
+              - $ref: '#/components/schemas/UnifiedMarket'
+          description: Pass a UnifiedMarket directly instead of marketId/slug/url.
         - in: query
           name: marketId
           required: false
@@ -1529,12 +1536,88 @@ paths:
         Find the same or related market on other venues. Given a market on one venue, discover semantically equivalent
         markets across every other venue PMXT ingests — each with a relation type (identity, subset, superset, overlap,
         disjoint), confidence score, and reasoning.
+  '/api/{exchange}/fetchMatches':
+    get:
+      summary: Find Similar Markets (Deprecated)
+      operationId: fetchMatches
+      parameters:
+        - $ref: '#/components/parameters/ExchangeParam'
+        - in: query
+          name: market
+          required: false
+          schema:
+            allOf:
+              - $ref: '#/components/schemas/UnifiedMarket'
+          description: Pass a UnifiedMarket directly instead of marketId/slug/url.
+        - in: query
+          name: marketId
+          required: false
+          schema:
+            type: string
+        - in: query
+          name: slug
+          required: false
+          schema:
+            type: string
+        - in: query
+          name: url
+          required: false
+          schema:
+            type: string
+        - in: query
+          name: relation
+          required: false
+          schema:
+            type: string
+            enum:
+              - identity
+              - subset
+              - superset
+              - overlap
+              - disjoint
+        - in: query
+          name: minConfidence
+          required: false
+          schema:
+            type: number
+        - in: query
+          name: limit
+          required: false
+          schema:
+            type: number
+        - in: query
+          name: includePrices
+          required: false
+          schema:
+            type: boolean
+      responses:
+        '200':
+          description: Find Similar Markets (Deprecated) response
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: '#/components/schemas/BaseResponse'
+                  - type: object
+                    properties:
+                      data:
+                        type: array
+                        items:
+                          $ref: '#/components/schemas/MatchResult'
+      deprecated: true
   '/api/{exchange}/fetchEventMatches':
     get:
       summary: Find Similar Events
       operationId: fetchEventMatches
       parameters:
         - $ref: '#/components/parameters/ExchangeParam'
+        - in: query
+          name: event
+          required: false
+          schema:
+            allOf:
+              - $ref: '#/components/schemas/UnifiedEvent'
+          description: Pass a UnifiedEvent directly instead of eventId/slug.
         - in: query
           name: eventId
           required: false
@@ -1605,7 +1688,7 @@ paths:
                   type: array
                   maxItems: 1
                   items:
-                    $ref: '#/components/schemas/FetchMatchesParams'
+                    $ref: '#/components/schemas/FetchMarketMatchesParams'
                   minItems: 1
                 credentials:
                   $ref: '#/components/schemas/ExchangeCredentials'
@@ -1634,6 +1717,13 @@ paths:
       operationId: fetchHedges
       parameters:
         - $ref: '#/components/parameters/ExchangeParam'
+        - in: query
+          name: market
+          required: false
+          schema:
+            allOf:
+              - $ref: '#/components/schemas/UnifiedMarket'
+          description: Pass a UnifiedMarket directly instead of marketId/slug/url.
         - in: query
           name: marketId
           required: false
@@ -1713,6 +1803,20 @@ paths:
           required: false
           schema:
             type: number
+        - in: query
+          name: relations
+          required: false
+          schema:
+            type: array
+            items:
+              type: string
+              enum:
+                - identity
+                - subset
+                - superset
+                - overlap
+                - disjoint
+          description: 'Comma-separated relation types to include (default: ''identity'').'
       responses:
         '200':
           description: Find Arbitrage Opportunities response
@@ -1842,6 +1946,9 @@ components:
         contractAddress:
           type: string
           description: 'On-chain contract / condition identifier where applicable (Polymarket conditionId, etc.).'
+        sourceExchange:
+          type: string
+          description: 'The exchange/venue this market originates from (e.g. ''polymarket'', ''kalshi''). Populated by the Router.'
         'yes':
           allOf:
             - $ref: '#/components/schemas/MarketOutcome'
@@ -1934,6 +2041,9 @@ components:
           items:
             type: string
           description: Optional list of tags associated with the event.
+        sourceExchange:
+          type: string
+          description: 'The exchange/venue this event originates from (e.g. ''polymarket'', ''kalshi''). Populated by the Router.'
       required:
         - id
         - title
@@ -2639,9 +2749,13 @@ components:
             max:
               type: number
           description: Sum of market volumes
-    FetchMatchesParams:
+    FetchMarketMatchesParams:
       type: object
       properties:
+        market:
+          allOf:
+            - $ref: '#/components/schemas/UnifiedMarket'
+          description: Pass a UnifiedMarket directly instead of marketId/slug/url.
         marketId:
           type: string
         slug:
@@ -2665,6 +2779,10 @@ components:
     FetchEventMatchesParams:
       type: object
       properties:
+        event:
+          allOf:
+            - $ref: '#/components/schemas/UnifiedEvent'
+          description: Pass a UnifiedEvent directly instead of eventId/slug.
         eventId:
           type: string
         slug:
@@ -2692,6 +2810,17 @@ components:
           type: string
         limit:
           type: number
+        relations:
+          type: array
+          items:
+            type: string
+            enum:
+              - identity
+              - subset
+              - superset
+              - overlap
+              - disjoint
+          description: 'Comma-separated relation types to include (default: ''identity'').'
     MatchResult:
       type: object
       properties:
@@ -2792,6 +2921,18 @@ components:
           type: number
         sellPrice:
           type: number
+        relation:
+          type: string
+          enum:
+            - identity
+            - subset
+            - superset
+            - overlap
+            - disjoint
+          description: 'The set-theoretic relation between the two markets (e.g. identity, subset).'
+        confidence:
+          type: number
+          description: Match confidence score (0.0 to 1.0).
       required:
         - marketA
         - marketB

package/dist/types.d.ts

@@ -37,6 +37,8 @@ export interface UnifiedEvent {
     category?: string;
     /** Optional list of tags associated with the event. */
     tags?: string[];
+    /** The exchange/venue this event originates from (e.g. 'polymarket', 'kalshi'). Populated by the Router. */
+    sourceExchange?: string;
 }
 export interface UnifiedMarket {
     /** The unique identifier for this market */
@@ -73,6 +75,8 @@ export interface UnifiedMarket {
     status?: string;
     /** On-chain contract / condition identifier where applicable (Polymarket conditionId, etc.). */
     contractAddress?: string;
+    /** The exchange/venue this market originates from (e.g. 'polymarket', 'kalshi'). Populated by the Router. */
+    sourceExchange?: string;
     /** Convenience accessor for the YES outcome on a binary market. */
     yes?: MarketOutcome;
     /** Convenience accessor for the NO outcome on a binary market. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxt-core",
-  "version": "2.33.4",
+  "version": "2.34.0",
   "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.33.4,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.33.4,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.34.0,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.34.0,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",