Skip to content

About

Real-time Polymarket whale trade tracker — live feed, herd signals, leaderboard, trader drilldown

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

🐋 Polymarket Whale Watch

A real-time whale trade tracker dashboard for Polymarket. Track large trades ($10K+), spot herd signals, browse the trader leaderboard, and drill into any whale's portfolio.

Features

  • Live Whale Feed — trades $10K+ with threshold selector ($10K / $25K / $50K / $100K) and buy/sell filter, auto-refreshing every 60 seconds
  • Herd Signal Detection — flags markets where ≥3 whales are ≥80% one-directional
  • Hot Markets Panel — volume, net flow, whale count, and direction per market
  • Charts — buy/sell split donut, whale $ by market, trade size distribution
  • Leaderboard — top traders by PnL or volume across day/week/month/all windows
  • Trader Drilldown — positions with avg/current price, cash PnL, and recent trades for any wallet

Stack

  • Next.js 14 (App Router) + TypeScript
  • Tailwind CSS — dark trading-terminal theme
  • API routes proxy data-api.polymarket.com with in-memory TTL caching (60s trades, 5min leaderboard) and stale-fallback on upstream errors

API Routes

Route Source Cache TTL
/api/trades?minUsd=&limit= /trades (CASH filter) 60s
/api/leaderboard?window=&rankType= /v1/leaderboard 5min
/api/positions/[wallet] /positions 2min
/api/holders/[conditionId] /holders 5min

Getting Started

npm install
npm run dev

Open http://localhost:3000.

Deploy

Deploys out of the box on Vercel — framework auto-detected as Next.js.

Roadmap

  • Kalshi whale trade integration
  • Arbitrage detection via scrapers
  • WebSocket real-time updates (replace polling)
  • Persistent trade history + alerts (Vercel KV / Supabase)

About

Real-time Polymarket whale trade tracker — live feed, herd signals, leaderboard, trader drilldown

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages