pmxtjs 2.49.6 → 2.49.8

package/dist/esm/generated/src/models/OrderBook.d.ts

@@ -40,6 +40,26 @@ export interface OrderBook {
      * @memberof OrderBook
      */
     datetime?: string;
+    /**
+     * Whether the venue marks this snapshot as a negative-risk market.
+     * @type {boolean}
+     * @memberof OrderBook
+     */
+    isNegRisk?: boolean;
+    /**
+     * Last traded price from venues that include it with the book snapshot.
+     * @type {number}
+     * @memberof OrderBook
+     */
+    lastTradePrice?: number;
+    /**
+     * Venue-specific metadata preserved from the raw order book snapshot.
+     * @type {{ [key: string]: any; }}
+     * @memberof OrderBook
+     */
+    sourceMetadata?: {
+        [key: string]: any;
+    };
 }
 /**
  * Check if a given object implements the OrderBook interface.

package/dist/esm/generated/src/models/OrderBook.js

@@ -34,6 +34,9 @@ export function OrderBookFromJSONTyped(json, ignoreDiscriminator) {
         'asks': (json['asks'].map(OrderLevelFromJSON)),
         'timestamp': json['timestamp'] == null ? undefined : json['timestamp'],
         'datetime': json['datetime'] == null ? undefined : json['datetime'],
+        'isNegRisk': json['isNegRisk'] == null ? undefined : json['isNegRisk'],
+        'lastTradePrice': json['lastTradePrice'] == null ? undefined : json['lastTradePrice'],
+        'sourceMetadata': json['sourceMetadata'] == null ? undefined : json['sourceMetadata'],
     };
 }
 export function OrderBookToJSON(json) {
@@ -48,5 +51,8 @@ export function OrderBookToJSONTyped(value, ignoreDiscriminator = false) {
         'asks': (value['asks'].map(OrderLevelToJSON)),
         'timestamp': value['timestamp'],
         'datetime': value['datetime'],
+        'isNegRisk': value['isNegRisk'],
+        'lastTradePrice': value['lastTradePrice'],
+        'sourceMetadata': value['sourceMetadata'],
     };
 }

package/dist/esm/index.d.ts

@@ -23,7 +23,7 @@ import { ServerManager } from "./pmxt/server-manager.js";
 import { FeedClient } from "./pmxt/feed-client.js";
 import * as models from "./pmxt/models.js";
 import * as errors from "./pmxt/errors.js";
-export { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Mock, PolymarketOptions } from "./pmxt/client.js";
+export { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Suibets, Mock, PolymarketOptions } from "./pmxt/client.js";
 export { FeedClient } from "./pmxt/feed-client.js";
 export type { Ticker, Tickers, OHLCV, Market as FeedMarket, OracleRound, FeedClientOptions } from "./pmxt/feed-client.js";
 export { Router } from "./pmxt/router.js";
@@ -95,6 +95,7 @@ declare const pmxt: {
     GeminiTitan: typeof GeminiTitan;
     Hyperliquid: typeof Hyperliquid;
     SuiBets: typeof SuiBets;
+    Suibets: typeof SuiBets;
     Mock: typeof Mock;
     Router: typeof Router;
     ServerManager: typeof ServerManager;

package/dist/esm/index.js

@@ -17,13 +17,13 @@
  * console.log(markets[0].title);
  * ```
  */
-import { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Mock } from "./pmxt/client.js";
+import { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Suibets, Mock } from "./pmxt/client.js";
 import { Router } from "./pmxt/router.js";
 import { ServerManager } from "./pmxt/server-manager.js";
 import { FeedClient } from "./pmxt/feed-client.js";
 import * as models from "./pmxt/models.js";
 import * as errors from "./pmxt/errors.js";
-export { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Mock } from "./pmxt/client.js";
+export { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Suibets, Mock } from "./pmxt/client.js";
 export { FeedClient } from "./pmxt/feed-client.js";
 export { Router } from "./pmxt/router.js";
 export { ServerManager } from "./pmxt/server-manager.js";
