Data Sources & Updates
Real-time data feeds, update intervals, and source information for all statistics and predictions on HV ODDS
Live Game Scores
Real-time game scores, quarters, and game status
Source:ESPN APIUpdate Interval:Every 30 seconds during gamesData Points:Score by quarter, game status, time remaining, possessionAvailability:Live during games, final scores post-game
Live Betting Odds
Current odds from major sportsbooks
Source:The Odds API (Free Tier)Update Interval:Intelligent: 5 min during live games, 30 min on game days, 4 hrs off-daysData Points:Moneyline, spread, over/under (totals) from multiple bookmakersBookmakers:DraftKings, FanDuel, BetMGM, and othersOptimization:Tracks requests to stay within 500/month limit (450 used max, 50 buffer)Storage:Cached in localStorage between updates
Player Injury Reports
Official injury status and player availability
Source:NFL Official Injury Report APIUpdate Interval:Every 1 hourData Points:Player status (Out, Doubtful, Questionable, Probable), injury typeImpact:Used in AI model predictions and game analysisStorage:Cached in localStorage with timestamp
Weather Conditions
Real-time weather at stadium locations
Source:Weather API (OpenWeather or similar)Update Interval:Every 5 minutesData Points:Temperature, wind speed/direction, precipitation, field conditionsImpact:Affects passing game predictions, kicking accuracy, total score projectionsNote:Indoor stadiums display "Controlled Environment"
AI Model Predictions
Machine learning model predictions and confidence scores
Source:Internal AI/ML EngineUpdate Method:Manual via "Run Model" button in headerInput Data:Team stats, player injuries, weather, historical performance, line movementsOutput:Win probability, predicted spread, predicted total, confidence scoresProcessing:Runs client-side, takes ~3-5 seconds per week
Static Game Data
Pre-loaded NFL schedule and team information
Source:NFL Schedule (lib/nfl-data.tsx)Update Method:Pre-loaded, updated manually as neededData Points:Team names, matchups, game times, weeks 1-18, stadium locationsCoverage:2025 NFL Regular Season (Weeks 1-18)
Automatic Week Progression
Intelligent week detection and advancement
Logic:Checks if all games in current week are completedAuto-Advance:11:59 PM PST on the day of the final game of the weekManual Override:"Next Week" button available in header to manually advanceReset:"Auto" button resets to automatic week calculationSeason Start:September 4, 2025
User Betting Data
Cross-device bet synchronization
Storage:Supabase PostgreSQL DatabaseSync Method:Real-time via user_code (5-digit code)Update:Instant on bet placement, retrieved on loginSecurity:Row Level Security (RLS) policies by user_codeMigration:Auto-migrates localStorage bets to cloud on first login
API Rate Limits & Optimization
The Odds API (Free Tier):
- 500 requests per month total limit
- Smart refresh: 5 min during live games (Thu/Sun/Mon 10am-11pm), 30 min pre-game, 4 hrs off-days
- Request tracking: Monitors count per month, stops at 450 to preserve buffer
- Estimated usage: ~400-450 requests/month with intelligent scheduling
- Cached in localStorage between updates for zero-cost retrieval
ESPN Live Scores:
- No official rate limit
- 30-second refresh during live games only
- Pauses when no games are in progress
Intelligent Odds Refresh Strategy:
Live Games (Thu/Sun/Mon 10am-11pm): Every 5 minutes
→ Max 12 requests/hour × 13 hours = ~156 requests/game day
Pre-Game (Game days, non-game hours): Every 30 minutes
→ ~48 requests/day on game days during off-hours
Off-Days (Tue/Wed/Fri/Sat): Every 4 hours
→ 6 requests/day on non-game days
Monthly Estimate: ~400 requests (3 game days/week × 4 weeks + off-days)