Skip to contents

Find out your usage and remaining calls for your key from The Odds API

Source: R/toa_requests.R
toa_requests.Rd

Get your usage and remaining calls for your key from The Odds API.

The values are read from the x-requests-remaining and x-requests-used response headers returned with every API call. This check is performed against the free /v4/sports endpoint, so it does not consume any quota.

Usage quota cost: Free.

Usage

toa_requests()

Value

A tibble of The Odds API key usage with the following columns:

col_nametypesdescription
requests_remainingintegerUsage credits remaining until the monthly quota resets.
requests_usedintegerUsage credits consumed since the last quota reset.

See also

toa_quota() to read cached usage from the most recent call without a network round-trip, toa_key() / register_toa to configure your API key, and toa_sports() to start pulling data. Part of the SportsDataverse.

Other The Odds API: Account & Usage: register_toa, toa_quota()

Examples

# \donttest{
  try(toa_requests())
#> ── API Key Usage data from the-odds-api.com ────────── oddsapiR 1.0.0 ──
#> ℹ Data updated: 2026-06-24 03:15:39 UTC
#> ℹ Odds API quota: 2426 used, 17574 remaining (last call cost 0)
#> # A tibble: 1 × 2
#>   requests_remaining requests_used
#>                <int>         <int>
#> 1              17574          2426
# }