git:20260524.918c4af to git:20260719.1748a98

23 added, 1 removed. Audit A to A.

---

name: rbnz-data

- description: Discover and fetch Reserve Bank of New Zealand public statistics datasets through data.govt.nz CKAN and browser-compatible rbnz.govt.nz public file/chart endpoints. Use when the task involves RBNZ exchange rates, wholesale interest rates, OCR/key graphs, retail mortgage/deposit rate charts, dataset metadata, resource URLs, downloadable XLSX series, or JSON chart-cache previews. Read-only; no authentication required.

+ description: "Discover and fetch Reserve Bank of New Zealand public statistics datasets through data.govt.nz CKAN and browser-compatible rbnz.govt.nz public file/chart endpoints. Use when the task involves RBNZ exchange rates, wholesale interest rates, OCR/key graphs, retail mortgage/deposit rate charts, dataset metadata, resource URLs, downloadable XLSX series, or JSON chart-cache previews. Read-only; no authentication required."

+ license: MIT

+ compatibility: "Requires Python 3.10+ and network access for live data"

+ metadata:

+ thecolab.category: "finance"

+ thecolab.source_owner: "Reserve Bank of New Zealand"

+ thecolab.source_type: "official"

+ thecolab.auth: "none"

+ thecolab.access_mode: "public-download"

+ thecolab.data_class: "public"

+ thecolab.writes: "false"

+ thecolab.browser: "false"

+ thecolab.risk: "low"

+ thecolab.cache_ttl: "24h"

+ thecolab.schema_version: "1"

+ thecolab.skill_type: "public-download"

+ thecolab.pack: "nz-public-data"

+ thecolab.source_url: "https://www.rbnz.govt.nz/statistics"

+ thecolab.allowed_domains: "catalogue.data.govt.nz,www.rbnz.govt.nz"

+ thecolab.last_verified: "2026-07-19"

+ thecolab.health: "healthy"

+ thecolab.maintainer: "@adam91holt"

+ thecolab.local_output: "downloaded-source-files"

---

# RBNZ Data

## Goal

Find RBNZ public statistics datasets/resources through the data.govt.nz catalogue, then fetch official rbnz.govt.nz public XLSX/chart endpoints using browser-compatible request headers.

## CLI

```bash

python3 skills/rbnz-data/scripts/cli.py search "interest rates" --json

python3 skills/rbnz-data/scripts/cli.py dataset exchange-rates --json

python3 skills/rbnz-data/scripts/cli.py exchange-rates --limit 3 --json

python3 skills/rbnz-data/scripts/cli.py download exchange-rates --match daily --preview

python3 skills/rbnz-data/scripts/cli.py chart retail-rates --limit 5 --json

```

Commands:

- `search QUERY [--limit N] [--json]` - RBNZ-only data.govt.nz catalogue search

- `dataset ID_OR_NAME [--json]` - package metadata and resource URLs

- `exchange-rates [--limit N] [--json]` - small CKAN datastore preview for the RBNZ exchange-rates resource where available

- `download DATASET [--match TEXT] [--preview] [--output PATH] [--json]` - fetch a matching official RBNZ public XLSX resource and optionally preview worksheet rows

- `chart {twi,retail-rates}` - fetch public RBNZ chart-cache JSON used on the Statistics page

## Resources

- CLI: `scripts/cli.py`

- Smoke test: `scripts/smoke_test.py`

- API notes: `references/api-notes.md`