Polymarket Copy Tracker Skill

Polymarket Copy Tracker

Analyze top Polymarket traders for copy trading signals.

Data Sources

Data API (data-api.polymarket.com) - Wallet history (public, no auth)
Polymarket.com/leaderboard - Top traders page (extract wallet addresses)

Quick Start

Step 1: Get wallet addresses

python3 scripts/find_top_traders.py --limit 20

Step 2: Analyze a wallet

python3 scripts/analyze_wallet.py 0xWALLET_ADDRESS
python3 scripts/analyze_wallet.py 0xWALLET_ADDRESS --json  # raw JSON output

Step 3: Score multiple wallets

python3 scripts/copy_score.py wallet1 wallet2 wallet3 ...

API Endpoints

Data API (Public)

# Open positions
GET https://data-api.polymarket.com/positions?user=WALLET&limit=50

# Closed/resolved positions
GET https://data-api.polymarket.com/closed-positions?user=WALLET&limit=50

# Trade history
GET https://data-api.polymarket.com/trades?user=WALLET&limit=100

Key fields in positions:

title - Market name
size - Number of shares
avgPrice - Average entry price
currentValue - Current market value
cashPnl - Unrealized P&L (open positions)
realizedPnl - Realized P&L (resolved positions)
outcome - Selected outcome (Yes/No/Team name)
redeemable - True if resolved and can be redeemed

Scoring Criteria

| Metric | Weight | Good | Bad | |--------|--------|------|-----| | Win Rate | 40% | ≥65% | <45% | | Total PnL | 30% | ≥$1000 | <$0 | | Risk Score | 20% | <0.8 | ≥1.0 | | Sample Size | 10% | ≥20 trades | <5 trades |

Risk Score = Avg Loss / Avg Win (lower = better, <1.0 means wins > losses)

Final Score: 0-100 → COPYABLE (≥70), CAUTION (45-69), NOT RECOMMENDED (<45)

Example Output

=== Analyzing Wallet: 0xf19572...8057 ===

CLOSED POSITIONS (Win Rate & PnL)
==================================================
Total Closed:    49
Win Rate:        67.3%  (33W / 16L)
Total PnL:       +$2,223,761
Avg Win:         $110,028
Avg Loss:        $87,948
Risk Score:      0.80  ✅ GOOD

OPEN POSITIONS: 8 | Value: $17,739 | Unrealized: -$445,325

COPY ASSESSMENT
==================================================
Score: 92/100  ✅ COPYABLE
  ✅ High win rate (67%)
  ✅ Excellent PnL ($2,223,761)
  ✅ Low risk (score 0.80)
  ✅ Good sample (49 trades)

Scripts

| Script | Purpose | |--------|---------| | find_top_traders.py | Extract wallet addresses from polymarket.com/leaderboard | | analyze_wallet.py | Deep-dive a single wallet (positions, trades, score) | | copy_score.py | Score and rank multiple wallets in parallel |

Curated Wallet Database

See references/top-wallets.md for a curated list of high-quality wallets organized by tier:

Tier 2 wallets are best for copy trading (high ROI + human-scale activity)
Includes filtering notes (skip protocol addresses, bots, etc.)

Discovery Methods

See references/discovery-methods.md for 5 methods to find wallets:

Dune Profitability Dashboard — PnL/ROI rankings (free, no login)
Dune Wallet Analyzooooor — Per-wallet win rate (free, needs login)
Polymarket Data API — Real-time positions (public API)
Polymarket Leaderboard — Quick browse top traders
Polymarket Profile Page — Visual current positions

Quick Workflow

# 1. Score a known wallet
python3 scripts/analyze_wallet.py 0x2785e7022dc20757108204b13c08cea8613b70ae

# 2. Compare multiple candidates
python3 scripts/copy_score.py 0x2785e702... 0xed107a85... 0x6a72f618...

# 3. Find new top traders
python3 scripts/find_top_traders.py --limit 20

Notes

Data API is public (read-only, no auth required)
Rate limit: ~100 req/min
Not all wallets have public history (new or privacy)
closed-positions has resolved trades, positions has open trades
PnL is calculated from face value (shares × $1) minus cost (shares × avgPrice)
Dune data is all-time historical; API shows recent activity
Wallets with 0 trades but huge PnL are protocol addresses — skip them
Wallets with >500K trades are likely market-making bots — not suitable for copy trading

Agent Skills: Polymarket Copy Tracker

Install this agent skill to your local

Skill Files