Skip to contents

Get the sports for which The Odds API provides coverage.

Returns a list of in-season sports. The key returned here is the sport_key consumed by every other toa_*() endpoint.

Usage quota cost: Free. This endpoint does not count against your quota.

Usage

toa_sports(all_sports = TRUE)

Arguments

all_sports

(Logical, optional): If TRUE, returns all sports (including out-of-season). If FALSE, returns only in-season sports. Defaults to TRUE.

Value

A tibble of the sports for which The Odds API provides coverage:

col_nametypesdescription
keycharacterSport key, e.g. americanfootball_nfl. Use as sport_key elsewhere.
groupcharacterSport group / category, e.g. American Football.
titlecharacterHuman-readable sport title, e.g. NFL.
descriptioncharacterDescription of the sport or competition.
activelogicalTRUE if the sport is currently in season.
has_outrightslogicalTRUE if the sport offers outright (futures) markets.

See also

toa_sports_events() to list upcoming events for a sport, toa_sports_scores() for live/recent scores, and toa_sports_odds() to pull featured-market odds. Part of the SportsDataverse.

Other The Odds API: Sports & Events: toa_sports_events(), toa_sports_participants(), toa_sports_scores()

Examples

# \donttest{
  try(toa_sports(all_sports = TRUE))
#> ── Sports coverage data from the-odds-api.com ──────── oddsapiR 1.0.0 ──
#>  Data updated: 2026-06-24 03:15:40 UTC
#>  Odds API quota: 2426 used, 17574 remaining (last call cost 0)
#> # A tibble: 170 × 6
#>    key                      group title description active has_outrights
#>    <chr>                    <chr> <chr> <chr>       <lgl>  <lgl>        
#>  1 americanfootball_cfl     Amer… CFL   Canadian F… TRUE   FALSE        
#>  2 americanfootball_ncaaf   Amer… NCAAF US College… TRUE   FALSE        
#>  3 americanfootball_ncaaf_… Amer… NCAA… US College… TRUE   TRUE         
#>  4 americanfootball_nfl     Amer… NFL   US Football TRUE   FALSE        
#>  5 americanfootball_nfl_pr… Amer… NFL … US Football TRUE   FALSE        
#>  6 americanfootball_nfl_su… Amer… NFL … Super Bowl… TRUE   TRUE         
#>  7 americanfootball_ufl     Amer… UFL   United Foo… FALSE  FALSE        
#>  8 aussierules_afl          Auss… AFL   Aussie Foo… TRUE   FALSE        
#>  9 baseball_kbo             Base… KBO   KBO League  TRUE   FALSE        
#> 10 baseball_milb            Base… MiLB  Minor Leag… FALSE  FALSE        
#> # ℹ 160 more rows
# }