pmxt-core 2.35.7 → 2.35.9

package/dist/BaseExchange.d.ts

@@ -2,7 +2,7 @@ import { AxiosInstance } from 'axios';
 import { SubscribedAddressSnapshot, SubscriptionOption } from './subscriber/base';
 import { Balance, BuiltOrder, CandleInterval, CreateOrderParams, Order, OrderBook, Position, PriceCandle, Trade, UnifiedEvent, UnifiedMarket, UserTrade } from './types';
 import { ExecutionPriceResult } from './utils/math';
-import type { FetchMarketMatchesParams, FetchMatchesParams, FetchEventMatchesParams, FetchArbitrageParams, MatchResult, EventMatchResult, PriceComparison, ArbitrageOpportunity } from './router/types';
+import type { FetchMarketMatchesParams, FetchMatchesParams, FetchEventMatchesParams, FetchArbitrageParams, FetchMatchedMarketsParams, FetchMatchedPricesParams, MatchResult, EventMatchResult, PriceComparison, ArbitrageOpportunity, MatchedMarketPair, MatchedPricePair } from './router/types';
 export interface ApiEndpoint {
     /** HTTP verb for the endpoint (e.g. GET, POST). */
     method: string;
@@ -236,9 +236,15 @@ export interface ExchangeHas {
     fetchEventMatches: ExchangeCapability;
     /** Whether this exchange supports comparing prices across venues. */
     compareMarketPrices: ExchangeCapability;
-    /** Whether this exchange supports finding hedging opportunities across venues. */
+    /** Whether this exchange supports finding related markets across venues. */
+    fetchRelatedMarkets: ExchangeCapability;
+    /** Whether this exchange supports fetching matched markets across venues. */
+    fetchMatchedMarkets: ExchangeCapability;
+    /** @deprecated Use {@link fetchMatchedMarkets} instead. */
+    fetchMatchedPrices: ExchangeCapability;
+    /** @deprecated Use {@link fetchRelatedMarkets} instead. */
     fetchHedges: ExchangeCapability;
-    /** Whether this exchange supports scanning for arbitrage opportunities. */
+    /** @deprecated Use {@link fetchMatchedMarkets} instead. */
     fetchArbitrage: ExchangeCapability;
 }
 /**
@@ -604,23 +610,35 @@ export declare abstract class PredictionMarketExchange {
      */
     close(): Promise<void>;
     /**
-     * Find the same or related market on other venues. Given a market on one venue, discover semantically equivalent markets across every other venue PMXT ingests — each with a relation type (identity, subset, superset, overlap, disjoint), confidence score, and reasoning.
+     * Find the same or related market on other venues. Two modes:
      *
-     * @param params - Match filter parameters (marketId, relation, minConfidence, etc.)
+     * **Lookup mode** (marketId/slug/url provided): Given a market on one venue, discover
+     * semantically equivalent markets across every other venue PMXT ingests.
+     *
+     * **Browse mode** (no identifier): Returns all matched market pairs from the catalog.
+     * Supports query, category, minDifference, and sort params for filtering.
+     *
+     * @param params - Match filter parameters
      * @returns Array of matched markets with relation and confidence
      */
-    fetchMarketMatches(params: FetchMarketMatchesParams): Promise<MatchResult[]>;
+    fetchMarketMatches(params?: FetchMarketMatchesParams): Promise<MatchResult[]>;
     /**
      * @deprecated Use {@link fetchMarketMatches} instead.
      */
     fetchMatches(params: FetchMatchesParams): Promise<MatchResult[]>;
     /**
-     * Find the same or related event on other venues. Given an event on one venue, discover semantically equivalent events across every other venue PMXT ingests — including market-level match details for each child market.
+     * Find the same or related event on other venues. Two modes:
+     *
+     * **Lookup mode** (eventId/slug provided): Given an event on one venue, discover
+     * semantically equivalent events across every other venue PMXT ingests.
      *
-     * @param params - Event match filter parameters (eventId, relation, etc.)
+     * **Browse mode** (no identifier): Returns all matched event pairs from the catalog.
+     * Supports query and category params for filtering.
+     *
+     * @param params - Event match filter parameters
      * @returns Array of matched events with market-level match details
      */
-    fetchEventMatches(params: FetchEventMatchesParams): Promise<EventMatchResult[]>;
+    fetchEventMatches(params?: FetchEventMatchesParams): Promise<EventMatchResult[]>;
     /**
      * Compare live prices for the same market across venues. Finds identity matches and returns side-by-side best bid/ask prices so you can spot price differences at a glance.
      *
@@ -629,14 +647,35 @@ export declare abstract class PredictionMarketExchange {
      */
     compareMarketPrices(params: FetchMatchesParams): Promise<PriceComparison[]>;
     /**
-     * Find hedging opportunities across venues. Discovers subset/superset market relationships where one market's outcome implies another, enabling cross-venue hedging strategies with live prices.
+     * Find related markets across venues. Discovers subset/superset market relationships
+     * where one market's outcome implies another, with live prices.
+     *
+     * @param params - Match filter parameters
+     * @returns Array of subset/superset matches with live prices
+     */
+    fetchRelatedMarkets(params: FetchMatchesParams): Promise<PriceComparison[]>;
+    /**
+     * @deprecated Use {@link fetchMarketMatches} without a marketId instead.
+     * Fetch matched markets across venues.
+     */
+    fetchMatchedMarkets(params?: FetchMatchedMarketsParams): Promise<MatchedMarketPair[]>;
+    /**
+     * @deprecated Use {@link fetchMatchedMarkets} instead. Compare matched market prices across venues. Finds markets listed on multiple venues
+     * and returns side-by-side pricing data.
+     *
+     * @param params - Price comparison parameters (minDifference, category, limit)
+     * @returns Array of matched market pairs with prices from each venue
+     */
+    fetchMatchedPrices(params?: FetchMatchedPricesParams): Promise<MatchedPricePair[]>;
+    /**
+     * @deprecated Use {@link fetchRelatedMarkets} instead. Find hedging opportunities across venues. Discovers subset/superset market relationships where one market's outcome implies another, enabling cross-venue hedging strategies with live prices.
      *
      * @param params - Match filter parameters
      * @returns Array of subset/superset matches with live prices
      */
     fetchHedges(params: FetchMatchesParams): Promise<PriceComparison[]>;
     /**
-     * Scan for arbitrage opportunities across venues. Finds identity matches where the same market is priced differently on different venues, returning opportunities sorted by spread size.
+     * @deprecated Use {@link fetchMatchedPrices} instead. Scan for arbitrage opportunities across venues. Finds identity matches where the same market is priced differently on different venues, returning opportunities sorted by spread size.
      *
      * @param params - Arbitrage scan parameters (minSpread, category, limit)
      * @returns Array of arbitrage opportunities sorted by spread

package/dist/BaseExchange.js

@@ -820,9 +820,15 @@ class PredictionMarketExchange {
     // Matching Methods (Router-only; stubs throw for standard exchanges)
     // ----------------------------------------------------------------------------
     /**
-     * Find the same or related market on other venues. Given a market on one venue, discover semantically equivalent markets across every other venue PMXT ingests — each with a relation type (identity, subset, superset, overlap, disjoint), confidence score, and reasoning.
+     * Find the same or related market on other venues. Two modes:
      *
-     * @param params - Match filter parameters (marketId, relation, minConfidence, etc.)
+     * **Lookup mode** (marketId/slug/url provided): Given a market on one venue, discover
+     * semantically equivalent markets across every other venue PMXT ingests.
+     *
+     * **Browse mode** (no identifier): Returns all matched market pairs from the catalog.
+     * Supports query, category, minDifference, and sort params for filtering.
+     *
+     * @param params - Match filter parameters
      * @returns Array of matched markets with relation and confidence
      */
     async fetchMarketMatches(params) {
@@ -836,9 +842,15 @@ class PredictionMarketExchange {
         return this.fetchMarketMatches(params);
     }
     /**
-     * Find the same or related event on other venues. Given an event on one venue, discover semantically equivalent events across every other venue PMXT ingests — including market-level match details for each child market.
+     * Find the same or related event on other venues. Two modes:
+     *
+     * **Lookup mode** (eventId/slug provided): Given an event on one venue, discover
+     * semantically equivalent events across every other venue PMXT ingests.
+     *
+     * **Browse mode** (no identifier): Returns all matched event pairs from the catalog.
+     * Supports query and category params for filtering.
      *
-     * @param params - Event match filter parameters (eventId, relation, etc.)
+     * @param params - Event match filter parameters
      * @returns Array of matched events with market-level match details
      */
     async fetchEventMatches(params) {
@@ -854,7 +866,34 @@ class PredictionMarketExchange {
         throw new Error("Method compareMarketPrices not implemented.");
     }
     /**
-     * Find hedging opportunities across venues. Discovers subset/superset market relationships where one market's outcome implies another, enabling cross-venue hedging strategies with live prices.
+     * Find related markets across venues. Discovers subset/superset market relationships
+     * where one market's outcome implies another, with live prices.
+     *
+     * @param params - Match filter parameters
+     * @returns Array of subset/superset matches with live prices
+     */
+    async fetchRelatedMarkets(params) {
+        throw new Error("Method fetchRelatedMarkets not implemented.");
+    }
+    /**
+     * @deprecated Use {@link fetchMarketMatches} without a marketId instead.
+     * Fetch matched markets across venues.
+     */
+    async fetchMatchedMarkets(params) {
+        throw new Error("Method fetchMatchedMarkets not implemented.");
+    }
+    /**
+     * @deprecated Use {@link fetchMatchedMarkets} instead. Compare matched market prices across venues. Finds markets listed on multiple venues
+     * and returns side-by-side pricing data.
+     *
+     * @param params - Price comparison parameters (minDifference, category, limit)
+     * @returns Array of matched market pairs with prices from each venue
+     */
+    async fetchMatchedPrices(params) {
+        throw new Error("Method fetchMatchedPrices not implemented.");
+    }
+    /**
+     * @deprecated Use {@link fetchRelatedMarkets} instead. Find hedging opportunities across venues. Discovers subset/superset market relationships where one market's outcome implies another, enabling cross-venue hedging strategies with live prices.
      *
      * @param params - Match filter parameters
      * @returns Array of subset/superset matches with live prices
@@ -863,7 +902,7 @@ class PredictionMarketExchange {
         throw new Error("Method fetchHedges not implemented.");
     }
     /**
-     * Scan for arbitrage opportunities across venues. Finds identity matches where the same market is priced differently on different venues, returning opportunities sorted by spread size.
+     * @deprecated Use {@link fetchMatchedPrices} instead. Scan for arbitrage opportunities across venues. Finds identity matches where the same market is priced differently on different venues, returning opportunities sorted by spread size.
      *
      * @param params - Arbitrage scan parameters (minSpread, category, limit)
      * @returns Array of arbitrage opportunities sorted by spread
@@ -998,7 +1037,7 @@ class PredictionMarketExchange {
         'unwatchOrderBook', 'watchTrades', 'fetchMyTrades',
         'fetchClosedOrders', 'fetchAllOrders', 'buildOrder', 'submitOrder',
         'fetchMarketMatches', 'fetchMatches', 'fetchEventMatches', 'compareMarketPrices',
-        'fetchHedges', 'fetchArbitrage',
+        'fetchRelatedMarkets', 'fetchMatchedMarkets', 'fetchMatchedPrices', 'fetchHedges', 'fetchArbitrage',
     ];
     // Compile-time exhaustiveness check: fails tsc if a key exists in
     // ExchangeHas but is missing from _capabilityKeys above.
@@ -1011,7 +1050,7 @@ class PredictionMarketExchange {
         watchTrades: true, fetchMyTrades: true, fetchClosedOrders: true,
         fetchAllOrders: true, buildOrder: true, submitOrder: true,
         fetchMarketMatches: true, fetchMatches: true, fetchEventMatches: true, compareMarketPrices: true,
-        fetchHedges: true, fetchArbitrage: true,
+        fetchRelatedMarkets: true, fetchMatchedMarkets: true, fetchMatchedPrices: true, fetchHedges: true, fetchArbitrage: true,
     };
     /**
      * Map from capability keys to the actual method(s) whose override status
@@ -1023,6 +1062,9 @@ class PredictionMarketExchange {
         fetchMarkets: 'fetchMarketsImpl',
         fetchEvents: 'fetchEventsImpl',
         fetchMatches: 'fetchMarketMatches',
+        fetchHedges: 'fetchRelatedMarkets',
+        fetchMatchedPrices: 'fetchMatchedMarkets',
+        fetchArbitrage: 'fetchMatchedMarkets',
     };
     /**
      * Derive the capability map by comparing this instance's prototype chain

package/dist/exchanges/kalshi/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/kalshi/Kalshi.yaml
- * Generated at: 2026-04-27T07:41:03.202Z
+ * Generated at: 2026-04-27T12:43:03.854Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const kalshiApiSpec: {

package/dist/exchanges/kalshi/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.kalshiApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/kalshi/Kalshi.yaml
- * Generated at: 2026-04-27T07:41:03.202Z
+ * Generated at: 2026-04-27T12:43:03.854Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.kalshiApiSpec = {

package/dist/exchanges/limitless/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/limitless/Limitless.yaml
- * Generated at: 2026-04-27T07:41:03.258Z
+ * Generated at: 2026-04-27T12:43:03.891Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const limitlessApiSpec: {

package/dist/exchanges/limitless/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.limitlessApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/limitless/Limitless.yaml
- * Generated at: 2026-04-27T07:41:03.258Z
+ * Generated at: 2026-04-27T12:43:03.891Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.limitlessApiSpec = {

package/dist/exchanges/myriad/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/myriad/myriad.yaml
- * Generated at: 2026-04-27T07:41:03.282Z
+ * Generated at: 2026-04-27T12:43:03.902Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const myriadApiSpec: {

package/dist/exchanges/myriad/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.myriadApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/myriad/myriad.yaml
- * Generated at: 2026-04-27T07:41:03.282Z
+ * Generated at: 2026-04-27T12:43:03.902Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.myriadApiSpec = {

package/dist/exchanges/opinion/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/opinion/opinion-openapi.yaml
- * Generated at: 2026-04-27T07:41:03.289Z
+ * Generated at: 2026-04-27T12:43:03.908Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const opinionApiSpec: {

package/dist/exchanges/opinion/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.opinionApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/opinion/opinion-openapi.yaml
- * Generated at: 2026-04-27T07:41:03.289Z
+ * Generated at: 2026-04-27T12:43:03.908Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.opinionApiSpec = {

package/dist/exchanges/polymarket/api-clob.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketClobAPI.yaml
- * Generated at: 2026-04-27T07:41:03.209Z
+ * Generated at: 2026-04-27T12:43:03.861Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const polymarketClobSpec: {

package/dist/exchanges/polymarket/api-clob.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.polymarketClobSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketClobAPI.yaml
- * Generated at: 2026-04-27T07:41:03.209Z
+ * Generated at: 2026-04-27T12:43:03.861Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketClobSpec = {

package/dist/exchanges/polymarket/api-data.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/Polymarket_Data_API.yaml
- * Generated at: 2026-04-27T07:41:03.231Z
+ * Generated at: 2026-04-27T12:43:03.873Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const polymarketDataSpec: {

package/dist/exchanges/polymarket/api-data.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.polymarketDataSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/Polymarket_Data_API.yaml
- * Generated at: 2026-04-27T07:41:03.231Z
+ * Generated at: 2026-04-27T12:43:03.873Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketDataSpec = {

package/dist/exchanges/polymarket/api-gamma.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketGammaAPI.yaml
- * Generated at: 2026-04-27T07:41:03.224Z
+ * Generated at: 2026-04-27T12:43:03.871Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const polymarketGammaSpec: {

package/dist/exchanges/polymarket/api-gamma.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.polymarketGammaSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/polymarket/PolymarketGammaAPI.yaml
- * Generated at: 2026-04-27T07:41:03.224Z
+ * Generated at: 2026-04-27T12:43:03.871Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketGammaSpec = {

package/dist/exchanges/polymarket/auth.d.ts

@@ -1,5 +1,5 @@
-import { ClobClient } from '@polymarket/clob-client';
-import type { ApiKeyCreds } from '@polymarket/clob-client';
+import { ClobClient } from '@polymarket/clob-client-v2';
+import type { ApiKeyCreds } from '@polymarket/clob-client-v2';
 import { ExchangeCredentials } from '../../BaseExchange';
 /**
  * Manages Polymarket authentication and CLOB client initialization.

package/dist/exchanges/polymarket/auth.js

@@ -4,7 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PolymarketAuth = void 0;
-const clob_client_1 = require("@polymarket/clob-client");
+const clob_client_v2_1 = require("@polymarket/clob-client-v2");
 const ethers_1 = require("ethers");
 const axios_1 = __importDefault(require("axios"));
 const errors_1 = require("./errors");
@@ -68,7 +68,11 @@ class PolymarketAuth {
             return this.apiCreds;
         }
         // Otherwise, derive/create them using L1 auth
-        const l1Client = new clob_client_1.ClobClient(POLYMARKET_HOST, POLYGON_CHAIN_ID, this.signer);
+        const l1Client = new clob_client_v2_1.ClobClient({
+            host: POLYMARKET_HOST,
+            chain: POLYGON_CHAIN_ID,
+            signer: this.signer,
+        });
         // Robust derivation strategy:
         // 1. Try to DERIVE existing credentials first (most common case).
         // 2. If that fails (e.g. 404 or 400), try to CREATE new ones.
@@ -219,7 +223,14 @@ class PolymarketAuth {
         const finalSignatureType = signatureType;
         // Create L2-authenticated client
         // console.log(`[PolymarketAuth] Initializing ClobClient | Signer: ${signerAddress} | Funder: ${finalProxyAddress} | SigType: ${finalSignatureType}`);
-        this.clobClient = new clob_client_1.ClobClient(POLYMARKET_HOST, POLYGON_CHAIN_ID, this.signer, apiCreds, finalSignatureType, finalProxyAddress);
+        this.clobClient = new clob_client_v2_1.ClobClient({
+            host: POLYMARKET_HOST,
+            chain: POLYGON_CHAIN_ID,
+            signer: this.signer,
+            creds: apiCreds,
+            signatureType: finalSignatureType,
+            funderAddress: finalProxyAddress,
+        });
         return this.clobClient;
     }
     /**

package/dist/exchanges/polymarket/errors.d.ts

@@ -1,18 +1,33 @@
 import { ErrorMapper } from '../../utils/error-mapper';
-import { BadRequest } from '../../errors';
+import { BaseError, BadRequest } from '../../errors';
 /**
  * Polymarket-specific error mapper
  *
- * Handles CLOB-specific error patterns and message formats.
+ * Handles CLOB V2 error patterns. V2 returns `{ "error": "<message>" }` on all
+ * error responses. The base ErrorMapper already extracts `data.error` when it is
+ * a string, so no extractErrorMessage override is needed.
+ *
+ * V2-specific status codes handled here:
+ *   425 Too Early  -- matching engine restarting (retryable)
+ *   503 Service Unavailable -- exchange paused / cancel-only mode
  */
 export declare class PolymarketErrorMapper extends ErrorMapper {
     constructor();
     /**
      * Override to handle Polymarket-specific error patterns
+     *
+     * V2 returns `{ "error": "<message>" }` as a plain string. The base class
+     * handles this natively via `data.error` (string path). We keep the legacy
+     * `errorMsg` path for any residual V1 responses (order submission still
+     * returns `errorMsg` in some batch flows).
      */
     protected extractErrorMessage(error: any): string;
     /**
-     * Override to detect Polymarket-specific error patterns
+     * Override to handle V2 status code 425 (Too Early -- matching engine restarting)
+     */
+    protected mapByStatusCode(status: number, message: string, data: any, response?: any): BaseError;
+    /**
+     * Override to detect Polymarket-specific error patterns in 400 responses
      */
     protected mapBadRequestError(message: string, data: any): BadRequest;
 }

package/dist/exchanges/polymarket/errors.js

@@ -10,7 +10,13 @@ const errors_1 = require("../../errors");
 /**
  * Polymarket-specific error mapper
  *
- * Handles CLOB-specific error patterns and message formats.
+ * Handles CLOB V2 error patterns. V2 returns `{ "error": "<message>" }` on all
+ * error responses. The base ErrorMapper already extracts `data.error` when it is
+ * a string, so no extractErrorMessage override is needed.
+ *
+ * V2-specific status codes handled here:
+ *   425 Too Early  -- matching engine restarting (retryable)
+ *   503 Service Unavailable -- exchange paused / cancel-only mode
  */
 class PolymarketErrorMapper extends error_mapper_1.ErrorMapper {
     constructor() {
@@ -18,38 +24,65 @@ class PolymarketErrorMapper extends error_mapper_1.ErrorMapper {
     }
     /**
      * Override to handle Polymarket-specific error patterns
+     *
+     * V2 returns `{ "error": "<message>" }` as a plain string. The base class
+     * handles this natively via `data.error` (string path). We keep the legacy
+     * `errorMsg` path for any residual V1 responses (order submission still
+     * returns `errorMsg` in some batch flows).
      */
     extractErrorMessage(error) {
-        // Handle Polymarket CLOB errors
         if (axios_1.default.isAxiosError(error) && error.response?.data) {
             const data = error.response.data;
-            // Polymarket uses errorMsg field
+            // V2 format: { "error": "<message>" }
+            if (typeof data.error === 'string') {
+                return data.error;
+            }
+            // Legacy V1 format: { "errorMsg": "<message>" }
             if (data.errorMsg) {
                 return data.errorMsg;
             }
-            // Also check standard error paths
-            if (data.error?.message) {
-                return data.error.message;
-            }
-            if (data.message) {
-                return data.message;
-            }
         }
         return super.extractErrorMessage(error);
     }
     /**
-     * Override to detect Polymarket-specific error patterns
+     * Override to handle V2 status code 425 (Too Early -- matching engine restarting)
+     */
+    mapByStatusCode(status, message, data, response) {
+        if (status === 425) {
+            return new errors_1.ExchangeNotAvailable(`Matching engine restarting: ${message}`, this.exchangeName);
+        }
+        return super.mapByStatusCode(status, message, data, response);
+    }
+    /**
+     * Override to detect Polymarket-specific error patterns in 400 responses
      */
     mapBadRequestError(message, data) {
         const lowerMessage = message.toLowerCase();
-        // Polymarket-specific authentication errors (400 status)
+        // Authentication errors surfaced as 400
         if (lowerMessage.includes('api key') ||
             lowerMessage.includes('proxy') ||
-            lowerMessage.includes('signature type')) {
+            lowerMessage.includes('signature type') ||
+            lowerMessage.includes('l1 request headers')) {
             return new errors_1.AuthenticationError(message, this.exchangeName);
         }
-        // Polymarket-specific order validation
-        if (lowerMessage.includes('tick size')) {
+        // Trading disabled / cancel-only mode -- exchange-level unavailability
+        if (lowerMessage.includes('trading is currently disabled') ||
+            lowerMessage.includes('trading is currently cancel-only')) {
+            return new errors_1.ExchangeNotAvailable(message, this.exchangeName);
+        }
+        // Address banned or restricted
+        if (lowerMessage.includes('address banned') ||
+            lowerMessage.includes('closed only mode')) {
+            return new errors_1.PermissionDenied(message, this.exchangeName);
+        }
+        // Order validation errors
+        if (lowerMessage.includes('tick size') ||
+            lowerMessage.includes('post-only order') ||
+            lowerMessage.includes('duplicated') ||
+            lowerMessage.includes('size lower than') ||
+            lowerMessage.includes('invalid expiration') ||
+            lowerMessage.includes('fok order') ||
+            lowerMessage.includes('fak order')) {
             return new errors_1.InvalidOrder(message, this.exchangeName);
         }
         // Fall back to base error mapping

package/dist/exchanges/polymarket/index.d.ts

@@ -63,7 +63,7 @@ export declare class PolymarketExchange extends PredictionMarketExchange {
      * Ensure authentication is initialized before trading operations.
      */
     private ensureAuth;
-    /** Fetch on-chain USDC balance on Polygon for any address without requiring credentials. */
+    /** Fetch on-chain pUSD balance on Polygon for any address without requiring credentials. */
     private getAddressOnChainBalance;
     private ensureWs;
     private fetchWatchedAddressActivity;

package/dist/exchanges/polymarket/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PolymarketExchange = exports.buildPolymarketTradesActivity = exports.POLYMARKET_DEFAULT_SUBSCRIPTION = void 0;
-const clob_client_1 = require("@polymarket/clob-client");
+const clob_client_v2_1 = require("@polymarket/clob-client-v2");
 const crypto_1 = require("crypto");
 const BaseExchange_1 = require("../../BaseExchange");
 const errors_1 = require("../../errors");
@@ -152,8 +152,8 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
         try {
             const auth = this.ensureAuth();
             const client = await auth.getClobClient();
-            const side = params.side.toUpperCase() === 'BUY' ? clob_client_1.Side.BUY : clob_client_1.Side.SELL;
-            const price = params.price || (side === clob_client_1.Side.BUY ? 0.99 : 0.01);
+            const side = params.side.toUpperCase() === 'BUY' ? clob_client_v2_1.Side.BUY : clob_client_v2_1.Side.SELL;
+            const price = params.price || (side === clob_client_v2_1.Side.BUY ? 0.99 : 0.01);
             const tickSize = params.tickSize ? params.tickSize.toString() : undefined;
             const orderArgs = {
                 tokenID: params.outcomeId,
@@ -161,8 +161,6 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
                 side,
                 size: params.amount,
             };
-            if (params.fee != null)
-                orderArgs.feeRateBps = params.fee;
             const options = {};
             if (tickSize)
                 options.tickSize = tickSize;
@@ -188,8 +186,8 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
             if (!response || !response.success) {
                 throw new Error(`${response?.errorMsg || 'Order submission failed'} (Response: ${JSON.stringify(response)})`);
             }
-            const side = built.params.side.toUpperCase() === 'BUY' ? clob_client_1.Side.BUY : clob_client_1.Side.SELL;
-            const price = built.params.price || (side === clob_client_1.Side.BUY ? 0.99 : 0.01);
+            const side = built.params.side.toUpperCase() === 'BUY' ? clob_client_v2_1.Side.BUY : clob_client_v2_1.Side.SELL;
+            const price = built.params.price || (side === clob_client_v2_1.Side.BUY ? 0.99 : 0.01);
             return {
                 id: response.orderID,
                 marketId: built.params.marketId,
@@ -334,7 +332,7 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
             let clobBalanceAvailable = false;
             try {
                 const balRes = await client.getBalanceAllowance({
-                    asset_type: clob_client_1.AssetType.COLLATERAL,
+                    asset_type: clob_client_v2_1.AssetType.COLLATERAL,
                 });
                 if (balRes && typeof balRes.balance === 'string') {
                     const rawBalance = parseFloat(balRes.balance);
@@ -378,7 +376,7 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
                 const openOrders = await client.getOpenOrders({});
                 if (Array.isArray(openOrders)) {
                     for (const order of openOrders) {
-                        if (order.side === clob_client_1.Side.BUY) {
+                        if (order.side === clob_client_v2_1.Side.BUY) {
                             const remainingSize = parseFloat(order.original_size) - parseFloat(order.size_matched);
                             const price = parseFloat(order.price);
                             locked += remainingSize * price;
@@ -528,7 +526,7 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
         }
         return this.auth;
     }
-    /** Fetch on-chain USDC balance on Polygon for any address without requiring credentials. */
+    /** Fetch on-chain pUSD balance on Polygon for any address without requiring credentials. */
     async getAddressOnChainBalance(address) {
         const { ethers } = require('ethers');
         if (!ethers.utils.isAddress(address)) {
@@ -540,14 +538,14 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
             chainId: 137,
             name: 'matic',
         });
-        const usdcAddress = '0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174'; // USDC.e (Bridged)
-        const usdcAbi = [
+        const pusdAddress = '0xC011a7E12a19f7B1f670d46F03B03f3342E82DFB'; // pUSD (Polymarket USD)
+        const erc20Abi = [
             'function balanceOf(address) view returns (uint256)',
             'function decimals() view returns (uint8)',
         ];
-        const usdcContract = new ethers.Contract(usdcAddress, usdcAbi, provider);
-        const rawBalance = await usdcContract.balanceOf(address);
-        const decimals = await usdcContract.decimals();
+        const pusdContract = new ethers.Contract(pusdAddress, erc20Abi, provider);
+        const rawBalance = await pusdContract.balanceOf(address);
+        const decimals = await pusdContract.decimals();
         const total = parseFloat(ethers.utils.formatUnits(rawBalance, decimals));
         return [{ currency: 'USDC', total, available: total, locked: 0 }];
     }

package/dist/exchanges/probable/api.d.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/probable/probable.yaml
- * Generated at: 2026-04-27T07:41:03.268Z
+ * Generated at: 2026-04-27T12:43:03.895Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const probableApiSpec: {