@@ -76,6 +76,7 @@ const pmxt = {
     GeminiTitan,
     Hyperliquid,
     SuiBets,
+    Suibets,
     Mock,
     Router,
     ServerManager,

package/dist/esm/pmxt/client.d.ts

@@ -837,6 +837,7 @@ export declare class SuiBets extends Exchange {
      */
     protected getCredentials(): ExchangeCredentials | undefined;
 }
+export declare const Suibets: typeof SuiBets;
 /**
  * Mock exchange client.
  *

package/dist/esm/pmxt/client.js

@@ -10,6 +10,7 @@ import { ServerManager } from "./server-manager.js";
 import { PmxtError, fromServerError, InvalidOrder, NotSupported } from "./errors.js";
 import { resolvePmxtBaseUrl } from "./constants.js";
 import { SidecarWsClient } from "./ws-client.js";
+import { logger } from "./logger.js";
 // Hosted-mode trading dispatch.
 // These modules are introduced as part of the hosted trading mode rollout.
 // Some of them may be authored by parallel agents; until they all land, the
@@ -364,8 +365,8 @@ export class Exchange {
                     try {
                         await this.serverManager.ensureServerRunning();
                     }
-                    catch {
-                        // Restart failed — continue retrying anyway
+                    catch (err) {
+                        logger.warn('PmxtClient: server restart failed during retry', { attempt, error: String(err) });
                     }
                 }
                 await new Promise(resolve => setTimeout(resolve, delays[attempt]));
@@ -405,7 +406,8 @@ export class Exchange {
                 throw new Error("WS handshake failed");
             }
         }
-        catch {
+        catch (err) {
+            logger.warn('PmxtClient: WebSocket probe failed, falling back to HTTP', { error: String(err) });
             this._wsUnsupported = true;
             client.close();
             return null;
@@ -923,6 +925,9 @@ export class Exchange {
             return this._hostedSubmitOrder(built);
         }
         await this.initPromise;
+        if (this.isHosted) {
+            throw new PmxtError("submitOrder is not available in hosted mode. Use createOrder instead.");
+        }
         try {
             const args = [];
             args.push(built);
@@ -2111,7 +2116,8 @@ export class Exchange {
                         this._hostedAccount = {};
                     }
                 }
-                catch {
+                catch (err) {
+                    logger.warn('PmxtClient: hosted account discovery failed', { error: String(err) });
                     this._hostedAccount = {};
                 }
             })();
@@ -2988,6 +2994,8 @@ export class SuiBets extends Exchange {
         };
     }
 }
+// Backwards-compatible casing alias matching the Python SDK export.
+export const Suibets = SuiBets;
 /**
  * Mock exchange client.
  *

package/dist/esm/pmxt/hosted-mappers.js

@@ -96,7 +96,11 @@ export function userTradeFromV0(payload) {
     const trade = {
         id: strOrEmpty(payload["id"]),
         price: floatOrZero(payload["price"]),
-        amount: floatOrZero(payload["amount"]),
+        // The v0 wire sends trade amounts in 6-dec micro-shares (verified
+        // live: 58139533.0 == 58.139533 shares, matching the same position's
+        // decimal `shares`). Normalize so UserTrade.amount means shares,
+        // like everywhere else in the SDK.
+        amount: floatOrZero(payload["amount"]) / 1_000_000,
         side,
         timestamp: timestampToMs(payload["timestamp"]),
     };
@@ -116,7 +120,8 @@ export function userTradeToV0(trade) {
     const out = {
         id: trade.id,
         side: trade.side,
-        amount: trade.amount,
+        // Inverse of userTradeFromV0: decimal shares -> 6-dec micro-shares.
+        amount: Math.round(trade.amount * 1_000_000),
         price: trade.price,
         timestamp: msToTimestamp(trade.timestamp),
     };

package/dist/esm/pmxt/hosted-typed-data.js

@@ -313,6 +313,18 @@ const SIX_DEC_DIVISOR = 1_000_000;
 function validateWorstPrice(message, route, buildRequest, buildResponse) {
     const worstPriceMicro = messageBigInt(message, "worst_price", "worstPrice");
     const worstPrice = Number(worstPriceMicro) / SIX_DEC_DIVISOR;
+    // Hosted MARKET orders pin worst_price to the tick-grid extreme by
+    // design ("textbook market semantics"): the binding user protection is
+    // max_cost_usdc (buys) / shares_6dec (sells), validated above. A
+    // slippage bound on worst_price would reject every server-built market
+    // order, so only sanity-check the price domain here.
+    const orderType = String(firstPresent(getField(buildRequest, "order_type"), getField(buildRequest, "orderType"), "market")).toLowerCase();
+    if (orderType === "market") {
+        if (!(worstPrice > 0 && worstPrice < 1)) {
+            economicFail(`worst_price expected within (0, 1) got ${worstPrice}`);
+        }
+        return;
+    }
     const slippagePctRaw = firstPresent(getField(buildRequest, "slippage_pct"), getField(buildRequest, "slippagePct"), getField(buildResponse, "slippage_pct"), getField(buildResponse, "slippagePct"), 20);
     const slippagePct = toFiniteNumber(slippagePctRaw, "slippage_pct");
     if (route === "polymarket_buy") {

package/dist/esm/pmxt/router.d.ts

@@ -44,6 +44,8 @@ export declare class Router extends Exchange {
         marketId?: string;
         slug?: string;
         url?: string;
+        query?: string;
+        category?: string;
         relation?: MatchRelation;
         minConfidence?: number;
         limit?: number;
@@ -58,6 +60,8 @@ export declare class Router extends Exchange {
         marketId?: string;
         slug?: string;
         url?: string;
+        query?: string;
+        category?: string;
         relation?: MatchRelation;
         minConfidence?: number;
         limit?: number;
@@ -73,6 +77,8 @@ export declare class Router extends Exchange {
         event?: UnifiedEvent;
         eventId?: string;
         slug?: string;
+        query?: string;
+        category?: string;
         relation?: MatchRelation;
         minConfidence?: number;
         limit?: number;

package/dist/esm/pmxt/router.js

@@ -166,6 +166,10 @@ export class Router extends Exchange {
             query.slug = params.slug ?? params.market?.slug;
         if (params.url)
             query.url = params.url;
+        if (params.query)
+            query.query = params.query;
+        if (params.category)
+            query.category = params.category;
         if (params.relation)
             query.relation = params.relation;
         if (params.minConfidence !== undefined)
@@ -203,6 +207,10 @@ export class Router extends Exchange {
             query.eventId = eventId;
         if (params.slug ?? params.event?.slug)
             query.slug = params.slug ?? params.event?.slug;
+        if (params.query)
+            query.query = params.query;
+        if (params.category)
+            query.category = params.category;
         if (params.relation)
             query.relation = params.relation;
         if (params.minConfidence !== undefined)

package/dist/esm/pmxt/server-manager.js

@@ -7,6 +7,7 @@ import { DefaultApi, Configuration } from "../generated/src/index.js";
 import { readFileSync, existsSync } from "fs";
 import { homedir } from "os";
 import { join, dirname } from "path";
+import { logger } from "./logger.js";
 export class ServerManager {
     baseUrl;
     maxRetries;
@@ -123,8 +124,8 @@ export class ServerManager {
                             return;
                     }
                 }
-                catch {
-                    // Not ready yet
+                catch (err) {
+                    logger.debug('server-manager: health poll error', { error: String(err) });
                 }
             }
             await new Promise((resolve) => setTimeout(resolve, this.retryDelayMs));
@@ -230,8 +231,8 @@ export class ServerManager {
                 }
             }
         }
-        catch {
-            // Ignore errors
+        catch (err) {
+            logger.warn('server-manager: version check failed', { error: String(err) });
         }
         return false;
     }
@@ -343,6 +344,9 @@ export class ServerManager {
             const { unlinkSync } = await import('fs');
             unlinkSync(this.lockPath);
         }
-        catch { }
+        catch (err) {
+            // Best-effort — expected when file was already removed.
+            logger.debug('server-manager: lock file removal failed', { path: this.lockPath, error: String(err) });
+        }
     }
 }

package/dist/esm/pmxt/ws-client.js

@@ -273,8 +273,8 @@ export class SidecarWsClient {
             try {
                 this.ws.close();
             }
-            catch {
-                // ignore
+            catch (err) {
+                logger.debug('[SidecarWsClient] error during ws.close()', { error: String(err) });
             }
             this.ws = null;
         }

package/dist/generated/src/models/OrderBook.d.ts

@@ -40,6 +40,26 @@ export interface OrderBook {
      * @memberof OrderBook
      */
     datetime?: string;
+    /**
+     * Whether the venue marks this snapshot as a negative-risk market.
+     * @type {boolean}
+     * @memberof OrderBook
+     */
+    isNegRisk?: boolean;
+    /**
+     * Last traded price from venues that include it with the book snapshot.
+     * @type {number}
+     * @memberof OrderBook
+     */
+    lastTradePrice?: number;
+    /**
+     * Venue-specific metadata preserved from the raw order book snapshot.
+     * @type {{ [key: string]: any; }}
+     * @memberof OrderBook
+     */
+    sourceMetadata?: {
+        [key: string]: any;
+    };
 }
 /**
  * Check if a given object implements the OrderBook interface.

package/dist/generated/src/models/OrderBook.js

@@ -41,6 +41,9 @@ function OrderBookFromJSONTyped(json, ignoreDiscriminator) {
         'asks': (json['asks'].map(OrderLevel_1.OrderLevelFromJSON)),
         'timestamp': json['timestamp'] == null ? undefined : json['timestamp'],
         'datetime': json['datetime'] == null ? undefined : json['datetime'],
+        'isNegRisk': json['isNegRisk'] == null ? undefined : json['isNegRisk'],
+        'lastTradePrice': json['lastTradePrice'] == null ? undefined : json['lastTradePrice'],
+        'sourceMetadata': json['sourceMetadata'] == null ? undefined : json['sourceMetadata'],
     };
 }
 function OrderBookToJSON(json) {
@@ -55,5 +58,8 @@ function OrderBookToJSONTyped(value, ignoreDiscriminator = false) {
         'asks': (value['asks'].map(OrderLevel_1.OrderLevelToJSON)),
         'timestamp': value['timestamp'],
         'datetime': value['datetime'],
+        'isNegRisk': value['isNegRisk'],
+        'lastTradePrice': value['lastTradePrice'],
+        'sourceMetadata': value['sourceMetadata'],
     };
 }

package/dist/index.d.ts

@@ -23,7 +23,7 @@ import { ServerManager } from "./pmxt/server-manager.js";
 import { FeedClient } from "./pmxt/feed-client.js";
 import * as models from "./pmxt/models.js";
 import * as errors from "./pmxt/errors.js";
-export { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Mock, PolymarketOptions } from "./pmxt/client.js";
+export { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Suibets, Mock, PolymarketOptions } from "./pmxt/client.js";
 export { FeedClient } from "./pmxt/feed-client.js";
 export type { Ticker, Tickers, OHLCV, Market as FeedMarket, OracleRound, FeedClientOptions } from "./pmxt/feed-client.js";
 export { Router } from "./pmxt/router.js";
@@ -95,6 +95,7 @@ declare const pmxt: {
     GeminiTitan: typeof GeminiTitan;
     Hyperliquid: typeof Hyperliquid;
     SuiBets: typeof SuiBets;
+    Suibets: typeof SuiBets;
     Mock: typeof Mock;
     Router: typeof Router;
     ServerManager: typeof ServerManager;

package/dist/index.js

@@ -55,7 +55,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.server = exports.MarketList = exports.resolvePmxtBaseUrl = exports.ENV = exports.LOCAL_URL = exports.HOSTED_URL = exports.ServerManager = exports.Router = exports.FeedClient = exports.Mock = exports.SuiBets = exports.Hyperliquid = exports.GeminiTitan = exports.PolymarketUS = exports.Smarkets = exports.Metaculus = exports.Opinion = exports.Baozi = exports.Probable = exports.Myriad = exports.Limitless = exports.KalshiDemo = exports.Kalshi = exports.Polymarket = exports.Exchange = void 0;
+exports.server = exports.MarketList = exports.resolvePmxtBaseUrl = exports.ENV = exports.LOCAL_URL = exports.HOSTED_URL = exports.ServerManager = exports.Router = exports.FeedClient = exports.Mock = exports.Suibets = exports.SuiBets = exports.Hyperliquid = exports.GeminiTitan = exports.PolymarketUS = exports.Smarkets = exports.Metaculus = exports.Opinion = exports.Baozi = exports.Probable = exports.Myriad = exports.Limitless = exports.KalshiDemo = exports.Kalshi = exports.Polymarket = exports.Exchange = void 0;
 const client_js_1 = require("./pmxt/client.js");
 const router_js_1 = require("./pmxt/router.js");
 const server_manager_js_1 = require("./pmxt/server-manager.js");
@@ -78,6 +78,7 @@ Object.defineProperty(exports, "PolymarketUS", { enumerable: true, get: function
 Object.defineProperty(exports, "GeminiTitan", { enumerable: true, get: function () { return client_js_2.GeminiTitan; } });
 Object.defineProperty(exports, "Hyperliquid", { enumerable: true, get: function () { return client_js_2.Hyperliquid; } });
 Object.defineProperty(exports, "SuiBets", { enumerable: true, get: function () { return client_js_2.SuiBets; } });
+Object.defineProperty(exports, "Suibets", { enumerable: true, get: function () { return client_js_2.Suibets; } });
 Object.defineProperty(exports, "Mock", { enumerable: true, get: function () { return client_js_2.Mock; } });
 var feed_client_js_2 = require("./pmxt/feed-client.js");
 Object.defineProperty(exports, "FeedClient", { enumerable: true, get: function () { return feed_client_js_2.FeedClient; } });
@@ -139,6 +140,7 @@ const pmxt = {
     GeminiTitan: client_js_1.GeminiTitan,
     Hyperliquid: client_js_1.Hyperliquid,
     SuiBets: client_js_1.SuiBets,
+    Suibets: client_js_1.Suibets,
     Mock: client_js_1.Mock,
     Router: router_js_1.Router,
     ServerManager: server_manager_js_1.ServerManager,

package/dist/pmxt/client.d.ts

@@ -837,6 +837,7 @@ export declare class SuiBets extends Exchange {
      */
     protected getCredentials(): ExchangeCredentials | undefined;
 }
