bb_picks: Retrieve model estimates for a league

In betbetter: Access the Bet Better Open Sports Model API

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")]
}

betbetter documentation built on Oct. 6, 2026, 5:07 p.m.