pmxtjs 0.4.3 → 1.0.0-b2

package/dist/esm/generated/src/runtime.js

@@ -0,0 +1,349 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * PMXT Sidecar API
+ * A unified local sidecar API for prediction markets (Polymarket, Kalshi). This API acts as a JSON-RPC-style gateway. Each endpoint corresponds to a specific method on the generic exchange implementation.
+ *
+ * The version of the OpenAPI document: 0.4.4
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TextApiResponse = exports.BlobApiResponse = exports.VoidApiResponse = exports.JSONApiResponse = exports.COLLECTION_FORMATS = exports.RequiredError = exports.FetchError = exports.ResponseError = exports.BaseAPI = exports.DefaultConfig = exports.Configuration = exports.BASE_PATH = void 0;
+exports.querystring = querystring;
+exports.exists = exists;
+exports.mapValues = mapValues;
+exports.canConsumeForm = canConsumeForm;
+exports.BASE_PATH = "http://localhost:3847".replace(/\/+$/, "");
+class Configuration {
+    configuration;
+    constructor(configuration = {}) {
+        this.configuration = configuration;
+    }
+    set config(configuration) {
+        this.configuration = configuration;
+    }
+    get basePath() {
+        return this.configuration.basePath != null ? this.configuration.basePath : exports.BASE_PATH;
+    }
+    get fetchApi() {
+        return this.configuration.fetchApi;
+    }
+    get middleware() {
+        return this.configuration.middleware || [];
+    }
+    get queryParamsStringify() {
+        return this.configuration.queryParamsStringify || querystring;
+    }
+    get username() {
+        return this.configuration.username;
+    }
+    get password() {
+        return this.configuration.password;
+    }
+    get apiKey() {
+        const apiKey = this.configuration.apiKey;
+        if (apiKey) {
+            return typeof apiKey === 'function' ? apiKey : () => apiKey;
+        }
+        return undefined;
+    }
+    get accessToken() {
+        const accessToken = this.configuration.accessToken;
+        if (accessToken) {
+            return typeof accessToken === 'function' ? accessToken : async () => accessToken;
+        }
+        return undefined;
+    }
+    get headers() {
+        return this.configuration.headers;
+    }
+    get credentials() {
+        return this.configuration.credentials;
+    }
+}
+exports.Configuration = Configuration;
+exports.DefaultConfig = new Configuration();
+/**
+ * This is the base class for all generated API classes.
+ */
+class BaseAPI {
+    configuration;
+    static jsonRegex = new RegExp('^(:?application\/json|[^;/ \t]+\/[^;/ \t]+[+]json)[ \t]*(:?;.*)?$', 'i');
+    middleware;
+    constructor(configuration = exports.DefaultConfig) {
+        this.configuration = configuration;
+        this.middleware = configuration.middleware;
+    }
+    withMiddleware(...middlewares) {
+        const next = this.clone();
+        next.middleware = next.middleware.concat(...middlewares);
+        return next;
+    }
+    withPreMiddleware(...preMiddlewares) {
+        const middlewares = preMiddlewares.map((pre) => ({ pre }));
+        return this.withMiddleware(...middlewares);
+    }
+    withPostMiddleware(...postMiddlewares) {
+        const middlewares = postMiddlewares.map((post) => ({ post }));
+        return this.withMiddleware(...middlewares);
+    }
+    /**
+     * Check if the given MIME is a JSON MIME.
+     * JSON MIME examples:
+     *   application/json
+     *   application/json; charset=UTF8
+     *   APPLICATION/JSON
+     *   application/vnd.company+json
+     * @param mime - MIME (Multipurpose Internet Mail Extensions)
+     * @return True if the given MIME is JSON, false otherwise.
+     */
+    isJsonMime(mime) {
+        if (!mime) {
+            return false;
+        }
+        return BaseAPI.jsonRegex.test(mime);
+    }
+    async request(context, initOverrides) {
+        const { url, init } = await this.createFetchParams(context, initOverrides);
+        const response = await this.fetchApi(url, init);
+        if (response && (response.status >= 200 && response.status < 300)) {
+            return response;
+        }
+        throw new ResponseError(response, 'Response returned an error code');
+    }
+    async createFetchParams(context, initOverrides) {
+        let url = this.configuration.basePath + context.path;
+        if (context.query !== undefined && Object.keys(context.query).length !== 0) {
+            // only add the querystring to the URL if there are query parameters.
+            // this is done to avoid urls ending with a "?" character which buggy webservers
+            // do not handle correctly sometimes.
+            url += '?' + this.configuration.queryParamsStringify(context.query);
+        }
+        const headers = Object.assign({}, this.configuration.headers, context.headers);
+        Object.keys(headers).forEach(key => headers[key] === undefined ? delete headers[key] : {});
+        const initOverrideFn = typeof initOverrides === "function"
+            ? initOverrides
+            : async () => initOverrides;
+        const initParams = {
+            method: context.method,
+            headers,
+            body: context.body,
+            credentials: this.configuration.credentials,
+        };
+        const overriddenInit = {
+            ...initParams,
+            ...(await initOverrideFn({
+                init: initParams,
+                context,
+            }))
+        };
+        let body;
+        if (isFormData(overriddenInit.body)
+            || (overriddenInit.body instanceof URLSearchParams)
+            || isBlob(overriddenInit.body)) {
+            body = overriddenInit.body;
+        }
+        else if (this.isJsonMime(headers['Content-Type'])) {
+            body = JSON.stringify(overriddenInit.body);
+        }
+        else {
+            body = overriddenInit.body;
+        }
+        const init = {
+            ...overriddenInit,
+            body
+        };
+        return { url, init };
+    }
+    fetchApi = async (url, init) => {
+        let fetchParams = { url, init };
+        for (const middleware of this.middleware) {
+            if (middleware.pre) {
+                fetchParams = await middleware.pre({
+                    fetch: this.fetchApi,
+                    ...fetchParams,
+                }) || fetchParams;
+            }
+        }
+        let response = undefined;
+        try {
+            response = await (this.configuration.fetchApi || fetch)(fetchParams.url, fetchParams.init);
+        }
+        catch (e) {
+            for (const middleware of this.middleware) {
+                if (middleware.onError) {
+                    response = await middleware.onError({
+                        fetch: this.fetchApi,
+                        url: fetchParams.url,
+                        init: fetchParams.init,
+                        error: e,
+                        response: response ? response.clone() : undefined,
+                    }) || response;
+                }
+            }
+            if (response === undefined) {
+                if (e instanceof Error) {
+                    throw new FetchError(e, 'The request failed and the interceptors did not return an alternative response');
+                }
+                else {
+                    throw e;
+                }
+            }
+        }
+        for (const middleware of this.middleware) {
+            if (middleware.post) {
+                response = await middleware.post({
+                    fetch: this.fetchApi,
+                    url: fetchParams.url,
+                    init: fetchParams.init,
+                    response: response.clone(),
+                }) || response;
+            }
+        }
+        return response;
+    };
+    /**
+     * Create a shallow clone of `this` by constructing a new instance
+     * and then shallow cloning data members.
+     */
+    clone() {
+        const constructor = this.constructor;
+        const next = new constructor(this.configuration);
+        next.middleware = this.middleware.slice();
+        return next;
+    }
+}
+exports.BaseAPI = BaseAPI;
+;
+function isBlob(value) {
+    return typeof Blob !== 'undefined' && value instanceof Blob;
+}
+function isFormData(value) {
+    return typeof FormData !== "undefined" && value instanceof FormData;
+}
+class ResponseError extends Error {
+    response;
+    name = "ResponseError";
+    constructor(response, msg) {
+        super(msg);
+        this.response = response;
+    }
+}
+exports.ResponseError = ResponseError;
+class FetchError extends Error {
+    cause;
+    name = "FetchError";
+    constructor(cause, msg) {
+        super(msg);
+        this.cause = cause;
+    }
+}
+exports.FetchError = FetchError;
+class RequiredError extends Error {
+    field;
+    name = "RequiredError";
+    constructor(field, msg) {
+        super(msg);
+        this.field = field;
+    }
+}
+exports.RequiredError = RequiredError;
+exports.COLLECTION_FORMATS = {
+    csv: ",",
+    ssv: " ",
+    tsv: "\t",
+    pipes: "|",
+};
+function querystring(params, prefix = '') {
+    return Object.keys(params)
+        .map(key => querystringSingleKey(key, params[key], prefix))
+        .filter(part => part.length > 0)
+        .join('&');
+}
+function querystringSingleKey(key, value, keyPrefix = '') {
+    const fullKey = keyPrefix + (keyPrefix.length ? `[${key}]` : key);
+    if (value instanceof Array) {
+        const multiValue = value.map(singleValue => encodeURIComponent(String(singleValue)))
+            .join(`&${encodeURIComponent(fullKey)}=`);
+        return `${encodeURIComponent(fullKey)}=${multiValue}`;
+    }
+    if (value instanceof Set) {
+        const valueAsArray = Array.from(value);
+        return querystringSingleKey(key, valueAsArray, keyPrefix);
+    }
+    if (value instanceof Date) {
+        return `${encodeURIComponent(fullKey)}=${encodeURIComponent(value.toISOString())}`;
+    }
+    if (value instanceof Object) {
+        return querystring(value, fullKey);
+    }
+    return `${encodeURIComponent(fullKey)}=${encodeURIComponent(String(value))}`;
+}
+function exists(json, key) {
+    const value = json[key];
+    return value !== null && value !== undefined;
+}
+function mapValues(data, fn) {
+    const result = {};
+    for (const key of Object.keys(data)) {
+        result[key] = fn(data[key]);
+    }
+    return result;
+}
+function canConsumeForm(consumes) {
+    for (const consume of consumes) {
+        if ('multipart/form-data' === consume.contentType) {
+            return true;
+        }
+    }
+    return false;
+}
+class JSONApiResponse {
+    raw;
+    transformer;
+    constructor(raw, transformer = (jsonValue) => jsonValue) {
+        this.raw = raw;
+        this.transformer = transformer;
+    }
+    async value() {
+        return this.transformer(await this.raw.json());
+    }
+}
+exports.JSONApiResponse = JSONApiResponse;
+class VoidApiResponse {
+    raw;
+    constructor(raw) {
+        this.raw = raw;
+    }
+    async value() {
+        return undefined;
+    }
+}
+exports.VoidApiResponse = VoidApiResponse;
+class BlobApiResponse {
+    raw;
+    constructor(raw) {
+        this.raw = raw;
+    }
+    async value() {
+        return await this.raw.blob();
+    }
+    ;
+}
+exports.BlobApiResponse = BlobApiResponse;
+class TextApiResponse {
+    raw;
+    constructor(raw) {
+        this.raw = raw;
+    }
+    async value() {
+        return await this.raw.text();
+    }
+    ;
+}
+exports.TextApiResponse = TextApiResponse;

