knownasnaffy Polymarket Paper Trading
Practice Polymarket trading with virtual money. Learn strategies. Compete on leaderboards.
Quick Start
# Create account with $10,000 virtual
neckr0ik-polymarket-paper create-account --name "MyPortfolio"
# View available markets
neckr0ik-polymarket-paper markets --limit 20
# Place a trade
neckr0ik-polymarket-paper trade --market "will-bitcoin-reach-100k" --side YES --amount 500
# Check portfolio
neckr0ik-polymarket-paper portfolio
# View leaderboard
neckr0ik-polymarket-paper leaderboard --weekly
What This Does
- Virtual trading — $10,000 practice account
- Real market data — Live Polymarket prices
- Simulated execution — Orders filled at market price
- Performance tracking — Win rate, ROI, Sharpe ratio
- Leaderboards — Compete with other paper traders
- Strategy guides — Learn before risking real money
Account Types
| Tier | Virtual Cash | Markets/Day | Analytics |
|---|---|---|---|
| Free | $10,000 | 5 | Basic |
| Pro ($9/mo) | $100,000 | Unlimited | Advanced |
| Team ($29/mo) | Multiple accounts | Unlimited | Full |
Commands
create-account
Create a paper trading account.
neckr0ik-polymarket-paper create-account [options]
Options:
--name <name> Account name
--tier <tier> Account tier (free, pro, team)
--initial <amount> Starting cash (default: 10000)
markets
View available Polymarket markets.
neckr0ik-polymarket-paper markets [options]
Options:
--limit <n> Max results (default: 20)
--category <name> Filter by category (crypto, politics, sports)
--search <query> Search by keyword
trade
Place a paper trade.
neckr0ik-polymarket-paper trade [options]
Options:
--market <id> Market ID or slug
--side <side> YES or NO
--amount <dollars> Amount to trade
--limit <price> Limit price (optional)
portfolio
View your portfolio.
neckr0ik-polymarket-paper portfolio [options]
Options:
--history Show transaction history
--performance Show performance metrics
resolve
Manually resolve a market (for practice).
neckr0ik-polymarket-paper resolve --market <id> --outcome <YES|NO>
leaderboard
View top paper traders.
neckr0ik-polymarket-paper leaderboard [options]
Options:
--period <period> weekly, monthly, all-time
--strategy <type> Filter by strategy
analytics
View detailed analytics.
neckr0ik-polymarket-paper analytics [options]
Options:
--period <days> Analysis period (default: 30)
--strategy Breakdown by strategy
export
Export your trading history.
neckr0ik-polymarket-paper export [options]
Options:
--format <format> csv, json
--output <file> Output file
Trading Strategies
1. Spread Arbitrage (Practice)
Buy both YES and NO when combined < $1.00.
Example:
Market: "Will Bitcoin hit $100k?"
YES: $0.48
NO: $0.50
Combined: $0.98
Trade: Buy $490 YES + $500 NO = $990 total
Guaranteed payout: $1,000
Profit: $10 (1.01%)
2. Endgame Trading
Buy near-certain outcomes close to resolution.
Example:
Market: "Will X happen by March 31?"
Current: March 28
YES price: $0.97
Days remaining: 3
Trade: Buy YES at $0.97
Hold until resolution at $1.00
Profit: 3.1% in 3 days (376% annualized)
3. News Correlation
Trade on news before market adjusts.
Example:
News: "Israel strikes Tehran. Trump demands surrender."
Market: "Will Trump declare war on Iran?" @ 40%
Analysis: Military action ≠ formal war declaration
Market likely overpriced
Trade: Sell YES (or buy NO)
Performance Metrics
| Metric | Description |
|---|---|
| Total PnL | Total profit/loss |
| Win Rate | % of trades profitable |
| Average Return | Mean return per trade |
| Sharpe Ratio | Risk-adjusted return |
| Max Drawdown | Largest peak-to-trough |
| Calmar Ratio | Return / max drawdown |
Leaderboard Categories
| Category | Ranking By |
|---|---|
| Overall | Total PnL |
| ROI | Return on investment |
| Win Rate | % profitable trades |
| Sharpe | Risk-adjusted return |
| Streak | Longest win streak |
Educational Content
Strategy Guides
- Spread Arbitrage 101 — Risk-free profit basics
- Endgame Trading — Near-certain outcomes
- News Correlation — Event-driven trading
- Risk Management — Position sizing, stop-losses
- Advanced Strategies — Cross-market, cross-platform
Practice Scenarios
Scenario: Crypto Bull Run
- Start with $50,000
- Market: "Will BTC hit $150k by EOY?"
- Learn: Position sizing, timing
Scenario: Election Night
- Start with $25,000
- Markets: Multiple election outcomes
- Learn: Hedging, correlation
Scenario: Market Crash
- Start with $100,000
- Market: "Will S&P drop below 4000?"
- Learn: Risk management, stop-losses
Example Session
$ neckr0ik-polymarket-paper create-account --name "Learning"
✓ Created account: Learning
Virtual cash: $10,000
$ neckr0ik-polymarket-paper markets --search "bitcoin"
Found 5 markets:
1. "Will Bitcoin hit $100k by EOY 2026?" YES: 0.45
2. "Will Bitcoin drop below $50k?" NO: 0.65
3. "Will Bitcoin be banned?" NO: 0.92
...
$ neckr0ik-polymarket-paper trade --market "bitcoin-100k" --side YES --amount 1000
✓ Trade executed
Market: "Will Bitcoin hit $100k by EOY 2026?"
Side: YES
Amount: $1,000
Price: $0.45
Shares: 2,222.22
Fee: $0.01
$ neckr0ik-polymarket-paper portfolio
Portfolio: Learning
Cash: $8,999.99
Positions:
- "bitcoin-100k" YES: 2,222.22 shares @ $0.45 = $999.99
Total Value: $10,000.00 (0.00% return)
$ neckr0ik-polymarket-paper leaderboard --weekly
Weekly Leaderboard:
1. @trader1: +15.2% ($1,520 profit)
2. @trader2: +12.8% ($1,280 profit)
3. @trader3: +10.5% ($1,050 profit)
...
127. @Learning: 0.0% ($0 profit)
See Also
references/strategies.md— Detailed strategy guidesscripts/paper_trading.py— Main implementationprojects/polymarket-paper-trading/— Full platform design