pmxt-core 2.43.4 → 2.43.8

package/dist/BaseExchange.d.ts

@@ -475,9 +475,15 @@ export declare abstract class PredictionMarketExchange {
     /**
      * Fetch the order book (bids/asks) for a specific outcome.
      *
+     * Supports live and historical queries. For historical data, pass `since`
+     * to get a single snapshot, or `since` + `until` to get an array of fully
+     * reconstructed L2 books from the archive. Range queries return up to
+     * `limit` snapshots (default 100, max 1000).
+     *
      * @param outcomeId - The Outcome ID (outcomeId) or market slug
-     * @param limit - Max number of bid/ask levels to return (CCXT-style).
-     *   For range queries, limits the number of snapshots returned.
+     * @param limit - Max number of bid/ask levels to return. For range
+     *   queries (since + until), limits the number of snapshots returned
+     *   (default 100, max 1000).
      * @param params - Optional parameters:
      *   - `side`: 'yes' or 'no' — explicitly indicate the outcome side
      *     (required for exchanges like Limitless where the API returns a

package/dist/BaseExchange.js

@@ -7,6 +7,7 @@ exports.PredictionMarketExchange = void 0;
 const axios_1 = __importDefault(require("axios"));
 const errors_1 = require("./errors");
 const math_1 = require("./utils/math");
+const logger_1 = require("./utils/logger");
 const throttler_1 = require("./utils/throttler");
 // ----------------------------------------------------------------------------
 // Base Exchange Class
@@ -85,30 +86,27 @@ class PredictionMarketExchange {
         // Request Interceptor
         this.http.interceptors.request.use((config) => {
             if (this.verbose) {
-                console.log(`\n[pmxt] → ${config.method?.toUpperCase()} ${config.url}`);
+                logger_1.logger.debug(`-> ${config.method?.toUpperCase()} ${config.url}`);
                 if (config.params)
-                    console.log('[pmxt] params:', config.params);
+                    logger_1.logger.debug('params:', { params: config.params });
                 if (config.data)
-                    console.log('[pmxt] body:', JSON.stringify(config.data, null, 2));
+                    logger_1.logger.debug('body:', { body: config.data });
             }
             return config;
         });
         // Response Interceptor
         this.http.interceptors.response.use((response) => {
             if (this.verbose) {
-                console.log(`\n[pmxt] ← ${response.status} ${response.statusText} ${response.config.url}`);
-                // console.log('[pmxt] response:', JSON.stringify(response.data, null, 2));
-                // Commented out full body log to avoid spam, but headers might be useful
+                logger_1.logger.debug(`<- ${response.status} ${response.statusText} ${response.config.url}`);
             }
             return response;
         }, (error) => {
             if (this.verbose) {
-                console.log(`\n[pmxt] ✖ REQUEST FAILED: ${error.config?.url}`);
-                console.log('[pmxt] error:', error.message);
-                if (error.response) {
-                    console.log('[pmxt] status:', error.response.status);
-                    console.log('[pmxt] data:', JSON.stringify(error.response.data, null, 2));
-                }
+                logger_1.logger.debug(`REQUEST FAILED: ${error.config?.url}`, {
+                    error: error.message,
+                    status: error.response?.status,
+                    data: error.response?.data,
+                });
             }
             return Promise.reject(error);
         });
@@ -419,9 +417,15 @@ class PredictionMarketExchange {
     /**
      * Fetch the order book (bids/asks) for a specific outcome.
      *
+     * Supports live and historical queries. For historical data, pass `since`
+     * to get a single snapshot, or `since` + `until` to get an array of fully
+     * reconstructed L2 books from the archive. Range queries return up to
+     * `limit` snapshots (default 100, max 1000).
+     *
      * @param outcomeId - The Outcome ID (outcomeId) or market slug
-     * @param limit - Max number of bid/ask levels to return (CCXT-style).
-     *   For range queries, limits the number of snapshots returned.
+     * @param limit - Max number of bid/ask levels to return. For range
+     *   queries (since + until), limits the number of snapshots returned
+     *   (default 100, max 1000).
      * @param params - Optional parameters:
      *   - `side`: 'yes' or 'no' — explicitly indicate the outcome side
      *     (required for exchanges like Limitless where the API returns a
@@ -461,8 +465,7 @@ class PredictionMarketExchange {
     async fetchTrades(outcomeId, params) {
         // Deprecation warning for resolution parameter
         if ('resolution' in params && params.resolution !== undefined) {
-            console.warn('[pmxt] Warning: The "resolution" parameter is deprecated for fetchTrades() and will be ignored. ' +
-                'It will be removed in v3.0.0. Please remove it from your code.');
+            logger_1.logger.warn('The "resolution" parameter is deprecated for fetchTrades() and will be ignored. It will be removed in v3.0.0.');
         }
         throw new Error("Method fetchTrades not implemented.");
     }
@@ -907,7 +910,7 @@ class PredictionMarketExchange {
      * @deprecated Use {@link fetchMarketMatches} instead.
      */
     async fetchMatches(params) {
-        console.warn('[pmxt] fetchMatches is deprecated, use fetchMarketMatches instead');
+        logger_1.logger.warn('fetchMatches is deprecated, use fetchMarketMatches instead');
         return this.fetchMarketMatches(params);
     }
     /**

package/dist/exchanges/gemini-titan/websocket.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GeminiWebSocket = void 0;
 const ws_1 = __importDefault(require("ws"));
+const logger_1 = require("../../utils/logger");
 const watch_timeout_1 = require("../../utils/watch-timeout");
 /**
  * Gemini Titan WebSocket for real-time order book and trade streaming.
@@ -105,7 +106,7 @@ class GeminiWebSocket {
             clearTimeout(this.reconnectTimer);
         this.reconnectTimer = setTimeout(() => {
             this.connect().catch((err) => {
-                console.warn(`[gemini-titan] reconnect failed: ${err instanceof Error ? err.message : String(err)}`);
+                logger_1.logger.warn(`[gemini-titan] reconnect failed: ${err instanceof Error ? err.message : String(err)}`);
             });
         }, this.config.reconnectIntervalMs ?? 5000);
     }
@@ -225,7 +226,7 @@ class GeminiWebSocket {
         this.subscribedDepthSymbols.add(symbol);
         if (!this.isConnected) {
             this.connect().catch((err) => {
-                console.warn(`[gemini-titan] connect failed during watchOrderBook('${symbol}'): ${err instanceof Error ? err.message : String(err)}`);
+                logger_1.logger.warn(`[gemini-titan] connect failed during watchOrderBook('${symbol}'): ${err instanceof Error ? err.message : String(err)}`);
             });
         }
         else {
@@ -246,7 +247,7 @@ class GeminiWebSocket {
         this.subscribedTradeSymbols.add(symbol);
         if (!this.isConnected) {
             this.connect().catch((err) => {
-                console.warn(`[gemini-titan] connect failed during watchTrades('${symbol}'): ${err instanceof Error ? err.message : String(err)}`);
+                logger_1.logger.warn(`[gemini-titan] connect failed during watchTrades('${symbol}'): ${err instanceof Error ? err.message : String(err)}`);
             });
         }
         else {

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-05-22T19:54:12.923Z
+ * Generated at: 2026-05-22T21:57:50.589Z
  * 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-05-22T19:54:12.923Z
+ * Generated at: 2026-05-22T21:57:50.589Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.kalshiApiSpec = {

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-05-22T19:54:12.961Z
+ * Generated at: 2026-05-22T21:57:50.625Z
  * 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-05-22T19:54:12.961Z
+ * Generated at: 2026-05-22T21:57:50.625Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.limitlessApiSpec = {

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-05-22T19:54:12.972Z
+ * Generated at: 2026-05-22T21:57:50.636Z
  * 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-05-22T19:54:12.972Z
+ * Generated at: 2026-05-22T21:57:50.636Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.myriadApiSpec = {

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

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/opinion/opinion-openapi.yaml
- * Generated at: 2026-05-22T19:54:12.977Z
+ * Generated at: 2026-05-22T21:57:50.641Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const opinionApiSpec: {

package/dist/exchanges/opinion/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.opinionApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/opinion/opinion-openapi.yaml
- * Generated at: 2026-05-22T19:54:12.977Z
+ * Generated at: 2026-05-22T21:57:50.641Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.opinionApiSpec = {

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-05-22T19:54:12.931Z
+ * Generated at: 2026-05-22T21:57:50.595Z
  * 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-05-22T19:54:12.931Z
+ * Generated at: 2026-05-22T21:57:50.595Z
  * 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-05-22T19:54:12.944Z
+ * Generated at: 2026-05-22T21:57:50.608Z
  * 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-05-22T19:54:12.944Z
+ * Generated at: 2026-05-22T21:57:50.608Z
  * 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-05-22T19:54:12.941Z
+ * Generated at: 2026-05-22T21:57:50.606Z
  * 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-05-22T19:54:12.941Z
+ * Generated at: 2026-05-22T21:57:50.606Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketGammaSpec = {

package/dist/exchanges/polymarket/auth.js

@@ -9,6 +9,7 @@ const viem_1 = require("viem");
 const accounts_1 = require("viem/accounts");
 const chains_1 = require("viem/chains");
 const axios_1 = __importDefault(require("axios"));
+const logger_1 = require("../../utils/logger");
 const errors_1 = require("./errors");
 const DEFAULT_POLYMARKET_HOST = process.env.POLYMARKET_CLOB_URL || 'https://clob.polymarket.com';
 const POLYGON_CHAIN_ID = 137;
@@ -98,8 +99,7 @@ class PolymarketAuth {
             }
         }
         catch (deriveError) {
-            console.log('[PolymarketAuth] Derivation failed:', deriveError.message || deriveError);
-            console.log('[PolymarketAuth] Attempting to create new API key...');
+            logger_1.logger.info('API key derivation failed, creating new key', { error: deriveError.message || String(deriveError) });
             try {
                 creds = await l1Client.createApiKey();
             }
@@ -108,7 +108,7 @@ class PolymarketAuth {
             }
         }
         if (!creds || !creds.key || !creds.secret || !creds.passphrase) {
-            console.error('[PolymarketAuth] Incomplete credentials:', { hasKey: !!creds?.key, hasSecret: !!creds?.secret, hasPassphrase: !!creds?.passphrase });
+            logger_1.logger.error('Incomplete credentials after derivation', { hasKey: !!creds?.key, hasSecret: !!creds?.secret, hasPassphrase: !!creds?.passphrase });
             throw new Error('Authentication failed: Derived credentials are incomplete.');
         }
         // console.log(`[PolymarketAuth] Successfully obtained API credentials for key ${creds.key.substring(0, 8)}...`);
@@ -149,7 +149,7 @@ class PolymarketAuth {
             }
         }
         catch (error) {
-            // console.warn(`[PolymarketAuth] Could not auto-discover proxy for ${address}:`, error instanceof Error ? error.message : error);
+            logger_1.logger.warn(`Proxy auto-discovery failed for ${address}`, { error: error instanceof Error ? error.message : String(error) });
         }
         // Fallback to EOA if discovery fails
         return {
@@ -223,7 +223,9 @@ class PolymarketAuth {
                 // Discovery failure — fall through to default (Gnosis Safe) below.
                 // A network/HTTP error here does not block trading; we just lose
                 // the ability to auto-detect signatureType.
-                console.warn('[polymarket] signature-type discovery failed; defaulting to Gnosis Safe', { error: err instanceof Error ? err.message : String(err) });
+                logger_1.logger.warn('Signature-type discovery failed; defaulting to Gnosis Safe', {
+                    error: err instanceof Error ? err.message : String(err),
+                });
             }
         }
         if (signatureType === undefined) {

package/dist/exchanges/polymarket/index.js

@@ -14,6 +14,7 @@ const api_clob_1 = require("./api-clob");
 const api_data_1 = require("./api-data");
 const api_gamma_1 = require("./api-gamma");
 const auth_1 = require("./auth");
+const logger_1 = require("../../utils/logger");
 const errors_2 = require("./errors");
 const fetcher_1 = require("./fetcher");
 const normalizer_1 = require("./normalizer");
@@ -135,8 +136,7 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
         (0, validation_1.validateIdFormat)(outcomeId, 'Trades');
         (0, validation_1.validateOutcomeId)(outcomeId, 'Trades');
         if ('resolution' in params && params.resolution !== undefined) {
-            console.warn('[pmxt] Warning: The "resolution" parameter is deprecated for fetchTrades() and will be ignored. ' +
-                'It will be removed in v3.0.0. Please remove it from your code.');
+            logger_1.logger.warn('The "resolution" parameter is deprecated for fetchTrades() and will be ignored. It will be removed in v3.0.0.');
         }
         const rawTrades = await this.fetcher.fetchRawTrades(outcomeId, params);
         const mappedTrades = rawTrades.map((raw, i) => this.normalizer.normalizeTrade(raw, i));
@@ -380,7 +380,9 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
                 // If balRes was an error envelope, fall through to on-chain.
             }
             catch (clobError) {
-                // Network/transport error — fall through to on-chain.
+                logger_1.logger.warn('CLOB balance request failed, falling through to on-chain', {
+                    error: clobError instanceof Error ? clobError.message : String(clobError),
+                });
             }
             // On-Chain Fallback/Check (Robustness)
             // Trigger when CLOB couldn't tell us, or reported a true zero (CLOB
@@ -395,7 +397,9 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
                     }
                 }
                 catch (err) {
-                    console.warn('[polymarket] on-chain balance lookup failed; using CLOB balance only', { error: err instanceof Error ? err.message : String(err) });
+                    logger_1.logger.warn('On-chain balance lookup failed; using CLOB balance only', {
+                        error: err instanceof Error ? err.message : String(err),
+                    });
                 }
             }
             // 2. Fetch open orders to calculate locked funds.

package/dist/exchanges/polymarket/websocket.js

@@ -41,6 +41,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PolymarketWebSocket = void 0;
+const logger_1 = require("../../utils/logger");
 const goldsky_1 = require("../../subscriber/external/goldsky");
 const watcher_1 = require("../../subscriber/watcher");
 const watch_timeout_1 = require("../../utils/watch-timeout");
@@ -165,7 +166,7 @@ class PolymarketWebSocket {
         const url = 'wss://ws-subscriptions-clob.polymarket.com/ws/user';
         this.userWs = new WebSocket(url);
         this.userWs.on('open', () => {
-            console.log('[polymarket-ws] user channel connected');
+            logger_1.logger.debug('[polymarket-ws] user channel connected');
             this.sendUserSubscription(creds);
             // Ping every 10 seconds to keep the connection alive.
             if (this.userPingInterval)
@@ -186,7 +187,7 @@ class PolymarketWebSocket {
                             cb(event);
                         }
                         catch (e) {
-                            console.error('[polymarket-ws] user callback error:', e);
+                            logger_1.logger.error('[polymarket-ws] user callback error', { error: e instanceof Error ? e.message : String(e) });
                         }
                     }
                 }
@@ -196,11 +197,11 @@ class PolymarketWebSocket {
             }
         });
         this.userWs.on('close', () => {
-            console.warn('[polymarket-ws] user channel disconnected, reconnecting in 5s');
+            logger_1.logger.warn('[polymarket-ws] user channel disconnected, reconnecting in 5s');
             this.scheduleUserReconnect(creds);
         });
         this.userWs.on('error', (err) => {
-            console.error('[polymarket-ws] user channel error:', err.message);
+            logger_1.logger.error('[polymarket-ws] user channel error', { error: err.message });
         });
     }
     sendUserSubscription(creds) {
@@ -227,7 +228,7 @@ class PolymarketWebSocket {
                     await this.connectUserChannel(creds);
                 }
                 catch (e) {
-                    console.error('[polymarket-ws] reconnect failed:', e.message);
+                    logger_1.logger.error('[polymarket-ws] reconnect failed', { error: e.message });
                     this.scheduleUserReconnect(creds);
                 }
             }
@@ -293,10 +294,14 @@ class PolymarketWebSocket {
                             this.handleTrade(msg);
                     }
                 }
-                catch { }
+                catch (e) {
+                    logger_1.logger.error('[polymarket-ws] market message handler error', {
+                        error: e instanceof Error ? e.message : String(e),
+                    });
+                }
             });
             this.ws.on('error', (err) => {
-                console.error('Polymarket WebSocket error:', err.message);
+                logger_1.logger.error('[polymarket-ws] WebSocket error', { error: err.message });
                 reject(err);
             });
             this.ws.on('close', () => {

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-05-22T19:54:12.967Z
+ * Generated at: 2026-05-22T21:57:50.629Z
  * 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-05-22T19:54:12.967Z
+ * Generated at: 2026-05-22T21:57:50.629Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

package/dist/router/Router.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Router = void 0;
 const BaseExchange_1 = require("../BaseExchange");
+const logger_1 = require("../utils/logger");
 const client_1 = require("./client");
 // ---------------------------------------------------------------------------
 // Orderbook merge utilities
@@ -163,7 +164,7 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
     }
     /** @deprecated Use {@link fetchMarketMatches} instead. */
     async fetchMatches(params) {
-        console.warn('[pmxt] fetchMatches is deprecated, use fetchMarketMatches instead');
+        logger_1.logger.warn('fetchMatches is deprecated, use fetchMarketMatches instead');
         return this.fetchMarketMatches(params);
     }
     // -----------------------------------------------------------------------
@@ -235,7 +236,7 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
     }
     /** @deprecated Use {@link fetchRelatedMarkets} instead. */
     async fetchHedges(params) {
-        console.warn('[pmxt] fetchHedges is deprecated, use fetchRelatedMarkets instead');
+        logger_1.logger.warn('fetchHedges is deprecated, use fetchRelatedMarkets instead');
         return this.fetchRelatedMarkets(params);
     }
     // -----------------------------------------------------------------------