+export declare const Suibets: typeof SuiBets;
 /**
  * Mock exchange client.
  *

package/dist/pmxt/client.js

@@ -6,13 +6,14 @@
  * OpenAPI client, matching the Python API exactly.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Mock = exports.SuiBets = exports.Hyperliquid = exports.GeminiTitan = exports.PolymarketUS = exports.Smarkets = exports.Metaculus = exports.Opinion = exports.Baozi = exports.Probable = exports.Myriad = exports.KalshiDemo = exports.Limitless = exports.Kalshi = exports.Polymarket = exports.Exchange = void 0;
+exports.Mock = exports.Suibets = exports.SuiBets = exports.Hyperliquid = exports.GeminiTitan = exports.PolymarketUS = exports.Smarkets = exports.Metaculus = exports.Opinion = exports.Baozi = exports.Probable = exports.Myriad = exports.KalshiDemo = exports.Limitless = exports.Kalshi = exports.Polymarket = exports.Exchange = void 0;
 const index_js_1 = require("../generated/src/index.js");
 const models_js_1 = require("./models.js");
 const server_manager_js_1 = require("./server-manager.js");
 const errors_js_1 = require("./errors.js");
 const constants_js_1 = require("./constants.js");
 const ws_client_js_1 = require("./ws-client.js");
+const logger_js_1 = require("./logger.js");
 // Hosted-mode trading dispatch.
 // These modules are introduced as part of the hosted trading mode rollout.
 // Some of them may be authored by parallel agents; until they all land, the
@@ -367,8 +368,8 @@ class Exchange {
                     try {
                         await this.serverManager.ensureServerRunning();
                     }
-                    catch {
-                        // Restart failed — continue retrying anyway
+                    catch (err) {
+                        logger_js_1.logger.warn('PmxtClient: server restart failed during retry', { attempt, error: String(err) });
                     }
                 }
                 await new Promise(resolve => setTimeout(resolve, delays[attempt]));
@@ -408,7 +409,8 @@ class Exchange {
                 throw new Error("WS handshake failed");
             }
         }
-        catch {
+        catch (err) {
+            logger_js_1.logger.warn('PmxtClient: WebSocket probe failed, falling back to HTTP', { error: String(err) });
             this._wsUnsupported = true;
             client.close();
             return null;
@@ -926,6 +928,9 @@ class Exchange {
             return this._hostedSubmitOrder(built);
         }
         await this.initPromise;
+        if (this.isHosted) {
+            throw new errors_js_1.PmxtError("submitOrder is not available in hosted mode. Use createOrder instead.");
+        }
         try {
             const args = [];
             args.push(built);
@@ -2114,7 +2119,8 @@ class Exchange {
                         this._hostedAccount = {};
                     }
                 }
-                catch {
+                catch (err) {
+                    logger_js_1.logger.warn('PmxtClient: hosted account discovery failed', { error: String(err) });
                     this._hostedAccount = {};
                 }
             })();
@@ -3006,6 +3012,8 @@ class SuiBets extends Exchange {
     }
 }
 exports.SuiBets = SuiBets;
+// Backwards-compatible casing alias matching the Python SDK export.
+exports.Suibets = SuiBets;
 /**
  * Mock exchange client.
  *

package/dist/pmxt/hosted-mappers.js

@@ -107,7 +107,11 @@ function userTradeFromV0(payload) {
     const trade = {
         id: strOrEmpty(payload["id"]),
         price: floatOrZero(payload["price"]),
-        amount: floatOrZero(payload["amount"]),
+        // The v0 wire sends trade amounts in 6-dec micro-shares (verified
+        // live: 58139533.0 == 58.139533 shares, matching the same position's
+        // decimal `shares`). Normalize so UserTrade.amount means shares,
+        // like everywhere else in the SDK.
+        amount: floatOrZero(payload["amount"]) / 1_000_000,
         side,
         timestamp: timestampToMs(payload["timestamp"]),
     };
@@ -127,7 +131,8 @@ function userTradeToV0(trade) {
     const out = {
         id: trade.id,
         side: trade.side,
-        amount: trade.amount,
+        // Inverse of userTradeFromV0: decimal shares -> 6-dec micro-shares.
+        amount: Math.round(trade.amount * 1_000_000),
         price: trade.price,
         timestamp: msToTimestamp(trade.timestamp),
     };

package/dist/pmxt/hosted-typed-data.js

@@ -352,6 +352,18 @@ const SIX_DEC_DIVISOR = 1_000_000;
 function validateWorstPrice(message, route, buildRequest, buildResponse) {
     const worstPriceMicro = messageBigInt(message, "worst_price", "worstPrice");
     const worstPrice = Number(worstPriceMicro) / SIX_DEC_DIVISOR;
+    // Hosted MARKET orders pin worst_price to the tick-grid extreme by
+    // design ("textbook market semantics"): the binding user protection is
+    // max_cost_usdc (buys) / shares_6dec (sells), validated above. A
+    // slippage bound on worst_price would reject every server-built market
+    // order, so only sanity-check the price domain here.
+    const orderType = String(firstPresent(getField(buildRequest, "order_type"), getField(buildRequest, "orderType"), "market")).toLowerCase();
+    if (orderType === "market") {
+        if (!(worstPrice > 0 && worstPrice < 1)) {
+            economicFail(`worst_price expected within (0, 1) got ${worstPrice}`);
+        }
+        return;
+    }
     const slippagePctRaw = firstPresent(getField(buildRequest, "slippage_pct"), getField(buildRequest, "slippagePct"), getField(buildResponse, "slippage_pct"), getField(buildResponse, "slippagePct"), 20);
     const slippagePct = toFiniteNumber(slippagePctRaw, "slippage_pct");
     if (route === "polymarket_buy") {

package/dist/pmxt/router.d.ts

@@ -44,6 +44,8 @@ export declare class Router extends Exchange {
         marketId?: string;
         slug?: string;
         url?: string;
+        query?: string;
+        category?: string;
         relation?: MatchRelation;
         minConfidence?: number;
         limit?: number;
@@ -58,6 +60,8 @@ export declare class Router extends Exchange {
         marketId?: string;
         slug?: string;
         url?: string;
+        query?: string;
+        category?: string;
         relation?: MatchRelation;
         minConfidence?: number;
         limit?: number;
@@ -73,6 +77,8 @@ export declare class Router extends Exchange {
         event?: UnifiedEvent;
         eventId?: string;
         slug?: string;
+        query?: string;
+        category?: string;
         relation?: MatchRelation;
         minConfidence?: number;
         limit?: number;

package/dist/pmxt/router.js

@@ -202,6 +202,10 @@ class Router extends client_js_1.Exchange {
             query.slug = params.slug ?? params.market?.slug;
         if (params.url)
             query.url = params.url;
+        if (params.query)
+            query.query = params.query;
+        if (params.category)
+            query.category = params.category;
         if (params.relation)
             query.relation = params.relation;
         if (params.minConfidence !== undefined)
@@ -239,6 +243,10 @@ class Router extends client_js_1.Exchange {
             query.eventId = eventId;
         if (params.slug ?? params.event?.slug)
             query.slug = params.slug ?? params.event?.slug;
+        if (params.query)
+            query.query = params.query;
+        if (params.category)
+            query.category = params.category;
         if (params.relation)
             query.relation = params.relation;
         if (params.minConfidence !== undefined)

package/dist/pmxt/server-manager.js

@@ -43,6 +43,7 @@ const index_js_1 = require("../generated/src/index.js");
 const fs_1 = require("fs");
 const os_1 = require("os");
 const path_1 = require("path");
+const logger_js_1 = require("./logger.js");
 class ServerManager {
     baseUrl;
     maxRetries;
@@ -159,8 +160,8 @@ class ServerManager {
                             return;
                     }
                 }
-                catch {
-                    // Not ready yet
+                catch (err) {
+                    logger_js_1.logger.debug('server-manager: health poll error', { error: String(err) });
                 }
             }
             await new Promise((resolve) => setTimeout(resolve, this.retryDelayMs));
@@ -266,8 +267,8 @@ class ServerManager {
                 }
             }
         }
-        catch {
-            // Ignore errors
+        catch (err) {
+            logger_js_1.logger.warn('server-manager: version check failed', { error: String(err) });
         }
         return false;
     }
@@ -379,7 +380,10 @@ class ServerManager {
             const { unlinkSync } = await Promise.resolve().then(() => __importStar(require('fs')));
             unlinkSync(this.lockPath);
         }
-        catch { }
+        catch (err) {
+            // Best-effort — expected when file was already removed.
+            logger_js_1.logger.debug('server-manager: lock file removal failed', { path: this.lockPath, error: String(err) });
+        }
     }
 }
 exports.ServerManager = ServerManager;

package/dist/pmxt/ws-client.js

@@ -276,8 +276,8 @@ class SidecarWsClient {
             try {
                 this.ws.close();
             }
-            catch {
-                // ignore
+            catch (err) {
+                logger_js_1.logger.debug('[SidecarWsClient] error during ws.close()', { error: String(err) });
             }
             this.ws = null;
         }

package/generated/docs/GetExecutionPriceRequestArgsInner.md

@@ -10,6 +10,9 @@ Name | Type
 `asks` | [Array<OrderLevel>](OrderLevel.md)
 `timestamp` | number
 `datetime` | string
+`isNegRisk` | boolean
+`lastTradePrice` | number
+`sourceMetadata` | { [key: string]: object; }
 
 ## Example
 
@@ -22,6 +25,9 @@ const example = {
   "asks": null,
   "timestamp": null,
   "datetime": null,
+  "isNegRisk": null,
+  "lastTradePrice": null,
+  "sourceMetadata": null,
 } satisfies GetExecutionPriceRequestArgsInner
 
 console.log(example)

package/generated/docs/OrderBook.md

@@ -10,6 +10,9 @@ Name | Type
 `asks` | [Array<OrderLevel>](OrderLevel.md)
 `timestamp` | number
 `datetime` | string
+`isNegRisk` | boolean
+`lastTradePrice` | number
+`sourceMetadata` | { [key: string]: any; }
 
 ## Example
 
@@ -22,6 +25,9 @@ const example = {
   "asks": null,
   "timestamp": null,
   "datetime": null,
+  "isNegRisk": null,
+  "lastTradePrice": null,
+  "sourceMetadata": null,
 } satisfies OrderBook
 
 console.log(example)

package/generated/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxtjs",
-  "version": "2.49.6",
+  "version": "2.49.8",
   "description": "OpenAPI client for pmxtjs",
   "author": "OpenAPI-Generator",
   "repository": {

package/generated/src/models/OrderBook.ts

@@ -51,6 +51,24 @@ export interface OrderBook {
      * @memberof OrderBook
      */
     datetime?: string;
