pmxtjs 2.35.5 → 2.35.6

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/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/package.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxtjs",
-  "version": "2.35.5",
+  "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.5"
+    "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;