pmxtjs 1.5.7 → 1.7.0

package/dist/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/pmxt/client.js

@@ -790,6 +790,248 @@ 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;
+        });
+    }
 }
 exports.Exchange = Exchange;
 /**

package/dist/pmxt/models.d.ts

@@ -268,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/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/pmxt/server-manager.js

@@ -206,6 +206,19 @@ 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/generated/docs/MarketOutcome.md

@@ -7,6 +7,7 @@
 Name | Type
 ------------ | -------------
 `id` | string
+`outcomeId` | string
 `label` | string
 `price` | number
 `priceChange24h` | number
@@ -20,6 +21,7 @@ import type { MarketOutcome } from 'pmxtjs'
 // TODO: Update the object below with actual values
 const example = {
   "id": null,
+  "outcomeId": null,
   "label": null,
   "price": null,
   "priceChange24h": null,

package/generated/docs/UnifiedMarket.md

@@ -7,6 +7,7 @@
 Name | Type
 ------------ | -------------
 `id` | string
+`marketId` | string
 `title` | string
 `description` | string
 `outcomes` | [Array<MarketOutcome>](MarketOutcome.md)
@@ -32,6 +33,7 @@ import type { UnifiedMarket } from 'pmxtjs'
 // TODO: Update the object below with actual values
 const example = {
   "id": null,
+  "marketId": null,
   "title": null,
   "description": null,
   "outcomes": null,

package/generated/package.json

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

package/generated/src/models/MarketOutcome.ts

@@ -20,11 +20,18 @@ import { mapValues } from '../runtime';
  */
 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}
@@ -69,6 +76,7 @@ export function MarketOutcomeFromJSONTyped(json: any, ignoreDiscriminator: boole
     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'],
@@ -88,6 +96,7 @@ export function MarketOutcomeToJSONTyped(value?: MarketOutcome | null, ignoreDis
     return {
         
         'id': value['id'],
+        'outcomeId': value['outcomeId'],
         'label': value['label'],
         'price': value['price'],
         'priceChange24h': value['priceChange24h'],

package/generated/src/models/UnifiedMarket.ts

@@ -28,11 +28,18 @@ import {
  */
 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}
@@ -149,6 +156,7 @@ export function UnifiedMarketFromJSONTyped(json: any, ignoreDiscriminator: boole
     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'] as Array<any>).map(MarketOutcomeFromJSON)),
@@ -180,6 +188,7 @@ export function UnifiedMarketToJSONTyped(value?: UnifiedMarket | null, ignoreDis
     return {
         
         'id': value['id'],
+        'marketId': value['marketId'],
         'title': value['title'],
         'description': value['description'],
         'outcomes': value['outcomes'] == null ? undefined : ((value['outcomes'] as Array<any>).map(MarketOutcomeToJSON)),

package/index.ts

@@ -28,12 +28,24 @@ export { ServerManager } from "./pmxt/server-manager.js";
 export type * from "./pmxt/models.js";
 
 
+const defaultManager = new ServerManager();
+
+async function stopServer(): Promise<void> {
+    await defaultManager.stop();
+}
+
+async function restartServer(): Promise<void> {
+    await defaultManager.restart();
+}
+
 const pmxt = {
     Exchange,
     Polymarket,
     Kalshi,
     Limitless,
     ServerManager,
+    stopServer,
+    restartServer,
     ...models
 };
 

package/package.json

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