package/dist/esm/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * PMXT - Unified Prediction Market API (TypeScript SDK)
+ *
+ * A unified interface for interacting with multiple prediction market exchanges
+ * (Kalshi, Polymarket) identically.
+ *
+ * @example
+ * ```typescript
+ * import { Polymarket, Kalshi } from "pmxtjs";
+ *
+ * // Initialize exchanges
+ * const poly = new Polymarket();
+ * const kalshi = new Kalshi();
+ *
+ * // Search for markets
+ * const markets = await poly.searchMarkets("Trump");
+ * console.log(markets[0].title);
+ * ```
+ */
+import { Exchange, Polymarket, Kalshi } from "./pmxt/client.js";
+import { ServerManager } from "./pmxt/server-manager.js";
+export { Exchange, Polymarket, Kalshi } from "./pmxt/client.js";
+export { ServerManager } from "./pmxt/server-manager.js";
+export type * from "./pmxt/models.js";
+export declare const VERSION = "0.0.1";
+declare const pmxt: {
+    Exchange: typeof Exchange;
+    Polymarket: typeof Polymarket;
+    Kalshi: typeof Kalshi;
+    ServerManager: typeof ServerManager;
+};
+export default pmxt;

package/dist/esm/index.js

@@ -0,0 +1,33 @@
+/**
+ * PMXT - Unified Prediction Market API (TypeScript SDK)
+ *
+ * A unified interface for interacting with multiple prediction market exchanges
+ * (Kalshi, Polymarket) identically.
+ *
+ * @example
+ * ```typescript
+ * import { Polymarket, Kalshi } from "pmxtjs";
+ *
+ * // Initialize exchanges
+ * const poly = new Polymarket();
+ * const kalshi = new Kalshi();
+ *
+ * // Search for markets
+ * const markets = await poly.searchMarkets("Trump");
+ * console.log(markets[0].title);
+ * ```
+ */
+import { Exchange, Polymarket, Kalshi } from "./pmxt/client.js";
+import { ServerManager } from "./pmxt/server-manager.js";
+import * as models from "./pmxt/models.js";
+export { Exchange, Polymarket, Kalshi } from "./pmxt/client.js";
+export { ServerManager } from "./pmxt/server-manager.js";
+export const VERSION = "0.0.1";
+const pmxt = {
+    Exchange,
+    Polymarket,
+    Kalshi,
+    ServerManager,
+    ...models
+};
+export default pmxt;

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

@@ -0,0 +1,213 @@
+/**
+ * Exchange client implementations.
+ *
+ * This module provides clean, TypeScript-friendly wrappers around the auto-generated
+ * OpenAPI client, matching the Python API exactly.
+ */
+import { DefaultApi } from "../generated/src/index.js";
+import { UnifiedMarket, PriceCandle, OrderBook, Trade, Order, Position, Balance, MarketFilterParams, HistoryFilterParams, CreateOrderParams } from "./models.js";
+import { ServerManager } from "./server-manager.js";
+/**
+ * Base exchange client options.
+ */
+export interface ExchangeOptions {
+    /** API key for authentication (optional) */
+    apiKey?: string;
+    /** Private key for authentication (optional) */
+    privateKey?: string;
+    /** Base URL of the PMXT sidecar server */
+    baseUrl?: string;
+    /** Automatically start server if not running (default: true) */
+    autoStartServer?: boolean;
+}
+/**
+ * Base class for prediction market exchanges.
+ *
+ * This provides a unified interface for interacting with different
+ * prediction market platforms (Polymarket, Kalshi, etc.).
+ */
+export declare abstract class Exchange {
+    protected exchangeName: string;
+    protected apiKey?: string;
+    protected privateKey?: string;
+    protected api: DefaultApi;
+    protected serverManager: ServerManager;
+    constructor(exchangeName: string, options?: ExchangeOptions);
+    protected handleResponse(response: any): any;
+    /**
+     * Get active markets from the exchange.
+     *
+     * @param params - Optional filter parameters
+     * @returns List of unified markets
+     *
+     * @example
+     * ```typescript
+     * const markets = await exchange.fetchMarkets({ limit: 20, sort: "volume" });
+     * ```
+     */
+    fetchMarkets(params?: MarketFilterParams): Promise<UnifiedMarket[]>;
+    /**
+     * Search markets by keyword.
+     *
+     * @param query - Search query
+     * @param params - Optional filter parameters
+     * @returns List of matching markets
+     *
+     * @example
+     * ```typescript
+     * const markets = await exchange.searchMarkets("Trump", { limit: 10 });
+     * ```
+     */
+    searchMarkets(query: string, params?: MarketFilterParams): Promise<UnifiedMarket[]>;
+    /**
+     * Fetch markets by URL slug/ticker.
+     *
+     * @param slug - Market slug (Polymarket) or ticker (Kalshi)
+     * @returns List of matching markets
+     *
+     * @example
+     * ```typescript
+     * // Polymarket
+     * const markets = await poly.getMarketsBySlug("who-will-trump-nominate-as-fed-chair");
+     *
+     * // Kalshi
+     * const markets = await kalshi.getMarketsBySlug("KXFEDCHAIRNOM-29");
+     * ```
+     */
+    getMarketsBySlug(slug: string): Promise<UnifiedMarket[]>;
+    /**
+     * Get historical price candles.
+     *
+     * **CRITICAL**: Use outcome.id, not market.id.
+     * - Polymarket: outcome.id is the CLOB Token ID
+     * - Kalshi: outcome.id is the Market Ticker
+     *
+     * @param outcomeId - Outcome ID (from market.outcomes[].id)
+     * @param params - History filter parameters
+     * @returns List of price candles
+     *
+     * @example
+     * ```typescript
+     * const markets = await exchange.searchMarkets("Trump");
+     * const outcomeId = markets[0].outcomes[0].id;
+     * const candles = await exchange.fetchOHLCV(outcomeId, {
+     *   resolution: "1h",
+     *   limit: 100
+     * });
+     * ```
+     */
+    fetchOHLCV(outcomeId: string, params: HistoryFilterParams): Promise<PriceCandle[]>;
+    /**
+     * Get current order book for an outcome.
+     *
+     * @param outcomeId - Outcome ID
+     * @returns Current order book
+     *
+     * @example
+     * ```typescript
+     * const orderBook = await exchange.fetchOrderBook(outcomeId);
+     * console.log(`Best bid: ${orderBook.bids[0].price}`);
+     * console.log(`Best ask: ${orderBook.asks[0].price}`);
+     * ```
+     */
+    fetchOrderBook(outcomeId: string): Promise<OrderBook>;
+    /**
+     * Get trade history for an outcome.
+     *
+     * Note: Polymarket requires API key.
+     *
+     * @param outcomeId - Outcome ID
+     * @param params - History filter parameters
+     * @returns List of trades
+     */
+    fetchTrades(outcomeId: string, params: HistoryFilterParams): Promise<Trade[]>;
+    /**
+     * Create a new order.
+     *
+     * @param params - Order parameters
+     * @returns Created order
+     *
+     * @example
+     * ```typescript
+     * const order = await exchange.createOrder({
+     *   marketId: "663583",
+     *   outcomeId: "10991849...",
+     *   side: "buy",
+     *   type: "limit",
+     *   amount: 10,
+     *   price: 0.55
+     * });
+     * ```
+     */
+    createOrder(params: CreateOrderParams): Promise<Order>;
+    /**
+     * Cancel an open order.
+     *
+     * @param orderId - Order ID to cancel
+     * @returns Cancelled order
+     */
+    cancelOrder(orderId: string): Promise<Order>;
+    /**
+     * Get details of a specific order.
+     *
+     * @param orderId - Order ID
+     * @returns Order details
+     */
+    fetchOrder(orderId: string): Promise<Order>;
+    /**
+     * Get all open orders, optionally filtered by market.
+     *
+     * @param marketId - Optional market ID to filter by
+     * @returns List of open orders
+     */
+    fetchOpenOrders(marketId?: string): Promise<Order[]>;
+    /**
+     * Get current positions across all markets.
+     *
+     * @returns List of positions
+     */
+    fetchPositions(): Promise<Position[]>;
+    /**
+     * Get account balance.
+     *
+     * @returns List of balances (by currency)
+     */
+    fetchBalance(): Promise<Balance[]>;
+}
+/**
+ * Polymarket exchange client.
+ *
+ * @example
+ * ```typescript
+ * // Public data (no auth)
+ * const poly = new Polymarket();
+ * const markets = await poly.searchMarkets("Trump");
+ *
+ * // Trading (requires auth)
+ * const poly = new Polymarket({ privateKey: process.env.POLYMARKET_PRIVATE_KEY });
+ * const balance = await poly.fetchBalance();
+ * ```
+ */
+export declare class Polymarket extends Exchange {
+    constructor(options?: Omit<ExchangeOptions, "apiKey">);
+}
+/**
+ * Kalshi exchange client.
+ *
+ * @example
+ * ```typescript
+ * // Public data (no auth)
+ * const kalshi = new Kalshi();
+ * const markets = await kalshi.searchMarkets("Fed rates");
+ *
+ * // Trading (requires auth)
+ * const kalshi = new Kalshi({
+ *   apiKey: process.env.KALSHI_API_KEY,
+ *   privateKey: process.env.KALSHI_PRIVATE_KEY
+ * });
+ * const balance = await kalshi.fetchBalance();
+ * ```
+ */
+export declare class Kalshi extends Exchange {
+    constructor(options?: ExchangeOptions);
+}