pmxt-core 2.9.2 → 2.9.3

package/dist/exchanges/probable/index.js

@@ -47,12 +47,18 @@ class ProbableExchange extends BaseExchange_1.PredictionMarketExchange {
         fetchBalance: true,
         watchOrderBook: true,
         watchTrades: false,
+        fetchMyTrades: true,
+        fetchClosedOrders: false,
+        fetchAllOrders: false,
+        buildOrder: false,
+        submitOrder: false,
     };
     auth;
     ws;
     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 +88,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 }));
     }
@@ -142,6 +184,25 @@ class ProbableExchange extends BaseExchange_1.PredictionMarketExchange {
         }
         return candles;
     }
+    async fetchMyTrades(params) {
+        const auth = this.ensureAuth();
+        const address = auth.getAddress();
+        const queryParams = { user: address };
+        if (params?.limit)
+            queryParams.limit = params.limit;
+        const data = await this.callApi('getPublicApiV1Trades', queryParams);
+        const trades = Array.isArray(data) ? data : (data.data || []);
+        return trades.map((t) => ({
+            id: String(t.tradeId || t.id || t.timestamp),
+            timestamp: typeof t.time === 'number'
+                ? (t.time > 1e12 ? t.time : t.time * 1000)
+                : Date.now(),
+            price: parseFloat(t.price || '0'),
+            amount: parseFloat(t.qty || t.size || t.amount || '0'),
+            side: (t.side || '').toLowerCase() === 'buy' ? 'buy' : 'sell',
+            orderId: t.orderId,
+        }));
+    }
     // --------------------------------------------------------------------------
     // Trading Methods
     // --------------------------------------------------------------------------

package/dist/exchanges/probable/utils.js

@@ -29,6 +29,7 @@ function mapMarketToUnified(market, event) {
     }
     const um = {
         marketId: String(market.id),
+        eventId: event ? String(event.id) : (market.event_id ? String(market.event_id) : undefined),
         title: market.question || market.title || '',
         description: market.description || '',
         outcomes,
@@ -56,17 +57,20 @@ function mapEventToUnified(event) {
                 markets.push(mapped);
         }
     }
