pmxt-core 2.44.3 → 2.44.5

package/dist/errors.d.ts

@@ -84,6 +84,12 @@ export declare class ValidationError extends BaseError {
     readonly field?: string;
     constructor(message: string, field?: string, exchange?: string);
 }
+/**
+ * 501 Not Implemented - The requested operation is not supported
+ */
+export declare class NotSupported extends BaseError {
+    constructor(message: string, exchange?: string);
+}
 /**
  * 503 Service Unavailable - Network connectivity issues (retryable)
  */

package/dist/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExchangeNotAvailable = exports.NetworkError = exports.ValidationError = exports.InsufficientFunds = exports.InvalidOrder = exports.RateLimitExceeded = exports.EventNotFound = exports.MarketNotFound = exports.OrderNotFound = exports.NotFound = exports.PermissionDenied = exports.AuthenticationError = exports.BadRequest = exports.BaseError = void 0;
+exports.ExchangeNotAvailable = exports.NetworkError = exports.NotSupported = exports.ValidationError = exports.InsufficientFunds = exports.InvalidOrder = exports.RateLimitExceeded = exports.EventNotFound = exports.MarketNotFound = exports.OrderNotFound = exports.NotFound = exports.PermissionDenied = exports.AuthenticationError = exports.BadRequest = exports.BaseError = void 0;
 /**
  * Base error class for all PMXT errors
  *
@@ -140,6 +140,15 @@ exports.ValidationError = ValidationError;
 // ============================================================================
 // 5xx Server/Network Errors
 // ============================================================================
+/**
+ * 501 Not Implemented - The requested operation is not supported
+ */
+class NotSupported extends BaseError {
+    constructor(message, exchange) {
+        super(message, 501, 'NOT_SUPPORTED', false, exchange);
+    }
+}
+exports.NotSupported = NotSupported;
 /**
  * 503 Service Unavailable - Network connectivity issues (retryable)
  */

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-24T20:43:25.041Z
+ * Generated at: 2026-05-25T10:52:11.681Z
  * 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-24T20:43:25.041Z
+ * Generated at: 2026-05-25T10:52:11.681Z
  * 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-24T20:43:25.078Z
+ * Generated at: 2026-05-25T10:52:11.722Z
  * 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-24T20:43:25.078Z
