pmxt-core 2.48.6 → 2.49.1

package/dist/feeds/chainlink/chainlink-feed.js

@@ -139,7 +139,7 @@ class ChainlinkFeed extends base_feed_1.BaseDataFeed {
     // -- CCXT: watchTicker --
     watchTickerImpl(symbol, callback) {
         const sub = { symbol: symbol.toUpperCase(), callback };
-        this.subscriptions = [...this.subscriptions, sub];
+        this.subscriptions.push(sub);
         this.ensureConnected().catch((err) => {
             logger_1.logger.error('[ChainlinkFeed] initial connect failed in watchTickerImpl', { error: err instanceof Error ? err.message : String(err) });
         });
@@ -281,7 +281,10 @@ class ChainlinkFeed extends base_feed_1.BaseDataFeed {
         try {
             msg = JSON.parse(text);
         }
-        catch {
+        catch (error) {
+            logger_1.logger.debug('[ChainlinkFeed] failed to parse relay message', {
+                error: error instanceof Error ? error.message : String(error),
+            });
             return;
         }
         if (msg.op !== 'event')

package/dist/server/openapi.yaml

@@ -2612,9 +2612,108 @@ components:
           $ref: '#/components/schemas/ErrorDetail'
     ErrorDetail:
       type: object
+      description: >-
+        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`.
       properties:
         message:
           type: string
+          description: Human-readable error message.
+        code:
+          type: string
+          description: >-
+            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`).
+          enum:
+            - HOSTED_TRADING_ERROR
+            - INSUFFICIENT_ESCROW_BALANCE
+            - ORDER_SIZE_TOO_SMALL
+            - INVALID_API_KEY
+            - OUTCOME_NOT_FOUND
+            - CATALOG_UNAVAILABLE
+            - BUILT_ORDER_EXPIRED
+            - INVALID_SIGNATURE
+            - NO_LIQUIDITY
+            - MISSING_WALLET_ADDRESS
+            - BAD_REQUEST
+            - AUTHENTICATION_ERROR
+            - PERMISSION_DENIED
+            - NOT_FOUND
+            - ORDER_NOT_FOUND
+            - MARKET_NOT_FOUND
+            - EVENT_NOT_FOUND
+            - RATE_LIMIT_EXCEEDED
+            - INVALID_ORDER
+            - INSUFFICIENT_FUNDS
+            - VALIDATION_ERROR
+            - NETWORK_ERROR
+            - EXCHANGE_NOT_AVAILABLE
+            - NOT_SUPPORTED
+        retryable:
+          type: boolean
+          description: >-
+            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.
+        exchange:
+          type: string
+          nullable: true
+          description: 'Venue the error originated from, when known (e.g. ''polymarket'', ''kalshi'').'
+        detail:
+          type: object
+          additionalProperties: {}
+          nullable: true
+          description: >-
+            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 }`.
+    ExchangeOptions:
+      type: object
+      description: |-
+        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.
+      properties:
+        pmxtApiKey:
+          type: string
+          description: >-
+            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.
+        walletAddress:
+          type: string
+          nullable: true
+          description: >-
+            EVM wallet address for hosted reads/writes. Required for endpoints that operate on a wallet (balances,
+            positions, trades, open orders).
+        signer:
+          type: object
+          nullable: true
+          description: >-
+            Optional pre-built signer for hosted writes. If absent and privateKey is set, the SDK auto-wraps privateKey
+            into a signer.
+        privateKey:
+          type: string
+          nullable: true
+          description: >-
+            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.
+        baseUrl:
+          type: string
+          nullable: true
+          description: >-
+            Explicit base URL override. When unset, the SDK uses api.pmxt.dev when pmxtApiKey is set, or the local
+            sidecar otherwise.
+        apiKey:
+          type: string
+          nullable: true
+          description: Venue-side API key (e.g. Polymarket CLOB key). Only relevant for self-hosted mode.
+        autoStartServer:
+          type: boolean
+          nullable: true
+          description: >-
+            Auto-start the local sidecar when running self-hosted. Defaults to true when no pmxtApiKey is set, false
+            when hosted.
     BaseRequest:
       type: object
       description: Base request structure with optional credentials
@@ -2847,14 +2946,12 @@ components:
           type: string
           description: 'Human-readable series title (e.g. "ATP Match Winner", "WTA").'
         description:
-          oneOf:
-            - type: string
-            - {}
+          type: string
+          nullable: true
           description: Long-form series description.
         recurrence:
-          oneOf:
-            - type: string
-            - {}
+          type: string
+          nullable: true
           description: 'Recurrence cadence the venue reports (''daily'', ''weekly'', ''annual'', ...).'
         events:
           type: array
@@ -2862,14 +2959,12 @@ components:
             $ref: '#/components/schemas/UnifiedEvent'
           description: Child events. Populated when fetched by id; the list form usually omits this to keep payloads small.
         url:
-          oneOf:
-            - type: string
-            - {}
+          type: string
+          nullable: true
           description: Canonical venue URL for the series.
         image:
-          oneOf:
-            - type: string
-            - {}
+          type: string
+          nullable: true
           description: Venue-hosted image.
         sourceExchange:
           type: string
@@ -2939,6 +3034,8 @@ components:
         size:
           type: number
           description: contracts/shares
+        orderCount:
+          type: number
       required:
         - price
         - size
@@ -3001,6 +3098,18 @@ components:
         orderId:
           type: string
           description: 'The order that produced this trade, if known.'
+        txHash:
+          type: string
+          nullable: true
+          description: Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues.
+        chain:
+          type: string
+          nullable: true
+          description: Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues.
+        blockNumber:
+          type: number
+          nullable: true
+          description: Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues.
       required:
         - id
         - timestamp
@@ -3064,6 +3173,18 @@ components:
         feeRateBps:
           type: number
           description: Fee rate in basis points applied to this order (e.g. 100 = 1%).
+        txHash:
+          type: string
+          nullable: true
+          description: Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues.
+        chain:
+          type: string
+          nullable: true
+          description: Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues.
+        blockNumber:
+          type: number
+          nullable: true
+          description: Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues.
       required:
         - id
         - marketId
@@ -3077,6 +3198,10 @@ components:
         - timestamp
     Position:
       type: object
+      description: >-
+        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.
       properties:
         marketId:
           type: string
@@ -3086,30 +3211,58 @@ components:
           description: The outcome this position is held in.
         outcomeLabel:
           type: string
-          description: Human-readable label for the outcome held.
+          nullable: true
+          description: Human-readable label for the outcome held. Optional in hosted mode.
         size:
           type: number
           description: 'Positive for long, negative for short'
         entryPrice:
           type: number
-          description: Average entry price for the position (probability between 0.0 and 1.0).
+          nullable: true
+          description: >-
+            Average entry price for the position (probability between 0.0 and 1.0). Optional in hosted mode when no fill
+            history is available.
         currentPrice:
           type: number
-          description: Current mark price for the position (probability between 0.0 and 1.0).
+          nullable: true
+          description: >-
+            Current mark price for the position (probability between 0.0 and 1.0). Optional in hosted mode when
+            mark-to-market data is unavailable.
+        currentValue:
+          type: number
+          nullable: true
+          description: Current market value of the position (size * currentPrice). Null when currentPrice is unavailable.
         unrealizedPnL:
           type: number
-          description: Unrealized profit or loss at the current price (USD).
+          nullable: true
+          description: >-
+            Unrealized profit or loss at the current price (USD). Optional in hosted mode when mark-to-market data is
+            unavailable.
         realizedPnL:
           type: number
           description: Realized profit or loss booked so far (USD).
+        txHash:
+          type: string
+          nullable: true
+          description: >-
+            Populated in hosted mode after on-chain settlement (from the last fill); null for local-mode and for
+            non-on-chain venues.
+        chain:
+          type: string
+          nullable: true
+          description: >-
+            Populated in hosted mode after on-chain settlement (from the last fill); null for local-mode and for
+            non-on-chain venues.
+        blockNumber:
+          type: number
+          nullable: true
+          description: >-
+            Populated in hosted mode after on-chain settlement (from the last fill); null for local-mode and for
+            non-on-chain venues.
       required:
         - marketId
         - outcomeId
-        - outcomeLabel
         - size
-        - entryPrice
-        - currentPrice
-        - unrealizedPnL
     Balance:
       type: object
       properties:
@@ -3125,6 +3278,12 @@ components:
         locked:
           type: number
           description: In open orders
+        venue:
+          type: string
+          nullable: true
+          description: >-
+            Hosted-mode: which venue this balance belongs to in a multi-venue response. Null when the balance is
+            venue-agnostic.
       required:
         - currency
         - total
@@ -3455,6 +3614,12 @@ components:
             populates this.
         raw:
           description: 'The raw, exchange-native payload. Always present.'
+        expiry:
+          type: number
+          nullable: true
+          description: >-
+            Unix epoch (ms) when this built order expires server-side. Submitting after expiry returns
+            BUILT_ORDER_EXPIRED.
       required:
         - exchange
         - params
@@ -3764,17 +3929,14 @@ components:
         confidence:
           type: number
         reasoning:
-          oneOf:
-            - type: string
-            - {}
+          type: string
+          nullable: true
         bestBid:
-          oneOf:
-            - type: number
-            - {}
+          type: number
+          nullable: true
         bestAsk:
-          oneOf:
-            - type: number
-            - {}
+          type: number
+          nullable: true
       required:
         - market
         - relation
@@ -3811,17 +3973,14 @@ components:
         confidence:
           type: number
         reasoning:
-          oneOf:
-            - type: string
-            - {}
+          type: string
+          nullable: true
         bestBid:
-          oneOf:
-            - type: number
-            - {}
+          type: number
+          nullable: true
         bestAsk:
-          oneOf:
-            - type: number
-            - {}
+          type: number
+          nullable: true
         venue:
           type: string
       required:
@@ -3922,9 +4081,8 @@ components:
           type: number
           description: Match confidence score (0.0 to 1.0).
         reasoning:
-          oneOf:
-            - type: string
-            - {}
+          type: string
+          nullable: true
           description: Why the two markets were matched.
       required:
         - marketA

package/dist/types.d.ts

@@ -148,6 +148,7 @@ export interface PriceCandle {
 export interface OrderLevel {
     price: number;
     size: number;
+    orderCount?: number;
 }
 export interface OrderBook {
     /** Order book bid levels, sorted by price descending. */
@@ -176,6 +177,12 @@ export interface Trade {
 export interface UserTrade extends Trade {
     /** The order that produced this trade, if known. */
     orderId?: string;
+    /** Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues. */
+    txHash?: string | null;
+    /** Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues. */
+    chain?: string | null;
+    /** Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues. */
+    blockNumber?: number | null;
 }
 export interface QueuedPromise<T> {
     /** Internal: resolver for a queued promise. */
@@ -208,23 +215,45 @@ export interface Order {
     fee?: number;
     /** Fee rate in basis points applied to this order (e.g. 100 = 1%). */
     feeRateBps?: number;
+    /** Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues. */
+    txHash?: string | null;
+    /** Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues. */
+    chain?: string | null;
+    /** Populated in hosted mode after on-chain settlement; null for local-mode and for non-on-chain venues. */
+    blockNumber?: number | null;
 }
+/**
+ * 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 {
     /** The market this position is held in. */
     marketId: string;
     /** The outcome this position is held in. */
     outcomeId: string;
-    /** Human-readable label for the outcome held. */
-    outcomeLabel: string;
+    /** Human-readable label for the outcome held. Optional in hosted mode. */
+    outcomeLabel?: string | null;
     size: number;
-    /** Average entry price for the position (probability between 0.0 and 1.0). */
-    entryPrice: number;
-    /** Current mark price for the position (probability between 0.0 and 1.0). */
-    currentPrice: number;
-    /** Unrealized profit or loss at the current price (USD). */
-    unrealizedPnL: number;
+    /** Average entry price for the position (probability between 0.0 and 1.0). Optional in hosted mode when no fill history is available. */
+    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. */
+    currentPrice?: number | null;
+    /** Current market value of the position (size * currentPrice). Null when currentPrice is unavailable. */
+    currentValue?: number | null;
+    /** Unrealized profit or loss at the current price (USD). Optional in hosted mode when mark-to-market data is unavailable. */
+    unrealizedPnL?: number | null;
     /** Realized profit or loss booked so far (USD). */
     realizedPnL?: number;
+    /** Populated in hosted mode after on-chain settlement (from the last fill); null for local-mode and for non-on-chain venues. */
+    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. */
+    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. */
+    blockNumber?: number | null;
 }
 export interface Balance {
     currency: string;
@@ -233,6 +262,8 @@ export interface Balance {
     /** Balance available to trade (excludes locked funds). */
     available: number;
     locked: number;
+    /** Hosted-mode: which venue this balance belongs to in a multi-venue response. Null when the balance is venue-agnostic. */
+    venue?: string | null;
 }
 export interface CreateOrderParams {
     /** The market to trade on. */
@@ -273,4 +304,9 @@ export interface BuiltOrder {
     };
     /** The raw, exchange-native payload. Always present. */
     raw: unknown;
+    /**
+     * Unix epoch (ms) when this built order expires server-side.
+     * Submitting after expiry returns BUILT_ORDER_EXPIRED.
+     */
+    expiry?: number | null;
 }

package/dist/utils/throttler.js

@@ -17,12 +17,10 @@ class Throttler {
         this.maxQueueDepth = config.maxQueueDepth ?? 1000;
     }
     async throttle(cost = 1) {
-        return new Promise((resolve) => {
+        return new Promise((resolve, reject) => {
             if (this.queue.length >= this.maxQueueDepth) {
-                const dropped = this.queue.shift();
-                if (dropped) {
-                    dropped.resolve();
-                }
+                reject(new Error(`Throttler queue full (max depth ${this.maxQueueDepth})`));
+                return;
             }
             this.queue.push({ resolve, cost });
             if (!this.running) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxt-core",
-  "version": "2.48.6",
+  "version": "2.49.1",
   "description": "pmxt is a unified prediction market data API. The ccxt for prediction markets.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -29,8 +29,8 @@
     "test": "jest -c jest.config.js",
     "server": "tsx watch src/server/index.ts",
     "server:prod": "node dist/server/index.js",
-    "generate:sdk:python": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g python -o ../sdks/python/generated --package-name pmxt_internal --additional-properties=projectName=pmxt-internal,packageVersion=2.48.6,library=urllib3",
-    "generate:sdk:typescript": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g typescript-fetch -o ../sdks/typescript/generated --additional-properties=npmName=pmxtjs,npmVersion=2.48.6,supportsES6=true,typescriptThreePlus=true && node ../sdks/typescript/scripts/fix-generated.js",
+    "generate:sdk:python": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g python -o ../sdks/python/generated --package-name pmxt_internal --additional-properties=projectName=pmxt-internal,packageVersion=2.49.1,library=urllib3",
+    "generate:sdk:typescript": "npx @openapitools/openapi-generator-cli generate -i src/server/openapi.yaml -g typescript-fetch -o ../sdks/typescript/generated --additional-properties=npmName=pmxtjs,npmVersion=2.49.1,supportsES6=true,typescriptThreePlus=true && node ../sdks/typescript/scripts/fix-generated.js",
     "fetch:openapi": "node scripts/fetch-openapi-specs.js",
     "extract:jsdoc": "node ../scripts/extract-jsdoc.js",
     "generate:docs": "npm run extract:jsdoc && node ../scripts/generate-api-docs.js",
@@ -50,7 +50,7 @@
     "@polymarket/clob-client-v2": "^1.0.5",
     "@prob/clob": "0.5.0",
     "@solana/web3.js": "^1.98.4",
-    "axios": "^1.13.2",
+    "axios": "^1.17.0",
     "bs58": "^6.0.0",
     "cors": "^2.8.5",
     "dotenv": "^17.2.3",