polytrader 0.1.1

Python trading client for Polymarket

polytrader

A Python trading client for Polymarket — the world's largest prediction market.

Features

• Order management — create limit (GTC/GTD) and market (FOK/FAK) orders, cancel single or all orders
• Real-time WebSocket — market data (order book, price changes, trades, best bid/ask) and user events (order updates, trade confirmations)
• Typed models — all API and WebSocket data parsed into Python dataclasses with proper types (Decimal prices, enum statuses)
• Position & balance tracking — query positions, USDC balance, and conditional token balances
• On-chain operations — approve tokens and collateral for trading, with optional builder/relayer support

Installation

pip install polytrader

Quick Start

from decimal import Decimal
from polytrader import PolyTrader, OrderSide, Coin, Timeframe

trader = PolyTrader(
    private_key="0x...",
    funder="0x...",
    signature_type=0,
)

# Get current Up/Down market
market = await trader.get_current_updown_market(Coin.BTC, Timeframe.M5)

# Place a limit order
result = trader.create_order(
    token_id=market.up_token_id,
    side=OrderSide.BUY,
    price=Decimal("0.50"),
    size=Decimal("10"),
)

# Get open orders
orders = trader.get_orders()

# Cancel all orders
trader.cancel_all_orders()

WebSocket

# Market data (public)
await trader.market_ws.connect()
await trader.market_ws.subscribe([market.up_token_id], callback)
await trader.market_ws.run()

# User events (authenticated)
await trader.user_ws.connect()
await trader.user_ws.subscribe([market.condition_id], callback)
await trader.user_ws.run()

Requirements

• Python >= 3.11

License

MIT