Changelog • oddsapiR

oddsapiR 1.0.1

CRAN release: 2026-08-27

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

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.

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.

CRAN release: 2026-08-24

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

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.

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.

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.

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.

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).

CRAN release: 2023-03-19

CRAN release: 2023-01-05

CRAN release: 2022-06-22

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.