pmxtjs 2.43.16 → 2.43.18

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

@@ -62,6 +62,7 @@ export interface FetchEventRequest {
     exchange: FetchEventExchangeEnum;
     query?: string;
     limit?: number;
+    cursor?: string;
     offset?: number;
     sort?: FetchEventSortEnum;
     status?: FetchEventStatusEnum;
@@ -88,6 +89,7 @@ export interface FetchEventsRequest {
     exchange: FetchEventsExchangeEnum;
     query?: string;
     limit?: number;
+    cursor?: string;
     offset?: number;
     sort?: FetchEventsSortEnum;
     status?: FetchEventsStatusEnum;

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

@@ -335,6 +335,9 @@ export class DefaultApi extends runtime.BaseAPI {
         if (requestParameters['limit'] != null) {
             queryParameters['limit'] = requestParameters['limit'];
         }
+        if (requestParameters['cursor'] != null) {
+            queryParameters['cursor'] = requestParameters['cursor'];
+        }
         if (requestParameters['offset'] != null) {
             queryParameters['offset'] = requestParameters['offset'];
         }
@@ -451,6 +454,9 @@ export class DefaultApi extends runtime.BaseAPI {
         if (requestParameters['limit'] != null) {
             queryParameters['limit'] = requestParameters['limit'];
         }
+        if (requestParameters['cursor'] != null) {
+            queryParameters['cursor'] = requestParameters['cursor'];
+        }
         if (requestParameters['offset'] != null) {
             queryParameters['offset'] = requestParameters['offset'];
         }

package/dist/esm/generated/src/models/EventFetchParams.d.ts

@@ -28,6 +28,12 @@ export interface EventFetchParams {
      * @memberof EventFetchParams
      */
     limit?: number;
+    /**
+     * Opaque venue pagination cursor, where supported.
+     * @type {string}
+     * @memberof EventFetchParams
+     */
+    cursor?: string;
     /**
      * Pagination offset — number of results to skip
      * @type {number}

package/dist/esm/generated/src/models/EventFetchParams.js

@@ -53,6 +53,7 @@ export function EventFetchParamsFromJSONTyped(json, ignoreDiscriminator) {
     return {
         'query': json['query'] == null ? undefined : json['query'],
         'limit': json['limit'] == null ? undefined : json['limit'],
+        'cursor': json['cursor'] == null ? undefined : json['cursor'],
         'offset': json['offset'] == null ? undefined : json['offset'],
         'sort': json['sort'] == null ? undefined : json['sort'],
         'status': json['status'] == null ? undefined : json['status'],
@@ -74,6 +75,7 @@ export function EventFetchParamsToJSONTyped(value, ignoreDiscriminator = false)
     return {
         'query': value['query'],
         'limit': value['limit'],
+        'cursor': value['cursor'],
         'offset': value['offset'],
         'sort': value['sort'],
         'status': value['status'],

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/generated/src/apis/DefaultApi.d.ts

@@ -62,6 +62,7 @@ export interface FetchEventRequest {
     exchange: FetchEventExchangeEnum;
     query?: string;
     limit?: number;
+    cursor?: string;
     offset?: number;
     sort?: FetchEventSortEnum;
     status?: FetchEventStatusEnum;
@@ -88,6 +89,7 @@ export interface FetchEventsRequest {
     exchange: FetchEventsExchangeEnum;
     query?: string;
     limit?: number;
+    cursor?: string;
     offset?: number;
     sort?: FetchEventsSortEnum;
     status?: FetchEventsStatusEnum;

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

@@ -372,6 +372,9 @@ class DefaultApi extends runtime.BaseAPI {
         if (requestParameters['limit'] != null) {
             queryParameters['limit'] = requestParameters['limit'];
         }
+        if (requestParameters['cursor'] != null) {
+            queryParameters['cursor'] = requestParameters['cursor'];
+        }
         if (requestParameters['offset'] != null) {
             queryParameters['offset'] = requestParameters['offset'];
         }
@@ -488,6 +491,9 @@ class DefaultApi extends runtime.BaseAPI {
         if (requestParameters['limit'] != null) {
             queryParameters['limit'] = requestParameters['limit'];
         }
+        if (requestParameters['cursor'] != null) {
+            queryParameters['cursor'] = requestParameters['cursor'];
+        }
         if (requestParameters['offset'] != null) {
             queryParameters['offset'] = requestParameters['offset'];
         }

package/dist/generated/src/models/EventFetchParams.d.ts

@@ -28,6 +28,12 @@ export interface EventFetchParams {
      * @memberof EventFetchParams
      */
     limit?: number;
+    /**
+     * Opaque venue pagination cursor, where supported.
+     * @type {string}
+     * @memberof EventFetchParams
+     */
+    cursor?: string;
     /**
      * Pagination offset — number of results to skip
      * @type {number}

package/dist/generated/src/models/EventFetchParams.js

@@ -61,6 +61,7 @@ function EventFetchParamsFromJSONTyped(json, ignoreDiscriminator) {
     return {
         'query': json['query'] == null ? undefined : json['query'],
         'limit': json['limit'] == null ? undefined : json['limit'],
+        'cursor': json['cursor'] == null ? undefined : json['cursor'],
         'offset': json['offset'] == null ? undefined : json['offset'],
         'sort': json['sort'] == null ? undefined : json['sort'],
         'status': json['status'] == null ? undefined : json['status'],
@@ -82,6 +83,7 @@ function EventFetchParamsToJSONTyped(value, ignoreDiscriminator = false) {
     return {
         'query': value['query'],
         'limit': value['limit'],
+        'cursor': value['cursor'],
         'offset': value['offset'],
         'sort': value['sort'],
         'status': value['status'],

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/docs/DefaultApi.md

@@ -702,7 +702,7 @@ No authorization required
 
 ## fetchEvent
 
-> FetchEvent200Response fetchEvent(exchange, query, limit, offset, sort, status, searchIn, eventId, slug, filter, category, tags)
+> FetchEvent200Response fetchEvent(exchange, query, limit, cursor, offset, sort, status, searchIn, eventId, slug, filter, category, tags)
 
 Fetch Event
 
@@ -728,6 +728,8 @@ async function example() {
     query: query_example,
     // number | Maximum number of results to return (optional)
     limit: 8.14,
+    // string | Opaque venue pagination cursor, where supported. (optional)
+    cursor: cursor_example,
     // number | Pagination offset — number of results to skip (optional)
     offset: 8.14,
     // 'volume' | 'liquidity' | 'newest' | Sort order for results (optional)
@@ -768,6 +770,7 @@ example().catch(console.error);
 | **exchange** | `polymarket`, `kalshi`, `kalshi-demo`, `limitless`, `probable`, `baozi`, `myriad`, `opinion`, `metaculus`, `smarkets`, `polymarket_us`, `gemini-titan`, `hyperliquid`, `mock`, `router` | The prediction market exchange to target. | [Defaults to `undefined`] [Enum: polymarket, kalshi, kalshi-demo, limitless, probable, baozi, myriad, opinion, metaculus, smarkets, polymarket_us, gemini-titan, hyperliquid, mock, router] |
 | **query** | `string` | For keyword search | [Optional] [Defaults to `undefined`] |
 | **limit** | `number` | Maximum number of results to return | [Optional] [Defaults to `undefined`] |
+| **cursor** | `string` | Opaque venue pagination cursor, where supported. | [Optional] [Defaults to `undefined`] |
 | **offset** | `number` | Pagination offset — number of results to skip | [Optional] [Defaults to `undefined`] |
 | **sort** | `volume`, `liquidity`, `newest` | Sort order for results | [Optional] [Defaults to `undefined`] [Enum: volume, liquidity, newest] |
 | **status** | `active`, `inactive`, `closed`, `all` | Filter by event status (default: \'active\', \'inactive\' and \'closed\' are interchangeable) | [Optional] [Defaults to `undefined`] [Enum: active, inactive, closed, all] |
@@ -896,7 +899,7 @@ No authorization required
 
 ## fetchEvents
 
-> FetchEvents200Response fetchEvents(exchange, query, limit, offset, sort, status, searchIn, eventId, slug, filter, category, tags)
+> FetchEvents200Response fetchEvents(exchange, query, limit, cursor, offset, sort, status, searchIn, eventId, slug, filter, category, tags)
 
 Fetch Events
 
@@ -922,6 +925,8 @@ async function example() {
     query: query_example,
     // number | Maximum number of results to return (optional)
     limit: 8.14,
+    // string | Opaque venue pagination cursor, where supported. (optional)
+    cursor: cursor_example,
     // number | Pagination offset — number of results to skip (optional)
     offset: 8.14,
     // 'volume' | 'liquidity' | 'newest' | Sort order for results (optional)
@@ -962,6 +967,7 @@ example().catch(console.error);
 | **exchange** | `polymarket`, `kalshi`, `kalshi-demo`, `limitless`, `probable`, `baozi`, `myriad`, `opinion`, `metaculus`, `smarkets`, `polymarket_us`, `gemini-titan`, `hyperliquid`, `mock`, `router` | The prediction market exchange to target. | [Defaults to `undefined`] [Enum: polymarket, kalshi, kalshi-demo, limitless, probable, baozi, myriad, opinion, metaculus, smarkets, polymarket_us, gemini-titan, hyperliquid, mock, router] |
 | **query** | `string` | For keyword search | [Optional] [Defaults to `undefined`] |
 | **limit** | `number` | Maximum number of results to return | [Optional] [Defaults to `undefined`] |
+| **cursor** | `string` | Opaque venue pagination cursor, where supported. | [Optional] [Defaults to `undefined`] |
 | **offset** | `number` | Pagination offset — number of results to skip | [Optional] [Defaults to `undefined`] |
 | **sort** | `volume`, `liquidity`, `newest` | Sort order for results | [Optional] [Defaults to `undefined`] [Enum: volume, liquidity, newest] |
 | **status** | `active`, `inactive`, `closed`, `all` | Filter by event status (default: \'active\', \'inactive\' and \'closed\' are interchangeable) | [Optional] [Defaults to `undefined`] [Enum: active, inactive, closed, all] |

package/generated/docs/EventFetchParams.md

@@ -8,6 +8,7 @@ Name | Type
 ------------ | -------------
 `query` | string
 `limit` | number
+`cursor` | string
 `offset` | number
 `sort` | string
 `status` | string
@@ -27,6 +28,7 @@ import type { EventFetchParams } from 'pmxtjs'
 const example = {
   "query": null,
   "limit": null,
+  "cursor": null,
   "offset": null,
   "sort": null,
   "status": null,

package/generated/package.json

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

package/generated/src/apis/DefaultApi.ts

@@ -205,6 +205,7 @@ export interface FetchEventRequest {
     exchange: FetchEventExchangeEnum;
     query?: string;
     limit?: number;
+    cursor?: string;
     offset?: number;
     sort?: FetchEventSortEnum;
     status?: FetchEventStatusEnum;
@@ -233,6 +234,7 @@ export interface FetchEventsRequest {
     exchange: FetchEventsExchangeEnum;
     query?: string;
     limit?: number;
+    cursor?: string;
     offset?: number;
     sort?: FetchEventsSortEnum;
     status?: FetchEventsStatusEnum;
@@ -890,6 +892,10 @@ export class DefaultApi extends runtime.BaseAPI {
             queryParameters['limit'] = requestParameters['limit'];
         }
 
+        if (requestParameters['cursor'] != null) {
+            queryParameters['cursor'] = requestParameters['cursor'];
+        }
+
         if (requestParameters['offset'] != null) {
             queryParameters['offset'] = requestParameters['offset'];
         }
@@ -1048,6 +1054,10 @@ export class DefaultApi extends runtime.BaseAPI {
             queryParameters['limit'] = requestParameters['limit'];
         }
 
+        if (requestParameters['cursor'] != null) {
+            queryParameters['cursor'] = requestParameters['cursor'];
+        }
+
         if (requestParameters['offset'] != null) {
             queryParameters['offset'] = requestParameters['offset'];
         }

package/generated/src/models/EventFetchParams.ts

@@ -39,6 +39,12 @@ export interface EventFetchParams {
      * @memberof EventFetchParams
      */
     limit?: number;
+    /**
+     * Opaque venue pagination cursor, where supported.
+     * @type {string}
+     * @memberof EventFetchParams
+     */
+    cursor?: string;
     /**
      * Pagination offset — number of results to skip
      * @type {number}
@@ -147,6 +153,7 @@ export function EventFetchParamsFromJSONTyped(json: any, ignoreDiscriminator: bo
         
         'query': json['query'] == null ? undefined : json['query'],
         'limit': json['limit'] == null ? undefined : json['limit'],
+        'cursor': json['cursor'] == null ? undefined : json['cursor'],
         'offset': json['offset'] == null ? undefined : json['offset'],
         'sort': json['sort'] == null ? undefined : json['sort'],
         'status': json['status'] == null ? undefined : json['status'],
@@ -172,6 +179,7 @@ export function EventFetchParamsToJSONTyped(value?: EventFetchParams | null, ign
         
         'query': value['query'],
         'limit': value['limit'],
+        'cursor': value['cursor'],
         'offset': value['offset'],
         'sort': value['sort'],
         'status': value['status'],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxtjs",
-  "version": "2.43.16",
+  "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.16",
+    "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;
 }
 
 /**