Skip to content

WhiiteRose/PolyScan

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

5 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

PolyScan

Polymarket Copy Trading Scanner β€” Identifies the top 10 most interesting traders to copy on Polymarket, updated daily.

🎯 Purpose

PolyScan analyzes the Polymarket leaderboard and individual trader positions to find the best wallets for copy trading via Polycop. It calculates a composite score based on:

Weight Metric Why it matters
25% ROI % Capital efficiency β€” crucial for small budgets
20% PnL (30 days) Recent performance
15% PnL (7 days) Short-term momentum
15% Consistency Present in leaderboard across multiple periods
10% Win Rate % of profitable positions
10% Activity Level Sweet spot of 5-25 active positions
5% Budget Compatibility Slight penalty for huge average position sizes

πŸš€ Quick Start

1. Generate data

cd backend
npm install
cd ..
node backend/fetch-data.js

2. View the dashboard

Open index.html in your browser, or serve it locally:

npx -y serve .

3. Copy a wallet

Click the πŸ“‹ button next to any trader to copy their wallet address, then paste it into Polycop.

πŸ”„ Auto-Updates

The GitHub Action (.github/workflows/update-data.yml) runs daily at 8:00 AM Paris time and commits the updated data/top10.json. You can also trigger it manually from the Actions tab.

πŸ“ Project Structure

PolyScan/
β”œβ”€β”€ backend/
β”‚   β”œβ”€β”€ fetch-data.js     # Data fetcher & scoring engine
β”‚   └── package.json
β”œβ”€β”€ data/
β”‚   └── top10.json        # Generated daily (committed by bot)
β”œβ”€β”€ .github/workflows/
β”‚   └── update-data.yml   # Daily cron job
β”œβ”€β”€ index.html            # Dashboard interface
β”œβ”€β”€ style.css             # Styles
β”œβ”€β”€ app.js                # Frontend logic
└── README.md

⚠️ Disclaimer

This tool is for informational purposes only. Copy trading on prediction markets carries significant risks including but not limited to:

  • Execution latency β€” you may get worse prices than the copied trader
  • Slippage β€” especially in low-liquidity markets
  • Past performance β‰  future results β€” a trader's history doesn't guarantee future success
  • Market risk β€” prediction markets can be highly volatile

Always do your own research (DYOR) and never invest more than you can afford to lose.

πŸ“œ License

This project is licensed under the MIT License.

About

πŸ“Š Polymarket copy trading scanner β€” Identifies the top 10 most profitable traders to copy daily using a weighted scoring algorithm. Built for Polycop integration.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors