pmxt-core 2.51.3 → 2.52.0

package/dist/BaseExchange.d.ts

@@ -526,6 +526,13 @@ export declare abstract class PredictionMarketExchange {
      * @throws EventNotFound if no event matches the parameters
      */
     fetchEvent(params?: EventFetchParams): Promise<UnifiedEvent>;
+    /**
+     * Fetch venue-native metadata for a specific event when the exchange
+     * exposes a dedicated metadata endpoint.
+     *
+     * Kalshi implements this for `GET /events/{event_ticker}/metadata`.
+     */
+    fetchEventMetadata(eventTicker: string): Promise<Record<string, unknown>>;
     /**
      * Fetch historical OHLCV (candlestick) price data for a specific market outcome.
      *

package/dist/BaseExchange.js

@@ -487,6 +487,16 @@ class PredictionMarketExchange {
         }
         return events[0];
     }
+    /**
+     * Fetch venue-native metadata for a specific event when the exchange
+     * exposes a dedicated metadata endpoint.
+     *
+     * Kalshi implements this for `GET /events/{event_ticker}/metadata`.
+     */
+    async fetchEventMetadata(eventTicker) {
+        void eventTicker;
+        throw new Error("Method fetchEventMetadata not implemented.");
+    }
     /**
      * Fetch historical OHLCV (candlestick) price data for a specific market outcome.
      *

package/dist/exchanges/gemini-titan/errors.d.ts

@@ -10,10 +10,15 @@ import { BadRequest } from '../../errors';
  *   - InvalidSignature -> AuthenticationError
  *   - InsufficientFunds -> InsufficientFunds
  *   - InvalidQuantity, InvalidPrice, MarketNotOpen -> InvalidOrder
+ *   - TermsNotAccepted -> AuthenticationError (with auto-accept flow)
  */
 export declare class GeminiErrorMapper extends ErrorMapper {
     constructor();
     protected extractErrorMessage(error: unknown): string;
+    /**
+     * Check if an error is related to terms acceptance
+     */
+    private isTermsError;
     protected mapBadRequestError(message: string, data: unknown): BadRequest;
     mapError(error: unknown): ReturnType<ErrorMapper['mapError']>;
 }

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

@@ -7,6 +7,14 @@ exports.geminiErrorMapper = exports.GeminiErrorMapper = void 0;
 const axios_1 = __importDefault(require("axios"));
 const error_mapper_1 = require("../../utils/error-mapper");
 const errors_1 = require("../../errors");
+// Terms-related error patterns
+const TERMS_ERROR_PATTERNS = [
+    'terms_not_accepted',
+    'terms required',
+    'prediction markets terms',
+    'accept terms',
+    'terms must be accepted',
+];
 /**
  * Maps Gemini Titan API errors to PMXT unified error classes.
  *
@@ -17,6 +25,7 @@ const errors_1 = require("../../errors");
  *   - InvalidSignature -> AuthenticationError
  *   - InsufficientFunds -> InsufficientFunds
  *   - InvalidQuantity, InvalidPrice, MarketNotOpen -> InvalidOrder
+ *   - TermsNotAccepted -> AuthenticationError (with auto-accept flow)
  */
 class GeminiErrorMapper extends error_mapper_1.ErrorMapper {
     constructor() {
@@ -37,12 +46,25 @@ class GeminiErrorMapper extends error_mapper_1.ErrorMapper {
         }
         return super.extractErrorMessage(error);
     }
+    /**
+     * Check if an error is related to terms acceptance
+     */
+    isTermsError(message) {
+        const lowerMessage = message.toLowerCase();
+        return TERMS_ERROR_PATTERNS.some(pattern => lowerMessage.includes(pattern));
+    }
     mapBadRequestError(message, data) {
         const reason = typeof data === 'object' && data !== null && 'reason' in data
             ? String(data.reason)
             : '';
         const lowerReason = reason.toLowerCase();
         const lowerMessage = message.toLowerCase();
+        // ✅ Check for terms-related errors first
+        if (this.isTermsError(lowerMessage) || this.isTermsError(lowerReason)) {
+            return new errors_1.AuthenticationError(`Gemini Prediction Markets terms must be accepted before placing orders. ` +
+                `The adapter will automatically accept terms on your behalf. ` +
+                `Original error: ${message}`, this.exchangeName);
+        }
         if (lowerReason.includes('insufficientfunds') || lowerMessage.includes('insufficient')) {
             return new errors_1.InsufficientFunds(message, this.exchangeName);
         }
@@ -56,8 +78,7 @@ class GeminiErrorMapper extends error_mapper_1.ErrorMapper {
             return new errors_1.InvalidOrder(message, this.exchangeName);
         }
         if (lowerReason.includes('invalidsignature') ||
-            lowerReason.includes('invalidapikey') ||
-            lowerMessage.includes('terms_not_accepted')) {
+            lowerReason.includes('invalidapikey')) {
             return new errors_1.AuthenticationError(message, this.exchangeName);
         }
         return super.mapBadRequestError(message, data);
@@ -68,6 +89,20 @@ class GeminiErrorMapper extends error_mapper_1.ErrorMapper {
             const retryAfterSeconds = retryAfter ? parseInt(retryAfter, 10) : undefined;
             return new errors_1.RateLimitExceeded(this.extractErrorMessage(error), retryAfterSeconds, this.exchangeName);
         }
+        // ✅ Check for terms errors in non-4xx responses
+        if (axios_1.default.isAxiosError(error) && error.response?.data) {
+            const data = error.response.data;
+            const message = typeof data === 'object' && data !== null && 'message' in data
+                ? String(data.message)
+                : typeof data === 'string'
+                    ? data
+                    : '';
+            if (this.isTermsError(message)) {
+                return new errors_1.AuthenticationError(`Gemini Prediction Markets terms must be accepted before placing orders. ` +
+                    `The adapter will automatically accept terms on your behalf. ` +
+                    `Original error: ${message}`, this.exchangeName);
+            }
+        }
         return super.mapError(error);
     }
 }

package/dist/exchanges/gemini-titan/fetcher.d.ts

@@ -6,13 +6,42 @@ export declare class GeminiFetcher implements IExchangeFetcher<GeminiRawEvent, G
     private readonly ctx;
     private readonly baseUrl;
     private readonly auth;
+    private readonly httpClient;
     private symbolToEventTicker;
+    private termsAccepted;
     constructor(ctx: FetcherContext, baseUrl: string, auth?: GeminiAuth);
     fetchRawMarkets(params?: MarketFilterParams): Promise<GeminiRawEvent[]>;
     fetchRawEvents(params: EventFetchParams): Promise<GeminiRawEvent[]>;
     fetchRawSingleEvent(eventTicker: string): Promise<GeminiRawEvent>;
     fetchRawOrderBook(instrumentSymbol: string): Promise<GeminiRawOrderBook | undefined>;
     getEventTickerForSymbol(instrumentSymbol: string): string | undefined;
+    /**
+     * Get current terms version and content
+     */
+    getTerms(): Promise<{
+        version: string;
+        content: string;
+    }>;
+    /**
+     * Check if API key has accepted the latest terms
+     */
+    getTermsStatus(): Promise<{
+        hasAcceptedLatest: boolean;
+        acceptedVersion?: string;
+        latestVersion?: string;
+    }>;
+    /**
+     * Accept the latest terms version
+     */
+    acceptTerms(): Promise<{
+        accepted: boolean;
+        version: string;
+    }>;
+    /**
+     * Ensure terms are accepted before placing orders.
+     * This is called automatically before order submission.
+     */
+    ensureTermsAccepted(): Promise<void>;
     submitRawOrder(payload: Record<string, unknown>): Promise<GeminiRawOrder>;
     cancelRawOrder(orderId: number): Promise<GeminiRawOrder>;
     fetchRawActiveOrders(symbol?: string): Promise<GeminiRawOrder[]>;
@@ -20,5 +49,9 @@ export declare class GeminiFetcher implements IExchangeFetcher<GeminiRawEvent, G
     private fetchPaginatedOrders;
     fetchRawPositions(): Promise<GeminiRawPosition[]>;
     private get;
+    /**
+     * Authenticated GET request
+     */
+    private getAuthenticated;
     private postAuthenticated;
 }

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

