How to Get the RBNZ (RBNZ_OCR) Rate

How to Get the RBNZ (RBNZ_OCR) Rate

You need the Reserve Bank of New Zealand’s Official Cash Rate (RBNZ_OCR) inside your app, model, or dashboard, and you want to fetch it reliably via a simple, authenticated REST GET. By the end of this guide, you will be able to retrieve the latest RBNZ_OCR value, query historical and time series data, compute fluctuations and OHLC aggregates, and compare loan interest costs—all via the Interest Rates API endpoints.

What the RBNZ_OCR Represents

RBNZ_OCR is the Reserve Bank of New Zealand’s Official Cash Rate—New Zealand’s key policy rate. It anchors short-term interest rates across the economy, influences wholesale funding costs, and flows into lending, mortgage, and deposit rates. In the Interest Rates API, the RBNZ_OCR is a central bank symbol with currency NZD and a monthly frequency (i.e., values typically change on policy decision days and are represented as monthly data points).

Illustration: How to Get the RBNZ (RBNZ_OCR) Rate

Developers use this benchmark to price loans, stress test funding costs, analyze monetary policy transmission, and build analytics such as policy-rate monitors and rate-sensitive P&L drivers.

How the API Expresses RBNZ_OCR Values

All endpoints return numeric rates as percentage values (for example, 2.75 means 2.75%). Effective dates are expressed as ISO 8601 dates (Y-m-d). For monthly symbols like RBNZ_OCR, “the last day with data within that month” applies on historical lookups. In practice, this means you should:

  • Interpret the number as percent per annum.
  • Use the date fields to align your models (for example, set an effective window from the previous policy date to the next).
  • Cache stable monthly values; you often do not need to re-query within the same calendar day unless you expect an update event.

Getting Started: One-Line Latest Fetch for RBNZ_OCR

The following is the official example to fetch the latest RBNZ_OCR value. Authentication uses the api_key query parameter, and all methods are GET.

curl -s "https://interestratesapi.com/api/v1/latest?api_key=YOUR_API_KEY&symbols=RBNZ_OCR"
{
    "success": true,
    "date": "2026-10-31",
    "base": "NZD",
    "rates": {
        "RBNZ_OCR": 2.75
    },
    "dates": {
        "RBNZ_OCR": "2026-10-31"
    },
    "currencies": {
        "RBNZ_OCR": "NZD"
    },
    "base_filter_note": null
}

How to read this:

  • rates.RBNZ_OCR is expressed in percent (2.75 means 2.75%).
  • dates.RBNZ_OCR shows the effective date for that value.
  • currencies.RBNZ_OCR is NZD, the rate’s currency context.
  • date is the API response’s anchor date, which for monthly series represents the last date with data in that month.

Explore more at interestratesapi.com. When you’re ready to build, use Register to obtain your API key and start integrating.

Data Model and Integration Notes

Key response maps include:

  • rates: symbol-to-value mapping (percentage values).
  • dates: symbol-to-effective-date mapping for each returned symbol.
  • currencies: symbol-to-currency mapping.

Business days and publication cadence: RBNZ_OCR is monthly in this API. Values are stable between policy updates and are available as a time series. The endpoints can be queried any day; for monthly data, you should not expect a new value every calendar day. For cost efficiency, cache successful responses until you expect a change (for example, a policy meeting day) or until your app’s refresh interval elapses.

Error handling: watch for structured errors (success=false, error=message). Rate limiting is indicated by X-RateLimit-* headers and HTTP 429. Always use GET requests with the api_key query parameter.

1) Catalogue: Find and Validate RBNZ_OCR With /symbols

Use this to confirm symbol metadata or to search by category/currency. RBNZ_OCR is a central_bank symbol in NZD with monthly frequency.

cURL

Note: The example filters USD central bank symbols. To explore NZD, set base=NZD or omit filters. The response schema looks like:

Python (requests)

import requests

resp = requests.get(
"https://interestratesapi.com/api/v1/symbols",
params=dict(category="central_bank", base="NZD", api_key="YOUR_KEY")
)
symbols = resp.json()

JavaScript (fetch)

const response = await fetch(
"https://interestratesapi.com/api/v1/symbols?category=central_bank&base=NZD&api_key=YOUR_KEY"
);
const data = await response.json();

