pmxtjs 2.49.0 → 2.49.3

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

@@ -57,6 +57,24 @@ export interface UserTrade {
      * @memberof UserTrade
      */
     orderId?: string;
+    /**
+     * Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues.
+     * @type {string}
+     * @memberof UserTrade
+     */
+    txHash?: string | null;
+    /**
+     * Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues.
+     * @type {string}
+     * @memberof UserTrade
+     */
+    chain?: string | null;
+    /**
+     * Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues.
+     * @type {number}
+     * @memberof UserTrade
+     */
+    blockNumber?: number | null;
 }
 /**
  * @export

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

@@ -50,6 +50,9 @@ export function UserTradeFromJSONTyped(json, ignoreDiscriminator) {
         'side': json['side'],
         'outcomeId': json['outcomeId'] == null ? undefined : json['outcomeId'],
         'orderId': json['orderId'] == null ? undefined : json['orderId'],
+        'txHash': json['txHash'] == null ? undefined : json['txHash'],
+        'chain': json['chain'] == null ? undefined : json['chain'],
+        'blockNumber': json['blockNumber'] == null ? undefined : json['blockNumber'],
     };
 }
 export function UserTradeToJSON(json) {
@@ -67,5 +70,8 @@ export function UserTradeToJSONTyped(value, ignoreDiscriminator = false) {
         'side': value['side'],
         'outcomeId': value['outcomeId'],
         'orderId': value['orderId'],
+        'txHash': value['txHash'],
+        'chain': value['chain'],
+        'blockNumber': value['blockNumber'],
     };
 }

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

@@ -21,6 +21,7 @@ export * from './EventFilterCriteriaTotalVolume.js';
 export * from './EventMatchResult.js';
 export * from './ExchangeCredentials.js';
 export * from './ExchangeCredentialsSignatureType.js';
+export * from './ExchangeOptions.js';
 export * from './ExecutionPriceResult.js';
 export * from './FeedFetchHistoricalPrices200Response.js';
 export * from './FeedFetchOHLCV200Response.js';

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

@@ -23,6 +23,7 @@ export * from './EventFilterCriteriaTotalVolume.js';
 export * from './EventMatchResult.js';
 export * from './ExchangeCredentials.js';
 export * from './ExchangeCredentialsSignatureType.js';
+export * from './ExchangeOptions.js';
 export * from './ExecutionPriceResult.js';
 export * from './FeedFetchHistoricalPrices200Response.js';
 export * from './FeedFetchOHLCV200Response.js';

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

@@ -72,6 +72,9 @@ export interface ExchangeOptions {
  */
 export declare abstract class Exchange {
     private static readonly OBDATA_WATCH_ALL_SOURCES;
+    private static readonly _UUID_RE;
+    /** True iff `value` parses as a canonical catalog UUID string. */
+    protected static _isCatalogUuid(value: string): boolean;
     exchangeName: string;
     pmxtApiKey?: string;
     protected apiKey?: string;

package/dist/esm/pmxt/client.js

@@ -148,6 +148,14 @@ export class Exchange {
         "kalshi",
         "opinion",
     ]);
+    // Match a canonical 8-4-4-4-12 UUID string. The hosted catalog emits
+    // UUIDs in this exact shape, so a regex is both faster and stricter
+    // than `crypto.randomUUID()`-style parsing.
+    static _UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    /** True iff `value` parses as a canonical catalog UUID string. */
+    static _isCatalogUuid(value) {
+        return Exchange._UUID_RE.test(value);
+    }
     // Public so structural interfaces like `HostedClientLike`
     // (./hosted-routing) can read the venue name and hosted credentials
     // without violating protected-access on this base class.
@@ -2202,12 +2210,17 @@ export class Exchange {
                 throw new InvalidOrder("cannot specify both 'outcome' and 'marketId'/'outcomeId'");
             }
             const outcome = params.outcome;
-            if (!outcome.marketId) {
-                throw new InvalidOrder("outcome.marketId is not set; ensure the outcome comes from a fetched market");
+            if (!outcome.outcomeId) {
+                throw new InvalidOrder("outcome.outcomeId is not set; ensure the outcome comes from a fetched market");
             }
-            marketId = outcome.marketId;
+            // marketId is optional in hosted mode -- backend derives it from
+            // outcomeId (catalog UUID). Forward it when present for backcompat.
+            marketId = outcome.marketId || undefined;
             outcomeId = outcome.outcomeId;
         }
