The hardware and bandwidth for this mirror is donated by dogado GmbH, the Webhosting and Full Service-Cloud Provider. Check out our Wordpress Tutorial.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]dogado.de.

oddsapiR 1.0.1

CRAN fix release, addressing the --run-donttest check failure reported on 2026-08-25.

Bug fixes

• Printing an oddsapiR_data tibble no longer errors with “missing value where TRUE/FALSE needed”. The Odds API omits its x-requests-* usage headers on error responses, which stored a zero-length quota value; the print method’s guard then evaluated to NA. Absent or unparseable headers are now recorded as NA_integer_, and the guard is length-safe.
• toa_event_odds() and toa_event_odds_history() no longer report an API error response (an invalid key, say) as “event found, but no bookmaker odds are available yet”. The API’s own error message is surfaced instead, so a failed request is never mistaken for an event with no odds posted.

Infrastructure & tooling

• Examples that call the live API are guarded with @examplesIf has_toa_key(), so they are skipped where no API key is configured rather than making a doomed request.

oddsapiR 1.0.0

First major release. Full coverage of The Odds API v4, an httr2 HTTP stack, and per-request usage-quota reporting.

New features

• Five new endpoint wrappers complete the v4 surface:
  • toa_sports_events() – in-play and upcoming events for a sport (/v4/sports/{sport}/events).
  • toa_event_markets() – available market keys per bookmaker for a single event (/v4/sports/{sport}/events/{eventId}/markets).
  • toa_sports_participants() – teams or players for a sport (/v4/sports/{sport}/participants).
  • toa_sports_events_history() – historical events snapshot (/v4/historical/sports/{sport}/events).
  • toa_event_odds_history() – historical single-event odds (/v4/historical/sports/{sport}/events/{eventId}/odds).
• toa_quota() – new exported accessor returning the usage credits (requests_remaining, requests_used, requests_last) from the most recent call. The same values are attached as attributes to every returned tibble and echoed when an oddsapiR_data object is printed.
• Every wrapper’s @return documentation is now a 3-column table (col_name | types | description) and carries a Usage quota cost note.

Breaking changes

• The HTTP stack migrated from httr to httr2. httr and janitor were removed from Imports; tibble was promoted to Imports.
• toa_sports_odds_history() now calls the current /v4/historical/sports/{sport}/odds endpoint (the legacy /v4/sports/{sport}/odds-history path is deprecated upstream). Its signature changed: date is now the required second argument and event_ids is an optional filter. The return gains leading timestamp, previous_timestamp and next_timestamp columns.

Bug fixes

• toa_event_odds() and toa_event_odds_history() now return a zero-row tibble carrying the documented column schema (with an informative message) when the event exists but its bookmakers array is empty – e.g. no lines posted yet for the requested markets/regions – instead of erroring with a misleading “Invalid arguments” alert (#4).
• Wrappers now initialize their return variable before the tryCatch, so an API error (500/timeout/connection reset) returns an empty tibble and a cli message instead of throwing object '...' not found.
• toa_event_odds() parsing is more robust (builds an explicit tibble rather than as_tibble(data = ".")) and surfaces outcomes_description for player-prop markets.
• Returns are self-describing: toa_sports_participants() echoes sport_key, and the historical wrappers surface the snapshot timestamps.

Test infrastructure

• Tests added for all new functions; legacy tests hardened to gate on has_toa_key(), skip on empty/out-of-season responses, and assert columns subset-direction (expect_in(sort(cols), sort(colnames(x)))) so upstream column additions don’t break the suite.

Infrastructure & tooling

• GitHub Actions workflows modernized for the Node 24 runtime (actions/checkout@v5, r-lib/actions/*@v2, check-r-package, pak-based dependency installs).
• Added project meta files: CLAUDE.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md, .github/copilot-instructions.md, issue templates, and a pull request template.
• README installation now leads with pak (with devtools as an alternative).

oddsapiR 0.0.3

• toa_event_odds() function added
• toa_sports_odds_history() function added

oddsapiR 0.0.2

• Minor under the hood changes for tidyselect deprecation of .data$ masking

oddsapiR 0.0.1

• Added a NEWS.md file to track changes to the package.
• Four core exported functions:
  • toa_sports(): Get the Sports for which the Odds API provides coverage
  • toa_sports_odds(): Get the odds for the sports which the Odds API provides coverage
  • toa_sports_scores(): Get the scores for the sports which the Odds API provides coverage
  • toa_requests(): Get your usage and remaining calls for your key from The Odds API
• Tests added for each of the above functions.

These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.
Health stats visible at Monitor.