Package 'betbetter'

Title: Access the Bet Better Open Sports Model API
Description: Retrieves published statistical model estimates for upcoming sporting fixtures from the Bet Better open API, covering Australian rules football, baseball, basketball, American football, ice hockey, association football, tennis and mixed martial arts. For each rated selection the interface returns the model's estimated probability that the selection occurs, together with the decimal odds implied by that probability. No registration or authentication is required. Bookmaker prices are not published by the API and are therefore not available through this package.
Authors: Edward Glush [aut, cre]
Maintainer: Edward Glush <[email protected]>
License: MIT + file LICENSE
Version: 0.1.0
Built: 2026-10-07 09:42:08 UTC
Source: https://github.com/cran/betbetter

Help Index


Feed types recognised by the API

Description

Feed types recognised by the API

Usage

bb_feeds()

Value

A character vector of feed types accepted by bb_picks(). "games" covers match-level markets, "props" covers individual player markets, and "picks" combines both.

Examples

bb_feeds()

League slugs recognised by the API

Description

League slugs recognised by the API

Usage

bb_leagues()

Value

A character vector of league slugs accepted by bb_picks().

Examples

bb_leagues()

Retrieve model estimates for a league

Description

Downloads the model's currently published estimates for upcoming fixtures in one league.

Usage

bb_picks(league, feed = "picks", min_probability = NULL, limit = NULL)

Arguments

league

A league slug; see bb_leagues().

feed

Which markets to retrieve; see bb_feeds(). Defaults to "picks".

min_probability

Optional lower bound, between 0 and 1. Selections the model estimates below this probability are dropped.

limit

Optional maximum number of rows to return.

Details

fair_odds is the break-even price implied by the model's own probability. It is not a bookmaker price, and no bookmaker price is available through this package.

Value

A data frame with one row per rated selection and the columns game, start_time (UTC), market, selection, line, model_probability (a proportion between 0 and 1), fair_odds (decimal odds implied by model_probability), confidence and verdict. A zero-row data frame is returned when the league has no upcoming fixtures, which is normal outside its season. NULL is returned, with a message, if the API cannot be reached.

Examples

afl <- bb_picks("afl", limit = 5)
if (!is.null(afl) && nrow(afl) > 0) {
  afl[, c("game", "selection", "model_probability", "confidence")]
}