| name | neckr0ik-polymarket-paper |
| version | 1.0.0 |
| description | Paper trading platform for Polymarket. Practice prediction market trading with virtual money, learn strategies, track performance, and compete on leaderboards. Use for training before risking real capital. |
Setup
Install Homebrew (macOS)
If Homebrew is not installed:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Install dependencies
brew install jq curl git
This skill uses standard macOS package management. All packages are from the official Homebrew repository.
Polymarket Paper Trading
Practice Polymarket trading with virtual money. Learn strategies. Compete on leaderboards.
Quick Start
neckr0ik-polymarket-paper create-account --name "MyPortfolio"
neckr0ik-polymarket-paper markets --limit 20
neckr0ik-polymarket-paper trade --market "will-bitcoin-reach-100k" --side YES --amount 500
neckr0ik-polymarket-paper portfolio
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
