pmxt-core 2.30.8 → 2.31.0

package/dist/BaseExchange.d.ts

@@ -46,6 +46,12 @@ export interface MarketFilterParams {
     similarityThreshold?: number;
 }
 export interface MarketFetchParams extends MarketFilterParams {
+    /** Optional client-side filter applied after fetching */
+    filter?: MarketFilterCriteria;
+    /** Shorthand for filter.category -- merged into filter (takes precedence) */
+    category?: string;
+    /** Shorthand for filter.tags -- merged into filter (takes precedence) */
+    tags?: string[];
 }
 export interface EventFetchParams {
     query?: string;
@@ -60,6 +66,12 @@ export interface EventFetchParams {
     searchIn?: 'title' | 'description' | 'both';
     eventId?: string;
     slug?: string;
+    /** Optional client-side filter applied after fetching */
+    filter?: EventFilterCriteria;
+    /** Shorthand for filter.category -- merged into filter (takes precedence) */
+    category?: string;
+    /** Shorthand for filter.tags -- merged into filter (takes precedence) */
+    tags?: string[];
 }
 /**
  * Deprecated - use OHLCVParams or TradesParams instead. Resolution is optional for backward compatibility.
@@ -115,7 +127,7 @@ export interface OrderHistoryParams {
     /** Opaque pagination cursor from a previous response */
     cursor?: string;
 }