-    return {
+    const unifiedEvent = {
         id: String(event.id),
         title: event.title || '',
         description: event.description || '',
         slug: event.slug || '',
         markets,
+        volume24h: markets.reduce((sum, m) => sum + m.volume24h, 0),
+        volume: markets.some(m => m.volume !== undefined) ? markets.reduce((sum, m) => sum + (m.volume ?? 0), 0) : undefined,
         url: `https://probable.markets/events/${event.slug || event.id}`,
         image: event.icon || event.image || undefined,
         category: event.category || undefined,
         tags: event.tags || [],
     };
+    return unifiedEvent;
 }
 async function enrichMarketsWithPrices(markets, callMidpoint) {
     const outcomes = [];

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * from './errors';
 export * from './exchanges/polymarket';
 export * from './exchanges/limitless';
 export * from './exchanges/kalshi';
+export * from './exchanges/kalshi-demo';
 export * from './exchanges/probable';
 export * from './exchanges/baozi';
 export * from './exchanges/myriad';
@@ -15,6 +16,7 @@ export * from './server/utils/lock-file';
 import { PolymarketExchange } from './exchanges/polymarket';
 import { LimitlessExchange } from './exchanges/limitless';
 import { KalshiExchange } from './exchanges/kalshi';
+import { KalshiDemoExchange } from './exchanges/kalshi-demo';
 import { ProbableExchange } from './exchanges/probable';
 import { BaoziExchange } from './exchanges/baozi';
 import { MyriadExchange } from './exchanges/myriad';
@@ -22,6 +24,7 @@ declare const pmxt: {
     Polymarket: typeof PolymarketExchange;
     Limitless: typeof LimitlessExchange;
     Kalshi: typeof KalshiExchange;
+    KalshiDemo: typeof KalshiDemoExchange;
     Probable: typeof ProbableExchange;
     Baozi: typeof BaoziExchange;
     Myriad: typeof MyriadExchange;
@@ -29,6 +32,7 @@ declare const pmxt: {
 export declare const Polymarket: typeof PolymarketExchange;
 export declare const Limitless: typeof LimitlessExchange;
 export declare const Kalshi: typeof KalshiExchange;
+export declare const KalshiDemo: typeof KalshiDemoExchange;
 export declare const Probable: typeof ProbableExchange;
 export declare const Baozi: typeof BaoziExchange;
 export declare const Myriad: typeof MyriadExchange;

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Myriad = exports.Baozi = exports.Probable = exports.Kalshi = exports.Limitless = exports.Polymarket = exports.parseOpenApiSpec = void 0;
+exports.Myriad = exports.Baozi = exports.Probable = exports.KalshiDemo = exports.Kalshi = exports.Limitless = exports.Polymarket = exports.parseOpenApiSpec = void 0;
 __exportStar(require("./BaseExchange"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./utils/math"), exports);
@@ -24,6 +24,7 @@ __exportStar(require("./errors"), exports);
 __exportStar(require("./exchanges/polymarket"), exports);
 __exportStar(require("./exchanges/limitless"), exports);
 __exportStar(require("./exchanges/kalshi"), exports);
+__exportStar(require("./exchanges/kalshi-demo"), exports);
 __exportStar(require("./exchanges/probable"), exports);
 __exportStar(require("./exchanges/baozi"), exports);
 __exportStar(require("./exchanges/myriad"), exports);
@@ -33,6 +34,7 @@ __exportStar(require("./server/utils/lock-file"), exports);
 const polymarket_1 = require("./exchanges/polymarket");
 const limitless_1 = require("./exchanges/limitless");
 const kalshi_1 = require("./exchanges/kalshi");
+const kalshi_demo_1 = require("./exchanges/kalshi-demo");
 const probable_1 = require("./exchanges/probable");
 const baozi_1 = require("./exchanges/baozi");
 const myriad_1 = require("./exchanges/myriad");
@@ -40,6 +42,7 @@ const pmxt = {
     Polymarket: polymarket_1.PolymarketExchange,
     Limitless: limitless_1.LimitlessExchange,
     Kalshi: kalshi_1.KalshiExchange,
+    KalshiDemo: kalshi_demo_1.KalshiDemoExchange,
     Probable: probable_1.ProbableExchange,
     Baozi: baozi_1.BaoziExchange,
     Myriad: myriad_1.MyriadExchange
@@ -47,6 +50,7 @@ const pmxt = {
 exports.Polymarket = polymarket_1.PolymarketExchange;
 exports.Limitless = limitless_1.LimitlessExchange;
 exports.Kalshi = kalshi_1.KalshiExchange;
+exports.KalshiDemo = kalshi_demo_1.KalshiDemoExchange;
 exports.Probable = probable_1.ProbableExchange;
 exports.Baozi = baozi_1.BaoziExchange;
 exports.Myriad = myriad_1.MyriadExchange;

package/dist/server/app.js

@@ -9,6 +9,7 @@ const cors_1 = __importDefault(require("cors"));
 const polymarket_1 = require("../exchanges/polymarket");
 const limitless_1 = require("../exchanges/limitless");
 const kalshi_1 = require("../exchanges/kalshi");
+const kalshi_demo_1 = require("../exchanges/kalshi-demo");
 const probable_1 = require("../exchanges/probable");
 const baozi_1 = require("../exchanges/baozi");
 const myriad_1 = require("../exchanges/myriad");
@@ -18,44 +19,34 @@ const defaultExchanges = {
     polymarket: null,
     limitless: null,
     kalshi: null,
+    "kalshi-demo": null,
     probable: null,
     baozi: null,
-    myriad: null
+    myriad: null,
 };
 async function startServer(port, accessToken) {
     const app = (0, express_1.default)();
     app.use((0, cors_1.default)());
     app.use(express_1.default.json());
     // Health check (public)
-    app.get('/health', (req, res) => {
-        res.json({ status: 'ok', timestamp: Date.now() });
+    app.get("/health", (req, res) => {
+        res.json({ status: "ok", timestamp: Date.now() });
     });
     // Auth Middleware
     app.use((req, res, next) => {
-        const token = req.headers['x-pmxt-access-token'];
+        const token = req.headers["x-pmxt-access-token"];
         if (!token || token !== accessToken) {
-            res.status(401).json({ success: false, error: 'Unauthorized: Invalid or missing access token' });
+            res.status(401).json({
+                success: false,
+                error: "Unauthorized: Invalid or missing access token",
+            });
             return;
         }
         next();
     });
-    // Capability map endpoint: GET /api/:exchange/has
-    app.get('/api/:exchange/has', (req, res, next) => {
-        try {
-            const exchangeName = req.params.exchange.toLowerCase();
-            if (!defaultExchanges[exchangeName]) {
-                defaultExchanges[exchangeName] = createExchange(exchangeName);
-            }
-            const exchange = defaultExchanges[exchangeName];
-            res.json({ success: true, data: exchange.has });
-        }
-        catch (error) {
-            next(error);
-        }
-    });
     // API endpoint: POST /api/:exchange/:method
     // Body: { args: any[], credentials?: ExchangeCredentials }
-    app.post('/api/:exchange/:method', async (req, res, next) => {
+    app.post("/api/:exchange/:method", async (req, res, next) => {
         try {
             const exchangeName = req.params.exchange.toLowerCase();
             const methodName = req.params.method;
@@ -74,18 +65,20 @@ async function startServer(port, accessToken) {
                 }
                 exchange = defaultExchanges[exchangeName];
             }
-            // Set verbose flag if present in request
-            if (req.body.verbose === true) {
+            // Apply verbose logging if requested via header
+            if (req.headers["x-pmxt-verbose"] === "true") {
                 exchange.verbose = true;
             }
             else {
                 // Reset to false for singleton instances to avoid leaking state between requests
-                // For new instances it defaults to false anyway
                 exchange.verbose = false;
             }
             // 2. Validate Method
-            if (typeof exchange[methodName] !== 'function') {
-                res.status(404).json({ success: false, error: `Method '${methodName}' not found on ${exchangeName}` });
+            if (typeof exchange[methodName] !== "function") {
+                res.status(404).json({
+                    success: false,
+                    error: `Method '${methodName}' not found on ${exchangeName}`,
+                });
                 return;
             }
             // 3. Execute with direct argument spreading
@@ -98,7 +91,7 @@ async function startServer(port, accessToken) {
     });
     // Error handler
     app.use((error, req, res, next) => {
-        console.error('API Error:', error);
+        console.error("API Error:", error);
         if (error.stack) {
             console.error(error.stack);
         }
@@ -109,72 +102,87 @@ async function startServer(port, accessToken) {
                 error: {
                     message: error.message,
                     code: error.code,
-                    retryable: error.retryable
-                }
+                    retryable: error.retryable,
+                },
             };
             // Add exchange context if available
             if (error.exchange) {
                 errorResponse.error.exchange = error.exchange;
             }
             // Add retryAfter for rate limit errors
-            if ('retryAfter' in error && error.retryAfter !== undefined) {
+            if ("retryAfter" in error && error.retryAfter !== undefined) {
                 errorResponse.error.retryAfter = error.retryAfter;
             }
             // Add stack trace in development
-            if (process.env.NODE_ENV === 'development') {
+            if (process.env.NODE_ENV === "development") {
                 errorResponse.error.stack = error.stack;
             }
-            res.status(error.status).json(errorResponse);
+            res.status(error.status || 500).json(errorResponse);
             return;
         }
         // Handle generic errors
         res.status(error.status || 500).json({
             success: false,
             error: {
-                message: error.message || 'Internal server error',
-                stack: process.env.NODE_ENV === 'development' ? error.stack : undefined
-            }
+                message: error.message || "Internal server error",
+                stack: process.env.NODE_ENV === "development" ? error.stack : undefined,
+            },
         });
     });
-    return app.listen(port, '127.0.0.1');
+    return app.listen(port, "127.0.0.1");
 }
 function createExchange(name, credentials) {
     switch (name) {
-        case 'polymarket':
+        case "polymarket":
             return new polymarket_1.PolymarketExchange({
-                privateKey: credentials?.privateKey || process.env.POLYMARKET_PK || process.env.POLYMARKET_PRIVATE_KEY,
+                privateKey: credentials?.privateKey ||
+                    process.env.POLYMARKET_PK ||
+                    process.env.POLYMARKET_PRIVATE_KEY,
                 apiKey: credentials?.apiKey || process.env.POLYMARKET_API_KEY,
                 apiSecret: credentials?.apiSecret || process.env.POLYMARKET_API_SECRET,
                 passphrase: credentials?.passphrase || process.env.POLYMARKET_PASSPHRASE,
                 funderAddress: credentials?.funderAddress,
-                signatureType: credentials?.signatureType
+                signatureType: credentials?.signatureType,
             });
-        case 'limitless':
+        case "limitless":
             return new limitless_1.LimitlessExchange({
-                privateKey: credentials?.privateKey || process.env.LIMITLESS_PK || process.env.LIMITLESS_PRIVATE_KEY,
+                privateKey: credentials?.privateKey ||
+                    process.env.LIMITLESS_PK ||
+                    process.env.LIMITLESS_PRIVATE_KEY,
                 apiKey: credentials?.apiKey || process.env.LIMITLESS_API_KEY,
                 apiSecret: credentials?.apiSecret || process.env.LIMITLESS_API_SECRET,
-                passphrase: credentials?.passphrase || process.env.LIMITLESS_PASSPHRASE
+                passphrase: credentials?.passphrase || process.env.LIMITLESS_PASSPHRASE,
             });
-        case 'kalshi':
+        case "kalshi":
             return new kalshi_1.KalshiExchange({
-                apiKey: credentials?.apiKey || process.env.KALSHI_API_KEY,
-                privateKey: credentials?.privateKey || process.env.KALSHI_PRIVATE_KEY
+                credentials: {
+                    apiKey: credentials?.apiKey || process.env.KALSHI_API_KEY,
+                    privateKey: credentials?.privateKey || process.env.KALSHI_PRIVATE_KEY,
+                },
+            });
+        case "kalshi-demo":
+            return new kalshi_demo_1.KalshiDemoExchange({
+                credentials: {
+                    apiKey: credentials?.apiKey || process.env.KALSHI_API_KEY,
+                    privateKey: credentials?.privateKey || process.env.KALSHI_PRIVATE_KEY,
+                },
             });
-        case 'probable':
+        case "probable":
             return new probable_1.ProbableExchange({
                 apiKey: credentials?.apiKey || process.env.PROBABLE_API_KEY,
                 apiSecret: credentials?.apiSecret || process.env.PROBABLE_API_SECRET,
                 passphrase: credentials?.passphrase || process.env.PROBABLE_PASSPHRASE,
                 privateKey: credentials?.privateKey || process.env.PROBABLE_PRIVATE_KEY,
             });
-        case 'baozi':
+        case "baozi":
             return new baozi_1.BaoziExchange({
                 privateKey: credentials?.privateKey || process.env.BAOZI_PRIVATE_KEY,
             });
-        case 'myriad':
+        case "myriad":
             return new myriad_1.MyriadExchange({
-                apiKey: credentials?.apiKey || process.env.MYRIAD_API_KEY || process.env.MYRIAD_PROD,
+                apiKey: credentials?.apiKey ||
+                    process.env.MYRIAD_API_KEY ||
+                    process.env.MYRIAD_PROD,
                 privateKey: credentials?.privateKey || process.env.MYRIAD_WALLET_ADDRESS,
             });
         default:

package/dist/server/utils/port-manager.js

@@ -61,7 +61,7 @@ class PortManager {
                 server.close();
                 resolve(true);
             });
-            server.listen(port);
+            server.listen(port, '127.0.0.1');
         });
     }
 }

package/dist/types.d.ts

@@ -14,6 +14,8 @@ export interface UnifiedEvent {
     description: string;
     slug: string;
     markets: UnifiedMarket[];
+    volume24h: number;
+    volume?: number;
     url: string;
     image?: string;
     category?: string;
@@ -22,6 +24,7 @@ export interface UnifiedEvent {
 export interface UnifiedMarket {
     /** The unique identifier for this market */
     marketId: string;
+    eventId?: string;
     title: string;
     description: string;
     slug?: string;
@@ -66,6 +69,9 @@ export interface Trade {
     amount: number;
     side: 'buy' | 'sell' | 'unknown';
 }
+export interface UserTrade extends Trade {
+    orderId?: string;
+}
 export interface Order {
     id: string;
     marketId: string;
@@ -107,3 +113,26 @@ export interface CreateOrderParams {
     tickSize?: number;
     negRisk?: boolean;
 }
+export interface BuiltOrder {
+    /** The exchange name this order was built for. */
+    exchange: string;
+    /** The original params used to build this order. */
+    params: CreateOrderParams;
+    /**
+     * For CLOB exchanges (Polymarket): the EIP-712 signed order
+     * ready to POST to the exchange's order endpoint.
+     */
+    signedOrder?: Record<string, unknown>;
+    /**
+     * For on-chain AMM exchanges: the EVM transaction payload.
+     * Reserved for future exchanges; no current exchange populates this.
+     */
+    tx?: {
+        to: string;
+        data: string;
+        value: string;
+        chainId: number;
+    };
+    /** The raw, exchange-native payload. Always present. */
+    raw: unknown;
+}

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.9.3",
   "description": "pmxt is a unified prediction market data API. The ccxt for prediction markets.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -29,12 +29,15 @@
     "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.9.3,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.3,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",
-    "generate:sdk:all": "npm run generate:sdk:python && npm run generate:sdk:typescript && npm run generate:docs"
+    "generate:openapi": "node scripts/generate-openapi.js",
+    "generate:python-exchanges": "node scripts/generate-python-exchanges.js",
+    "generate:compliance": "node scripts/generate-compliance.js",
+    "generate:sdk:all": "npm run generate:openapi && npm run generate:sdk:python && npm run generate:python-exchanges && npm run generate:sdk:typescript && npm run generate:docs && npm run generate:compliance"
   },
   "keywords": [],
   "author": "",