Find scores for the sports which are accessible through the Odds API

Get the scores for the sports which The Odds API provides coverage.

Returns live and recently completed games for a sport, including scores for games completed within the last 3 days. Live scores update roughly every 30 seconds.

Usage quota cost: 1 credit when days_from is not supplied; 2 credits when days_from is supplied.

Usage

toa_sports_scores(sport_key, days_from = NULL, date_format = "iso")

Arguments

sport_key

(string, required): The sport_key to look up scores for. See toa_sports() for a full lookup of sport_key values.

days_from

(integer, optional): Number of days in the past from which to return completed games, an integer from 1 to 3. If NULL (default), only live and upcoming games are returned.

date_format

(string, optional): Format of returned timestamps. Options are:

iso (ISO 8601, the default)
unix (epoch seconds)

Value

A tibble of scores for the sport The Odds API provides coverage for:

col_name	types	description
id	character	Unique event id.
sport_key	character	Sport key, e.g. `basketball_nba`.
sport_title	character	Human-readable sport title, e.g. `NBA`.
commence_time	character	Game start time (ISO 8601 string or unix seconds).
completed	logical	`TRUE` if the game has finished.
home_team	character	Home team name.
away_team	character	Away team name.
scores	list	Per-team `name`/`score` pairs; `NULL`/`NA` before scores post.
last_update	character	Time the scores were last updated; `NA` until a game is live.

Examples

# \donttest{
   try(toa_sports_scores(sport_key = 'basketball_nba',
                         days_from = NULL,
                         date_format = 'iso'))
#> ── Sports scores data from the-odds-api.com ────────── oddsapiR 1.0.0 ──
#> ℹ Data updated: 2026-08-24 08:27:44 UTC
#> ℹ Odds API quota: 10551 used, 4989449 remaining (last call cost 1)
#> # A tibble: 41 × 9
#>    id            sport_key sport_title commence_time completed home_team
#>    <chr>         <chr>     <chr>       <chr>         <lgl>     <chr>    
#>  1 26b036ff107f… basketba… NBA         2026-10-20T1… FALSE     Detroit …
#>  2 2b042ddad3d3… basketba… NBA         2026-10-20T2… FALSE     New York…
#>  3 bccd283de569… basketba… NBA         2026-10-21T0… FALSE     San Anto…
#>  4 85e6e4e2404e… basketba… NBA         2026-10-21T2… FALSE     Orlando …
#>  5 164cc0396837… basketba… NBA         2026-10-21T2… FALSE     Washingt…
#>  6 47cc511bb5ce… basketba… NBA         2026-10-21T2… FALSE     Brooklyn…
#>  7 93cdd8e4ade5… basketba… NBA         2026-10-21T2… FALSE     Miami He…
#>  8 fd33c09c84ab… basketba… NBA         2026-10-22T0… FALSE     New Orle…
#>  9 e6769c813dd6… basketba… NBA         2026-10-22T0… FALSE     Memphis …
#> 10 af2f08407539… basketba… NBA         2026-10-22T0… FALSE     Houston …
#> # ℹ 31 more rows
#> # ℹ 3 more variables: away_team <chr>, scores <lgl>, last_update <lgl>
# }

Find scores for the sports which are accessible through the Odds API

Usage

Arguments

Value

See also

Examples