pmxtjs 1.5.6 → 1.6.0

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

@@ -51,6 +51,12 @@ export interface CreateOrderParams {
      * @memberof CreateOrderParams
      */
     price?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof CreateOrderParams
+     */
+    fee?: number;
 }
 /**
  * @export

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

@@ -55,6 +55,7 @@ export function CreateOrderParamsFromJSONTyped(json, ignoreDiscriminator) {
         'type': json['type'],
         'amount': json['amount'],
         'price': json['price'] == null ? undefined : json['price'],
+        'fee': json['fee'] == null ? undefined : json['fee'],
     };
 }
 export function CreateOrderParamsToJSON(json) {
@@ -71,5 +72,6 @@ export function CreateOrderParamsToJSONTyped(value, ignoreDiscriminator = false)
         'type': value['type'],
         'amount': value['amount'],
         'price': value['price'],
+        'fee': value['fee'],
     };
 }

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

@@ -16,11 +16,18 @@
  */
 export interface MarketOutcome {
     /**
-     *
+     * DEPRECATED: Use outcomeId instead. Will be removed in v2.0
      * @type {string}
      * @memberof MarketOutcome
+     * @deprecated
      */
     id?: string;
+    /**
+     * Outcome ID for trading operations (CLOB Token ID for Polymarket, Market Ticker for Kalshi)
+     * @type {string}
+     * @memberof MarketOutcome
+     */
+    outcomeId?: string;
     /**
      *
      * @type {string}

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

@@ -26,6 +26,7 @@ export function MarketOutcomeFromJSONTyped(json, ignoreDiscriminator) {
     }
     return {
         'id': json['id'] == null ? undefined : json['id'],
+        'outcomeId': json['outcomeId'] == null ? undefined : json['outcomeId'],
         'label': json['label'] == null ? undefined : json['label'],
         'price': json['price'] == null ? undefined : json['price'],
         'priceChange24h': json['priceChange24h'] == null ? undefined : json['priceChange24h'],
@@ -41,6 +42,7 @@ export function MarketOutcomeToJSONTyped(value, ignoreDiscriminator = false) {
     }
     return {
         'id': value['id'],
+        'outcomeId': value['outcomeId'],
         'label': value['label'],
         'price': value['price'],
         'priceChange24h': value['priceChange24h'],

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

@@ -17,11 +17,18 @@ import type { MarketOutcome } from './MarketOutcome.js';
  */
 export interface UnifiedMarket {
     /**
-     *
+     * DEPRECATED: Use marketId instead. Will be removed in v2.0
      * @type {string}
      * @memberof UnifiedMarket
+     * @deprecated
      */
     id?: string;
+    /**
+     * The unique identifier for this market
+     * @type {string}
+     * @memberof UnifiedMarket
+     */
+    marketId?: string;
     /**
      *
      * @type {string}

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

@@ -27,6 +27,7 @@ export function UnifiedMarketFromJSONTyped(json, ignoreDiscriminator) {
     }
     return {
         'id': json['id'] == null ? undefined : json['id'],
+        'marketId': json['marketId'] == null ? undefined : json['marketId'],
         'title': json['title'] == null ? undefined : json['title'],
         'description': json['description'] == null ? undefined : json['description'],
         'outcomes': json['outcomes'] == null ? undefined : (json['outcomes'].map(MarketOutcomeFromJSON)),
@@ -54,6 +55,7 @@ export function UnifiedMarketToJSONTyped(value, ignoreDiscriminator = false) {
     }
     return {
         'id': value['id'],
+        'marketId': value['marketId'],
         'title': value['title'],
         'description': value['description'],
         'outcomes': value['outcomes'] == null ? undefined : (value['outcomes'].map(MarketOutcomeToJSON)),

package/dist/esm/index.d.ts

@@ -22,11 +22,15 @@ import { ServerManager } from "./pmxt/server-manager.js";
 export { Exchange, Polymarket, Kalshi, Limitless } from "./pmxt/client.js";
 export { ServerManager } from "./pmxt/server-manager.js";
 export type * from "./pmxt/models.js";
+declare function stopServer(): Promise<void>;
+declare function restartServer(): Promise<void>;
 declare const pmxt: {
     Exchange: typeof Exchange;
     Polymarket: typeof Polymarket;
     Kalshi: typeof Kalshi;
     Limitless: typeof Limitless;
     ServerManager: typeof ServerManager;
+    stopServer: typeof stopServer;
+    restartServer: typeof restartServer;
 };
 export default pmxt;

package/dist/esm/index.js

@@ -22,12 +22,21 @@ import { ServerManager } from "./pmxt/server-manager.js";
 import * as models from "./pmxt/models.js";
 export { Exchange, Polymarket, Kalshi, Limitless } from "./pmxt/client.js";
 export { ServerManager } from "./pmxt/server-manager.js";
+const defaultManager = new ServerManager();
+async function stopServer() {
+    await defaultManager.stop();
+}
+async function restartServer() {
+    await defaultManager.restart();
+}
 const pmxt = {
     Exchange,
     Polymarket,
     Kalshi,
     Limitless,
     ServerManager,
+    stopServer,
+    restartServer,
     ...models
 };
 export default pmxt;

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

@@ -5,7 +5,7 @@
  * OpenAPI client, matching the Python API exactly.
  */
 import { DefaultApi, Configuration, ExchangeCredentials } from "../generated/src/index.js";
-import { UnifiedMarket, PriceCandle, OrderBook, Trade, Order, Position, Balance, MarketFilterParams, HistoryFilterParams, CreateOrderParams, UnifiedEvent, ExecutionPriceResult } from "./models.js";
+import { UnifiedMarket, PriceCandle, OrderBook, Trade, Order, Position, Balance, MarketFilterParams, HistoryFilterParams, CreateOrderParams, UnifiedEvent, ExecutionPriceResult, MarketFilterCriteria, MarketFilterFunction, EventFilterCriteria, EventFilterFunction } from "./models.js";
 import { ServerManager } from "./server-manager.js";
 /**
  * Base exchange client options.
@@ -254,6 +254,51 @@ export declare abstract class Exchange {
      * @returns Detailed execution result
      */
     getExecutionPriceDetailed(orderBook: OrderBook, side: 'buy' | 'sell', amount: number): Promise<ExecutionPriceResult>;
+    /**
+     * Filter markets based on criteria or custom function.
+     *
+     * @param markets - Array of markets to filter
+     * @param criteria - Filter criteria object, string (simple text search), or predicate function
+     * @returns Filtered array of markets
+     *
+     * @example Simple text search
+     * api.filterMarkets(markets, 'Trump')
+     *
+     * @example Advanced filtering
+     * api.filterMarkets(markets, {
+     *   text: 'Trump',
+     *   searchIn: ['title', 'tags'],
+     *   volume24h: { min: 10000 },
+     *   category: 'Politics',
+     *   price: { outcome: 'yes', max: 0.5 }
+     * })
+     *
+     * @example Custom predicate
+     * api.filterMarkets(markets, m => m.liquidity > 5000 && m.yes?.price < 0.3)
+     */
+    filterMarkets(markets: UnifiedMarket[], criteria: string | MarketFilterCriteria | MarketFilterFunction): UnifiedMarket[];
+    /**
+     * Filter events based on criteria or custom function.
+     *
+     * @param events - Array of events to filter
+     * @param criteria - Filter criteria object, string (simple text search), or predicate function
+     * @returns Filtered array of events
+     *
+     * @example Simple text search
+     * api.filterEvents(events, 'Trump')
+     *
+     * @example Advanced filtering
+     * api.filterEvents(events, {
+     *   text: 'Election',
+     *   searchIn: ['title', 'tags'],
+     *   category: 'Politics',
+     *   marketCount: { min: 5 }
+     * })
+     *
+     * @example Custom predicate
+     * api.filterEvents(events, e => e.markets.length > 10)
+     */
+    filterEvents(events: UnifiedEvent[], criteria: string | EventFilterCriteria | EventFilterFunction): UnifiedEvent[];
 }
 /**
  * Polymarket exchange client.

package/dist/esm/pmxt/client.js

@@ -594,6 +594,9 @@ export class Exchange {
             if (params.price !== undefined) {
                 paramsDict.price = params.price;
             }
+            if (params.fee !== undefined) {
+                paramsDict.fee = params.fee;
+            }
             const requestBody = {
                 args: [paramsDict],
                 credentials: this.getCredentials()
@@ -784,6 +787,248 @@ export class Exchange {
             throw new Error(`Failed to get execution price: ${error}`);
         }
     }
+    // ----------------------------------------------------------------------------
+    // Filtering Methods
+    // ----------------------------------------------------------------------------
+    /**
+     * Filter markets based on criteria or custom function.
+     *
+     * @param markets - Array of markets to filter
+     * @param criteria - Filter criteria object, string (simple text search), or predicate function
+     * @returns Filtered array of markets
+     *
+     * @example Simple text search
+     * api.filterMarkets(markets, 'Trump')
+     *
+     * @example Advanced filtering
+     * api.filterMarkets(markets, {
+     *   text: 'Trump',
+     *   searchIn: ['title', 'tags'],
+     *   volume24h: { min: 10000 },
+     *   category: 'Politics',
+     *   price: { outcome: 'yes', max: 0.5 }
+     * })
+     *
+     * @example Custom predicate
+     * api.filterMarkets(markets, m => m.liquidity > 5000 && m.yes?.price < 0.3)
+     */
+    filterMarkets(markets, criteria) {
+        // Handle predicate function
+        if (typeof criteria === 'function') {
+            return markets.filter(criteria);
+        }
+        // Handle simple string search
+        if (typeof criteria === 'string') {
+            const lowerQuery = criteria.toLowerCase();
+            return markets.filter(m => m.title.toLowerCase().includes(lowerQuery));
+        }
+        // Handle criteria object
+        return markets.filter(market => {
+            // Text search
+            if (criteria.text) {
+                const lowerQuery = criteria.text.toLowerCase();
+                const searchIn = criteria.searchIn || ['title'];
+                let textMatch = false;
+                for (const field of searchIn) {
+                    if (field === 'title' && market.title?.toLowerCase().includes(lowerQuery)) {
+                        textMatch = true;
+                        break;
+                    }
+                    if (field === 'description' && market.description?.toLowerCase().includes(lowerQuery)) {
+                        textMatch = true;
+                        break;
+                    }
+                    if (field === 'category' && market.category?.toLowerCase().includes(lowerQuery)) {
+                        textMatch = true;
+                        break;
+                    }
+                    if (field === 'tags' && market.tags?.some(tag => tag.toLowerCase().includes(lowerQuery))) {
+                        textMatch = true;
+                        break;
+                    }
+                    if (field === 'outcomes' && market.outcomes?.some(o => o.label.toLowerCase().includes(lowerQuery))) {
+                        textMatch = true;
+                        break;
+                    }
+                }
+                if (!textMatch)
+                    return false;
+            }
+            // Category filter
+            if (criteria.category && market.category !== criteria.category) {
+                return false;
+            }
+            // Tags filter (match ANY of the provided tags)
+            if (criteria.tags && criteria.tags.length > 0) {
+                const hasMatchingTag = criteria.tags.some(tag => market.tags?.some(marketTag => marketTag.toLowerCase() === tag.toLowerCase()));
+                if (!hasMatchingTag)
+                    return false;
+            }
+            // Volume24h filter
+            if (criteria.volume24h) {
+                if (criteria.volume24h.min !== undefined && market.volume24h < criteria.volume24h.min) {
+                    return false;
+                }
+                if (criteria.volume24h.max !== undefined && market.volume24h > criteria.volume24h.max) {
+                    return false;
+                }
+            }
+            // Volume filter
+            if (criteria.volume) {
+                if (criteria.volume.min !== undefined && (market.volume || 0) < criteria.volume.min) {
+                    return false;
+                }
+                if (criteria.volume.max !== undefined && (market.volume || 0) > criteria.volume.max) {
+                    return false;
+                }
+            }
+            // Liquidity filter
+            if (criteria.liquidity) {
+                if (criteria.liquidity.min !== undefined && market.liquidity < criteria.liquidity.min) {
+                    return false;
+                }
+                if (criteria.liquidity.max !== undefined && market.liquidity > criteria.liquidity.max) {
+                    return false;
+                }
+            }
+            // OpenInterest filter
+            if (criteria.openInterest) {
+                if (criteria.openInterest.min !== undefined && (market.openInterest || 0) < criteria.openInterest.min) {
+                    return false;
+                }
+                if (criteria.openInterest.max !== undefined && (market.openInterest || 0) > criteria.openInterest.max) {
+                    return false;
+                }
+            }
+            // ResolutionDate filter
+            if (criteria.resolutionDate && market.resolutionDate) {
+                const resDate = market.resolutionDate;
+                if (criteria.resolutionDate.before && resDate >= criteria.resolutionDate.before) {
+                    return false;
+                }
+                if (criteria.resolutionDate.after && resDate <= criteria.resolutionDate.after) {
+                    return false;
+                }
+            }
+            // Price filter (for binary markets)
+            if (criteria.price) {
+                const outcome = market[criteria.price.outcome];
+                if (!outcome)
+                    return false;
+                if (criteria.price.min !== undefined && outcome.price < criteria.price.min) {
+                    return false;
+                }
+                if (criteria.price.max !== undefined && outcome.price > criteria.price.max) {
+                    return false;
+                }
+            }
+            // Price change filter
+            if (criteria.priceChange24h) {
+                const outcome = market[criteria.priceChange24h.outcome];
+                if (!outcome || outcome.priceChange24h === undefined)
+                    return false;
+                if (criteria.priceChange24h.min !== undefined && outcome.priceChange24h < criteria.priceChange24h.min) {
+                    return false;
+                }
+                if (criteria.priceChange24h.max !== undefined && outcome.priceChange24h > criteria.priceChange24h.max) {
+                    return false;
+                }
+            }
+            return true;
+        });
+    }
+    /**
+     * Filter events based on criteria or custom function.
+     *
+     * @param events - Array of events to filter
+     * @param criteria - Filter criteria object, string (simple text search), or predicate function
+     * @returns Filtered array of events
+     *
+     * @example Simple text search
+     * api.filterEvents(events, 'Trump')
+     *
+     * @example Advanced filtering
+     * api.filterEvents(events, {
+     *   text: 'Election',
+     *   searchIn: ['title', 'tags'],
+     *   category: 'Politics',
+     *   marketCount: { min: 5 }
+     * })
+     *
+     * @example Custom predicate
+     * api.filterEvents(events, e => e.markets.length > 10)
+     */
+    filterEvents(events, criteria) {
+        // Handle predicate function
+        if (typeof criteria === 'function') {
+            return events.filter(criteria);
+        }
+        // Handle simple string search
+        if (typeof criteria === 'string') {
+            const lowerQuery = criteria.toLowerCase();
+            return events.filter(e => e.title.toLowerCase().includes(lowerQuery));
+        }
+        // Handle criteria object
+        return events.filter(event => {
+            // Text search
+            if (criteria.text) {
+                const lowerQuery = criteria.text.toLowerCase();
+                const searchIn = criteria.searchIn || ['title'];
+                let textMatch = false;
+                for (const field of searchIn) {
+                    if (field === 'title' && event.title?.toLowerCase().includes(lowerQuery)) {
+                        textMatch = true;
+                        break;
+                    }
+                    if (field === 'description' && event.description?.toLowerCase().includes(lowerQuery)) {
+                        textMatch = true;
+                        break;
+                    }
+                    if (field === 'category' && event.category?.toLowerCase().includes(lowerQuery)) {
+                        textMatch = true;
+                        break;
+                    }
+                    if (field === 'tags' && event.tags?.some(tag => tag.toLowerCase().includes(lowerQuery))) {
+                        textMatch = true;
+                        break;
+                    }
+                }
+                if (!textMatch)
+                    return false;
+            }
+            // Category filter
+            if (criteria.category && event.category !== criteria.category) {
+                return false;
+            }
+            // Tags filter (match ANY of the provided tags)
+            if (criteria.tags && criteria.tags.length > 0) {
+                const hasMatchingTag = criteria.tags.some(tag => event.tags?.some(eventTag => eventTag.toLowerCase() === tag.toLowerCase()));
+                if (!hasMatchingTag)
+                    return false;
+            }
+            // Market count filter
+            if (criteria.marketCount) {
+                const count = event.markets.length;
+                if (criteria.marketCount.min !== undefined && count < criteria.marketCount.min) {
+                    return false;
+                }
+                if (criteria.marketCount.max !== undefined && count > criteria.marketCount.max) {
+                    return false;
+                }
+            }
+            // Total volume filter
+            if (criteria.totalVolume) {
+                const totalVolume = event.markets.reduce((sum, m) => sum + m.volume24h, 0);
+                if (criteria.totalVolume.min !== undefined && totalVolume < criteria.totalVolume.min) {
+                    return false;
+                }
+                if (criteria.totalVolume.max !== undefined && totalVolume > criteria.totalVolume.max) {
+                    return false;
+                }
+            }
+            return true;
+        });
+    }
 }
 /**
  * Polymarket exchange client.

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

@@ -234,6 +234,8 @@ export interface CreateOrderParams {
     amount: number;
     /** Limit price (required for limit orders, 0.0-1.0) */
     price?: number;