@@ -9,12 +9,16 @@ class GeminiFetcher {
     ctx;
     baseUrl;
     auth;
+    httpClient; // Add httpClient
     // Index mapping instrumentSymbol -> eventTicker, built during fetchRawEvents
     symbolToEventTicker = new Map();
+    // Track terms acceptance status to avoid repeated checks
+    termsAccepted = false;
     constructor(ctx, baseUrl, auth) {
         this.ctx = ctx;
         this.baseUrl = baseUrl;
         this.auth = auth;
+        this.httpClient = ctx.http; // Initialize httpClient from ctx
     }
     // -- Public data -----------------------------------------------------------
     async fetchRawMarkets(params) {
@@ -95,8 +99,60 @@ class GeminiFetcher {
     getEventTickerForSymbol(instrumentSymbol) {
         return this.symbolToEventTicker.get(instrumentSymbol);
     }
+    // -- Terms Acceptance Flow -----------------------------------------------
+    /**
+     * Get current terms version and content
+     */
+    async getTerms() {
+        return this.getAuthenticated('/v1/prediction-markets/terms');
+    }
+    /**
+     * Check if API key has accepted the latest terms
+     */
+    async getTermsStatus() {
+        return this.getAuthenticated('/v1/prediction-markets/terms/status');
+    }
+    /**
+     * Accept the latest terms version
+     */
+    async acceptTerms() {
+        const result = await this.postAuthenticated('/v1/prediction-markets/terms/accept', {});
+        this.termsAccepted = true;
+        return result;
+    }
+    /**
+     * Ensure terms are accepted before placing orders.
+     * This is called automatically before order submission.
+     */
+    async ensureTermsAccepted() {
+        // Skip if already accepted in this session
+        if (this.termsAccepted) {
+            return;
+        }
+        try {
+            const status = await this.getTermsStatus();
+            if (!status.hasAcceptedLatest) {
+                // Terms not accepted - accept them
+                await this.acceptTerms();
+                // Log acceptance (using logger instead of console if available)
+            }
+            else {
+                this.termsAccepted = true;
+            }
+        }
+        catch (error) {
+            // If terms check fails with a specific error, re-throw
+            if (error.message?.includes('TERMS') || error.message?.includes('terms')) {
+                throw errors_1.geminiErrorMapper.mapError(error);
+            }
+            // Otherwise log warning but don't block order submission
+            // The order will fail with a clear error if terms are required
+        }
+    }
     // -- Authenticated endpoints -----------------------------------------------
     async submitRawOrder(payload) {
+        // ✅ Ensure terms are accepted before placing order
+        await this.ensureTermsAccepted();
         return this.postAuthenticated('/v1/prediction-markets/order', payload);
     }
     async cancelRawOrder(orderId) {
@@ -153,6 +209,27 @@ class GeminiFetcher {
             throw errors_1.geminiErrorMapper.mapError(error);
         }
     }
+    /**
+     * Authenticated GET request
+     */
+    async getAuthenticated(path) {
+        if (!this.auth) {
+            throw new Error('Authentication required. Provide apiKey and apiSecret.');
+        }
+        const url = `${this.baseUrl}${path}`;
+        const payload = {
+            request: path,
+            nonce: this.auth.nonce(),
+        };
+        const headers = this.auth.buildHeaders(payload);
+        try {
+            const response = await this.httpClient.get(url, { headers });
+            return response.data;
+        }
+        catch (error) {
+            throw errors_1.geminiErrorMapper.mapError(error);
+        }
+    }
     async postAuthenticated(path, extraFields) {
         if (!this.auth) {
             throw new Error('Authentication required. Provide apiKey and apiSecret.');

package/dist/exchanges/gemini-titan/index.d.ts

@@ -33,3 +33,7 @@ export declare class GeminiTitanExchange extends PredictionMarketExchange {
     watchTrades(outcomeId: string): Promise<Trade[]>;
     close(): Promise<void>;
 }
+export { GeminiFetcher } from './fetcher';
+export { GeminiAuth } from './auth';
+export { geminiErrorMapper } from './errors';
+export * from './types';

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

@@ -1,6 +1,20 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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.GeminiTitanExchange = void 0;
+exports.geminiErrorMapper = exports.GeminiAuth = exports.GeminiFetcher = exports.GeminiTitanExchange = void 0;
 const BaseExchange_1 = require("../../BaseExchange");
 const errors_1 = require("../../errors");
 const config_1 = require("./config");
@@ -258,3 +272,10 @@ class GeminiTitanExchange extends BaseExchange_1.PredictionMarketExchange {
     }
 }
 exports.GeminiTitanExchange = GeminiTitanExchange;
+var fetcher_2 = require("./fetcher");
+Object.defineProperty(exports, "GeminiFetcher", { enumerable: true, get: function () { return fetcher_2.GeminiFetcher; } });
+var auth_2 = require("./auth");
+Object.defineProperty(exports, "GeminiAuth", { enumerable: true, get: function () { return auth_2.GeminiAuth; } });
+var errors_3 = require("./errors");
+Object.defineProperty(exports, "geminiErrorMapper", { enumerable: true, get: function () { return errors_3.geminiErrorMapper; } });
+__exportStar(require("./types"), exports);

package/dist/exchanges/hyperliquid/index.js

@@ -185,12 +185,25 @@ class HyperliquidExchange extends BaseExchange_1.PredictionMarketExchange {
                 ? { limit: { tif: 'Ioc' } }
                 : { limit: { tif: 'Gtc' } },
         };
-        // Key order matters for msgpack hash: type, orders, grouping
+        // Key order matters for msgpack hash: type, orders, grouping, builder
         const action = {
             type: 'order',
             orders: [orderWire],
             grouping: 'na',
         };
+        if (params.builder !== undefined || params.builderFee !== undefined) {
+            if (!params.builder) {
+                throw new Error('Hyperliquid builderFee requires builder address');
+            }
+            if (!/^0x[0-9a-fA-F]{40}$/.test(params.builder)) {
+                throw new Error(`Invalid Hyperliquid builder address: ${params.builder}`);
+            }
+            const builderFee = params.builderFee ?? 0;
+            if (!Number.isInteger(builderFee) || builderFee < 0) {
+                throw new Error('Hyperliquid builderFee must be a non-negative integer in tenths of a basis point');
+            }
+            action.builder = { b: params.builder.toLowerCase(), f: builderFee };
+        }
         return {
             exchange: this.name,
             params,

package/dist/exchanges/hyperliquid/normalizer.js

@@ -73,6 +73,38 @@ function parseExpiryDate(expiry) {
     const [, year, month, day, hour, minute] = match;
     return new Date(`${year}-${month}-${day}T${hour}:${minute}:00Z`);
 }
+const MONTH_INDEX = {
+    January: 0, February: 1, March: 2, April: 3, May: 4, June: 5,
+    July: 6, August: 7, September: 8, October: 9, November: 10, December: 11,
+};
+/**
+ * Fall back to scanning the question's prose description for a resolution
+ * deadline. Hyperliquid puts no structured endTime on the Outcome/Question
+ * objects, but every non-recurring question's description contains at least
+ * one "<Month> <DD>[,] <YYYY>" date (e.g. "by October 14, 2026 at 23:59 UTC").
+ * Returns the LATEST such date — questions often mention an event date and a
+ * later resolution deadline, and we want the deadline. Defaults to 23:59 UTC
+ * when no time is given.
+ */
+function parseDeadlineFromText(text) {
+    if (!text)
+        return undefined;
+    const re = /(January|February|March|April|May|June|July|August|September|October|November|December)\s+(\d{1,2}),?\s+(\d{4})(?:\s+at\s+(\d{1,2}):(\d{2})\s*UTC)?/g;
+    let latest;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        const [, monthName, day, year, hour, minute] = m;
+        const month = MONTH_INDEX[monthName];
+        if (month === undefined)
+            continue;
+        const d = new Date(Date.UTC(parseInt(year, 10), month, parseInt(day, 10), hour !== undefined ? parseInt(hour, 10) : 23, minute !== undefined ? parseInt(minute, 10) : 59, 0));
+        if (Number.isNaN(d.getTime()))
+            continue;
+        if (!latest || d > latest)
+            latest = d;
+    }
+    return latest;
+}
 /**
  * Build a human-readable title from the parsed description.
  */
@@ -154,10 +186,11 @@ class HyperliquidNormalizer {
                 price: noPrice,
             });
         }
-        // Resolution date: prefer outcome-level expiry, fall back to question-level
+        // Resolution date: prefer outcome-level expiry, then question-level expiry tag,
+        // then a deadline phrase scraped from the question's prose description.
         const expiryDate = parsed.expiryDate
             ?? questionParsed?.expiryDate
-            ?? undefined;
+            ?? parseDeadlineFromText(raw.question?.description ?? "");
         // Build a descriptive title from the parsed description
         const title = buildTitle(outcome.name, parsed, questionParsed);
         // Derive underlying from outcome or question

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-06-24T09:17:49.567Z
+ * Generated at: 2026-07-18T00:54:13.384Z
  * 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-06-24T09:17:49.567Z
+ * Generated at: 2026-07-18T00:54:13.384Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.kalshiApiSpec = {

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

@@ -70,25 +70,48 @@ export interface KalshiRawEventPage {
 }
 export interface KalshiRawCandlestick {
     end_period_ts: number;
+    /** @deprecated Old API field — new API uses `volume_fp` (string) */
     volume?: number;
+    /** New API field: cumulative volume as a fixed-point string */
+    volume_fp?: string;
+    /**
+     * Kalshi candlestick prices come nested under `price`. The new API returns
+     * dollar-denominated string fields (e.g. `close_dollars: "0.9700"`); older
+     * responses used integer cent fields (e.g. `close: 97`). Both shapes are
+     * supported by the normalizer.
+     */
     price?: {
         open?: number;
         high?: number;
         low?: number;
         close?: number;
         previous?: number;
+        open_dollars?: string;
+        high_dollars?: string;
+        low_dollars?: string;
+        close_dollars?: string;
+        mean_dollars?: string;
+        previous_dollars?: string;
     };
     yes_ask?: {
         open?: number;
         high?: number;
         low?: number;
         close?: number;
+        open_dollars?: string;
+        high_dollars?: string;
+        low_dollars?: string;
+        close_dollars?: string;
     };
     yes_bid?: {
         open?: number;
         high?: number;
         low?: number;
         close?: number;
+        open_dollars?: string;
+        high_dollars?: string;
+        low_dollars?: string;
+        close_dollars?: string;
     };
     [key: string]: unknown;
 }
@@ -114,7 +137,12 @@ export interface KalshiRawTrade {
     count?: number;
     /** New API field: count as a string e.g. "424.00" */
     count_fp?: string;
-    taker_side: string;
+    /** @deprecated removal deadline May 14, 2026 */
+    taker_side?: string;
+    /** New v2 directional fields */
+    taker_outcome_side?: string;
+    taker_book_side?: string;
+    is_block_trade?: boolean;
     [key: string]: unknown;
 }
 export interface KalshiRawFill {
@@ -126,8 +154,14 @@ export interface KalshiRawFill {
     /** @deprecated Old API field */
     count?: number;
     count_fp?: string;
-    side: string;
     order_id: string;
+    /** @deprecated removal deadline May 14, 2026 */
+    side?: string;
+    /** @deprecated removal deadline May 14, 2026 */
+    action?: string;
+    /** New v2 directional fields */
+    outcome_side?: string;
+    book_side?: string;
     [key: string]: unknown;
 }
 export interface KalshiRawOrder {
@@ -174,6 +208,7 @@ export declare class KalshiFetcher implements IExchangeFetcher<KalshiRawEvent, K
     fetchRawOrders(queryParams: Record<string, any>): Promise<KalshiRawOrder[]>;
     fetchRawHistoricalOrders(queryParams: Record<string, any>): Promise<KalshiRawOrder[]>;
     fetchRawSeriesList(): Promise<KalshiRawSeries[]>;
+    fetchRawEventMetadata(eventTicker: string): Promise<Record<string, unknown>>;
     fetchRawSeriesMap(): Promise<Map<string, KalshiSeriesInfo>>;
     fetchRawEventByTicker(eventTicker: string): Promise<KalshiRawEvent[]>;
     private fetchRawEventsDefault;

package/dist/exchanges/kalshi/fetcher.js

@@ -238,6 +238,16 @@ class KalshiFetcher {
             throw errors_1.kalshiErrorMapper.mapError(e);
         }
     }
+    async fetchRawEventMetadata(eventTicker) {
+        try {
+            return this.ctx.callApi('GetEventMetadata', {
+                event_ticker: eventTicker.toUpperCase(),
+            });
+        }
+        catch (e) {
+            throw errors_1.kalshiErrorMapper.mapError(e);
+        }
+    }
     async fetchRawSeriesMap() {
         try {
             const data = await this.ctx.callApi('GetSeriesList');

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

@@ -24,6 +24,13 @@ export declare class KalshiExchange extends PredictionMarketExchange {
     protected fetchMarketsImpl(params?: MarketFilterParams): Promise<UnifiedMarket[]>;
     protected fetchEventsImpl(params: EventFetchParams): Promise<UnifiedEvent[]>;
     protected fetchSeriesImpl(params: SeriesFetchParams): Promise<UnifiedSeries[]>;
+    /**
+     * Fetch Kalshi's venue-native per-event metadata payload.
+     *
+     * This surfaces Kalshi's `GET /events/{event_ticker}/metadata` endpoint,
+     * which is distinct from the normalized `fetchEvent` response.
+     */
+    fetchEventMetadata(eventTicker: string): Promise<Record<string, unknown>>;
     fetchEventsPage(params?: EventFetchParams): Promise<{
         events: UnifiedEvent[];
         cursor: string | null;

package/dist/exchanges/kalshi/index.js

@@ -151,6 +151,15 @@ class KalshiExchange extends BaseExchange_1.PredictionMarketExchange {
         }
         return filtered;
     }
+    /**
+     * Fetch Kalshi's venue-native per-event metadata payload.
+     *
+     * This surfaces Kalshi's `GET /events/{event_ticker}/metadata` endpoint,
+     * which is distinct from the normalized `fetchEvent` response.
+     */
+    async fetchEventMetadata(eventTicker) {
+        return this.fetcher.fetchRawEventMetadata(eventTicker);
+    }
     async fetchEventsPage(params = {}) {
         const page = await this.fetcher.fetchRawEventPage(params);
         const query = (params?.query || '').toLowerCase();

package/dist/exchanges/kalshi/normalizer.js

@@ -180,24 +180,47 @@ class KalshiNormalizer {
             const p = c.price || {};
             const ask = c.yes_ask || {};
             const bid = c.yes_bid || {};
+            /**
+             * Kalshi's new candlestick API returns prices as dollar-denominated
+             * strings under `*_dollars` fields (e.g. `close_dollars: "0.9700"`).
+             * The legacy API returned integer cents under bare fields
+             * (e.g. `close: 97`). Prefer dollars when present; fall back to
+             * cents (converted via {@link fromKalshiCents}).
+             */
             const getVal = (field) => {
+                const dollarsKey = `${field}_dollars`;
+                const pd = p[dollarsKey];
+                const ad = ask[dollarsKey];
+                const bd = bid[dollarsKey];
+                if (pd != null)
+                    return Number(pd);
+                if (ad != null && bd != null) {
+                    return (Number(ad) + Number(bd)) / 2;
+                }
                 const pf = p[field];
                 const af = ask[field];
                 const bf = bid[field];
                 if (pf != null)
-                    return pf;
+                    return (0, price_1.fromKalshiCents)(pf);
                 if (af != null && bf != null) {
-                    return (af + bf) / 2;
+                    return ((0, price_1.fromKalshiCents)(af) + (0, price_1.fromKalshiCents)(bf)) / 2;
                 }
-                return p.previous || 0;
+                if (p.previous_dollars != null)
+                    return Number(p.previous_dollars);
+                if (p.previous != null)
+                    return (0, price_1.fromKalshiCents)(p.previous);
+                return 0;
             };
+            const volume = c.volume_fp != null
+                ? parseFloat(c.volume_fp) || 0
+                : (c.volume || 0);
             return {
                 timestamp: c.end_period_ts * 1000,
-                open: (0, price_1.fromKalshiCents)(getVal('open')),
-                high: (0, price_1.fromKalshiCents)(getVal('high')),
-                low: (0, price_1.fromKalshiCents)(getVal('low')),
-                close: (0, price_1.fromKalshiCents)(getVal('close')),
-                volume: c.volume || 0,
+                open: getVal('open'),
+                high: getVal('high'),
+                low: getVal('low'),
+                close: getVal('close'),
+                volume,
             };
         });
         if (params.limit && candles.length > params.limit) {
@@ -251,7 +274,8 @@ class KalshiNormalizer {
             timestamp: new Date(raw.created_time).getTime(),
             price,
             amount,
-            side: raw.taker_side === 'yes' ? 'buy' : 'sell',
+            // Support legacy taker_side, fallback to v2 taker_outcome_side
+            side: (raw.taker_side || raw.taker_outcome_side) === 'yes' ? 'buy' : 'sell',
         };
     }
     normalizeUserTrade(raw, _index) {
@@ -268,7 +292,7 @@ class KalshiNormalizer {
             timestamp: new Date(raw.created_time).getTime(),
             price,
             amount,
-            side: raw.side === 'yes' ? 'buy' : 'sell',
+            side: (raw.side || raw.outcome_side) === 'yes' ? 'buy' : 'sell',
             orderId: raw.order_id,
         };
     }

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-06-24T09:17:49.606Z
+ * Generated at: 2026-07-18T00:54:13.429Z
  * 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-06-24T09:17:49.606Z
+ * Generated at: 2026-07-18T00:54:13.429Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.limitlessApiSpec = {

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

@@ -42,6 +42,7 @@ export declare class LimitlessExchange extends PredictionMarketExchange {
     fetchPositions(address?: string): Promise<Position[]>;
     fetchBalance(address?: string): Promise<Balance[]>;
     watchOrderBook(outcomeId: string, limit?: number, _params?: Record<string, any>): Promise<OrderBook>;
+    unwatchOrderBook(outcomeId: string): Promise<void>;
     watchTrades(outcomeId: string, address?: string, since?: number, limit?: number): Promise<Trade[]>;
     /**
      * Watch AMM price updates for a market address (Limitless only).

package/dist/exchanges/limitless/index.js

@@ -423,6 +423,11 @@ class LimitlessExchange extends BaseExchange_1.PredictionMarketExchange {
         const ws = this.ensureWs();
         return ws.watchOrderBook(slug);
     }
+    async unwatchOrderBook(outcomeId) {
+        const slug = await this.resolveSlug(outcomeId);
+        const ws = this.ensureWs();
+        await ws.unsubscribe(slug);
+    }
     async watchTrades(outcomeId, address, since, limit) {
         const slug = await this.resolveSlug(outcomeId);
         const ws = this.ensureWs();

package/dist/exchanges/limitless/websocket.js

@@ -155,8 +155,12 @@ class LimitlessWebSocket {
             return await Promise.race([wsUpdatePromise, timeoutPromise]);
         }
         catch (err) {
-            // Fallback to empty orderbook if all else fails
-            return this.getEmptyOrderbook();
+            logger_1.logger.error('LimitlessWS: watchOrderBook failed', {
+                market: marketSlug,
+                error: err instanceof Error ? err.message : String(err)
+            });
+            // Do not return fake liquidity. Force the upstream loop to handle the break.
+            throw err;
         }
     }
     /**

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-06-24T09:17:49.618Z
+ * Generated at: 2026-07-18T00:54:13.441Z
  * 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-06-24T09:17:49.618Z
+ * Generated at: 2026-07-18T00:54:13.441Z
  * 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-06-24T09:17:49.621Z
+ * Generated at: 2026-07-18T00:54:13.446Z
  * 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-06-24T09:17:49.621Z
+ * Generated at: 2026-07-18T00:54:13.446Z
  * 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-06-24T09:17:49.575Z
+ * Generated at: 2026-07-18T00:54:13.392Z
  * 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-06-24T09:17:49.575Z
+ * Generated at: 2026-07-18T00:54:13.392Z
  * 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-06-24T09:17:49.588Z
+ * Generated at: 2026-07-18T00:54:13.410Z
  * 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-06-24T09:17:49.588Z
+ * Generated at: 2026-07-18T00:54:13.410Z
  * 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-06-24T09:17:49.586Z
+ * Generated at: 2026-07-18T00:54:13.407Z
  * 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-06-24T09:17:49.586Z
+ * Generated at: 2026-07-18T00:54:13.407Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketGammaSpec = {

package/dist/exchanges/polymarket_us/websocket.js

@@ -116,7 +116,23 @@ class PolymarketUSWebSocket {
             socket.on('trade', (msg) => this.handleTrade(msg));
             socket.on('error', (err) => this.handleError(err));
             socket.on('close', () => this.handleClose());
-            await socket.connect();
+            // Wrap connection in a timeout with proper garbage collection
+            const CONNECTION_TIMEOUT_MS = 15000; // 15s is standard for trading API handshakes
+            let timeoutHandle;
+            const timeoutPromise = new Promise((_, reject) => {
+                timeoutHandle = setTimeout(() => {
+                    reject(new Error(`PolymarketUS WebSocket connection timed out after ${CONNECTION_TIMEOUT_MS}ms`));
+                }, CONNECTION_TIMEOUT_MS);
+            });
+            try {
+                await Promise.race([
+                    socket.connect(),
+                    timeoutPromise
+                ]);
+            }
+            finally {
+                clearTimeout(timeoutHandle); // Always clear the timer so the event loop can breathe
+            }
             this.socket = socket;
         })();
         try {

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-06-24T09:17:49.613Z
+ * Generated at: 2026-07-18T00:54:13.436Z
  * 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-06-24T09:17:49.613Z
+ * Generated at: 2026-07-18T00:54:13.436Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

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

@@ -5,6 +5,7 @@ export declare class RainExchange extends PredictionMarketExchange {
     protected readonly capabilityOverrides: {
         fetchSeries: false;
         fetchOrderBook: "emulated";
+        fetchOrderBooks: "emulated";
         watchOrderBook: "emulated";
         watchTrades: "emulated";
         fetchOpenOrders: "emulated";
@@ -21,6 +22,7 @@ export declare class RainExchange extends PredictionMarketExchange {
     protected fetchEventsImpl(params: EventFetchParams): Promise<UnifiedEvent[]>;
     fetchOHLCV(outcomeId: string, params: OHLCVParams): Promise<PriceCandle[]>;
     fetchOrderBook(outcomeId: string, _limit?: number, _params?: Record<string, any>): Promise<OrderBook>;
+    fetchOrderBooks(outcomeIds: string[]): Promise<Record<string, OrderBook>>;
     fetchTrades(outcomeId: string, params: TradesParams | HistoryFilterParams): Promise<Trade[]>;
     fetchMyTrades(params?: MyTradesParams): Promise<UserTrade[]>;
     fetchPositions(address?: string): Promise<Position[]>;

package/dist/exchanges/rain/index.js

@@ -37,6 +37,8 @@ class RainExchange extends BaseExchange_1.PredictionMarketExchange {
     capabilityOverrides = {
         fetchSeries: false,
         fetchOrderBook: 'emulated',
+        // Emulated batch: loops the single-outcome fetchOrderBook (no native batch endpoint).
+        fetchOrderBooks: 'emulated',
         watchOrderBook: 'emulated',
         watchTrades: 'emulated',
         // Trading is on-chain via Rain SDK + viem. open/closed orders + fetchOrder
@@ -115,6 +117,13 @@ class RainExchange extends BaseExchange_1.PredictionMarketExchange {
             return { bids: [], asks: [], timestamp: Date.now() };
         return this.normalizer.normalizeOrderBook(raw, outcomeId);
     }
+    async fetchOrderBooks(outcomeIds) {
+        const response = {};
+        for (const outcomeId of outcomeIds) {
+            response[outcomeId] = await this.fetchOrderBook(outcomeId);
+        }
+        return response;
+    }
     async fetchTrades(outcomeId, params) {
         const parts = outcomeId.split(':');
         if (parts.length < 2) {

package/dist/exchanges/smarkets/normalizer.js

@@ -48,6 +48,13 @@ function buildContractOutcome(contract, marketId) {
         price: 0,
     };
 }
+function parseSmarketsResolutionDate(event) {
+    // Smarkets list and detail endpoints currently return end_date as null for
+    // many events. start_datetime is an event start, not a market resolution,
+    // so leave the unified resolution date unset instead of using a misleading
+    // fallback that can corrupt cross-venue ordering.
+    return event.end_date ? new Date(event.end_date) : undefined;
+}
 // ----------------------------------------------------------------------------
 // Normalizer
 // ----------------------------------------------------------------------------
@@ -87,12 +94,7 @@ class SmarketsNormalizer {
                     tags.push(cat);
             }
         }
-        // Derive resolution date from event end_date or start_datetime
-        const resolutionDate = event.end_date
-            ? new Date(event.end_date)
-            : event.start_datetime
-                ? new Date(event.start_datetime)
-                : new Date();
+        const resolutionDate = parseSmarketsResolutionDate(event);
         const um = {
             marketId: market.id,
             eventId: event.id,

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

@@ -11,5 +11,4 @@
  *   GET /api/p2p/offers          - List open P2P offers (status, matchId, sport, limit, offset)
  *   GET /api/p2p/offers/:id      - Get a single P2P offer by ID
  *   GET /api/p2p/my?wallet=...   - Get user activity (created offers, matched bets, parlays)
- *   GET /api/events/upcoming     - List upcoming sports events (sport, limit)
  */

package/dist/exchanges/suibets/api.js

@@ -12,6 +12,5 @@
  *   GET /api/p2p/offers          - List open P2P offers (status, matchId, sport, limit, offset)
  *   GET /api/p2p/offers/:id      - Get a single P2P offer by ID
  *   GET /api/p2p/my?wallet=...   - Get user activity (created offers, matched bets, parlays)
- *   GET /api/events/upcoming     - List upcoming sports events (sport, limit)
  */
 // No runtime exports — this file serves as API documentation only.

package/dist/exchanges/suibets/fetcher.d.ts

@@ -21,6 +21,12 @@ export interface SuibetsRawOffer {
     isOnchain?: boolean;
     onchainOfferId?: string;
     leagueName?: string;
+    onchainState?: {
+        makerRemaining?: string;
+        totalLiquidity?: string;
+        filledAmount?: string;
+        status?: string;
+    };
 }
 export interface SuibetsRawEvent {
     id: string;

package/dist/exchanges/suibets/normalizer.js

@@ -3,7 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SuibetsNormalizer = void 0;
 const utils_1 = require("./utils");
 function liquidity(offer) {
-    const remaining = offer.remainingStake ?? offer.creatorStake;
+    // Prioritize live onchainState.makerRemaining data before falling back to legacy fields
+    const remaining = offer.onchainState?.makerRemaining ?? offer.remainingStake ?? offer.creatorStake;
     return (0, utils_1.mistToSui)(remaining);
 }
 class SuibetsNormalizer {

package/dist/server/method-verbs.json

@@ -79,6 +79,16 @@
       }
     ]
   },
+  "fetchEventMetadata": {
+    "verb": "get",
+    "args": [
+      {
+        "name": "eventTicker",
+        "kind": "string",
+        "optional": false
+      }
+    ]
+  },
   "fetchOHLCV": {
     "verb": "get",
     "args": [

package/dist/server/openapi.yaml

@@ -2,8 +2,8 @@ openapi: 3.0.0
 info:
   title: PMXT Sidecar API
   description: >-
-    A unified local sidecar API for prediction markets (Polymarket, Kalshi, Limitless). This API acts as a
-    JSON-RPC-style gateway. Each endpoint corresponds to a specific method on the generic exchange implementation.
+    A unified local sidecar API for supported prediction markets. This API acts as a JSON-RPC-style gateway over PMXT
+    exchange implementations, with venue and write support varying by method and capability.
   version: 0.4.4
 servers:
   - url: 'http://localhost:3847'
@@ -680,6 +680,33 @@ paths:
       description: >-
         Fetch a single event by lookup parameters. Convenience wrapper around fetchEvents() that returns a single result
         or throws EventNotFound.
+  '/api/{exchange}/fetchEventMetadata':
+    get:
+      summary: Fetch Event Metadata
+      operationId: fetchEventMetadata
+      parameters:
+        - $ref: '#/components/parameters/ExchangeParam'
+        - in: query
+          name: eventTicker
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: Fetch Event Metadata response
+          content:
+            application/json:
+              schema:
+                allOf:
+                  - $ref: '#/components/schemas/BaseResponse'
+                  - type: object
+                    properties:
+                      data:
+                        type: object
+                        additionalProperties: {}
+      description: >-
+        Fetch venue-native metadata for a specific event when the exchange exposes a dedicated metadata endpoint. Kalshi
+        implements this for `GET /events/{event_ticker}/metadata`.
   '/api/{exchange}/fetchOHLCV':
     get:
       summary: Fetch OHLCV
@@ -3654,6 +3681,12 @@ components:
         fee:
           type: number
           description: 'Optional fee rate (e.g., 1000 for 0.1%)'
+        builder:
+          type: string
+          description: Hyperliquid builder address to attach to the order action.
+        builderFee:
+          type: number
+          description: Hyperliquid builder fee in tenths of a basis point (e.g. 10 = 1 bp).
         tickSize:
           type: number
           description: Optional override for Limitless/Polymarket

package/dist/types.d.ts

@@ -290,6 +290,10 @@ export interface CreateOrderParams {
     denom?: 'usdc' | 'shares';
     slippage_pct?: number;
     fee?: number;
+    /** Hyperliquid builder address to attach to the order action. */
+    builder?: string;
+    /** Hyperliquid builder fee in tenths of a basis point (e.g. 10 = 1 bp). */
+    builderFee?: number;
     tickSize?: number;
     negRisk?: boolean;
     onBehalfOf?: number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pmxt-core",
-  "version": "2.51.3",
-  "description": "pmxt is a unified prediction market data API. The ccxt for prediction markets.",
+  "version": "2.52.0",
+  "description": "Local sidecar API for supported prediction markets.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "repository": {
@@ -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.51.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.51.3,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.52.0,library=urllib3",
+    "generate:sdk:typescript": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g typescript-fetch -o ../sdks/typescript/generated --additional-properties=npmName=pmxtjs,npmVersion=2.52.0,supportsES6=true,typescriptThreePlus=true && node ../sdks/typescript/scripts/fix-generated.js",
     "fetch:openapi": "node scripts/fetch-openapi-specs.js",
     "extract:jsdoc": "node ../scripts/extract-jsdoc.js",
     "generate:docs": "npm run extract:jsdoc && node ../scripts/generate-api-docs.js",