+    /**
+     * Whether the venue marks this snapshot as a negative-risk market.
+     * @type {boolean}
+     * @memberof OrderBook
+     */
+    isNegRisk?: boolean;
+    /**
+     * Last traded price from venues that include it with the book snapshot.
+     * @type {number}
+     * @memberof OrderBook
+     */
+    lastTradePrice?: number;
+    /**
+     * Venue-specific metadata preserved from the raw order book snapshot.
+     * @type {{ [key: string]: any; }}
+     * @memberof OrderBook
+     */
+    sourceMetadata?: { [key: string]: any; };
 }
 
 /**
@@ -76,6 +94,9 @@ export function OrderBookFromJSONTyped(json: any, ignoreDiscriminator: boolean):
         'asks': ((json['asks'] as Array<any>).map(OrderLevelFromJSON)),
         'timestamp': json['timestamp'] == null ? undefined : json['timestamp'],
         'datetime': json['datetime'] == null ? undefined : json['datetime'],
+        'isNegRisk': json['isNegRisk'] == null ? undefined : json['isNegRisk'],
+        'lastTradePrice': json['lastTradePrice'] == null ? undefined : json['lastTradePrice'],
+        'sourceMetadata': json['sourceMetadata'] == null ? undefined : json['sourceMetadata'],
     };
 }
 
@@ -94,6 +115,9 @@ export function OrderBookToJSONTyped(value?: OrderBook | null, ignoreDiscriminat
         'asks': ((value['asks'] as Array<any>).map(OrderLevelToJSON)),
         'timestamp': value['timestamp'],
         'datetime': value['datetime'],
+        'isNegRisk': value['isNegRisk'],
+        'lastTradePrice': value['lastTradePrice'],
+        'sourceMetadata': value['sourceMetadata'],
     };
 }
 

package/index.ts

@@ -19,14 +19,14 @@
  */
 
 
