pmxt-core 2.9.2 → 2.11.0

package/dist/BaseExchange.d.ts

@@ -140,6 +140,11 @@ export declare abstract class PredictionMarketExchange {
     protected credentials?: ExchangeCredentials;
     verbose: boolean;
     http: AxiosInstance;
+    enableRateLimit: boolean;
+    private _rateLimit;
+    private _throttler;
+    get rateLimit(): number;
+    set rateLimit(value: number);
     markets: Record<string, UnifiedMarket>;
     marketsBySlug: Record<string, UnifiedMarket>;
     loadedMarkets: boolean;

package/dist/BaseExchange.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PredictionMarketExchange = void 0;
 const math_1 = require("./utils/math");
 const errors_1 = require("./errors");
+const throttler_1 = require("./utils/throttler");
 const axios_1 = __importDefault(require("axios"));
 // ----------------------------------------------------------------------------
 // Base Exchange Class
@@ -14,6 +15,20 @@ class PredictionMarketExchange {
     credentials;
     verbose = false;
     http;
+    enableRateLimit = true;
+    _rateLimit = 1000;
+    _throttler;
+    get rateLimit() {
+        return this._rateLimit;
+    }
+    set rateLimit(value) {
+        this._rateLimit = value;
+        this._throttler = new throttler_1.Throttler({
+            refillRate: 1 / value,
+            capacity: 1,
+            delay: 1,
+        });
+    }
     // Market Cache
     markets = {};
     marketsBySlug = {};
@@ -39,6 +54,18 @@ class PredictionMarketExchange {
     constructor(credentials) {
         this.credentials = credentials;
         this.http = axios_1.default.create();
+        this._throttler = new throttler_1.Throttler({
+            refillRate: 1 / this._rateLimit,
+            capacity: 1,
+            delay: 1,
+        });
+        // Rate Limit Interceptor
+        this.http.interceptors.request.use(async (config) => {
+            if (this.enableRateLimit) {
+                await this._throttler.throttle();
+            }
+            return config;
+        });
         // Request Interceptor
         this.http.interceptors.request.use((config) => {
             if (this.verbose) {

package/dist/exchanges/baozi/index.js

@@ -43,6 +43,7 @@ class BaoziExchange extends BaseExchange_1.PredictionMarketExchange {
             credentials = options;
         }
         super(credentials);
+        this.rateLimit = 500;
         rpcUrl = rpcUrl
             || process.env.BAOZI_RPC_URL
             || process.env.HELIUS_RPC_URL

package/dist/exchanges/kalshi/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/kalshi/Kalshi.yaml
- * Generated at: 2026-02-19T07:57:20.394Z
+ * Generated at: 2026-02-22T07:47:40.083Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const kalshiApiSpec: {

package/dist/exchanges/kalshi/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.kalshiApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/kalshi/Kalshi.yaml
- * Generated at: 2026-02-19T07:57:20.394Z
+ * Generated at: 2026-02-22T07:47:40.083Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.kalshiApiSpec = {

package/dist/exchanges/kalshi/index.js

@@ -44,6 +44,7 @@ class KalshiExchange extends BaseExchange_1.PredictionMarketExchange {
             credentials = options;
         }
         super(credentials);
+        this.rateLimit = 100;
         this.wsConfig = wsConfig;
         if (credentials?.apiKey && credentials?.privateKey) {
             this.auth = new auth_1.KalshiAuth(credentials);

package/dist/exchanges/limitless/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/limitless/Limitless.yaml
- * Generated at: 2026-02-19T07:57:20.577Z
+ * Generated at: 2026-02-22T07:47:40.130Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const limitlessApiSpec: {

package/dist/exchanges/limitless/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.limitlessApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/limitless/Limitless.yaml
- * Generated at: 2026-02-19T07:57:20.577Z
+ * Generated at: 2026-02-22T07:47:40.130Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.limitlessApiSpec = {

package/dist/exchanges/limitless/index.js

@@ -53,6 +53,7 @@ class LimitlessExchange extends BaseExchange_1.PredictionMarketExchange {
             credentials = options;
         }
         super(credentials);
+        this.rateLimit = 200;
         this.wsConfig = wsConfig;
         // Initialize auth if API key or private key are provided
         // API key is now the primary authentication method

package/dist/exchanges/myriad/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/myriad/myriad.yaml
- * Generated at: 2026-02-19T07:57:20.660Z
+ * Generated at: 2026-02-22T07:47:40.144Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const myriadApiSpec: {

package/dist/exchanges/myriad/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.myriadApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/myriad/myriad.yaml
- * Generated at: 2026-02-19T07:57:20.660Z
+ * Generated at: 2026-02-22T07:47:40.144Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.myriadApiSpec = {

package/dist/exchanges/myriad/index.js

@@ -33,6 +33,7 @@ class MyriadExchange extends BaseExchange_1.PredictionMarketExchange {
     ws;
     constructor(credentials) {
         super(credentials);
+        this.rateLimit = 500;
         if (credentials?.apiKey) {
             this.auth = new auth_1.MyriadAuth(credentials);
         }

package/dist/exchanges/polymarket/api-clob.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketClobAPI.yaml
- * Generated at: 2026-02-19T07:57:20.409Z
+ * Generated at: 2026-02-22T07:47:40.090Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const polymarketClobSpec: {

package/dist/exchanges/polymarket/api-clob.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.polymarketClobSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketClobAPI.yaml
- * Generated at: 2026-02-19T07:57:20.409Z
+ * Generated at: 2026-02-22T07:47:40.090Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketClobSpec = {

package/dist/exchanges/polymarket/api-data.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/Polymarket_Data_API.yaml
- * Generated at: 2026-02-19T07:57:20.513Z
+ * Generated at: 2026-02-22T07:47:40.108Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const polymarketDataSpec: {

package/dist/exchanges/polymarket/api-data.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.polymarketDataSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/Polymarket_Data_API.yaml
- * Generated at: 2026-02-19T07:57:20.513Z
+ * Generated at: 2026-02-22T07:47:40.108Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketDataSpec = {

package/dist/exchanges/polymarket/api-gamma.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketGammaAPI.yaml
- * Generated at: 2026-02-19T07:57:20.469Z
+ * Generated at: 2026-02-22T07:47:40.103Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const polymarketGammaSpec: {

package/dist/exchanges/polymarket/api-gamma.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.polymarketGammaSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketGammaAPI.yaml
- * Generated at: 2026-02-19T07:57:20.469Z
+ * Generated at: 2026-02-22T07:47:40.103Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketGammaSpec = {

package/dist/exchanges/polymarket/index.d.ts

@@ -46,9 +46,25 @@ export declare class PolymarketExchange extends PredictionMarketExchange {
      */
     private ensureAuth;
     /**
-     * Pre-warm the SDK's internal caches for a token by fetching tick size,
-     * fee rate, and neg-risk in parallel. Call this when you start watching
-     * a market so that subsequent createOrder calls hit only POST /order.
+     * Pre-warm the SDK's internal caches for a market outcome.
+     *
+     * Fetches tick size, fee rate, and neg-risk in parallel so that subsequent
+     * `createOrder` calls skip those lookups and hit only `POST /order`.
+     * Call this when you start watching a market.
+     *
+     * @param outcomeId - The CLOB Token ID for the outcome (use `outcome.outcomeId`)
+     *
+     * @example-ts Pre-warm before placing orders
+     * const markets = await exchange.fetchMarkets({ query: 'Trump' });
+     * const outcomeId = markets[0].outcomes[0].outcomeId;
+     * await exchange.preWarmMarket(outcomeId);
+     * // Subsequent createOrder calls are faster
+     *
+     * @example-python Pre-warm before placing orders
+     * markets = exchange.fetch_markets(query='Trump')
+     * outcome_id = markets[0].outcomes[0].outcome_id
+     * exchange.pre_warm_market(outcome_id)
+     * # Subsequent create_order calls are faster
      */
     preWarmMarket(outcomeId: string): Promise<void>;
     createOrder(params: CreateOrderParams): Promise<Order>;

package/dist/exchanges/polymarket/index.js

@@ -52,6 +52,7 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
             credentials = options;
         }
         super(credentials);
+        this.rateLimit = 200;
         this.wsConfig = wsConfig;
         // Initialize auth if credentials are provided
         if (credentials?.privateKey) {
@@ -185,9 +186,25 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
         return this.auth;
     }
     /**
-     * Pre-warm the SDK's internal caches for a token by fetching tick size,
-     * fee rate, and neg-risk in parallel. Call this when you start watching
-     * a market so that subsequent createOrder calls hit only POST /order.
+     * Pre-warm the SDK's internal caches for a market outcome.
+     *
+     * Fetches tick size, fee rate, and neg-risk in parallel so that subsequent
+     * `createOrder` calls skip those lookups and hit only `POST /order`.
+     * Call this when you start watching a market.
+     *
+     * @param outcomeId - The CLOB Token ID for the outcome (use `outcome.outcomeId`)
+     *
+     * @example-ts Pre-warm before placing orders
+     * const markets = await exchange.fetchMarkets({ query: 'Trump' });
+     * const outcomeId = markets[0].outcomes[0].outcomeId;
+     * await exchange.preWarmMarket(outcomeId);
+     * // Subsequent createOrder calls are faster
+     *
+     * @example-python Pre-warm before placing orders
+     * markets = exchange.fetch_markets(query='Trump')
+     * outcome_id = markets[0].outcomes[0].outcome_id
+     * exchange.pre_warm_market(outcome_id)
+     * # Subsequent create_order calls are faster
      */
     async preWarmMarket(outcomeId) {
         const auth = this.ensureAuth();

package/dist/exchanges/probable/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/probable/probable.yaml
- * Generated at: 2026-02-19T07:57:20.610Z
+ * Generated at: 2026-02-22T07:47:40.137Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const probableApiSpec: {

package/dist/exchanges/probable/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.probableApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/probable/probable.yaml
- * Generated at: 2026-02-19T07:57:20.610Z
+ * Generated at: 2026-02-22T07:47:40.137Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

package/dist/exchanges/probable/index.d.ts

@@ -26,7 +26,43 @@ export declare class ProbableExchange extends PredictionMarketExchange {
     private ensureAuth;
     protected fetchMarketsImpl(params?: MarketFetchParams): Promise<UnifiedMarket[]>;
     protected fetchEventsImpl(params: EventFetchParams): Promise<UnifiedEvent[]>;
+    /**
+     * Fetch a single event by its numeric ID (Probable only).
+     *
+     * @param id - The numeric event ID
+     * @returns The UnifiedEvent, or null if not found
+     *
+     * @example-ts Get event by ID
+     * const event = await exchange.getEventById('42');
+     * if (event) {
+     *   console.log(event.title);
+     *   console.log(event.markets.length, 'markets');
+     * }
+     *
+     * @example-python Get event by ID
+     * event = exchange.get_event_by_id('42')
+     * if event:
+     *     print(event.title)
+     *     print(len(event.markets), 'markets')
+     */
     getEventById(id: string): Promise<UnifiedEvent | null>;
+    /**
+     * Fetch a single event by its URL slug (Probable only).
+     *
+     * @param slug - The event's URL slug (e.g. `"trump-2024-election"`)
+     * @returns The UnifiedEvent, or null if not found
+     *
+     * @example-ts Get event by slug
+     * const event = await exchange.getEventBySlug('trump-2024-election');
+     * if (event) {
+     *   console.log(event.title);
+     * }
+     *
+     * @example-python Get event by slug
+     * event = exchange.get_event_by_slug('trump-2024-election')
+     * if event:
+     *     print(event.title)
+     */
     getEventBySlug(slug: string): Promise<UnifiedEvent | null>;
     fetchOrderBook(id: string): Promise<OrderBook>;
     fetchOHLCV(id: string, params: OHLCVParams | HistoryFilterParams): Promise<PriceCandle[]>;

package/dist/exchanges/probable/index.js

@@ -53,6 +53,7 @@ class ProbableExchange extends BaseExchange_1.PredictionMarketExchange {
     wsConfig;
     constructor(credentials, wsConfig) {
         super(credentials);
+        this.rateLimit = 500;
         this.wsConfig = wsConfig;
         if (credentials?.privateKey && credentials?.apiKey && credentials?.apiSecret && credentials?.passphrase) {
             this.auth = new auth_1.ProbableAuth(credentials);
@@ -82,9 +83,45 @@ class ProbableExchange extends BaseExchange_1.PredictionMarketExchange {
     async fetchEventsImpl(params) {
         return (0, fetchEvents_1.fetchEvents)(params, this.http, (tokenId) => this.callApi('getPublicApiV1Midpoint', { token_id: tokenId }), (queryParams) => this.callApi('getPublicApiV1PublicSearch', queryParams));
     }
+    /**
+     * Fetch a single event by its numeric ID (Probable only).
+     *
+     * @param id - The numeric event ID
+     * @returns The UnifiedEvent, or null if not found
+     *
+     * @example-ts Get event by ID
+     * const event = await exchange.getEventById('42');
+     * if (event) {
+     *   console.log(event.title);
+     *   console.log(event.markets.length, 'markets');
+     * }
+     *
+     * @example-python Get event by ID
+     * event = exchange.get_event_by_id('42')
+     * if event:
+     *     print(event.title)
+     *     print(len(event.markets), 'markets')
+     */
     async getEventById(id) {
         return (0, fetchEvents_1.fetchEventById)(id, this.http, (tokenId) => this.callApi('getPublicApiV1Midpoint', { token_id: tokenId }));
     }
+    /**
+     * Fetch a single event by its URL slug (Probable only).
+     *
+     * @param slug - The event's URL slug (e.g. `"trump-2024-election"`)
+     * @returns The UnifiedEvent, or null if not found
+     *
+     * @example-ts Get event by slug
+     * const event = await exchange.getEventBySlug('trump-2024-election');
+     * if (event) {
+     *   console.log(event.title);
+     * }
+     *
+     * @example-python Get event by slug
+     * event = exchange.get_event_by_slug('trump-2024-election')
+     * if event:
+     *     print(event.title)
+     */
     async getEventBySlug(slug) {
         return (0, fetchEvents_1.fetchEventBySlug)(slug, this.http, (tokenId) => this.callApi('getPublicApiV1Midpoint', { token_id: tokenId }));
     }

package/dist/utils/throttler.d.ts

@@ -0,0 +1,17 @@
+export declare class Throttler {
+    private tokens;
+    private queue;
+    private running;
+    private lastTimestamp;
+    private refillRate;
+    private capacity;
+    private delay;
+    constructor(config: {
+        refillRate: number;
+        capacity: number;
+        delay: number;
+    });
+    throttle(cost?: number): Promise<void>;
+    private loop;
+    private sleep;
+}

package/dist/utils/throttler.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Throttler = void 0;
+class Throttler {
+    tokens = 0;
+    queue = [];
+    running = false;
+    lastTimestamp = 0;
+    refillRate;
+    capacity;
+    delay;
+    constructor(config) {
+        this.refillRate = config.refillRate;
+        this.capacity = config.capacity;
+        this.delay = config.delay;
+    }
+    async throttle(cost = 1) {
+        return new Promise((resolve) => {
+            this.queue.push({ resolve, cost });
+            if (!this.running) {
+                this.running = true;
+                this.loop();
+            }
+        });
+    }
+    async loop() {
+        while (this.queue.length > 0) {
+            const now = Date.now();
+            if (this.lastTimestamp > 0) {
+                const elapsed = now - this.lastTimestamp;
+                this.tokens = Math.min(this.tokens + elapsed * this.refillRate, this.capacity);
+            }
+            this.lastTimestamp = now;
+            const head = this.queue[0];
+            if (this.tokens >= 0) {
+                this.tokens -= head.cost;
+                head.resolve();
+                this.queue.shift();
+            }
+            else {
+                await this.sleep(this.delay);
+            }
+        }
+        this.running = false;
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+exports.Throttler = Throttler;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxt-core",
-  "version": "2.9.2",
+  "version": "2.11.0",
   "description": "pmxt is a unified prediction market data API. The ccxt for prediction markets.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -29,8 +29,8 @@
     "test": "jest -c jest.config.js",
     "server": "tsx watch src/server/index.ts",
     "server:prod": "node dist/server/index.js",
-    "generate:sdk:python": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g python -o ../sdks/python/generated --package-name pmxt_internal --additional-properties=projectName=pmxt-internal,packageVersion=2.9.2,library=urllib3",
-    "generate:sdk:typescript": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g typescript-fetch -o ../sdks/typescript/generated --additional-properties=npmName=pmxtjs,npmVersion=2.9.2,supportsES6=true,typescriptThreePlus=true && node ../sdks/typescript/scripts/fix-generated.js",
+    "generate:sdk:python": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g python -o ../sdks/python/generated --package-name pmxt_internal --additional-properties=projectName=pmxt-internal,packageVersion=2.11.0,library=urllib3",
+    "generate:sdk:typescript": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g typescript-fetch -o ../sdks/typescript/generated --additional-properties=npmName=pmxtjs,npmVersion=2.11.0,supportsES6=true,typescriptThreePlus=true && node ../sdks/typescript/scripts/fix-generated.js",
     "fetch:openapi": "node scripts/fetch-openapi-specs.js",
     "extract:jsdoc": "node ../scripts/extract-jsdoc.js",
     "generate:docs": "npm run extract:jsdoc && node ../scripts/generate-api-docs.js",