Docs › Guides
Off-season? What to build now
Your league is between seasons, but your key isn’t limited to one league or one season. Here are four things worth doing with it until opening day.
1. Use a league that is playing right now
In season today: NFL, NBA, College Football, College Basketball, NHL. The big European soccer leagues (Premier League, LaLiga, Serie A, Bundesliga, Champions League) run from late summer to spring. Same key, same endpoints: change the sport and league in the path.
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://www.realtimesportsapi.com/api/v1/sports/basketball/leagues/nba/events/live"Live scores, play-by-play, odds, WebSocket and webhooks work the same way for every monitored league. See WebSockets and webhooks.
2. Backtest on past seasons
Past seasons are in the API with final scores, so you can test a model, a fantasy scorer or a betting tool on games whose results you already know. List the seasons a league has, then pull a full season:
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://www.realtimesportsapi.com/api/v1/sports/basketball/leagues/nba/seasons"curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://www.realtimesportsapi.com/api/v1/sports/football/leagues/nfl/seasons/2024/schedule?page=1"- One team’s whole season:
/seasons/2024/teams/{teamId}/events - A player’s game-by-game stats:
/athletes/{athleteId}/gamelog?season=2025 - Box scores and play-by-play for any finished game:
/events/{eventId}/boxscore,/plays - How a line moved before a game:
/events/{eventId}/odds/history - When players were ruled in or out:
/player-availability/historyand/athletes/{athleteId}/availability-history - Any past day’s games:
/events?date=YYYYMMDD
3. Load next season’s schedule
Schedules appear as soon as a league publishes them. Build the calendar, notifications or fixture pages now and they’ll be ready on day one. The /season endpoint tells you which season is active.
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://www.realtimesportsapi.com/api/v1/sports/baseball/leagues/mlb/seasons/2027/schedule"Or browse them on the public schedule pages.
4. Test your integration before opening day
- Webhooks: send yourself a signed test delivery with
POST /webhooks/{webhookId}/testand check your endpoint verifies and stores it. - Parsing: replay a finished game day through your code with
/events?date=YYYYMMDDand the game’s/plays. - Live: point your WebSocket client at a league that is playing tonight (list above) to watch real score updates arrive.
New to the API? Start with your first call, or the full API reference.