Get against-the-spread (ATS) summary records by team
Retrieves a season-level against-the-spread summary for each team:
how often the team covered, failed to cover, or pushed relative to
the closing spread, plus the average margin by which it beat the
spread. Complements cfbd_betting_lines(), which returns the
per-game lines themselves.
Arguments
- year
(Integer required): Year, 4 digit format (YYYY).
- team
(String optional): D-I Team
- conference
(String optional): Conference abbreviation - Select a valid FBS conference
Conference abbreviations P5: ACC, B12, B1G, SEC, PAC
Conference abbreviations G5 and FBS Independents: CUSA, MAC, MWC, Ind, SBC, AAC
Value
Against-the-spread records with the following 9 columns:
| col_name | types | description |
| year | integer | Four-digit season year. |
| team_id | integer | Unique CFBD team identifier. |
| team | character | D-I team name. |
| conference | character | Team conference name. |
| games | integer | Number of games included in the ATS summary. |
| ats_wins | integer | Games the team covered the spread. |
| ats_losses | integer | Games the team failed to cover the spread. |
| ats_pushes | integer | Games that pushed against the spread. |
| avg_cover_margin | numeric | Average margin by which the team beat the spread. |
See also
Other CFBD Betting Functions:
cfbd_betting_lines()
Examples
# \donttest{
try(cfbd_betting_ats(year = 2023, team = "Michigan"))
#> ── Against-the-spread records from CollegeFootballData.com ─── cfbfastR 2.3.0 ──
#> ℹ Data updated: 2026-06-09 19:57:36 UTC
#> # A tibble: 1 × 9
#> year team_id team conference games ats_wins ats_losses ats_pushes
#> <int> <int> <chr> <chr> <int> <int> <int> <int>
#> 1 2023 130 Michigan B1G 15 10 5 0
#> # ℹ 1 more variable: avg_cover_margin <dbl>
# }