+ * Generated at: 2026-05-25T10:52:11.722Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.limitlessApiSpec = {

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

@@ -28,9 +28,10 @@ export declare class MockExchange extends PredictionMarketExchange {
     private _buildEvents;
     protected fetchMarketsImpl(params?: MarketFetchParams): Promise<UnifiedMarket[]>;
     protected fetchEventsImpl(params: EventFetchParams): Promise<UnifiedEvent[]>;
-    fetchOrderBook(id: string, _limit?: number, _params?: Record<string, any>): Promise<OrderBook>;
+    fetchOrderBook(id: string, limit?: number, _params?: Record<string, any>): Promise<OrderBook>;
+    fetchOrderBooks(outcomeIds: string[]): Promise<Record<string, OrderBook>>;
     fetchOHLCV(id: string, params: OHLCVParams): Promise<PriceCandle[]>;
-    fetchTrades(id: string, _params: TradesParams): Promise<Trade[]>;
+    fetchTrades(id: string, params?: TradesParams): Promise<Trade[]>;
     fetchBalance(_address?: string): Promise<Balance[]>;
     fetchPositions(_address?: string): Promise<Position[]>;
     private _nextOrderId;

package/dist/exchanges/mock/index.js

@@ -289,12 +289,13 @@ class MockExchange extends BaseExchange_1.PredictionMarketExchange {
         const limit = params?.limit;
         return limit !== undefined ? events.slice(offset, offset + limit) : events.slice(offset);
     }
-    async fetchOrderBook(id, _limit, _params) {
+    async fetchOrderBook(id, limit, _params) {
         const resolved = await this.resolveOutcomeAlias(id, _params);
         id = resolved.outcomeId;
         const f = new seededRng_1.SeededRng(id);
         const midPrice = round(f.float(0.1, 0.9), 3);
         const spread = round(f.float(0.005, 0.03), 3);
+        const depth = limit === undefined ? 8 : Math.max(0, Math.floor(limit));
         const buildLevels = (startPrice, direction, count) => {
             const levels = [];
             let price = startPrice;
@@ -308,11 +309,18 @@ class MockExchange extends BaseExchange_1.PredictionMarketExchange {
         const askStart = clamp(round(midPrice + spread / 2, 3), 0.01, 0.99);
         const bidStart = clamp(round(midPrice - spread / 2, 3), 0.01, 0.99);
         return {
-            bids: buildLevels(bidStart, -1, 8).sort((a, b) => b.price - a.price),
-            asks: buildLevels(askStart, 1, 8).sort((a, b) => a.price - b.price),
+            bids: buildLevels(bidStart, -1, depth).sort((a, b) => b.price - a.price),
+            asks: buildLevels(askStart, 1, depth).sort((a, b) => a.price - b.price),
             timestamp: Date.now(),
         };
     }
+    async fetchOrderBooks(outcomeIds) {
+        const books = {};
+        for (const outcomeId of outcomeIds) {
+            books[outcomeId] = await this.fetchOrderBook(outcomeId);
+        }
+        return books;
+    }
     async fetchOHLCV(id, params) {
         const f = new seededRng_1.SeededRng(id);
         const resolutionMs = {
@@ -343,7 +351,7 @@ class MockExchange extends BaseExchange_1.PredictionMarketExchange {
         }
         return candles;
     }
-    async fetchTrades(id, _params) {
+    async fetchTrades(id, params = {}) {
         const f = new seededRng_1.SeededRng(id);
         const count = f.int(5, 30);
         const trades = [];
@@ -359,7 +367,8 @@ class MockExchange extends BaseExchange_1.PredictionMarketExchange {
                 outcomeId: id,
             });
         }
-        return trades.sort((a, b) => b.timestamp - a.timestamp);
+        const sorted = trades.sort((a, b) => b.timestamp - a.timestamp);
+        return params.limit === undefined ? sorted : sorted.slice(0, Math.max(0, Math.floor(params.limit)));
     }
     async fetchBalance(_address) {
         const locked = this._locked();

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-24T20:43:25.089Z
+ * Generated at: 2026-05-25T10:52:11.733Z
  * 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-24T20:43:25.089Z
+ * Generated at: 2026-05-25T10:52:11.733Z
  * 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-24T20:43:25.092Z
+ * Generated at: 2026-05-25T10:52:11.737Z
  * 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-24T20:43:25.092Z
+ * Generated at: 2026-05-25T10:52:11.737Z
  * 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-24T20:43:25.048Z
+ * Generated at: 2026-05-25T10:52:11.689Z
  * 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-24T20:43:25.048Z
+ * Generated at: 2026-05-25T10:52:11.689Z
  * 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-24T20:43:25.060Z
+ * Generated at: 2026-05-25T10:52:11.704Z
  * 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-24T20:43:25.060Z
+ * Generated at: 2026-05-25T10:52:11.704Z
  * 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-24T20:43:25.058Z
+ * Generated at: 2026-05-25T10:52:11.701Z
  * 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-24T20:43:25.058Z
+ * Generated at: 2026-05-25T10:52:11.701Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketGammaSpec = {

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-24T20:43:25.083Z
+ * Generated at: 2026-05-25T10:52:11.728Z
  * 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-24T20:43:25.083Z
+ * Generated at: 2026-05-25T10:52:11.728Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

package/dist/feeds/binance/binance-feed.d.ts

@@ -4,6 +4,14 @@ import { BinanceFeedConfig } from './types';
 export declare class BinanceFeed extends BaseDataFeed {
     readonly name = "binance";
     readonly description = "Binance spot trade firehose via obdata relay";
+    readonly has: {
+        readonly loadMarkets: true;
+        readonly fetchTicker: true;
+        readonly fetchTickers: true;
+        readonly watchTicker: true;
+        readonly fetchOHLCV: false;
+        readonly fetchOrderBook: false;
+    };
     private readonly wsUrl;
     private readonly apiKey;
     private readonly reconnectIntervalMs;
@@ -26,4 +34,5 @@ export declare class BinanceFeed extends BaseDataFeed {
     private establishConnection;
     private handleMessage;
     private scheduleReconnect;
+    private validateRelayWsUrl;
 }

package/dist/feeds/binance/binance-feed.js

@@ -6,12 +6,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BinanceFeed = void 0;
 const ws_1 = __importDefault(require("ws"));
 const logger_1 = require("../../utils/logger");
+const errors_1 = require("../../errors");
 const base_feed_1 = require("../base-feed");
 const types_1 = require("./types");
 const normalizer_1 = require("./normalizer");
 class BinanceFeed extends base_feed_1.BaseDataFeed {
     name = 'binance';
     description = 'Binance spot trade firehose via obdata relay';
+    has = {
+        loadMarkets: true,
+        fetchTicker: true,
+        fetchTickers: true,
+        watchTicker: true,
+        fetchOHLCV: false,
+        fetchOrderBook: false,
+    };
     wsUrl;
     apiKey;
     reconnectIntervalMs;
@@ -23,7 +32,7 @@ class BinanceFeed extends base_feed_1.BaseDataFeed {
     connectionPromise = null;
     constructor(config = {}, options) {
         super(options);
-        this.wsUrl = config.wsUrl ?? types_1.BINANCE_RELAY_DEFAULTS.wsUrl;
+        this.wsUrl = config.wsUrl ?? process.env.BINANCE_RELAY_WS_URL ?? types_1.BINANCE_RELAY_DEFAULTS.wsUrl;
         this.apiKey = config.apiKey ?? process.env.OBDATA_API_KEY ?? '';
         this.reconnectIntervalMs = config.reconnectIntervalMs ?? types_1.BINANCE_RELAY_DEFAULTS.reconnectIntervalMs;
     }
@@ -117,10 +126,10 @@ class BinanceFeed extends base_feed_1.BaseDataFeed {
         };
     }
     async fetchOHLCVImpl(_symbol, _timeframe, _since, _limit) {
-        throw new Error('BinanceFeed: OHLCV not available via trade relay');
+        throw new errors_1.NotSupported('BinanceFeed does not support fetchOHLCV via the configured trade relay.', this.name);
     }
     async fetchOrderBookImpl(_symbol, _limit) {
-        throw new Error('BinanceFeed: Order book not available via trade relay');
+        throw new errors_1.NotSupported('BinanceFeed does not support fetchOrderBook via the configured trade relay.', this.name);
     }
     // -- Internal --
     async ensureConnected() {
@@ -130,10 +139,11 @@ class BinanceFeed extends base_feed_1.BaseDataFeed {
     }
     establishConnection() {
         return new Promise((resolve, reject) => {
-            const url = this.apiKey
-                ? `${this.wsUrl}?key=${this.apiKey}`
-                : this.wsUrl;
-            const ws = new ws_1.default(url);
+            const relayUrl = this.validateRelayWsUrl();
+            if (this.apiKey) {
+                relayUrl.searchParams.set('key', this.apiKey);
+            }
+            const ws = new ws_1.default(relayUrl.toString());
             const connectionTimeout = setTimeout(() => {
                 ws.close();
                 this.ws = null;
@@ -203,5 +213,22 @@ class BinanceFeed extends base_feed_1.BaseDataFeed {
             }
         }, this.reconnectIntervalMs);
     }
+    validateRelayWsUrl() {
+        const rawUrl = this.wsUrl.trim();
+        if (!rawUrl) {
+            throw new errors_1.ExchangeNotAvailable('BinanceFeed requires BINANCE_RELAY_WS_URL to fetch live ticker data.', this.name);
+        }
+        let url;
+        try {
+            url = new URL(rawUrl);
+        }
+        catch {
+            throw new errors_1.ExchangeNotAvailable('BinanceFeed requires BINANCE_RELAY_WS_URL to be a valid WebSocket URL.', this.name);
+        }
+        if (url.protocol !== 'ws:' && url.protocol !== 'wss:') {
+            throw new errors_1.ExchangeNotAvailable('BinanceFeed requires BINANCE_RELAY_WS_URL to use ws:// or wss://.', this.name);
+        }
+        return url;
+    }
 }
 exports.BinanceFeed = BinanceFeed;

package/dist/feeds/chainlink/chainlink-feed.d.ts

@@ -4,6 +4,18 @@ import { ChainlinkFeedConfig } from './types';
 export declare class ChainlinkFeed extends BaseDataFeed {
     readonly name = "chainlink";
     readonly description = "Chainlink price feeds (ETH, BTC, XRP, SOL) on Polygon via pmxt-ohlc";
+    readonly has: {
+        readonly loadMarkets: true;
+        readonly fetchTicker: true;
+        readonly fetchTickers: true;
+        readonly watchTicker: true;
+        readonly fetchOHLCV: false;
+        readonly fetchOrderBook: false;
+        readonly fetchOracleRound: true;
+        readonly fetchOracleHistory: true;
+        readonly fetchHistoricalPrices: true;
+    };
+    private readonly baseUrl;
     private readonly client;
     private readonly wsUrl;
     private readonly wsApiKey;
@@ -32,7 +44,9 @@ export declare class ChainlinkFeed extends BaseDataFeed {
         order?: 'asc' | 'desc';
     }): Promise<Ticker[]>;
     private ensureConnected;
+    private ensureRestConfigured;
     private establishConnection;
+    private validateWsUrl;
     private handleMessage;
     private scheduleReconnect;
 }

package/dist/feeds/chainlink/chainlink-feed.js

@@ -8,11 +8,24 @@ const ws_1 = __importDefault(require("ws"));
 const axios_1 = __importDefault(require("axios"));
 const base_feed_1 = require("../base-feed");
 const logger_1 = require("../../utils/logger");
+const errors_1 = require("../../errors");
 const types_1 = require("./types");
 const normalizer_1 = require("./normalizer");
 class ChainlinkFeed extends base_feed_1.BaseDataFeed {
     name = 'chainlink';
     description = 'Chainlink price feeds (ETH, BTC, XRP, SOL) on Polygon via pmxt-ohlc';
+    has = {
+        loadMarkets: true,
+        fetchTicker: true,
+        fetchTickers: true,
+        watchTicker: true,
+        fetchOHLCV: false,
+        fetchOrderBook: false,
+        fetchOracleRound: true,
+        fetchOracleHistory: true,
+        fetchHistoricalPrices: true,
+    };
+    baseUrl;
     client;
     wsUrl;
     wsApiKey;
@@ -25,13 +38,14 @@ class ChainlinkFeed extends base_feed_1.BaseDataFeed {
     connectionPromise = null;
     constructor(config, options) {
         super(options);
-        const baseURL = config.baseUrl ?? types_1.CHAINLINK_DEFAULTS.baseUrl;
+        const baseURL = config.baseUrl ?? process.env.CHAINLINK_API_URL ?? types_1.CHAINLINK_DEFAULTS.baseUrl;
+        this.baseUrl = baseURL;
         this.client = axios_1.default.create({
             baseURL,
             headers: { 'X-API-Key': config.apiKey },
             timeout: 10_000,
         });
-        this.wsUrl = config.wsUrl ?? types_1.CHAINLINK_DEFAULTS.wsUrl;
+        this.wsUrl = config.wsUrl ?? process.env.CHAINLINK_WS_URL ?? types_1.CHAINLINK_DEFAULTS.wsUrl;
         this.wsApiKey = config.wsApiKey ?? config.apiKey;
         this.reconnectIntervalMs = config.reconnectIntervalMs ?? types_1.CHAINLINK_DEFAULTS.reconnectIntervalMs;
     }
@@ -87,6 +101,7 @@ class ChainlinkFeed extends base_feed_1.BaseDataFeed {
         const cached = this.latestTickers.get(symbol.toUpperCase());
         if (cached)
             return cached;
+        this.ensureRestConfigured();
         const token = types_1.TOKEN_BY_PAIR.get(symbol.toUpperCase());
         if (!token) {
             throw new Error(`Unsupported Chainlink symbol: ${symbol}. Supported: ${types_1.SUPPORTED_TOKENS.map((t) => t.pair).join(', ')}`);
@@ -101,6 +116,7 @@ class ChainlinkFeed extends base_feed_1.BaseDataFeed {
     }
     // -- CCXT: fetchTickers --
     async fetchTickersImpl(symbols) {
+        this.ensureRestConfigured();
         const { data } = await this.client.get('/v1/chainlink/latest-prices');
         const now = Date.now();
         const requested = symbols
@@ -133,15 +149,16 @@ class ChainlinkFeed extends base_feed_1.BaseDataFeed {
     }
     // -- CCXT: fetchOHLCV (not supported) --
     async fetchOHLCVImpl(_symbol, _timeframe, _since, _limit) {
-        throw new Error('Chainlink feed does not provide OHLCV candles. ' +
-            'Use fetchOracleHistory() for raw AnswerUpdated records.');
+        throw new errors_1.NotSupported('Chainlink feed does not provide OHLCV candles. ' +
+            'Use fetchOracleHistory() for raw AnswerUpdated records.', this.name);
     }
     // -- CCXT: fetchOrderBook (not applicable) --
     async fetchOrderBookImpl(_symbol, _limit) {
-        throw new Error('Chainlink oracle feeds do not have order books.');
+        throw new errors_1.NotSupported('Chainlink oracle feeds do not have order books.', this.name);
     }
     // -- pmxt extensions: Oracle --
     async fetchOracleRound(params) {
+        this.ensureRestConfigured();
         const token = types_1.TOKEN_BY_PAIR.get(params.feed.toUpperCase());
         if (!token) {
             throw new Error(`Unsupported Chainlink feed: ${params.feed}. Supported: ${types_1.SUPPORTED_TOKENS.map((t) => t.pair).join(', ')}`);
@@ -153,6 +170,7 @@ class ChainlinkFeed extends base_feed_1.BaseDataFeed {
         return (0, normalizer_1.normalizePriceRecordToOracleRound)(data.data[0]);
     }
     async fetchOracleHistory(params) {
+        this.ensureRestConfigured();
         const token = types_1.TOKEN_BY_PAIR.get(params.feed.toUpperCase());
         if (!token) {
             throw new Error(`Unsupported Chainlink feed: ${params.feed}. Supported: ${types_1.SUPPORTED_TOKENS.map((t) => t.pair).join(', ')}`);
@@ -161,6 +179,7 @@ class ChainlinkFeed extends base_feed_1.BaseDataFeed {
         return data.data.map(normalizer_1.normalizePriceRecordToOracleRound);
     }
     async fetchHistoricalPrices(symbol, opts) {
+        this.ensureRestConfigured();
         const token = types_1.TOKEN_BY_PAIR.get(symbol.toUpperCase());
         if (!token) {
             throw new Error(`Unsupported Chainlink symbol: ${symbol}. Supported: ${types_1.SUPPORTED_TOKENS.map((t) => t.pair).join(', ')}`);
@@ -183,10 +202,29 @@ class ChainlinkFeed extends base_feed_1.BaseDataFeed {
             return;
         await this.connect();
     }
+    ensureRestConfigured() {
+        const rawUrl = this.baseUrl.trim();
+        if (!rawUrl) {
+            throw new errors_1.ExchangeNotAvailable('ChainlinkFeed requires CHAINLINK_API_URL to fetch oracle data.', this.name);
+        }
+        let url;
+        try {
+            url = new URL(rawUrl);
+        }
+        catch {
+            throw new errors_1.ExchangeNotAvailable('ChainlinkFeed requires CHAINLINK_API_URL to be a valid HTTP URL.', this.name);
+        }
+        if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+            throw new errors_1.ExchangeNotAvailable('ChainlinkFeed requires CHAINLINK_API_URL to use http:// or https://.', this.name);
+        }
+    }
     establishConnection() {
         return new Promise((resolve, reject) => {
-            const url = `${this.wsUrl}?key=${this.wsApiKey}`;
-            const ws = new ws_1.default(url);
+            const wsUrl = this.validateWsUrl();
+            if (this.wsApiKey) {
+                wsUrl.searchParams.set('key', this.wsApiKey);
+            }
+            const ws = new ws_1.default(wsUrl.toString());
             const connectionTimeout = setTimeout(() => {
                 ws.close();
                 this.ws = null;
@@ -220,6 +258,23 @@ class ChainlinkFeed extends base_feed_1.BaseDataFeed {
             });
         });
     }
+    validateWsUrl() {
+        const rawUrl = this.wsUrl.trim();
+        if (!rawUrl) {
+            throw new errors_1.ExchangeNotAvailable('ChainlinkFeed requires CHAINLINK_WS_URL to stream live oracle data.', this.name);
+        }
+        let url;
+        try {
+            url = new URL(rawUrl);
+        }
+        catch {
+            throw new errors_1.ExchangeNotAvailable('ChainlinkFeed requires CHAINLINK_WS_URL to be a valid WebSocket URL.', this.name);
+        }
+        if (url.protocol !== 'ws:' && url.protocol !== 'wss:') {
+            throw new errors_1.ExchangeNotAvailable('ChainlinkFeed requires CHAINLINK_WS_URL to use ws:// or wss://.', this.name);
+        }
+        return url;
+    }
     handleMessage(data) {
         const text = typeof data === 'string' ? data : data.toString();
         let msg;

package/dist/feeds/interfaces.d.ts

@@ -1,7 +1,11 @@
 import { Ticker, Tickers, OHLCV, OrderBook, Market, FundingRate, FundingRates, OracleRound, OracleParams, Dictionary } from './types';
+export type DataFeedCapability = 'loadMarkets' | 'fetchTicker' | 'fetchTickers' | 'watchTicker' | 'fetchOHLCV' | 'fetchOrderBook' | 'watchOrderBook' | 'fetchFundingRate' | 'fetchFundingRates' | 'fetchOracleRound' | 'fetchOracleHistory' | 'fetchHistoricalPrices';
+export type DataFeedCapabilityValue = true | false | 'emulated';
+export type DataFeedCapabilities = Readonly<Partial<Record<DataFeedCapability, DataFeedCapabilityValue>>>;
 export interface IDataFeed {
     readonly name: string;
     readonly description: string;
+    readonly has?: DataFeedCapabilities;
     loadMarkets(reload?: boolean): Promise<Dictionary<Market>>;
     fetchTicker(symbol: string): Promise<Ticker>;
     fetchTickers(symbols?: string[]): Promise<Tickers>;
@@ -13,6 +17,12 @@ export interface IDataFeed {
     fetchFundingRates?(symbols?: string[]): Promise<FundingRates>;
     fetchOracleRound?(params: OracleParams): Promise<OracleRound>;
     fetchOracleHistory?(params: OracleParams): Promise<OracleRound[]>;
+    fetchHistoricalPrices?(symbol: string, opts?: {
+        fromTimestamp?: number;
+        untilTimestamp?: number;
+        maxSize?: number;
+        order?: 'asc' | 'desc';
+    }): Promise<Ticker[]>;
     connect?(): Promise<void>;
     close?(): Promise<void>;
 }

package/dist/router/Router.d.ts

@@ -4,6 +4,7 @@ import type { RouterOptions, MatchResult, EventMatchResult, PriceComparison, Arb
 export declare class Router extends PredictionMarketExchange {
     private readonly client;
     private readonly exchanges;
+    private readonly localExchanges;
     constructor(options: RouterOptions);
     get name(): string;
     protected fetchMarketsImpl(params?: MarketFetchParams): Promise<UnifiedMarket[]>;
@@ -28,6 +29,14 @@ export declare class Router extends PredictionMarketExchange {
     fetchMatchedPrices(params?: FetchMatchedPricesParams): Promise<MatchedPricePair[]>;
     /** @deprecated Use {@link fetchMatchedMarkets} instead. */
     fetchArbitrage(params?: FetchArbitrageParams): Promise<ArbitrageOpportunity[]>;
+    private getLocalExchange;
+    /**
+     * Local mock IDs are sidecar-only fixtures. Hosted match endpoints do not
+     * know them, so resolve them locally when possible and avoid opaque hosted
+     * "not found" responses.
+     */
+    private resolveLocalMockMarketLookup;
+    private resolveLocalMockEventLookup;
     private fetchArbitrageInternal;
     /**
      * Bulk arbitrage via `GET /v0/arbitrage`. One round-trip.