PHP

<?php
$url = "https://interestratesapi.com/api/v1/symbols?category=central_bank&base=NZD&api_key=YOUR_KEY";
$json = file_get_contents($url);
$data = json_decode($json, true);
?>

Use symbols to validate that RBNZ_OCR is available and to read its frequency and description. See also the MCP for more schema details.

2) Latest: Fetch the Current RBNZ_OCR With /latest

Use this when you need the current official cash rate for pricing, dashboards, or triggers. The official cURL and JSON above are the authoritative sample for RBNZ_OCR.

cURL (official)

Python (requests)

import requests

response = requests.get(
"https://interestratesapi.com/api/v1/latest",
params=dict(symbols="RBNZ_OCR", api_key="YOUR_API_KEY")
)
data = response.json()
ocr = data["rates"]["RBNZ_OCR"]
effective_date = data["dates"]["RBNZ_OCR"]
currency = data["currencies"]["RBNZ_OCR"]

JavaScript (fetch)

const response = await fetch(
"https://interestratesapi.com/api/v1/latest?symbols=RBNZ_OCR&api_key=YOUR_API_KEY"
);
const data = await response.json();
const ocr = data.rates.RBNZ_OCR;
const effectiveDate = data.dates.RBNZ_OCR;
const currency = data.currencies.RBNZ_OCR;

PHP

<?php
$url = "https://interestratesapi.com/api/v1/latest?symbols=RBNZ_OCR&api_key=YOUR_API_KEY";
$json = file_get_contents($url);
$data = json_decode($json, true);
$ocr = $data["rates"]["RBNZ_OCR"];
$effectiveDate = $data["dates"]["RBNZ_OCR"];
$currency = $data["currencies"]["RBNZ_OCR"];
?>

Tip: cache the latest RBNZ_OCR value for your app’s refresh interval; monthly policy rates change infrequently relative to interbank benchmarks.

3) Historical: Point-in-Time Lookups With /historical

Use this endpoint to obtain the value on a specific date. For monthly symbols, the last day with data within that month is used if you pass any date in that month.

cURL

Sample JSON

Notes:

  • The value is in percent; interpret it as the month’s applicable OCR if you selected a mid-month date.
  • Handle 404 responses if the chosen date precedes available coverage; the error may include details with available ranges.

Python (requests)

import requests

resp = requests.get(
"https://interestratesapi.com/api/v1/historical",
params=dict(date="2025-06-15", symbols="RBNZ_OCR", api_key="YOUR_KEY")
)
data = resp.json()

JavaScript (fetch)

const res = await fetch(
"https://interestratesapi.com/api/v1/historical?date=2025-06-15&symbols=RBNZ_OCR&api_key=YOUR_KEY"
);
const hist = await res.json();

PHP

<?php
$url = "https://interestratesapi.com/api/v1/historical?date=2025-06-15&symbols=RBNZ_OCR&api_key=YOUR_KEY";
$json = file_get_contents($url);
$hist = json_decode($json, true);
?>

4) Time Series: Build Panels and Models With /timeseries

Use this to retrieve a series between start and end dates. For RBNZ_OCR (monthly), you may receive repeated values across business days within a month. The API consolidates the series over your requested window.

cURL

Sample JSON

Interpretation tips:

  • Use the map under rates.RBNZ_OCR to plot or compute metrics.
  • If you need month-end aggregates, see /ohlc below for computed OHLC buckets.

Python (requests)

import requests

r = requests.get(
"https://interestratesapi.com/api/v1/timeseries",
params=dict(start="2025-11-14", end="2026-11-14", symbols="RBNZ_OCR", api_key="YOUR_KEY")
)
series = r.json()

JavaScript (fetch)

const resp = await fetch(
"https://interestratesapi.com/api/v1/timeseries?start=2025-11-14&end=2026-11-14&symbols=RBNZ_OCR&api_key=YOUR_KEY"
);
const ts = await resp.json();

PHP

<?php
$u = "https://interestratesapi.com/api/v1/timeseries?start=2025-11-14&end=2026-11-14&symbols=RBNZ_OCR&api_key=YOUR_KEY";
$j = file_get_contents($u);
$ts = json_decode($j, true);
?>

5) Fluctuation: Calculate Changes With /fluctuation

