pmxt-core 2.32.4 → 2.33.2

package/dist/BaseExchange.d.ts

@@ -2,6 +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';
 export interface ApiEndpoint {
     /** HTTP verb for the endpoint (e.g. GET, POST). */
     method: string;
@@ -227,6 +228,16 @@ export interface ExchangeHas {
     buildOrder: ExchangeCapability;
     /** Whether this exchange supports submitting a pre-built order. */
     submitOrder: ExchangeCapability;
+    /** Whether this exchange supports fetching cross-venue market matches. */
+    fetchMatches: ExchangeCapability;
+    /** Whether this exchange supports fetching cross-venue event matches. */
+    fetchEventMatches: ExchangeCapability;
+    /** Whether this exchange supports comparing prices across venues. */
+    compareMarketPrices: ExchangeCapability;
+    /** Whether this exchange supports finding hedging opportunities across venues. */
+    fetchHedges: ExchangeCapability;
+    /** Whether this exchange supports scanning for arbitrage opportunities. */
+    fetchArbitrage: ExchangeCapability;
 }
 /**
  * Optional authentication credentials for exchange operations.
@@ -559,6 +570,41 @@ export declare abstract class PredictionMarketExchange {
      * Call this when you're done streaming to properly release connections.
      */
     close(): Promise<void>;
+    /**
+     * Fetch cross-venue matches for a given market.
+     *
+     * @param params - Match filter parameters (marketId, relation, minConfidence, etc.)
+     * @returns Array of matched markets with relation and confidence
+     */
+    fetchMatches(params: FetchMatchesParams): Promise<MatchResult[]>;
+    /**
+     * Fetch cross-venue matches for a given event.
+     *
+     * @param params - Event match filter parameters (eventId, relation, etc.)
+     * @returns Array of matched events with market-level match details
+     */
+    fetchEventMatches(params: FetchEventMatchesParams): Promise<EventMatchResult[]>;
+    /**
+     * Compare prices across venues for identity matches of a market.
+     *
+     * @param params - Match filter parameters (uses relation: 'identity' internally)
+     * @returns Array of price comparisons across venues
+     */
+    compareMarketPrices(params: FetchMatchesParams): Promise<PriceComparison[]>;
+    /**
+     * Find hedging opportunities via subset/superset matches across venues.
+     *
+     * @param params - Match filter parameters
+     * @returns Array of subset/superset matches with live prices
+     */
+    fetchHedges(params: FetchMatchesParams): Promise<PriceComparison[]>;
+    /**
+     * Scan for arbitrage opportunities across identity matches.
+     *
+     * @param params - Arbitrage scan parameters (minSpread, category, limit)
+     * @returns Array of arbitrage opportunities sorted by spread
+     */
+    fetchArbitrage(params?: FetchArbitrageParams): Promise<ArbitrageOpportunity[]>;
     /**
      * @internal
      * Implementation for fetching/searching markets.

package/dist/BaseExchange.js

@@ -760,6 +760,54 @@ class PredictionMarketExchange {
         // Default implementation: no-op
         // Exchanges with WebSocket support should override this
     }
+    // ----------------------------------------------------------------------------
+    // Matching Methods (Router-only; stubs throw for standard exchanges)
+    // ----------------------------------------------------------------------------
+    /**
+     * Fetch cross-venue matches for a given market.
+     *
+     * @param params - Match filter parameters (marketId, relation, minConfidence, etc.)
+     * @returns Array of matched markets with relation and confidence
+     */
+    async fetchMatches(params) {
+        throw new Error("Method fetchMatches not implemented.");
+    }
+    /**
+     * Fetch cross-venue matches for a given event.
+     *
+     * @param params - Event match filter parameters (eventId, relation, etc.)
+     * @returns Array of matched events with market-level match details
+     */
+    async fetchEventMatches(params) {
+        throw new Error("Method fetchEventMatches not implemented.");
+    }
+    /**
+     * Compare prices across venues for identity matches of a market.
+     *
+     * @param params - Match filter parameters (uses relation: 'identity' internally)
+     * @returns Array of price comparisons across venues
+     */
+    async compareMarketPrices(params) {
+        throw new Error("Method compareMarketPrices not implemented.");
+    }
+    /**
+     * Find hedging opportunities via subset/superset matches across venues.
+     *
+     * @param params - Match filter parameters
+     * @returns Array of subset/superset matches with live prices
+     */
+    async fetchHedges(params) {
+        throw new Error("Method fetchHedges not implemented.");
+    }
+    /**
+     * Scan for arbitrage opportunities across identity matches.
+     *
+     * @param params - Arbitrage scan parameters (minSpread, category, limit)
+     * @returns Array of arbitrage opportunities sorted by spread
+     */
+    async fetchArbitrage(params) {
+        throw new Error("Method fetchArbitrage not implemented.");
+    }
     /**
      * @internal
      * Implementation for fetching/searching markets.
@@ -886,6 +934,8 @@ class PredictionMarketExchange {
         'watchAddress', 'unwatchAddress', 'watchOrderBook',
         'unwatchOrderBook', 'watchTrades', 'fetchMyTrades',
         'fetchClosedOrders', 'fetchAllOrders', 'buildOrder', 'submitOrder',
+        'fetchMatches', 'fetchEventMatches', 'compareMarketPrices',
+        'fetchHedges', 'fetchArbitrage',
     ];
     // Compile-time exhaustiveness check: fails tsc if a key exists in
     // ExchangeHas but is missing from _capabilityKeys above.
@@ -897,6 +947,8 @@ 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,
+        fetchHedges: true, fetchArbitrage: true,
     };
     /**
      * Map from capability keys to the actual method(s) whose override status

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-22T16:11:36.646Z
+ * Generated at: 2026-04-23T07:50:04.153Z
  * 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-22T16:11:36.646Z
+ * Generated at: 2026-04-23T07:50:04.153Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.kalshiApiSpec = {

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-22T16:11:36.689Z
+ * Generated at: 2026-04-23T07:50:04.190Z
  * 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-22T16:11:36.689Z
+ * Generated at: 2026-04-23T07:50:04.190Z
  * 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-22T16:11:36.707Z
+ * Generated at: 2026-04-23T07:50:04.201Z
  * 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-22T16:11:36.707Z
+ * Generated at: 2026-04-23T07:50:04.201Z
  * 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-22T16:11:36.715Z
+ * Generated at: 2026-04-23T07:50:04.206Z
  * 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-22T16:11:36.715Z
+ * Generated at: 2026-04-23T07:50:04.206Z
  * 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-22T16:11:36.654Z
+ * Generated at: 2026-04-23T07:50:04.161Z
  * 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-22T16:11:36.654Z
+ * Generated at: 2026-04-23T07:50:04.161Z
  * 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-22T16:11:36.669Z
+ * Generated at: 2026-04-23T07:50:04.172Z
  * 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-22T16:11:36.669Z
+ * Generated at: 2026-04-23T07:50:04.172Z
  * 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-22T16:11:36.666Z
+ * Generated at: 2026-04-23T07:50:04.170Z
  * 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-22T16:11:36.666Z
+ * Generated at: 2026-04-23T07:50:04.170Z
  * 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-22T16:11:36.695Z
+ * Generated at: 2026-04-23T07:50:04.194Z
  * 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-22T16:11:36.695Z
+ * Generated at: 2026-04-23T07:50:04.194Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

package/dist/router/Router.d.ts

@@ -1,15 +1,15 @@
+import { PredictionMarketExchange, type MarketFetchParams, type EventFetchParams } from '../BaseExchange';
 import type { UnifiedMarket, UnifiedEvent } from '../types';
-import type { RouterOptions, MatchResult, EventMatchResult, PriceComparison, ArbitrageOpportunity, FetchMatchesParams, FetchEventMatchesParams, FetchArbitrageParams, RouterMarketSearchParams, RouterEventSearchParams } from './types';
-export declare class Router {
-    readonly name = "Router";
+import type { RouterOptions, MatchResult, EventMatchResult, PriceComparison, ArbitrageOpportunity, 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[]>;
     fetchMatches(params: FetchMatchesParams): Promise<MatchResult[]>;
     fetchEventMatches(params: FetchEventMatchesParams): Promise<EventMatchResult[]>;
     compareMarketPrices(params: FetchMatchesParams): Promise<PriceComparison[]>;
     fetchHedges(params: FetchMatchesParams): Promise<PriceComparison[]>;
     fetchArbitrage(params?: FetchArbitrageParams): Promise<ArbitrageOpportunity[]>;
-    fetchMarkets(params?: RouterMarketSearchParams): Promise<UnifiedMarket[]>;
-    fetchEvents(params?: RouterEventSearchParams): Promise<UnifiedEvent[]>;
-    createOrder(): Promise<never>;
 }

package/dist/router/Router.js

@@ -1,19 +1,54 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Router = void 0;
+const BaseExchange_1 = require("../BaseExchange");
 const client_1 = require("./client");
-class Router {
-    name = 'Router';
+class Router extends BaseExchange_1.PredictionMarketExchange {
     client;
     constructor(options) {
+        super({ apiKey: options.apiKey });
         this.client = new client_1.PmxtApiClient(options.apiKey, options.baseUrl);
+        this.rateLimit = 100;
+    }
+    get name() {
+        return 'Router';
     }
     // -----------------------------------------------------------------------
-    // Core: Cross-exchange market matches
+    // BaseExchange implementation delegates
+    // -----------------------------------------------------------------------
+    async fetchMarketsImpl(params) {
+        const response = await this.client.searchMarkets({
+            query: params?.query,
+            category: params?.category,
+            limit: params?.limit,
+            offset: params?.offset,
+            closed: params?.status === 'closed' || params?.status === 'inactive',
+        });
+        return response ?? [];
+    }
+    async fetchEventsImpl(params) {
+        const response = await this.client.searchEvents({
+            query: params?.query,
+            category: params?.category,
+            limit: params?.limit,
+            offset: params?.offset,
+        });
+        return response ?? [];
+    }
+    // -----------------------------------------------------------------------
+    // Cross-exchange market matches
     // -----------------------------------------------------------------------
     async fetchMatches(params) {
         const response = await this.client.getMarketMatches(params);
-        return response.matches ?? [];
+        const matches = response.matches ?? [];
+        return matches.map((m) => ({
+            market: m.market,
+            relation: m.relation,
+            confidence: m.confidence,
+            reasoning: m.reasoning ?? null,
+            bestBid: m.market?.bestBid ?? null,
+            bestAsk: m.market?.bestAsk ?? null,
+        }));
     }
     // -----------------------------------------------------------------------
     // Cross-exchange event matches
@@ -81,7 +116,7 @@ class Router {
             if (matches.length === 0)
                 continue;
             const sourceAsk = market.outcomes[0]?.price ?? null;
-            const sourceBid = sourceAsk; // Best approximation from last price
+            const sourceBid = sourceAsk;
             const sourceVenue = market.sourceExchange ?? '';
             for (const match of matches) {
                 const matchBid = match.bestBid;
@@ -120,22 +155,5 @@ class Router {
         opportunities.sort((a, b) => b.spread - a.spread);
         return opportunities;
     }
-    // -----------------------------------------------------------------------
-    // Cross-venue search
-    // -----------------------------------------------------------------------
-    async fetchMarkets(params) {
-        const response = await this.client.searchMarkets(params);
-        return response ?? [];
-    }
-    async fetchEvents(params) {
-        const response = await this.client.searchEvents(params);
-        return response ?? [];
-    }
-    // -----------------------------------------------------------------------
-    // Disabled: order routing (future)
-    // -----------------------------------------------------------------------
-    async createOrder() {
-        throw new Error('Router order routing is not yet implemented');
-    }
 }
 exports.Router = Router;

package/dist/router/Router.test.js

@@ -23,20 +23,20 @@ describe('Router', () => {
     });
     describe('fetchMatches', () => {
         it('returns matches from the API using marketId', async () => {
-            const mockMatches = [
+            const mockApiResponse = [
                 {
-                    market: { marketId: 'k1', sourceExchange: 'kalshi' },
+                    market: { marketId: 'k1', sourceExchange: 'kalshi', bestBid: 0.60, bestAsk: 0.65 },
                     relation: 'identity',
                     confidence: 0.95,
                     reasoning: 'Same resolution condition.',
-                    bestBid: 0.60,
-                    bestAsk: 0.65,
                 },
             ];
-            clientInstance.getMarketMatches = jest.fn().mockResolvedValue({ matches: mockMatches });
+            clientInstance.getMarketMatches = jest.fn().mockResolvedValue({ matches: mockApiResponse });
             const result = await router.fetchMatches({ marketId: 'm1', relation: 'identity' });
             expect(clientInstance.getMarketMatches).toHaveBeenCalledWith({ marketId: 'm1', relation: 'identity' });
-            expect(result).toEqual(mockMatches);
+            expect(result[0].confidence).toBe(0.95);
+            expect(result[0].bestBid).toBe(0.60);
+            expect(result[0].bestAsk).toBe(0.65);
         });
         it('accepts slug as identifier', async () => {
             clientInstance.getMarketMatches = jest.fn().mockResolvedValue({ matches: [] });
@@ -64,12 +64,10 @@ describe('Router', () => {
         it('fetches identity matches with includePrices and maps to PriceComparison', async () => {
             const mockMatches = [
                 {
-                    market: { marketId: 'k1', sourceExchange: 'kalshi', outcomes: [] },
+                    market: { marketId: 'k1', sourceExchange: 'kalshi', outcomes: [], bestBid: 0.55, bestAsk: 0.62 },
                     relation: 'identity',
                     confidence: 0.9,
                     reasoning: 'Same market.',
-                    bestBid: 0.55,
-                    bestAsk: 0.62,
                 },
             ];
             clientInstance.getMarketMatches = jest.fn().mockResolvedValue({ matches: mockMatches });
@@ -90,28 +88,22 @@ describe('Router', () => {
         it('returns only subset/superset matches with reasoning', async () => {
             const mockMatches = [
                 {
-                    market: { marketId: 'k1', sourceExchange: 'kalshi' },
+                    market: { marketId: 'k1', sourceExchange: 'kalshi', bestBid: 0.60, bestAsk: 0.65 },
                     relation: 'identity',
                     confidence: 0.95,
                     reasoning: 'Same.',
-                    bestBid: 0.60,
-                    bestAsk: 0.65,
                 },
                 {
-                    market: { marketId: 'k2', sourceExchange: 'kalshi' },
+                    market: { marketId: 'k2', sourceExchange: 'kalshi', bestBid: 0.40, bestAsk: 0.45 },
                     relation: 'subset',
                     confidence: 0.8,
                     reasoning: 'Narrower market — nomination implies candidacy.',
-                    bestBid: 0.40,
-                    bestAsk: 0.45,
                 },
                 {
-                    market: { marketId: 'k3', sourceExchange: 'polymarket' },
+                    market: { marketId: 'k3', sourceExchange: 'polymarket', bestBid: 0.70, bestAsk: 0.73 },
                     relation: 'superset',
                     confidence: 0.7,
                     reasoning: 'Broader — popular vote does not guarantee election win.',
-                    bestBid: 0.70,
-                    bestAsk: 0.73,
                 },
             ];
             clientInstance.getMarketMatches = jest.fn().mockResolvedValue({ matches: mockMatches });
@@ -127,7 +119,7 @@ describe('Router', () => {
             const mockMarkets = [{ marketId: 'm1', title: 'BTC' }];
             clientInstance.searchMarkets = jest.fn().mockResolvedValue(mockMarkets);
             const result = await router.fetchMarkets({ query: 'bitcoin' });
-            expect(clientInstance.searchMarkets).toHaveBeenCalledWith({ query: 'bitcoin' });
+            expect(clientInstance.searchMarkets).toHaveBeenCalled();
             expect(result).toEqual(mockMarkets);
         });
     });
@@ -136,13 +128,31 @@ describe('Router', () => {
             const mockEvents = [{ id: 'e1', title: 'Election' }];
             clientInstance.searchEvents = jest.fn().mockResolvedValue(mockEvents);
             const result = await router.fetchEvents({ query: 'election' });
-            expect(clientInstance.searchEvents).toHaveBeenCalledWith({ query: 'election' });
+            expect(clientInstance.searchEvents).toHaveBeenCalled();
             expect(result).toEqual(mockEvents);
         });
     });
     describe('createOrder', () => {
         it('throws not implemented error', async () => {
-            await expect(router.createOrder()).rejects.toThrow('Router order routing is not yet implemented');
+            await expect(router.createOrder({})).rejects.toThrow('not implemented');
+        });
+    });
+    describe('capabilities', () => {
+        it('reports matching methods as supported', () => {
+            expect(router.has.fetchMatches).toBe(true);
+            expect(router.has.fetchEventMatches).toBe(true);
+            expect(router.has.compareMarketPrices).toBe(true);
+            expect(router.has.fetchHedges).toBe(true);
+            expect(router.has.fetchArbitrage).toBe(true);
+        });
+        it('reports trading methods as unsupported', () => {
+            expect(router.has.createOrder).toBe(false);
+            expect(router.has.cancelOrder).toBe(false);
+            expect(router.has.fetchOrderBook).toBe(false);
+        });
+        it('reports search methods as supported', () => {
+            expect(router.has.fetchMarkets).toBe(true);
+            expect(router.has.fetchEvents).toBe(true);
         });
     });
 });

package/dist/server/app.js

@@ -20,6 +20,7 @@ const opinion_1 = require("../exchanges/opinion");
 const metaculus_1 = require("../exchanges/metaculus");
 const smarkets_1 = require("../exchanges/smarkets");
 const polymarket_us_1 = require("../exchanges/polymarket_us");
+const router_1 = require("../router");
 const errors_1 = require("../errors");
 function loadMethodVerbs() {
     const candidates = [
@@ -410,6 +411,10 @@ function createExchange(name, credentials) {
                 apiKey: credentials?.apiKey || process.env.POLYMARKET_US_KEY_ID,
                 privateKey: credentials?.privateKey || process.env.POLYMARKET_US_SECRET_KEY,
             });
+        case "router":
+            return new router_1.Router({
+                apiKey: process.env.PMXT_API_KEY || '',
+            });
         default:
             throw new Error(`Unknown exchange: ${name}`);
     }

package/dist/server/method-verbs.json

@@ -357,5 +357,55 @@
   "close": {
     "verb": "post",
     "args": []
+  },
+  "fetchMatches": {
+    "verb": "get",
+    "args": [
+      {
+        "name": "params",
+        "kind": "object",
+        "optional": false
+      }
+    ]
+  },
+  "fetchEventMatches": {
+    "verb": "get",
+    "args": [
+      {
+        "name": "params",
+        "kind": "object",
+        "optional": false
+      }
+    ]
+  },
+  "compareMarketPrices": {
+    "verb": "post",
+    "args": [
+      {
+        "name": "params",
+        "kind": "object",
+        "optional": false
+      }
+    ]
+  },
+  "fetchHedges": {
+    "verb": "get",
+    "args": [
+      {
+        "name": "params",
+        "kind": "object",
+        "optional": false
+      }
+    ]
+  },
+  "fetchArbitrage": {
+    "verb": "get",
+    "args": [
+      {
+        "name": "params",
+        "kind": "object",
+        "optional": true
+      }
+    ]
   }
 }

package/dist/server/openapi.yaml

@@ -1464,6 +1464,261 @@ paths:
       description: >-
         Close all WebSocket connections and clean up resources. Call this when you're done streaming to properly release
         connections.
+  '/api/{exchange}/fetchMatches':
+    get:
+      summary: Fetch Matches
+      operationId: fetchMatches
+      parameters:
+        - $ref: '#/components/parameters/ExchangeParam'
+        - 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: Fetch Matches response
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: '#/components/schemas/BaseResponse'
+                  - type: object
+                    properties:
+                      data:
+                        type: array
+                        items:
+                          $ref: '#/components/schemas/MatchResult'
+      description: Fetch cross-venue matches for a given market.
+  '/api/{exchange}/fetchEventMatches':
+    get:
+      summary: Fetch Event Matches
+      operationId: fetchEventMatches
+      parameters:
+        - $ref: '#/components/parameters/ExchangeParam'
+        - in: query
+          name: eventId
+          required: false
+          schema:
+            type: string
+        - in: query
+          name: slug
+          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: Fetch Event Matches response
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: '#/components/schemas/BaseResponse'
+                  - type: object
+                    properties:
+                      data:
+                        type: array
+                        items:
+                          $ref: '#/components/schemas/EventMatchResult'
+      description: Fetch cross-venue matches for a given event.
+  '/api/{exchange}/compareMarketPrices':
+    post:
+      summary: Compare Market Prices
+      operationId: compareMarketPrices
+      parameters:
+        - $ref: '#/components/parameters/ExchangeParam'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              title: CompareMarketPricesRequest
+              type: object
+              properties:
+                args:
+                  type: array
+                  maxItems: 1
+                  items:
+                    $ref: '#/components/schemas/FetchMatchesParams'
+                  minItems: 1
+                credentials:
+                  $ref: '#/components/schemas/ExchangeCredentials'
+              required:
+                - args
+      responses:
+        '200':
+          description: Compare Market Prices response
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: '#/components/schemas/BaseResponse'
+                  - type: object
+                    properties:
+                      data:
+                        type: array
+                        items:
+                          $ref: '#/components/schemas/PriceComparison'
+      description: Compare prices across venues for identity matches of a market.
+  '/api/{exchange}/fetchHedges':
+    get:
+      summary: Fetch Hedges
+      operationId: fetchHedges
+      parameters:
+        - $ref: '#/components/parameters/ExchangeParam'
+        - 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: Fetch Hedges response
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: '#/components/schemas/BaseResponse'
+                  - type: object
+                    properties:
+                      data:
+                        type: array
+                        items:
+                          $ref: '#/components/schemas/PriceComparison'
+      description: Find hedging opportunities via subset/superset matches across venues.
+  '/api/{exchange}/fetchArbitrage':
+    get:
+      summary: Fetch Arbitrage
+      operationId: fetchArbitrage
+      parameters:
+        - $ref: '#/components/parameters/ExchangeParam'
+        - in: query
+          name: minSpread
+          required: false
+          schema:
+            type: number
+        - in: query
+          name: category
+          required: false
+          schema:
+            type: string
+        - in: query
+          name: limit
+          required: false
+          schema:
+            type: number
+      responses:
+        '200':
+          description: Fetch Arbitrage response
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: '#/components/schemas/BaseResponse'
+                  - type: object
+                    properties:
+                      data:
+                        type: array
+                        items:
+                          $ref: '#/components/schemas/ArbitrageOpportunity'
+      description: Scan for arbitrage opportunities across identity matches.
 components:
   parameters:
     ExchangeParam:
@@ -1483,6 +1738,7 @@ components:
           - metaculus
           - smarkets
           - polymarket_us
+          - router
       required: true
       description: The prediction market exchange to target.
   schemas:
@@ -2372,6 +2628,167 @@ components:
             max:
               type: number
           description: Sum of market volumes
+    FetchMatchesParams:
+      type: object
+      properties:
+        marketId:
+          type: string
+        slug:
+          type: string
+        url:
+          type: string
+        relation:
+          type: string
+          enum:
+            - identity
+            - subset
+            - superset
+            - overlap
+            - disjoint
+        minConfidence:
+          type: number
+        limit:
+          type: number
+        includePrices:
+          type: boolean
+    FetchEventMatchesParams:
+      type: object
+      properties:
+        eventId:
+          type: string
+        slug:
+          type: string
+        relation:
+          type: string
+          enum:
+            - identity
+            - subset
+            - superset
+            - overlap
+            - disjoint
+        minConfidence:
+          type: number
+        limit:
+          type: number
+        includePrices:
+          type: boolean
+    FetchArbitrageParams:
+      type: object
+      properties:
+        minSpread:
+          type: number
+        category:
+          type: string
+        limit:
+          type: number
+    MatchResult:
+      type: object
+      properties:
+        market:
+          $ref: '#/components/schemas/UnifiedMarket'
+        relation:
+          type: string
+          enum:
+            - identity
+            - subset
+            - superset
+            - overlap
+            - disjoint
+        confidence:
+          type: number
+        reasoning:
+          oneOf:
+            - type: string
+            - {}
+        bestBid:
+          oneOf:
+            - type: number
+            - {}
+        bestAsk:
+          oneOf:
+            - type: number
+            - {}
+      required:
+        - market
+        - relation
+        - confidence
+        - reasoning
+        - bestBid
+        - bestAsk
+    EventMatchResult:
+      type: object
+      properties:
+        event:
+          $ref: '#/components/schemas/UnifiedEvent'
+        marketMatches:
+          type: array
+          items:
+            $ref: '#/components/schemas/MatchResult'
+      required:
+        - event
+        - marketMatches
+    PriceComparison:
+      type: object
+      properties:
+        market:
+          $ref: '#/components/schemas/UnifiedMarket'
+        relation:
+          type: string
+          enum:
+            - identity
+            - subset
+            - superset
+            - overlap
+            - disjoint
+        confidence:
+          type: number
+        reasoning:
+          oneOf:
+            - type: string
+            - {}
+        bestBid:
+          oneOf:
+            - type: number
+            - {}
+        bestAsk:
+          oneOf:
+            - type: number
+            - {}
+        venue:
+          type: string
+      required:
+        - market
+        - relation
+        - confidence
+        - reasoning
+        - bestBid
+        - bestAsk
+        - venue
+    ArbitrageOpportunity:
+      type: object
+      properties:
+        marketA:
+          $ref: '#/components/schemas/UnifiedMarket'
+        marketB:
+          $ref: '#/components/schemas/UnifiedMarket'
+        spread:
+          type: number
+        buyVenue:
+          type: string
+        sellVenue:
+          type: string
+        buyPrice:
+          type: number
+        sellPrice:
+          type: number
+      required:
+        - marketA
+        - marketB
+        - spread
+        - buyVenue
+        - sellVenue
+        - buyPrice
+        - sellPrice
     ExchangeCredentials:
       type: object
       description: Optional authentication credentials for exchange operations.
@@ -2593,3 +3010,10 @@ x-sdk-constructors:
         tsName: privateKey
         type: string
         description: Private key for authentication
+  router:
+    className: Router
+    params:
+      - name: pmxt_api_key
+        tsName: pmxtApiKey
+        type: string
+        description: PMXT API key for hosted access

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxt-core",
-  "version": "2.32.4",
+  "version": "2.33.2",
   "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.32.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.32.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.33.2,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.2,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",