TennisStatMan
A fan-inspired professional tennis analytics website covering ATP and WTA tours with innovative stats beyond the traditional box score.
Vision
TennisStatMan aims to surface the invisible forces in tennis — momentum swings, clutch performance under pressure, mental resilience, and external factors like weather and court conditions.
Features (Current)
- Homepage with hero, featured match analysis, and live rankings snapshot
- Official Rankings page (
/rankings) with ATP + WTA singles tables
- API routes at
/api/rankings/atp and /api/rankings/wta
- ATP & WTA tour pages with top-20 live rankings
- Stats Lab showcasing current and upcoming innovative metrics
- Momentum Swing Index — interactive preview tracking win-probability shifts game-by-game
Rankings refresh hourly from official tour sources, with Tennis API (RapidAPI) as a fallback and primary ATP source when configured:
- WTA: parsed from the official rankings page at
wtatennis.com
- ATP: Tennis API when
RAPIDAPI_KEY is set, otherwise the official ATP rankings API
- Free tier note: Tennis API responses are cached for 24 hours (50 requests/day limit). No live endpoints are used.
Tennis API setup (optional, free tier)
- Subscribe to Tennis API on RapidAPI
- Copy
.env.example to .env.local and add your key:
RAPIDAPI_KEY=your_key_here
- Available adapter routes (non-live, free-tier friendly):
GET /api/tennis/rankings/atp or /wtaGET /api/tennis/player/atp/{playerId}GET /api/tennis/h2h/atp/{player1Id}/{player2Id}GET /api/tennis/fixtures/atp?date=YYYY-MM-DDGET /api/tennis/fixtures/atp?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD
Upcoming Metrics
- Clutch Factor Score
- Mental Resilience Map
- External Factor Index (heat, wind, court speed)
- Serve Momentum Chain
- Crowd Influence Delta
Tech Stack
Getting Started
npm install
npm run dev
Open http://localhost:3000 to view the site.
Deploy
Deploy easily on Vercel:
npm run build
License
Private project — 3maybees-glitch/tennisstatman