Fluctuation gives you start_value, end_value, absolute change, pct change, and high/low for a date range. This is useful for policy-change detection, alerting, and reporting.

cURL

Sample JSON

Use change_pct to normalize moves across regimes; use high/low for worst-case scenarios (e.g., margin tests in lending models).

Python (requests)

import requests

fx = requests.get(
"https://interestratesapi.com/api/v1/fluctuation",
params=dict(start="2025-11-14", end="2026-11-14", symbols="RBNZ_OCR", api_key="YOUR_KEY")
).json()

JavaScript (fetch)

const f = await fetch(
"https://interestratesapi.com/api/v1/fluctuation?start=2025-11-14&end=2026-11-14&symbols=RBNZ_OCR&api_key=YOUR_KEY"
);
const fluct = await f.json();

PHP

<?php
$url = "https://interestratesapi.com/api/v1/fluctuation?start=2025-11-14&end=2026-11-14&symbols=RBNZ_OCR&api_key=YOUR_KEY";
$json = file_get_contents($url);
$fluct = json_decode($json, true);
?>

6) OHLC: Monthly Buckets for Charting With /ohlc

OHLC turns daily data into candlestick-style aggregates (open, high, low, close) for the requested period. For RBNZ_OCR, monthly OHLC is typically flat within months unless a policy change occurs during that month.

cURL

Sample JSON

Fields:

  • open/high/low/close: computed from the daily series in the bucket.
  • data_points: how many daily observations fed the aggregate.

Python (requests)

import requests

ohlc = requests.get(
"https://interestratesapi.com/api/v1/ohlc",
params=dict(symbols="RBNZ_OCR", period="monthly", start="2025-11-14", end="2026-11-14", api_key="YOUR_KEY")
).json()

JavaScript (fetch)

const o = await fetch(
"https://interestratesapi.com/api/v1/ohlc?symbols=RBNZ_OCR&period=monthly&start=2025-11-14&end=2026-11-14&api_key=YOUR_KEY"
);
const ohlcData = await o.json();

PHP

<?php
$u = "https://interestratesapi.com/api/v1/ohlc?symbols=RBNZ_OCR&period=monthly&start=2025-11-14&end=2026-11-14&api_key=YOUR_KEY";
$j = file_get_contents($u);
$ohlc = json_decode($j, true);
?>

7) Convert: Compare Loan Interest Costs With /convert

The convert endpoint compares the total interest cost of a simple loan based on the latest rate of two symbols. Use this to compute spreads and interest savings when pricing against a benchmark. Although your focus is RBNZ_OCR, you can compare it with another central bank policy rate for loan-cost deltas.

cURL

Sample JSON

Key fields:

  • from/to.rate: latest percent rate for each symbol.
  • total_interest/total_payment: simple interest comparison for the chosen amount and term_months.
  • difference.rate_spread: absolute spread in percentage points.

Python (requests)

import requests

cmp = requests.get(
"https://interestratesapi.com/api/v1/convert",
params=dict(from="RBNZ_OCR", to="ECB_MRO", amount=100000, term_months=12, api_key="YOUR_KEY")
).json()

JavaScript (fetch)

const c = await fetch(
"https://interestratesapi.com/api/v1/convert?from=RBNZ_OCR&to=ECB_MRO&amount=100000&term_months=12&api_key=YOUR_KEY"
);
const comparison = await c.json();

PHP

<?php
$u = "https://interestratesapi.com/api/v1/convert?from=RBNZ_OCR&to=ECB_MRO&amount=100000&term_months=12&api_key=YOUR_KEY";
$j = file_get_contents($u);
$cmp = json_decode($j, true);
?>

Computations: Spreads and Payments Using RBNZ_OCR

Use cases often require combining the returned RBNZ_OCR with other figures—margins, fees, or alternative benchmarks. Here is how to compute common quantities without inserting any specific numbers:

  • Spread versus another benchmark (e.g., ECB_MRO): spread_pp = ocr_rate - other_rate. Both inputs are in percentage points.
  • Monthly interest payment on a simple, interest-only loan: monthly_interest = principal × (ocr_rate / 100) ÷ 12.
  • Total interest over N months (simple interest): total_interest = principal × (ocr_rate / 100) × (N ÷ 12).
  • If you need amortizing payments, use the standard annuity formula with the monthly rate r = (ocr_rate / 100) ÷ 12, payment = P × r ÷ (1 - (1 + r)^(-N)).

