Overview
What is PolyWhales?
PolyWhales connects directly to the Polygon blockchain via Alchemy WebSocket and streams every trade from Polymarket's CTF Exchange contracts in real time — no polling, no delay. It identifies high-performing wallets ("whales") by win rate and volume, then surfaces signals whenever smart money opens a new position in a sports market.
How It Works
On-Chain Event Streaming
Subscribes to OrderFilled events on both Polymarket CTF Exchange contracts via Alchemy WebSocket. Every trade hits the system the moment it's confirmed on Polygon.
Token Cache
Maps 100k+ Polymarket outcome token IDs to human-readable market titles and outcomes. Refreshed every 10 minutes from the Polymarket API.
Wallet Scoring
Every wallet that trades in sports markets gets scored by win rate, total volume, and recency. Top 50 wallets are flagged as tracked whales.
Signal Generation
When a tracked whale opens a new position, a signal fires immediately. Signals include the market, direction, size, wallet score, and win rate.
Dashboard
Live Web UI
Four-tab dashboard accessible at whales.ferocity.trade — Live Feed of whale trades, Signal log, Whale leaderboard ranked by score, and Markets overview showing where whales are positioned.
Roadmap
Prometheus Integration
PolyWhales exposes a /api/signals/prometheus endpoint ready for the Claude-powered Prometheus agent to consume and act on whale signals autonomously.
Expanded Markets
Currently tracking sports markets. Full market expansion planned for when Prometheus takes over trade decisions.