Skip to content
Skills Library
Finance & accounting · Analysis

polymarket-copy-tracker

/polymarket-copy-tracker

Analyze top Polymarket traders for copy trading. Use when asked to find best traders to copy, analyze trader performance/history, evaluate wallet PnL, discover high-ROI wallets, or research trader win rates on Polymarket. Supports Dune analytics, Polymarket Data API, and automated scoring.

Licence
MIT
Last repository change
20.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
6
Scripts
3
HTML comments
0
URLs in SKILL.md
3
Deprecation

No signals detected. Repository changed on 20.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 3 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/analyze_wallet.py, scripts/copy_score.py, scripts/find_top_traders.py

What it does and when to use it

Analyze top Polymarket traders for copy trading. Use when asked to find best traders to copy, analyze trader performance/history, evaluate wallet PnL, discover high-ROI wallets, or research trader win rates on Polymarket. Supports Dune analytics, Polymarket Data API, and automated scoring.

Original author description

Analyze top Polymarket traders for copy trading. Use when asked to find best traders to copy, analyze trader performance/history, evaluate wallet PnL, discover high-ROI wallets, or research trader win rates on Polymarket. Supports Dune analytics, Polymarket Data API, and automated scoring.

How it works

  1. Data Sources
  2. Quick Start
  3. API Endpoints
  4. Scoring Criteria
  5. Example Output
  6. Scripts
  7. Curated Wallet Database
  8. Discovery Methods
  9. Quick Workflow
  10. Notes
Original SKILL.md headings · 138 lines, 579 words
SKILL.md preview
---
name: polymarket-copy-tracker
description: Analyze top Polymarket traders for copy trading. Use when asked to find best traders to copy, analyze trader performance/history, evaluate wallet PnL, discover high-ROI wallets, or research trader win rates on Polymarket. Supports Dune analytics, Polymarket Data API, and automated scoring.
---

# Polymarket Copy Tracker

Analyze top Polymarket traders for copy trading signals.

## Data Sources

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

## Quick Start

### Step 1: Get wallet addresses
```bash
python3 scripts/find_top_traders.py --limit 20
```

### Step 2: Analyze a wallet
```bash
python3 scripts/analyze_wallet.py 0xWALLET_ADDRESS
python3 scripts/analyze_wallet.py 0xWALLET_ADDRESS --json  # raw JSON output
```

### Step 3: Score multiple wallets
```bash
python3 scripts/copy_score.py wallet1 wallet2 wallet3 ...
```

## API Endpoints

### Data API (Public)

```bash
# 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](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](references/discovery-methods.md) for 5 methods to find wallets:
1. **Dune Profitability Dashboard** — PnL/ROI rankings (free, no login)
2. **Dune Wallet Analyzooooor** — Per-wallet win rate (free, needs login)
3. **Polymarket Data API** — Real-time positions (public API)
4. **Polymarket Leaderboard** — Quick browse top traders
5. **Polymarket Profile Page** — Visual current positions

## Quick Workflow

```bash
# 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
Files in this package (6)
  • SKILL.md 4 KB
  • references/discovery-methods.md 4 KB
  • references/top-wallets.md 3 KB
  • scripts/analyze_wallet.py 13 KB
  • scripts/copy_score.py 7 KB
  • scripts/find_top_traders.py 2 KB

Versions

The database has no other skills named polymarket-copy-tracker.

Database snapshot: 13.11.2026 · package version a15adb412d21 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100polyvision
    Analyze Polymarket prediction market wallets — get copy trading scores (1-10), P&L, win rate, risk metrics (Sharpe ratio, Sortino ratio, max drawdown), red flags, position sizing, market category performance, recent performance (7d/30d/90d), streak analysis, individual open…
  • 95nansen-polymarket-trader-profile
    What is a Polymarket trader betting on? Trades by address, PnL breakdown, and market context. Use when analysing a specific Polymarket wallet.
  • 90senpi-trader-research
    Research public Hyperliquid traders with the Senpi connector. Use for "find top traders", "best traders this month", "who's consistent?", "find traders to copy", "who could I mirror?", "compare these wallets", "is 0x… any good?", "show me their trades". Calls find_top_traders…
  • 87senpi-trader-research
    Research Hyperliquid traders to copy — rank the best track records and vet a specific trader before mirroring. Use for "who should I copy?", "find good traders", "is this trader any good?", "should I copy 0x…?", "best traders this month", "top copy strategies". Use this instead…
  • 100nansen-polymarket-deep-dive
    Deep dive on a Polymarket market — OHLCV, orderbook, top holders, positions, trades, and PnL leaderboard. Use when analysing a specific prediction market.
  • 95polymarket-tradingskill
    Use when an OpenClaw user needs fast NBA opportunity scanning, NBA-only /fair pricing, or deep analysis of one specific Polymarket market or event in any domain, including politics, via prompts like /analyze, analyze this market, or direct PM URLs, without making the final trading decision.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.