For production systems, ensure consistent rounding and currency formatting, and make your rate-to-decimal conversion explicit to avoid unit mistakes. Also remember that policy rates may not equal actual lending rates; apply your margin or product pricing logic on top.

Caching, Business Days, and Reliability

RBNZ_OCR is monthly in this API. You can safely cache successful GET responses for at least several minutes to hours depending on your UX and SLA. If you operate an intraday dashboard, a refresh cadence of 1–4 hours is common for policy rates; on meeting days, increase polling frequency if you need near-real-time updates.

Time zones: Dates are returned as Y-m-d. If your application spans regions, anchor to UTC dates when storing and comparing periods. Ensure you check the dates map per symbol, as it explicitly states the effective date for each rate.

Errors and quotas: Handle 401/403 for auth/plan issues, 404 for missing symbols or date coverage, 422 for validation, and 429 for rate limits. Respect Retry-After and the X-RateLimit-* headers. All requests must use GET and include the api_key query parameter.

Real-World Use Cases for RBNZ_OCR

  • Interest rate dashboards: display current RBNZ_OCR, prior change, next decision window, and chart monthly OHLC.
  • Lending and mortgage platforms: compute priced products as OCR + margin; alert users when OCR moves by more than X bps.
  • Treasury and ALM: simulate funding costs under OCR scenarios; compute VaR/earnings-at-risk sensitivity to OCR shifts.
  • Macro research: backtest policy-rate regimes; correlate OCR phases with domestic loan growth or FX dynamics.
  • Fintech analytics: trigger notifications when /fluctuation change_pct exceeds a threshold; visualize /timeseries for client reporting.

Build and test these workflows with the endpoints above. Find more resources at interestratesapi.com and the MCP.

Endpoint-by-Endpoint Troubleshooting Tips

  • /symbols: If you do not see RBNZ_OCR when filtering, remove filters or query by category=central_bank only. Confirm spelling of the symbol.
  • /latest: Always include symbols=RBNZ_OCR and the api_key parameter. If rates is empty, inspect error and dates.
  • /historical: For monthly series, pass a date within the target month; the API uses the last day with data in that month. Expect 404 if the month is outside coverage.
  • /timeseries: Ensure start ≤ end and both are Y-m-d. If you need month buckets, prefer /ohlc with period=monthly to reduce client-side processing.
  • /fluctuation: If start_value is 0, change_pct may be null by design; use absolute change in that case.
  • /ohlc: OHLC is computed on the fly; if your charts need performance, cache these aggregates.
  • /convert: Validate amount ≥ 0 and term_months in [1, 360]. The comparison uses latest rates only; if you need a backtest, compute it from /historical or /timeseries.

FAQ

Q: Are RBNZ_OCR values returned as decimals or percentages?
A: Percentages. For example, 2.75 means 2.75% per annum. Convert to decimals in your formulas by dividing by 100.

Q: How should I interpret dates for monthly series like RBNZ_OCR?
A: The API provides dates as Y-m-d. For /historical, any date in a month returns the last day with data in that month. Use dates.RBNZ_OCR to align effective periods in your models.

Q: How often should I refresh RBNZ_OCR?
A: It’s a monthly series that updates on policy events. For most apps, hourly or daily refresh is sufficient; increase polling on meeting days if you need faster updates.

Q: What’s the fastest way to compute a loan payment from RBNZ_OCR?
A: Convert the returned percent to a monthly rate r = (ocr / 100) ÷ 12. For interest-only loans, monthly_interest = principal × r. For amortizing loans, use the standard annuity formula: payment = P × r ÷ (1 - (1 + r)^(-N)).

Q: Do I need headers for authentication?
A: No. Authentication is via the api_key query parameter on every GET request (e.g., ?api_key=YOUR_API_KEY).

Ship your integration today. Retrieve the RBNZ_OCR via a single GET and scale to historical analysis, fluctuation stats, OHLC aggregates, and loan comparisons using the endpoints above. Register for an API key and explore endpoint details in the MCP.

Ready to get started?

Get your API key and start validating bank data in minutes.

Get API Key