-import { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Mock } from "./pmxt/client.js";
+import { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Suibets, Mock } from "./pmxt/client.js";
 import { Router } from "./pmxt/router.js";
 import { ServerManager } from "./pmxt/server-manager.js";
 import { FeedClient } from "./pmxt/feed-client.js";
 import * as models from "./pmxt/models.js";
 import * as errors from "./pmxt/errors.js";
 
-export { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Mock, PolymarketOptions } from "./pmxt/client.js";
+export { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Suibets, Mock, PolymarketOptions } from "./pmxt/client.js";
 export { FeedClient } from "./pmxt/feed-client.js";
 export type { Ticker, Tickers, OHLCV, Market as FeedMarket, OracleRound, FeedClientOptions } from "./pmxt/feed-client.js";
 export { Router } from "./pmxt/router.js";
@@ -88,6 +88,7 @@ const pmxt = {
     GeminiTitan,
     Hyperliquid,
     SuiBets,
+    Suibets,
     Mock,
     Router,
     ServerManager,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxtjs",
-  "version": "2.49.6",
+  "version": "2.49.8",
   "description": "Unified prediction market data API - The ccxt for prediction markets",
   "author": "PMXT Contributors",
   "repository": {
@@ -43,7 +43,7 @@
     "unified"
   ],
   "dependencies": {
-    "pmxt-core": "2.49.6",
+    "pmxt-core": "2.49.8",
     "ws": "^8.18.0"
   },
   "peerDependencies": {

package/pmxt/client.ts

@@ -53,6 +53,7 @@ import { buildArgsWithOptionalOptions } from "./args.js";
 import { PmxtError, fromServerError, InvalidOrder, NotSupported } from "./errors.js";
 import { LOCAL_URL, resolvePmxtBaseUrl } from "./constants.js";
 import { SidecarWsClient } from "./ws-client.js";
+import { logger } from "./logger.js";
 
 // Hosted-mode trading dispatch.
 // These modules are introduced as part of the hosted trading mode rollout.
@@ -547,8 +548,8 @@ export abstract class Exchange {
                 if (attempt === 0 && !this.isHosted) {
                     try {
                         await this.serverManager.ensureServerRunning();
-                    } catch {
-                        // Restart failed — continue retrying anyway
+                    } catch (err) {
+                        logger.warn('PmxtClient: server restart failed during retry', { attempt, error: String(err) });
                     }
                 }
                 await new Promise(resolve => setTimeout(resolve, delays[attempt]));
@@ -594,7 +595,8 @@ export abstract class Exchange {
             if (!client.connected) {
                 throw new Error("WS handshake failed");
             }
-        } catch {
+        } catch (err) {
+            logger.warn('PmxtClient: WebSocket probe failed, falling back to HTTP', { error: String(err) });
             this._wsUnsupported = true;
             client.close();
             return null;
@@ -1133,6 +1135,9 @@ export abstract class Exchange {
             return this._hostedSubmitOrder(built);
         }
         await this.initPromise;
+        if (this.isHosted) {
+            throw new PmxtError("submitOrder is not available in hosted mode. Use createOrder instead.");
+        }
         try {
             const args: any[] = [];
             args.push(built);
@@ -2352,7 +2357,10 @@ export abstract class Exchange {
                         const body = await res.json();
                         this._hostedAccount = { depositWallet: body.deposit_wallet, signatureType: body.signature_type };
                     } else { this._hostedAccount = {}; }
-                } catch { this._hostedAccount = {}; }
+                } catch (err) {
+                    logger.warn('PmxtClient: hosted account discovery failed', { error: String(err) });
+                    this._hostedAccount = {};
+                }
             })();
         }
         await this._accountDiscoveryPromise;