+        if (!outcomeId) {
+            throw new InvalidOrder("outcomeId is required (or pass an 'outcome' from a fetched market)");
+        }
         const side = String(params.side);
         const orderType = String(params.type ?? "market");
         const denom = params["denom"];
@@ -2244,15 +2257,37 @@ export class Exchange {
         }
         // to6dec throws InvalidOrder for sub-micro precision.
         const amount6dec = to6dec(params.amount).toString();
+        // The supplied outcomeId may be a catalog UUID OR a venue-native id
+        // (e.g. a Polymarket tokenId or an Opinion market hash). Catalog
+        // UUIDs are forwarded as `outcome_id`; venue-native ids are
+        // forwarded as `(venue, venue_outcome_id)` so the backend resolver
+        // picks the right path. Either shape is accepted by the v0 trading
+        // API.
         const body = {
-            market_id: marketId,
-            outcome_id: outcomeId,
             side,
             order_type: orderType,
             denom: resolvedDenom,
             amount: params.amount,
             amount_6dec: amount6dec,
         };
+        if (Exchange._isCatalogUuid(outcomeId)) {
+            body["outcome_id"] = outcomeId;
+            // market_id is optional in hosted mode: backend derives it
+            // from outcome_id (UUID) when omitted. Forward only when the
+            // caller supplied a non-empty UUID -- "absent" and "null" are
+            // not equivalent under some Pydantic configs on the backend.
+            if (marketId && Exchange._isCatalogUuid(marketId)) {
+                body["market_id"] = marketId;
+            }
+        }
+        else {
+            // Venue-native form: backend resolves the row from
+            // (source_exchange, pmxt_id). marketId from a venue client is
+            // itself venue-native and would fail backend UUID validation
+            // if forwarded -- suppress it.
+            body["venue"] = this.exchangeName;
+            body["venue_outcome_id"] = outcomeId;
+        }
         if (params.price !== undefined)
             body["price"] = params.price;
         const extra = params;

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

@@ -39,6 +39,12 @@ export interface Balance {
      * @memberof Balance
      */
     locked: number;
+    /**
+     * Hosted-mode: which venue this balance belongs to in a multi-venue response. Null when the balance is venue-agnostic.
+     * @type {string}
+     * @memberof Balance
+     */
+    venue?: string | null;
 }
 /**
  * Check if a given object implements the Balance interface.

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

@@ -44,6 +44,7 @@ function BalanceFromJSONTyped(json, ignoreDiscriminator) {
         'total': json['total'],
         'available': json['available'],
         'locked': json['locked'],
+        'venue': json['venue'] == null ? undefined : json['venue'],
     };
 }
 function BalanceToJSON(json) {
@@ -58,5 +59,6 @@ function BalanceToJSONTyped(value, ignoreDiscriminator = false) {
         'total': value['total'],
         'available': value['available'],
         'locked': value['locked'],
+        'venue': value['venue'],
     };
 }

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

@@ -49,6 +49,12 @@ export interface BuiltOrder {
      * @memberof BuiltOrder
      */
     raw: any | null;
