Package {oddsapiio}

oddsapiio: Client for the 'Odds-API.io' Sports Betting Odds API

Description

Query live and pre-match sports betting odds from the 'Odds-API.io' REST API https://docs.odds-api.io. Covers sports, bookmakers, leagues, events, per-event odds, value bets and arbitrage bets across 265+ bookmakers, returned as tidy data frames. An API key is required; a free tier is available.

Author(s)

Maintainer: Markus Bjermeland markus@odds-api.io

Authors:

• Markus Bjermeland markus@odds-api.io

See Also

Useful links:

• https://odds-api.io

• https://github.com/odds-api-io/odds-api-r

• Report bugs at https://github.com/odds-api-io/odds-api-r/issues

Get arbitrage bets

Description

Returns arbitrage opportunities across the given bookmakers, including the legs and optimal stake split for each opportunity.

Usage

oa_arbitrage_bets(
  bookmakers,
  limit = NULL,
  include_event_details = FALSE,
  api_key = NULL
)

Arguments

Value

A data frame with one row per arbitrage opportunity. The legs and optimalStakes columns are list-columns of data frames.

Examples

## Not run: 
arbs <- oa_arbitrage_bets(c("Bet365", "SingBet"),
                          include_event_details = TRUE)
arbs[order(-arbs$profitMargin), ]

## End(Not run)

List available bookmakers

Description

Returns the bookmakers covered by 'Odds-API.io'. This endpoint does not require an API key.

Usage

oa_bookmakers(api_key = NULL)

Arguments

Value

A data frame with one row per bookmaker (columns name and active).

Examples

## Not run: 
bookmakers <- oa_bookmakers()
head(bookmakers)

## End(Not run)

List events for a sport

Description

Returns upcoming, live or settled events. When to is omitted the API returns events within the next 14 days, hard-capped at 5000 rows per response; use limit and skip to paginate.

Usage

oa_events(
  sport,
  league = NULL,
  status = NULL,
  from = NULL,
  to = NULL,
  limit = NULL,
  skip = NULL,
  bookmaker = NULL,
  participant_id = NULL,
  api_key = NULL
)

Arguments

Value

A data frame with one row per event.

Examples

## Not run: 
events <- oa_events("football", league = "england-premier-league")
live <- oa_events("football", status = c("pending", "live"))

## End(Not run)

List leagues for a sport

Description

List leagues for a sport

Usage

oa_leagues(sport, api_key = NULL)

Arguments

Value

A data frame with one row per league (columns name, slug and eventsCount).

Examples

## Not run: 
leagues <- oa_leagues("football")
head(leagues)

## End(Not run)

Get odds for an event

Description

Fetches odds for one event from up to 30 bookmakers and returns them as a tidy data frame with one row per price line.

Usage

oa_odds(event_id, bookmakers, api_key = NULL)

Arguments

Value

A data frame with one row per odds line, with columns eventId, bookmaker, market, updatedAt and the price columns present in the response (such as home, draw, away, hdp, over, under).

Examples

## Not run: 
odds <- oa_odds(123456, bookmakers = c("Bet365", "SingBet"))
subset(odds, market == "ML")

## End(Not run)

List available sports

Description

Returns the sports covered by 'Odds-API.io'. This endpoint does not require an API key.

Usage

oa_sports(api_key = NULL)

Arguments

Value

A data frame with one row per sport (columns name and slug).

Examples

## Not run: 
sports <- oa_sports()
head(sports)

## End(Not run)

Get value bets

Description

Returns value betting opportunities for a bookmaker, calculated by comparing its odds against the market consensus.

Usage

oa_value_bets(
  bookmaker,
  sport = NULL,
  league = NULL,
  include_event_details = FALSE,
  api_key = NULL
)

Arguments

Value

A data frame with one row per value bet, including the bet side, expected value and bookmaker odds.

Examples

## Not run: 
vb <- oa_value_bets("Bet365", include_event_details = TRUE)
vb[vb$expectedValue > 0.03, ]

## End(Not run)