pmxt-core 2.0.4 → 2.0.7

package/API_REFERENCE.md

@@ -127,7 +127,6 @@ Get trade history.
 
 ```typescript
 const trades = await kalshi.fetchTrades('FED-25JAN', {
-  resolution: '1h',
   limit: 100
 });
 ```

package/dist/BaseExchange.d.ts

@@ -19,11 +19,22 @@ export interface EventFetchParams {
     searchIn?: 'title' | 'description' | 'both';
 }
 export interface HistoryFilterParams {
+    resolution?: CandleInterval;
+    start?: Date;
+    end?: Date;
+    limit?: number;
+}
+export interface OHLCVParams {
     resolution: CandleInterval;
     start?: Date;
     end?: Date;
     limit?: number;
 }
+export interface TradesParams {
+    start?: Date;
+    end?: Date;
+    limit?: number;
+}
 export type MarketFilterCriteria = {
     text?: string;
     searchIn?: ('title' | 'description' | 'category' | 'tags' | 'outcomes')[];
@@ -140,8 +151,9 @@ export declare abstract class PredictionMarketExchange {
     /**
      * 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.
+     * @param params - OHLCV parameters including resolution (required)
      */
-    fetchOHLCV(id: string, params: HistoryFilterParams): Promise<PriceCandle[]>;
+    fetchOHLCV(id: string, params: OHLCVParams | HistoryFilterParams): Promise<PriceCandle[]>;
     /**
      * Fetch the current order book (bids/asks) for a specific outcome.
      * Essential for calculating localized spread and depth.
@@ -149,8 +161,10 @@ export declare abstract class PredictionMarketExchange {
     fetchOrderBook(id: string): Promise<OrderBook>;
     /**
      * Fetch raw trade history.
+     * @param id - The Outcome ID
+     * @param params - Trade filter parameters (resolution is deprecated and ignored)
      */
-    fetchTrades(id: string, params: HistoryFilterParams): Promise<Trade[]>;
+    fetchTrades(id: string, params: TradesParams | HistoryFilterParams): Promise<Trade[]>;
     /**
      * Place a new order.
      */

package/dist/BaseExchange.js

@@ -75,6 +75,7 @@ class PredictionMarketExchange {
     /**
      * 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.
+     * @param params - OHLCV parameters including resolution (required)
      */
     async fetchOHLCV(id, params) {
         throw new Error("Method fetchOHLCV not implemented.");
@@ -88,8 +89,15 @@ class PredictionMarketExchange {
     }
     /**
      * Fetch raw trade history.
+     * @param id - The Outcome ID
+     * @param params - Trade filter parameters (resolution is deprecated and ignored)
      */
     async fetchTrades(id, params) {
+        // Deprecation warning for resolution parameter
+        if ('resolution' in params && params.resolution !== undefined) {
+            console.warn('[pmxt] Warning: The "resolution" parameter is deprecated for fetchTrades() and will be ignored. ' +
+                'It will be removed in v3.0.0. Please remove it from your code.');
+        }
         throw new Error("Method fetchTrades not implemented.");
     }
     // ----------------------------------------------------------------------------

package/dist/exchanges/kalshi/auth.js

@@ -82,7 +82,11 @@ class KalshiAuth {
             // Allow input of private key in both raw string or PEM format
             // If it's a raw key without headers, accessing it might be tricky with implicit types,
             // but standard PEM is best. We assume the user provides a valid PEM.
-            const privateKey = this.credentials.privateKey;
+            let privateKey = this.credentials.privateKey;
+            // Fix for common .env issue where newlines are escaped
+            if (privateKey.includes('\\n')) {
+                privateKey = privateKey.replace(/\\n/g, '\n');
+            }
             // Kalshi uses RSA-PSS for signing
             const signature = signer.sign({
                 key: privateKey,

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

@@ -1,3 +1,3 @@
-import { HistoryFilterParams } from '../../BaseExchange';
+import { HistoryFilterParams, OHLCVParams } from '../../BaseExchange';
 import { PriceCandle } from '../../types';
-export declare function fetchOHLCV(id: string, params: HistoryFilterParams): Promise<PriceCandle[]>;
+export declare function fetchOHLCV(id: string, params: OHLCVParams | HistoryFilterParams): Promise<PriceCandle[]>;

package/dist/exchanges/kalshi/fetchOHLCV.js

@@ -10,6 +10,10 @@ const validation_1 = require("../../utils/validation");
 const errors_1 = require("./errors");
 async function fetchOHLCV(id, params) {
     (0, validation_1.validateIdFormat)(id, 'OHLCV');
+    // Validate resolution is provided
+    if (!params.resolution) {
+        throw new Error('fetchOHLCV requires a resolution parameter. Use OHLCVParams with resolution specified.');
+    }
     try {
         // Kalshi API expects uppercase tickers
         // Handle virtual "-NO" suffix by stripping it (fetching the underlying market history)

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

@@ -1,3 +1,3 @@
-import { HistoryFilterParams } from '../../BaseExchange';
+import { HistoryFilterParams, TradesParams } from '../../BaseExchange';
 import { Trade } from '../../types';
-export declare function fetchTrades(id: string, params: HistoryFilterParams): Promise<Trade[]>;
+export declare function fetchTrades(id: string, params: TradesParams | HistoryFilterParams): Promise<Trade[]>;

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

@@ -1,4 +1,4 @@
-import { PredictionMarketExchange, MarketFilterParams, HistoryFilterParams, ExchangeCredentials, EventFetchParams } from '../../BaseExchange';
+import { PredictionMarketExchange, MarketFilterParams, HistoryFilterParams, OHLCVParams, TradesParams, ExchangeCredentials, EventFetchParams } from '../../BaseExchange';
 import { UnifiedMarket, UnifiedEvent, PriceCandle, OrderBook, Trade, Balance, Order, Position, CreateOrderParams } from '../../types';
 import { KalshiWebSocketConfig } from './websocket';
 export type { KalshiWebSocketConfig };
@@ -15,9 +15,9 @@ export declare class KalshiExchange extends PredictionMarketExchange {
     private ensureAuth;
     protected fetchMarketsImpl(params?: MarketFilterParams): Promise<UnifiedMarket[]>;
     protected fetchEventsImpl(params: EventFetchParams): Promise<UnifiedEvent[]>;
-    fetchOHLCV(id: string, params: HistoryFilterParams): Promise<PriceCandle[]>;
+    fetchOHLCV(id: string, params: OHLCVParams | HistoryFilterParams): Promise<PriceCandle[]>;
     fetchOrderBook(id: string): Promise<OrderBook>;
-    fetchTrades(id: string, params: HistoryFilterParams): Promise<Trade[]>;
+    fetchTrades(id: string, params: TradesParams | HistoryFilterParams): Promise<Trade[]>;
     fetchBalance(): Promise<Balance[]>;
     createOrder(params: CreateOrderParams): Promise<Order>;
     cancelOrder(orderId: string): Promise<Order>;

package/dist/exchanges/kalshi/index.js

@@ -67,6 +67,11 @@ class KalshiExchange extends BaseExchange_1.PredictionMarketExchange {
         return (0, fetchOrderBook_1.fetchOrderBook)(id);
     }
     async fetchTrades(id, params) {
+        // Deprecation warning
+        if ('resolution' in params && params.resolution !== undefined) {
+            console.warn('[pmxt] Warning: The "resolution" parameter is deprecated for fetchTrades() and will be ignored. ' +
+                'It will be removed in v3.0.0. Please remove it from your code.');
+        }
         return (0, fetchTrades_1.fetchTrades)(id, params);
     }
     // ----------------------------------------------------------------------------

package/dist/exchanges/limitless/auth.js

@@ -19,7 +19,12 @@ class LimitlessAuth {
         }
         // Initialize signer if private key is provided (needed for order signing)
         if (credentials.privateKey) {
-            this.signer = new ethers_1.Wallet(credentials.privateKey);
+            let privateKey = credentials.privateKey;
+            // Fix for common .env issue where newlines are escaped
+            if (privateKey.includes('\\n')) {
+                privateKey = privateKey.replace(/\\n/g, '\n');
+            }
+            this.signer = new ethers_1.Wallet(privateKey);
         }
     }
     /**

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

@@ -66,4 +66,5 @@ export declare class LimitlessClient {
      * Clear the market cache.
      */
     clearMarketCache(): void;
+    getBalance(): Promise<number>;
 }

package/dist/exchanges/limitless/client.js

@@ -11,6 +11,10 @@ const LIMITLESS_API_URL = 'https://api.limitless.exchange';
 class LimitlessClient {
     constructor(privateKey, apiKey) {
         this.marketCache = {};
+        // Fix for common .env issue where newlines are escaped
+        if (privateKey.includes('\\n')) {
+            privateKey = privateKey.replace(/\\n/g, '\n');
+        }
         this.signer = new ethers_1.Wallet(privateKey);
         // Initialize HTTP client with API key
         this.httpClient = new sdk_1.HttpClient({
@@ -127,5 +131,16 @@ class LimitlessClient {
     clearMarketCache() {
         this.marketCache = {};
     }
+    async getBalance() {
+        // USDC on Base
+        const USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+        const ABI = ["function balanceOf(address) view returns (uint256)", "function decimals() view returns (uint8)"];
+        // Use a public RPC for Base
+        const provider = new ethers_1.providers.JsonRpcProvider('https://mainnet.base.org');
+        const contract = new ethers_1.Contract(USDC_ADDRESS, ABI, provider);
+        const balance = await contract.balanceOf(this.signer.address);
+        const decimals = await contract.decimals(); // Should be 6
+        return parseFloat(ethers_1.utils.formatUnits(balance, decimals));
+    }
 }
 exports.LimitlessClient = LimitlessClient;

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

@@ -1,7 +1,7 @@
-import { HistoryFilterParams } from '../../BaseExchange';
+import { HistoryFilterParams, OHLCVParams } from '../../BaseExchange';
 import { PriceCandle } from '../../types';
 /**
  * Fetch historical price data (candles) for a specific market.
  * @param id - The market slug
  */
-export declare function fetchOHLCV(id: string, params: HistoryFilterParams): Promise<PriceCandle[]>;
+export declare function fetchOHLCV(id: string, params: OHLCVParams | HistoryFilterParams): Promise<PriceCandle[]>;

package/dist/exchanges/limitless/fetchOHLCV.js

@@ -14,6 +14,10 @@ const errors_1 = require("./errors");
  */
 async function fetchOHLCV(id, params) {
     (0, validation_1.validateIdFormat)(id, 'OHLCV');
+    // Validate resolution is provided
+    if (!params.resolution) {
+        throw new Error('fetchOHLCV requires a resolution parameter. Use OHLCVParams with resolution specified.');
+    }
     try {
         const fidelity = (0, utils_1.mapIntervalToFidelity)(params.resolution);
         // New API endpoint: /markets/{slug}/historical-price

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

@@ -1,7 +1,7 @@
-import { HistoryFilterParams } from '../../BaseExchange';
+import { HistoryFilterParams, TradesParams } from '../../BaseExchange';
 import { Trade } from '../../types';
 /**
  * Fetch trade history for a specific market or user.
  * @param id - The market slug or wallet address
  */
-export declare function fetchTrades(id: string, params: HistoryFilterParams): Promise<Trade[]>;
+export declare function fetchTrades(id: string, params: TradesParams | HistoryFilterParams): Promise<Trade[]>;

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

@@ -1,4 +1,4 @@
-import { PredictionMarketExchange, MarketFetchParams, HistoryFilterParams, ExchangeCredentials, EventFetchParams } from '../../BaseExchange';
+import { PredictionMarketExchange, MarketFetchParams, HistoryFilterParams, OHLCVParams, TradesParams, ExchangeCredentials, EventFetchParams } from '../../BaseExchange';
 import { UnifiedMarket, UnifiedEvent, PriceCandle, OrderBook, Trade, Order, Position, Balance, CreateOrderParams } from '../../types';
 import { LimitlessWebSocketConfig } from './websocket';
 export type { LimitlessWebSocketConfig };
@@ -14,9 +14,9 @@ export declare class LimitlessExchange extends PredictionMarketExchange {
     get name(): string;
     protected fetchMarketsImpl(params?: MarketFetchParams): Promise<UnifiedMarket[]>;
     protected fetchEventsImpl(params: EventFetchParams): Promise<UnifiedEvent[]>;
-    fetchOHLCV(id: string, params: HistoryFilterParams): Promise<PriceCandle[]>;
+    fetchOHLCV(id: string, params: OHLCVParams | HistoryFilterParams): Promise<PriceCandle[]>;
     fetchOrderBook(id: string): Promise<OrderBook>;
-    fetchTrades(id: string, params: HistoryFilterParams): Promise<Trade[]>;
+    fetchTrades(id: string, params: TradesParams | HistoryFilterParams): Promise<Trade[]>;
     private ensureClient;
     /**
      * Ensure authentication is initialized before trading operations.

package/dist/exchanges/limitless/index.js

@@ -74,6 +74,11 @@ class LimitlessExchange extends BaseExchange_1.PredictionMarketExchange {
         return (0, fetchOrderBook_1.fetchOrderBook)(id);
     }
     async fetchTrades(id, params) {
+        // Deprecation warning
+        if ('resolution' in params && params.resolution !== undefined) {
+            console.warn('[pmxt] Warning: The "resolution" parameter is deprecated for fetchTrades() and will be ignored. ' +
+                'It will be removed in v3.0.0. Please remove it from your code.');
+        }
         return (0, fetchTrades_1.fetchTrades)(id, params);
     }
     // ----------------------------------------------------------------------------
@@ -106,11 +111,13 @@ class LimitlessExchange extends BaseExchange_1.PredictionMarketExchange {
             if (!params.price) {
                 throw new Error('Limit orders require a price');
             }
+            // Limitless (USDC on Base) supports 6 decimals max.
+            const price = Math.round(params.price * 1000000) / 1000000;
             const response = await client.createOrder({
                 marketSlug: marketSlug,
                 outcomeId: params.outcomeId,
                 side: side,
-                price: params.price,
+                price: price,
                 amount: params.amount,
                 type: params.type,
             });
@@ -175,7 +182,7 @@ class LimitlessExchange extends BaseExchange_1.PredictionMarketExchange {
             return orders.map((o) => ({
                 id: o.id,
                 marketId: marketId,
-                outcomeId: 'unknown', // API might not return this in the simplified list
+                outcomeId: o.tokenId || 'unknown',
                 side: o.side.toLowerCase(),
                 type: 'limit',
                 price: parseFloat(o.price),
@@ -199,7 +206,7 @@ class LimitlessExchange extends BaseExchange_1.PredictionMarketExchange {
         const auth = this.ensureAuth();
         try {
             // Query USDC balance directly from the blockchain
-            // Base chain RPC
+            // Base chain RPC (not Polygon)
             const provider = new ethers_1.providers.JsonRpcProvider('https://mainnet.base.org');
             const address = auth.getAddress();
             // Get USDC contract address for Base

package/dist/exchanges/limitless/utils.js

@@ -12,10 +12,12 @@ function mapMarketToUnified(market) {
     // The new API provides 'tokens' and 'prices'
     // tokens: { no: "...", yes: "..." }
     // prices: [noPrice, yesPrice]
-    if (market.tokens && market.prices) {
+    if (market.tokens) {
         const tokenEntries = Object.entries(market.tokens);
+        // Ensure prices array exists, otherwise default to empty
+        const prices = Array.isArray(market.prices) ? market.prices : [];
         tokenEntries.forEach(([label, tokenId], index) => {
-            const outcomePrice = market.prices[index] || 0;
+            const outcomePrice = prices[index] || 0;
             const outcomeIdValue = tokenId;
             outcomes.push({
                 outcomeId: outcomeIdValue,

package/dist/exchanges/polymarket/auth.js

@@ -21,7 +21,12 @@ class PolymarketAuth {
             throw new Error('Polymarket requires a privateKey for authentication');
         }
         // Initialize the signer
-        this.signer = new ethers_1.Wallet(credentials.privateKey);
+        let privateKey = credentials.privateKey;
+        // Fix for common .env issue where newlines are escaped
+        if (privateKey.includes('\\n')) {
+            privateKey = privateKey.replace(/\\n/g, '\n');
+        }
+        this.signer = new ethers_1.Wallet(privateKey);
     }
     /**
      * Get or create API credentials using L1 authentication.

package/dist/exchanges/polymarket/fetchMarkets.js

@@ -90,7 +90,9 @@ async function fetchMarketsDefault(params) {
         // queryParams.order = 'liquidity';
     }
     else {
-        // Default: do not send order param to avoid 422
+        // Default to volume sort to ensure we get active markets
+        queryParams.order = 'volume';
+        queryParams.ascending = 'false';
     }
     try {
         // Fetch active events from Gamma

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

@@ -1,7 +1,7 @@
-import { HistoryFilterParams } from '../../BaseExchange';
+import { HistoryFilterParams, OHLCVParams } from '../../BaseExchange';
 import { PriceCandle } from '../../types';
 /**
  * Fetch historical price data (OHLCV candles) for a specific token.
  * @param id - The CLOB token ID (e.g., outcome token ID)
  */
-export declare function fetchOHLCV(id: string, params: HistoryFilterParams): Promise<PriceCandle[]>;
+export declare function fetchOHLCV(id: string, params: OHLCVParams | HistoryFilterParams): Promise<PriceCandle[]>;

package/dist/exchanges/polymarket/fetchOHLCV.js

@@ -15,6 +15,10 @@ const errors_1 = require("./errors");
 async function fetchOHLCV(id, params) {
     (0, validation_1.validateIdFormat)(id, 'OHLCV');
     (0, validation_1.validateOutcomeId)(id, 'OHLCV');
+    // Validate resolution is provided
+    if (!params.resolution) {
+        throw new Error('fetchOHLCV requires a resolution parameter. Use OHLCVParams with resolution specified.');
+    }
     try {
         const fidelity = (0, utils_1.mapIntervalToFidelity)(params.resolution);
         const nowTs = Math.floor(Date.now() / 1000);

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

@@ -1,4 +1,4 @@
-import { HistoryFilterParams } from '../../BaseExchange';
+import { HistoryFilterParams, TradesParams } from '../../BaseExchange';
 import { Trade } from '../../types';
 /**
  * Fetch raw trade history for a specific token.
@@ -6,4 +6,4 @@ import { Trade } from '../../types';
  *
  * NOTE: Uses Polymarket Data API (public) to fetch trades.
  */
-export declare function fetchTrades(id: string, params: HistoryFilterParams): Promise<Trade[]>;
+export declare function fetchTrades(id: string, params: TradesParams | HistoryFilterParams): Promise<Trade[]>;

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

@@ -1,4 +1,4 @@
-import { PredictionMarketExchange, MarketFilterParams, HistoryFilterParams, ExchangeCredentials, EventFetchParams } from '../../BaseExchange';
+import { PredictionMarketExchange, MarketFilterParams, HistoryFilterParams, OHLCVParams, TradesParams, ExchangeCredentials, EventFetchParams } from '../../BaseExchange';
 import { UnifiedMarket, UnifiedEvent, PriceCandle, OrderBook, Trade, Order, Position, Balance, CreateOrderParams } from '../../types';
 import { PolymarketWebSocketConfig } from './websocket';
 export type { PolymarketWebSocketConfig };
@@ -13,9 +13,9 @@ export declare class PolymarketExchange extends PredictionMarketExchange {
     get name(): string;
     protected fetchMarketsImpl(params?: MarketFilterParams): Promise<UnifiedMarket[]>;
     protected fetchEventsImpl(params: EventFetchParams): Promise<UnifiedEvent[]>;
-    fetchOHLCV(id: string, params: HistoryFilterParams): Promise<PriceCandle[]>;
+    fetchOHLCV(id: string, params: OHLCVParams | HistoryFilterParams): Promise<PriceCandle[]>;
     fetchOrderBook(id: string): Promise<OrderBook>;
-    fetchTrades(id: string, params: HistoryFilterParams): Promise<Trade[]>;
+    fetchTrades(id: string, params: TradesParams | HistoryFilterParams): Promise<Trade[]>;
     /**
      * Ensure authentication is initialized before trading operations.
      */

package/dist/exchanges/polymarket/index.js

@@ -53,6 +53,11 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
         return (0, fetchOrderBook_1.fetchOrderBook)(id);
     }
     async fetchTrades(id, params) {
+        // Deprecation warning (also in base class, but adding here for consistency)
+        if ('resolution' in params && params.resolution !== undefined) {
+            console.warn('[pmxt] Warning: The "resolution" parameter is deprecated for fetchTrades() and will be ignored. ' +
+                'It will be removed in v3.0.0. Please remove it from your code.');
+        }
         return (0, fetchTrades_1.fetchTrades)(id, params);
     }
     // ----------------------------------------------------------------------------

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxt-core",
-  "version": "2.0.4",
+  "version": "2.0.7",
   "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.0.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.0.4,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.0.7,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.0.7,supportsES6=true,typescriptThreePlus=true && node ../sdks/typescript/scripts/fix-generated.js",
     "generate:docs": "node ../scripts/generate-api-docs.js",
     "generate:sdk:all": "npm run generate:sdk:python && npm run generate:sdk:typescript && npm run generate:docs"
   },