+    /**
+     * Unix epoch (ms) when this built order expires server-side. Submitting after expiry returns BUILT_ORDER_EXPIRED.
+     * @type {number}
+     * @memberof BuiltOrder
+     */
+    expiry?: number | null;
 }
 /**
  * Check if a given object implements the BuiltOrder interface.

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

@@ -45,6 +45,7 @@ function BuiltOrderFromJSONTyped(json, ignoreDiscriminator) {
         'signedOrder': json['signedOrder'] == null ? undefined : json['signedOrder'],
         'tx': json['tx'] == null ? undefined : (0, BuiltOrderTx_1.BuiltOrderTxFromJSON)(json['tx']),
         'raw': json['raw'],
+        'expiry': json['expiry'] == null ? undefined : json['expiry'],
     };
 }
 function BuiltOrderToJSON(json) {
@@ -60,5 +61,6 @@ function BuiltOrderToJSONTyped(value, ignoreDiscriminator = false) {
         'signedOrder': value['signedOrder'],
         'tx': (0, BuiltOrderTx_1.BuiltOrderTxToJSON)(value['tx']),
         'raw': value['raw'],
+        'expiry': value['expiry'],
     };
 }

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

@@ -10,18 +10,74 @@
  * Do not edit the class manually.
  */
 /**
- *
+ * Structured error envelope returned inside `BaseResponse.error` and `ErrorResponse.error`. Hosted-mode endpoints populate `code`, `retryable`, and optionally `exchange` / `detail`; legacy local-mode endpoints may still return only `message`.
  * @export
  * @interface ErrorDetail
  */
 export interface ErrorDetail {
     /**
-     *
+     * Human-readable error message.
      * @type {string}
      * @memberof ErrorDetail
      */
     message?: string;
+    /**
+     * Stable machine-readable error code. Hosted-mode errors use the `HostedTradingError` family (e.g. `INSUFFICIENT_ESCROW_BALANCE`, `BUILT_ORDER_EXPIRED`); pre-hosted local errors use the legacy family (e.g. `BAD_REQUEST`, `NOT_FOUND`).
+     * @type {string}
+     * @memberof ErrorDetail
+     */
+    code?: ErrorDetailCodeEnum;
+    /**
+     * Hint for clients: when `true`, the same request may succeed on retry (e.g. transient network or rate-limit conditions); when `false`, the caller should not retry without modifying the request.
+     * @type {boolean}
+     * @memberof ErrorDetail
+     */
+    retryable?: boolean;
+    /**
+     * Venue the error originated from, when known (e.g. 'polymarket', 'kalshi').
+     * @type {string}
+     * @memberof ErrorDetail
+     */
+    exchange?: string | null;
+    /**
+     * Free-form hosted-mode detail blob. Shape depends on `code` — e.g. for `INSUFFICIENT_ESCROW_BALANCE` it may include `{ requested, available }`; for `ORDER_SIZE_TOO_SMALL` it may include `{ min }`; for `BUILT_ORDER_EXPIRED` it may include `{ expiry }`.
+     * @type {{ [key: string]: any; }}
+     * @memberof ErrorDetail
+     */
+    detail?: {
+        [key: string]: any;
+    } | null;
 }
+/**
+ * @export
+ */
+export declare const ErrorDetailCodeEnum: {
+    readonly HostedTradingError: "HOSTED_TRADING_ERROR";
+    readonly InsufficientEscrowBalance: "INSUFFICIENT_ESCROW_BALANCE";
+    readonly OrderSizeTooSmall: "ORDER_SIZE_TOO_SMALL";
+    readonly InvalidApiKey: "INVALID_API_KEY";
+    readonly OutcomeNotFound: "OUTCOME_NOT_FOUND";
+    readonly CatalogUnavailable: "CATALOG_UNAVAILABLE";
+    readonly BuiltOrderExpired: "BUILT_ORDER_EXPIRED";
+    readonly InvalidSignature: "INVALID_SIGNATURE";
+    readonly NoLiquidity: "NO_LIQUIDITY";
+    readonly MissingWalletAddress: "MISSING_WALLET_ADDRESS";
+    readonly BadRequest: "BAD_REQUEST";
+    readonly AuthenticationError: "AUTHENTICATION_ERROR";
+    readonly PermissionDenied: "PERMISSION_DENIED";
+    readonly NotFound: "NOT_FOUND";
+    readonly OrderNotFound: "ORDER_NOT_FOUND";
+    readonly MarketNotFound: "MARKET_NOT_FOUND";
+    readonly EventNotFound: "EVENT_NOT_FOUND";
+    readonly RateLimitExceeded: "RATE_LIMIT_EXCEEDED";
+    readonly InvalidOrder: "INVALID_ORDER";
+    readonly InsufficientFunds: "INSUFFICIENT_FUNDS";
+    readonly ValidationError: "VALIDATION_ERROR";
+    readonly NetworkError: "NETWORK_ERROR";
+    readonly ExchangeNotAvailable: "EXCHANGE_NOT_AVAILABLE";
+    readonly NotSupported: "NOT_SUPPORTED";
+};
+export type ErrorDetailCodeEnum = typeof ErrorDetailCodeEnum[keyof typeof ErrorDetailCodeEnum];
 /**
  * Check if a given object implements the ErrorDetail interface.
  */

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