@@ -269,12 +270,12 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
     }
     /** @deprecated Use {@link fetchMatchedMarkets} instead. */
     async fetchMatchedPrices(params) {
-        console.warn('[pmxt] fetchMatchedPrices is deprecated, use fetchMatchedMarkets instead');
+        logger_1.logger.warn('fetchMatchedPrices is deprecated, use fetchMatchedMarkets instead');
         return this.fetchMatchedMarkets(params);
     }
     /** @deprecated Use {@link fetchMatchedMarkets} instead. */
     async fetchArbitrage(params) {
-        console.warn('[pmxt] fetchArbitrage is deprecated, use fetchMatchedPrices instead');
+        logger_1.logger.warn('fetchArbitrage is deprecated, use fetchMatchedPrices instead');
         return this.fetchArbitrageInternal(params);
     }
     async fetchArbitrageInternal(params) {
@@ -288,7 +289,7 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
             // callers are not silently given stale N+1 data.
             const status = error?.status ?? error?.response?.status;
             if (status === 404 || status === 501) {
-                console.warn('[pmxt] Router: bulk arbitrage endpoint unavailable, falling back to N+1 approach');
+                logger_1.logger.warn('Router: bulk arbitrage endpoint unavailable, falling back to N+1 approach');
                 return this.fetchArbitrageFallback(params);
             }
             throw error;

package/dist/server/app.js

@@ -14,6 +14,7 @@ const ws_handler_1 = require("./ws-handler");
 Object.defineProperty(exports, "createWebSocketHandler", { enumerable: true, get: function () { return ws_handler_1.createWebSocketHandler; } });
 const exchange_factory_1 = require("./exchange-factory");
 const errors_1 = require("../errors");
+const logger_1 = require("../utils/logger");
 function loadMethodVerbs() {
     const candidates = [
         path_1.default.join(__dirname, "method-verbs.json"),
@@ -25,8 +26,7 @@ function loadMethodVerbs() {
         const raw = fs_1.default.readFileSync(file, "utf8");
         return JSON.parse(raw);
     }
-    console.warn("[pmxt-core] method-verbs.json not found — GET /api/:exchange/:method disabled. " +
-        "POST continues to work. Rebuild pmxt-core to regenerate.");
+    logger_1.logger.warn("method-verbs.json not found — GET /api/:exchange/:method disabled. POST continues to work. Rebuild pmxt-core to regenerate.");
     return {};
 }
 const METHOD_VERBS = loadMethodVerbs();
@@ -290,10 +290,7 @@ function createApp(options = {}) {
     });
     // Error handler
     app.use((error, req, res, next) => {
-        console.error("API Error:", error);
-        if (error.stack) {
-            console.error(error.stack);
-        }
+        logger_1.logger.error('API Error', { message: error.message, stack: error.stack });
         // Handle BaseError instances with full context
         if (error instanceof errors_1.BaseError) {
             const errorResponse = {

package/dist/server/openapi.yaml

@@ -684,7 +684,10 @@ paths:
                     properties:
                       data:
                         $ref: '#/components/schemas/OrderBook'
-      description: Fetch the order book (bids/asks) for a specific outcome.
+      description: >-
+        Fetch the order book (bids/asks) for a specific outcome. Supports live and historical queries. For historical
+        data, pass `since` to get a single snapshot, or `since` + `until` to get an array of fully reconstructed L2
+        books from the archive. Range queries return up to `limit` snapshots (default 100, max 1000).
   '/api/{exchange}/fetchOrderBooks':
     post:
       summary: Fetch Order Books

package/dist/utils/logger.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Structured logger for pmxt-core.
+ *
+ * Thin abstraction over console that:
+ * - Attaches a `[pmxt]` prefix for easy filtering
+ * - Supports log levels (debug, info, warn, error)
+ * - Respects a configurable level threshold
+ * - Can be swapped for a real transport (pino, winston) later
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+export declare const logger: {
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    setLevel(level: LogLevel): void;
+    getLevel(): LogLevel;
+};

package/dist/utils/logger.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Structured logger for pmxt-core.
+ *
+ * Thin abstraction over console that:
+ * - Attaches a `[pmxt]` prefix for easy filtering
+ * - Supports log levels (debug, info, warn, error)
+ * - Respects a configurable level threshold
+ * - Can be swapped for a real transport (pino, winston) later
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+let currentLevel = process.env.PMXT_LOG_LEVEL || 'info';
+function shouldLog(level) {
+    return LEVEL_PRIORITY[level] >= LEVEL_PRIORITY[currentLevel];
+}
+exports.logger = {
+    debug(message, context) {
+        if (!shouldLog('debug'))
+            return;
+        if (context) {
+            console.debug(`[pmxt] ${message}`, context);
+        }
+        else {
+            console.debug(`[pmxt] ${message}`);
+        }
+    },
+    info(message, context) {
+        if (!shouldLog('info'))
+            return;
+        if (context) {
+            console.info(`[pmxt] ${message}`, context);
+        }
+        else {
+            console.info(`[pmxt] ${message}`);
+        }
+    },
+    warn(message, context) {
+        if (!shouldLog('warn'))
+            return;
+        if (context) {
+            console.warn(`[pmxt] ${message}`, context);
+        }
+        else {
+            console.warn(`[pmxt] ${message}`);
+        }
+    },
+    error(message, context) {
+        if (!shouldLog('error'))
+            return;
+        if (context) {
+            console.error(`[pmxt] ${message}`, context);
+        }
+        else {
+            console.error(`[pmxt] ${message}`);
+        }
+    },
+    setLevel(level) {
+        currentLevel = level;
+    },
+    getLevel() {
+        return currentLevel;
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxt-core",
-  "version": "2.43.4",
+  "version": "2.43.8",
   "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.43.4,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.43.4,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.43.8,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.43.8,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",