🐋 Polymarket Whale Copier

Automatically copy trade winning Polymarket wallets.

Track any wallet, mirror their bets, profit from their alpha.

Features

• 🎯 Copy Any Wallet — Just paste their address
• 📊 Configurable Size — Copy 1-100% of their position
• 🛡️ Risk Controls — Min/max trade limits, BUY-only mode
• 📝 Full Logging — Every trade documented
• 🔄 Auto-Redemption — Claims winning positions automatically
• 💰 No API Keys — Uses public Polymarket APIs

Quick Start

# 1. Set your Polymarket private key
export POLYMARKET_KEY="0xYourPrivateKey"

# 2. Run the copier
python3 scripts/copy_trader.py --target 0xWhaleWallet --percent 10

Configuration

Edit config.json:

{
  "target_wallet": "0x...",
  "copy_percent": 10,
  "min_trade_usd": 5,
  "max_trade_usd": 50,
  "buy_only": true,
  "check_interval_sec": 60,
  "dry_run": false
}

Commands

# Start copy trading (background)
./scripts/start.sh

# Check status
./scripts/status.sh

# Stop trading
./scripts/stop.sh

# View recent trades
./scripts/logs.sh

# Auto-redeem winning positions
python3 scripts/auto_redeem.py

Finding Whale Wallets

1. Go to Polymarket Leaderboard
2. Click on top traders
3. Copy their wallet address from the URL
4. Paste into config or --target flag

Risk Management

Setting	Default	Description
copy_percent	10%	% of whale's position to copy
min_trade_usd	$5	Skip trades smaller than this
max_trade_usd	$50	Cap maximum trade size
buy_only	true	Only copy BUYs (safer)

How It Works

1. Monitor — Polls target wallet every 60 seconds
2. Detect — Identifies new trades via Polymarket API
3. Filter — Applies your risk settings
4. Execute — Places matching orders on your account
5. Log — Records everything for analysis

Example Output

🚀 POLYMARKET COPY TRADER STARTING
🎯 Target: 0x4ffe49ba...609f71
📊 Copy: 10% | Limits: $5-$50

🔄 Monitoring cycle #42
📈 New trade detected!
   Whale: BUY 500 shares @ $0.35 = $175
   Copying: BUY 50 shares @ $0.35 = $17.50
✅ Order placed: #123456789

Requirements

• Python 3.8+
• Polymarket account with USDC
• Private key (for signing trades)

Safety Notes

⚠️ Never share your private key ⚠️ Start with small amounts ⚠️ Use dry_run mode first ⚠️ Past performance ≠ future results

Support

Issues? Questions? Open a GitHub issue or find us on Discord.

---

Built by Nix 🔥 | Not financial advice