pmxtjs 2.51.1 → 2.51.3

package/dist/esm/pmxt/escrow.js

@@ -9,6 +9,80 @@
  * Mirrors `sdks/python/pmxt/escrow.py`.
  */
 import { _tradingRequest, formatRoutePath, HOSTED_METHOD_ROUTES, resolveWalletAddress, } from "./hosted-routing.js";
+import { ValidationError } from "./errors.js";
+const APPROVAL_TOKENS = new Set(["usdc", "ctf"]);
+const WITHDRAW_ACTIONS = new Set(["request", "claim", "cancel"]);
+const USDC_SCALE = 1000000n;
+function isDecimalTokenId(token) {
+    return /^[0-9]+$/.test(token);
+}
+function normalizeApprovalToken(token) {
+    if (typeof token !== "string") {
+        throw new ValidationError("token must be 'usdc', 'ctf', or a decimal CTF token_id string", "token");
+    }
+    const candidate = token.trim();
+    const normalized = candidate.toLowerCase();
+    if (APPROVAL_TOKENS.has(normalized)) {
+        return normalized;
+    }
+    if (isDecimalTokenId(candidate)) {
+        return candidate;
+    }
+    throw new ValidationError("token must be 'usdc', 'ctf', or a decimal CTF token_id string", "token");
+}
+function normalizeAmountWei(amountWei) {
+    if (amountWei === undefined) {
+        return undefined;
+    }
+    if (typeof amountWei !== "bigint") {
+        throw new ValidationError("amount_wei must be a non-negative integer", "amount_wei");
+    }
+    if (amountWei < 0n) {
+        throw new ValidationError("amount_wei must be non-negative", "amount_wei");
+    }
+    return amountWei.toString();
+}
+function validateUsdcDecimal(value, field) {
+    const match = /^([0-9]+)(?:\.([0-9]+))?$/.exec(value);
+    if (!match) {
+        throw new ValidationError(`${field} must be a finite positive number`, field);
+    }
+    const fractional = match[2] ?? "";
+    if (fractional.length > 6) {
+        throw new ValidationError(`${field} precision exceeds 6 decimals; max precision for USDC is 0.000001`, field);
+    }
+    const scaled = BigInt(match[1]) * USDC_SCALE + BigInt(fractional.padEnd(6, "0"));
+    if (scaled <= 0n) {
+        throw new ValidationError(`${field} must be positive`, field);
+    }
+}
+function normalizeUsdcAmount(value, field = "amount") {
+    if (typeof value === "bigint") {
+        if (value <= 0n) {
+            throw new ValidationError(`${field} must be positive`, field);
+        }
+        return value.toString();
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new ValidationError(`${field} must be a finite positive number`, field);
+        }
+        validateUsdcDecimal(String(value), field);
+        return value;
+    }
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        validateUsdcDecimal(trimmed, field);
+        return trimmed;
+    }
+    throw new ValidationError(`${field} must be a finite positive number`, field);
+}
+function normalizeWithdrawAction(action) {
+    if (typeof action === "string" && WITHDRAW_ACTIONS.has(action)) {
+        return action;
+    }
+    throw new ValidationError("action must be 'request', 'claim', or 'cancel'", "action");
+}
 export class Escrow {
     client;
     constructor(client) {
@@ -19,13 +93,16 @@ export class Escrow {
      * `amountWei` is omitted, the server returns an unlimited approval.
      */
     async approveTx(token, amountWei) {
+        const address = resolveWalletAddress(this.client);
+        const approvalAmount = normalizeAmountWei(amountWei);
         const route = HOSTED_METHOD_ROUTES.get("escrowApproveTx");
         return _tradingRequest(this.client, {
             method: route.method,
             path: route.path,
             body: {
-                token,
-                amount_wei: amountWei === undefined ? null : amountWei.toString(),
+                token: normalizeApprovalToken(token),
+                user_address: address,
+                ...(approvalAmount === undefined ? {} : { amount_wei: approvalAmount }),
             },
         });
     }
@@ -34,12 +111,15 @@ export class Escrow {
      * grid). Accepts number, decimal string, or BigInt in micro-units.
      */
     async depositTx(amount) {
+        const address = resolveWalletAddress(this.client);
         const route = HOSTED_METHOD_ROUTES.get("escrowDepositTx");
         return _tradingRequest(this.client, {
             method: route.method,
             path: route.path,
             body: {
-                amount: typeof amount === "bigint" ? amount.toString() : amount,
+                token: "usdc",
+                amount: normalizeUsdcAmount(amount),
+                user_address: address,
             },
         });
     }
@@ -49,16 +129,31 @@ export class Escrow {
      * the timelock, `cancel` aborts a pending request.
      */
     async withdrawTx(action, amount) {
+        const normalizedAction = normalizeWithdrawAction(action);
+        const address = resolveWalletAddress(this.client);
         const route = HOSTED_METHOD_ROUTES.get("escrowWithdrawTx");
-        const normalizedAmount = amount === undefined
-            ? null
-            : typeof amount === "bigint"
-                ? amount.toString()
-                : amount;
+        if (normalizedAction === "request") {
+            if (amount === undefined) {
+                throw new ValidationError("amount is required when action='request'", "amount");
+            }
+            return _tradingRequest(this.client, {
+                method: route.method,
+                path: route.path,
+                body: {
+                    action: normalizedAction,
+                    token: "usdc",
+                    amount: normalizeUsdcAmount(amount),
+                    user_address: address,
+                },
+            });
+        }
+        if (amount !== undefined) {
+            throw new ValidationError(`amount must be omitted when action='${normalizedAction}'`, "amount");
+        }
         return _tradingRequest(this.client, {
             method: route.method,
             path: route.path,
-            body: { action, amount: normalizedAmount },
+            body: { action: normalizedAction, token: "usdc", user_address: address },
         });
     }
     /**
@@ -67,12 +162,16 @@ export class Escrow {
      */
     async withdrawals(opts = {}) {
         const address = resolveWalletAddress(this.client, opts.address);
+        const include = (opts.include ?? "pending,events").trim();
+        if (!include) {
+            throw new ValidationError("include must not be empty", "include");
+        }
         const route = HOSTED_METHOD_ROUTES.get("escrowWithdrawals");
         const path = formatRoutePath(route, { address });
         return _tradingRequest(this.client, {
             method: route.method,
             path,
-            params: { include: opts.include ?? "pending,events" },
+            params: { include },
         });
     }
 }

package/dist/esm/pmxt/hosted-typed-data.d.ts

@@ -9,7 +9,7 @@
  * Layer 3 uses the optional `ethers` peer dependency for typed-data verification.
  */
 import { TypedData } from "./signers.js";
-export type HostedRoute = "polymarket_buy" | "polymarket_sell" | "limitless_buy" | "limitless_sell_polygon" | "limitless_sell_base_pull" | "opinion_buy" | "opinion_sell_polygon" | "opinion_sell_bsc_pull" | "cancel_polymarket" | "cancel_opinion_polygon" | "cancel_opinion_bsc_pull";
+export type HostedRoute = "polymarket_buy" | "polymarket_sell" | "limitless_buy" | "limitless_sell_polygon" | "limitless_sell_base_pull" | "opinion_buy" | "opinion_sell_polygon" | "opinion_sell_bsc_pull" | "cancel_polymarket" | "cancel_opinion_polygon" | "cancel_opinion_bsc_pull" | "cancel_limitless_polygon" | "cancel_limitless_base_pull";
 export declare const SECP256K1_HALF_N = 57896044618658097711785492504343953926418782139537452191302581570759080747168n;
 /**
  * Validate the structural shape of a typed-data payload before signing.

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

@@ -172,6 +172,20 @@ const SCHEMAS = {
         messageKeys: messageKeysFromFields(CANCEL_PULL_FIELDS),
         walletField: "user",
     },
+    cancel_limitless_polygon: {
+        primaryType: "CancelOrder",
+        domain: PREFUNDED_DOMAIN,
+        fields: CANCEL_ORDER_FIELDS,
+        messageKeys: messageKeysFromFields(CANCEL_ORDER_FIELDS),
+        walletField: "user",
+    },
+    cancel_limitless_base_pull: {
+        primaryType: "CancelPull",
+        domain: LIMITLESS_VENUE_DOMAIN,
+        fields: CANCEL_PULL_FIELDS,
+        messageKeys: messageKeysFromFields(CANCEL_PULL_FIELDS),
+        walletField: "user",
+    },
 };
 // secp256k1 group order / 2, for canonical low-s check.
 export const SECP256K1_HALF_N = 0x7fffffffffffffffffffffffffffffff5d576e7357a4501ddfe92f46681b20a0n;

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

@@ -400,6 +400,10 @@ export interface CreateOrderParams {
     amount: number;
     /** Limit price (required for limit orders, 0.0-1.0) */
     price?: number;
+    /** Hosted mode: unit that amount is denominated in. Market buys use usdc; market sells and limit orders use shares. */
+    denom?: "usdc" | "shares";
+    /** Hosted mode: maximum slippage percentage for market orders. */
+    slippage_pct?: number;
     /** Optional fee rate (e.g., 1000 for 0.1%) */
     fee?: number;
     /** Optional override for Limitless/Polymarket */
@@ -409,6 +413,19 @@ export interface CreateOrderParams {
     /** Limitless delegated signing: profile ID to trade on behalf of */
     onBehalfOf?: number;
 }
+/**
+ * Public order input accepted by createOrder/buildOrder.
+ *
+ * Callers can either pass explicit marketId/outcomeId fields, or pass an
+ * outcome object returned by fetchMarkets and let the SDK infer those ids.
+ */
+export type CreateOrderInput = (CreateOrderParams & {
+    outcome?: never;
+}) | (Omit<CreateOrderParams, 'marketId' | 'outcomeId'> & {
+    outcome: MarketOutcome;
+    marketId?: never;
+    outcomeId?: never;
+});
 /** Alias matching the core MarketFetchParams name. */
 export type MarketFetchParams = MarketFilterParams;
 /**

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

@@ -81,12 +81,14 @@ export class ServerManager {
      * Check if the server is running.
      */
     async isServerRunning() {
-        // Read lock file to get current port
-        const port = this.getRunningPort();
+        const info = this.getServerInfo();
+        if (!info?.port) {
+            return false;
+        }
         try {
             // Use native fetch to check health on the actual running port
             // This avoids issues where this.api is configured with the wrong port
-            const response = await fetch(`http://localhost:${port}/health`, {
+            const response = await fetch(`http://localhost:${info.port}/health`, {
                 signal: AbortSignal.timeout(5_000),
             });
             if (response.ok) {

package/dist/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/generated/src/apis/DefaultApi.js

@@ -205,6 +205,7 @@ 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) {
@@ -239,6 +240,7 @@ class DefaultApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.FetchOpenOrders200ResponseFromJSON)(jsonValue));
     }
     /**
+     * Fetch authenticated order history across open and closed orders.
      * Fetch All Orders
      */
     async fetchAllOrders(requestParameters, initOverrides) {
@@ -317,6 +319,7 @@ class DefaultApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
+     * Fetch authenticated closed orders.
      * Fetch Closed Orders
      */
     async fetchClosedOrdersRaw(requestParameters, initOverrides) {
@@ -351,6 +354,7 @@ class DefaultApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.FetchOpenOrders200ResponseFromJSON)(jsonValue));
     }
     /**
+     * Fetch authenticated closed orders.
      * Fetch Closed Orders
      */
     async fetchClosedOrders(requestParameters, initOverrides) {
@@ -981,6 +985,7 @@ class DefaultApi extends runtime.BaseAPI {
         return await response.value();
     }
     /**
+     * Fetch authenticated user trade history.
      * Fetch My Trades
      */
     async fetchMyTradesRaw(requestParameters, initOverrides) {
@@ -1018,6 +1023,7 @@ class DefaultApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.FetchMyTrades200ResponseFromJSON)(jsonValue));
     }
     /**
+     * Fetch authenticated user trade history.
      * Fetch My Trades
      */
     async fetchMyTrades(requestParameters, initOverrides) {

package/dist/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/generated/src/models/CreateOrderParams.js

@@ -13,7 +13,7 @@
  * Do not edit the class manually.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CreateOrderParamsTypeEnum = exports.CreateOrderParamsSideEnum = void 0;
+exports.CreateOrderParamsDenomEnum = exports.CreateOrderParamsTypeEnum = exports.CreateOrderParamsSideEnum = void 0;
 exports.instanceOfCreateOrderParams = instanceOfCreateOrderParams;
 exports.CreateOrderParamsFromJSON = CreateOrderParamsFromJSON;
 exports.CreateOrderParamsFromJSONTyped = CreateOrderParamsFromJSONTyped;
@@ -33,6 +33,13 @@ exports.CreateOrderParamsTypeEnum = {
     Market: 'market',
     Limit: 'limit'
 };
+/**
+ * @export
+ */
+exports.CreateOrderParamsDenomEnum = {
+    Usdc: 'usdc',
+    Shares: 'shares'
+};
 /**
  * Check if a given object implements the CreateOrderParams interface.
  */
@@ -63,6 +70,8 @@ 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'],
@@ -83,6 +92,8 @@ 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/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/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.LIMITLESS_VENUE_ESCROW_ADDRESSES = exports.VENUE_ESCROW_ADDRESSES = exports.PREFUNDED_ESCROW_ADDRESSES = exports.resolvePmxtBaseUrl = exports.ENV = exports.LOCAL_URL = exports.HOSTED_URL = exports.ServerManager = exports.Router = exports.FeedClient = exports.Mock = exports.Rain = 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;
+exports.server = exports.MarketList = exports.LIMITLESS_VENUE_ESCROW_ADDRESSES = exports.VENUE_ESCROW_ADDRESSES = exports.PREFUNDED_ESCROW_ADDRESSES = exports.resolvePmxtBaseUrl = exports.ENV = exports.LOCAL_URL = exports.HOSTED_URL = exports.ServerManager = exports.Router = exports.FeedClient = exports.Mock = exports.Hunch = exports.Rain = 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");
@@ -80,6 +80,7 @@ Object.defineProperty(exports, "Hyperliquid", { enumerable: true, get: function
 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, "Rain", { enumerable: true, get: function () { return client_js_2.Rain; } });
+Object.defineProperty(exports, "Hunch", { enumerable: true, get: function () { return client_js_2.Hunch; } });
 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; } });
@@ -146,6 +147,7 @@ const pmxt = {
     SuiBets: client_js_1.SuiBets,
     Suibets: client_js_1.Suibets,
     Rain: client_js_1.Rain,
+    Hunch: client_js_1.Hunch,
     Mock: client_js_1.Mock,
     Router: router_js_1.Router,
     ServerManager: server_manager_js_1.ServerManager,

package/dist/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.
  *