Polymarket trading bot for prediction markets — browse CLOB markets, watch the order book in the terminal, run edge detection, liquidity provision and cross-market arbitrage strategies with paper trading and risk limits. Educational open-source toolkit — not financial advice. Unofficial community project, not affiliated with Polymarket.
Polymarket trading bot for prediction markets — CLOB order book, edge detection and arbitrage signals in your terminal.
Browse CLOB markets · watch the book · run probability-edge & liquidity strategies · track USDC.
Polymarket Prediction Bot is a Polymarket trading bot for prediction markets — a keyboard-driven terminal dashboard for Polymarket, the Polygon-based prediction market with a central-limit order book (CLOB) and USDC settlement. It bundles a markets browser, a live CLOB order-book view, a strategy engine and a position/fill tracker into one pane — a complete Polymarket CLOB API client (REST + WebSocket) in your terminal.
Polymarket shares resolve YES/NO to $1/$0 on real events: elections, crypto milestones, sports, macro prints. Pricing a share is pricing a probability — the bot runs edge detection and liquidity provision strategies against a fair-probability model, surfaces cross-market arbitrage signals (YES+NO spread, multi-outcome), and keeps position tracking and PnL history with risk limits and exposure controls. A paper trading mode with virtual USDC balance lets you iterate safely. Terminal UI built with Textual and Rich — an educational open-source toolkit, no financial advice.
⚠️ Paper-trade by default.--demosimulates fills against a bundled dataset. Live order placement requires your own Polymarket API credentials and is gated behind explicit configuration.
| Area | What you get |
|---|---|
| 🔍 Markets browser | Filter by volume, spread, time-to-resolve, category (GAMMA). |
| 📖 CLOB book | YES/NO bids/asks, spread, mid, book imbalance. |
| 🧠 Strategy engine | Probability-edge vs. a fair-probability model, book-imbalance, liquidity. |
| 💼 Positions | Open YES/NO size, avg cost, uPnL in USDC, resolution countdown. |
| 🧾 Fill log | CLOB fills, cancels, signals — local paper trail. |
| 🎛️ Dashboard | Top movers, widest spreads, soonest-to-resolve, signal queue. |
| ⌨️ Keyboard-first | Vim bindings, / filter, b book, s scan, o order. |
| 🌑 Theming | Multiple palettes. |
╔══════════════════════════════════════════════════════════════════════════════════════════╗
║ 🔮 Polymarket Bot [1]Dash [2]Markets [3]Book [4]Strategy [5]Positions [6]Log ║
╠══════════════════════════════════════════════════════════════════════════════════════════╣
║ Wallet: paper · 12,000 USDC Open: 4,280 USDC Day P&L: +312 USDC Signals: 4 ║
║ ────────────────────────────────────────────────────────────────────────────────────── ║
║ Slug Market Price Vol Resolve ║
║ btc-100k-by-eoy Will BTC hit $100k by EOY 0.31 3.1M 165d ║
║ fed-cut-sep Fed cuts rates in Sep 0.68 8.4M 59d ║
║ eth-4k-july ETH above $4k in July 0.12 1.2M 12d ║
║ us-recession-2026 US recession in 2026 0.42 2.7M 198d ║
║ ║
║ STRATEGY SIGNALS BOOK: btc-100k-by-eoy ║
║ ◆ fed-cut-sep PROB-EDGE conf .74 YES bid .29 ask .33 spread 4.0¢ ║
║ ▲ eth-4k-july IMBALANCE conf .61 NO bid .67 ask .71 spread 4.0¢ ║
║ ◆ btc-100k-eoy PROB-EDGE conf .69 imbalance: 61% YES ║
║ ║
║ q Quit / Filter b Book s Scan o Order t Theme ? Help ║
╚══════════════════════════════════════════════════════════════════════════════════════════╝
git clone https://github.com/ArtemPavlov1994/polymarket-prediction-bot.git
cd polymarket-prediction-bot
pip install -r requirements.txt
python main.py --demo # paper-trade bundled dataset
python main.py # live mode (needs API credentials)One-click launchers (no system Python required — they unpack a bundled standalone interpreter on first run):
run.bat :: Windowschmod +x run.sh && ./run.sh # Linux / macOS# ~/.polymarket-bot/config.toml
[auth]
private_key = "0x…" # Polygon EOA private key (chmod 0600!)
proxy_address = "0x…" # Polymarket proxy/signer address
api_key = "…"
api_secret = "…"
api_passphrase= "…"
endpoint = "https://clob.polymarket.com"Credentials are read only from the config file (mode 0600). Never commit them.
| Key | Action |
|---|---|
1–6 |
Dash · Markets · Book · Strategy · Positions · Log |
/ |
Filter markets |
Enter / b |
Open CLOB book for the selected market |
s |
Run the strategy engine across the watchlist |
o |
Compose a paper order |
t |
Cycle theme |
q |
Quit |
Built-in strategies (selectable, composable):
- Probability-edge — compares market price to a fair-probability model and signals when the edge exceeds a threshold.
- Book-imbalance — large YES/NO size skew as a directional cue.
- Liquidity — wide-spread mean-reversion toward mid.
Each signal carries a confidence 0..1 and a suggested side. The bot logs every signal; in
live mode you wire a strategy to an order template.
polymarket-prediction-bot/
├── main.py # Entry point (unpacks bundled runtime on first launch)
├── polymarket_bot/ # Host package
│ ├── __main__.py # `python -m polymarket_bot` entry
│ ├── cli.py # argparse + launch
│ ├── config.py # Config loader (TOML)
│ ├── core/ # models, strategy engine, mock data
│ └── tui/ # Textual app: screens, widgets, styles
├── support/ # Runtime support library
├── requirements.txt
├── run.bat / run.sh # One-click launchers
└── release/ # Pre-compiled binaries (planned)
- Paper-trade by default.
--demonever touches your wallet. - Keys local only, mode 0600, never logged.
- Risk controls: max USDC exposure, per-market cap, daily loss limit.
Is Polymarket available in my region?
Polymarket restricts access in some jurisdictions (notably the US). This bot does not bypass geofencing — check Polymarket's terms for your region.
Does it place real orders?
Only in live mode with your own credentials. By default it runs in paper mode and logs
signals and simulated fills. Start with --demo.
Is this affiliated with Polymarket?
No. Independent, unofficial community project. Polymarket is a third-party protocol.
This is an unofficial community project, not affiliated with, endorsed by, or sponsored by Polymarket. Not financial advice. Trading prediction markets involves risk of loss; no strategy in this repository is guaranteed to make money.
MIT — see LICENSE.