pmxtjs 2.1.3 → 2.3.0

package/README.md

@@ -107,9 +107,9 @@ const limitless = new pmxt.Limitless({
 
 - `createOrder(params)` - Place a new order
   ```typescript
+  // Using outcome shorthand (recommended)
   await poly.createOrder({
-      marketId: market.marketId,
-      outcomeId: outcome.outcomeId,
+      outcome: market.yes,
       side: 'buy',
       type: 'limit',
       amount: 10,

package/dist/esm/generated/src/models/MarketOutcome.d.ts

@@ -21,6 +21,12 @@ export interface MarketOutcome {
      * @memberof MarketOutcome
      */
     outcomeId?: string;
+    /**
+     * The market this outcome belongs to (set automatically)
+     * @type {string}
+     * @memberof MarketOutcome
+     */
+    marketId?: string;
     /**
      *
      * @type {string}

package/dist/esm/generated/src/models/MarketOutcome.js

@@ -26,6 +26,7 @@ export function MarketOutcomeFromJSONTyped(json, ignoreDiscriminator) {
     }
     return {
         'outcomeId': json['outcomeId'] == null ? undefined : json['outcomeId'],
+        'marketId': json['marketId'] == null ? undefined : json['marketId'],
         'label': json['label'] == null ? undefined : json['label'],
         'price': json['price'] == null ? undefined : json['price'],
         'priceChange24h': json['priceChange24h'] == null ? undefined : json['priceChange24h'],
@@ -41,6 +42,7 @@ export function MarketOutcomeToJSONTyped(value, ignoreDiscriminator = false) {
     }
     return {
         'outcomeId': value['outcomeId'],
+        'marketId': value['marketId'],
         'label': value['label'],
         'price': value['price'],
         'priceChange24h': value['priceChange24h'],

package/dist/esm/index.d.ts

@@ -19,12 +19,15 @@
  */
 import { Exchange, Polymarket, Kalshi, Limitless } from "./pmxt/client.js";
 import { ServerManager } from "./pmxt/server-manager.js";
+import * as models from "./pmxt/models.js";
 export { Exchange, Polymarket, Kalshi, Limitless, PolymarketOptions } from "./pmxt/client.js";
 export { ServerManager } from "./pmxt/server-manager.js";
+export { MarketList } from "./pmxt/models.js";
 export type * from "./pmxt/models.js";
 declare function stopServer(): Promise<void>;
 declare function restartServer(): Promise<void>;
 declare const pmxt: {
+    MarketList: typeof models.MarketList;
     Exchange: typeof Exchange;
     Polymarket: typeof Polymarket;
     Kalshi: typeof Kalshi;

package/dist/esm/index.js

@@ -22,6 +22,7 @@ import { ServerManager } from "./pmxt/server-manager.js";
 import * as models from "./pmxt/models.js";
 export { Exchange, Polymarket, Kalshi, Limitless } from "./pmxt/client.js";
 export { ServerManager } from "./pmxt/server-manager.js";
+export { MarketList } from "./pmxt/models.js";
 const defaultManager = new ServerManager();
 async function stopServer() {
     await defaultManager.stop();

package/dist/esm/pmxt/client.js

@@ -5,11 +5,13 @@
  * OpenAPI client, matching the Python API exactly.
  */
 import { DefaultApi, Configuration, } from "../generated/src/index.js";
+import { MarketList, } from "./models.js";
 import { ServerManager } from "./server-manager.js";
 // Converter functions
 function convertMarket(raw) {
     const outcomes = (raw.outcomes || []).map((o) => ({
         outcomeId: o.outcomeId,
+        marketId: o.marketId,
         label: o.label,
         price: o.price,
         priceChange24h: o.priceChange24h,
@@ -17,6 +19,7 @@ function convertMarket(raw) {
     }));
     const convertOutcome = (o) => o ? ({
         outcomeId: o.outcomeId,
+        marketId: o.marketId,
         label: o.label,
         price: o.price,
         priceChange24h: o.priceChange24h,
@@ -113,7 +116,7 @@ function convertBalance(raw) {
     };
 }
 function convertEvent(raw) {
-    const markets = (raw.markets || []).map(convertMarket);
+    const markets = MarketList.from((raw.markets || []).map(convertMarket));
     return {
         id: raw.id,
         title: raw.title,
@@ -456,9 +459,23 @@ export class Exchange {
     async createOrder(params) {
         await this.initPromise;
         try {
+            // Resolve outcome shorthand: extract marketId/outcomeId from outcome object
+            let marketId = params.marketId;
+            let outcomeId = params.outcomeId;
+            if (params.outcome) {
+                if (marketId !== undefined || outcomeId !== undefined) {
+                    throw new Error("Cannot specify both 'outcome' and 'marketId'/'outcomeId'. Use one or the other.");
+                }
+                const outcome = params.outcome;
+                if (!outcome.marketId) {
+                    throw new Error("outcome.marketId is not set. Ensure the outcome comes from a fetched market.");
+                }
+                marketId = outcome.marketId;
+                outcomeId = outcome.outcomeId;
+            }
             const paramsDict = {
-                marketId: params.marketId,
-                outcomeId: params.outcomeId,
+                marketId,
+                outcomeId,
                 side: params.side,
                 type: params.type,
                 amount: params.amount,

package/dist/esm/pmxt/models.d.ts

@@ -13,6 +13,8 @@ export interface MarketOutcome {
      * - Kalshi: Market Ticker
      */
     outcomeId: string;
+    /** The market this outcome belongs to (set automatically). */
+    marketId?: string;
     /** Human-readable label (e.g., "Trump", "Yes") */
     label: string;
     /** Current price (0.0 to 1.0, representing probability) */
@@ -237,6 +239,21 @@ export interface CreateOrderParams {
     /** Optional fee rate (e.g., 1000 for 0.1%) */
     fee?: number;
 }
+/**
+ * A list of UnifiedMarket objects with a convenience match() method.
+ * Extends Array so all standard array operations work unchanged.
+ */
+export declare class MarketList extends Array<UnifiedMarket> {
+    /**
+     * Find a single market by case-insensitive substring match.
+     *
+     * @param query - Substring to search for
+     * @param searchIn - Fields to search in (default: ['title'])
+     * @returns The matching UnifiedMarket
+     * @throws Error if zero or multiple markets match
+     */
+    match(query: string, searchIn?: ('title' | 'description' | 'category' | 'tags' | 'outcomes')[]): UnifiedMarket;
+}
 /**
  * A grouped collection of related markets (e.g., "Who will be Fed Chair?" contains multiple candidate markets)
  */
@@ -250,7 +267,7 @@ export interface UnifiedEvent {
     /** Event slug */
     slug: string;
     /** Related markets in this event */
-    markets: UnifiedMarket[];
+    markets: MarketList;
     /** Event URL */
     url: string;
     /** Event image URL */

package/dist/esm/pmxt/models.js

@@ -3,4 +3,59 @@
  *
  * These are clean TypeScript interfaces that provide a user-friendly API.
  */
-export {};
+/**
+ * A list of UnifiedMarket objects with a convenience match() method.
+ * Extends Array so all standard array operations work unchanged.
+ */
+export class MarketList extends Array {
+    /**
+     * Find a single market by case-insensitive substring match.
+     *
+     * @param query - Substring to search for
+     * @param searchIn - Fields to search in (default: ['title'])
+     * @returns The matching UnifiedMarket
+     * @throws Error if zero or multiple markets match
+     */
+    match(query, searchIn) {
+        const fields = searchIn || ['title'];
+        const lowerQuery = query.toLowerCase();
+        const matches = [];
+        for (const m of this) {
+            for (const field of fields) {
+                if (field === 'title' && m.title?.toLowerCase().includes(lowerQuery)) {
+                    matches.push(m);
+                    break;
+                }
+                if (field === 'description' && m.description?.toLowerCase().includes(lowerQuery)) {
+                    matches.push(m);
+                    break;
+                }
+                if (field === 'category' && m.category?.toLowerCase().includes(lowerQuery)) {
+                    matches.push(m);
+                    break;
+                }
+                if (field === 'tags' && m.tags?.some(t => t.toLowerCase().includes(lowerQuery))) {
+                    matches.push(m);
+                    break;
+                }
+                if (field === 'outcomes' && m.outcomes?.some(o => o.label.toLowerCase().includes(lowerQuery))) {
+                    matches.push(m);
+                    break;
+                }
+            }
+        }
+        if (matches.length === 0) {
+            throw new Error(`No markets matching '${query}'`);
+        }
+        if (matches.length > 1) {
+            const titlesStr = matches
+                .map((m, i) => {
+                const truncated = m.title.length > 70 ? m.title.substring(0, 70) + '...' : m.title;
+                return `${i + 1}. ${truncated}`;
+            })
+                .join('\n  ');
+            throw new Error(`Multiple markets matching '${query}' (${matches.length} matches):\n  ${titlesStr}\n\nPlease refine your search.`);
+        }
+        return matches[0];
+    }
+}

package/dist/generated/src/models/MarketOutcome.d.ts

@@ -21,6 +21,12 @@ export interface MarketOutcome {
      * @memberof MarketOutcome
      */
     outcomeId?: string;
+    /**
+     * The market this outcome belongs to (set automatically)
+     * @type {string}
+     * @memberof MarketOutcome
+     */
+    marketId?: string;
     /**
      *
      * @type {string}

package/dist/generated/src/models/MarketOutcome.js

@@ -33,6 +33,7 @@ function MarketOutcomeFromJSONTyped(json, ignoreDiscriminator) {
     }
     return {
         'outcomeId': json['outcomeId'] == null ? undefined : json['outcomeId'],
+        'marketId': json['marketId'] == null ? undefined : json['marketId'],
         'label': json['label'] == null ? undefined : json['label'],
         'price': json['price'] == null ? undefined : json['price'],
         'priceChange24h': json['priceChange24h'] == null ? undefined : json['priceChange24h'],
@@ -48,6 +49,7 @@ function MarketOutcomeToJSONTyped(value, ignoreDiscriminator = false) {
     }
     return {
         'outcomeId': value['outcomeId'],
+        'marketId': value['marketId'],
         'label': value['label'],
         'price': value['price'],
         'priceChange24h': value['priceChange24h'],

package/dist/index.d.ts

@@ -19,12 +19,15 @@
  */
 import { Exchange, Polymarket, Kalshi, Limitless } from "./pmxt/client.js";
 import { ServerManager } from "./pmxt/server-manager.js";
+import * as models from "./pmxt/models.js";
 export { Exchange, Polymarket, Kalshi, Limitless, PolymarketOptions } from "./pmxt/client.js";
 export { ServerManager } from "./pmxt/server-manager.js";
+export { MarketList } from "./pmxt/models.js";
 export type * from "./pmxt/models.js";
 declare function stopServer(): Promise<void>;
 declare function restartServer(): Promise<void>;
 declare const pmxt: {
+    MarketList: typeof models.MarketList;
     Exchange: typeof Exchange;
     Polymarket: typeof Polymarket;
     Kalshi: typeof Kalshi;

package/dist/index.js

@@ -52,7 +52,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ServerManager = exports.Limitless = exports.Kalshi = exports.Polymarket = exports.Exchange = void 0;
+exports.MarketList = exports.ServerManager = exports.Limitless = exports.Kalshi = exports.Polymarket = exports.Exchange = void 0;
 const client_js_1 = require("./pmxt/client.js");
 const server_manager_js_1 = require("./pmxt/server-manager.js");
 const models = __importStar(require("./pmxt/models.js"));
@@ -63,6 +63,8 @@ Object.defineProperty(exports, "Kalshi", { enumerable: true, get: function () {
 Object.defineProperty(exports, "Limitless", { enumerable: true, get: function () { return client_js_2.Limitless; } });
 var server_manager_js_2 = require("./pmxt/server-manager.js");
 Object.defineProperty(exports, "ServerManager", { enumerable: true, get: function () { return server_manager_js_2.ServerManager; } });
+var models_js_1 = require("./pmxt/models.js");
+Object.defineProperty(exports, "MarketList", { enumerable: true, get: function () { return models_js_1.MarketList; } });
 const defaultManager = new server_manager_js_1.ServerManager();
 async function stopServer() {
     await defaultManager.stop();

package/dist/pmxt/client.js

@@ -8,11 +8,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Limitless = exports.Kalshi = exports.Polymarket = exports.Exchange = void 0;
 const index_js_1 = require("../generated/src/index.js");
+const models_js_1 = require("./models.js");
 const server_manager_js_1 = require("./server-manager.js");
 // Converter functions
 function convertMarket(raw) {
     const outcomes = (raw.outcomes || []).map((o) => ({
         outcomeId: o.outcomeId,
+        marketId: o.marketId,
         label: o.label,
         price: o.price,
         priceChange24h: o.priceChange24h,
@@ -20,6 +22,7 @@ function convertMarket(raw) {
     }));
     const convertOutcome = (o) => o ? ({
         outcomeId: o.outcomeId,
+        marketId: o.marketId,
         label: o.label,
         price: o.price,
         priceChange24h: o.priceChange24h,
@@ -116,7 +119,7 @@ function convertBalance(raw) {
     };
 }
 function convertEvent(raw) {
-    const markets = (raw.markets || []).map(convertMarket);
+    const markets = models_js_1.MarketList.from((raw.markets || []).map(convertMarket));
     return {
         id: raw.id,
         title: raw.title,
@@ -459,9 +462,23 @@ class Exchange {
     async createOrder(params) {
         await this.initPromise;
         try {
+            // Resolve outcome shorthand: extract marketId/outcomeId from outcome object
+            let marketId = params.marketId;
+            let outcomeId = params.outcomeId;
+            if (params.outcome) {
+                if (marketId !== undefined || outcomeId !== undefined) {
+                    throw new Error("Cannot specify both 'outcome' and 'marketId'/'outcomeId'. Use one or the other.");
+                }
+                const outcome = params.outcome;
+                if (!outcome.marketId) {
+                    throw new Error("outcome.marketId is not set. Ensure the outcome comes from a fetched market.");
+                }
+                marketId = outcome.marketId;
+                outcomeId = outcome.outcomeId;
+            }
             const paramsDict = {
-                marketId: params.marketId,
-                outcomeId: params.outcomeId,
+                marketId,
+                outcomeId,
                 side: params.side,
                 type: params.type,
                 amount: params.amount,

package/dist/pmxt/models.d.ts

@@ -13,6 +13,8 @@ export interface MarketOutcome {
      * - Kalshi: Market Ticker
      */
     outcomeId: string;
+    /** The market this outcome belongs to (set automatically). */
+    marketId?: string;
     /** Human-readable label (e.g., "Trump", "Yes") */
     label: string;
     /** Current price (0.0 to 1.0, representing probability) */
@@ -237,6 +239,21 @@ export interface CreateOrderParams {
     /** Optional fee rate (e.g., 1000 for 0.1%) */
     fee?: number;
 }
+/**
+ * A list of UnifiedMarket objects with a convenience match() method.
+ * Extends Array so all standard array operations work unchanged.
+ */
+export declare class MarketList extends Array<UnifiedMarket> {
+    /**
+     * Find a single market by case-insensitive substring match.
+     *
+     * @param query - Substring to search for
+     * @param searchIn - Fields to search in (default: ['title'])
+     * @returns The matching UnifiedMarket
+     * @throws Error if zero or multiple markets match
+     */
+    match(query: string, searchIn?: ('title' | 'description' | 'category' | 'tags' | 'outcomes')[]): UnifiedMarket;
+}
 /**
  * A grouped collection of related markets (e.g., "Who will be Fed Chair?" contains multiple candidate markets)
  */
@@ -250,7 +267,7 @@ export interface UnifiedEvent {
     /** Event slug */
     slug: string;
     /** Related markets in this event */
-    markets: UnifiedMarket[];
+    markets: MarketList;
     /** Event URL */
     url: string;
     /** Event image URL */

package/dist/pmxt/models.js

@@ -5,3 +5,61 @@
  * These are clean TypeScript interfaces that provide a user-friendly API.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarketList = void 0;
+/**
+ * A list of UnifiedMarket objects with a convenience match() method.
+ * Extends Array so all standard array operations work unchanged.
+ */
+class MarketList extends Array {
+    /**
+     * Find a single market by case-insensitive substring match.
+     *
+     * @param query - Substring to search for
+     * @param searchIn - Fields to search in (default: ['title'])
+     * @returns The matching UnifiedMarket
+     * @throws Error if zero or multiple markets match
+     */
+    match(query, searchIn) {
+        const fields = searchIn || ['title'];
+        const lowerQuery = query.toLowerCase();
+        const matches = [];
+        for (const m of this) {
+            for (const field of fields) {
+                if (field === 'title' && m.title?.toLowerCase().includes(lowerQuery)) {
+                    matches.push(m);
+                    break;
+                }
+                if (field === 'description' && m.description?.toLowerCase().includes(lowerQuery)) {
+                    matches.push(m);
+                    break;
+                }
+                if (field === 'category' && m.category?.toLowerCase().includes(lowerQuery)) {
+                    matches.push(m);
+                    break;
+                }
+                if (field === 'tags' && m.tags?.some(t => t.toLowerCase().includes(lowerQuery))) {
+                    matches.push(m);
+                    break;
+                }
+                if (field === 'outcomes' && m.outcomes?.some(o => o.label.toLowerCase().includes(lowerQuery))) {
+                    matches.push(m);
+                    break;
+                }
+            }
+        }
+        if (matches.length === 0) {
+            throw new Error(`No markets matching '${query}'`);
+        }
+        if (matches.length > 1) {
+            const titlesStr = matches
+                .map((m, i) => {
+                const truncated = m.title.length > 70 ? m.title.substring(0, 70) + '...' : m.title;
+                return `${i + 1}. ${truncated}`;
+            })
+                .join('\n  ');
+            throw new Error(`Multiple markets matching '${query}' (${matches.length} matches):\n  ${titlesStr}\n\nPlease refine your search.`);
+        }
+        return matches[0];
+    }
+}
+exports.MarketList = MarketList;

package/generated/docs/MarketOutcome.md

@@ -7,6 +7,7 @@
 Name | Type
 ------------ | -------------
 `outcomeId` | string
+`marketId` | string
 `label` | string
 `price` | number
 `priceChange24h` | number
@@ -20,6 +21,7 @@ import type { MarketOutcome } from 'pmxtjs'
 // TODO: Update the object below with actual values
 const example = {
   "outcomeId": null,
+  "marketId": null,
   "label": null,
   "price": null,
   "priceChange24h": null,

package/generated/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pmxtjs",
-  "version": "2.1.3",
+  "version": "2.3.0",
   "description": "OpenAPI client for pmxtjs",
   "author": "OpenAPI-Generator",
   "repository": {