Skip to contents

Get OECD government deficit data

Source: R/deficit.R
get_oecd_deficit.Rd

Downloads (and caches) general government net lending/borrowing as a share of GDP for OECD member countries from the OECD National Accounts (NAAG) database.

Usage

get_oecd_deficit(countries = "all", start_year = 1990, refresh = FALSE)

Arguments

countries

Character vector of ISO 3166-1 alpha-3 country codes, or "all" for all available OECD members. Defaults to "all". Run list_oecd_countries() to see available codes.

start_year

Numeric. Earliest year to include. Defaults to 1990.

refresh

Logical. If TRUE, re-download even if a cached copy exists. Defaults to FALSE.

Value

A data frame with columns:

country

ISO 3166-1 alpha-3 country code (character)

country_name

English country name (character)

year

Calendar year (integer)

series

"GOVT_NET_LENDING" (character)

value

Net lending/borrowing as a share of GDP (numeric). Positive = surplus; negative = deficit.

unit

"% of GDP" (character)

Details

Net lending/borrowing is the difference between government revenue and expenditure, expressed as a percentage of GDP. A positive value indicates a surplus (government saving); a negative value indicates a deficit (government borrowing). This is the standard fiscal balance measure used for cross-country comparisons and is consistent with the System of National Accounts (SNA) definition.

See also

Other fiscal: get_oecd_tax()

Examples

# \donttest{
op <- options(readoecd.cache_dir = tempdir())
deficit <- try(get_oecd_deficit(c("AUS", "GBR", "USA"), start_year = 2000))
#> Downloading from OECD API...
#> Error in value[[3L]](cond) : Failed to reach the OECD API.
#> ℹ Check your internet connection and try again.
#> ℹ If the problem persists, the OECD may have changed their API.
#> ℹ Check for a package update or report at
#>   <https://github.com/charlescoverdale/readoecd/issues>
if (!inherits(deficit, "try-error")) head(deficit)
options(op)
# }