@@ -13,11 +13,41 @@
  * Do not edit the class manually.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorDetailCodeEnum = void 0;
 exports.instanceOfErrorDetail = instanceOfErrorDetail;
 exports.ErrorDetailFromJSON = ErrorDetailFromJSON;
 exports.ErrorDetailFromJSONTyped = ErrorDetailFromJSONTyped;
 exports.ErrorDetailToJSON = ErrorDetailToJSON;
 exports.ErrorDetailToJSONTyped = ErrorDetailToJSONTyped;
+/**
+ * @export
+ */
+exports.ErrorDetailCodeEnum = {
+    HostedTradingError: 'HOSTED_TRADING_ERROR',
+    InsufficientEscrowBalance: 'INSUFFICIENT_ESCROW_BALANCE',
+    OrderSizeTooSmall: 'ORDER_SIZE_TOO_SMALL',
+    InvalidApiKey: 'INVALID_API_KEY',
+    OutcomeNotFound: 'OUTCOME_NOT_FOUND',
+    CatalogUnavailable: 'CATALOG_UNAVAILABLE',
+    BuiltOrderExpired: 'BUILT_ORDER_EXPIRED',
+    InvalidSignature: 'INVALID_SIGNATURE',
+    NoLiquidity: 'NO_LIQUIDITY',
+    MissingWalletAddress: 'MISSING_WALLET_ADDRESS',
+    BadRequest: 'BAD_REQUEST',
+    AuthenticationError: 'AUTHENTICATION_ERROR',
+    PermissionDenied: 'PERMISSION_DENIED',
+    NotFound: 'NOT_FOUND',
+    OrderNotFound: 'ORDER_NOT_FOUND',
+    MarketNotFound: 'MARKET_NOT_FOUND',
+    EventNotFound: 'EVENT_NOT_FOUND',
+    RateLimitExceeded: 'RATE_LIMIT_EXCEEDED',
+    InvalidOrder: 'INVALID_ORDER',
+    InsufficientFunds: 'INSUFFICIENT_FUNDS',
+    ValidationError: 'VALIDATION_ERROR',
+    NetworkError: 'NETWORK_ERROR',
+    ExchangeNotAvailable: 'EXCHANGE_NOT_AVAILABLE',
+    NotSupported: 'NOT_SUPPORTED'
+};
 /**
  * Check if a given object implements the ErrorDetail interface.
  */
@@ -33,6 +63,10 @@ function ErrorDetailFromJSONTyped(json, ignoreDiscriminator) {
     }
     return {
         'message': json['message'] == null ? undefined : json['message'],
+        'code': json['code'] == null ? undefined : json['code'],
+        'retryable': json['retryable'] == null ? undefined : json['retryable'],
+        'exchange': json['exchange'] == null ? undefined : json['exchange'],
+        'detail': json['detail'] == null ? undefined : json['detail'],
     };
 }
 function ErrorDetailToJSON(json) {
@@ -44,5 +78,9 @@ function ErrorDetailToJSONTyped(value, ignoreDiscriminator = false) {
     }
     return {
         'message': value['message'],
+        'code': value['code'],
+        'retryable': value['retryable'],
+        'exchange': value['exchange'],
+        'detail': value['detail'],
     };
 }

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

