pmxtjs 2.35.4 → 2.35.6

package/dist/esm/generated/src/apis/DefaultApi.d.ts

@@ -160,17 +160,6 @@ export interface FetchMarketsPaginatedRequest {
     cursor?: string;
     filter?: MarketFilterCriteria;
 }
-export interface FetchMatchesRequest {
-    exchange: FetchMatchesExchangeEnum;
-    market?: UnifiedMarket;
-    marketId?: string;
-    slug?: string;
-    url?: string;
-    relation?: FetchMatchesRelationEnum;
-    minConfidence?: number;
-    limit?: number;
-    includePrices?: boolean;
-}
 export interface FetchMyTradesRequest {
     exchange: FetchMyTradesExchangeEnum;
     outcomeId?: string;
@@ -435,16 +424,6 @@ export declare class DefaultApi extends runtime.BaseAPI {
      * Fetch Markets Paginated
      */
     fetchMarketsPaginated(requestParameters: FetchMarketsPaginatedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchMarketsPaginated200Response>;
-    /**
-     * Find Similar Markets (Deprecated)
-     * @deprecated
-     */
-    fetchMatchesRaw(requestParameters: FetchMatchesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FetchMarketMatches200Response>>;
-    /**
-     * Find Similar Markets (Deprecated)
-     * @deprecated
-     */
-    fetchMatches(requestParameters: FetchMatchesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchMarketMatches200Response>;
     /**
      * Fetch My Trades
      */
@@ -1112,35 +1091,6 @@ export declare const FetchMarketsPaginatedExchangeEnum: {
     readonly Router: "router";
 };
 export type FetchMarketsPaginatedExchangeEnum = typeof FetchMarketsPaginatedExchangeEnum[keyof typeof FetchMarketsPaginatedExchangeEnum];
-/**
- * @export
- */
-export declare const FetchMatchesExchangeEnum: {
-    readonly Polymarket: "polymarket";
-    readonly Kalshi: "kalshi";
-    readonly KalshiDemo: "kalshi-demo";
-    readonly Limitless: "limitless";
-    readonly Probable: "probable";
-    readonly Baozi: "baozi";
-    readonly Myriad: "myriad";
-    readonly Opinion: "opinion";
-    readonly Metaculus: "metaculus";
-    readonly Smarkets: "smarkets";
-    readonly PolymarketUs: "polymarket_us";
-    readonly Router: "router";
-};
-export type FetchMatchesExchangeEnum = typeof FetchMatchesExchangeEnum[keyof typeof FetchMatchesExchangeEnum];
-/**
- * @export
- */
-export declare const FetchMatchesRelationEnum: {
-    readonly Identity: "identity";
-    readonly Subset: "subset";
-    readonly Superset: "superset";
-    readonly Overlap: "overlap";
-    readonly Disjoint: "disjoint";
-};
-export type FetchMatchesRelationEnum = typeof FetchMatchesRelationEnum[keyof typeof FetchMatchesRelationEnum];
 /**
  * @export
  */

package/dist/esm/generated/src/apis/DefaultApi.js

@@ -797,58 +797,6 @@ export class DefaultApi extends runtime.BaseAPI {
         const response = await this.fetchMarketsPaginatedRaw(requestParameters, initOverrides);
         return await response.value();
     }
-    /**
-     * Find Similar Markets (Deprecated)
-     * @deprecated
-     */
-    async fetchMatchesRaw(requestParameters, initOverrides) {
-        if (requestParameters['exchange'] == null) {
-            throw new runtime.RequiredError('exchange', 'Required parameter "exchange" was null or undefined when calling fetchMatches().');
-        }
-        const queryParameters = {};
-        if (requestParameters['market'] != null) {
-            queryParameters['market'] = requestParameters['market'];
-        }
-        if (requestParameters['marketId'] != null) {
-            queryParameters['marketId'] = requestParameters['marketId'];
-        }
-        if (requestParameters['slug'] != null) {
-            queryParameters['slug'] = requestParameters['slug'];
-        }
-        if (requestParameters['url'] != null) {
-            queryParameters['url'] = requestParameters['url'];
-        }
-        if (requestParameters['relation'] != null) {
-            queryParameters['relation'] = requestParameters['relation'];
-        }
-        if (requestParameters['minConfidence'] != null) {
-            queryParameters['minConfidence'] = requestParameters['minConfidence'];
-        }
-        if (requestParameters['limit'] != null) {
-            queryParameters['limit'] = requestParameters['limit'];
-        }
-        if (requestParameters['includePrices'] != null) {
-            queryParameters['includePrices'] = requestParameters['includePrices'];
-        }
-        const headerParameters = {};
-        let urlPath = `/api/{exchange}/fetchMatches`;
-        urlPath = urlPath.replace(`{${"exchange"}}`, encodeURIComponent(String(requestParameters['exchange'])));
-        const response = await this.request({
-            path: urlPath,
-            method: 'GET',
-            headers: headerParameters,
-            query: queryParameters,
-        }, initOverrides);
-        return new runtime.JSONApiResponse(response, (jsonValue) => FetchMarketMatches200ResponseFromJSON(jsonValue));
-    }
-    /**
-     * Find Similar Markets (Deprecated)
-     * @deprecated
-     */
-    async fetchMatches(requestParameters, initOverrides) {
-        const response = await this.fetchMatchesRaw(requestParameters, initOverrides);
-        return await response.value();
-    }
     /**
      * Fetch My Trades
      */
@@ -1911,33 +1859,6 @@ export const FetchMarketsPaginatedExchangeEnum = {
     PolymarketUs: 'polymarket_us',
     Router: 'router'
 };
-/**
- * @export
- */
-export const FetchMatchesExchangeEnum = {
-    Polymarket: 'polymarket',
-    Kalshi: 'kalshi',
-    KalshiDemo: 'kalshi-demo',
-    Limitless: 'limitless',
-    Probable: 'probable',
-    Baozi: 'baozi',
-    Myriad: 'myriad',
-    Opinion: 'opinion',
-    Metaculus: 'metaculus',
-    Smarkets: 'smarkets',
-    PolymarketUs: 'polymarket_us',
-    Router: 'router'
-};
-/**
- * @export
- */
-export const FetchMatchesRelationEnum = {
-    Identity: 'identity',
-    Subset: 'subset',
-    Superset: 'superset',
-    Overlap: 'overlap',
-    Disjoint: 'disjoint'
-};
 /**
  * @export
  */

package/dist/esm/pmxt/models.d.ts

@@ -500,8 +500,9 @@ export interface SubscribedAddressSnapshot {
 }
 /** Set-theoretic relation between two markets' resolution conditions. */
 export type MatchRelation = 'identity' | 'subset' | 'superset' | 'overlap' | 'disjoint';
-/** A cross-venue market match with relation classification. */
-export interface MatchResult {
+/** A cross-venue market match with relation classification.
+ *  Market properties (title, slug, url, etc.) are accessible directly on the result. */
+export interface MatchResult extends Readonly<UnifiedMarket> {
     /** The matched market on another venue. */
     market: UnifiedMarket;
     /** Set-theoretic relation between the source and matched market. */
@@ -515,8 +516,9 @@ export interface MatchResult {
     /** Best ask price on the matched venue (when includePrices=true). */
     bestAsk?: number;
 }
-/** A cross-venue event match with constituent market matches. */
-export interface EventMatchResult {
+/** A cross-venue event match with constituent market matches.
+ *  Event properties (title, slug, url, etc.) are accessible directly on the result. */
+export interface EventMatchResult extends Readonly<UnifiedEvent> {
     /** The matched event on another venue. */
     event: UnifiedEvent;
     /** Cross-venue market matches within this event. */

package/dist/esm/pmxt/router.d.ts

@@ -28,7 +28,7 @@ export interface RouterOptions {
  *
  * const router = new pmxt.Router({ pmxtApiKey: "pmxt_live_..." });
  * const markets = await router.fetchMarkets({ query: "election" });
- * const matches = await router.fetchMarketMatches({ market: markets[0] });
+ * const matches = await router.fetchMarketMatches(markets[0]);
  * ```
  */
 export declare class Router extends Exchange {
@@ -36,15 +36,9 @@ export declare class Router extends Exchange {
     /**
      * Find markets on other venues that correspond to a given market.
      *
-     * @param params.market - A UnifiedMarket object (extracts marketId automatically).
-     * @param params.marketId - PMXT market ID.
-     * @param params.slug - Market slug (alternative to marketId).
-     * @param params.url - Market URL on the source venue.
-     * @param params.relation - Filter to a specific relation type.
-     * @param params.minConfidence - Minimum confidence threshold (0–1).
-     * @param params.limit - Maximum number of matches to return.
-     * @param params.includePrices - Attach live bestBid/bestAsk to each match.
+     * @param marketOrParams - A UnifiedMarket, or an options object.
      */
+    fetchMarketMatches(market: UnifiedMarket): Promise<MatchResult[]>;
     fetchMarketMatches(params?: {
         market?: UnifiedMarket;
         marketId?: string;
@@ -58,6 +52,7 @@ export declare class Router extends Exchange {
     /**
      * @deprecated Use {@link fetchMarketMatches} instead.
      */
+    fetchMatches(market: UnifiedMarket): Promise<MatchResult[]>;
     fetchMatches(params?: {
         market?: UnifiedMarket;
         marketId?: string;
@@ -71,14 +66,9 @@ export declare class Router extends Exchange {
     /**
      * Match an entire event across venues.
      *
-     * @param params.event - A UnifiedEvent object (extracts id automatically).
-     * @param params.eventId - PMXT event ID.
-     * @param params.slug - Event slug.
-     * @param params.relation - Filter market matches to a specific relation type.
-     * @param params.minConfidence - Minimum confidence threshold (0–1).
-     * @param params.limit - Maximum number of event matches to return.
-     * @param params.includePrices - Attach live prices to each market match.
+     * @param eventOrParams - A UnifiedEvent, or an options object.
      */
+    fetchEventMatches(event: UnifiedEvent): Promise<EventMatchResult[]>;
     fetchEventMatches(params?: {
         event?: UnifiedEvent;
         eventId?: string;
@@ -91,11 +81,9 @@ export declare class Router extends Exchange {
     /**
      * Compare prices for the same market across venues.
      *
-     * @param params.market - A UnifiedMarket object (extracts marketId automatically).
-     * @param params.marketId - PMXT market ID.
-     * @param params.slug - Market slug.
-     * @param params.url - Market URL.
+     * @param marketOrParams - A UnifiedMarket, or an options object.
      */
+    compareMarketPrices(market: UnifiedMarket): Promise<PriceComparison[]>;
     compareMarketPrices(params?: {
         market?: UnifiedMarket;
         marketId?: string;
@@ -105,11 +93,9 @@ export declare class Router extends Exchange {
     /**
      * Find markets that partially hedge a position.
      *
-     * @param params.market - A UnifiedMarket object (extracts marketId automatically).
-     * @param params.marketId - PMXT market ID.
-     * @param params.slug - Market slug.
-     * @param params.url - Market URL.
+     * @param marketOrParams - A UnifiedMarket, or an options object.
      */
+    fetchHedges(market: UnifiedMarket): Promise<PriceComparison[]>;
     fetchHedges(params?: {
         market?: UnifiedMarket;
         marketId?: string;

package/dist/esm/pmxt/router.js

@@ -66,8 +66,10 @@ function convertEvent(raw) {
 }
 function parseMatchResult(raw) {
     const marketData = raw.market || {};
+    const market = convertMarket(marketData);
     return {
-        market: convertMarket(marketData),
+        ...market,
+        market,
         relation: raw.relation || 'identity',
         confidence: raw.confidence || 0,
         reasoning: raw.reasoning,
@@ -88,29 +90,15 @@ function parseMatchResult(raw) {
  *
  * const router = new pmxt.Router({ pmxtApiKey: "pmxt_live_..." });
  * const markets = await router.fetchMarkets({ query: "election" });
- * const matches = await router.fetchMarketMatches({ market: markets[0] });
+ * const matches = await router.fetchMarketMatches(markets[0]);
  * ```
  */
 export class Router extends Exchange {
     constructor(options = {}) {
         super("router", options);
     }
-    // ------------------------------------------------------------------
-    // Matching
-    // ------------------------------------------------------------------
-    /**
-     * Find markets on other venues that correspond to a given market.
-     *
-     * @param params.market - A UnifiedMarket object (extracts marketId automatically).
-     * @param params.marketId - PMXT market ID.
-     * @param params.slug - Market slug (alternative to marketId).
-     * @param params.url - Market URL on the source venue.
-     * @param params.relation - Filter to a specific relation type.
-     * @param params.minConfidence - Minimum confidence threshold (0–1).
-     * @param params.limit - Maximum number of matches to return.
-     * @param params.includePrices - Attach live bestBid/bestAsk to each match.
-     */
-    async fetchMarketMatches(params = {}) {
+    async fetchMarketMatches(marketOrParams = {}) {
+        const params = 'title' in marketOrParams ? { market: marketOrParams } : marketOrParams;
         await this.initPromise;
         const query = {};
         const marketId = params.marketId ?? params.market?.marketId;
@@ -141,25 +129,12 @@ export class Router extends Exchange {
             throw new Error(`Failed to fetchMarketMatches: ${error}`);
         }
     }
-    /**
-     * @deprecated Use {@link fetchMarketMatches} instead.
-     */
-    async fetchMatches(params = {}) {
+    async fetchMatches(marketOrParams = {}) {
         console.warn('[pmxt] fetchMatches is deprecated, use fetchMarketMatches instead');
-        return this.fetchMarketMatches(params);
+        return this.fetchMarketMatches(marketOrParams);
     }
-    /**
-     * Match an entire event across venues.
-     *
-     * @param params.event - A UnifiedEvent object (extracts id automatically).
-     * @param params.eventId - PMXT event ID.
-     * @param params.slug - Event slug.
-     * @param params.relation - Filter market matches to a specific relation type.
-     * @param params.minConfidence - Minimum confidence threshold (0–1).
-     * @param params.limit - Maximum number of event matches to return.
-     * @param params.includePrices - Attach live prices to each market match.
-     */
-    async fetchEventMatches(params = {}) {
+    async fetchEventMatches(eventOrParams = {}) {
+        const params = 'title' in eventOrParams && 'markets' in eventOrParams ? { event: eventOrParams } : eventOrParams;
         await this.initPromise;
         const query = {};
         const eventId = params.eventId ?? params.event?.id;
@@ -180,10 +155,14 @@ export class Router extends Exchange {
             const data = this.handleResponse(json);
             if (!data)
                 return [];
-            return data.map((entry) => ({
-                event: convertEvent(entry.event || {}),
-                marketMatches: (entry.marketMatches || []).map(parseMatchResult),
-            }));
+            return data.map((entry) => {
+                const event = convertEvent(entry.event || {});
+                return {
+                    ...event,
+                    event,
+                    marketMatches: (entry.marketMatches || []).map(parseMatchResult),
+                };
+            });
         }
         catch (error) {
             if (error instanceof Error)
@@ -191,18 +170,8 @@ export class Router extends Exchange {
             throw new Error(`Failed to fetchEventMatches: ${error}`);
         }
     }
-    // ------------------------------------------------------------------
-    // Price comparison
-    // ------------------------------------------------------------------
-    /**
-     * Compare prices for the same market across venues.
-     *
-     * @param params.market - A UnifiedMarket object (extracts marketId automatically).
-     * @param params.marketId - PMXT market ID.
-     * @param params.slug - Market slug.
-     * @param params.url - Market URL.
-     */
-    async compareMarketPrices(params = {}) {
+    async compareMarketPrices(marketOrParams = {}) {
+        const params = 'title' in marketOrParams ? { market: marketOrParams } : marketOrParams;
         await this.initPromise;
         const query = {};
         const marketId = params.marketId ?? params.market?.marketId;
@@ -247,18 +216,8 @@ export class Router extends Exchange {
             throw new Error(`Failed to compareMarketPrices: ${error}`);
         }
     }
-    // ------------------------------------------------------------------
-    // Hedging
-    // ------------------------------------------------------------------
-    /**
-     * Find markets that partially hedge a position.
-     *
-     * @param params.market - A UnifiedMarket object (extracts marketId automatically).
-     * @param params.marketId - PMXT market ID.
-     * @param params.slug - Market slug.
-     * @param params.url - Market URL.
-     */
-    async fetchHedges(params = {}) {
+    async fetchHedges(marketOrParams = {}) {
+        const params = 'title' in marketOrParams ? { market: marketOrParams } : marketOrParams;
         await this.initPromise;
         const query = {};
         const marketId = params.marketId ?? params.market?.marketId;

package/dist/generated/src/apis/DefaultApi.d.ts

@@ -160,17 +160,6 @@ export interface FetchMarketsPaginatedRequest {
     cursor?: string;
     filter?: MarketFilterCriteria;
 }
-export interface FetchMatchesRequest {
-    exchange: FetchMatchesExchangeEnum;
-    market?: UnifiedMarket;
-    marketId?: string;
-    slug?: string;
-    url?: string;
-    relation?: FetchMatchesRelationEnum;
-    minConfidence?: number;
-    limit?: number;
-    includePrices?: boolean;
-}
 export interface FetchMyTradesRequest {
     exchange: FetchMyTradesExchangeEnum;
     outcomeId?: string;
@@ -435,16 +424,6 @@ export declare class DefaultApi extends runtime.BaseAPI {
      * Fetch Markets Paginated
      */
     fetchMarketsPaginated(requestParameters: FetchMarketsPaginatedRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchMarketsPaginated200Response>;
-    /**
-     * Find Similar Markets (Deprecated)
-     * @deprecated
-     */
-    fetchMatchesRaw(requestParameters: FetchMatchesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FetchMarketMatches200Response>>;
-    /**
-     * Find Similar Markets (Deprecated)
-     * @deprecated
-     */
-    fetchMatches(requestParameters: FetchMatchesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchMarketMatches200Response>;
     /**
      * Fetch My Trades
      */
@@ -1112,35 +1091,6 @@ export declare const FetchMarketsPaginatedExchangeEnum: {
     readonly Router: "router";
 };
 export type FetchMarketsPaginatedExchangeEnum = typeof FetchMarketsPaginatedExchangeEnum[keyof typeof FetchMarketsPaginatedExchangeEnum];
-/**
- * @export
- */
-export declare const FetchMatchesExchangeEnum: {
-    readonly Polymarket: "polymarket";
-    readonly Kalshi: "kalshi";
-    readonly KalshiDemo: "kalshi-demo";
-    readonly Limitless: "limitless";
-    readonly Probable: "probable";
-    readonly Baozi: "baozi";
-    readonly Myriad: "myriad";
-    readonly Opinion: "opinion";
-    readonly Metaculus: "metaculus";
-    readonly Smarkets: "smarkets";
-    readonly PolymarketUs: "polymarket_us";
-    readonly Router: "router";
-};
-export type FetchMatchesExchangeEnum = typeof FetchMatchesExchangeEnum[keyof typeof FetchMatchesExchangeEnum];
-/**
- * @export
- */
-export declare const FetchMatchesRelationEnum: {
-    readonly Identity: "identity";
-    readonly Subset: "subset";
-    readonly Superset: "superset";
-    readonly Overlap: "overlap";
-    readonly Disjoint: "disjoint";
-};
-export type FetchMatchesRelationEnum = typeof FetchMatchesRelationEnum[keyof typeof FetchMatchesRelationEnum];
 /**
  * @export
  */

package/dist/generated/src/apis/DefaultApi.js

@@ -46,8 +46,8 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LoadMarketsOperationExchangeEnum = exports.GetExecutionPriceDetailedOperationExchangeEnum = exports.GetExecutionPriceOperationExchangeEnum = exports.FilterMarketsOperationExchangeEnum = exports.FilterEventsOperationExchangeEnum = exports.FetchTradesExchangeEnum = exports.FetchPositionsExchangeEnum = exports.FetchOrderBookExchangeEnum = exports.FetchOrderExchangeEnum = exports.FetchOpenOrdersExchangeEnum = exports.FetchOHLCVResolutionEnum = exports.FetchOHLCVExchangeEnum = exports.FetchMyTradesExchangeEnum = exports.FetchMatchesRelationEnum = exports.FetchMatchesExchangeEnum = exports.FetchMarketsPaginatedExchangeEnum = exports.FetchMarketsSearchInEnum = exports.FetchMarketsStatusEnum = exports.FetchMarketsSortEnum = exports.FetchMarketsExchangeEnum = exports.FetchMarketMatchesRelationEnum = exports.FetchMarketMatchesExchangeEnum = exports.FetchMarketSearchInEnum = exports.FetchMarketStatusEnum = exports.FetchMarketSortEnum = exports.FetchMarketExchangeEnum = exports.FetchHedgesRelationEnum = exports.FetchHedgesExchangeEnum = exports.FetchEventsPaginatedExchangeEnum = exports.FetchEventsSearchInEnum = exports.FetchEventsStatusEnum = exports.FetchEventsSortEnum = exports.FetchEventsExchangeEnum = exports.FetchEventMatchesRelationEnum = exports.FetchEventMatchesExchangeEnum = exports.FetchEventSearchInEnum = exports.FetchEventStatusEnum = exports.FetchEventSortEnum = exports.FetchEventExchangeEnum = exports.FetchClosedOrdersExchangeEnum = exports.FetchBalanceExchangeEnum = exports.FetchArbitrageRelationsEnum = exports.FetchArbitrageExchangeEnum = exports.FetchAllOrdersExchangeEnum = exports.CreateOrderOperationExchangeEnum = exports.CompareMarketPricesOperationExchangeEnum = exports.CloseOperationExchangeEnum = exports.CancelOrderOperationExchangeEnum = exports.BuildOrderOperationExchangeEnum = exports.DefaultApi = void 0;
-exports.WatchTradesOperationExchangeEnum = exports.WatchOrderBookOperationExchangeEnum = exports.WatchAddressOperationExchangeEnum = exports.UnwatchOrderBookOperationExchangeEnum = exports.UnwatchAddressOperationExchangeEnum = exports.SubmitOrderOperationExchangeEnum = void 0;
+exports.UnwatchAddressOperationExchangeEnum = exports.SubmitOrderOperationExchangeEnum = exports.LoadMarketsOperationExchangeEnum = exports.GetExecutionPriceDetailedOperationExchangeEnum = exports.GetExecutionPriceOperationExchangeEnum = exports.FilterMarketsOperationExchangeEnum = exports.FilterEventsOperationExchangeEnum = exports.FetchTradesExchangeEnum = exports.FetchPositionsExchangeEnum = exports.FetchOrderBookExchangeEnum = exports.FetchOrderExchangeEnum = exports.FetchOpenOrdersExchangeEnum = exports.FetchOHLCVResolutionEnum = exports.FetchOHLCVExchangeEnum = exports.FetchMyTradesExchangeEnum = exports.FetchMarketsPaginatedExchangeEnum = exports.FetchMarketsSearchInEnum = exports.FetchMarketsStatusEnum = exports.FetchMarketsSortEnum = exports.FetchMarketsExchangeEnum = exports.FetchMarketMatchesRelationEnum = exports.FetchMarketMatchesExchangeEnum = exports.FetchMarketSearchInEnum = exports.FetchMarketStatusEnum = exports.FetchMarketSortEnum = exports.FetchMarketExchangeEnum = exports.FetchHedgesRelationEnum = exports.FetchHedgesExchangeEnum = exports.FetchEventsPaginatedExchangeEnum = exports.FetchEventsSearchInEnum = exports.FetchEventsStatusEnum = exports.FetchEventsSortEnum = exports.FetchEventsExchangeEnum = exports.FetchEventMatchesRelationEnum = exports.FetchEventMatchesExchangeEnum = exports.FetchEventSearchInEnum = exports.FetchEventStatusEnum = exports.FetchEventSortEnum = exports.FetchEventExchangeEnum = exports.FetchClosedOrdersExchangeEnum = exports.FetchBalanceExchangeEnum = exports.FetchArbitrageRelationsEnum = exports.FetchArbitrageExchangeEnum = exports.FetchAllOrdersExchangeEnum = exports.CreateOrderOperationExchangeEnum = exports.CompareMarketPricesOperationExchangeEnum = exports.CloseOperationExchangeEnum = exports.CancelOrderOperationExchangeEnum = exports.BuildOrderOperationExchangeEnum = exports.DefaultApi = void 0;
+exports.WatchTradesOperationExchangeEnum = exports.WatchOrderBookOperationExchangeEnum = exports.WatchAddressOperationExchangeEnum = exports.UnwatchOrderBookOperationExchangeEnum = void 0;
 const runtime = __importStar(require("../runtime"));
 const index_1 = require("../models/index");
 /**
@@ -834,58 +834,6 @@ class DefaultApi extends runtime.BaseAPI {
         const response = await this.fetchMarketsPaginatedRaw(requestParameters, initOverrides);
         return await response.value();
     }
-    /**
-     * Find Similar Markets (Deprecated)
-     * @deprecated
-     */
-    async fetchMatchesRaw(requestParameters, initOverrides) {
-        if (requestParameters['exchange'] == null) {
-            throw new runtime.RequiredError('exchange', 'Required parameter "exchange" was null or undefined when calling fetchMatches().');
-        }
-        const queryParameters = {};
-        if (requestParameters['market'] != null) {
-            queryParameters['market'] = requestParameters['market'];
-        }
-        if (requestParameters['marketId'] != null) {
-            queryParameters['marketId'] = requestParameters['marketId'];
-        }
-        if (requestParameters['slug'] != null) {
-            queryParameters['slug'] = requestParameters['slug'];
-        }
-        if (requestParameters['url'] != null) {
-            queryParameters['url'] = requestParameters['url'];
-        }
-        if (requestParameters['relation'] != null) {
-            queryParameters['relation'] = requestParameters['relation'];
-        }
-        if (requestParameters['minConfidence'] != null) {
-            queryParameters['minConfidence'] = requestParameters['minConfidence'];
-        }
-        if (requestParameters['limit'] != null) {
-            queryParameters['limit'] = requestParameters['limit'];
-        }
-        if (requestParameters['includePrices'] != null) {
-            queryParameters['includePrices'] = requestParameters['includePrices'];
-        }
-        const headerParameters = {};
-        let urlPath = `/api/{exchange}/fetchMatches`;
-        urlPath = urlPath.replace(`{${"exchange"}}`, encodeURIComponent(String(requestParameters['exchange'])));
-        const response = await this.request({
-            path: urlPath,
-            method: 'GET',
-            headers: headerParameters,
-            query: queryParameters,
-        }, initOverrides);
-        return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.FetchMarketMatches200ResponseFromJSON)(jsonValue));
-    }
-    /**
-     * Find Similar Markets (Deprecated)
-     * @deprecated
-     */
-    async fetchMatches(requestParameters, initOverrides) {
-        const response = await this.fetchMatchesRaw(requestParameters, initOverrides);
-        return await response.value();
-    }
     /**
      * Fetch My Trades
      */
@@ -1949,33 +1897,6 @@ exports.FetchMarketsPaginatedExchangeEnum = {
     PolymarketUs: 'polymarket_us',
     Router: 'router'
 };
-/**
- * @export
- */
-exports.FetchMatchesExchangeEnum = {
-    Polymarket: 'polymarket',
-    Kalshi: 'kalshi',
-    KalshiDemo: 'kalshi-demo',
-    Limitless: 'limitless',
-    Probable: 'probable',
-    Baozi: 'baozi',
-    Myriad: 'myriad',
-    Opinion: 'opinion',
-    Metaculus: 'metaculus',
-    Smarkets: 'smarkets',
-    PolymarketUs: 'polymarket_us',
-    Router: 'router'
-};
-/**
- * @export
- */
-exports.FetchMatchesRelationEnum = {
-    Identity: 'identity',
-    Subset: 'subset',
-    Superset: 'superset',
-    Overlap: 'overlap',
-    Disjoint: 'disjoint'
-};
 /**
  * @export
  */

package/dist/pmxt/models.d.ts

@@ -500,8 +500,9 @@ export interface SubscribedAddressSnapshot {
 }
 /** Set-theoretic relation between two markets' resolution conditions. */
 export type MatchRelation = 'identity' | 'subset' | 'superset' | 'overlap' | 'disjoint';
-/** A cross-venue market match with relation classification. */
-export interface MatchResult {
+/** A cross-venue market match with relation classification.
+ *  Market properties (title, slug, url, etc.) are accessible directly on the result. */
+export interface MatchResult extends Readonly<UnifiedMarket> {
     /** The matched market on another venue. */
     market: UnifiedMarket;
     /** Set-theoretic relation between the source and matched market. */
@@ -515,8 +516,9 @@ export interface MatchResult {
     /** Best ask price on the matched venue (when includePrices=true). */
     bestAsk?: number;
 }
-/** A cross-venue event match with constituent market matches. */
-export interface EventMatchResult {
+/** A cross-venue event match with constituent market matches.
+ *  Event properties (title, slug, url, etc.) are accessible directly on the result. */
+export interface EventMatchResult extends Readonly<UnifiedEvent> {
     /** The matched event on another venue. */
     event: UnifiedEvent;
     /** Cross-venue market matches within this event. */

package/dist/pmxt/router.d.ts

@@ -28,7 +28,7 @@ export interface RouterOptions {
  *
  * const router = new pmxt.Router({ pmxtApiKey: "pmxt_live_..." });
  * const markets = await router.fetchMarkets({ query: "election" });
- * const matches = await router.fetchMarketMatches({ market: markets[0] });
+ * const matches = await router.fetchMarketMatches(markets[0]);
  * ```
  */
 export declare class Router extends Exchange {
@@ -36,15 +36,9 @@ export declare class Router extends Exchange {
     /**
      * Find markets on other venues that correspond to a given market.
      *
-     * @param params.market - A UnifiedMarket object (extracts marketId automatically).
-     * @param params.marketId - PMXT market ID.
-     * @param params.slug - Market slug (alternative to marketId).
-     * @param params.url - Market URL on the source venue.
-     * @param params.relation - Filter to a specific relation type.
-     * @param params.minConfidence - Minimum confidence threshold (0–1).
-     * @param params.limit - Maximum number of matches to return.
-     * @param params.includePrices - Attach live bestBid/bestAsk to each match.
+     * @param marketOrParams - A UnifiedMarket, or an options object.
      */
+    fetchMarketMatches(market: UnifiedMarket): Promise<MatchResult[]>;
     fetchMarketMatches(params?: {
         market?: UnifiedMarket;
         marketId?: string;
@@ -58,6 +52,7 @@ export declare class Router extends Exchange {
     /**
      * @deprecated Use {@link fetchMarketMatches} instead.
      */
+    fetchMatches(market: UnifiedMarket): Promise<MatchResult[]>;
     fetchMatches(params?: {
         market?: UnifiedMarket;
         marketId?: string;
@@ -71,14 +66,9 @@ export declare class Router extends Exchange {
     /**
      * Match an entire event across venues.
      *
-     * @param params.event - A UnifiedEvent object (extracts id automatically).
-     * @param params.eventId - PMXT event ID.
-     * @param params.slug - Event slug.
-     * @param params.relation - Filter market matches to a specific relation type.
-     * @param params.minConfidence - Minimum confidence threshold (0–1).
-     * @param params.limit - Maximum number of event matches to return.
-     * @param params.includePrices - Attach live prices to each market match.
+     * @param eventOrParams - A UnifiedEvent, or an options object.
      */
+    fetchEventMatches(event: UnifiedEvent): Promise<EventMatchResult[]>;
     fetchEventMatches(params?: {
         event?: UnifiedEvent;
         eventId?: string;
@@ -91,11 +81,9 @@ export declare class Router extends Exchange {
     /**
      * Compare prices for the same market across venues.
      *
-     * @param params.market - A UnifiedMarket object (extracts marketId automatically).
-     * @param params.marketId - PMXT market ID.
-     * @param params.slug - Market slug.
-     * @param params.url - Market URL.
+     * @param marketOrParams - A UnifiedMarket, or an options object.
      */
+    compareMarketPrices(market: UnifiedMarket): Promise<PriceComparison[]>;
     compareMarketPrices(params?: {
         market?: UnifiedMarket;
         marketId?: string;
@@ -105,11 +93,9 @@ export declare class Router extends Exchange {
     /**
      * Find markets that partially hedge a position.
      *
-     * @param params.market - A UnifiedMarket object (extracts marketId automatically).
-     * @param params.marketId - PMXT market ID.
-     * @param params.slug - Market slug.
-     * @param params.url - Market URL.
+     * @param marketOrParams - A UnifiedMarket, or an options object.
      */
+    fetchHedges(market: UnifiedMarket): Promise<PriceComparison[]>;
     fetchHedges(params?: {
         market?: UnifiedMarket;
         marketId?: string;

package/dist/pmxt/router.js

@@ -102,8 +102,10 @@ function convertEvent(raw) {
 }
 function parseMatchResult(raw) {
     const marketData = raw.market || {};
+    const market = convertMarket(marketData);
     return {
-        market: convertMarket(marketData),
+        ...market,
+        market,
         relation: raw.relation || 'identity',
         confidence: raw.confidence || 0,
         reasoning: raw.reasoning,
@@ -124,29 +126,15 @@ function parseMatchResult(raw) {
  *
  * const router = new pmxt.Router({ pmxtApiKey: "pmxt_live_..." });
  * const markets = await router.fetchMarkets({ query: "election" });
- * const matches = await router.fetchMarketMatches({ market: markets[0] });
+ * const matches = await router.fetchMarketMatches(markets[0]);
  * ```
  */
 class Router extends client_js_1.Exchange {
     constructor(options = {}) {
         super("router", options);
     }
-    // ------------------------------------------------------------------
-    // Matching
-    // ------------------------------------------------------------------
-    /**
-     * Find markets on other venues that correspond to a given market.
-     *
-     * @param params.market - A UnifiedMarket object (extracts marketId automatically).
-     * @param params.marketId - PMXT market ID.
-     * @param params.slug - Market slug (alternative to marketId).
-     * @param params.url - Market URL on the source venue.
-     * @param params.relation - Filter to a specific relation type.
-     * @param params.minConfidence - Minimum confidence threshold (0–1).
-     * @param params.limit - Maximum number of matches to return.
-     * @param params.includePrices - Attach live bestBid/bestAsk to each match.
-     */
-    async fetchMarketMatches(params = {}) {
+    async fetchMarketMatches(marketOrParams = {}) {
+        const params = 'title' in marketOrParams ? { market: marketOrParams } : marketOrParams;
         await this.initPromise;
         const query = {};
         const marketId = params.marketId ?? params.market?.marketId;
@@ -177,25 +165,12 @@ class Router extends client_js_1.Exchange {
             throw new Error(`Failed to fetchMarketMatches: ${error}`);
         }
     }
-    /**
-     * @deprecated Use {@link fetchMarketMatches} instead.
-     */
-    async fetchMatches(params = {}) {
+    async fetchMatches(marketOrParams = {}) {
         console.warn('[pmxt] fetchMatches is deprecated, use fetchMarketMatches instead');
-        return this.fetchMarketMatches(params);
+        return this.fetchMarketMatches(marketOrParams);
     }
-    /**
-     * Match an entire event across venues.
-     *
-     * @param params.event - A UnifiedEvent object (extracts id automatically).
-     * @param params.eventId - PMXT event ID.
-     * @param params.slug - Event slug.
-     * @param params.relation - Filter market matches to a specific relation type.
-     * @param params.minConfidence - Minimum confidence threshold (0–1).
-     * @param params.limit - Maximum number of event matches to return.
-     * @param params.includePrices - Attach live prices to each market match.
-     */
-    async fetchEventMatches(params = {}) {
+    async fetchEventMatches(eventOrParams = {}) {
+        const params = 'title' in eventOrParams && 'markets' in eventOrParams ? { event: eventOrParams } : eventOrParams;
         await this.initPromise;
         const query = {};
         const eventId = params.eventId ?? params.event?.id;
@@ -216,10 +191,14 @@ class Router extends client_js_1.Exchange {
             const data = this.handleResponse(json);
             if (!data)
                 return [];
-            return data.map((entry) => ({
-                event: convertEvent(entry.event || {}),
-                marketMatches: (entry.marketMatches || []).map(parseMatchResult),
-            }));
+            return data.map((entry) => {
+                const event = convertEvent(entry.event || {});
+                return {
+                    ...event,
+                    event,
+                    marketMatches: (entry.marketMatches || []).map(parseMatchResult),
+                };
+            });
         }
         catch (error) {
             if (error instanceof Error)
@@ -227,18 +206,8 @@ class Router extends client_js_1.Exchange {
             throw new Error(`Failed to fetchEventMatches: ${error}`);
         }
     }
-    // ------------------------------------------------------------------
-    // Price comparison
-    // ------------------------------------------------------------------
-    /**
-     * Compare prices for the same market across venues.
-     *
-     * @param params.market - A UnifiedMarket object (extracts marketId automatically).
-     * @param params.marketId - PMXT market ID.
-     * @param params.slug - Market slug.
-     * @param params.url - Market URL.
-     */
-    async compareMarketPrices(params = {}) {
+    async compareMarketPrices(marketOrParams = {}) {
+        const params = 'title' in marketOrParams ? { market: marketOrParams } : marketOrParams;
         await this.initPromise;
         const query = {};
         const marketId = params.marketId ?? params.market?.marketId;
@@ -283,18 +252,8 @@ class Router extends client_js_1.Exchange {
             throw new Error(`Failed to compareMarketPrices: ${error}`);
         }
     }
-    // ------------------------------------------------------------------
-    // Hedging
-    // ------------------------------------------------------------------
-    /**
-     * Find markets that partially hedge a position.
-     *
-     * @param params.market - A UnifiedMarket object (extracts marketId automatically).
-     * @param params.marketId - PMXT market ID.
-     * @param params.slug - Market slug.
-     * @param params.url - Market URL.
-     */
-    async fetchHedges(params = {}) {
+    async fetchHedges(marketOrParams = {}) {
+        const params = 'title' in marketOrParams ? { market: marketOrParams } : marketOrParams;
         await this.initPromise;
         const query = {};
         const marketId = params.marketId ?? params.market?.marketId;

package/generated/docs/DefaultApi.md

@@ -22,7 +22,6 @@ All URIs are relative to *http://localhost:3847*
 | [**fetchMarketMatches**](DefaultApi.md#fetchmarketmatches) | **GET** /api/{exchange}/fetchMarketMatches | Find Similar Markets |
 | [**fetchMarkets**](DefaultApi.md#fetchmarkets) | **GET** /api/{exchange}/fetchMarkets | Fetch Markets |
 | [**fetchMarketsPaginated**](DefaultApi.md#fetchmarketspaginated) | **GET** /api/{exchange}/fetchMarketsPaginated | Fetch Markets Paginated |
-| [**fetchMatches**](DefaultApi.md#fetchmatches) | **GET** /api/{exchange}/fetchMatches | Find Similar Markets (Deprecated) |
 | [**fetchMyTrades**](DefaultApi.md#fetchmytrades) | **GET** /api/{exchange}/fetchMyTrades | Fetch My Trades |
 | [**fetchOHLCV**](DefaultApi.md#fetchohlcv) | **GET** /api/{exchange}/fetchOHLCV | Fetch OHLCV |
 | [**fetchOpenOrders**](DefaultApi.md#fetchopenorders) | **GET** /api/{exchange}/fetchOpenOrders | Fetch Open Orders |
@@ -1532,95 +1531,6 @@ No authorization required
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## fetchMatches
-
-> FetchMarketMatches200Response fetchMatches(exchange, market, marketId, slug, url, relation, minConfidence, limit, includePrices)
-
-Find Similar Markets (Deprecated)
-
-### Example
-
-```ts
-import {
-  Configuration,
-  DefaultApi,
-} from 'pmxtjs';
-import type { FetchMatchesRequest } from 'pmxtjs';
-
-async function example() {
-  console.log("🚀 Testing pmxtjs SDK...");
-  const api = new DefaultApi();
-
-  const body = {
-    // 'polymarket' | 'kalshi' | 'kalshi-demo' | 'limitless' | 'probable' | 'baozi' | 'myriad' | 'opinion' | 'metaculus' | 'smarkets' | 'polymarket_us' | 'router' | The prediction market exchange to target.
-    exchange: exchange_example,
-    // UnifiedMarket | Pass a UnifiedMarket directly instead of marketId/slug/url. (optional)
-    market: ...,
-    // string (optional)
-    marketId: marketId_example,
-    // string (optional)
-    slug: slug_example,
-    // string (optional)
-    url: url_example,
-    // 'identity' | 'subset' | 'superset' | 'overlap' | 'disjoint' (optional)
-    relation: relation_example,
-    // number (optional)
-    minConfidence: 8.14,
-    // number (optional)
-    limit: 8.14,
-    // boolean (optional)
-    includePrices: true,
-  } satisfies FetchMatchesRequest;
-
-  try {
-    const data = await api.fetchMatches(body);
-    console.log(data);
-  } catch (error) {
-    console.error(error);
-  }
-}
-
-// Run the test
-example().catch(console.error);
-```
-
-### Parameters
-
-
-| Name | Type | Description  | Notes |
-|------------- | ------------- | ------------- | -------------|
-| **exchange** | `polymarket`, `kalshi`, `kalshi-demo`, `limitless`, `probable`, `baozi`, `myriad`, `opinion`, `metaculus`, `smarkets`, `polymarket_us`, `router` | The prediction market exchange to target. | [Defaults to `undefined`] [Enum: polymarket, kalshi, kalshi-demo, limitless, probable, baozi, myriad, opinion, metaculus, smarkets, polymarket_us, router] |
-| **market** | [](.md) | Pass a UnifiedMarket directly instead of marketId/slug/url. | [Optional] [Defaults to `undefined`] |
-| **marketId** | `string` |  | [Optional] [Defaults to `undefined`] |
-| **slug** | `string` |  | [Optional] [Defaults to `undefined`] |
-| **url** | `string` |  | [Optional] [Defaults to `undefined`] |
-| **relation** | `identity`, `subset`, `superset`, `overlap`, `disjoint` |  | [Optional] [Defaults to `undefined`] [Enum: identity, subset, superset, overlap, disjoint] |
-| **minConfidence** | `number` |  | [Optional] [Defaults to `undefined`] |
-| **limit** | `number` |  | [Optional] [Defaults to `undefined`] |
-| **includePrices** | `boolean` |  | [Optional] [Defaults to `undefined`] |
-
-### Return type
-
-[**FetchMarketMatches200Response**](FetchMarketMatches200Response.md)
-
-### Authorization
-
-No authorization required
-
-### HTTP request headers
-
-- **Content-Type**: Not defined
-- **Accept**: `application/json`
-
-
-### HTTP response details
-| Status code | Description | Response headers |
-|-------------|-------------|------------------|
-| **200** | Find Similar Markets (Deprecated) response |  -  |
-
-[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
-
-
 ## fetchMyTrades
 
 > FetchMyTrades200Response fetchMyTrades(exchange, outcomeId, marketId, since, until, limit, cursor)

package/generated/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxtjs",
-  "version": "2.35.4",
+  "version": "2.35.6",
   "description": "OpenAPI client for pmxtjs",
   "author": "OpenAPI-Generator",
   "repository": {

package/generated/src/apis/DefaultApi.ts

@@ -321,18 +321,6 @@ export interface FetchMarketsPaginatedRequest {
     filter?: MarketFilterCriteria;
 }
 
-export interface FetchMatchesRequest {
-    exchange: FetchMatchesExchangeEnum;
-    market?: UnifiedMarket;
-    marketId?: string;
-    slug?: string;
-    url?: string;
-    relation?: FetchMatchesRelationEnum;
-    minConfidence?: number;
-    limit?: number;
-    includePrices?: boolean;
-}
-
 export interface FetchMyTradesRequest {
     exchange: FetchMyTradesExchangeEnum;
     outcomeId?: string;
@@ -1513,77 +1501,6 @@ export class DefaultApi extends runtime.BaseAPI {
         return await response.value();
     }
 
-    /**
-     * Find Similar Markets (Deprecated)
-     * @deprecated
-     */
-    async fetchMatchesRaw(requestParameters: FetchMatchesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FetchMarketMatches200Response>> {
-        if (requestParameters['exchange'] == null) {
-            throw new runtime.RequiredError(
-                'exchange',
-                'Required parameter "exchange" was null or undefined when calling fetchMatches().'
-            );
-        }
-
-        const queryParameters: any = {};
-
-        if (requestParameters['market'] != null) {
-            queryParameters['market'] = requestParameters['market'];
-        }
-
-        if (requestParameters['marketId'] != null) {
-            queryParameters['marketId'] = requestParameters['marketId'];
-        }
-
-        if (requestParameters['slug'] != null) {
-            queryParameters['slug'] = requestParameters['slug'];
-        }
-
-        if (requestParameters['url'] != null) {
-            queryParameters['url'] = requestParameters['url'];
-        }
-
-        if (requestParameters['relation'] != null) {
-            queryParameters['relation'] = requestParameters['relation'];
-        }
-
-        if (requestParameters['minConfidence'] != null) {
-            queryParameters['minConfidence'] = requestParameters['minConfidence'];
-        }
-
-        if (requestParameters['limit'] != null) {
-            queryParameters['limit'] = requestParameters['limit'];
-        }
-
-        if (requestParameters['includePrices'] != null) {
-            queryParameters['includePrices'] = requestParameters['includePrices'];
-        }
-
-        const headerParameters: runtime.HTTPHeaders = {};
-
-
-        let urlPath = `/api/{exchange}/fetchMatches`;
-        urlPath = urlPath.replace(`{${"exchange"}}`, encodeURIComponent(String(requestParameters['exchange'])));
-
-        const response = await this.request({
-            path: urlPath,
-            method: 'GET',
-            headers: headerParameters,
-            query: queryParameters,
-        }, initOverrides);
-
-        return new runtime.JSONApiResponse(response, (jsonValue) => FetchMarketMatches200ResponseFromJSON(jsonValue));
-    }
-
-    /**
-     * Find Similar Markets (Deprecated)
-     * @deprecated
-     */
-    async fetchMatches(requestParameters: FetchMatchesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchMarketMatches200Response> {
-        const response = await this.fetchMatchesRaw(requestParameters, initOverrides);
-        return await response.value();
-    }
-
     /**
      * Fetch My Trades
      */
@@ -2932,35 +2849,6 @@ export const FetchMarketsPaginatedExchangeEnum = {
     Router: 'router'
 } as const;
 export type FetchMarketsPaginatedExchangeEnum = typeof FetchMarketsPaginatedExchangeEnum[keyof typeof FetchMarketsPaginatedExchangeEnum];
-/**
- * @export
- */
-export const FetchMatchesExchangeEnum = {
-    Polymarket: 'polymarket',
-    Kalshi: 'kalshi',
-    KalshiDemo: 'kalshi-demo',
-    Limitless: 'limitless',
-    Probable: 'probable',
-    Baozi: 'baozi',
-    Myriad: 'myriad',
-    Opinion: 'opinion',
-    Metaculus: 'metaculus',
-    Smarkets: 'smarkets',
-    PolymarketUs: 'polymarket_us',
-    Router: 'router'
-} as const;
-export type FetchMatchesExchangeEnum = typeof FetchMatchesExchangeEnum[keyof typeof FetchMatchesExchangeEnum];
-/**
- * @export
- */
-export const FetchMatchesRelationEnum = {
-    Identity: 'identity',
-    Subset: 'subset',
-    Superset: 'superset',
-    Overlap: 'overlap',
-    Disjoint: 'disjoint'
-} as const;
-export type FetchMatchesRelationEnum = typeof FetchMatchesRelationEnum[keyof typeof FetchMatchesRelationEnum];
 /**
  * @export
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxtjs",
-  "version": "2.35.4",
+  "version": "2.35.6",
   "description": "Unified prediction market data API - The ccxt for prediction markets",
   "author": "PMXT Contributors",
   "repository": {
@@ -43,7 +43,7 @@
     "unified"
   ],
   "dependencies": {
-    "pmxt-core": "2.35.4"
+    "pmxt-core": "2.35.6"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",

package/pmxt/models.ts

@@ -692,8 +692,9 @@ export interface SubscribedAddressSnapshot {
 /** Set-theoretic relation between two markets' resolution conditions. */
 export type MatchRelation = 'identity' | 'subset' | 'superset' | 'overlap' | 'disjoint';
 
-/** A cross-venue market match with relation classification. */
-export interface MatchResult {
+/** A cross-venue market match with relation classification.
+ *  Market properties (title, slug, url, etc.) are accessible directly on the result. */
+export interface MatchResult extends Readonly<UnifiedMarket> {
     /** The matched market on another venue. */
     market: UnifiedMarket;
 
@@ -713,8 +714,9 @@ export interface MatchResult {
     bestAsk?: number;
 }
 
-/** A cross-venue event match with constituent market matches. */
-export interface EventMatchResult {
+/** A cross-venue event match with constituent market matches.
+ *  Event properties (title, slug, url, etc.) are accessible directly on the result. */
+export interface EventMatchResult extends Readonly<UnifiedEvent> {
     /** The matched event on another venue. */
     event: UnifiedEvent;
 

package/pmxt/router.ts

@@ -81,8 +81,10 @@ function convertEvent(raw: any): UnifiedEvent {
 
 function parseMatchResult(raw: any): MatchResult {
     const marketData = raw.market || {};
+    const market = convertMarket(marketData);
     return {
-        market: convertMarket(marketData),
+        ...market,
+        market,
         relation: raw.relation || 'identity',
         confidence: raw.confidence || 0,
         reasoning: raw.reasoning,
@@ -116,7 +118,7 @@ export interface RouterOptions {
  *
  * const router = new pmxt.Router({ pmxtApiKey: "pmxt_live_..." });
  * const markets = await router.fetchMarkets({ query: "election" });
- * const matches = await router.fetchMarketMatches({ market: markets[0] });
+ * const matches = await router.fetchMarketMatches(markets[0]);
  * ```
  */
 export class Router extends Exchange {
@@ -131,16 +133,20 @@ export class Router extends Exchange {
     /**
      * Find markets on other venues that correspond to a given market.
      *
-     * @param params.market - A UnifiedMarket object (extracts marketId automatically).
-     * @param params.marketId - PMXT market ID.
-     * @param params.slug - Market slug (alternative to marketId).
-     * @param params.url - Market URL on the source venue.
-     * @param params.relation - Filter to a specific relation type.
-     * @param params.minConfidence - Minimum confidence threshold (0–1).
-     * @param params.limit - Maximum number of matches to return.
-     * @param params.includePrices - Attach live bestBid/bestAsk to each match.
+     * @param marketOrParams - A UnifiedMarket, or an options object.
      */
-    async fetchMarketMatches(params: {
+    async fetchMarketMatches(market: UnifiedMarket): Promise<MatchResult[]>;
+    async fetchMarketMatches(params?: {
+        market?: UnifiedMarket;
+        marketId?: string;
+        slug?: string;
+        url?: string;
+        relation?: MatchRelation;
+        minConfidence?: number;
+        limit?: number;
+        includePrices?: boolean;
+    }): Promise<MatchResult[]>;
+    async fetchMarketMatches(marketOrParams: UnifiedMarket | {
         market?: UnifiedMarket;
         marketId?: string;
         slug?: string;
@@ -150,6 +156,7 @@ export class Router extends Exchange {
         limit?: number;
         includePrices?: boolean;
     } = {}): Promise<MatchResult[]> {
+        const params = 'title' in marketOrParams ? { market: marketOrParams as UnifiedMarket } : marketOrParams;
         await this.initPromise;
         const query: Record<string, unknown> = {};
         const marketId = params.marketId ?? params.market?.marketId;
@@ -175,7 +182,18 @@ export class Router extends Exchange {
     /**
      * @deprecated Use {@link fetchMarketMatches} instead.
      */
-    async fetchMatches(params: {
+    async fetchMatches(market: UnifiedMarket): Promise<MatchResult[]>;
+    async fetchMatches(params?: {
+        market?: UnifiedMarket;
+        marketId?: string;
+        slug?: string;
+        url?: string;
+        relation?: MatchRelation;
+        minConfidence?: number;
+        limit?: number;
+        includePrices?: boolean;
+    }): Promise<MatchResult[]>;
+    async fetchMatches(marketOrParams: UnifiedMarket | {
         market?: UnifiedMarket;
         marketId?: string;
         slug?: string;
@@ -186,21 +204,25 @@ export class Router extends Exchange {
         includePrices?: boolean;
     } = {}): Promise<MatchResult[]> {
         console.warn('[pmxt] fetchMatches is deprecated, use fetchMarketMatches instead');
-        return this.fetchMarketMatches(params);
+        return this.fetchMarketMatches(marketOrParams as any);
     }
 
     /**
      * Match an entire event across venues.
      *
-     * @param params.event - A UnifiedEvent object (extracts id automatically).
-     * @param params.eventId - PMXT event ID.
-     * @param params.slug - Event slug.
-     * @param params.relation - Filter market matches to a specific relation type.
-     * @param params.minConfidence - Minimum confidence threshold (0–1).
-     * @param params.limit - Maximum number of event matches to return.
-     * @param params.includePrices - Attach live prices to each market match.
+     * @param eventOrParams - A UnifiedEvent, or an options object.
      */
-    async fetchEventMatches(params: {
+    async fetchEventMatches(event: UnifiedEvent): Promise<EventMatchResult[]>;
+    async fetchEventMatches(params?: {
+        event?: UnifiedEvent;
+        eventId?: string;
+        slug?: string;
+        relation?: MatchRelation;
+        minConfidence?: number;
+        limit?: number;
+        includePrices?: boolean;
+    }): Promise<EventMatchResult[]>;
+    async fetchEventMatches(eventOrParams: UnifiedEvent | {
         event?: UnifiedEvent;
         eventId?: string;
         slug?: string;
@@ -209,6 +231,7 @@ export class Router extends Exchange {
         limit?: number;
         includePrices?: boolean;
     } = {}): Promise<EventMatchResult[]> {
+        const params = 'title' in eventOrParams && 'markets' in eventOrParams ? { event: eventOrParams as UnifiedEvent } : eventOrParams;
         await this.initPromise;
         const query: Record<string, unknown> = {};
         const eventId = params.eventId ?? params.event?.id;
@@ -223,10 +246,14 @@ export class Router extends Exchange {
             const json = await this.sidecarReadRequest('fetchEventMatches', query, [query]);
             const data = this.handleResponse(json);
             if (!data) return [];
-            return (data as any[]).map((entry) => ({
-                event: convertEvent(entry.event || {}),
-                marketMatches: (entry.marketMatches || []).map(parseMatchResult),
-            }));
+            return (data as any[]).map((entry) => {
+                const event = convertEvent(entry.event || {});
+                return {
+                    ...event,
+                    event,
+                    marketMatches: (entry.marketMatches || []).map(parseMatchResult),
+                };
+            });
         } catch (error) {
             if (error instanceof Error) throw error;
             throw new Error(`Failed to fetchEventMatches: ${error}`);
@@ -240,17 +267,22 @@ export class Router extends Exchange {
     /**
      * Compare prices for the same market across venues.
      *
-     * @param params.market - A UnifiedMarket object (extracts marketId automatically).
-     * @param params.marketId - PMXT market ID.
-     * @param params.slug - Market slug.
-     * @param params.url - Market URL.
+     * @param marketOrParams - A UnifiedMarket, or an options object.
      */
-    async compareMarketPrices(params: {
+    async compareMarketPrices(market: UnifiedMarket): Promise<PriceComparison[]>;
+    async compareMarketPrices(params?: {
+        market?: UnifiedMarket;
+        marketId?: string;
+        slug?: string;
+        url?: string;
+    }): Promise<PriceComparison[]>;
+    async compareMarketPrices(marketOrParams: UnifiedMarket | {
         market?: UnifiedMarket;
         marketId?: string;
         slug?: string;
         url?: string;
     } = {}): Promise<PriceComparison[]> {
+        const params = 'title' in marketOrParams ? { market: marketOrParams as UnifiedMarket } : marketOrParams;
         await this.initPromise;
         const query: Record<string, unknown> = {};
         const marketId = params.marketId ?? params.market?.marketId;
@@ -298,17 +330,22 @@ export class Router extends Exchange {
     /**
      * Find markets that partially hedge a position.
      *
-     * @param params.market - A UnifiedMarket object (extracts marketId automatically).
-     * @param params.marketId - PMXT market ID.
-     * @param params.slug - Market slug.
-     * @param params.url - Market URL.
+     * @param marketOrParams - A UnifiedMarket, or an options object.
      */
-    async fetchHedges(params: {
+    async fetchHedges(market: UnifiedMarket): Promise<PriceComparison[]>;
+    async fetchHedges(params?: {
+        market?: UnifiedMarket;
+        marketId?: string;
+        slug?: string;
+        url?: string;
+    }): Promise<PriceComparison[]>;
+    async fetchHedges(marketOrParams: UnifiedMarket | {
         market?: UnifiedMarket;
         marketId?: string;
         slug?: string;
         url?: string;
     } = {}): Promise<PriceComparison[]> {
+        const params = 'title' in marketOrParams ? { market: marketOrParams as UnifiedMarket } : marketOrParams;
         await this.initPromise;
         const query: Record<string, unknown> = {};
         const marketId = params.marketId ?? params.market?.marketId;