Neckr0ik Polymarket Paper

v1.0.0

Paper trading platform for Polymarket. Practice prediction market trading with virtual money, learn strategies, track performance, and compete on leaderboard...

0· 251· 1 versions· 1 current· 1 all-time· Updated 11h ago· MIT-0

Install

openclaw skills install neckr0ik-polymarket-paper

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

TierVirtual CashMarkets/DayAnalytics
Free$10,0005Basic
Pro ($9/mo)$100,000UnlimitedAdvanced
Team ($29/mo)Multiple accountsUnlimitedFull

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

MetricDescription
Total PnLTotal profit/loss
Win Rate% of trades profitable
Average ReturnMean return per trade
Sharpe RatioRisk-adjusted return
Max DrawdownLargest peak-to-trough
Calmar RatioReturn / max drawdown

Leaderboard Categories

CategoryRanking By
OverallTotal PnL
ROIReturn on investment
Win Rate% profitable trades
SharpeRisk-adjusted return
StreakLongest win streak

Educational Content

Strategy Guides

  1. Spread Arbitrage 101 — Risk-free profit basics
  2. Endgame Trading — Near-certain outcomes
  3. News Correlation — Event-driven trading
  4. Risk Management — Position sizing, stop-losses
  5. Advanced Strategies — Cross-market, cross-platform

Practice Scenarios

  1. Scenario: Crypto Bull Run

    • Start with $50,000
    • Market: "Will BTC hit $150k by EOY?"
    • Learn: Position sizing, timing
  2. Scenario: Election Night

    • Start with $25,000
    • Markets: Multiple election outcomes
    • Learn: Hedging, correlation
  3. 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 guides
  • scripts/paper_trading.py — Main implementation
  • projects/polymarket-paper-trading/ — Full platform design

Version tags

latestvk977c7y7hnx5abctyj46wgxa8d82fy1w