pmxt-core 2.51.2 → 2.51.3

package/API_REFERENCE.md

@@ -1,6 +1,6 @@
 # Prediction Market API Reference
 
-A unified interface for interacting with multiple prediction market exchanges (Kalshi, Polymarket) identically.
+A unified interface for interacting with multiple prediction market exchanges and venues through one interface.
 
 ## Installation & Usage
 
@@ -8,33 +8,22 @@ A unified interface for interacting with multiple prediction market exchanges (K
 npm install pmxtjs
 ```
 
-### Basic Import (CommonJS)
+### Import Styles
 
 ```typescript
-import pmxt from 'pmxtjs';
+import { Polymarket, Kalshi } from 'pmxtjs';
 
-const poly = new pmxt.Polymarket();
-const kalshi = new pmxt.Kalshi();
+const polymarket = new Polymarket();
+const kalshi = new Kalshi();
 ```
 
-### Note for ESM Users
-
-**pmxt is currently CommonJS-only.** If you're using `"type": "module"` in your `package.json`, you have two options:
-
-**Option 1: Default import (recommended)**
 ```typescript
 import pmxt from 'pmxtjs';
-const poly = new pmxt.Polymarket();
-```
 
-**Option 2: Dynamic import**
-```typescript
-const pmxt = await import('pmxtjs');
-const poly = new pmxt.default.Polymarket();
+const polymarket = new pmxt.Polymarket();
+const kalshi = new pmxt.Kalshi();
 ```
 
-**Note**: Named exports like `import { Polymarket } from 'pmxtjs'` will **not work** in ESM projects.
-
 ---
 
 ## Core Methods
@@ -46,8 +35,8 @@ Get active markets from an exchange. This is the unified method for all market f
 - `limit`: Number of results (default: 20)
 - `offset`: Pagination offset
 - `sort`: 'volume' | 'liquidity' | 'newest'
-- `query`: Search text (replaces `searchMarkets`)
-- `slug`: Market slug or ticker (replaces `getMarketsBySlug`)
+- `query`: Search text
+- `slug`: Market slug or ticker
 
 ```typescript
 // 1. Fetch recent markets
@@ -56,13 +45,13 @@ const markets = await polymarket.fetchMarkets({
   sort: 'volume' 
 });
 
-// 2. Search by text (replaces searchMarkets)
+// 2. Search by text
 const results = await kalshi.fetchMarkets({ 
   query: 'Fed rates',
   limit: 10
 });
 
-// 3. Fetch by slug/ticker (replaces getMarketsBySlug)
+// 3. Fetch by slug/ticker
 const market = await polymarket.fetchMarkets({ 
   slug: 'who-will-trump-nominate-as-fed-chair'
 });
@@ -140,7 +129,7 @@ Calculate the volume-weighted average price for a given amount. Returns `0` if t
 
 ```typescript
 const orderBook = await polymarket.fetchOrderBook(outcomeId);
-const price = await polymarket.getExecutionPrice(orderBook, 'buy', 100);
+const price = polymarket.getExecutionPrice(orderBook, 'buy', 100);
 console.log(`Average price for 100 shares: ${price}`);
 ```
 
@@ -148,7 +137,7 @@ console.log(`Average price for 100 shares: ${price}`);
 Calculate detailed execution price information, including partial fills.
 
 ```typescript
-const detailed = await polymarket.getExecutionPriceDetailed(orderBook, 'buy', 100);
+const detailed = polymarket.getExecutionPriceDetailed(orderBook, 'buy', 100);
 console.log(`Average Price: ${detailed.price}`);
 console.log(`Filled Amount: ${detailed.filledAmount}`);
 console.log(`Fully Filled: ${detailed.fullyFilled}`);
@@ -275,10 +264,10 @@ console.log(`Spread: ${(spread * 100).toFixed(2)}%`);
 
 ```typescript
 try {
-  const markets = await kalshi.getMarketsBySlug('INVALID-TICKER');
+  const market = await kalshi.fetchMarket({ slug: 'INVALID-TICKER' });
+  console.log(market.title);
 } catch (error) {
-  // Kalshi: "Event not found: INVALID-TICKER"
-  // Polymarket: Returns empty array []
+  // Throws MarketNotFound when no market matches the lookup
   console.error(error.message);
 }
 ```
@@ -310,7 +299,7 @@ import pmxt, {
 
 ## Authentication & Trading
 
-Both Polymarket and Kalshi support authenticated trading operations. You must provide credentials when initializing the exchange.
+Authenticated trading is available on venues that expose trading APIs. You must provide the venue-specific credentials when initializing the exchange; the examples below show Polymarket and Kalshi.
 
 ### Polymarket Authentication
 

package/bin/pmxt-ensure-server

@@ -39,7 +39,7 @@ function isServerRunning() {
         // Check if process exists
         try {
             process.kill(pid, 0); // Signal 0 checks existence without killing
-            return { running: true, port };
+            return { running: true, pid, port };
         } catch (err) {
             // Process doesn't exist, remove stale lock file
             fs.unlinkSync(LOCK_FILE);
@@ -50,6 +50,26 @@ function isServerRunning() {
     }
 }
 
+/**
+ * Remove the lock we just proved unhealthy, without deleting a newer sidecar's
+ * lock if another launcher won the race and replaced it first.
+ */
+function removeLockFileIfMatches(staleLock) {
+    try {
+        if (!fs.existsSync(LOCK_FILE)) {
+            return false;
+        }
+        const currentLock = JSON.parse(fs.readFileSync(LOCK_FILE, 'utf-8'));
+        if (currentLock.pid === staleLock.pid && currentLock.port === staleLock.port) {
+            fs.unlinkSync(LOCK_FILE);
+            return true;
+        }
+    } catch (err) {
+        return false;
+    }
+    return false;
+}
+
 /**
  * Wait for server to respond to health check
  */
@@ -196,6 +216,7 @@ async function main() {
             } catch (err) {
                 // Server process exists but not responding, try to start fresh
                 console.error('Server process exists but not responding, starting fresh...');
+                removeLockFileIfMatches(serverStatus);
             }
         }
 

package/bin/pmxt-ensure-server.js

@@ -39,7 +39,7 @@ function isServerRunning() {
         // Check if process exists
         try {
             process.kill(pid, 0); // Signal 0 checks existence without killing
-            return { running: true, port };
+            return { running: true, pid, port };
         } catch (err) {
             // Process doesn't exist, remove stale lock file
             fs.unlinkSync(LOCK_FILE);
@@ -50,6 +50,26 @@ function isServerRunning() {
     }
 }
 
+/**
+ * Remove the lock we just proved unhealthy, without deleting a newer sidecar's
+ * lock if another launcher won the race and replaced it first.
+ */
+function removeLockFileIfMatches(staleLock) {
+    try {
+        if (!fs.existsSync(LOCK_FILE)) {
+            return false;
+        }
+        const currentLock = JSON.parse(fs.readFileSync(LOCK_FILE, 'utf-8'));
+        if (currentLock.pid === staleLock.pid && currentLock.port === staleLock.port) {
+            fs.unlinkSync(LOCK_FILE);
+            return true;
+        }
+    } catch (err) {
+        return false;
+    }
+    return false;
+}
+
 /**
  * Wait for server to respond to health check
  */
@@ -85,6 +105,44 @@ function waitForHealth(port, timeout = HEALTH_CHECK_TIMEOUT) {
     });
 }
 
+/**
+ * Wait for the lock file to appear, then health-check the port it specifies.
+ *
+ * The sidecar may bind a non-default port when the default is occupied by an
+ * orphan.  Polling DEFAULT_PORT would be fooled by the orphan, so we wait for
+ * the new sidecar to write its lock file and health-check THAT port.
+ */
+function waitForLockAndHealth(timeout = HEALTH_CHECK_TIMEOUT) {
+    return new Promise((resolve, reject) => {
+        const startTime = Date.now();
+
+        const poll = () => {
+            if (Date.now() - startTime > timeout) {
+                return reject(new Error('Server health check timeout (lock file never appeared)'));
+            }
+
+            try {
+                if (fs.existsSync(LOCK_FILE)) {
+                    const lockData = JSON.parse(fs.readFileSync(LOCK_FILE, 'utf-8'));
+                    const port = lockData.port || DEFAULT_PORT;
+                    // Lock file appeared — now health-check the actual port
+                    const remaining = timeout - (Date.now() - startTime);
+                    waitForHealth(port, Math.max(remaining, 1000))
+                        .then(resolve)
+                        .catch(reject);
+                    return;
+                }
+            } catch (err) {
+                // Lock file partially written or unreadable — retry
+            }
+
+            setTimeout(poll, HEALTH_CHECK_INTERVAL);
+        };
+
+        poll();
+    });
+}
+
 /**
  * Start the PMXT server
  */
@@ -136,8 +194,10 @@ async function startServer() {
     // Detach from parent process
     serverProcess.unref();
 
-    // Wait for server to be ready
-    await waitForHealth(DEFAULT_PORT);
+    // Wait for the sidecar to write its lock file, then health-check
+    // the actual port it bound (which may differ from DEFAULT_PORT if
+    // an orphan sidecar is occupying it).
+    await waitForLockAndHealth();
 }
 
 /**
@@ -156,6 +216,7 @@ async function main() {
             } catch (err) {
                 // Server process exists but not responding, try to start fresh
                 console.error('Server process exists but not responding, starting fresh...');
+                removeLockFileIfMatches(serverStatus);
             }
         }
 

package/dist/BaseExchange.d.ts

@@ -627,8 +627,42 @@ export declare abstract class PredictionMarketExchange {
      * @returns Array of open orders
      */
     fetchOpenOrders(marketId?: string): Promise<Order[]>;
+    /**
+     * Fetch authenticated user trade history.
+     *
+     * @param params - Optional trade history filters
+     * @param params.outcomeId - Filter by outcome token ID
+     * @param params.marketId - Filter by market ID or ticker
+     * @param params.since - Start timestamp or ISO date
+     * @param params.until - End timestamp or ISO date
+     * @param params.limit - Maximum number of trades
+     * @param params.cursor - Pagination cursor
+     * @returns Array of user trades
+     */
     fetchMyTrades(params?: MyTradesParams): Promise<UserTrade[]>;
+    /**
+     * Fetch authenticated closed orders.
+     *
+     * @param params - Optional order history filters
+     * @param params.marketId - Filter by market ID or ticker
+     * @param params.since - Start timestamp or ISO date
+     * @param params.until - End timestamp or ISO date
+     * @param params.limit - Maximum number of orders
+     * @param params.cursor - Pagination cursor
+     * @returns Array of closed orders
+     */
     fetchClosedOrders(params?: OrderHistoryParams): Promise<Order[]>;
+    /**
+     * Fetch authenticated order history across open and closed orders.
+     *
+     * @param params - Optional order history filters
+     * @param params.marketId - Filter by market ID or ticker
+     * @param params.since - Start timestamp or ISO date
+     * @param params.until - End timestamp or ISO date
+     * @param params.limit - Maximum number of orders
+     * @param params.cursor - Pagination cursor
+     * @returns Array of orders
+     */
     fetchAllOrders(params?: OrderHistoryParams): Promise<Order[]>;
     /**
      * Fetch current user positions across all markets.

package/dist/BaseExchange.js

@@ -213,7 +213,13 @@ class PredictionMarketExchange {
             return limit !== undefined ? filtered.slice(start, start + limit) : filtered.slice(start);
         }
         const { limit, offset, ...venueParams } = fetchParams;
-        const markets = await this.fetchMarketsImpl(Object.keys(venueParams).length > 0 ? venueParams : undefined);
+        const hasVenueParams = Object.keys(venueParams).length > 0;
+        const shouldForwardSimpleLimit = limit !== undefined && offset === undefined && !hasVenueParams;
+        const markets = await this.fetchMarketsImpl(shouldForwardSimpleLimit
+            ? { limit }
+            : hasVenueParams
+                ? venueParams
+                : undefined);
         const start = offset ?? 0;
         return limit !== undefined ? markets.slice(start, start + limit) : markets.slice(start);
     }
@@ -357,7 +363,9 @@ class PredictionMarketExchange {
             return limit !== undefined ? filtered.slice(start, start + limit) : filtered.slice(start);
         }
         const { limit, offset, ...venueParams } = fetchParams;
-        const events = await this.fetchEventsImpl(venueParams);
+        const hasVenueParams = Object.keys(venueParams).length > 0;
+        const shouldForwardSimpleLimit = limit !== undefined && offset === undefined && !hasVenueParams;
+        const events = await this.fetchEventsImpl(shouldForwardSimpleLimit ? { limit } : venueParams);
         const start = offset ?? 0;
         return limit !== undefined ? events.slice(start, start + limit) : events.slice(start);
     }
@@ -607,12 +615,46 @@ class PredictionMarketExchange {
     async fetchOpenOrders(marketId) {
         throw new Error("Method fetchOpenOrders not implemented.");
     }
+    /**
+     * Fetch authenticated user trade history.
+     *
+     * @param params - Optional trade history filters
+     * @param params.outcomeId - Filter by outcome token ID
+     * @param params.marketId - Filter by market ID or ticker
+     * @param params.since - Start timestamp or ISO date
+     * @param params.until - End timestamp or ISO date
+     * @param params.limit - Maximum number of trades
+     * @param params.cursor - Pagination cursor
+     * @returns Array of user trades
+     */
     async fetchMyTrades(params) {
         throw new Error("Method fetchMyTrades not implemented.");
     }
+    /**
+     * Fetch authenticated closed orders.
+     *
+     * @param params - Optional order history filters
+     * @param params.marketId - Filter by market ID or ticker
+     * @param params.since - Start timestamp or ISO date
+     * @param params.until - End timestamp or ISO date
+     * @param params.limit - Maximum number of orders
+     * @param params.cursor - Pagination cursor
+     * @returns Array of closed orders
+     */
     async fetchClosedOrders(params) {
         throw new Error("Method fetchClosedOrders not implemented.");
     }
+    /**
+     * Fetch authenticated order history across open and closed orders.
+     *
+     * @param params - Optional order history filters
+     * @param params.marketId - Filter by market ID or ticker
+     * @param params.since - Start timestamp or ISO date
+     * @param params.until - End timestamp or ISO date
+     * @param params.limit - Maximum number of orders
+     * @param params.cursor - Pagination cursor
+     * @returns Array of orders
+     */
     async fetchAllOrders(params) {
         throw new Error("Method fetchAllOrders not implemented.");
     }

package/dist/exchanges/hyperliquid/normalizer.js

@@ -175,7 +175,7 @@ class HyperliquidNormalizer {
             description: outcome.description,
             slug: `hl-${outcomeId}`,
             outcomes,
-            resolutionDate: expiryDate ?? new Date(0),
+            resolutionDate: expiryDate,
             volume24h: raw.volume24h ?? 0,
             liquidity: 0,
             url: buildMarketUrl(outcomeId),

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-06-23T09:51:53.440Z
+ * Generated at: 2026-06-24T09:17:49.567Z
  * 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-06-23T09:51:53.440Z
+ * Generated at: 2026-06-24T09:17:49.567Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.kalshiApiSpec = {

package/dist/exchanges/kalshi/fetcher.js

@@ -64,6 +64,19 @@ class KalshiFetcher {
                 return this.fetchAllWithSeriesTicker(params.series);
             }
             const status = params?.status || 'active';
+            const hasBoundedDefaultRead = status === 'active' &&
+                (params.limit !== undefined || params.cursor !== undefined) &&
+                !params.query &&
+                params.offset === undefined &&
+                params.sort === undefined &&
+                params.searchIn === undefined &&
+                params.category === undefined &&
+                params.tags === undefined &&
+                params.filter === undefined;
+            if (hasBoundedDefaultRead) {
+                const page = await this.fetchRawEventPage(params);
+                return page.events;
+            }
             if (status === 'all') {
                 const openEvents = await this.fetchAllWithStatus('open');
                 const closedEvents = await this.fetchAllWithStatus('closed');

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-06-23T09:51:53.479Z
+ * Generated at: 2026-06-24T09:17:49.606Z
  * 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-06-23T09:51:53.479Z
+ * Generated at: 2026-06-24T09:17:49.606Z
  * 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-06-23T09:51:53.491Z
+ * Generated at: 2026-06-24T09:17:49.618Z
  * 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-06-23T09:51:53.491Z
+ * Generated at: 2026-06-24T09:17:49.618Z
  * 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-06-23T09:51:53.496Z
+ * Generated at: 2026-06-24T09:17:49.621Z
  * 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-06-23T09:51:53.496Z
+ * Generated at: 2026-06-24T09:17:49.621Z
  * 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-06-23T09:51:53.448Z
+ * Generated at: 2026-06-24T09:17:49.575Z
  * 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-06-23T09:51:53.448Z
+ * Generated at: 2026-06-24T09:17:49.575Z
  * 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-06-23T09:51:53.462Z
+ * Generated at: 2026-06-24T09:17:49.588Z
  * 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-06-23T09:51:53.462Z
+ * Generated at: 2026-06-24T09:17:49.588Z
  * 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-06-23T09:51:53.459Z
+ * Generated at: 2026-06-24T09:17:49.586Z
  * 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-06-23T09:51:53.459Z
+ * Generated at: 2026-06-24T09:17:49.586Z
  * 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-06-23T09:51:53.484Z
+ * Generated at: 2026-06-24T09:17:49.613Z
  * 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-06-23T09:51:53.484Z
+ * Generated at: 2026-06-24T09:17:49.613Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

package/dist/exchanges/rain/fetcher.d.ts

@@ -6,6 +6,7 @@ export interface RainFetcherConfig {
     subgraphApiKey?: string;
     rpcUrl?: string;
     wsRpcUrl?: string;
+    sdk?: RainSdk;
 }
 export type RainRawMarket = Awaited<ReturnType<RainClient['getPublicMarkets']>>[number];
 export type RainRawMarketDetails = Awaited<ReturnType<RainClient['getMarketDetails']>>;
@@ -38,7 +39,7 @@ export declare class RainFetcher {
         status?: string;
     }): Promise<RainMarketWithDetails[]>;
     fetchRawMarket(marketId: string): Promise<RainMarketWithDetails | null>;
-    fetchRawOHLCV(marketId: string, optionIndex: number, interval: string, limit?: number): Promise<RainRawPriceHistory | null>;
+    fetchRawOHLCV(marketAddress: string, optionIndex: number, _interval: string, _limit?: number): Promise<RainRawPriceHistory | null>;
     fetchRawPositions(walletAddress: string): Promise<RainRawPositions>;
     fetchRawBalance(walletAddress: string, tokenAddresses: string[]): Promise<RainRawBalance>;
     fetchRawMarketTrades(marketAddress: string, limit?: number): Promise<RainRawMarketTransactions | null>;

package/dist/exchanges/rain/fetcher.js

@@ -23,7 +23,7 @@ class RainFetcher {
     }
     async getClient() {
         if (!this.client) {
-            const sdk = await loadSdk();
+            const sdk = this.config.sdk ?? await loadSdk();
             this.client = new sdk.Rain({
                 environment: this.config.environment ?? 'production',
                 rpcUrl: this.config.rpcUrl,
@@ -91,16 +91,15 @@ class RainFetcher {
             throw errors_1.rainErrorMapper.mapError(error);
         }
     }
-    async fetchRawOHLCV(marketId, optionIndex, interval, limit) {
+    async fetchRawOHLCV(marketAddress, optionIndex, _interval, _limit) {
         if (!this.config.subgraphUrl)
             return null;
         try {
             const client = await this.getClient();
             return await client.getPriceHistory({
-                marketId,
-                optionIndex,
-                interval: interval,
-                limit,
+                marketAddress: marketAddress,
+                interval: _interval,
+                option: optionIndex,
             });
         }
         catch (error) {

package/dist/exchanges/rain/index.js

@@ -96,7 +96,11 @@ class RainExchange extends BaseExchange_1.PredictionMarketExchange {
         const marketId = parts[1];
         const choiceIndex = Number(parts[2]);
         const interval = normalizer_1.RainNormalizer.mapInterval(params.resolution);
-        const raw = await this.fetcher.fetchRawOHLCV(marketId, choiceIndex, interval, params.limit);
+        const market = await this.fetcher.fetchRawMarket(marketId);
+        const contractAddress = market?.details?.contractAddress;
+        if (!contractAddress)
+            return [];
+        const raw = await this.fetcher.fetchRawOHLCV(contractAddress, choiceIndex, interval, params.limit);
         return this.normalizer.normalizeOHLCV(raw, params.limit);
     }
     async fetchOrderBook(outcomeId, _limit, _params) {

package/dist/exchanges/smarkets/fetcher.js

@@ -40,12 +40,19 @@ class SmarketsFetcher {
             if (params.eventId) {
                 return this.fetchEnrichedEventById(params.eventId);
             }
+            if (params.limit !== undefined && params.limit <= 0) {
+                return [];
+            }
             const stateFilter = this.mapEventStatus(params?.status || 'active');
+            const requestedLimit = params.limit === undefined
+                ? undefined
+                : Math.max(1, Math.floor(params.limit));
             const rawEvents = await this.fetchPaginatedEvents({
                 state: stateFilter,
                 type_scope: ['single_event'],
                 with_new_type: true,
-            });
+                ...(requestedLimit === undefined ? {} : { limit: Math.min(requestedLimit, BATCH_SIZE) }),
+            }, requestedLimit);
             return this.enrichEvents(rawEvents);
         }
         catch (error) {
@@ -153,11 +160,8 @@ class SmarketsFetcher {
         const contracts = contractsData.contracts || [];
         if (contracts.length === 0)
             return [];
-        // Step 2: Fetch volumes for this market
-        const volumeData = await this.ctx.callApi('get_volumes_by_market_ids', {
-            market_ids: [marketId],
-        });
-        const volumes = volumeData.volumes || [];
+        // Step 2: Fetch optional authenticated volumes for this market.
+        const volumes = await this.fetchVolumesByMarketIds([marketId]);
         // Step 3: We need the event_id. The contracts have market_id but not event_id.
         // Use the events/markets endpoint by searching for events that contain this market.
         // The most reliable approach: fetch all active events and find the one that owns
@@ -201,6 +205,8 @@ class SmarketsFetcher {
             }];
     }
     async fetchAllEnrichedEvents(params) {
+        if (params?.limit !== undefined && params.limit <= 0)
+            return [];
         const stateFilter = this.mapEventStatus(params?.status || 'active');
         const limit = params?.limit || 1000;
         const rawEvents = await this.fetchPaginatedEvents({
@@ -318,6 +324,10 @@ class SmarketsFetcher {
     async fetchVolumesByMarketIds(marketIds) {
         if (marketIds.length === 0)
             return [];
+        const headers = this.ctx.getHeaders();
+        const hasAuthHeader = Object.entries(headers).some(([key, value]) => key.toLowerCase() === 'authorization' && String(value).trim().length > 0);
+        if (!hasAuthHeader)
+            return [];
         const batches = this.batchArray(marketIds, MARKET_ID_BATCH_SIZE);
         const results = await Promise.all(batches.map(async (batch) => {
             try {

package/dist/server/openapi.yaml

@@ -1142,6 +1142,7 @@ paths:
                         type: array
                         items:
                           $ref: '#/components/schemas/UserTrade'
+      description: Fetch authenticated user trade history.
   '/api/{exchange}/fetchClosedOrders':
     get:
       summary: Fetch Closed Orders
@@ -1194,6 +1195,7 @@ paths:
                         type: array
                         items:
                           $ref: '#/components/schemas/Order'
+      description: Fetch authenticated closed orders.
   '/api/{exchange}/fetchAllOrders':
     get:
       summary: Fetch All Orders
@@ -1246,6 +1248,7 @@ paths:
                         type: array
                         items:
                           $ref: '#/components/schemas/Order'
+      description: Fetch authenticated order history across open and closed orders.
   '/api/{exchange}/fetchPositions':
     get:
       summary: Fetch Positions
@@ -3639,6 +3642,15 @@ components:
         price:
           type: number
           description: Required for limit orders
+        denom:
+          type: string
+          enum:
+            - usdc
+            - shares
+          description: 'Hosted mode: amount unit.'
+        slippage_pct:
+          type: number
+          description: 'Hosted mode: maximum market-order slippage percentage.'
         fee:
           type: number
           description: 'Optional fee rate (e.g., 1000 for 0.1%)'
@@ -4488,7 +4500,7 @@ x-sdk-constructors:
         type: string
         description: Private key for authentication
   polymarket_us:
-    className: PolymarketUs
+    className: PolymarketUS
     params:
       - name: pmxt_api_key
         tsName: pmxtApiKey
@@ -4533,7 +4545,7 @@ x-sdk-constructors:
         type: string
         description: API secret for authentication
   suibets:
-    className: Suibets
+    className: SuiBets
     params:
       - name: pmxt_api_key
         tsName: pmxtApiKey

package/dist/types.d.ts

@@ -287,6 +287,8 @@ export interface CreateOrderParams {
     /** Size of the order in contracts/shares. */
     amount: number;
     price?: number;
+    denom?: 'usdc' | 'shares';
+    slippage_pct?: number;
     fee?: number;
     tickSize?: number;
     negRisk?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxt-core",
-  "version": "2.51.2",
+  "version": "2.51.3",
   "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.51.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.51.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.51.3,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.51.3,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",