pmxtjs 0.1.2 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 qoery.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/BaseExchange.d.ts

@@ -22,8 +22,8 @@ export declare abstract class PredictionMarketExchange {
      */
     abstract searchMarkets(query: string, params?: MarketFilterParams): Promise<UnifiedMarket[]>;
     /**
-     * Fetch historical price data for a specific market or outcome.
-     * @param id - The market ID or specific outcome ID/Token ID depending on the exchange
+     * Fetch historical price data for a specific market outcome.
+     * @param id - The Outcome ID (MarketOutcome.id). This should be the ID of the specific tradeable asset.
      */
     getMarketHistory(id: string, params: HistoryFilterParams): Promise<PriceCandle[]>;
     /**

package/dist/BaseExchange.js

@@ -6,8 +6,8 @@ exports.PredictionMarketExchange = void 0;
 // ----------------------------------------------------------------------------
 class PredictionMarketExchange {
     /**
-     * Fetch historical price data for a specific market or outcome.
-     * @param id - The market ID or specific outcome ID/Token ID depending on the exchange
+     * Fetch historical price data for a specific market outcome.
+     * @param id - The Outcome ID (MarketOutcome.id). This should be the ID of the specific tradeable asset.
      */
     async getMarketHistory(id, params) {
         throw new Error("Method getMarketHistory not implemented.");

package/dist/exchanges/Kalshi.js

@@ -116,13 +116,13 @@ class KalshiExchange extends BaseExchange_1.PredictionMarketExchange {
         }
         const outcomes = [
             {
-                id: 'yes',
+                id: market.ticker, // The actual market ticker (primary tradeable)
                 label: candidateName || 'Yes',
                 price: price,
                 priceChange24h: priceChange
             },
             {
-                id: 'no',
+                id: `${market.ticker}-NO`, // Virtual ID for the No outcome
                 label: candidateName ? `Not ${candidateName}` : 'No',
                 price: 1 - price,
                 priceChange24h: -priceChange // Inverse change for No? simplified assumption
@@ -211,7 +211,9 @@ class KalshiExchange extends BaseExchange_1.PredictionMarketExchange {
     async getMarketHistory(id, params) {
         try {
             // Kalshi API expects uppercase tickers
-            const normalizedId = id.toUpperCase();
+            // Handle virtual "-NO" suffix by stripping it (fetching the underlying market history)
+            const cleanedId = id.replace(/-NO$/, '');
+            const normalizedId = cleanedId.toUpperCase();
             const interval = this.mapIntervalToKalshi(params.resolution);
             // Heuristic for series_ticker
             const parts = normalizedId.split('-');
@@ -261,7 +263,8 @@ class KalshiExchange extends BaseExchange_1.PredictionMarketExchange {
     }
     async getOrderBook(id) {
         try {
-            const url = `https://api.elections.kalshi.com/trade-api/v2/markets/${id}/orderbook`;
+            const ticker = id.replace(/-NO$/, '');
+            const url = `https://api.elections.kalshi.com/trade-api/v2/markets/${ticker}/orderbook`;
             const response = await axios_1.default.get(url);
             const data = response.data.orderbook;
             // Structure: { yes: [[price, qty], ...], no: [[price, qty], ...] }
@@ -285,10 +288,11 @@ class KalshiExchange extends BaseExchange_1.PredictionMarketExchange {
     }
     async getTradeHistory(id, params) {
         try {
+            const ticker = id.replace(/-NO$/, '');
             const url = `https://api.elections.kalshi.com/trade-api/v2/markets/trades`;
             const response = await axios_1.default.get(url, {
                 params: {
-                    ticker: id,
+                    ticker: ticker,
                     limit: params.limit || 100
                 }
             });

package/dist/exchanges/Polymarket.js

@@ -95,11 +95,12 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
                                 priceChange = Number(market.oneDayPriceChange || 0);
                             }
                             outcomes.push({
-                                id: String(index),
+                                id: clobTokenIds[index] || String(index), // Use CLOB Token ID as the primary ID
                                 label: outcomeLabel,
                                 price: parseFloat(rawPrice) || 0,
                                 priceChange24h: priceChange,
                                 metadata: {
+                                    // clobTokenId is now the main ID, but keeping it in metadata for backward compat if needed
                                     clobTokenId: clobTokenIds[index]
                                 }
                             });
@@ -218,7 +219,7 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
                                 priceChange = Number(market.oneDayPriceChange || 0);
                             }
                             outcomes.push({
-                                id: String(index),
+                                id: clobTokenIds[index] || String(index),
                                 label: outcomeLabel,
                                 price: parseFloat(outcomePrices[index] || "0") || 0,
                                 priceChange24h: priceChange,
@@ -273,7 +274,7 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
     async getMarketHistory(id, params) {
         // ID Validation: Polymarket CLOB requires a Token ID (long numeric string) not a Market ID
         if (id.length < 10 && /^\d+$/.test(id)) {
-            throw new Error(`Invalid ID for Polymarket history: "${id}". You provided a Market ID, but Polymarket's CLOB API requires a Token ID. Use outcome.metadata.clobTokenId instead.`);
+            throw new Error(`Invalid ID for Polymarket history: "${id}". You provided a Market ID, but Polymarket's CLOB API requires a Token ID. Ensure you are using 'outcome.id'.`);
         }
         try {
             const fidelity = this.mapIntervalToFidelity(params.resolution);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxtjs",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "pmxt is a unified prediction market data API. The ccxt for prediction markets.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,14 +18,15 @@
   },
   "keywords": [],
   "author": "",
-  "license": "ISC",
+  "license": "MIT",
   "type": "commonjs",
   "dependencies": {
     "axios": "^1.7.9",
+    "jest": "^30.2.0",
     "tsx": "^4.21.0"
   },
   "devDependencies": {
-    "typescript": "^5.9.3",
-    "@types/node": "^25.0.3"
+    "@types/node": "^25.0.3",
+    "typescript": "^5.9.3"
   }
-}
+}

package/readme.md

@@ -1,7 +1,53 @@
-# pmxt
+# pmxt [![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=The%20ccxt%20for%20prediction%20markets.&url=https://github.com/qoery-com/pmxt&hashtags=predictionmarkets,trading)
 
 **The ccxt for prediction markets.** A unified API for accessing prediction market data across multiple exchanges.
 
+<img width="3840" height="2160" alt="plot" src="https://github.com/user-attachments/assets/ed77d244-c95f-4fe0-a7a7-89af713c053f" />
+
+<div align="center">
+<table>
+<tr>
+<td rowspan="3">
+<a href="https://www.producthunt.com/products/qoery-python-sdk?embed=true&amp;utm_source=badge-featured&amp;utm_medium=badge&amp;utm_campaign=badge-qoery-python-sdk" target="_blank" rel="noopener noreferrer"><img alt="Qoery Python SDK - 50% cheaper crypto data. Now in Python. | Product Hunt" width="250" height="54" src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1056631&amp;theme=light&amp;t=1767263265752"></a>
+</td>
+<td>
+<img src="https://img.shields.io/github/watchers/qoery-com/pmxt?style=social" alt="GitHub watchers">
+</td>
+<td>
+<a href="https://www.npmjs.com/package/pmxtjs"><img src="https://img.shields.io/npm/dt/pmxtjs" alt="Downloads"></a>
+</td>
+</tr>
+<tr>
+<td>
+<img src="https://img.shields.io/github/forks/qoery-com/pmxt?style=social" alt="GitHub forks">
+</td>
+<td>
+<a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License"></a>
+</td>
+</tr>
+<tr>
+<td>
+<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 -->
+</td>
+</tr>
+</table>
+</div>
+
+<p align="center">
+<img src="https://polymarket.com/favicon.ico" alt="Polymarket" width="40" height="40">
+&nbsp;&nbsp;&nbsp;&nbsp;
+<img src="https://kalshi.com/favicon.ico" alt="Kalshi" width="40" height="40">
+&nbsp;&nbsp;&nbsp;&nbsp;
+<img src="https://manifold.markets/logo.svg" alt="Manifold Markets" width="40" height="40">
+&nbsp;&nbsp;&nbsp;&nbsp;
+<img src="https://metaculus.com/favicon.ico" alt="Metaculus" width="40" height="40">
+&nbsp;&nbsp;&nbsp;&nbsp;
+<img src="https://predictit.org/favicon.ico" alt="PredictIt" width="40" height="40">
+</p>
+
 ## Why pmxt?
 
 Different prediction market platforms have different APIs, data formats, and conventions. pmxt provides a single, consistent interface to work with all of them.
@@ -13,7 +59,7 @@ Search for markets across Polymarket and Kalshi using the same API:
 ```typescript
 import { PolymarketExchange, KalshiExchange } from 'pmxtjs';
 
-const query = process.argv[2] || 'Fed';
+const query = process.argv[2] || 'Who will Trump nominate as Fed Chair?';
 console.log(`Searching for "${query}"...\n`);
 
 // Polymarket
@@ -60,3 +106,6 @@ Check out the [examples](pmxt/examples/) directory for more use cases:
 - Historical prices
 - Event price tracking
 - Recent trades
+
+
+[![Stargazers repo roster for @qoery-com/pmxt](https://reporoster.com/stars/qoery-com/pmxt)](https://github.com/qoery-com/pmxt/stargazers)