@@ -3362,6 +3370,9 @@ export class SuiBets extends Exchange {
     }
 }
 
+// Backwards-compatible casing alias matching the Python SDK export.
+export const Suibets = SuiBets;
+
 /**
  * Mock exchange client.
  *

package/pmxt/hosted-mappers.ts

@@ -108,7 +108,11 @@ export function userTradeFromV0(payload: Record<string, unknown>): UserTrade {
     const trade: UserTrade = {
         id: strOrEmpty(payload["id"]),
         price: floatOrZero(payload["price"]),
-        amount: floatOrZero(payload["amount"]),
+        // The v0 wire sends trade amounts in 6-dec micro-shares (verified
+        // live: 58139533.0 == 58.139533 shares, matching the same position's
+        // decimal `shares`). Normalize so UserTrade.amount means shares,
+        // like everywhere else in the SDK.
+        amount: floatOrZero(payload["amount"]) / 1_000_000,
         side,
         timestamp: timestampToMs(payload["timestamp"]),
     };
@@ -130,7 +134,8 @@ export function userTradeToV0(trade: UserTrade): Record<string, unknown> {
     const out: Record<string, unknown> = {
         id: trade.id,
         side: trade.side,
-        amount: trade.amount,
+        // Inverse of userTradeFromV0: decimal shares -> 6-dec micro-shares.
+        amount: Math.round(trade.amount * 1_000_000),
         price: trade.price,
         timestamp: msToTimestamp(trade.timestamp),
     };

package/pmxt/hosted-typed-data.ts

@@ -442,6 +442,28 @@ function validateWorstPrice(
 ): void {
     const worstPriceMicro = messageBigInt(message, "worst_price", "worstPrice");
     const worstPrice = Number(worstPriceMicro) / SIX_DEC_DIVISOR;
+
+    // Hosted MARKET orders pin worst_price to the tick-grid extreme by
+    // design ("textbook market semantics"): the binding user protection is
+    // max_cost_usdc (buys) / shares_6dec (sells), validated above. A
+    // slippage bound on worst_price would reject every server-built market
+    // order, so only sanity-check the price domain here.
+    const orderType = String(
+        firstPresent(
+            getField(buildRequest, "order_type"),
+            getField(buildRequest, "orderType"),
+            "market",
+        ),
+    ).toLowerCase();
+    if (orderType === "market") {
+        if (!(worstPrice > 0 && worstPrice < 1)) {
+            economicFail(
+                `worst_price expected within (0, 1) got ${worstPrice}`,
+            );
+        }
+        return;
+    }
+
     const slippagePctRaw = firstPresent(
         getField(buildRequest, "slippage_pct"),
         getField(buildRequest, "slippagePct"),

package/pmxt/router.ts

@@ -224,6 +224,8 @@ export class Router extends Exchange {
         marketId?: string;
         slug?: string;
         url?: string;
+        query?: string;
+        category?: string;
         relation?: MatchRelation;
         minConfidence?: number;
         limit?: number;
@@ -234,6 +236,8 @@ export class Router extends Exchange {
         marketId?: string;
         slug?: string;
         url?: string;
+        query?: string;
+        category?: string;
         relation?: MatchRelation;
         minConfidence?: number;
         limit?: number;
@@ -246,6 +250,8 @@ export class Router extends Exchange {
         if (marketId) query.marketId = marketId;
         if (params.slug ?? params.market?.slug) query.slug = params.slug ?? params.market?.slug;
         if (params.url) query.url = params.url;
+        if (params.query) query.query = params.query;
+        if (params.category) query.category = params.category;
         if (params.relation) query.relation = params.relation;
         if (params.minConfidence !== undefined) query.minConfidence = params.minConfidence;
         if (params.limit !== undefined) query.limit = params.limit;
@@ -274,6 +280,8 @@ export class Router extends Exchange {
         marketId?: string;
         slug?: string;
         url?: string;
+        query?: string;
+        category?: string;
         relation?: MatchRelation;
         minConfidence?: number;
         limit?: number;
@@ -284,6 +292,8 @@ export class Router extends Exchange {
         marketId?: string;
         slug?: string;
         url?: string;
+        query?: string;
+        category?: string;
         relation?: MatchRelation;
         minConfidence?: number;
         limit?: number;
@@ -303,6 +313,8 @@ export class Router extends Exchange {
         event?: UnifiedEvent;
         eventId?: string;
         slug?: string;
+        query?: string;
+        category?: string;
         relation?: MatchRelation;
         minConfidence?: number;
         limit?: number;
@@ -312,6 +324,8 @@ export class Router extends Exchange {
         event?: UnifiedEvent;
         eventId?: string;
         slug?: string;
+        query?: string;
+        category?: string;
         relation?: MatchRelation;
         minConfidence?: number;
         limit?: number;
@@ -323,6 +337,8 @@ export class Router extends Exchange {
         const eventId = params.eventId ?? (!params.event?.slug ? params.event?.id : undefined);
         if (eventId) query.eventId = eventId;
         if (params.slug ?? params.event?.slug) query.slug = params.slug ?? params.event?.slug;
+        if (params.query) query.query = params.query;
+        if (params.category) query.category = params.category;
         if (params.relation) query.relation = params.relation;
         if (params.minConfidence !== undefined) query.minConfidence = params.minConfidence;
         if (params.limit !== undefined) query.limit = params.limit;

package/pmxt/server-manager.ts

@@ -8,6 +8,7 @@ import { DefaultApi, Configuration } from "../generated/src/index.js";
 import { readFileSync, existsSync } from "fs";
 import { homedir } from "os";
 import { join, dirname } from "path";
+import { logger } from "./logger.js";
 
 export interface ServerManagerOptions {
     baseUrl?: string;
@@ -145,8 +146,8 @@ export class ServerManager {
                         const data = await response.json() as any;
                         if (data.status === "ok") return;
                     }
-                } catch {
-                    // Not ready yet
+                } catch (err) {
+                    logger.debug('server-manager: health poll error', { error: String(err) });
                 }
             }
             await new Promise((resolve) => setTimeout(resolve, this.retryDelayMs));
@@ -264,8 +265,8 @@ export class ServerManager {
                     return true;
                 }
             }
-        } catch {
-            // Ignore errors
+        } catch (err) {
+            logger.warn('server-manager: version check failed', { error: String(err) });
         }
         return false;
     }
@@ -385,6 +386,9 @@ export class ServerManager {
         try {
             const { unlinkSync } = await import('fs');
             unlinkSync(this.lockPath);
-        } catch { }
+        } catch (err) {
+            // Best-effort — expected when file was already removed.
+            logger.debug('server-manager: lock file removal failed', { path: this.lockPath, error: String(err) });
+        }
     }
 }

package/pmxt/ws-client.ts

@@ -343,8 +343,8 @@ export class SidecarWsClient {
         if (this.ws) {
             try {
                 this.ws.close();
-            } catch {
-                // ignore
+            } catch (err) {
+                logger.debug('[SidecarWsClient] error during ws.close()', { error: String(err) });
             }
             this.ws = null;
         }