pmxtjs 2.43.17 → 2.43.18

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

@@ -152,7 +152,7 @@ export declare abstract class Exchange {
     protected sidecarReadRequest(methodName: string, query: Record<string, unknown>, args: unknown[]): Promise<any>;
     loadMarkets(reload?: boolean): Promise<Record<string, UnifiedMarket>>;
     fetchMarkets(params?: MarketFetchParams): Promise<UnifiedMarket[]>;
-    fetchMarketsPaginated(params?: any): Promise<PaginatedMarketsResult>;
+    fetchMarketsPaginated(params?: MarketFetchParams): Promise<PaginatedMarketsResult>;
     fetchEvents(params?: EventFetchParams): Promise<UnifiedEvent[]>;
     fetchMarket(params?: MarketFetchParams): Promise<UnifiedMarket>;
     fetchEvent(params?: EventFetchParams): Promise<UnifiedEvent>;
@@ -388,7 +388,7 @@ export declare abstract class Exchange {
      * @param amount - The amount to execute
      * @returns The volume-weighted average price, or 0 if insufficient liquidity
      */
-    getExecutionPrice(orderBook: OrderBook, side: 'buy' | 'sell', amount: number): Promise<number>;
+    getExecutionPrice(orderBook: OrderBook, side: 'buy' | 'sell', amount: number): number;
     /**
      * Calculate detailed execution price information.
      * Uses the sidecar server for calculation to ensure consistency.
@@ -463,8 +463,12 @@ export declare abstract class Exchange {
  * Options for initializing Polymarket client.
  */
 export interface PolymarketOptions {
+    /** Venue-specific API key (e.g. Polymarket CLOB key). Optional. */
+    apiKey?: string;
     /** Private key for authentication (optional) */
     privateKey?: string;
+    /** Hosted pmxt API key. Enables hosted mode when set. */
+    pmxtApiKey?: string;
     /** Base URL of the PMXT sidecar server */
     baseUrl?: string;
     /** Automatically start server if not running (default: true) */

package/dist/esm/pmxt/client.js

@@ -66,7 +66,7 @@ function queryHasNestedObject(query) {
 }
 // Converter functions
 function convertMarket(raw) {
-    return {
+    const market = {
         ...raw,
         resolutionDate: raw.resolutionDate ? new Date(raw.resolutionDate) : undefined,
         outcomes: (raw.outcomes || []).map((o) => ({ ...o })),
@@ -75,6 +75,12 @@ function convertMarket(raw) {
         up: raw.up ? { ...raw.up } : undefined,
         down: raw.down ? { ...raw.down } : undefined,
     };
+    Object.defineProperty(market, 'question', {
+        get() { return this.title; },
+        enumerable: false,
+        configurable: true,
+    });
+    return market;
 }
 function convertCandle(raw) {
     return { ...raw };
@@ -1899,9 +1905,20 @@ export class Exchange {
      * @param amount - The amount to execute
      * @returns The volume-weighted average price, or 0 if insufficient liquidity
      */
-    async getExecutionPrice(orderBook, side, amount) {
-        const result = await this.getExecutionPriceDetailed(orderBook, side, amount);
-        return result.fullyFilled ? result.price : 0;
+    getExecutionPrice(orderBook, side, amount) {
+        const levels = side === 'buy' ? orderBook.asks : orderBook.bids;
+        let remaining = amount;
+        let totalCost = 0;
+        for (const level of levels) {
+            const fill = Math.min(remaining, level.size);
+            totalCost += fill * level.price;
+            remaining -= fill;
+            if (remaining <= 0)
+                break;
+        }
+        if (remaining > 0)
+            return 0;
+        return totalCost / amount;
     }
     /**
      * Calculate detailed execution price information.

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

@@ -23,6 +23,10 @@ export interface MarketOutcome {
     priceChange24h?: number;
     /** Exchange-specific metadata */
     metadata?: Record<string, any>;
+    /** Best bid price from the order book (when includePrices=True) */
+    bestBid?: number;
+    /** Best ask price from the order book (when includePrices=True) */
+    bestAsk?: number;
 }
 /**
  * A unified market representation across exchanges.
@@ -74,6 +78,8 @@ export interface UnifiedMarket {
     up?: MarketOutcome;
     /** Convenience access to the Down outcome for binary markets. */
     down?: MarketOutcome;
+    /** Alias for `title`. Matches the Python SDK's `market.question` property. */
+    readonly question?: string;
 }
 /**
  * OHLCV price candle.

package/dist/pmxt/client.d.ts

@@ -152,7 +152,7 @@ export declare abstract class Exchange {
     protected sidecarReadRequest(methodName: string, query: Record<string, unknown>, args: unknown[]): Promise<any>;
     loadMarkets(reload?: boolean): Promise<Record<string, UnifiedMarket>>;
     fetchMarkets(params?: MarketFetchParams): Promise<UnifiedMarket[]>;
-    fetchMarketsPaginated(params?: any): Promise<PaginatedMarketsResult>;
+    fetchMarketsPaginated(params?: MarketFetchParams): Promise<PaginatedMarketsResult>;
     fetchEvents(params?: EventFetchParams): Promise<UnifiedEvent[]>;
     fetchMarket(params?: MarketFetchParams): Promise<UnifiedMarket>;
     fetchEvent(params?: EventFetchParams): Promise<UnifiedEvent>;
@@ -388,7 +388,7 @@ export declare abstract class Exchange {
      * @param amount - The amount to execute
      * @returns The volume-weighted average price, or 0 if insufficient liquidity
      */
-    getExecutionPrice(orderBook: OrderBook, side: 'buy' | 'sell', amount: number): Promise<number>;
+    getExecutionPrice(orderBook: OrderBook, side: 'buy' | 'sell', amount: number): number;
     /**
      * Calculate detailed execution price information.
      * Uses the sidecar server for calculation to ensure consistency.
@@ -463,8 +463,12 @@ export declare abstract class Exchange {
  * Options for initializing Polymarket client.
  */
 export interface PolymarketOptions {
+    /** Venue-specific API key (e.g. Polymarket CLOB key). Optional. */
+    apiKey?: string;
     /** Private key for authentication (optional) */
     privateKey?: string;
+    /** Hosted pmxt API key. Enables hosted mode when set. */
+    pmxtApiKey?: string;
     /** Base URL of the PMXT sidecar server */
     baseUrl?: string;
     /** Automatically start server if not running (default: true) */

package/dist/pmxt/client.js

@@ -69,7 +69,7 @@ function queryHasNestedObject(query) {
 }
 // Converter functions
 function convertMarket(raw) {
-    return {
+    const market = {
         ...raw,
         resolutionDate: raw.resolutionDate ? new Date(raw.resolutionDate) : undefined,
         outcomes: (raw.outcomes || []).map((o) => ({ ...o })),
@@ -78,6 +78,12 @@ function convertMarket(raw) {
         up: raw.up ? { ...raw.up } : undefined,
         down: raw.down ? { ...raw.down } : undefined,
     };
+    Object.defineProperty(market, 'question', {
+        get() { return this.title; },
+        enumerable: false,
+        configurable: true,
+    });
+    return market;
 }
 function convertCandle(raw) {
     return { ...raw };
@@ -1902,9 +1908,20 @@ class Exchange {
      * @param amount - The amount to execute
      * @returns The volume-weighted average price, or 0 if insufficient liquidity
      */
-    async getExecutionPrice(orderBook, side, amount) {
-        const result = await this.getExecutionPriceDetailed(orderBook, side, amount);
-        return result.fullyFilled ? result.price : 0;
+    getExecutionPrice(orderBook, side, amount) {
+        const levels = side === 'buy' ? orderBook.asks : orderBook.bids;
+        let remaining = amount;
+        let totalCost = 0;
+        for (const level of levels) {
+            const fill = Math.min(remaining, level.size);
+            totalCost += fill * level.price;
+            remaining -= fill;
+            if (remaining <= 0)
+                break;
+        }
+        if (remaining > 0)
+            return 0;
+        return totalCost / amount;
     }
     /**
      * Calculate detailed execution price information.

package/dist/pmxt/models.d.ts

@@ -23,6 +23,10 @@ export interface MarketOutcome {
     priceChange24h?: number;
     /** Exchange-specific metadata */
     metadata?: Record<string, any>;
+    /** Best bid price from the order book (when includePrices=True) */
+    bestBid?: number;
+    /** Best ask price from the order book (when includePrices=True) */
+    bestAsk?: number;
 }
 /**
  * A unified market representation across exchanges.
@@ -74,6 +78,8 @@ export interface UnifiedMarket {
     up?: MarketOutcome;
     /** Convenience access to the Down outcome for binary markets. */
     down?: MarketOutcome;
+    /** Alias for `title`. Matches the Python SDK's `market.question` property. */
+    readonly question?: string;
 }
 /**
  * OHLCV price candle.

package/generated/package.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxtjs",
-  "version": "2.43.17",
+  "version": "2.43.18",
   "description": "Unified prediction market data API - The ccxt for prediction markets",
   "author": "PMXT Contributors",
   "repository": {
@@ -43,14 +43,14 @@
     "unified"
   ],
   "dependencies": {
-    "pmxt-core": "2.43.17",
+    "pmxt-core": "2.43.18",
     "ws": "^8.18.0"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",
     "@types/node": "^20.0.0",
     "jest": "^30.4.2",
-    "ts-jest": "^29.4.9",
+    "ts-jest": "^29.4.11",
     "typescript": "^5.0.0"
   }
 }

package/pmxt/client.ts

@@ -104,7 +104,7 @@ function queryHasNestedObject(query: Record<string, unknown>): boolean {
 
 // Converter functions
 function convertMarket(raw: any): UnifiedMarket {
-    return {
+    const market: UnifiedMarket = {
         ...raw,
         resolutionDate: raw.resolutionDate ? new Date(raw.resolutionDate) : undefined,
         outcomes: (raw.outcomes || []).map((o: any) => ({ ...o })),
@@ -113,6 +113,12 @@ function convertMarket(raw: any): UnifiedMarket {
         up: raw.up ? { ...raw.up } : undefined,
         down: raw.down ? { ...raw.down } : undefined,
     };
+    Object.defineProperty(market, 'question', {
+        get() { return this.title; },
+        enumerable: false,
+        configurable: true,
+    });
+    return market;
 }
 
 
@@ -659,7 +665,7 @@ export abstract class Exchange {
         }
     }
 
-    async fetchMarketsPaginated(params?: any): Promise<PaginatedMarketsResult> {
+    async fetchMarketsPaginated(params?: MarketFetchParams): Promise<PaginatedMarketsResult> {
         await this.initPromise;
         try {
             const args: any[] = [];
@@ -2043,9 +2049,18 @@ export abstract class Exchange {
      * @param amount - The amount to execute
      * @returns The volume-weighted average price, or 0 if insufficient liquidity
      */
-    async getExecutionPrice(orderBook: OrderBook, side: 'buy' | 'sell', amount: number): Promise<number> {
-        const result = await this.getExecutionPriceDetailed(orderBook, side, amount);
-        return result.fullyFilled ? result.price : 0;
+    getExecutionPrice(orderBook: OrderBook, side: 'buy' | 'sell', amount: number): number {
+        const levels = side === 'buy' ? orderBook.asks : orderBook.bids;
+        let remaining = amount;
+        let totalCost = 0;
+        for (const level of levels) {
+            const fill = Math.min(remaining, level.size);
+            totalCost += fill * level.price;
+            remaining -= fill;
+            if (remaining <= 0) break;
+        }
+        if (remaining > 0) return 0;
+        return totalCost / amount;
     }
 
     /**
@@ -2400,9 +2415,15 @@ export abstract class Exchange {
  * Options for initializing Polymarket client.
  */
 export interface PolymarketOptions {
+    /** Venue-specific API key (e.g. Polymarket CLOB key). Optional. */
+    apiKey?: string;
+
     /** Private key for authentication (optional) */
     privateKey?: string;
 
+    /** Hosted pmxt API key. Enables hosted mode when set. */
+    pmxtApiKey?: string;
+
     /** Base URL of the PMXT sidecar server */
     baseUrl?: string;
 

package/pmxt/models.ts

@@ -29,6 +29,12 @@ export interface MarketOutcome {
 
     /** Exchange-specific metadata */
     metadata?: Record<string, any>;
+
+    /** Best bid price from the order book (when includePrices=True) */
+    bestBid?: number;
+
+    /** Best ask price from the order book (when includePrices=True) */
+    bestAsk?: number;
 }
 
 /**
@@ -103,6 +109,9 @@ export interface UnifiedMarket {
 
     /** Convenience access to the Down outcome for binary markets. */
     down?: MarketOutcome;
+
+    /** Alias for `title`. Matches the Python SDK's `market.question` property. */
+    readonly question?: string;
 }
 
 /**