polymarket-whale-copier - SKILL.md Agent Skill

name: polymarket-whale-copier version: 1.0.0 description: Copy trade winning Polymarket wallets automatically. Track whale wallets, mirror their bets at configurable percentages, with built-in risk management. No API keys needed. author: nix tags: [polymarket, trading, copy-trading, whale, prediction-markets, automation]

🐋 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

Go to Polymarket Leaderboard
Click on top traders
Copy their wallet address from the URL
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

Monitor — Polls target wallet every 60 seconds
Detect — Identifies new trades via Polymarket API
Filter — Applies your risk settings
Execute — Places matching orders on your account
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