+    /** Optional fee rate (e.g., 1000 for 0.1%) */
+    fee?: number;
 }
 /**
  * A grouped collection of related markets (e.g., "Who will be Fed Chair?" contains multiple candidate markets)
@@ -266,3 +268,85 @@ export interface UnifiedEvent {
      */
     searchMarkets(query: string, searchIn?: SearchIn): UnifiedMarket[];
 }
+/**
+ * Advanced criteria for filtering markets.
+ * Supports text search, numeric ranges, dates, categories, and price filters.
+ */
+export interface MarketFilterCriteria {
+    /** Text search query */
+    text?: string;
+    /** Fields to search in (default: ['title']) */
+    searchIn?: ('title' | 'description' | 'category' | 'tags' | 'outcomes')[];
+    /** Filter by 24-hour volume */
+    volume24h?: {
+        min?: number;
+        max?: number;
+    };
+    /** Filter by total volume */
+    volume?: {
+        min?: number;
+        max?: number;
+    };
+    /** Filter by liquidity */
+    liquidity?: {
+        min?: number;
+        max?: number;
+    };
+    /** Filter by open interest */
+    openInterest?: {
+        min?: number;
+        max?: number;
+    };
+    /** Filter by resolution date */
+    resolutionDate?: {
+        before?: Date;
+        after?: Date;
+    };
+    /** Filter by category */
+    category?: string;
+    /** Filter by tags (matches if market has ANY of these) */
+    tags?: string[];
+    /** Filter by outcome price (for binary markets) */
+    price?: {
+        outcome: 'yes' | 'no' | 'up' | 'down';
+        min?: number;
+        max?: number;
+    };
+    /** Filter by 24-hour price change */
+    priceChange24h?: {
+        outcome: 'yes' | 'no' | 'up' | 'down';
+        min?: number;
+        max?: number;
+    };
+}
+/**
+ * Function type for custom market filtering logic.
+ */
+export type MarketFilterFunction = (market: UnifiedMarket) => boolean;
+/**
+ * Advanced criteria for filtering events.
+ */
+export interface EventFilterCriteria {
+    /** Text search query */
+    text?: string;
+    /** Fields to search in (default: ['title']) */
+    searchIn?: ('title' | 'description' | 'category' | 'tags')[];
+    /** Filter by category */
+    category?: string;
+    /** Filter by tags (matches if event has ANY of these) */
+    tags?: string[];
+    /** Filter by number of markets in the event */
+    marketCount?: {
+        min?: number;
+        max?: number;
+    };
+    /** Filter by total volume across all markets */
+    totalVolume?: {
+        min?: number;
+        max?: number;
+    };
+}
+/**
+ * Function type for custom event filtering logic.
+ */
+export type EventFilterFunction = (event: UnifiedEvent) => boolean;