-export type MarketFilterCriteria = {
+export interface MarketFilterCriteria {
     text?: string;
     searchIn?: ('title' | 'description' | 'category' | 'tags' | 'outcomes')[];
     volume24h?: {
@@ -153,9 +165,9 @@ export type MarketFilterCriteria = {
         min?: number;
         max?: number;
     };
-};
+}
 export type MarketFilterFunction = (market: UnifiedMarket) => boolean;
-export type EventFilterCriteria = {
+export interface EventFilterCriteria {
     text?: string;
     searchIn?: ('title' | 'description' | 'category' | 'tags')[];
     category?: string;
@@ -169,7 +181,7 @@ export type EventFilterCriteria = {
         min?: number;
         max?: number;
     };
-};
+}
 export type EventFilterFunction = (event: UnifiedEvent) => boolean;
 export type ExchangeCapability = true | false | 'emulated';
 export interface ExchangeHas {
@@ -338,6 +350,7 @@ export declare abstract class PredictionMarketExchange {
     fetchMarketsPaginated(params?: {
         limit?: number;
         cursor?: string;
+        filter?: MarketFilterCriteria;
     }): Promise<PaginatedMarketsResult>;
     /**
      * Fetch events with optional keyword search.

package/dist/BaseExchange.js

@@ -175,7 +175,27 @@ class PredictionMarketExchange {
      * @note Some exchanges (like Limitless) may only support status 'active' for search results.
      */
     async fetchMarkets(params) {
-        return this.fetchMarketsImpl(params);
+        const { filter, category, tags, ...fetchParams } = params ?? {};
+        // Merge explicit category/tags into the filter (explicit params take precedence)
+        const mergedFilter = {
+            ...(filter ?? {}),
+            ...(category !== undefined ? { category } : {}),
+            ...(tags !== undefined ? { tags } : {}),
+        };
+        const hasFilter = Object.keys(mergedFilter).length > 0;
+        if (hasFilter) {
+            // When filtering, pull limit/offset out of the venue fetch so
+            // the venue returns enough data for the filter to work with.
+            // Apply limit/offset after filtering so the caller gets the
+            // number of results they asked for.
+            const { limit, offset, ...venueParams } = fetchParams;
+            const markets = await this.fetchMarketsImpl(Object.keys(venueParams).length > 0 ? venueParams : undefined);
+            const filtered = this.filterMarkets(markets, mergedFilter);
+            const start = offset ?? 0;
+            return limit !== undefined ? filtered.slice(start, start + limit) : filtered.slice(start);
+        }
+        const markets = await this.fetchMarketsImpl(Object.keys(fetchParams).length > 0 ? fetchParams : undefined);
+        return markets;
     }
     /**
      * Fetch markets with cursor-based pagination backed by a stable in-memory snapshot.
@@ -195,6 +215,8 @@ class PredictionMarketExchange {
     async fetchMarketsPaginated(params) {
         const limit = params?.limit;
         const cursor = params?.cursor;
+        const filter = params?.filter;
+        const applyFilter = (markets) => filter ? this.filterMarkets(markets, filter) : markets;
         if (cursor) {
             // Cursor encodes: snapshotId:offset
             const sep = cursor.indexOf(':');
@@ -209,7 +231,7 @@ class PredictionMarketExchange {
             const slice = limit !== undefined ? markets.slice(offset, offset + limit) : markets.slice(offset);
             const nextOffset = offset + slice.length;
             const nextCursor = nextOffset < markets.length ? `${snapshotId}:${nextOffset}` : undefined;
-            return { data: slice, total: markets.length, nextCursor };
+            return { data: applyFilter(slice), total: markets.length, nextCursor };
         }
         // No cursor — (re)fetch snapshot
         if (!this._snapshot ||
@@ -224,11 +246,11 @@ class PredictionMarketExchange {
         }
         const markets = this._snapshot.markets;
         if (!limit) {
-            return { data: markets, total: markets.length, nextCursor: undefined };
+            return { data: applyFilter(markets), total: markets.length, nextCursor: undefined };
         }
         const slice = markets.slice(0, limit);
         const nextCursor = limit < markets.length ? `${this._snapshot.id}:${limit}` : undefined;
-        return { data: slice, total: markets.length, nextCursor };
+        return { data: applyFilter(slice), total: markets.length, nextCursor };
     }
     /**
      * Fetch events with optional keyword search.
@@ -244,7 +266,23 @@ class PredictionMarketExchange {
      * @note Some exchanges (like Limitless) may only support status 'active' for search results.
      */
     async fetchEvents(params) {
-        return this.fetchEventsImpl(params ?? {});
+        const { filter, category, tags, ...fetchParams } = params ?? {};
+        // Merge explicit category/tags into the filter (explicit params take precedence)
+        const mergedFilter = {
+            ...(filter ?? {}),
+            ...(category !== undefined ? { category } : {}),
+            ...(tags !== undefined ? { tags } : {}),
+        };
+        const hasFilter = Object.keys(mergedFilter).length > 0;
+        if (hasFilter) {
+            const { limit, offset, ...venueParams } = fetchParams;
+            const events = await this.fetchEventsImpl(venueParams);
+            const filtered = this.filterEvents(events, mergedFilter);
+            const start = offset ?? 0;
+            return limit !== undefined ? filtered.slice(start, start + limit) : filtered.slice(start);
+        }
+        const events = await this.fetchEventsImpl(fetchParams);
+        return events;
     }
     /**
      * Fetch a single market by lookup parameters.

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-14T08:11:59.575Z
+ * Generated at: 2026-04-14T11:53:52.793Z
  * 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-14T08:11:59.575Z
+ * Generated at: 2026-04-14T11:53:52.793Z
  * 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-14T08:11:59.613Z
+ * Generated at: 2026-04-14T11:53:52.834Z
  * 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-14T08:11:59.613Z
+ * Generated at: 2026-04-14T11:53:52.834Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.limitlessApiSpec = {

package/dist/exchanges/limitless/index.js

@@ -432,18 +432,12 @@ class LimitlessExchange extends BaseExchange_1.PredictionMarketExchange {
             fetches.push(this.fetchPositions(address)
                 .then((positions) => {
                 result.positions = positions;
-            })
-                .catch(() => {
-                result.positions = [];
             }));
         }
         if (types.includes('balances')) {
             fetches.push(this.getAddressOnChainBalance(address)
                 .then((balances) => {
                 result.balances = balances;
-            })
-                .catch(() => {
-                result.balances = [];
             }));
         }
         await Promise.all(fetches);

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-14T08:11:59.625Z
+ * Generated at: 2026-04-14T11:53:52.846Z
  * 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-14T08:11:59.625Z
+ * Generated at: 2026-04-14T11:53:52.846Z
  * 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-14T08:11:59.629Z
+ * Generated at: 2026-04-14T11:53:52.851Z
  * 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-14T08:11:59.629Z
+ * Generated at: 2026-04-14T11:53:52.851Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.opinionApiSpec = {

package/dist/exchanges/opinion/normalizer.js

@@ -154,7 +154,7 @@ class OpinionNormalizer {
         return {
             id: raw.orderId || '',
             marketId: String(raw.marketId),
-            outcomeId: String(raw.marketId),
+            outcomeId: raw.outcome || (raw.outcomeSide === 1 ? 'Yes' : 'No'),
             side: raw.side === 1 ? 'buy' : 'sell',
             type: raw.tradingMethod === 2 ? 'limit' : 'market',
             price: (0, utils_1.parseNumStr)(raw.price),
@@ -170,14 +170,20 @@ class OpinionNormalizer {
         if (!raw || raw.marketType !== 0)
             return null;
         const marketId = String(raw.marketId);
+        if (!raw.yesTokenId) {
+            throw new Error(`Opinion market ${marketId} is missing yesTokenId`);
+        }
+        if (!raw.noTokenId) {
+            throw new Error(`Opinion market ${marketId} is missing noTokenId`);
+        }
         const yesOutcome = {
-            outcomeId: raw.yesTokenId || '',
+            outcomeId: raw.yesTokenId,
             marketId,
             label: raw.yesLabel || 'Yes',
             price: 0.5,
         };
         const noOutcome = {
-            outcomeId: raw.noTokenId || '',
+            outcomeId: raw.noTokenId,
             marketId,
             label: raw.noLabel || 'No',
             price: 0.5,
@@ -200,14 +206,20 @@ class OpinionNormalizer {
         if (!child)
             return null;
         const marketId = String(child.marketId);
+        if (!child.yesTokenId) {
+            throw new Error(`Opinion child market ${marketId} is missing yesTokenId`);
+        }
+        if (!child.noTokenId) {
+            throw new Error(`Opinion child market ${marketId} is missing noTokenId`);
+        }
         const yesOutcome = {
-            outcomeId: child.yesTokenId || '',
+            outcomeId: child.yesTokenId,
             marketId,
             label: child.yesLabel || 'Yes',
             price: 0.5,
         };
         const noOutcome = {
-            outcomeId: child.noTokenId || '',
+            outcomeId: child.noTokenId,
             marketId,
             label: child.noLabel || 'No',
             price: 0.5,

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-14T08:11:59.581Z
+ * Generated at: 2026-04-14T11:53:52.802Z
  * 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-14T08:11:59.581Z
+ * Generated at: 2026-04-14T11:53:52.802Z
  * 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-14T08:11:59.593Z
+ * Generated at: 2026-04-14T11:53:52.816Z
  * 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-14T08:11:59.593Z
+ * Generated at: 2026-04-14T11:53:52.816Z
  * 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-14T08:11:59.591Z
+ * Generated at: 2026-04-14T11:53:52.814Z
  * 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-14T08:11:59.591Z
+ * Generated at: 2026-04-14T11:53:52.814Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketGammaSpec = {

package/dist/exchanges/polymarket_us/index.js

@@ -130,7 +130,10 @@ class PolymarketUSExchange extends BaseExchange_1.PredictionMarketExchange {
                 limit: params?.limit ?? 250,
                 offset: params?.offset ?? 0,
             });
-            let markets = (resp.markets || []).map(m => this.normalizer.normalizeMarket(m));
+            if (!resp.markets) {
+                throw new Error('PolymarketUS markets.list response missing required "markets" field');
+            }
+            let markets = resp.markets.map(m => this.normalizer.normalizeMarket(m));
             if (params?.query) {
                 const q = params.query.toLowerCase();
                 markets = markets.filter(m => m.title.toLowerCase().includes(q) ||
@@ -151,7 +154,10 @@ class PolymarketUSExchange extends BaseExchange_1.PredictionMarketExchange {
                 limit: params?.limit ?? 100,
                 offset: params?.offset ?? 0,
             });
-            let events = (resp.events || []).map(e => this.normalizer.normalizeEvent(e));
+            if (!resp.events) {
+                throw new Error('PolymarketUS events.list response missing required "events" field');
+            }
+            let events = resp.events.map(e => this.normalizer.normalizeEvent(e));
             if (params?.query) {
                 const q = params.query.toLowerCase();
                 events = events.filter(e => e.title.toLowerCase().includes(q) ||
@@ -184,7 +190,10 @@ class PolymarketUSExchange extends BaseExchange_1.PredictionMarketExchange {
         this.requireAuth();
         return this.run(async () => {
             const resp = await this.client.portfolio.positions({});
-            return this.normalizer.normalizePositions(resp.positions || {});
+            if (!resp.positions) {
+                throw new Error('PolymarketUS portfolio.positions response missing required "positions" field');
+            }
+            return this.normalizer.normalizePositions(resp.positions);
         });
     }
     async fetchMyTrades(params) {
@@ -195,7 +204,10 @@ class PolymarketUSExchange extends BaseExchange_1.PredictionMarketExchange {
                 limit: params?.limit ?? 100,
                 marketSlug: params?.marketId,
             });
-            const activities = resp.activities || [];
+            if (!resp.activities) {
+                throw new Error('PolymarketUS portfolio.activities response missing required "activities" field');
+            }
+            const activities = resp.activities;
             const trades = [];
             activities.forEach((activity, idx) => {
                 const trade = this.normalizer.normalizeUserTradeFromActivity(activity, idx);
@@ -214,7 +226,10 @@ class PolymarketUSExchange extends BaseExchange_1.PredictionMarketExchange {
             const resp = await this.client.orders.list({
                 slugs: marketId ? [marketId] : undefined,
             });
-            const raws = resp.orders || [];
+            if (!resp.orders) {
+                throw new Error('PolymarketUS orders.list response missing required "orders" field');
+            }
+            const raws = resp.orders;
             return raws.map(raw => {
                 const normalized = this.normalizer.normalizeOrder(raw);
                 this.cacheOrder(normalized.id, raw.marketSlug);
@@ -274,26 +289,7 @@ class PolymarketUSExchange extends BaseExchange_1.PredictionMarketExchange {
         const response = await this.run(() => this.client.orders.create(sdkParams));
         const newId = response.id;
         this.cacheOrder(newId, built.params.marketId);
-        try {
-            return await this.fetchOrder(newId);
-        }
-        catch {
-            // Order may not yet be visible via retrieve. Fall back to a
-            // synthetic Order built from the original params.
-            return {
-                id: newId,
-                marketId: built.params.marketId,
-                outcomeId: built.params.outcomeId,
-                side: built.params.side,
-                type: built.params.type,
-                price: built.params.price ?? 0,
-                amount: built.params.amount,
-                status: 'open',
-                filled: 0,
-                remaining: built.params.amount,
-                timestamp: Date.now(),
-            };
-        }
+        return await this.fetchOrder(newId);
     }
     async createOrder(params) {
         const built = await this.buildOrder(params);

package/dist/exchanges/polymarket_us/normalizer.js

@@ -274,11 +274,12 @@ class PolymarketUSNormalizer {
      * needing the short-side view must invert prices themselves.
      */
     normalizeOrderBook(book, _marketId) {
-        const bids = (book.bids || []).map(level => ({
+        // Missing bids/offers is a valid state (no liquidity), not broken data
+        const bids = (book.bids ?? []).map(level => ({
             price: (0, price_1.fromAmount)(level.px),
             size: parseFloat(level.qty || '0'),
         }));
-        const asks = (book.offers || []).map(level => ({
+        const asks = (book.offers ?? []).map(level => ({
             price: (0, price_1.fromAmount)(level.px),
             size: parseFloat(level.qty || '0'),
         }));

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-14T08:11:59.617Z
+ * Generated at: 2026-04-14T11:53:52.838Z
  * 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-14T08:11:59.617Z
+ * Generated at: 2026-04-14T11:53:52.838Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

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

@@ -57,30 +57,21 @@ export interface ProbableRawTrade {
     id?: string | number;
     tradeId?: string | number;
     time?: number;
-    timestamp?: number;
     price?: string | number;
-    qty?: string | number;
     size?: string | number;
-    amount?: string | number;
     side?: string;
     orderId?: string;
     [key: string]: unknown;
 }
 export interface ProbableRawPosition {
-    conditionId?: string;
     condition_id?: string;
-    asset?: string;
     token_id?: string;
     outcome?: string;
     title?: string;
     size?: string | number;
-    avgPrice?: string | number;
     avg_price?: string | number;
-    curPrice?: string | number;
     cur_price?: string | number;
-    cashPnl?: string | number;
     cash_pnl?: string | number;
-    realizedPnl?: string | number;
     realized_pnl?: string | number;
     [key: string]: unknown;
 }

package/dist/exchanges/probable/fetcher.js

@@ -109,7 +109,14 @@ class ProbableFetcher {
         if (params.end)
             queryParams.endTs = Math.floor(params.end.getTime() / 1000);
         const data = await this.ctx.callApi('getPublicApiV1PricesHistory', queryParams);
-        return data?.history || data || [];
+        if (data != null && typeof data === 'object' && !Array.isArray(data) && Array.isArray(data.history)) {
+            return data.history;
+        }
+        if (Array.isArray(data)) {
+            return data;
+        }
+        throw new Error(`Probable OHLCV: unexpected response shape (got ${typeof data}). ` +
+            `Expected { history: [...] } or an array.`);
     }
     // -----------------------------------------------------------------------
     // Trades
@@ -122,23 +129,30 @@ class ProbableFetcher {
         // client's getTrades through callApi or directly. For now, this goes
         // through the implicit API.
         const data = await this.ctx.callApi('getPublicApiV1Trades', queryParams);
-        const trades = Array.isArray(data) ? data : (data?.data || []);
-        return trades;
+        if (!Array.isArray(data)) {
+            throw new Error(`Probable trades: unexpected response shape (got ${typeof data}). Expected an array.`);
+        }
+        return data;
     }
     async fetchRawMyTrades(params, walletAddress) {
         const queryParams = { user: walletAddress };
         if (params?.limit)
             queryParams.limit = params.limit;
         const data = await this.ctx.callApi('getPublicApiV1Trades', queryParams);
-        const trades = Array.isArray(data) ? data : (data?.data || []);
-        return trades;
+        if (!Array.isArray(data)) {
+            throw new Error(`Probable myTrades: unexpected response shape (got ${typeof data}). Expected an array.`);
+        }
+        return data;
     }
     // -----------------------------------------------------------------------
     // Positions & Balance
     // -----------------------------------------------------------------------
     async fetchRawPositions(walletAddress) {
         const result = await this.ctx.callApi('getPublicApiV1PositionCurrent', { user: walletAddress, limit: 500 });
-        return Array.isArray(result) ? result : (result?.data || []);
+        if (!Array.isArray(result)) {
+            throw new Error(`Probable positions: unexpected response shape (got ${typeof result}). Expected an array.`);
+        }
+        return result;
     }
     // -----------------------------------------------------------------------
     // Midpoint (price enrichment)
@@ -183,7 +197,10 @@ class ProbableFetcher {
                     const response = await this.ctx.http.get(`${utils_1.BASE_URL}${utils_1.MARKETS_PATH}`, {
                         params: { page: 1, limit: 100, active: true },
                     });
-                    const markets = response.data?.markets || [];
+                    if (!response.data?.markets || !Array.isArray(response.data.markets)) {
+                        throw new Error(`Probable markets list: unexpected response shape. Expected { markets: [...] }.`);
+                    }
+                    const markets = response.data.markets;
                     return markets.filter(m => String(m.id) === cleanSlug);
                 }
                 throw error;
@@ -215,7 +232,10 @@ class ProbableFetcher {
             queryParams.event_id = params.eventId;
         }
         const response = await this.ctx.http.get(`${utils_1.BASE_URL}${utils_1.MARKETS_PATH}`, { params: queryParams });
-        return response.data?.markets || [];
+        if (!response.data?.markets || !Array.isArray(response.data.markets)) {
+            throw new Error(`Probable markets list: unexpected response shape. Expected { markets: [...] }.`);
+        }
+        return response.data.markets;
     }
     async fetchRawMarketsViaSearch(query, params) {
         const limit = params?.limit || 20;
@@ -264,7 +284,10 @@ class ProbableFetcher {
             }
         }
         const searchData = await this.ctx.callApi('getPublicApiV1PublicSearch', queryParams);
-        const events = searchData?.events || [];
+        if (!searchData?.events || !Array.isArray(searchData.events)) {
+            throw new Error(`Probable search: unexpected response shape. Expected { events: [...] }.`);
+        }
+        const events = searchData.events;
         const rawMarkets = [];
         for (const event of events) {
             if (event.markets && Array.isArray(event.markets)) {
@@ -300,8 +323,10 @@ class ProbableFetcher {
         queryParams.ascending = false;
         const response = await this.ctx.http.get(`${utils_1.BASE_URL}${utils_1.EVENTS_PATH}`, { params: queryParams });
         const data = response.data;
-        // API returns either a raw array or { events: [...] }
-        return Array.isArray(data) ? data : (data?.events || []);
+        if (!Array.isArray(data)) {
+            throw new Error(`Probable events list: unexpected response shape (got ${typeof data}). Expected an array.`);
+        }
+        return data;
     }
     async fetchRawEventsViaSearch(params) {
         const limit = params.limit || 20;
@@ -314,7 +339,10 @@ class ProbableFetcher {
             keep_closed_markets: params.status === 'all' || params.status === 'inactive' || params.status === 'closed' ? 1 : 0,
         };
         const searchData = await this.ctx.callApi('getPublicApiV1PublicSearch', queryParams);
-        return searchData?.events || [];
+        if (!searchData?.events || !Array.isArray(searchData.events)) {
+            throw new Error(`Probable event search: unexpected response shape. Expected { events: [...] }.`);
+        }
+        return searchData.events;
     }
 }
 exports.ProbableFetcher = ProbableFetcher;

package/dist/exchanges/probable/normalizer.js

@@ -65,40 +65,72 @@ class ProbableNormalizer {
         return candles;
     }
     normalizeTrade(raw, index) {
+        if (raw.id == null && raw.tradeId == null) {
+            throw new Error(`Probable trade at index ${index}: missing required field "id" or "tradeId".`);
+        }
+        if (raw.price == null) {
+            throw new Error(`Probable trade at index ${index}: missing required field "price".`);
+        }
+        if (raw.size == null) {
+            throw new Error(`Probable trade at index ${index}: missing required field "size".`);
+        }
+        if (raw.time == null) {
+            throw new Error(`Probable trade at index ${index}: missing required field "time".`);
+        }
         return {
-            id: String(raw.id || raw.tradeId || `${raw.time}-${raw.price}`),
-            timestamp: typeof raw.time === 'number'
-                ? (raw.time < 1e12 ? raw.time * 1000 : raw.time)
-                : Date.now(),
-            price: parseFloat(String(raw.price || '0')),
-            amount: parseFloat(String(raw.qty || raw.size || raw.amount || '0')),
+            id: String(raw.id ?? raw.tradeId),
+            timestamp: raw.time < 1e12 ? raw.time * 1000 : raw.time,
+            price: parseFloat(String(raw.price)),
+            amount: parseFloat(String(raw.size)),
             side: raw.side === 'BUY' ? 'buy'
                 : raw.side === 'SELL' ? 'sell'
                     : 'unknown',
         };
     }
     normalizeUserTrade(raw, index) {
+        if (raw.tradeId == null && raw.id == null) {
+            throw new Error(`Probable user trade at index ${index}: missing required field "tradeId" or "id".`);
+        }
+        if (raw.price == null) {
+            throw new Error(`Probable user trade at index ${index}: missing required field "price".`);
+        }
+        if (raw.size == null) {
+            throw new Error(`Probable user trade at index ${index}: missing required field "size".`);
+        }
+        if (raw.time == null) {
+            throw new Error(`Probable user trade at index ${index}: missing required field "time".`);
+        }
+        if (raw.side == null) {
+            throw new Error(`Probable user trade at index ${index}: missing required field "side".`);
+        }
         return {
-            id: String(raw.tradeId || raw.id || raw.timestamp),
-            timestamp: typeof raw.time === 'number'
-                ? (raw.time > 1e12 ? raw.time : raw.time * 1000)
-                : Date.now(),
-            price: parseFloat(String(raw.price || '0')),
-            amount: parseFloat(String(raw.qty || raw.size || raw.amount || '0')),
-            side: (String(raw.side || '')).toLowerCase() === 'buy' ? 'buy' : 'sell',
+            id: String(raw.tradeId ?? raw.id),
+            timestamp: raw.time > 1e12 ? raw.time : raw.time * 1000,
+            price: parseFloat(String(raw.price)),
+            amount: parseFloat(String(raw.size)),
+            side: String(raw.side).toLowerCase() === 'buy' ? 'buy' : 'sell',
             orderId: raw.orderId,
         };
     }
     normalizePosition(raw) {
+        if (raw.condition_id == null) {
+            throw new Error(`Probable position: missing required field "condition_id".`);
+        }
+        if (raw.token_id == null) {
+            throw new Error(`Probable position: missing required field "token_id".`);
+        }
+        if (raw.size == null) {
+            throw new Error(`Probable position: missing required field "size".`);
+        }
         return {
-            marketId: String(raw.conditionId || raw.condition_id || ''),
-            outcomeId: String(raw.asset || raw.token_id || ''),
+            marketId: String(raw.condition_id),
+            outcomeId: String(raw.token_id),
             outcomeLabel: raw.outcome || raw.title || 'Unknown',
-            size: parseFloat(String(raw.size || '0')),
-            entryPrice: parseFloat(String(raw.avgPrice || raw.avg_price || '0')),
-            currentPrice: parseFloat(String(raw.curPrice || raw.cur_price || '0')),
-            unrealizedPnL: parseFloat(String(raw.cashPnl || raw.cash_pnl || '0')),
-            realizedPnL: parseFloat(String(raw.realizedPnl || raw.realized_pnl || '0')),
+            size: parseFloat(String(raw.size)),
+            entryPrice: parseFloat(String(raw.avg_price ?? '0')),
+            currentPrice: parseFloat(String(raw.cur_price ?? '0')),
+            unrealizedPnL: parseFloat(String(raw.cash_pnl ?? '0')),
+            realizedPnL: parseFloat(String(raw.realized_pnl ?? '0')),
         };
     }
     // -- Price enrichment helper (used by SDK class) --

package/dist/server/app.js

@@ -61,6 +61,13 @@ const METHOD_VERBS = loadMethodVerbs();
 function coerceQueryValue(raw, kind) {
     if (Array.isArray(raw))
         return raw.map((v) => coerceQueryValue(v, kind));
+    if (typeof raw === "object" && raw !== null && !Array.isArray(raw)) {
+        const result = {};
+        for (const [k, v] of Object.entries(raw)) {
+            result[k] = coerceQueryValue(v);
+        }
+        return result;
+    }
     if (typeof raw !== "string")
         return raw;
     if (kind === "string")
@@ -86,6 +93,12 @@ function coerceQueryValue(raw, kind) {
         return false;
     if (raw === "null")
         return null;
+    if (raw.startsWith("{") || raw.startsWith("[")) {
+        try {
+            return JSON.parse(raw);
+        }
+        catch { /* fall through */ }
+    }
     if (/^-?\d+$/.test(raw))
         return parseInt(raw, 10);
     if (/^-?\d*\.\d+$/.test(raw))

package/dist/server/openapi.yaml

@@ -191,6 +191,11 @@ paths:
           required: false
           schema:
             type: string
+        - in: query
+          name: filter
+          required: false
+          schema:
+            $ref: '#/components/schemas/MarketFilterCriteria'
       responses:
         '200':
           description: Fetch Markets Paginated response
@@ -276,6 +281,27 @@ paths:
           schema:
             type: string
           description: Lookup by event slug
+        - in: query
+          name: filter
+          required: false
+          schema:
+            allOf:
+              - $ref: '#/components/schemas/EventFilterCriteria'
+          description: Optional client-side filter applied after fetching
+        - in: query
+          name: category
+          required: false
+          schema:
+            type: string
+          description: Shorthand for filter.category -- merged into filter (takes precedence)
+        - in: query
+          name: tags
+          required: false
+          schema:
+            type: array
+            items:
+              type: string
+          description: Shorthand for filter.tags -- merged into filter (takes precedence)
       responses:
         '200':
           description: Fetch Events response
@@ -466,6 +492,27 @@ paths:
           schema:
             type: string
           description: Lookup by event slug
+        - in: query
+          name: filter
+          required: false
+          schema:
+            allOf:
+              - $ref: '#/components/schemas/EventFilterCriteria'
+          description: Optional client-side filter applied after fetching
+        - in: query
+          name: category
+          required: false
+          schema:
+            type: string
+          description: Shorthand for filter.category -- merged into filter (takes precedence)
+        - in: query
+          name: tags
+          required: false
+          schema:
+            type: array
+            items:
+              type: string
+          description: Shorthand for filter.tags -- merged into filter (takes precedence)
       responses:
         '200':
           description: Fetch Event response
@@ -1131,95 +1178,7 @@ paths:
                         items:
                           $ref: '#/components/schemas/UnifiedMarket'
                       - type: string
-                      - type: object
-                        properties:
-                          text:
-                            type: string
-                          searchIn:
-                            type: array
-                            items:
-                              type: string
-                              enum:
-                                - title
-                                - description
-                                - category
-                                - tags
-                                - outcomes
-                          volume24h:
-                            type: object
-                            properties:
-                              min:
-                                type: number
-                              max:
-                                type: number
-                          volume:
-                            type: object
-                            properties:
-                              min:
-                                type: number
-                              max:
-                                type: number
-                          liquidity:
-                            type: object
-                            properties:
-                              min:
-                                type: number
-                              max:
-                                type: number
-                          openInterest:
-                            type: object
-                            properties:
-                              min:
-                                type: number
-                              max:
-                                type: number
-                          resolutionDate:
-                            type: object
-                            properties:
-                              before:
-                                type: string
-                                format: date-time
-                              after:
-                                type: string
-                                format: date-time
-                          category:
-                            type: string
-                          tags:
-                            type: array
-                            items:
-                              type: string
-                          price:
-                            type: object
-                            properties:
-                              outcome:
-                                type: string
-                                enum:
-                                  - 'yes'
-                                  - 'no'
-                                  - up
-                                  - down
-                              min:
-                                type: number
-                              max:
-                                type: number
-                            required:
-                              - outcome
-                          priceChange24h:
-                            type: object
-                            properties:
-                              outcome:
-                                type: string
-                                enum:
-                                  - 'yes'
-                                  - 'no'
-                                  - up
-                                  - down
-                              min:
-                                type: number
-                              max:
-                                type: number
-                            required:
-                              - outcome
+                      - $ref: '#/components/schemas/MarketFilterCriteria'
                       - type: object
                 credentials:
                   $ref: '#/components/schemas/ExchangeCredentials'
@@ -1265,39 +1224,7 @@ paths:
                         items:
                           $ref: '#/components/schemas/UnifiedEvent'
                       - type: string
-                      - type: object
-                        properties:
-                          text:
-                            type: string
-                          searchIn:
-                            type: array
-                            items:
-                              type: string
-                              enum:
-                                - title
-                                - description
-                                - category
-                                - tags
-                          category:
-                            type: string
-                          tags:
-                            type: array
-                            items:
-                              type: string
-                          marketCount:
-                            type: object
-                            properties:
-                              min:
-                                type: number
-                              max:
-                                type: number
-                          totalVolume:
-                            type: object
-                            properties:
-                              min:
-                                type: number
-                              max:
-                                type: number
+                      - $ref: '#/components/schemas/EventFilterCriteria'
                       - type: object
                 credentials:
                   $ref: '#/components/schemas/ExchangeCredentials'
@@ -2111,6 +2038,18 @@ components:
         slug:
           type: string
           description: Lookup by event slug
+        filter:
+          allOf:
+            - $ref: '#/components/schemas/EventFilterCriteria'
+          description: Optional client-side filter applied after fetching
+        category:
+          type: string
+          description: Shorthand for filter.category -- merged into filter (takes precedence)
+        tags:
+          type: array
+          items:
+            type: string
+          description: Shorthand for filter.tags -- merged into filter (takes precedence)
     HistoryFilterParams:
       type: object
       description: Deprecated - use OHLCVParams or TradesParams instead. Resolution is optional for backward compatibility.
@@ -2301,6 +2240,138 @@ components:
         cursor:
           type: string
           description: Opaque pagination cursor from a previous response
+    MarketFilterCriteria:
+      type: object
+      properties:
+        text:
+          type: string
+        searchIn:
+          type: array
+          items:
+            type: string
+            enum:
+              - title
+              - description
+              - category
+              - tags
+              - outcomes
+          description: 'Default: [''title'']'
+        volume24h:
+          type: object
+          properties:
+            min:
+              type: number
+            max:
+              type: number
+        volume:
+          type: object
+          properties:
+            min:
+              type: number
+            max:
+              type: number
+          description: Filter by total (lifetime) volume range
+        liquidity:
+          type: object
+          properties:
+            min:
+              type: number
+            max:
+              type: number
+          description: Filter by current liquidity range
+        openInterest:
+          type: object
+          properties:
+            min:
+              type: number
+            max:
+              type: number
+          description: Filter by open interest range
+        resolutionDate:
+          type: object
+          properties:
+            before:
+              type: string
+              format: date-time
+            after:
+              type: string
+              format: date-time
+        category:
+          type: string
+        tags:
+          type: array
+          items:
+            type: string
+          description: Match if market has ANY of these tags
+        price:
+          type: object
+          properties:
+            outcome:
+              type: string
+              enum:
+                - 'yes'
+                - 'no'
+                - up
+                - down
+            min:
+              type: number
+            max:
+              type: number
+          required:
+            - outcome
+        priceChange24h:
+          type: object
+          properties:
+            outcome:
+              type: string
+              enum:
+                - 'yes'
+                - 'no'
+                - up
+                - down
+            min:
+              type: number
+            max:
+              type: number
+          required:
+            - outcome
+    EventFilterCriteria:
+      type: object
+      properties:
+        text:
+          type: string
+        searchIn:
+          type: array
+          items:
+            type: string
+            enum:
+              - title
+              - description
+              - category
+              - tags
+          description: 'Default: [''title'']'
+        category:
+          type: string
+        tags:
+          type: array
+          items:
+            type: string
+          description: Match events that have any of these tags
+        marketCount:
+          type: object
+          properties:
+            min:
+              type: number
+            max:
+              type: number
+        totalVolume:
+          type: object
+          properties:
+            min:
+              type: number
+            max:
+              type: number
+          description: Sum of market volumes
     ExchangeCredentials:
       type: object
       description: Optional authentication credentials for exchange operations.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxt-core",
-  "version": "2.30.8",
+  "version": "2.31.0",
   "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.30.8,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.30.8,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.31.0,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.31.0,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",