pmxtjs 0.4.0 → 0.4.2

package/API_REFERENCE.md

@@ -249,7 +249,7 @@ Both Polymarket and Kalshi support authenticated trading operations. You must pr
 
 ### Polymarket Authentication
 
-Requires your **Polygon Private Key**. See [Setup Guide](docs/SETUP_POLYMARKET.md) for details.
+Requires your **Polygon Private Key**. See [Setup Guide](https://github.com/qoery-com/pmxt/blob/main/docs/SETUP_POLYMARKET.md) for details.
 
 ```typescript
 import pmxt from 'pmxtjs';

package/dist/exchanges/kalshi/fetchMarkets.js

@@ -18,7 +18,6 @@ async function fetchActiveEvents(targetMarketCount) {
     const BATCH_SIZE = 200; // Max limit per Kalshi API docs
     do {
         try {
-            // console.log(`Fetching Kalshi page ${page + 1}...`);
             const queryParams = {
                 limit: BATCH_SIZE,
                 with_nested_markets: true,
@@ -51,15 +50,42 @@ async function fetchActiveEvents(targetMarketCount) {
     } while (cursor && page < MAX_PAGES);
     return allEvents;
 }
+async function fetchSeriesMap() {
+    try {
+        const response = await axios_1.default.get(utils_1.KALSHI_SERIES_URL);
+        const seriesList = response.data.series || [];
+        const map = new Map();
+        for (const series of seriesList) {
+            if (series.tags && series.tags.length > 0) {
+                map.set(series.ticker, series.tags);
+            }
+        }
+        return map;
+    }
+    catch (e) {
+        console.error("Error fetching Kalshi series:", e);
+        return new Map();
+    }
+}
 async function fetchMarkets(params) {
     const limit = params?.limit || 50;
     try {
         // Fetch active events with nested markets
-        // For small limits, we can optimize by fetching fewer pages
-        const allEvents = await fetchActiveEvents(limit);
+        // We also fetch Series metadata to get tags (tags are on Series, not Event)
+        const [allEvents, seriesMap] = await Promise.all([
+            fetchActiveEvents(limit),
+            fetchSeriesMap()
+        ]);
         // Extract ALL markets from all events
         const allMarkets = [];
         for (const event of allEvents) {
+            // Enrich event with tags from Series
+            if (event.series_ticker && seriesMap.has(event.series_ticker)) {
+                // If event has no tags or empty tags, use series tags
+                if (!event.tags || event.tags.length === 0) {
+                    event.tags = seriesMap.get(event.series_ticker);
+                }
+            }
             const markets = event.markets || [];
             for (const market of markets) {
                 const unifiedMarket = (0, utils_1.mapMarketToUnified)(event, market);

package/dist/exchanges/kalshi/getMarketsBySlug.js

@@ -22,6 +22,22 @@ async function getMarketsBySlug(eventTicker) {
         const event = response.data.event;
         if (!event)
             return [];
+        // Enrichment: Fetch series tags if they exist
+        if (event.series_ticker) {
+            try {
+                const seriesUrl = `${utils_1.KALSHI_SERIES_URL}/${event.series_ticker}`;
+                const seriesResponse = await axios_1.default.get(seriesUrl);
+                const series = seriesResponse.data.series;
+                if (series && series.tags && series.tags.length > 0) {
+                    if (!event.tags || event.tags.length === 0) {
+                        event.tags = series.tags;
+                    }
+                }
+            }
+            catch (e) {
+                // Ignore errors fetching series info - non-critical
+            }
+        }
         const unifiedMarkets = [];
         const markets = event.markets || [];
         for (const market of markets) {

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

@@ -1,4 +1,5 @@
 import { UnifiedMarket, CandleInterval } from '../../types';
 export declare const KALSHI_API_URL = "https://api.elections.kalshi.com/trade-api/v2/events";
+export declare const KALSHI_SERIES_URL = "https://api.elections.kalshi.com/trade-api/v2/series";
 export declare function mapMarketToUnified(event: any, market: any): UnifiedMarket | null;
 export declare function mapIntervalToKalshi(interval: CandleInterval): number;

package/dist/exchanges/kalshi/utils.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KALSHI_API_URL = void 0;
+exports.KALSHI_SERIES_URL = exports.KALSHI_API_URL = void 0;
 exports.mapMarketToUnified = mapMarketToUnified;
 exports.mapIntervalToKalshi = mapIntervalToKalshi;
 exports.KALSHI_API_URL = "https://api.elections.kalshi.com/trade-api/v2/events";
+exports.KALSHI_SERIES_URL = "https://api.elections.kalshi.com/trade-api/v2/series";
 function mapMarketToUnified(event, market) {
     if (!market)
         return null;
@@ -42,10 +43,24 @@ function mapMarketToUnified(event, market) {
             priceChange24h: -priceChange // Inverse change for No? simplified assumption
         }
     ];
+    // Combine category and tags into a unified tags array
+    const unifiedTags = [];
+    // Add category first (if it exists)
+    if (event.category) {
+        unifiedTags.push(event.category);
+    }
+    // Add tags (if they exist and avoid duplicates)
+    if (event.tags && Array.isArray(event.tags)) {
+        for (const tag of event.tags) {
+            if (!unifiedTags.includes(tag)) {
+                unifiedTags.push(tag);
+            }
+        }
+    }
     return {
         id: market.ticker,
         title: event.title,
-        description: event.sub_title || market.subtitle || "",
+        description: market.rules_primary || market.rules_secondary || "",
         outcomes: outcomes,
         resolutionDate: new Date(market.expiration_time),
         volume24h: Number(market.volume_24h || market.volume || 0),
@@ -54,7 +69,7 @@ function mapMarketToUnified(event, market) {
         openInterest: Number(market.open_interest || 0),
         url: `https://kalshi.com/events/${event.event_ticker}`,
         category: event.category,
-        tags: event.tags || []
+        tags: unifiedTags
     };
 }
 function mapIntervalToKalshi(interval) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxtjs",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "pmxt is a unified prediction market data API. The ccxt for prediction markets.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/readme.md

@@ -30,7 +30,9 @@
 <a href="https://github.com/qoery-com/pmxt/stargazers"><img src="https://img.shields.io/github/stars/qoery-com/pmxt?refresh=1" alt="GitHub stars"></a>
 </td>
 <td>
-<!-- Space for future badge -->
+<a href="https://www.npmjs.com/package/pmxtjs">
+  <img src="https://img.shields.io/npm/v/pmxtjs.svg" alt="npm version">
+</a>
 </td>
 </tr>
 </table>
@@ -87,7 +89,7 @@ pmxt supports trading functionality (placing and cancelling orders).
 To trade, you must provide your private credentials.
 
 - **Polymarket**: Requires your Polygon Private Key. [View Setup Guide](docs/SETUP_POLYMARKET.md)
-- **Kalshi**: Requires API Key & Private Key (Coming Soon).
+- **Kalshi**: Requires API Key & Private Key.
 
 ### Trading Example