pmxt-core 2.43.12 → 2.43.13

package/dist/BaseExchange.d.ts

@@ -128,6 +128,11 @@ export interface FetchOrderBookParams {
     /** Outcome side: 'yes' or 'no'. Required for exchanges like Limitless
      *  where the API returns a single orderbook per market. */
     side?: 'yes' | 'no';
+    /** Outcome alias: 'yes' or 'no', or an outcome token ID. When set,
+     *  the first argument is treated as a market ID and this value selects
+     *  which outcome's order book to fetch. Accepts the literal strings
+     *  'yes'/'no' (resolved via a market lookup) or a raw outcome token ID. */
+    outcome?: string;
     /** Unix timestamp (ms) — fetch a historical snapshot at or before this
      *  time, or the start of a range when combined with `until` (hosted API only). */
     since?: number;
@@ -453,6 +458,21 @@ export declare abstract class PredictionMarketExchange {
      * @throws MarketNotFound if no market matches the parameters
      */
     fetchMarket(params?: MarketFetchParams): Promise<UnifiedMarket>;
+    private cacheMarketLookup;
+    private marketMatchesIdentifier;
+    private getCachedMarketForOutcomeAlias;
+    private fetchMarketForOutcomeAlias;
+    /**
+     * Resolve an outcome alias ('yes'/'no') to an actual outcome token ID.
+     * When params.outcome is set, treats `id` as a market ID, looks up the
+     * market, and returns the resolved outcome token ID plus cleaned params.
+     * When params.outcome is already a token ID (not 'yes'/'no'), returns it
+     * directly. When params.outcome is not set, returns `id` unchanged.
+     */
+    protected resolveOutcomeAlias(id: string, params?: FetchOrderBookParams): Promise<{
+        outcomeId: string;
+        params?: FetchOrderBookParams;
+    }>;
     /**
      * Fetch a single event by lookup parameters.
      * Convenience wrapper around fetchEvents() that returns a single result or throws EventNotFound.

package/dist/BaseExchange.js

@@ -386,6 +386,63 @@ class PredictionMarketExchange {
         }
         return markets[0];
     }
+    cacheMarketLookup(market) {
+        this.markets[market.marketId] = market;
+        if (market.slug) {
+            this.marketsBySlug[market.slug] = market;
+        }
+    }
+    marketMatchesIdentifier(market, id) {
+        return market.marketId === id
+            || market.slug === id
+            || market.contractAddress === id
+            || market.id === id;
+    }
+    getCachedMarketForOutcomeAlias(id) {
+        const direct = this.markets[id] ?? this.marketsBySlug[id];
+        if (direct && this.marketMatchesIdentifier(direct, id))
+            return direct;
+        return Object.values(this.markets).find((market) => this.marketMatchesIdentifier(market, id));
+    }
+    async fetchMarketForOutcomeAlias(id) {
+        const cached = this.getCachedMarketForOutcomeAlias(id);
+        if (cached)
+            return cached;
+        for (const params of [{ marketId: id }, { slug: id }]) {
+            const markets = await this.fetchMarkets(params);
+            const exact = markets.find((market) => this.marketMatchesIdentifier(market, id));
+            const market = exact ?? (markets.length === 1 ? markets[0] : undefined);
+            if (market) {
+                this.cacheMarketLookup(market);
+                return market;
+            }
+        }
+        throw new errors_1.MarketNotFound(id, this.name);
+    }
+    /**
+     * Resolve an outcome alias ('yes'/'no') to an actual outcome token ID.
+     * When params.outcome is set, treats `id` as a market ID, looks up the
+     * market, and returns the resolved outcome token ID plus cleaned params.
+     * When params.outcome is already a token ID (not 'yes'/'no'), returns it
+     * directly. When params.outcome is not set, returns `id` unchanged.
+     */
+    async resolveOutcomeAlias(id, params) {
+        if (!params?.outcome)
+            return { outcomeId: id, params };
+        const outcome = String(params.outcome);
+        const alias = outcome.toLowerCase();
+        const { outcome: _, ...rest } = params;
+        if (alias === 'yes' || alias === 'no') {
+            const market = await this.fetchMarketForOutcomeAlias(id);
+            const selected = alias === 'yes' ? market.yes : market.no;
+            if (!selected) {
+                throw new Error(`Market "${id}" has no '${alias}' outcome on ${this.name}`);
+            }
+            return { outcomeId: selected.outcomeId, params: rest };
+        }
+        // outcome is already a raw token ID — use it directly
+        return { outcomeId: outcome, params: rest };
+    }
     // ----------------------------------------------------------------------------
     // Implementation methods (to be overridden by exchanges)
     // ----------------------------------------------------------------------------

package/dist/exchanges/baozi/index.js

@@ -73,6 +73,9 @@ class BaoziExchange extends BaseExchange_1.PredictionMarketExchange {
         return [];
     }
     async fetchOrderBook(outcomeId, _limit, _params) {
+        const resolved = await this.resolveOutcomeAlias(outcomeId, _params);
+        outcomeId = resolved.outcomeId;
+        _params = resolved.params;
         const rawMarket = await this.fetcher.fetchRawOrderBook(outcomeId);
         return this.normalizer.normalizeOrderBook(rawMarket, outcomeId);
     }

package/dist/exchanges/gemini-titan/index.js

@@ -68,6 +68,9 @@ class GeminiTitanExchange extends BaseExchange_1.PredictionMarketExchange {
             .filter((e) => e !== null);
     }
     async fetchOrderBook(outcomeId, _limit, _params) {
+        const resolved = await this.resolveOutcomeAlias(outcomeId, _params);
+        outcomeId = resolved.outcomeId;
+        _params = resolved.params;
         const { instrumentSymbol } = (0, utils_1.fromOutcomeId)(outcomeId);
         const raw = await this.fetcher.fetchRawOrderBook(instrumentSymbol);
         if (!raw) {

package/dist/exchanges/hyperliquid/index.js

@@ -79,6 +79,9 @@ class HyperliquidExchange extends BaseExchange_1.PredictionMarketExchange {
             .filter((e) => e !== null);
     }
     async fetchOrderBook(outcomeId, _limit, _params) {
+        const resolved = await this.resolveOutcomeAlias(outcomeId, _params);
+        outcomeId = resolved.outcomeId;
+        _params = resolved.params;
         const raw = await this.fetcher.fetchRawOrderBook(outcomeId);
         return this.normalizer.normalizeOrderBook(raw, 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-05-23T13:25:22.239Z
+ * Generated at: 2026-05-23T22:05:07.957Z
  * 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-05-23T13:25:22.239Z
+ * Generated at: 2026-05-23T22:05:07.957Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.kalshiApiSpec = {

package/dist/exchanges/kalshi/index.js

@@ -123,6 +123,9 @@ class KalshiExchange extends BaseExchange_1.PredictionMarketExchange {
         return this.normalizer.normalizeOHLCV(rawCandles, params);
     }
     async fetchOrderBook(outcomeId, _limit, _params) {
+        const resolved = await this.resolveOutcomeAlias(outcomeId, _params);
+        outcomeId = resolved.outcomeId;
+        _params = resolved.params;
         const raw = await this.fetcher.fetchRawOrderBook(outcomeId);
         return this.normalizer.normalizeOrderBook(raw, outcomeId);
     }

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-05-23T13:25:22.282Z
+ * Generated at: 2026-05-23T22:05:08.004Z
  * 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-05-23T13:25:22.282Z
+ * Generated at: 2026-05-23T22:05:08.004Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.limitlessApiSpec = {

package/dist/exchanges/limitless/index.js

@@ -156,6 +156,9 @@ class LimitlessExchange extends BaseExchange_1.PredictionMarketExchange {
         return this.normalizer.normalizeOHLCV(rawPrices, params);
     }
     async fetchOrderBook(outcomeId, limit, params) {
+        const resolved = await this.resolveOutcomeAlias(outcomeId, params);
+        outcomeId = resolved.outcomeId;
+        params = resolved.params;
         const slug = await this.resolveSlug(outcomeId);
         const rawOrderBook = await this.fetcher.fetchRawOrderBook(slug);
         const orderBook = this.normalizer.normalizeOrderBook(rawOrderBook, outcomeId);

package/dist/exchanges/mock/index.js

@@ -279,6 +279,8 @@ class MockExchange extends BaseExchange_1.PredictionMarketExchange {
         return limit !== undefined ? events.slice(offset, offset + limit) : events.slice(offset);
     }
     async fetchOrderBook(id, _limit, _params) {
+        const resolved = await this.resolveOutcomeAlias(id, _params);
+        id = resolved.outcomeId;
         const f = new seededRng_1.SeededRng(id);
         const midPrice = round(f.float(0.1, 0.9), 3);
         const spread = round(f.float(0.005, 0.03), 3);

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-05-23T13:25:22.294Z
+ * Generated at: 2026-05-23T22:05:08.018Z
  * 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-05-23T13:25:22.294Z
+ * Generated at: 2026-05-23T22:05:08.018Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.myriadApiSpec = {

package/dist/exchanges/myriad/index.js

@@ -91,6 +91,9 @@ class MyriadExchange extends BaseExchange_1.PredictionMarketExchange {
         return this.normalizer.normalizeOHLCV(rawMarket, params, parsedOutcomeId);
     }
     async fetchOrderBook(outcomeId, _limit, _params) {
+        const resolved = await this.resolveOutcomeAlias(outcomeId, _params);
+        outcomeId = resolved.outcomeId;
+        _params = resolved.params;
         const parts = outcomeId.split(':');
         if (parts.length >= 3) {
             const [networkId, marketId, oid] = parts;

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-05-23T13:25:22.299Z
+ * Generated at: 2026-05-23T22:05:08.023Z
  * 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-05-23T13:25:22.299Z
+ * Generated at: 2026-05-23T22:05:08.023Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.opinionApiSpec = {

package/dist/exchanges/opinion/index.js

@@ -170,6 +170,9 @@ class OpinionExchange extends BaseExchange_1.PredictionMarketExchange {
         return this.normalizer.normalizeOHLCV({ history: rawPoints }, params);
     }
     async fetchOrderBook(outcomeId, _limit, _params) {
+        const resolved = await this.resolveOutcomeAlias(outcomeId, _params);
+        outcomeId = resolved.outcomeId;
+        _params = resolved.params;
         const raw = await this.fetcher.fetchRawOrderBook(outcomeId);
         return this.normalizer.normalizeOrderBook(raw, outcomeId);
     }

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-05-23T13:25:22.247Z
+ * Generated at: 2026-05-23T22:05:07.964Z
  * 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-05-23T13:25:22.247Z
+ * Generated at: 2026-05-23T22:05:07.964Z
  * 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-05-23T13:25:22.264Z
+ * Generated at: 2026-05-23T22:05:07.982Z
  * 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-05-23T13:25:22.264Z
+ * Generated at: 2026-05-23T22:05:07.982Z
  * 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-05-23T13:25:22.262Z
+ * Generated at: 2026-05-23T22:05:07.978Z
  * 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-05-23T13:25:22.262Z
+ * Generated at: 2026-05-23T22:05:07.978Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.polymarketGammaSpec = {

package/dist/exchanges/polymarket/index.js

@@ -112,6 +112,9 @@ class PolymarketExchange extends BaseExchange_1.PredictionMarketExchange {
         return this.normalizer.normalizeOHLCV(raw, params);
     }
     async fetchOrderBook(outcomeId, _limit, _params) {
+        const resolved = await this.resolveOutcomeAlias(outcomeId, _params);
+        outcomeId = resolved.outcomeId;
+        _params = resolved.params;
         (0, validation_1.validateIdFormat)(outcomeId, 'OrderBook');
         (0, validation_1.validateOutcomeId)(outcomeId, 'OrderBook');
         const raw = await this.fetcher.fetchRawOrderBook(outcomeId);

package/dist/exchanges/polymarket_us/index.js

@@ -167,6 +167,9 @@ class PolymarketUSExchange extends BaseExchange_1.PredictionMarketExchange {
         });
     }
     async fetchOrderBook(outcomeId, _limit, _params) {
+        const resolved = await this.resolveOutcomeAlias(outcomeId, _params);
+        outcomeId = resolved.outcomeId;
+        _params = resolved.params;
         return this.run(async () => {
             const slug = this.slugFromId(outcomeId);
             const book = await this.client.markets.book(slug);

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-05-23T13:25:22.286Z
+ * Generated at: 2026-05-23T22:05:08.013Z
  * 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-05-23T13:25:22.286Z
+ * Generated at: 2026-05-23T22:05:08.013Z
  * Do not edit manually -- run "npm run fetch:openapi" to regenerate.
  */
 exports.probableApiSpec = {

package/dist/exchanges/probable/index.js

@@ -119,6 +119,9 @@ class ProbableExchange extends BaseExchange_1.PredictionMarketExchange {
         return event;
     }
     async fetchOrderBook(outcomeId, _limit, _params) {
+        const resolved = await this.resolveOutcomeAlias(outcomeId, _params);
+        outcomeId = resolved.outcomeId;
+        _params = resolved.params;
         const raw = await this.fetcher.fetchRawOrderBook(outcomeId);
         return this.normalizer.normalizeOrderBook(raw, outcomeId);
     }

package/dist/exchanges/smarkets/index.js

@@ -161,6 +161,9 @@ class SmarketsExchange extends BaseExchange_1.PredictionMarketExchange {
             .slice(0, limit);
     }
     async fetchOrderBook(outcomeId, _limit, _params) {
+        const resolved = await this.resolveOutcomeAlias(outcomeId, _params);
+        outcomeId = resolved.outcomeId;
+        _params = resolved.params;
         const raw = await this.fetcher.fetchRawOrderBook(outcomeId);
         return this.normalizer.normalizeOrderBook(raw, outcomeId);
     }

package/dist/server/openapi.yaml

@@ -656,6 +656,15 @@ paths:
           description: >-
             Outcome side: 'yes' or 'no'. Required for exchanges like Limitless where the API returns a single orderbook
             per market.
+        - in: query
+          name: outcome
+          required: false
+          schema:
+            type: string
+          description: >-
+            Outcome alias: 'yes' or 'no', or an outcome token ID. When set, the first argument is treated as a market ID
+            and this value selects which outcome's order book to fetch. Accepts the literal strings 'yes'/'no' (resolved
+            via a market lookup) or a raw outcome token ID.
         - in: query
           name: since
           required: false
@@ -3192,6 +3201,12 @@ components:
           description: >-
             Outcome side: 'yes' or 'no'. Required for exchanges like Limitless where the API returns a single orderbook
             per market.
+        outcome:
+          type: string
+          description: >-
+            Outcome alias: 'yes' or 'no', or an outcome token ID. When set, the first argument is treated as a market ID
+            and this value selects which outcome's order book to fetch. Accepts the literal strings 'yes'/'no' (resolved
+            via a market lookup) or a raw outcome token ID.
         since:
           type: number
           description: >-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxt-core",
-  "version": "2.43.12",
+  "version": "2.43.13",
   "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.43.12,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.43.12,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.43.13,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.43.13,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",