pmxt-core 2.35.17 → 2.35.18

package/dist/BaseExchange.d.ts

@@ -49,9 +49,9 @@ export interface MarketFilterParams {
 export interface MarketFetchParams extends MarketFilterParams {
     /** Optional client-side filter applied after fetching */
     filter?: MarketFilterCriteria;
-    /** Shorthand for filter.category -- merged into filter (takes precedence) */
+    /** Filter by category. Each market belongs to a venue-assigned category such as "Sports", "Politics", "Crypto", "Bitcoin", "Soccer", "Economic Policy" (Polymarket) or "Sports", "Mentions" (Kalshi). */
     category?: string;
-    /** Shorthand for filter.tags -- merged into filter (takes precedence) */
+    /** Filter by tags. Returns markets matching ANY of the provided tags. Tags are more specific than categories -- for example a "Sports" market might carry tags ["Sports", "FIFA World Cup", "2026 FIFA World Cup"]. Common tags include "Crypto", "Politics", "Elections", "Geopolitics", "Fed Rates", "Trump". */
     tags?: string[];
 }
 export interface EventFetchParams {
@@ -69,9 +69,9 @@ export interface EventFetchParams {
     slug?: string;
     /** Optional client-side filter applied after fetching */
     filter?: EventFilterCriteria;
-    /** Shorthand for filter.category -- merged into filter (takes precedence) */
+    /** Filter by category. Each event belongs to a venue-assigned category such as "Sports", "Politics", "Crypto", "Bitcoin", "Soccer", "Economic Policy" (Polymarket) or "Sports", "Mentions" (Kalshi). */
     category?: string;
-    /** Shorthand for filter.tags -- merged into filter (takes precedence) */
+    /** Filter by tags. Returns events matching ANY of the provided tags. Tags are more specific than categories -- for example a "Politics" event might carry tags ["Politics", "Geopolitics", "Middle East", "Iran"]. Common tags include "Crypto", "Elections", "Fed Rates", "FIFA World Cup", "Trump". */
     tags?: string[];
 }
 /**
@@ -154,7 +154,9 @@ export interface MarketFilterCriteria {
         before?: Date;
         after?: Date;
     };
+    /** Filter by category. Common values: "Sports", "Politics", "Crypto", "Bitcoin", "Soccer", "Economic Policy" (Polymarket) or "Sports", "Mentions" (Kalshi). */
     category?: string;
+    /** Match markets that have ANY of these tags. Examples: ["Crypto", "Crypto Prices"], ["Politics", "Elections"], ["Sports", "FIFA World Cup"]. */
     tags?: string[];
     price?: {
         outcome: 'yes' | 'no' | 'up' | 'down';
@@ -171,8 +173,9 @@ export type MarketFilterFunction = (market: UnifiedMarket) => boolean;
 export interface EventFilterCriteria {
     text?: string;
     searchIn?: ('title' | 'description' | 'category' | 'tags')[];
+    /** Filter by category. Common values: "Sports", "Politics", "Crypto", "Bitcoin", "Soccer", "Economic Policy" (Polymarket) or "Sports", "Mentions" (Kalshi). */
     category?: string;
-    /** Match events that have any of these tags */
+    /** Match events that have ANY of these tags. Examples: ["Crypto"], ["Politics", "Geopolitics", "Middle East"], ["Sports", "FIFA World Cup"]. */
     tags?: string[];
     marketCount?: {
         min?: number;

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-28T14:37:14.451Z
+ * Generated at: 2026-04-28T16:04:56.022Z
  * 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-28T14:37:14.451Z
+ * Generated at: 2026-04-28T16:04:56.022Z
  * 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-28T14:37:14.734Z
+ * Generated at: 2026-04-28T16:04:56.064Z
  * 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-28T14:37:14.734Z
+ * Generated at: 2026-04-28T16:04:56.064Z
  * 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-28T14:37:14.743Z
+ * Generated at: 2026-04-28T16:04:56.079Z
  * 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-28T14:37:14.743Z
+ * Generated at: 2026-04-28T16:04:56.079Z
  * 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-28T14:37:14.745Z
+ * Generated at: 2026-04-28T16:04:56.084Z
  * 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-28T14:37:14.745Z
+ * Generated at: 2026-04-28T16:04:56.084Z
  * 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-28T14:37:14.481Z
+ * Generated at: 2026-04-28T16:04:56.029Z
  * 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-28T14:37:14.481Z
+ * Generated at: 2026-04-28T16:04:56.029Z
  * 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-28T14:37:14.720Z
+ * Generated at: 2026-04-28T16:04:56.044Z
  * 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-28T14:37:14.720Z
+ * Generated at: 2026-04-28T16:04:56.044Z
  * 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-28T14:37:14.651Z
+ * Generated at: 2026-04-28T16:04:56.041Z
  * 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-28T14:37:14.651Z
+ * Generated at: 2026-04-28T16:04:56.041Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketGammaSpec = {

package/dist/exchanges/polymarket/fetcher.js

@@ -234,10 +234,13 @@ class PolymarketFetcher {
         return response.data || [];
     }
     async fetchRawMarketsBySlug(slug) {
-        const response = await this.http.get(utils_1.GAMMA_API_URL, {
-            params: { slug },
-        });
-        return response.data || [];
+        const response = await this.http.get(`${GAMMA_MARKETS_URL}/slug/${slug}`);
+        const market = response.data;
+        if (!market)
+            return [];
+        // Wrap in event-like shape for consistent normalizer input
+        const event = market.events?.[0] || market;
+        return [{ ...event, markets: [market] }];
     }
     async fetchRawMarketsSearch(params) {
         const limit = params?.limit || 250000;

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-28T14:37:14.739Z
+ * Generated at: 2026-04-28T16:04:56.071Z
  * 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-28T14:37:14.739Z
+ * Generated at: 2026-04-28T16:04:56.071Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

package/dist/server/openapi.yaml

@@ -332,7 +332,9 @@ paths:
           required: false
           schema:
             type: string
-          description: Shorthand for filter.category -- merged into filter (takes precedence)
+          description: >-
+            Filter by category. Each event belongs to a venue-assigned category such as "Sports", "Politics", "Crypto",
+            "Bitcoin", "Soccer", "Economic Policy" (Polymarket) or "Sports", "Mentions" (Kalshi).
         - in: query
           name: tags
           required: false
@@ -340,7 +342,10 @@ paths:
             type: array
             items:
               type: string
-          description: Shorthand for filter.tags -- merged into filter (takes precedence)
+          description: >-
+            Filter by tags. Returns events matching ANY of the provided tags. Tags are more specific than categories --
+            for example a "Politics" event might carry tags ["Politics", "Geopolitics", "Middle East", "Iran"]. Common
+            tags include "Crypto", "Elections", "Fed Rates", "FIFA World Cup", "Trump".
       responses:
         '200':
           description: Fetch Events response
@@ -543,7 +548,9 @@ paths:
           required: false
           schema:
             type: string
-          description: Shorthand for filter.category -- merged into filter (takes precedence)
+          description: >-
+            Filter by category. Each event belongs to a venue-assigned category such as "Sports", "Politics", "Crypto",
+            "Bitcoin", "Soccer", "Economic Policy" (Polymarket) or "Sports", "Mentions" (Kalshi).
         - in: query
           name: tags
           required: false
@@ -551,7 +558,10 @@ paths:
             type: array
             items:
               type: string
-          description: Shorthand for filter.tags -- merged into filter (takes precedence)
+          description: >-
+            Filter by tags. Returns events matching ANY of the provided tags. Tags are more specific than categories --
+            for example a "Politics" event might carry tags ["Politics", "Geopolitics", "Middle East", "Iran"]. Common
+            tags include "Crypto", "Elections", "Fed Rates", "FIFA World Cup", "Trump".
       responses:
         '200':
           description: Fetch Event response
@@ -2164,12 +2174,18 @@ components:
           description: Optional image URL for the market.
         category:
           type: string
-          description: 'Optional category label (e.g., "Politics", "Crypto").'
+          description: >-
+            Optional category label. Venue-defined — common values include "Sports", "Politics", "Crypto", "Economics",
+            "Science", "Culture". Polymarket uses finer-grained categories like "Bitcoin", "Soccer", "Economic Policy";
+            Kalshi uses broader ones like "Sports" or "Mentions".
         tags:
           type: array
           items:
             type: string
-          description: Optional list of tags associated with the market.
+          description: >-
+            Optional list of tags. More granular than category — e.g. ["Crypto", "Crypto Prices", "Bitcoin"] or
+            ["Politics", "Elections", "Trump"]. Tags vary by venue: Polymarket markets carry several, Kalshi typically
+            one.
         tickSize:
           type: number
           description: 'Minimum price increment (e.g., 0.01, 0.001)'
@@ -2268,12 +2284,18 @@ components:
           description: Optional image URL for the event.
         category:
           type: string
-          description: 'Optional category label (e.g., "Politics", "Sports").'
+          description: >-
+            Optional category label. Venue-defined — common values include "Sports", "Politics", "Crypto", "Economics",
+            "Science", "Culture". Polymarket uses finer-grained categories like "Bitcoin", "Soccer", "Economic Policy";
+            Kalshi uses broader ones like "Sports" or "Mentions".
         tags:
           type: array
           items:
             type: string
-          description: Optional list of tags associated with the event.
+          description: >-
+            Optional list of tags. More granular than category — e.g. ["Sports", "FIFA World Cup", "2026 FIFA World
+            Cup"] or ["Politics", "Geopolitics", "Middle East"]. Tags vary by venue: Polymarket markets carry several,
+            Kalshi typically one.
         sourceExchange:
           type: string
           description: 'The exchange/venue this event originates from (e.g. ''polymarket'', ''kalshi''). Populated by the Router.'
@@ -2672,12 +2694,17 @@ components:
           description: Optional client-side filter applied after fetching
         category:
           type: string
-          description: Shorthand for filter.category -- merged into filter (takes precedence)
+          description: >-
+            Filter by category. Each event belongs to a venue-assigned category such as "Sports", "Politics", "Crypto",
+            "Bitcoin", "Soccer", "Economic Policy" (Polymarket) or "Sports", "Mentions" (Kalshi).
         tags:
           type: array
           items:
             type: string
-          description: Shorthand for filter.tags -- merged into filter (takes precedence)
+          description: >-
+            Filter by tags. Returns events matching ANY of the provided tags. Tags are more specific than categories --
+            for example a "Politics" event might carry tags ["Politics", "Geopolitics", "Middle East", "Iran"]. Common
+            tags include "Crypto", "Elections", "Fed Rates", "FIFA World Cup", "Trump".
     HistoryFilterParams:
       type: object
       description: Deprecated - use OHLCVParams or TradesParams instead. Resolution is optional for backward compatibility.
@@ -2912,11 +2939,16 @@ components:
               format: date-time
         category:
           type: string
+          description: >-
+            Filter by category. Common values: "Sports", "Politics", "Crypto", "Bitcoin", "Soccer", "Economic Policy"
+            (Polymarket) or "Sports", "Mentions" (Kalshi).
         tags:
           type: array
           items:
             type: string
-          description: Match if market has ANY of these tags
+          description: >-
+            Match markets that have ANY of these tags. Examples: ["Crypto", "Crypto Prices"], ["Politics", "Elections"],
+            ["Sports", "FIFA World Cup"].
         price:
           type: object
           properties:
@@ -2966,11 +2998,16 @@ components:
           description: 'Default: [''title'']'
         category:
           type: string
+          description: >-
+            Filter by category. Common values: "Sports", "Politics", "Crypto", "Bitcoin", "Soccer", "Economic Policy"
+            (Polymarket) or "Sports", "Mentions" (Kalshi).
         tags:
           type: array
           items:
             type: string
-          description: Match events that have any of these tags
+          description: >-
+            Match events that have ANY of these tags. Examples: ["Crypto"], ["Politics", "Geopolitics", "Middle East"],
+            ["Sports", "FIFA World Cup"].
         marketCount:
           type: object
           properties:

package/dist/types.d.ts

@@ -33,9 +33,9 @@ export interface UnifiedEvent {
     url: string;
     /** Optional image URL for the event. */
     image?: string;
-    /** Optional category label (e.g., "Politics", "Sports"). */
+    /** Optional category label. Venue-defined — common values include "Sports", "Politics", "Crypto", "Economics", "Science", "Culture". Polymarket uses finer-grained categories like "Bitcoin", "Soccer", "Economic Policy"; Kalshi uses broader ones like "Sports" or "Mentions". */
     category?: string;
-    /** Optional list of tags associated with the event. */
+    /** Optional list of tags. More granular than category — e.g. ["Sports", "FIFA World Cup", "2026 FIFA World Cup"] or ["Politics", "Geopolitics", "Middle East"]. Tags vary by venue: Polymarket markets carry several, Kalshi typically one. */
     tags?: string[];
     /** The exchange/venue this event originates from (e.g. 'polymarket', 'kalshi'). Populated by the Router. */
     sourceExchange?: string;
@@ -66,9 +66,9 @@ export interface UnifiedMarket {
     url: string;
     /** Optional image URL for the market. */
     image?: string;
-    /** Optional category label (e.g., "Politics", "Crypto"). */
+    /** Optional category label. Venue-defined — common values include "Sports", "Politics", "Crypto", "Economics", "Science", "Culture". Polymarket uses finer-grained categories like "Bitcoin", "Soccer", "Economic Policy"; Kalshi uses broader ones like "Sports" or "Mentions". */
     category?: string;
-    /** Optional list of tags associated with the market. */
+    /** Optional list of tags. More granular than category — e.g. ["Crypto", "Crypto Prices", "Bitcoin"] or ["Politics", "Elections", "Trump"]. Tags vary by venue: Polymarket markets carry several, Kalshi typically one. */
     tags?: string[];
     tickSize?: number;
     /** Venue-native lifecycle status (e.g. 'active', 'closed', 'archived'). */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxt-core",
-  "version": "2.35.17",
+  "version": "2.35.18",
   "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.35.17,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.35.17,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.35.18,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.35.18,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",