@@ -0,0 +1,70 @@
+/**
+ * PMXT Sidecar API
+ * A unified local sidecar API for prediction markets (Polymarket, Kalshi, Limitless). This API acts as a JSON-RPC-style gateway. Each endpoint corresponds to a specific method on the generic exchange implementation.
+ *
+ * The version of the OpenAPI document: 0.4.4
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Constructor-level options for venue clients (Polymarket, Kalshi, Opinion, etc.).
+ * Hosted mode is the default when pmxtApiKey is set; otherwise the SDK runs against
+ * a local sidecar with venue credentials.
+ * @export
+ * @interface ExchangeOptions
+ */
+export interface ExchangeOptions {
+    /**
+     * PMXT customer API key. When set, the SDK routes to api.pmxt.dev (catalog) and trade.pmxt.dev (trading). Get one at pmxt.dev/dashboard.
+     * @type {string}
+     * @memberof ExchangeOptions
+     */
+    pmxtApiKey?: string;
+    /**
+     * EVM wallet address for hosted reads/writes. Required for endpoints that operate on a wallet (balances, positions, trades, open orders).
+     * @type {string}
+     * @memberof ExchangeOptions
+     */
+    walletAddress?: string | null;
+    /**
+     * Optional pre-built signer for hosted writes. If absent and privateKey is set, the SDK auto-wraps privateKey into a signer.
+     * @type {object}
+     * @memberof ExchangeOptions
+     */
+    signer?: object | null;
+    /**
+     * Private key. In hosted mode, used to derive an EIP-712 signer for writes (wraps into EthAccountSigner/EthersSigner). In self-hosted mode, used as the venue credential directly.
+     * @type {string}
+     * @memberof ExchangeOptions
+     */
+    privateKey?: string | null;
+    /**
+     * Explicit base URL override. When unset, the SDK uses api.pmxt.dev when pmxtApiKey is set, or the local sidecar otherwise.
+     * @type {string}
+     * @memberof ExchangeOptions
+     */
+    baseUrl?: string | null;
+    /**
+     * Venue-side API key (e.g. Polymarket CLOB key). Only relevant for self-hosted mode.
+     * @type {string}
+     * @memberof ExchangeOptions
+     */
+    apiKey?: string | null;
+    /**
+     * Auto-start the local sidecar when running self-hosted. Defaults to true when no pmxtApiKey is set, false when hosted.
+     * @type {boolean}
+     * @memberof ExchangeOptions
+     */
+    autoStartServer?: boolean | null;
+}
+/**
+ * Check if a given object implements the ExchangeOptions interface.
+ */
+export declare function instanceOfExchangeOptions(value: object): value is ExchangeOptions;
+export declare function ExchangeOptionsFromJSON(json: any): ExchangeOptions;
+export declare function ExchangeOptionsFromJSONTyped(json: any, ignoreDiscriminator: boolean): ExchangeOptions;
+export declare function ExchangeOptionsToJSON(json: any): ExchangeOptions;
+export declare function ExchangeOptionsToJSONTyped(value?: ExchangeOptions | null, ignoreDiscriminator?: boolean): any;

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

@@ -0,0 +1,60 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * PMXT Sidecar API
+ * A unified local sidecar API for prediction markets (Polymarket, Kalshi, Limitless). This API acts as a JSON-RPC-style gateway. Each endpoint corresponds to a specific method on the generic exchange implementation.
+ *
+ * The version of the OpenAPI document: 0.4.4
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instanceOfExchangeOptions = instanceOfExchangeOptions;
+exports.ExchangeOptionsFromJSON = ExchangeOptionsFromJSON;
+exports.ExchangeOptionsFromJSONTyped = ExchangeOptionsFromJSONTyped;
+exports.ExchangeOptionsToJSON = ExchangeOptionsToJSON;
+exports.ExchangeOptionsToJSONTyped = ExchangeOptionsToJSONTyped;
+/**
+ * Check if a given object implements the ExchangeOptions interface.
+ */
+function instanceOfExchangeOptions(value) {
+    return true;
+}
+function ExchangeOptionsFromJSON(json) {
+    return ExchangeOptionsFromJSONTyped(json, false);
+}
+function ExchangeOptionsFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'pmxtApiKey': json['pmxtApiKey'] == null ? undefined : json['pmxtApiKey'],
+        'walletAddress': json['walletAddress'] == null ? undefined : json['walletAddress'],
+        'signer': json['signer'] == null ? undefined : json['signer'],
+        'privateKey': json['privateKey'] == null ? undefined : json['privateKey'],
+        'baseUrl': json['baseUrl'] == null ? undefined : json['baseUrl'],
+        'apiKey': json['apiKey'] == null ? undefined : json['apiKey'],
+        'autoStartServer': json['autoStartServer'] == null ? undefined : json['autoStartServer'],
+    };
+}
+function ExchangeOptionsToJSON(json) {
+    return ExchangeOptionsToJSONTyped(json, false);
+}
+function ExchangeOptionsToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'pmxtApiKey': value['pmxtApiKey'],
+        'walletAddress': value['walletAddress'],
+        'signer': value['signer'],
+        'privateKey': value['privateKey'],
+        'baseUrl': value['baseUrl'],
+        'apiKey': value['apiKey'],
+        'autoStartServer': value['autoStartServer'],
+    };
+}

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

