pmxt-core 2.39.1 → 2.40.1

package/dist/exchanges/myriad/websocket.js

@@ -5,6 +5,7 @@ exports.MyriadWebSocket = void 0;
 // We implement a poll-based fallback that resolves promises
 // on each polling interval, matching the CCXT Pro async pattern.
 const DEFAULT_POLL_INTERVAL = 5000; // 5 seconds
+const MAX_CONSECUTIVE_FAILURES = 5;
 class MyriadWebSocket {
     callApi;
     fetchOrderBook;
@@ -12,8 +13,12 @@ class MyriadWebSocket {
     orderBookTimers = new Map();
     tradeTimers = new Map();
     orderBookResolvers = new Map();
+    orderBookRejecters = new Map();
     tradeResolvers = new Map();
+    tradeRejecters = new Map();
     lastTradeTimestamp = new Map();
+    orderBookFailureCount = new Map();
+    tradeFailureCount = new Map();
     closed = false;
     constructor(callApi, fetchOrderBook, pollInterval) {
         this.callApi = callApi;
@@ -23,11 +28,13 @@ class MyriadWebSocket {
     async watchOrderBook(outcomeId) {
         if (this.closed)
             throw new Error('WebSocket connection is closed');
-        return new Promise((resolve) => {
+        return new Promise((resolve, reject) => {
             if (!this.orderBookResolvers.has(outcomeId)) {
                 this.orderBookResolvers.set(outcomeId, []);
+                this.orderBookRejecters.set(outcomeId, []);
             }
             this.orderBookResolvers.get(outcomeId).push(resolve);
+            this.orderBookRejecters.get(outcomeId).push(reject);
             if (!this.orderBookTimers.has(outcomeId)) {
                 this.startOrderBookPolling(outcomeId);
             }
@@ -36,11 +43,13 @@ class MyriadWebSocket {
     async watchTrades(outcomeId) {
         if (this.closed)
             throw new Error('WebSocket connection is closed');
-        return new Promise((resolve) => {
+        return new Promise((resolve, reject) => {
             if (!this.tradeResolvers.has(outcomeId)) {
                 this.tradeResolvers.set(outcomeId, []);
+                this.tradeRejecters.set(outcomeId, []);
             }
             this.tradeResolvers.get(outcomeId).push(resolve);
+            this.tradeRejecters.get(outcomeId).push(reject);
             if (!this.tradeTimers.has(outcomeId)) {
                 this.startTradePolling(outcomeId);
             }
@@ -57,20 +66,39 @@ class MyriadWebSocket {
         this.orderBookTimers.clear();
         this.tradeTimers.clear();
         this.orderBookResolvers.clear();
+        this.orderBookRejecters.clear();
         this.tradeResolvers.clear();
+        this.tradeRejecters.clear();
     }
     startOrderBookPolling(id) {
         const poll = async () => {
             try {
                 const book = await this.fetchOrderBook(id);
+                this.orderBookFailureCount.set(id, 0);
                 const resolvers = this.orderBookResolvers.get(id) || [];
                 this.orderBookResolvers.set(id, []);
+                this.orderBookRejecters.set(id, []);
                 for (const resolve of resolvers) {
                     resolve(book);
                 }
             }
-            catch {
-                // Silently retry on next interval
+            catch (error) {
+                const failures = (this.orderBookFailureCount.get(id) || 0) + 1;
+                this.orderBookFailureCount.set(id, failures);
+                console.warn(`[Myriad] watchOrderBook poll failed for outcomeId=${id} (consecutive failures: ${failures}):`, error);
+                if (failures >= MAX_CONSECUTIVE_FAILURES) {
+                    const timer = this.orderBookTimers.get(id);
+                    if (timer)
+                        clearInterval(timer);
+                    this.orderBookTimers.delete(id);
+                    this.orderBookFailureCount.delete(id);
+                    const rejecters = this.orderBookRejecters.get(id) || [];
+                    this.orderBookResolvers.set(id, []);
+                    this.orderBookRejecters.set(id, []);
+                    for (const reject of rejecters) {
+                        reject(error);
+                    }
+                }
             }
         };
         // Immediate first poll
@@ -110,14 +138,31 @@ class MyriadWebSocket {
                     const maxTs = Math.max(...trades.map(t => t.timestamp));
                     this.lastTradeTimestamp.set(id, maxTs + 1);
                 }
+                this.tradeFailureCount.set(id, 0);
                 const resolvers = this.tradeResolvers.get(id) || [];
                 this.tradeResolvers.set(id, []);
+                this.tradeRejecters.set(id, []);
                 for (const resolve of resolvers) {
                     resolve(trades);
                 }
             }
-            catch {
-                // Silently retry on next interval
+            catch (error) {
+                const failures = (this.tradeFailureCount.get(id) || 0) + 1;
+                this.tradeFailureCount.set(id, failures);
+                console.warn(`[Myriad] watchTrades poll failed for outcomeId=${id} (consecutive failures: ${failures}):`, error);
+                if (failures >= MAX_CONSECUTIVE_FAILURES) {
+                    const timer = this.tradeTimers.get(id);
+                    if (timer)
+                        clearInterval(timer);
+                    this.tradeTimers.delete(id);
+                    this.tradeFailureCount.delete(id);
+                    const rejecters = this.tradeRejecters.get(id) || [];
+                    this.tradeResolvers.set(id, []);
+                    this.tradeRejecters.set(id, []);
+                    for (const reject of rejecters) {
+                        reject(error);
+                    }
+                }
             }
         };
         poll();

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-08T20:51:55.548Z
+ * Generated at: 2026-05-08T23:06:00.151Z
  * 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-08T20:51:55.548Z
+ * Generated at: 2026-05-08T23:06:00.151Z
  * 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-08T20:51:55.496Z
+ * Generated at: 2026-05-08T23:06:00.102Z
  * 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-08T20:51:55.496Z
+ * Generated at: 2026-05-08T23:06:00.102Z
  * 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-08T20:51:55.511Z
+ * Generated at: 2026-05-08T23:06:00.118Z
  * 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-08T20:51:55.511Z
+ * Generated at: 2026-05-08T23:06:00.118Z
  * 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-08T20:51:55.508Z
+ * Generated at: 2026-05-08T23:06:00.115Z
  * 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-08T20:51:55.508Z
+ * Generated at: 2026-05-08T23:06:00.115Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketGammaSpec = {

package/dist/exchanges/polymarket/auth.js

@@ -214,8 +214,11 @@ class PolymarketAuth {
                     signatureType = discovered.signatureType;
                 }
             }
-            catch {
-                // Discovery failure — fall through to default below.
+            catch (err) {
+                // 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) });
             }
         }
         if (signatureType === undefined) {

package/dist/exchanges/polymarket/index.js

@@ -358,7 +358,8 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
                         total = onChain;
                     }
                 }
-                catch {
+                catch (err) {
+                    console.warn('[polymarket] 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_us/normalizer.js

@@ -136,7 +136,7 @@ function intentToSide(intent) {
         case 'ORDER_INTENT_SELL_SHORT':
             return 'sell';
         default:
-            return 'buy';
+            throw new Error(`[polymarket_us] unknown order intent: ${String(intent)}`);
     }
 }
 function intentToOutcomeId(intent, slug) {
@@ -378,6 +378,10 @@ class PolymarketUSNormalizer {
             timestamp: parseTimeToMs(trade.createTime),
             price: (0, price_1.fromAmount)(trade.price),
             amount: parseFloat(trade.qty || '0'),
+            // The Polymarket US activity trade object (Trade$1) does not carry
+            // an intent/side field — only price, qty, and state are provided.
+            // Side cannot be derived from activity data; consumers must cross-reference
+            // with their own order history if side is required.
             side: 'unknown',
             outcomeId: undefined,
         };

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-08T20:51:55.535Z
+ * Generated at: 2026-05-08T23:06:00.139Z
  * 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-08T20:51:55.535Z
+ * Generated at: 2026-05-08T23:06:00.139Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

package/dist/exchanges/probable/index.js

@@ -272,13 +272,14 @@ class ProbableExchange extends BaseExchange_1.PredictionMarketExchange {
         }
     }
     async fetchOpenOrders(marketId) {
+        if (!marketId) {
+            throw new Error('[Probable] fetchOpenOrders requires a marketId: this exchange does not support fetching all orders across all markets');
+        }
         try {
             const auth = this.ensureAuth();
             const client = auth.getClobClient();
             const params = {};
-            if (marketId) {
-                params.eventId = marketId;
-            }
+            params.eventId = marketId;
             const orders = await client.getOpenOrders(params);
             const orderList = Array.isArray(orders) ? orders : orders?.data || [];
             return orderList.map((o) => ({
@@ -330,7 +331,8 @@ class ProbableExchange extends BaseExchange_1.PredictionMarketExchange {
                 total = parseFloat(formatUnits(balance, 18));
             }
             catch (chainError) {
-                // On-chain check failed, return 0
+                console.warn('[Probable] fetchBalance: on-chain USDT balance fetch failed:', chainError);
+                throw chainError;
             }
             // Calculate locked from open BUY orders
             let locked = 0;
@@ -342,8 +344,9 @@ class ProbableExchange extends BaseExchange_1.PredictionMarketExchange {
                     }
                 }
             }
-            catch {
-                // If we can't fetch orders, locked stays 0
+            catch (ordersError) {
+                console.warn('[Probable] fetchBalance: failed to fetch open orders for locked balance calculation:', ordersError);
+                throw ordersError;
             }
             return [{
                     currency: 'USDT',

package/dist/exchanges/smarkets/fetcher.js

@@ -313,8 +313,12 @@ class SmarketsFetcher {
                 });
                 return (data.volumes || []);
             }
-            catch {
-                // Volumes are non-critical; return empty on failure
+            catch (err) {
+                // Volumes are non-critical; return empty on failure but log it.
+                console.warn('[smarkets] volume fetch failed for batch', {
+                    marketIds: batch,
+                    error: err instanceof Error ? err.message : String(err),
+                });
                 return [];
             }
         }));

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from './types';
 export * from './utils/math';
 export { parseOpenApiSpec } from './utils/openapi';
 export * from './errors';
+export * from './exchanges/mock';
 export * from './exchanges/polymarket';
 export * from './exchanges/limitless';
 export * from './exchanges/kalshi';
@@ -15,10 +16,12 @@ export * from './exchanges/metaculus';
 export * from './exchanges/smarkets';
 export * from './exchanges/polymarket_us';
 export * from './exchanges/hyperliquid';
+export * from './exchanges/gemini-titan';
 export * from './router';
 export * from './server/app';
 export * from './server/utils/port-manager';
 export * from './server/utils/lock-file';
+import { MockExchange } from './exchanges/mock';
 import { PolymarketExchange } from './exchanges/polymarket';
 import { LimitlessExchange } from './exchanges/limitless';
 import { KalshiExchange } from './exchanges/kalshi';
@@ -31,8 +34,10 @@ import { MetaculusExchange } from './exchanges/metaculus';
 import { SmarketsExchange } from './exchanges/smarkets';
 import { PolymarketUSExchange } from './exchanges/polymarket_us';
 import { HyperliquidExchange } from './exchanges/hyperliquid';
+import { GeminiTitanExchange } from './exchanges/gemini-titan';
 import { Router } from './router';
 declare const pmxt: {
+    Mock: typeof MockExchange;
     Polymarket: typeof PolymarketExchange;
     Limitless: typeof LimitlessExchange;
     Kalshi: typeof KalshiExchange;
@@ -45,8 +50,10 @@ declare const pmxt: {
     Smarkets: typeof SmarketsExchange;
     PolymarketUS: typeof PolymarketUSExchange;
     Hyperliquid: typeof HyperliquidExchange;
+    GeminiTitan: typeof GeminiTitanExchange;
     Router: typeof Router;
 };
+export declare const Mock: typeof MockExchange;
 export declare const Polymarket: typeof PolymarketExchange;
 export declare const Limitless: typeof LimitlessExchange;
 export declare const Kalshi: typeof KalshiExchange;
@@ -59,4 +66,5 @@ export declare const Metaculus: typeof MetaculusExchange;
 export declare const Smarkets: typeof SmarketsExchange;
 export declare const PolymarketUS: typeof PolymarketUSExchange;
 export declare const Hyperliquid: typeof HyperliquidExchange;
+export declare const GeminiTitan: typeof GeminiTitanExchange;
 export default pmxt;

package/dist/index.js

@@ -14,13 +14,14 @@ 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.Hyperliquid = exports.PolymarketUS = exports.Smarkets = exports.Metaculus = exports.Opinion = exports.Myriad = exports.Baozi = exports.Probable = exports.KalshiDemo = exports.Kalshi = exports.Limitless = exports.Polymarket = exports.parseOpenApiSpec = void 0;
+exports.GeminiTitan = exports.Hyperliquid = exports.PolymarketUS = exports.Smarkets = exports.Metaculus = exports.Opinion = exports.Myriad = exports.Baozi = exports.Probable = exports.KalshiDemo = exports.Kalshi = exports.Limitless = exports.Polymarket = exports.Mock = exports.parseOpenApiSpec = void 0;
 __exportStar(require("./BaseExchange"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./utils/math"), exports);
 var openapi_1 = require("./utils/openapi");
 Object.defineProperty(exports, "parseOpenApiSpec", { enumerable: true, get: function () { return openapi_1.parseOpenApiSpec; } });
 __exportStar(require("./errors"), exports);
+__exportStar(require("./exchanges/mock"), exports);
 __exportStar(require("./exchanges/polymarket"), exports);
 __exportStar(require("./exchanges/limitless"), exports);
 __exportStar(require("./exchanges/kalshi"), exports);
@@ -33,10 +34,12 @@ __exportStar(require("./exchanges/metaculus"), exports);
 __exportStar(require("./exchanges/smarkets"), exports);
 __exportStar(require("./exchanges/polymarket_us"), exports);
 __exportStar(require("./exchanges/hyperliquid"), exports);
+__exportStar(require("./exchanges/gemini-titan"), exports);
 __exportStar(require("./router"), exports);
 __exportStar(require("./server/app"), exports);
 __exportStar(require("./server/utils/port-manager"), exports);
 __exportStar(require("./server/utils/lock-file"), exports);
+const mock_1 = require("./exchanges/mock");
 const polymarket_1 = require("./exchanges/polymarket");
 const limitless_1 = require("./exchanges/limitless");
 const kalshi_1 = require("./exchanges/kalshi");
@@ -49,8 +52,10 @@ const metaculus_1 = require("./exchanges/metaculus");
 const smarkets_1 = require("./exchanges/smarkets");
 const polymarket_us_1 = require("./exchanges/polymarket_us");
 const hyperliquid_1 = require("./exchanges/hyperliquid");
+const gemini_titan_1 = require("./exchanges/gemini-titan");
 const router_1 = require("./router");
 const pmxt = {
+    Mock: mock_1.MockExchange,
     Polymarket: polymarket_1.PolymarketExchange,
     Limitless: limitless_1.LimitlessExchange,
     Kalshi: kalshi_1.KalshiExchange,
@@ -63,8 +68,10 @@ const pmxt = {
     Smarkets: smarkets_1.SmarketsExchange,
     PolymarketUS: polymarket_us_1.PolymarketUSExchange,
     Hyperliquid: hyperliquid_1.HyperliquidExchange,
+    GeminiTitan: gemini_titan_1.GeminiTitanExchange,
     Router: router_1.Router,
 };
+exports.Mock = mock_1.MockExchange;
 exports.Polymarket = polymarket_1.PolymarketExchange;
 exports.Limitless = limitless_1.LimitlessExchange;
 exports.Kalshi = kalshi_1.KalshiExchange;
@@ -77,4 +84,5 @@ exports.Metaculus = metaculus_1.MetaculusExchange;
 exports.Smarkets = smarkets_1.SmarketsExchange;
 exports.PolymarketUS = polymarket_us_1.PolymarketUSExchange;
 exports.Hyperliquid = hyperliquid_1.HyperliquidExchange;
+exports.GeminiTitan = gemini_titan_1.GeminiTitanExchange;
 exports.default = pmxt;

package/dist/router/Router.js

@@ -50,7 +50,10 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
             offset: params?.offset,
             closed: params?.status === 'closed' || params?.status === 'inactive',
         });
-        return response ?? [];
+        if (!Array.isArray(response)) {
+            throw new Error(`fetchMarketsImpl: expected array from searchMarkets but received ${typeof response}`);
+        }
+        return response;
     }
     async fetchEventsImpl(params) {
         const response = await this.client.searchEvents({
@@ -59,7 +62,10 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
             limit: params?.limit,
             offset: params?.offset,
         });
-        return response ?? [];
+        if (!Array.isArray(response)) {
+            throw new Error(`fetchEventsImpl: expected array from searchEvents but received ${typeof response}`);
+        }
+        return response;
     }
     // -----------------------------------------------------------------------
     // Unified orderbook (cross-exchange merge)
@@ -86,19 +92,33 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
             const outcome = findOutcomeForSide(match.market, resolvedSide);
             if (!outcome)
                 continue;
-            fetchPromises.push(exchange.fetchOrderBook(outcome.outcomeId, resolvedSide).catch(() => null));
+            fetchPromises.push(exchange
+                .fetchOrderBook(outcome.outcomeId, resolvedSide)
+                .then((book) => ({ book, venue: venueName, error: null }))
+                .catch((error) => ({ book: null, venue: venueName, error })));
         }
         // Fetch the source market's orderbook (try remaining exchanges with the raw ID)
         for (const [name, exchange] of Object.entries(this.exchanges)) {
             if (matchedVenues.has(name))
                 continue;
-            fetchPromises.push(exchange.fetchOrderBook(outcomeId, resolvedSide).catch(() => null));
+            fetchPromises.push(exchange
+                .fetchOrderBook(outcomeId, resolvedSide)
+                .then((book) => ({ book, venue: name, error: null }))
+                .catch((error) => ({ book: null, venue: name, error })));
+        }
+        const results = await Promise.all(fetchPromises);
+        const books = results.filter((r) => r.book !== null);
+        const failures = results.filter((r) => r.book === null && r.error !== null);
+        if (books.length === 0 && failures.length > 0) {
+            const reasons = failures
+                .map((f) => `${f.venue}: ${f.error instanceof Error ? f.error.message : String(f.error)}`)
+                .join('; ');
+            throw new Error(`fetchOrderBook failed on all exchanges for outcomeId "${outcomeId}": ${reasons}`);
         }
-        const books = (await Promise.all(fetchPromises)).filter((b) => b !== null);
         if (books.length === 0) {
-            return { bids: [], asks: [], timestamp: Date.now() };
+            throw new Error(`fetchOrderBook: no exchange returned an orderbook for outcomeId "${outcomeId}"`);
         }
-        return mergeOrderBooks(books);
+        return mergeOrderBooks(books.map((r) => r.book));
     }
     // -----------------------------------------------------------------------
     // Cross-exchange market matches
@@ -259,9 +279,16 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
         try {
             return await this.fetchArbitrageBulk(params);
         }
-        catch {
-            // Dedicated endpoint not available — fall back to N+1 approach.
-            return this.fetchArbitrageFallback(params);
+        catch (error) {
+            // Only fall back when the bulk endpoint is genuinely not available (404/501).
+            // All other errors (network failures, 5xx, parsing errors) propagate so
+            // 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');
+                return this.fetchArbitrageFallback(params);
+            }
+            throw error;
         }
     }
     /**
@@ -280,17 +307,24 @@ class Router extends BaseExchange_1.PredictionMarketExchange {
         const res = await this.client.getArbitrage(query);
         // getArbitrage already unwraps .data — res is the opportunities array.
         const items = Array.isArray(res) ? res : (res?.data ?? []);
-        return items.map((r) => ({
-            marketA: r.marketA,
-            marketB: r.marketB,
-            spread: r.spread ?? 0,
-            buyVenue: r.buyVenue ?? '',
-            sellVenue: r.sellVenue ?? '',
-            buyPrice: r.buyPrice ?? 0,
-            sellPrice: r.sellPrice ?? 0,
-            relation: r.relation,
-            confidence: r.confidence,
-        }));
+        return items.map((r) => {
+            if (r.spread == null || r.buyPrice == null || r.sellPrice == null) {
+                throw new Error(`fetchArbitrageBulk: arbitrage record is missing required price fields ` +
+                    `(spread=${r.spread}, buyPrice=${r.buyPrice}, sellPrice=${r.sellPrice}) ` +
+                    `for markets ${r.marketA?.marketId ?? '?'} / ${r.marketB?.marketId ?? '?'}`);
+            }
+            return {
+                marketA: r.marketA,
+                marketB: r.marketB,
+                spread: r.spread,
+                buyVenue: r.buyVenue ?? '',
+                sellVenue: r.sellVenue ?? '',
+                buyPrice: r.buyPrice,
+                sellPrice: r.sellPrice,
+                relation: r.relation,
+                confidence: r.confidence,
+            };
+        });
     }
     /**
      * Legacy N+1 fallback: fetch markets, then fetch matches per-market.

package/dist/server/exchange-factory.js

@@ -13,6 +13,8 @@ const metaculus_1 = require("../exchanges/metaculus");
 const smarkets_1 = require("../exchanges/smarkets");
 const polymarket_us_1 = require("../exchanges/polymarket_us");
 const hyperliquid_1 = require("../exchanges/hyperliquid");
+const gemini_titan_1 = require("../exchanges/gemini-titan");
+const mock_1 = require("../exchanges/mock");
 const router_1 = require("../router");
 function createExchange(name, credentials, bearerToken) {
     switch (name) {
@@ -96,6 +98,13 @@ function createExchange(name, credentials, bearerToken) {
                 apiKey: credentials?.apiKey || process.env.HYPERLIQUID_WALLET_ADDRESS,
                 privateKey: credentials?.privateKey || process.env.HYPERLIQUID_PRIVATE_KEY,
             });
+        case "gemini-titan":
+            return new gemini_titan_1.GeminiTitanExchange({
+                apiKey: credentials?.apiKey || process.env.GEMINI_API_KEY,
+                apiSecret: credentials?.apiSecret || process.env.GEMINI_API_SECRET,
+            });
+        case "mock":
+            return new mock_1.MockExchange();
         case "router":
             return new router_1.Router({
                 apiKey: bearerToken,

package/dist/server/openapi.yaml

@@ -3684,6 +3684,28 @@ x-sdk-constructors:
         tsName: privateKey
         type: string
         description: Private key for authentication
+  gemini-titan:
+    className: GeminiTitan
+    params:
+      - name: pmxt_api_key
+        tsName: pmxtApiKey
+        type: string
+        description: PMXT API key for hosted access
+      - name: api_key
+        tsName: apiKey
+        type: string
+        description: API key for authentication
+      - name: api_secret
+        tsName: apiSecret
+        type: string
+        description: API secret for authentication
+  mock:
+    className: Mock
+    params:
+      - name: pmxt_api_key
+        tsName: pmxtApiKey
+        type: string
+        description: PMXT API key for hosted access
   router:
     className: Router
     params:

package/dist/server/ws-handler.js

@@ -196,7 +196,9 @@ function createWebSocketHandler(options = {}) {
             // Close all exchange instances
             for (const [, exchange] of state.exchanges) {
                 if (typeof exchange.close === "function") {
-                    exchange.close().catch(() => { });
+                    exchange.close().catch((err) => {
+                        console.warn('[ws-handler] exchange close() failed', { error: err instanceof Error ? err.message : String(err) });
+                    });
                 }
             }
             state.exchanges.clear();
@@ -254,8 +256,16 @@ function handleSubscribe(ws, state, msg, exchangeName) {
     state.subscriptions.set(key, { abortController });
     const streamFn = method === "watchOrderBooks" ? streamBatch : streamSingle;
     // Fire and forget -- the loop runs until aborted or WS closes
-    streamFn(exchange, method, args || [], id, ws, abortController.signal).catch(() => {
-        // Stream ended -- clean up
+    streamFn(exchange, method, args || [], id, ws, abortController.signal).catch((err) => {
+        // Unexpected stream rejection (programming error — exchange errors are
+        // caught and reported to the client inside streamSingle/streamBatch).
+        console.warn('[ws-handler] stream ended with unexpected error', {
+            exchange: exchangeName,
+            method,
+            id,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        sendError(ws, id, err instanceof Error ? err.message : 'Streaming error');
         state.subscriptions.delete(key);
     });
 }