package/dist/esm/pmxt/server-manager.d.ts

@@ -44,5 +44,13 @@ export declare class ServerManager {
      */
     ensureServerRunning(): Promise<void>;
     private isVersionMismatch;
+    /**
+     * Stop the currently running server.
+     */
+    stop(): Promise<void>;
+    /**
+     * Restart the server.
+     */
+    restart(): Promise<void>;
     private killOldServer;
 }

package/dist/esm/pmxt/server-manager.js

@@ -170,6 +170,19 @@ export class ServerManager {
         }
         return false;
     }
+    /**
+     * Stop the currently running server.
+     */
+    async stop() {
+        await this.killOldServer();
+    }
+    /**
+     * Restart the server.
+     */
+    async restart() {
+        await this.stop();
+        await this.ensureServerRunning();
+    }
     async killOldServer() {
         const info = this.getServerInfo();
         if (info && info.pid) {

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

@@ -51,6 +51,12 @@ export interface CreateOrderParams {
      * @memberof CreateOrderParams
      */
     price?: number;
+    /**
+     *
+     * @type {number}
+     * @memberof CreateOrderParams
+     */
+    fee?: number;
 }
 /**
  * @export

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

@@ -63,6 +63,7 @@ function CreateOrderParamsFromJSONTyped(json, ignoreDiscriminator) {
         'type': json['type'],
         'amount': json['amount'],
         'price': json['price'] == null ? undefined : json['price'],
+        'fee': json['fee'] == null ? undefined : json['fee'],
     };
 }
 function CreateOrderParamsToJSON(json) {
@@ -79,5 +80,6 @@ function CreateOrderParamsToJSONTyped(value, ignoreDiscriminator = false) {
         'type': value['type'],
         'amount': value['amount'],
         'price': value['price'],
+        'fee': value['fee'],
     };
 }

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

@@ -16,11 +16,18 @@
  */
 export interface MarketOutcome {
     /**
-     *
+     * DEPRECATED: Use outcomeId instead. Will be removed in v2.0
      * @type {string}
      * @memberof MarketOutcome
+     * @deprecated
      */
     id?: string;
+    /**
+     * Outcome ID for trading operations (CLOB Token ID for Polymarket, Market Ticker for Kalshi)
+     * @type {string}
+     * @memberof MarketOutcome
+     */
+    outcomeId?: string;
     /**
      *
      * @type {string}

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

@@ -33,6 +33,7 @@ function MarketOutcomeFromJSONTyped(json, ignoreDiscriminator) {
     }
     return {
         'id': json['id'] == null ? undefined : json['id'],
+        'outcomeId': json['outcomeId'] == null ? undefined : json['outcomeId'],
         'label': json['label'] == null ? undefined : json['label'],
         'price': json['price'] == null ? undefined : json['price'],
         'priceChange24h': json['priceChange24h'] == null ? undefined : json['priceChange24h'],
@@ -48,6 +49,7 @@ function MarketOutcomeToJSONTyped(value, ignoreDiscriminator = false) {
     }
     return {
         'id': value['id'],
+        'outcomeId': value['outcomeId'],
         'label': value['label'],
         'price': value['price'],
         'priceChange24h': value['priceChange24h'],

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

@@ -17,11 +17,18 @@ import type { MarketOutcome } from './MarketOutcome';
  */
 export interface UnifiedMarket {
     /**
-     *
+     * DEPRECATED: Use marketId instead. Will be removed in v2.0
      * @type {string}
      * @memberof UnifiedMarket
+     * @deprecated
      */
     id?: string;
+    /**
+     * The unique identifier for this market
+     * @type {string}
+     * @memberof UnifiedMarket
+     */
+    marketId?: string;
     /**
      *
      * @type {string}