@@ -71,7 +71,7 @@ export interface MatchedMarketPair {
      */
     confidence?: number;
     /**
-     *
+     * Why the two markets were matched.
      * @type {string}
      * @memberof MatchedMarketPair
      */

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

@@ -99,6 +99,24 @@ export interface Order {
      * @memberof Order
      */
     feeRateBps?: number;
+    /**
+     * Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues.
+     * @type {string}
+     * @memberof Order
+     */
+    txHash?: string | null;
+    /**
+     * Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues.
+     * @type {string}
+     * @memberof Order
+     */
+    chain?: string | null;
+    /**
+     * Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues.
+     * @type {number}
+     * @memberof Order
+     */
+    blockNumber?: number | null;
 }
 /**
  * @export

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

@@ -91,6 +91,9 @@ function OrderFromJSONTyped(json, ignoreDiscriminator) {
         'timestamp': json['timestamp'],
         'fee': json['fee'] == null ? undefined : json['fee'],
         'feeRateBps': json['feeRateBps'] == null ? undefined : json['feeRateBps'],
+        'txHash': json['txHash'] == null ? undefined : json['txHash'],
+        'chain': json['chain'] == null ? undefined : json['chain'],
+        'blockNumber': json['blockNumber'] == null ? undefined : json['blockNumber'],
     };
 }
 function OrderToJSON(json) {
@@ -115,5 +118,8 @@ function OrderToJSONTyped(value, ignoreDiscriminator = false) {
         'timestamp': value['timestamp'],
         'fee': value['fee'],
         'feeRateBps': value['feeRateBps'],
+        'txHash': value['txHash'],
+        'chain': value['chain'],
+        'blockNumber': value['blockNumber'],
     };
 }

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

@@ -10,7 +10,7 @@
  * Do not edit the class manually.
  */
 /**
- *
+ * A current position in a market. In hosted mode, `outcomeLabel`, `entryPrice`, `currentPrice` and `unrealizedPnL` may be null when the server cannot derive them (e.g. `with_mtm=false` or no fill history). Venue-direct callers continue to populate every field.
  * @export
  * @interface Position
  */
@@ -28,11 +28,11 @@ export interface Position {
      */
     outcomeId: string;
     /**
-     * Human-readable label for the outcome held.
+     * Human-readable label for the outcome held. Optional in hosted mode.
      * @type {string}
      * @memberof Position
      */
-    outcomeLabel: string;
+    outcomeLabel?: string | null;
     /**
      * Positive for long, negative for short
      * @type {number}
@@ -40,29 +40,53 @@ export interface Position {
      */
     size: number;
     /**
-     * Average entry price for the position (probability between 0.0 and 1.0).
+     * Average entry price for the position (probability between 0.0 and 1.0). Optional in hosted mode when no fill history is available.
+     * @type {number}
+     * @memberof Position
+     */
+    entryPrice?: number | null;
+    /**
+     * Current mark price for the position (probability between 0.0 and 1.0). Optional in hosted mode when mark-to-market data is unavailable.
      * @type {number}
      * @memberof Position
      */
-    entryPrice: number;
+    currentPrice?: number | null;
     /**
-     * Current mark price for the position (probability between 0.0 and 1.0).
+     * Current market value of the position (size * currentPrice). Null when currentPrice is unavailable.
      * @type {number}
      * @memberof Position
      */
-    currentPrice: number;
+    currentValue?: number | null;
     /**
-     * Unrealized profit or loss at the current price (USD).
+     * Unrealized profit or loss at the current price (USD). Optional in hosted mode when mark-to-market data is unavailable.
      * @type {number}
      * @memberof Position
      */
-    unrealizedPnL: number;
+    unrealizedPnL?: number | null;
     /**
      * Realized profit or loss booked so far (USD).
      * @type {number}
      * @memberof Position
      */
     realizedPnL?: number;
+    /**
+     * Populated in hosted mode after on-chain settlement (from the last fill); null for local-mode and for non-on-chain venues.
+     * @type {string}
+     * @memberof Position
+     */
+    txHash?: string | null;
+    /**
+     * Populated in hosted mode after on-chain settlement (from the last fill); null for local-mode and for non-on-chain venues.
+     * @type {string}
+     * @memberof Position
+     */
+    chain?: string | null;
+    /**
+     * Populated in hosted mode after on-chain settlement (from the last fill); null for local-mode and for non-on-chain venues.
+     * @type {number}
+     * @memberof Position
+     */
+    blockNumber?: number | null;
 }
 /**
  * Check if a given object implements the Position interface.