Get betting lines information for games
Usage
cfbd_betting_lines(
game_id = NULL,
year = NULL,
week = NULL,
season_type = "regular",
team = NULL,
home_team = NULL,
away_team = NULL,
conference = NULL,
line_provider = NULL
)Arguments
- game_id
(Integer optional): Game ID filter for querying a single game. Required if year not provided
Can be found using thecfbd_game_info()function- year
(Integer optional): Year, 4 digit format(YYYY). Required if game_id not provided
- week
(Integer optional): Week - values from 1-15, 1-14 for seasons pre-playoff (i.e. 2013 or earlier)
- season_type
(String default regular): Select Season Type: regular, postseason, both, allstar, spring_regular, spring_postseason
- team
(String optional): D-I Team
- home_team
(String optional): Home D-I Team
- away_team
(String optional): Away 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- line_provider
(String optional): Select Line Provider - Caesars, consensus, numberfire, or teamrankings
Value
Betting information for games with the following 21 columns:
| col_name | types | description |
| game_id | integer | Unique CFBD game identifier. |
| season | integer | Four-digit season year (e.g. 2024). |
| season_type | character | Season type (regular, postseason, both). |
| week | integer | Week of the season; 1-15, or 1-14 for seasons pre-playoff (2013 earlier). |
| start_date | character | Kickoff timestamp in ISO 8601 format. |
| home_team | character | Home D-I team name. |
| home_conference | character | Home team D-I conference. |
| home_classification | character | Home team conference classification (fbs, fcs, ii, iii). |
| home_score | integer | Final score of the home team. |
| away_team | character | Away D-I team name. |
| away_conference | character | Away team D-I conference. |
| away_classification | character | Away team conference classification (fbs, fcs, ii, iii). |
| away_score | integer | Final score of the away team. |
| provider | character | Sportsbook / line provider name. |
| spread | character | Closing point spread for the game. |
| formatted_spread | character | Human-readable formatted spread (e.g. "Florida State -7.5"). |
| spread_open | character | Opening point spread for the game. |
| over_under | character | Closing over/under (total) for the game. |
| over_under_open | character | Opening over/under (total) for the game. |
| home_moneyline | character | Home team moneyline odds. |
| away_moneyline | character | Away team moneyline odds. |
See also
Other CFBD Betting Functions:
cfbd_betting_ats()
Examples
# \donttest{
try(cfbd_betting_lines(year = 2018, week = 12, team = "Florida State"))
#> ── Betting lines data from CollegeFootballData.com ─────────── cfbfastR 2.3.0 ──
#> ℹ Data updated: 2026-06-13 04:18:02 UTC
#> # A tibble: 4 × 23
#> game_id season season_type week start_date home_team_id home_team
#> <int> <int> <chr> <int> <chr> <int> <chr>
#> 1 401013175 2018 regular 12 2018-11-17T20:30:00… 52 Florida …
#> 2 401013175 2018 regular 12 2018-11-17T20:30:00… 52 Florida …
#> 3 401013175 2018 regular 12 2018-11-17T20:30:00… 52 Florida …
#> 4 401013175 2018 regular 12 2018-11-17T20:30:00… 52 Florida …
#> # ℹ 16 more variables: home_conference <chr>, home_classification <chr>,
#> # home_score <int>, away_team_id <int>, away_team <chr>,
#> # away_conference <chr>, away_classification <chr>, away_score <int>,
#> # provider <chr>, spread <dbl>, formatted_spread <chr>, spread_open <lgl>,
#> # over_under <dbl>, over_under_open <lgl>, home_moneyline <lgl>,
#> # away_moneyline <lgl>
# }