pmxt-core 2.33.2 → 2.33.4

package/dist/BaseExchange.d.ts

@@ -571,35 +571,35 @@ export declare abstract class PredictionMarketExchange {
      */
     close(): Promise<void>;
     /**
-     * Fetch cross-venue matches for a given market.
+     * 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.
      *
      * @param params - Match filter parameters (marketId, relation, minConfidence, etc.)
      * @returns Array of matched markets with relation and confidence
      */
     fetchMatches(params: FetchMatchesParams): Promise<MatchResult[]>;
     /**
-     * Fetch cross-venue matches for a given event.
+     * 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.
      *
      * @param params - Event match filter parameters (eventId, relation, etc.)
      * @returns Array of matched events with market-level match details
      */
     fetchEventMatches(params: FetchEventMatchesParams): Promise<EventMatchResult[]>;
     /**
-     * Compare prices across venues for identity matches of a market.
+     * 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.
      *
      * @param params - Match filter parameters (uses relation: 'identity' internally)
      * @returns Array of price comparisons across venues
      */
     compareMarketPrices(params: FetchMatchesParams): Promise<PriceComparison[]>;
     /**
-     * Find hedging opportunities via subset/superset matches across venues.
+     * 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 identity matches.
+     * 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

@@ -764,7 +764,7 @@ class PredictionMarketExchange {
     // Matching Methods (Router-only; stubs throw for standard exchanges)
     // ----------------------------------------------------------------------------
     /**
-     * Fetch cross-venue matches for a given market.
+     * 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.
      *
      * @param params - Match filter parameters (marketId, relation, minConfidence, etc.)
      * @returns Array of matched markets with relation and confidence
@@ -773,7 +773,7 @@ class PredictionMarketExchange {
         throw new Error("Method fetchMatches not implemented.");
     }
     /**
-     * Fetch cross-venue matches for a given event.
+     * 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.
      *
      * @param params - Event match filter parameters (eventId, relation, etc.)
      * @returns Array of matched events with market-level match details
@@ -782,7 +782,7 @@ class PredictionMarketExchange {
         throw new Error("Method fetchEventMatches not implemented.");
     }
     /**
-     * Compare prices across venues for identity matches of a market.
+     * 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.
      *
      * @param params - Match filter parameters (uses relation: 'identity' internally)
      * @returns Array of price comparisons across venues
@@ -791,7 +791,7 @@ class PredictionMarketExchange {
         throw new Error("Method compareMarketPrices not implemented.");
     }
     /**
-     * Find hedging opportunities via subset/superset matches across venues.
+     * 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
@@ -800,7 +800,7 @@ class PredictionMarketExchange {
         throw new Error("Method fetchHedges not implemented.");
     }
     /**
-     * Scan for arbitrage opportunities across identity matches.
+     * 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/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-23T07:50:04.153Z
+ * Generated at: 2026-04-23T08:37:08.985Z
  * 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-23T07:50:04.153Z
+ * Generated at: 2026-04-23T08:37:08.985Z
  * 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-23T07:50:04.190Z
+ * Generated at: 2026-04-23T08:37:09.032Z
  * 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-23T07:50:04.190Z
+ * Generated at: 2026-04-23T08:37:09.032Z
  * 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-23T07:50:04.201Z
+ * Generated at: 2026-04-23T08:37:09.045Z
  * 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-23T07:50:04.201Z
+ * Generated at: 2026-04-23T08:37:09.045Z
  * 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-23T07:50:04.206Z
+ * Generated at: 2026-04-23T08:37:09.051Z
  * 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-23T07:50:04.206Z
+ * Generated at: 2026-04-23T08:37:09.051Z
  * 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-23T07:50:04.161Z
+ * Generated at: 2026-04-23T08:37:08.994Z
  * 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-23T07:50:04.161Z
+ * Generated at: 2026-04-23T08:37:08.994Z
  * 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-23T07:50:04.172Z
+ * Generated at: 2026-04-23T08:37:09.010Z
  * 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-23T07:50:04.172Z
+ * Generated at: 2026-04-23T08:37:09.010Z
  * 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-23T07:50:04.170Z
+ * Generated at: 2026-04-23T08:37:09.007Z
  * 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-23T07:50:04.170Z
+ * Generated at: 2026-04-23T08:37:09.007Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketGammaSpec = {

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-23T07:50:04.194Z
+ * Generated at: 2026-04-23T08:37:09.039Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 export declare const probableApiSpec: {

package/dist/exchanges/probable/api.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.probableApiSpec = void 0;
 /**
  * Auto-generated from /home/runner/work/pmxt/pmxt/core/specs/probable/probable.yaml
- * Generated at: 2026-04-23T07:50:04.194Z
+ * Generated at: 2026-04-23T08:37:09.039Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

package/dist/server/app.js

@@ -215,7 +215,14 @@ function createApp(options = {}) {
         try {
             const exchangeName = req.params.exchange.toLowerCase();
             let exchange;
-            if (credentials &&
+            if (exchangeName === "router") {
+                // Router uses the caller's Bearer token for its internal /v0/
+                // calls — not a server-side env var.  Each request may carry a
+                // different key, so Router is never cached as a singleton.
+                const bearer = req.headers.authorization?.replace(/^Bearer\s+/i, "") || "";
+                exchange = createExchange(exchangeName, undefined, bearer);
+            }
+            else if (credentials &&
                 (credentials.privateKey ||
                     credentials.apiKey ||
                     credentials.apiToken)) {
@@ -334,7 +341,7 @@ async function startServer(port, accessToken) {
     const app = createApp({ accessToken });
     return app.listen(port, "127.0.0.1");
 }
-function createExchange(name, credentials) {
+function createExchange(name, credentials, bearerToken) {
     switch (name) {
         case "polymarket":
             return new polymarket_1.PolymarketExchange({
@@ -413,7 +420,7 @@ function createExchange(name, credentials) {
             });
         case "router":
             return new router_1.Router({
-                apiKey: process.env.PMXT_API_KEY || '',
+                apiKey: bearerToken,
             });
         default:
             throw new Error(`Unknown exchange: ${name}`);

package/dist/server/openapi.yaml

@@ -530,7 +530,7 @@ paths:
         or throws EventNotFound.
   '/api/{exchange}/fetchOHLCV':
     get:
-      summary: Fetch O H L C V
+      summary: Fetch OHLCV
       operationId: fetchOHLCV
       parameters:
         - $ref: '#/components/parameters/ExchangeParam'
@@ -574,7 +574,7 @@ paths:
           description: Maximum number of results to return
       responses:
         '200':
-          description: Fetch O H L C V response
+          description: Fetch OHLCV response
           content:
             application/json:
               schema:
@@ -1466,7 +1466,7 @@ paths:
         connections.
   '/api/{exchange}/fetchMatches':
     get:
-      summary: Fetch Matches
+      summary: Find Similar Markets
       operationId: fetchMatches
       parameters:
         - $ref: '#/components/parameters/ExchangeParam'
@@ -1513,7 +1513,7 @@ paths:
             type: boolean
       responses:
         '200':
-          description: Fetch Matches response
+          description: Find Similar Markets response
           content:
             application/json:
               schema:
@@ -1525,10 +1525,13 @@ paths:
                         type: array
                         items:
                           $ref: '#/components/schemas/MatchResult'
-      description: Fetch cross-venue matches for a given market.
+      description: >-
+        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.
   '/api/{exchange}/fetchEventMatches':
     get:
-      summary: Fetch Event Matches
+      summary: Find Similar Events
       operationId: fetchEventMatches
       parameters:
         - $ref: '#/components/parameters/ExchangeParam'
@@ -1570,7 +1573,7 @@ paths:
             type: boolean
       responses:
         '200':
-          description: Fetch Event Matches response
+          description: Find Similar Events response
           content:
             application/json:
               schema:
@@ -1582,10 +1585,12 @@ paths:
                         type: array
                         items:
                           $ref: '#/components/schemas/EventMatchResult'
-      description: Fetch cross-venue matches for a given event.
+      description: >-
+        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.
   '/api/{exchange}/compareMarketPrices':
     post:
-      summary: Compare Market Prices
+      summary: Compare Prices Across Venues
       operationId: compareMarketPrices
       parameters:
         - $ref: '#/components/parameters/ExchangeParam'
@@ -1608,7 +1613,7 @@ paths:
                 - args
       responses:
         '200':
-          description: Compare Market Prices response
+          description: Compare Prices Across Venues response
           content:
             application/json:
               schema:
@@ -1620,10 +1625,12 @@ paths:
                         type: array
                         items:
                           $ref: '#/components/schemas/PriceComparison'
-      description: Compare prices across venues for identity matches of a market.
+      description: >-
+        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.
   '/api/{exchange}/fetchHedges':
     get:
-      summary: Fetch Hedges
+      summary: Find Hedging Opportunities
       operationId: fetchHedges
       parameters:
         - $ref: '#/components/parameters/ExchangeParam'
@@ -1670,7 +1677,7 @@ paths:
             type: boolean
       responses:
         '200':
-          description: Fetch Hedges response
+          description: Find Hedging Opportunities response
           content:
             application/json:
               schema:
@@ -1682,10 +1689,12 @@ paths:
                         type: array
                         items:
                           $ref: '#/components/schemas/PriceComparison'
-      description: Find hedging opportunities via subset/superset matches across venues.
+      description: >-
+        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.
   '/api/{exchange}/fetchArbitrage':
     get:
-      summary: Fetch Arbitrage
+      summary: Find Arbitrage Opportunities
       operationId: fetchArbitrage
       parameters:
         - $ref: '#/components/parameters/ExchangeParam'
@@ -1706,7 +1715,7 @@ paths:
             type: number
       responses:
         '200':
-          description: Fetch Arbitrage response
+          description: Find Arbitrage Opportunities response
           content:
             application/json:
               schema:
@@ -1718,7 +1727,9 @@ paths:
                         type: array
                         items:
                           $ref: '#/components/schemas/ArbitrageOpportunity'
-      description: Scan for arbitrage opportunities across identity matches.
+      description: >-
+        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.
 components:
   parameters:
     ExchangeParam:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxt-core",
-  "version": "2.33.2",
+  "version": "2.33.4",
   "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.33.2,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.33.2,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.33.4,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.33.4,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",