Polymarket Paper Trader

This is a zero-risk trading simulator that executes against live Polymarket order book prices and persists your portfolio in SQLite. It walks the actual order book to fill trades rather than using mid-prices, includes configurable risk rules like max position sizing and drawdown limits, and can execute structured recommendations from strategy advisors. The health check script is smart: run it at session start and it fetches live prices, updates your portfolio, evaluates stop losses, and returns a color-coded risk status. If you're building trading strategies or want to test ideas against real market data without putting money on the line, this gives you the full simulation loop with persistent state across sessions.

skills.sh installs: 203
GitHub stars: 99
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add mjunaidca/polymarket-skills --skill polymarket-paper-trader --agent claude-code

Installs into .claude/skills of the current project.

Files

Polymarket Paper Trading Engine

Simulate trades against live Polymarket prices with zero financial risk. No wallet, no keys, no money at stake. Portfolio persists across sessions in SQLite.

Quick Start

Initialize a Portfolio

python ~/.agents/skills/polymarket-paper-trader/scripts/paper_engine.py --action init --balance 1000

Buy Shares (Market Order)

# Buy $50 of YES shares using live order book prices
python ~/.agents/skills/polymarket-paper-trader/scripts/paper_engine.py \
  --action buy --token TOKEN_ID --side YES --size 50 \
  --reason "High confidence based on news analysis"

Buy Shares (Limit Order)

python ~/.agents/skills/polymarket-paper-trader/scripts/paper_engine.py \
  --action buy --token TOKEN_ID --side YES --size 50 --price 0.45 \
  --reason "Value buy below fair price estimate"

Check Portfolio

python ~/.agents/skills/polymarket-paper-trader/scripts/paper_engine.py --action portfolio
python ~/.agents/skills/polymarket-paper-trader/scripts/paper_engine.py --action portfolio --json

SKILL.md on GitHub