Get pre-game win probability data from API

Get pre-game win probability data from API

Usage

cfbd_metrics_wp_pregame(
  year = NULL,
  week = NULL,
  team = NULL,
  season_type = "both"
)

Arguments

year

(Integer optional): Year, 4 digit format (YYYY)

week

(Integer optional): Week - values from 1-15, 1-14 for seasons pre-playoff, i.e. 2013 or earlier

team

(String optional): D-I Team

season_type

(String default both): Season type - regular, postseason, both, allstar, spring_regular, spring_postseason

Value

cfbd_metrics_wp_pregame() - A data frame with 9 variables:

col_name	types	description
season	integer	Season of the game.
season_type	character	Season type of the game (regular, postseason, etc.).
week	integer	Game week of the season.
game_id	integer	Referencing game id.
home_team	character	Home team name.
away_team	character	Away team name.
spread	numeric	Betting line provider spread.
home_win_prob	numeric	Home win probability - pre-game prediction (0-1).
away_win_prob	numeric	Away win probability - pre-game prediction (0-1).

See also

Other CFBD Metrics: cfbd_metrics_fg_ep(), cfbd_metrics_ppa_games(), cfbd_metrics_ppa_players_games(), cfbd_metrics_ppa_players_season(), cfbd_metrics_ppa_predicted(), cfbd_metrics_ppa_teams(), cfbd_metrics_wepa_players_kicking(), cfbd_metrics_wepa_players_passing(), cfbd_metrics_wepa_players_rushing(), cfbd_metrics_wepa_team_season(), cfbd_metrics_wp()

Examples

# \donttest{
  try(cfbd_metrics_wp_pregame(year = 2019, week = 9, team = "Texas A&M"))
#> ── pre-game WP data from CollegeFootballData.com ───────────── cfbfastR 2.3.0 ──
#> ℹ Data updated: 2026-06-13 04:18:18 UTC
#> # A tibble: 1 × 9
#>   season season_type  week   game_id home_team away_team    spread home_win_prob
#>    <int> <chr>       <int>     <int> <chr>     <chr>         <int>         <dbl>
#> 1   2019 regular         9 401110835 Texas A&M Mississippi…    -11         0.776
#> # ℹ 1 more variable: away_win_prob <dbl>
# }