Skip to contents

Compute the trade balance (exports minus imports) for a reporter country against each trading partner.

Usage

ct_balance(
  reporter,
  partner = "0",
  year = NULL,
  commodity = "TOTAL",
  cache = TRUE
)

Arguments

reporter

Character. Reporter country ISO3 code.

partner

Character. Partner country code, or "0" for World. Default "0".

year

Integer. Year(s) to query.

commodity

Character. Commodity code. Default "TOTAL".

cache

Logical. Default TRUE.

Value

A data.frame with columns: partner, partner_desc, year, exports, imports, balance.

Examples

# \donttest{
op <- options(comtrade.cache_dir = tempdir())
ct_balance("GBR", year = 2023)
#>  No API key set. Using preview endpoint (500 records max, no descriptions).
#>  For full access (100k records, descriptions), get a free key at
#>   <https://comtradedeveloper.un.org/>
#>  Then run: `ct_set_key("your-key")`
#>   partner partner_desc year      exports      imports       balance
#> 1       0        World 2023 231805144781 582770820322 -350965675541
options(op)
# }