Agent skill
Polymarket Whale Tracker
This skill should be used when the user asks to "track whales", "monitor polymarket traders", "copy trade polymarket", "whale tracker", "follow smart money", or mentions tracking high-alpha Polymarket traders.
Install this agent skill to your Project
npx add-skill https://github.com/ChinchillaEnterprises/ChillSkills/tree/main/polymarket-whale-tracker
SKILL.md
Polymarket Whale Tracker
Real-time monitoring and copy-trading system for high-alpha Polymarket traders.
Quick Start
cd /Users/tori/Documents/Repos/polymarket-tools/whale-tracker
source venv/bin/activate
python main.py
Dashboard: http://localhost:8000 API Docs: http://localhost:8000/docs
How It Works
- WebSocket connects to Polymarket CLOB trade feed
- Incoming trades checked against tracked whale addresses
- Large trades (>$5k) from whales generate copy signals
- Dashboard shows real-time activity and positions
Key Settings
| Setting | Default | Description |
|---|---|---|
| MIN_TRADE_SIZE | $5,000 | Min whale trade to track |
| COPY_PERCENTAGE | 5% | % of whale size to copy |
| MAX_COPY_SIZE | $500 | Max copy trade |
| COOLDOWN_SECONDS | 60 | Between copies |
Managing Whales
Via Dashboard
- Open http://localhost:8000
- Add/remove addresses in the UI
Via API
# Add whale
curl -X POST http://localhost:8000/api/whales \
-H "Content-Type: application/json" \
-d '{"address": "0x...", "name": "Trader Name"}'
# List whales
curl http://localhost:8000/api/whales
# Remove whale
curl -X DELETE http://localhost:8000/api/whales/0x...
Via File
Edit whales.json directly.
Finding Whale Addresses
- Check Polymarket leaderboard
- Look for >60% win rate over 100+ trades
- Use etherscan/polygonscan to analyze patterns
Files
- Repo:
ChinchillaEnterprises/polymarket-tools - Code:
/Users/tori/Documents/Repos/polymarket-tools/whale-tracker/ - Main:
main.py(entry point) - API:
api.py(FastAPI + dashboard) - Tracker:
tracker.py(whale logic) - WS:
websocket_client.py(WebSocket) - Whales:
whales.json(tracked addresses)
API Endpoints
| Endpoint | Description |
|---|---|
| GET /api/stats | Statistics |
| GET /api/whales | List whales |
| POST /api/whales | Add whale |
| DELETE /api/whales/{addr} | Remove whale |
| GET /api/positions | Positions |
| GET /api/trades | Whale trades |
| GET /api/events | Recent events |
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
ChinchillaEnterprises/ChillSkills
Red Team
Use this skill when the user says "red team", "stress test", "attack this", "critique this", "run the models against this", "test this plan", "refine this with AI", or wants to use external AI models to critique, validate, or improve a document, pitch, plan, or idea. Also use when the user wants to save Claude Code usage by offloading analysis to other models.
ChinchillaEnterprises/ChillSkills
Upwork Scanner
This skill should be used when the user asks to "scan upwork", "find upwork jobs", "check upwork", "run the scanner", "look for jobs", or mentions finding freelance projects for Chinchilla AI.
ChinchillaEnterprises/ChillSkills
Polymarket Arb Scanner
This skill should be used when the user asks to "scan polymarket", "find arb opportunities", "check polymarket arbs", "run arb scanner", "polymarket arbitrage", or mentions detecting price inefficiencies on Polymarket.
ChinchillaEnterprises/ChillSkills
captain-update
ChinchillaEnterprises/ChillSkills
Polymarket Copy Trader
This skill should be used when the user asks to "copy trade", "telegram bot polymarket", "follow traders", "copy polymarket", or mentions building a copy trading bot for Polymarket.
ChinchillaEnterprises/ChillSkills
Architecture Diagram
This skill should be used when the user asks to "generate a diagram", "create an architecture diagram", "make a diagram", "draw a system diagram", or needs a branded Chinchilla AI technical diagram for proposals or documentation.
Didn't find tool you were looking for?