Skip to content

pmxt-dev/pmxt

Repository files navigation

pmxt Tweet

The ccxt for prediction markets. A unified API for accessing prediction market data across multiple exchanges.

plot

Polymarket      Kalshi      Manifold Markets      Metaculus      PredictIt

Discord

Why pmxt?

Different prediction market platforms have different APIs, data formats, and conventions. pmxt provides a single, consistent interface to work with all of them.

Supported Exchanges

Polymarket Polymarket      Kalshi Kalshi      Limitless Limitless

Feature Support & Compliance.

Installation

Ensure that Node.js is installed and the node command is available on your PATH.

Python

pip install pmxt

Node.js

npm install pmxtjs

Quickstart

Prediction markets are structured in a hierarchy to group related information.

  • Event: The broad topic (e.g., "Who will Trump nominate as Fed Chair?")
  • Market: A specific tradeable question (e.g., "Will Trump nominate Kevin Warsh as the next Fed Chair?")
  • Outcome: The actual share you buy (e.g., "Yes" or "No")

Python

import pmxt

api = pmxt.Exchange()

# 1. Search for the broad Event
events = api.fetch_events(query='Who will Trump nominate as Fed Chair?')
fed_event = events[0]

# 2. Filter for the specific Market within that event
warsh = api.filter_markets(fed_event.markets, 'Kevin Warsh')[0]

print(f"Price: {warsh.yes.price}")

TypeScript

import pmxt from 'pmxtjs';

const api = new pmxt.Exchange();

// 1. Search for the broad Event
const events = await api.fetchEvents({ query: 'Who will Trump nominate as Fed Chair?' });
const fedEvent = events[0];

// 2. Filter for the specific Market within that event
const warsh = api.filterMarkets(fedEvent.markets, 'Kevin Warsh')[0];

console.log(`Price: ${warsh.yes?.price}`);

Trading

pmxt supports unified trading across exchanges.

Setup

To trade, you must provide your private credentials during initialization.

Polymarket

exchange = pmxt.Polymarket(
    private_key=os.getenv('POLYMARKET_PRIVATE_KEY'),
    proxy_address=os.getenv('POLYMARKET_PROXY_ADDRESS'), # Optional: For proxy trading
    signature_type='gnosis-safe' # Default
)

Kalshi

exchange = pmxt.Kalshi(
    api_key=os.getenv('KALSHI_API_KEY'),
    private_key=os.getenv('KALSHI_PRIVATE_KEY') # RSA Private Key
)

Limitless

exchange = pmxt.Limitless(
    api_key=os.getenv('LIMITLESS_API_KEY'),
    private_key=os.getenv('LIMITLESS_PRIVATE_KEY') # For order signing (EIP-712)
)

Trading Example (Python)

import pmxt
import os

# Initialize with credentials (e.g., Polymarket)
exchange = pmxt.Exchange(...)

# 1. Check Balance
balance = exchange.fetch_balance()
print(f"Available balance: {balance[0].available}")

# 2. Place an Order
# Use market.market_id and outcome.outcome_id from your market data
order = exchange.create_order(
    market_id='market-123',      # From market.market_id
    outcome_id='outcome-456',    # From outcome.outcome_id
    side='buy',
    type='limit',
    price=0.33,
    amount=100
)
print(f"Order Status: {order.status}")

Documentation

See the API Reference for detailed documentation and more examples.

Examples

Check out the directory for more use cases:

TypeScript Python

Stargazers repo roster for @pmxt-dev/pmxt

Sponsor this project

Packages

No packages published

Contributors 5