pmxtjs 2.51.1 → 2.51.3

package/README.md

@@ -120,7 +120,7 @@ const order = await trader.createOrder({
   amount: 5.0,
   denom: "usdc",
   slippage_pct: 30.0,
-} as any);
+});
 console.log(`Order status: ${order.status}`);
 ```
 
@@ -143,7 +143,9 @@ When self-hosting, supply venue credentials directly — no `pmxtApiKey`. The SD
 
 **Polymarket:**
 ```typescript
-const poly = new pmxt.Polymarket({
+import { Polymarket } from "pmxtjs";
+
+const poly = new Polymarket({
     privateKey: process.env.POLYMARKET_PRIVATE_KEY,
     proxyAddress: process.env.POLYMARKET_PROXY_ADDRESS, // Optional
     // signatureType: 'gnosis-safe' (default)
@@ -152,7 +154,9 @@ const poly = new pmxt.Polymarket({
 
 **Kalshi:**
 ```typescript
-const kalshi = new pmxt.Kalshi({
+import { Kalshi } from "pmxtjs";
+
+const kalshi = new Kalshi({
     apiKey: process.env.KALSHI_API_KEY,
     privateKey: process.env.KALSHI_PRIVATE_KEY
 });
@@ -160,7 +164,9 @@ const kalshi = new pmxt.Kalshi({
 
 **Limitless:**
 ```typescript
-const limitless = new pmxt.Limitless({
+import { Limitless } from "pmxtjs";
+
+const limitless = new Limitless({
     privateKey: process.env.LIMITLESS_PRIVATE_KEY
 });
 ```
@@ -170,8 +176,11 @@ const limitless = new pmxt.Limitless({
 - `createOrder(params)` - Place a new order
   ```typescript
   // Using outcome shorthand (recommended)
+  const yes = market.yes;
+  if (!yes) throw new Error("Market has no YES outcome");
+
   await poly.createOrder({
-      outcome: market.yes,
+      outcome: yes,
       side: 'buy',
       type: 'limit',
       amount: 10,

package/dist/esm/generated/src/apis/DefaultApi.d.ts

@@ -342,10 +342,12 @@ export declare class DefaultApi extends runtime.BaseAPI {
      */
     createOrder(requestParameters: CreateOrderOperationRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<CreateOrder200Response>;
     /**
+     * Fetch authenticated order history across open and closed orders.
      * Fetch All Orders
      */
     fetchAllOrdersRaw(requestParameters: FetchAllOrdersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FetchOpenOrders200Response>>;
     /**
+     * Fetch authenticated order history across open and closed orders.
      * Fetch All Orders
      */
     fetchAllOrders(requestParameters: FetchAllOrdersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchOpenOrders200Response>;
@@ -370,10 +372,12 @@ export declare class DefaultApi extends runtime.BaseAPI {
      */
     fetchBalance(requestParameters: FetchBalanceRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchBalance200Response>;
     /**
+     * Fetch authenticated closed orders.
      * Fetch Closed Orders
      */
     fetchClosedOrdersRaw(requestParameters: FetchClosedOrdersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FetchOpenOrders200Response>>;
     /**
+     * Fetch authenticated closed orders.
      * Fetch Closed Orders
      */
     fetchClosedOrders(requestParameters: FetchClosedOrdersRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchOpenOrders200Response>;
@@ -488,10 +492,12 @@ export declare class DefaultApi extends runtime.BaseAPI {
      */
     fetchMatchedPrices(requestParameters: FetchMatchedPricesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchMatchedMarkets200Response>;
     /**
+     * Fetch authenticated user trade history.
      * Fetch My Trades
      */
     fetchMyTradesRaw(requestParameters: FetchMyTradesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<FetchMyTrades200Response>>;
     /**
+     * Fetch authenticated user trade history.
      * Fetch My Trades
      */
     fetchMyTrades(requestParameters: FetchMyTradesRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<FetchMyTrades200Response>;

package/dist/esm/generated/src/apis/DefaultApi.js

@@ -168,6 +168,7 @@ export class DefaultApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
+     * Fetch authenticated order history across open and closed orders.
      * Fetch All Orders
      */
     async fetchAllOrdersRaw(requestParameters, initOverrides) {
@@ -202,6 +203,7 @@ export class DefaultApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => FetchOpenOrders200ResponseFromJSON(jsonValue));
     }
     /**
+     * Fetch authenticated order history across open and closed orders.
      * Fetch All Orders
      */
     async fetchAllOrders(requestParameters, initOverrides) {
@@ -280,6 +282,7 @@ export class DefaultApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
+     * Fetch authenticated closed orders.
      * Fetch Closed Orders
      */
     async fetchClosedOrdersRaw(requestParameters, initOverrides) {
@@ -314,6 +317,7 @@ export class DefaultApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => FetchOpenOrders200ResponseFromJSON(jsonValue));
     }
     /**
+     * Fetch authenticated closed orders.
      * Fetch Closed Orders
      */
     async fetchClosedOrders(requestParameters, initOverrides) {
@@ -944,6 +948,7 @@ export class DefaultApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
+     * Fetch authenticated user trade history.
      * Fetch My Trades
      */
     async fetchMyTradesRaw(requestParameters, initOverrides) {
@@ -981,6 +986,7 @@ export class DefaultApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => FetchMyTrades200ResponseFromJSON(jsonValue));
     }
     /**
+     * Fetch authenticated user trade history.
      * Fetch My Trades
      */
     async fetchMyTrades(requestParameters, initOverrides) {

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

@@ -51,6 +51,18 @@ export interface CreateOrderParams {
      * @memberof CreateOrderParams
      */
     price?: number;
+    /**
+     * Hosted mode: amount unit.
+     * @type {string}
+     * @memberof CreateOrderParams
+     */
+    denom?: CreateOrderParamsDenomEnum;
+    /**
+     * Hosted mode: maximum market-order slippage percentage.
+     * @type {number}
+     * @memberof CreateOrderParams
+     */
+    slippagePct?: number;
     /**
      * Optional fee rate (e.g., 1000 for 0.1%)
      * @type {number}
@@ -92,6 +104,14 @@ export declare const CreateOrderParamsTypeEnum: {
     readonly Limit: "limit";
 };
 export type CreateOrderParamsTypeEnum = typeof CreateOrderParamsTypeEnum[keyof typeof CreateOrderParamsTypeEnum];
+/**
+ * @export
+ */
+export declare const CreateOrderParamsDenomEnum: {
+    readonly Usdc: "usdc";
+    readonly Shares: "shares";
+};
+export type CreateOrderParamsDenomEnum = typeof CreateOrderParamsDenomEnum[keyof typeof CreateOrderParamsDenomEnum];
 /**
  * Check if a given object implements the CreateOrderParams interface.
  */

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

@@ -25,6 +25,13 @@ export const CreateOrderParamsTypeEnum = {
     Market: 'market',
     Limit: 'limit'
 };
+/**
+ * @export
+ */
+export const CreateOrderParamsDenomEnum = {
+    Usdc: 'usdc',
+    Shares: 'shares'
+};
 /**
  * Check if a given object implements the CreateOrderParams interface.
  */
@@ -55,6 +62,8 @@ export function CreateOrderParamsFromJSONTyped(json, ignoreDiscriminator) {
         'type': json['type'],
         'amount': json['amount'],
         'price': json['price'] == null ? undefined : json['price'],
+        'denom': json['denom'] == null ? undefined : json['denom'],
+        'slippagePct': json['slippage_pct'] == null ? undefined : json['slippage_pct'],
         'fee': json['fee'] == null ? undefined : json['fee'],
         'tickSize': json['tickSize'] == null ? undefined : json['tickSize'],
         'negRisk': json['negRisk'] == null ? undefined : json['negRisk'],
@@ -75,6 +84,8 @@ export function CreateOrderParamsToJSONTyped(value, ignoreDiscriminator = false)
         'type': value['type'],
         'amount': value['amount'],
         'price': value['price'],
+        'denom': value['denom'],
+        'slippage_pct': value['slippagePct'],
         'fee': value['fee'],
         'tickSize': value['tickSize'],
         'negRisk': value['negRisk'],

package/dist/esm/index.d.ts

@@ -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, Rain, Mock } from "./pmxt/client.js";
+import { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Rain, Hunch, 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, Suibets, Rain, Mock, PolymarketOptions } from "./pmxt/client.js";
+export { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Suibets, Rain, Hunch, 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";
@@ -97,6 +97,7 @@ declare const pmxt: {
     SuiBets: typeof SuiBets;
     Suibets: typeof SuiBets;
     Rain: typeof Rain;
+    Hunch: typeof Hunch;
     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, Suibets, Rain, Mock } from "./pmxt/client.js";
+import { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Suibets, Rain, Hunch, 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, Suibets, Rain, Mock } from "./pmxt/client.js";
+export { Exchange, Polymarket, Kalshi, KalshiDemo, Limitless, Myriad, Probable, Baozi, Opinion, Metaculus, Smarkets, PolymarketUS, GeminiTitan, Hyperliquid, SuiBets, Suibets, Rain, Hunch, 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";
@@ -78,6 +78,7 @@ const pmxt = {
     SuiBets,
     Suibets,
     Rain,
+    Hunch,
     Mock,
     Router,
     ServerManager,

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

@@ -5,7 +5,7 @@
  * OpenAPI client, matching the Python API exactly.
  */
 import { Configuration, DefaultApi, ExchangeCredentials } from "../generated/src/index.js";
-import { Balance, BuiltOrder, CreateOrderParams, EventFetchParams, EventFilterCriteria, EventFilterFunction, ExecutionPriceResult, FetchOrderBookParams, MarketFetchParams, MarketFilterCriteria, MarketFilterFunction, MarketOutcome, MyTradesParams, Order, OrderBook, OrderHistoryParams, PaginatedMarketsResult, PaginatedEventsResult, Position, SeriesFetchParams, PriceCandle, SubscribedAddressSnapshot, SubscriptionOption, Trade, UnifiedEvent, UnifiedMarket, UnifiedSeries, UserTrade, FirehoseEvent, FetchMatchedMarketClustersParams } from "./models.js";
+import { Balance, BuiltOrder, CreateOrderInput, EventFetchParams, EventFilterCriteria, EventFilterFunction, ExecutionPriceResult, FetchOrderBookParams, MarketFetchParams, MarketFilterCriteria, MarketFilterFunction, MarketOutcome, MyTradesParams, Order, OrderBook, OrderHistoryParams, PaginatedMarketsResult, PaginatedEventsResult, Position, SeriesFetchParams, PriceCandle, SubscribedAddressSnapshot, SubscriptionOption, Trade, UnifiedEvent, UnifiedMarket, UnifiedSeries, UserTrade, FirehoseEvent, FetchMatchedMarketClustersParams } from "./models.js";
 import { ServerManager } from "./server-manager.js";
 import type { Signer } from "./signers.js";
 import { Escrow } from "./escrow.js";
@@ -105,6 +105,7 @@ export declare abstract class Exchange {
     private _wsClient;
     /** Sticky flag: true if the sidecar /ws endpoint is unavailable. */
     private _wsUnsupported;
+    private readonly _useSidecarLockBaseUrl;
     constructor(exchangeName: string, options?: ExchangeOptions);
     private initializeServer;
     protected handleResponse(response: any): any;
@@ -125,9 +126,9 @@ export declare abstract class Exchange {
     /**
      * Resolve the current sidecar base URL.
      *
-     * For hosted mode the configured basePath is returned as-is.
-     * For local mode the port is re-read from the lock file on every
-     * call so we pick up sidecar restarts that land on a different port.
+     * Hosted mode and explicit baseUrl clients keep the configured basePath.
+     * Default local clients re-read the lock-file port on every call so they
+     * pick up sidecar restarts that land on a different port.
      */
     private resolveBaseUrl;
     /**
@@ -335,7 +336,13 @@ export declare abstract class Exchange {
      * ```
      */
     watchAllOrderBooks(venues?: string[]): Promise<FirehoseEvent>;
-    /** @deprecated Use {@link watchAllOrderBooks} instead. */
+    /**
+     * Stream all orderbook updates across venues.
+     *
+     * @deprecated Use {@link watchAllOrderBooks} instead.
+     * @param venues - Optional venue filter
+     * @returns Next event with source, symbol, and orderbook
+     */
     firehose(venues?: string[]): Promise<FirehoseEvent>;
     /**
      * Watch real-time trade updates via WebSocket.
@@ -411,17 +418,18 @@ export declare abstract class Exchange {
      * const order = await exchange.submitOrder(built);
      *
      * // Using outcome shorthand:
+     * const yes = market.yes;
+     * if (!yes) throw new Error("Market has no YES outcome");
+     *
      * const built2 = await exchange.buildOrder({
-     *   outcome: market.yes,
+     *   outcome: yes,
      *   side: "buy",
      *   type: "market",
      *   amount: 10
      * });
      * ```
      */
-    buildOrder(params: CreateOrderParams & {
-        outcome?: MarketOutcome;
-    }): Promise<BuiltOrder>;
+    buildOrder(params: CreateOrderInput): Promise<BuiltOrder>;
     private _discoverHostedAccount;
     private _executeSorOrder;
     /**
@@ -475,9 +483,7 @@ export declare abstract class Exchange {
      * });
      * ```
      */
-    createOrder(params: CreateOrderParams & {
-        outcome?: MarketOutcome;
-    }): Promise<Order>;
+    createOrder(params: CreateOrderInput): Promise<Order>;
     /**
      * Calculate the average execution price for a given amount by walking the order book.
      * Uses the sidecar server for calculation to ensure consistency.
@@ -576,6 +582,14 @@ export interface PolymarketOptions {
     proxyAddress?: string;
     /** Optional signature type */
     signatureType?: 'eoa' | 'poly-proxy' | 'gnosis-safe' | number;
+    /**
+     * EVM wallet address used for hosted reads/writes.
+     */
+    walletAddress?: string;
+    /**
+     * External signer used for hosted writes.
+     */
+    signer?: Signer;
 }
 export declare class Polymarket extends Exchange {
     constructor(options?: PolymarketOptions);
@@ -626,6 +640,32 @@ export declare class Kalshi extends Exchange {
  */
 export declare class Limitless extends Exchange {
     constructor(options?: ExchangeOptions);
+    /**
+     * Watch real-time AMM price updates via WebSocket.
+     *
+     * @param marketAddress - Limitless market contract address
+     * @param callback - Optional callback invoked with the returned update
+     * @returns Next price update
+     */
+    watchPrices(marketAddress: string, callback?: (data: Record<string, any>) => void): Promise<Record<string, any>>;
+    /**
+     * Watch real-time Limitless user position updates.
+     *
+     * Requires API key authentication.
+     *
+     * @param callback - Optional callback invoked with the returned positions
+     * @returns Next position update payload
+     */
+    watchUserPositions(callback?: (data: Position[]) => void): Promise<Position[]>;
+    /**
+     * Watch real-time Limitless user transaction updates.
+     *
+     * Requires API key authentication.
+     *
+     * @param callback - Optional callback invoked with the returned update
+     * @returns Next transaction update
+     */
+    watchUserTransactions(callback?: (data: Record<string, any>) => void): Promise<Record<string, any>>;
 }
 /**
  * Kalshi Demo exchange client (paper trading / sandbox environment).
@@ -856,6 +896,15 @@ export declare const Suibets: typeof SuiBets;
 export declare class Rain extends Exchange {
     constructor(options?: ExchangeOptions);
 }
+/**
+ * Hunch exchange client.
+ *
+ * Hunch is a crypto-native prediction market. Reads are unauthenticated;
+ * trading requires an EVM private key.
+ */
+export declare class Hunch extends Exchange {
+    constructor(options?: ExchangeOptions);
+}
 /**
  * Mock exchange client.
  *

package/dist/esm/pmxt/client.js

@@ -7,8 +7,8 @@
 import { Configuration, DefaultApi, } from "../generated/src/index.js";
 import { MarketList, } from "./models.js";
 import { ServerManager } from "./server-manager.js";
-import { PmxtError, fromServerError, InvalidOrder } from "./errors.js";
-import { resolvePmxtBaseUrl } from "./constants.js";
+import { PmxtError, fromServerError, InvalidOrder, NotSupported } from "./errors.js";
+import { ENV, resolvePmxtBaseUrl } from "./constants.js";
 import { SidecarWsClient } from "./ws-client.js";
 import { logger } from "./logger.js";
 // Hosted-mode trading dispatch.
@@ -190,6 +190,7 @@ export class Exchange {
     _wsClient = null;
     /** Sticky flag: true if the sidecar /ws endpoint is unavailable. */
     _wsUnsupported = false;
+    _useSidecarLockBaseUrl;
     constructor(exchangeName, options = {}) {
         this.exchangeName = exchangeName.toLowerCase();
         this.apiKey = options.apiKey;
@@ -207,6 +208,9 @@ export class Exchange {
         const baseUrl = resolved.baseUrl;
         this.pmxtApiKey = resolved.pmxtApiKey;
         this.isHosted = resolved.isHosted;
+        const hasBaseUrlOverride = Boolean(options.baseUrl ||
+            (typeof process !== "undefined" && process.env[ENV.BASE_URL]));
+        this._useSidecarLockBaseUrl = !this.isHosted && !hasBaseUrlOverride;
         // Hosted trading bridge: if the caller passed a privateKey but no
         // explicit signer, lazily wrap it in an EthersSigner so that
         // `pmxt.Polymarket(pmxtApiKey, privateKey)` just works without the
@@ -247,15 +251,17 @@ export class Exchange {
         if (autoStartServer) {
             try {
                 await this.serverManager.ensureServerRunning();
-                // Get the actual port the server is running on
-                // (may differ from default if default port was busy)
-                const actualPort = this.serverManager.getRunningPort();
-                const newBaseUrl = `http://localhost:${actualPort}`;
-                // Update API client with actual base URL
-                this.config = new Configuration({
-                    basePath: newBaseUrl,
-                });
-                this.api = new DefaultApi(this.config);
+                if (this._useSidecarLockBaseUrl) {
+                    // Get the actual port the server is running on
+                    // (may differ from default if default port was busy)
+                    const actualPort = this.serverManager.getRunningPort();
+                    const newBaseUrl = `http://localhost:${actualPort}`;
+                    // Update API client with actual base URL
+                    this.config = new Configuration({
+                        basePath: newBaseUrl,
+                    });
+                    this.api = new DefaultApi(this.config);
+                }
             }
             catch (error) {
                 const msg = `Failed to start PMXT server: ${error instanceof Error ? error.message : error}\n\n` +
@@ -329,12 +335,12 @@ export class Exchange {
     /**
      * Resolve the current sidecar base URL.
      *
-     * For hosted mode the configured basePath is returned as-is.
-     * For local mode the port is re-read from the lock file on every
-     * call so we pick up sidecar restarts that land on a different port.
+     * Hosted mode and explicit baseUrl clients keep the configured basePath.
+     * Default local clients re-read the lock-file port on every call so they
+     * pick up sidecar restarts that land on a different port.
      */
     resolveBaseUrl() {
-        if (this.isHosted)
+        if (this.isHosted || !this._useSidecarLockBaseUrl)
             return this.config.basePath;
         const port = this.serverManager.getRunningPort();
         return `http://localhost:${port}`;
@@ -1018,7 +1024,10 @@ export class Exchange {
             const route = HOSTED_METHOD_ROUTES.get("fetchOrder");
             const path = formatRoutePath(route, { order_id: orderId });
             const data = await _tradingRequest(this, { method: route.method, path });
-            return orderFromV0(data);
+            const payload = data && typeof data === "object" && "order" in data
+                ? data.order
+                : data;
+            return orderFromV0(payload);
         }
         try {
             const args = [];
@@ -1124,6 +1133,9 @@ export class Exchange {
     }
     async fetchClosedOrders(params) {
         await this.initPromise;
+        if (this.isHosted) {
+            throw new NotSupported("fetchClosedOrders is not available in hosted trading mode.");
+        }
         try {
             const args = [];
             if (params !== undefined)
@@ -1152,6 +1164,9 @@ export class Exchange {
     }
     async fetchAllOrders(params) {
         await this.initPromise;
+        if (this.isHosted) {
+            throw new NotSupported("fetchAllOrders is not available in hosted trading mode.");
+        }
         try {
             const args = [];
             if (params !== undefined)
@@ -1185,7 +1200,9 @@ export class Exchange {
             const route = HOSTED_METHOD_ROUTES.get("fetchPositions");
             const path = formatRoutePath(route, { address: resolvedAddress });
             const data = await _tradingRequest(this, { method: route.method, path });
-            const list = Array.isArray(data) ? data : [];
+            const list = Array.isArray(data)
+                ? data
+                : (data && Array.isArray(data.positions) ? data.positions : []);
             return list.map((p) => positionFromV0(p));
         }
         try {
@@ -1221,7 +1238,9 @@ export class Exchange {
             const route = HOSTED_METHOD_ROUTES.get("fetchBalance");
             const path = formatRoutePath(route, { address: resolvedAddress });
             const data = await _tradingRequest(this, { method: route.method, path });
-            const list = Array.isArray(data) ? data : [];
+            const list = Array.isArray(data)
+                ? data
+                : (data && Array.isArray(data.balances) ? data.balances : []);
             return list.map((b) => balanceFromV0(b));
         }
         try {
@@ -1788,7 +1807,13 @@ export class Exchange {
         }
         throw this.wsTransportUnavailableError("watchAllOrderBooks");
     }
-    /** @deprecated Use {@link watchAllOrderBooks} instead. */
+    /**
+     * Stream all orderbook updates across venues.
+     *
+     * @deprecated Use {@link watchAllOrderBooks} instead.
+     * @param venues - Optional venue filter
+     * @returns Next event with source, symbol, and orderbook
+     */
     async firehose(venues) {
         return this.watchAllOrderBooks(venues);
     }
@@ -1913,8 +1938,11 @@ export class Exchange {
      * const order = await exchange.submitOrder(built);
      *
      * // Using outcome shorthand:
+     * const yes = market.yes;
+     * if (!yes) throw new Error("Market has no YES outcome");
+     *
      * const built2 = await exchange.buildOrder({
-     *   outcome: market.yes,
+     *   outcome: yes,
      *   side: "buy",
      *   type: "market",
      *   amount: 10
@@ -2207,8 +2235,9 @@ export class Exchange {
         const venue = this.exchangeName;
         if (venue === "polymarket")
             return "cancel_polymarket";
-        if (venue === "limitless")
+        if (venue === "limitless") {
             return isPull ? "cancel_limitless_base_pull" : "cancel_limitless_polygon";
+        }
         return isPull ? "cancel_opinion_bsc_pull" : "cancel_opinion_polygon";
     }
     /**
@@ -2781,6 +2810,71 @@ export class Limitless extends Exchange {
     constructor(options = {}) {
         super("limitless", options);
     }
+    /**
+     * Watch real-time AMM price updates via WebSocket.
+     *
+     * @param marketAddress - Limitless market contract address
+     * @param callback - Optional callback invoked with the returned update
+     * @returns Next price update
+     */
+    async watchPrices(marketAddress, callback) {
+        await this.initPromise;
+        try {
+            const json = await this.sidecarPostRequest("watchPrices", [marketAddress]);
+            const data = this.handleResponse(json);
+            callback?.(data);
+            return data;
+        }
+        catch (error) {
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to watch prices: ${error}`);
+        }
+    }
+    /**
+     * Watch real-time Limitless user position updates.
+     *
+     * Requires API key authentication.
+     *
+     * @param callback - Optional callback invoked with the returned positions
+     * @returns Next position update payload
+     */
+    async watchUserPositions(callback) {
+        await this.initPromise;
+        try {
+            const json = await this.sidecarPostRequest("watchUserPositions", []);
+            const data = this.handleResponse(json).map(convertPosition);
+            callback?.(data);
+            return data;
+        }
+        catch (error) {
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to watch user positions: ${error}`);
+        }
+    }
+    /**
+     * Watch real-time Limitless user transaction updates.
+     *
+     * Requires API key authentication.
+     *
+     * @param callback - Optional callback invoked with the returned update
+     * @returns Next transaction update
+     */
+    async watchUserTransactions(callback) {
+        await this.initPromise;
+        try {
+            const json = await this.sidecarPostRequest("watchUserTransactions", []);
+            const data = this.handleResponse(json);
+            callback?.(data);
+            return data;
+        }
+        catch (error) {
+            if (error instanceof PmxtError)
+                throw error;
+            throw new PmxtError(`Failed to watch user transactions: ${error}`);
+        }
+    }
 }
 /**
  * Kalshi Demo exchange client (paper trading / sandbox environment).
@@ -3034,6 +3128,17 @@ export class Rain extends Exchange {
         super("rain", options);
     }
 }
+/**
+ * Hunch exchange client.
+ *
+ * Hunch is a crypto-native prediction market. Reads are unauthenticated;
+ * trading requires an EVM private key.
+ */
+export class Hunch extends Exchange {
+    constructor(options = {}) {
+        super("hunch", options);
+    }
+}
 /**
  * Mock exchange client.
  *