Learn R Programming

RBNZ

The RBNZ package allows users to download data from the Reserve Bank of New Zealand website.

An overview of the package can be found on CRAN or in vignettes/Overview.Rmd.

Installation

## Install from CRAN:
install.packages('RBNZ')

## Install the development version from GitHub:
## install.packages("devtools")
devtools::install_github("rntq472/RBNZ")

Usage

The main entry point is the getSeries function where users can choose a data series to retrieve:


library(RBNZ)

m1 <- getSeries('M1')

Note - the RBNZ website has been put behind Cloudflare so now there are some extra steps for using this package.

One option is to email the RBNZ and request that your (static) public IP address be whitelisted. The email to contact is listed here.

The second option is to download the necessary files from the RBNZ website manually through your browser and then use this package to read and organise them. This can be done by downloading the spreadsheets needed and saving them in a given directory without changing their file names. This could be done from the individual series page or from the summary page.

For example for the B1 series a user could download and save the following spreadsheets:

  • hb1-daily-1973-1998.xlsx
  • hb1-daily-1999-2017.xlsx
  • hb1-daily.xlsx

They could then load the data as follows:


library(RBNZ)

dat <- getSeries('B1', destDir = 'path_to_downloaded_files', cacheOnly = TRUE)

If you are always having to do this then you can specify the download path in your .Rprofile using options(RBNZ.destDir = "path/to/stored/files").

Copy Link

Version

Install

install.packages('RBNZ')

Monthly Downloads

297

Version

3.0.0

License

MIT + file LICENSE

Maintainer

Jasper Watson

Last Published

October 28th, 2025

Functions in RBNZ (3.0.0)

C33

New Residential Mortgage Lending By Purpose
C13

Credit Card Spending
C50

Money and Credit Aggregates (Depository Corporations)
C60

Credit Conditions Survey
D35

Holdings of Kauri Bonds (Nominal Value)
C51

Other Depository Corporations Analytical Accounts
B4

Foreign Exchange Turnover
D12

Standing Facilities
C41

Residential Mortgage Borrower Gross Income (BGI)
D30

Holdings of Central Government Debt Securities
H1

Household Inflation Expectations
C40

Residential Mortgage Lending by Debt-To-Income Purpose Use
C65

Bank Customer Lending Flows
E2

New Zealand's Position with the IMF
F5

Reserve Bank Foreign Currency Assets and Liabilities
C35

Residential Mortgage Loan Reconciliation
C52

Depository Corporations Analytical Accounts
D3

Open Market Operations
M10

Housing
L3

Face Value of Funding by Residual Maturity ($m)
M12

Population and Migration
D10

Influences on Settlement Cash
D9

Government Bond Turnover
C66

Bank Customer Lending Stocks
M4

Domestic Trade
F4

Coin Mintings
M7

Balance of Payments and International Investment Position
D31

Non-Resident Holdings of Individual Bonds (Nominal Value)
S34

Banks: Assets – Loans and Repos by Industry
M14

Survey of Expectations
H3

Cash Use
C70

New Lending By Purpose
E1

New Zealand's Official Overseas Reserves
H2

Housing and Employment
R2

Reserve Bank Statistical Balance Sheet
L1

Mismatch Ratios
F3

Bank Notes in the Hands of the Public
C12

Credit Card Balances
RBNZ

Access Data from the Reserve Bank of New Zealand Website
M9

Labour Market
J10

Insurance: Income Statement
S31

Banks: Assets – Loans by Purpose
M6

National Saving (Year Ended March)
M1

Prices
M5

Gross Domestic Product
C71

New Lending Fully Secured By Residential Mortgage
S33

Banks: Assets – Loans Fully Secured by Residential Mortgage
S41

Banks: Liabilities – Deposits by Industry
R1

Reserve Bank Balance Sheet
C55

Other Financial Corporations Analytical Accounts
R3

Reserve Bank Analytical Accounts
S37

Banks: Assets – Agriculture Loans by Product
SDDS

New Zealand's International Reserves and Foreign Currency Liquidity
T44

Other Registered Superannuation
M8

Overseas Trade
M2

Consumption
S35

Banks: Assets – Loans by Business Size
L2

Core Funding Ratio
S30

Banks: Assets - Loans by Sector
S36

Banks: Assets – Loans by Product
T48

Wholesale Trusts and Other Funds
T43

KiwiSaver
T45

Retail Unit Trusts
M15

Business Expectations Survey
getSeries

Retrieve Data From the Reserve Bank of New Zealand Website
S32

Banks: Assets – Loans by Product
M3

Investment
J20

Insurance: Balance Sheet
S50

Banks: Assets - Loans by Asset Quality
T1

Non Banks: Balance Sheet
readSpreadsheet

Read a Downloaded Spreadsheet
T42

Life Insurance
S21

Banks: Income Statement
T46

Cash Management Trusts
S20

Banks: Summary Income Statement and Related Ratios
T31

Non-Deposit Taking Finance Companies: Balance Sheet
T41

Managed Fund Assets
T4

Non Banks: Funding and Claims by Sector
T21

Deposit Taking Finance Companies: Balance Sheet
T40

Funds Under Management
T47

Wholesale Trusts
allAvailableSeries

List All Data Series Available for Download
S10

Banks: Balance Sheet
T11

Savings Institutions: Balance Sheet
getDownloadLink

Determine the URL for a File to be Downloaded
getSeriesPageURL

Determine the URL of a Webpage Pertaining to a Series
S40

Banks: Liabilities – Deposits by Sector
readSeriesPage

Read a Series Webpage Into an XML object
B21

New Residential Mortgage Special Interest Rates
C30

New Residential Mortgage Lending by Loan-To-Valuation Ratio
B27

New Interest Bearing Term PIE Deposits Interest Rates
B6

Yields on Loans
B26

New Interest Bearing Term Deposit Interest rates
B2

Wholesale Interest Rates
B7

Costs of Deposits
B13

Historical TWI Weights
C21

Key Household Financial Statistics
B25

New Interest Bearing Call Savings Account Interest Rates
C22

Household Balance Sheet
B20

New Residential Mortgage Standard Interest Rates
B1

Exchange Rates and TWI
C31

New Residential Mortgage Lending by Borrower Type
B10

TWI Weights
B3

Retail Interest Rates on Lending and Deposits
C5

Sector Lending
B30

New Residential Mortgage Weighted Average Interest Rates
C32

New and Existing Residential Mortgage Lending by Payment Type