Skip to content

Reference

Macro Education

FXMacroData vs Stats NZ API: New Zealand CPI, GDP and Labour Data for NZD Traders

A buyer-guide comparison of Stats NZ (Aotearoa Data Explorer API, Infoshare, and release files) and FXMacroData for FX traders and developers who need New Zealand CPI, GDP, and labour data for NZD/USD and RBNZ analysis.

Share article X LinkedIn Email
Pip, the FXMacroData robot mascot, carries a single glowing quarterly report card across a small wooden footbridge at dawn, with soft green hills silhouetted behind.
Stats NZ is the official source for New Zealand data. FXMacroData records the same 10:45 releases with second-level UTC timestamps alongside 21 other currencies.

This comparison is for FX traders, quant developers, and analysts who need New Zealand macro data in code and are deciding whether to work directly with Stats NZ (Tatauranga Aotearoa) or use FXMacroData. New Zealand CPI, GDP, and labour-market releases move NZD/USD and shape what markets expect from the Reserve Bank of New Zealand, so the choice matters for anyone who trades or models the kiwi.

The core finding: Stats NZ is the official, free source of record for New Zealand statistics, licensed under Creative Commons Attribution 4.0, with full detail and downloadable release files. Its developer route is in transition, though. The Aotearoa Data Explorer (ADE) SDMX API needs a free subscription key, and Stats NZ plans to move the economic time series still held in Infoshare, including GDP and price indexes, into ADE in 2027. FXMacroData reads the same official releases and delivers them as FX-ready rows: second-level announcement timestamps, one schema across 22 currencies, a cross-country release calendar, pair dashboards, and MCP access for AI assistants.

Quick answer

Use Stats NZ when you need official New Zealand detail: every CPI basket group and region, the monthly selected price indexes, revisions, and release spreadsheets at no cost. Use FXMacroData when New Zealand data is one input into a multi-currency FX workflow that needs exact release times, consistent JSON across countries, a calendar, and agent-ready access through one API key.

Choose Stats NZ when

You need the official source, full component and regional breakdowns, monthly price indicators, or census and population data for New Zealand only.

Choose FXMacroData when

You trade NZD/USD or NZD crosses and want New Zealand releases beside USD, AUD, EUR, JPY and 17 other currencies in one schema, with second-level timing.

Entry access

Stats NZ: free; the ADE API needs a free subscription key.* FXMacroData: Always Free USD tier; NZD data on Individual at $50/month (14-day trial) or Business at $250/month for teams.

Takeaway: this is not official versus unofficial data. It is raw official access versus an FX-ready layer built on the same releases.

* Stats NZ access terms retrieved from its public API Portal, Aotearoa Data Explorer API user guide, and copyright pages in October 2026.

Pricing And Access

Price is not a like-for-like commercial comparison. Stats NZ publishes its data as a public service and lists no paid tier. The Aotearoa Data Explorer API is free, but you must register on the Stats NZ API Portal, subscribe to the ADE API product, and send the key in an Ocp-Apim-Subscription-Key header; the user guide says calls without a key return HTTP 401. The portal explains that sign-up exists to ensure fair use, and asks organisations not to share one key between people, warning that shared keys are likely to be throttled.

FXMacroData is a paid workflow product. The Always Free tier needs no key and covers USD data only, at 100 requests per day with USD announcements delayed 15 minutes. NZD data starts on the Individual plan at $50/month or $500/year, with a 14-day trial, 1,000,000 requests per month, and bursts of 300 per minute. The Business plan at $250/month or $2,500/year covers companies and teams of up to 10 people with the same allowance and priority support. Redistribution to your own users is a self-serve add-on at $10/month per block of up to 100 measured users.

Stats NZ (ADE API)

Free, key required*

SDMX 2.1 REST API with XML, JSON, and CSV output. Release files on stats.govt.nz. CC BY 4.0 with attribution.

FXMacroData Individual

$50/month

22 currencies, 700+ series, release calendar, FX rates, COT, yields, MCP. 1,000,000 requests/month, 14-day trial.

FXMacroData Business

$250/month

Same data and allowance for companies and teams of up to 10 people, with company checkout and priority support.

Takeaway: if New Zealand is the only country you need and you are happy to build and maintain the plumbing, Stats NZ costs nothing; FXMacroData's price buys cross-currency normalisation and release timing.

* Stats NZ access terms retrieved from its public API Portal and Aotearoa Data Explorer API user guide in October 2026. No paid tier or numeric rate limit is published.

Side-By-Side Comparison

Attribute Stats NZ (ADE API, Infoshare, release files) FXMacroData
Core job Official producer and publisher of New Zealand statistics, with browser tools, an SDMX API, and release downloads. FX macro data API and dashboards built on official releases across 22 currencies.
Entry pricing Free; no paid tier listed.* $50/month Individual, $250/month Business.
Free tier Entire service is free; the ADE API needs a free API Portal subscription key.* Always Free USD tier, no key, 100 requests/day, USD announcements delayed 15 minutes.
Coverage New Zealand only, with full detail. Headline economic time series (GDP, price indexes) are scheduled to move from Infoshare into ADE in 2027.* 22 currencies and 700+ indicator series; NZD includes CPI, GDP, unemployment and employment, wages, retail sales, trade, dairy exports, the OCR, and yields.
Release timing Releases scheduled at 10:45 a.m. New Zealand time, which is 21:45 or 22:45 UTC on the previous day.* Quarterly CPI; monthly CPI planned from July 2027.* Second-level announcement_datetime on every row; typically available within seconds of official publication, measured publicly.
API format SDMX 2.1 REST with dataflow IDs and dimension keys; XML by default, JSON and CSV on request.* REST JSON with OpenAPI, X-API-Key header auth, SSE streaming, GraphQL, Python and JavaScript SDKs.
Rate limits No numeric limit published; fair-use sign-up, and shared keys are likely to be throttled.* 1,000,000 requests/month; bursts of 300/min, 5,000/hour, 20 concurrent.
History Long official history (the CPI index series start in 1914), with revisions in each release. Release history with prior values and announcement times, in one schema across countries.
AI and MCP No MCP server found in the reviewed developer pages. Official MCP server for Claude, ChatGPT, Cursor, and other clients.
Licence for programmatic and commercial use Creative Commons Attribution 4.0 International: copy, distribute, and adapt with attribution; logos excluded.* Personal and internal use on Individual, team use on Business; redistribution via a self-serve add-on.
Best fit New Zealand economists, researchers, and data teams who need full official detail. FX traders and developers who need NZD beside other currencies, with timing and pair context.

* Stats NZ terms, release times, and roadmap retrieved from its public API Portal, ADE API user guide, release calendar, Infoshare transition, monthly CPI, and copyright pages in October 2026.

What The Official CPI Data Shows

The chart below is built from the official index-number file published with the New Zealand CPI release for the June 2026 quarter. It uses the all-groups CPI for New Zealand: annual change is the index against the same quarter a year earlier, and quarterly change is against the previous quarter. Annual inflation of 4.1 percent in the June 2026 quarter matches the headline Stats NZ published on 21 July 2026.

New Zealand CPI: annual and quarterly change, Sep 2024 to Jun 2026 quarters

Computed from the all-groups CPI index for New Zealand, not seasonally adjusted. Hover for values.

Takeaway: annual inflation rose from 2.2% to 4.1% over two years, with a 1.5% jump in the June 2026 quarter alone, and it now sits above the Reserve Bank's 1 to 3 percent target band, the kind of shift that reprices the Official Cash Rate path and the New Zealand dollar.

Source: Stats NZ, Consumers price index: June 2026 quarter, index numbers (series CPIQ.SE9A, CPI All Groups for New Zealand), retrieved October 2026. This work is based on Stats NZ's data which are licensed by Stats NZ for reuse under the Creative Commons Attribution 4.0 International licence.

Note the FX nuance in that chart: New Zealand still measures headline CPI only quarterly. Between those prints, Stats NZ publishes monthly selected price indexes covering food, rents, fuel, airfares and other items, which economists use to nowcast the quarter. Stats NZ has announced a full monthly CPI, with transitional reports in May and June 2027 and the first official monthly release on 29 July 2027, published alongside the quarterly CPI rather than replacing it. Until then, each quarterly CPI print carries three months of information, which is why it can move NZD/USD sharply.

Coverage And Depth

Stats NZ's catalogue is far deeper on New Zealand than any FX data product. The CPI release alone carries basket groups, regional indexes, tradable and non-tradable splits, and average prices for individual items. If your question is about Canterbury prices or regional rents, Stats NZ is the right place, and FXMacroData will not replace it.

The developer route is the complication in 2026. When we listed the ADE API catalogue, its 911 dataflows were dominated by census, population, and business tables; the headline quarterly CPI, GDP, and labour-market time series were not yet in it. Stats NZ says it plans to replace Infoshare, its older time-series tool, with an ADE Time Series Expansion in 2027, migrating economic series such as GDP and price indexes, and to decommission Infoshare once customers can reliably find that data in ADE. Today, a developer who wants headline releases typically works from Infoshare or the CSV and Excel files attached to each release, and should plan for identifiers and table names to change during the migration.

FXMacroData's coverage is designed the other way round: narrower per country, wider across countries. For NZD it carries the series an FX desk watches: quarterly CPI and the RBNZ's sectoral factor model core measure, GDP, the unemployment rate, employment and participation, wages, retail sales, trade, dairy exports, bond yields, and the Official Cash Rate. The OCR is set by the Reserve Bank rather than Stats NZ, which shows the joining work FXMacroData does: NZD rows from two official publishers arrive in one format. For the central-bank side, see our Reserve Bank of New Zealand guide, and for the full NZD inventory, the NZD data coverage guide.

Release Timing And Timestamps

Stats NZ publishes on a fixed, well-signalled schedule. Its release calendar lists the time of each release, and the market-moving economic releases are published at 10:45 a.m. New Zealand time. The June 2026 quarter CPI was published on 21 July 2026, labour market statistics on 5 August, and GDP on 17 September, all at 10:45. The September 2026 quarter CPI is scheduled for 22 October 2026, also at 10:45.

That local time matters for FX. New Zealand switches between NZST (UTC+12) and NZDT (UTC+13), so a 10:45 release is 22:45 UTC on the previous calendar day in the southern winter and 21:45 UTC in summer. It lands after the US cash close and before Tokyo opens, when NZD liquidity is thin, and a trading system has to handle New Zealand's daylight-saving shifts as well as the opposite-season US and European ones.

FXMacroData reads the same official release and stores an announcement_datetime in epoch seconds for every row, in the same field across all 22 currencies. Releases are typically available within seconds of official publication, against a target of one second, and the measured record is published at /release-speed, including the share of releases inside one second by source and every release that took longer.

A New Zealand CPI morning, two ways

Before 10:45 NZT

Stats NZ's release calendar shows the slot. FXMacroData's release calendar lists the NZD event beside US, Australian, and Japanese data due the same day.

10:45 NZT publication

Stats NZ publishes the release page and files. Your own client watches for them and parses the index; FXMacroData records the release with its second-level timestamp.

Seconds later

FXMacroData row available over REST and SSE streaming, with prior value and source metadata attached.

Analysis

Join the print to NZD/USD price action, the OCR path, and yields in UTC, without converting NZST or NZDT strings.

Takeaway: both routes start from the same 10:45 publication; FXMacroData removes the file watching, time-zone handling, and cross-country joining from your code.

API Design And Developer Experience

The ADE API is a standards-based SDMX 2.1 service built on the .Stat Suite platform. Requests follow the pattern /rest/data/{agency},{dataflowID},{version}/{key}, where the key selects codes from each dimension, separated by dots, with plus signs joining codes in the same dimension. Output is XML by default, with JSON and CSV on request, and the browser explorer generates query URLs for you. If you already use SDMX from other agencies, ADE will feel familiar; if not, dataflow IDs and dimension keys take some learning.

FXMacroData uses named routes instead. The same indicator name works across countries, so switching from New Zealand to US inflation is a change of currency code, not a new lookup. An NZD CPI request looks like this:

curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/announcements/nzd/inflation"

Same June 2026 quarter CPI release, two shapes

Stats NZ index-number file (row)

{
  "Series_reference": "CPIQ.SE9A",
  "Period": "2026.06",
  "Data_value": 1359,
  "UNITS": "Index",
  "Series_title_1": "All groups"
}

Shown as JSON for readability. Index level; annual rate computed by you. Release time comes from the calendar, in New Zealand time.

FXMacroData row (illustrative, abridged)

{
  "date": "2026-04-01",
  "val": 4.1,
  "prior": 3.1,
  "announcement_datetime": 1784587500
}

Annual rate with prior value; epoch-second timestamp (20 July 2026, 22:45:00 UTC).

Takeaway: Stats NZ gives you the official index exactly as published; FXMacroData gives you the number the FX market reacts to, timed to the second, in a shape shared by every currency.

Rate Limits And Availability

Stats NZ does not publish a numeric request limit for the ADE API. The portal frames the key requirement as fair use and warns that shared keys are likely to be throttled, and the user guide says uninterrupted service cannot be guaranteed. That is a reasonable posture for a free public service, but it leaves a trading application without a documented throughput figure to design against.

FXMacroData's limits are 1,000,000 requests per month on Individual and Business, with bursts of 300 per minute, 5,000 per hour, and 20 concurrent requests. Because new releases can be pushed over SSE streaming, an FX application does not need to poll at all to catch the 10:45 print.

Licensing And Redistribution

This is a genuine Stats NZ strength. Unless stated otherwise, Stats NZ content is licensed under Creative Commons Attribution 4.0 International: you may copy, distribute, and adapt the data, including commercially, provided you attribute Stats NZ. Photos, graphics, and logos are excluded. For a team publishing New Zealand statistics to clients, that is a clear and permissive basis.

FXMacroData's Individual plan covers a trader's or analyst's own research, dashboards, and scripts; Business covers internal team use. If you show FXMacroData data to your own users, the Commercial Redistribution add-on is $10/month per block of up to 100 measured users or 1,000 public-feed followers, and it is self-serve.

Where Stats NZ Is Genuinely Stronger

Source of record

The agency that produces the numbers. For audit, citation, and official reporting, nothing ranks above it.

Full detail

Every CPI group, region, and item price, plus census, population, and business data in ADE.

Monthly price signals

Selected price indexes give monthly readings between quarterly CPI prints; a full monthly CPI is planned from July 2027.

Free and open

No cost and a CC BY 4.0 licence that allows commercial reuse with attribution.

Takeaway: for New Zealand-only research, nowcasting from monthly price indexes, or a New Zealand statistics warehouse, Stats NZ is the better tool.

Where FXMacroData Is Stronger

The gap opens as soon as New Zealand is one of several countries in your model. NZD/USD reacts to New Zealand data and to US CPI, Non-Farm Payrolls, and Federal Reserve decisions, while AUD/USD and the AUD/NZD cross pull in Australian releases. With Stats NZ alone you would add the BLS, the Australian Bureau of Statistics, and the RBNZ as separate integrations, each with its own identifiers and time formats. With FXMacroData those rows share one schema and one timestamp field.

Around the releases, FXMacroData adds the context an FX desk uses: the cross-country release calendar, FX spot rates, CFTC positioning for New Zealand dollar futures, government bond yields, commodities, central-bank press releases, pair dashboards, exports, and widgets. The MCP server lets Claude, ChatGPT, or Cursor query the same records directly, so an assistant can answer "what did New Zealand CPI do this quarter and how did NZD/USD respond" with sourced rows rather than a web search.

Stats NZ tradeoffs

  • New Zealand only; other countries need other integrations.
  • Headline economic series mid-migration from Infoshare to ADE.
  • Release times in local NZST or NZDT, no per-row timestamp.
  • No published rate limit, FX pair context, or MCP server found.

FXMacroData strengths

  • One schema across 22 currencies.
  • Second-level announcement timestamps, measured publicly.
  • Calendar, FX rates, COT, yields, and commodities in one key.
  • REST, SSE, GraphQL, SDKs, and MCP.

FXMacroData tradeoffs

  • Not the original publisher of New Zealand statistics.
  • Carries FX-relevant series, not every table and breakdown.
  • No monthly selected price indexes; NZD CPI is quarterly.
  • NZD data requires a paid plan.

Takeaway: FXMacroData trades away depth on one country for speed, consistency, and context across all of them.

Decision Matrix

Reader Better fit Why
New Zealand economist or academic researcher Stats NZ Full official detail, revisions, and metadata matter more than FX packaging.
Analyst nowcasting quarterly CPI Stats NZ Monthly selected price indexes and item-level prices are only available from the source.
NZD/USD or AUD/NZD discretionary trader FXMacroData Calendar, pair dashboard, and New Zealand, Australian, and US releases side by side.
Quant backtesting NZD release reactions FXMacroData Epoch-second announcement times and prior values for no-lookahead event studies across currencies.
AI or automation builder FXMacroData MCP and named REST routes avoid a custom SDMX and file-parsing layer during the ADE migration.
Fintech publishing New Zealand stats to clients Depends Stats NZ plus CC BY 4.0 for New Zealand only; FXMacroData's redistribution add-on for multi-country feeds.

Recommendation

Choose Stats NZ if your work is about New Zealand itself: deep breakdowns, monthly price indicators, official citation, or a New Zealand data warehouse. It is free, openly licensed, and the source FXMacroData itself relies on for New Zealand statistics. If you build on it in code, budget time for the Infoshare-to-ADE migration in 2027 and for the monthly CPI arriving the same year.

Choose FXMacroData if New Zealand data is an input to FX decisions. You get NZD releases with second-level timing next to the US, Australian, and other data that moves NZD/USD and the crosses, without maintaining a separate integration per agency or tracking another agency's platform change. Check the measured timing record at /release-speed, browse the API reference, and compare plans on the pricing page; the Individual plan includes a 14-day trial.

Bottom line

Stats NZ is where New Zealand's numbers are born; FXMacroData is where they meet the rest of the FX market. Use Stats NZ for depth on New Zealand, and FXMacroData when the job is trading or modelling the kiwi against the world, timed to the second.

Sources Checked

Evidence checked - October 2026

FXMacroData API data

Data endpoints used in this article

No FXMacroData API data endpoint is attributed to this article. Its evidence base is identified in the article and source links.

Explore the FXMacroData API reference

Frequently asked

Questions about this topic

Is the Stats NZ API free?

Yes. Stats NZ lists no paid tier. The Aotearoa Data Explorer API requires a free subscription key from the Stats NZ API Portal, sent in the Ocp-Apim-Subscription-Key header. Data is licensed under Creative Commons Attribution 4.0.

Is Infoshare being replaced?

Yes. Stats NZ plans to replace Infoshare with an Aotearoa Data Explorer Time Series Expansion in 2027, migrating economic series such as GDP and price indexes, and to decommission Infoshare once customers can reliably find that data in ADE.

What time does Stats NZ release CPI and GDP?

Major Stats NZ releases are published at 10:45 a.m. New Zealand time, which is 22:45 UTC (NZST) or 21:45 UTC (NZDT) on the previous calendar day. FXMacroData records the same releases with second-level UTC timestamps, typically within seconds of publication.

Does New Zealand publish a monthly CPI?

Not yet. Headline CPI is quarterly, with monthly selected price indexes in between. Stats NZ plans transitional monthly reports in May and June 2027 and the first official monthly CPI on 29 July 2027, alongside the quarterly CPI.

Why would an FX trader use FXMacroData instead of Stats NZ?

FXMacroData reads the same official New Zealand releases and adds what NZD/USD workflows need: one schema across 22 currencies, epoch-second announcement times, a cross-country release calendar, FX rates, COT, yields, pair dashboards, and an MCP server for AI assistants.

When is Stats NZ the better choice?

Choose Stats NZ for New Zealand-only research that needs full CPI component and regional detail, monthly selected price indexes, census and population data, official citation, or free reuse under CC BY 4.0.

Keep reading

Blogroll

AI Answer-Ready

Key Facts

Page
FXMacroData vs Stats NZ API: New Zealand CPI, GDP and Labour Data for NZD Traders
Section
Articles
Canonical URL
https://fxmacrodata.com/articles/fxmacrodata-vs-stats-nz-api
Source
FXMacroData editorial and official publisher references
Last Updated
2026-10-05 11:58 UTC

Provenance And Trust

Cite the canonical URL and source field above. Where available, this page maps to official publisher releases and timestamped updates.

Quick Q&A

Is the Stats NZ API free? Yes. Stats NZ lists no paid tier. The Aotearoa Data Explorer API requires a free subscription key from the Stats NZ API Portal, sent in the Ocp-Apim-Subscription-Key header. Data is licensed under Creative Commons Attribution 4.0.

Is Infoshare being replaced? Yes. Stats NZ plans to replace Infoshare with an Aotearoa Data Explorer Time Series Expansion in 2027, migrating economic series such as GDP and price indexes, and to decommission Infoshare once customers can reliably find that data in ADE.

What time does Stats NZ release CPI and GDP? Major Stats NZ releases are published at 10:45 a.m. New Zealand time, which is 22:45 UTC (NZST) or 21:45 UTC (NZDT) on the previous calendar day. FXMacroData records the same releases with second-level UTC timestamps, typically within seconds of publication.

Does New Zealand publish a monthly CPI? Not yet. Headline CPI is quarterly, with monthly selected price indexes in between. Stats NZ plans transitional monthly reports in May and June 2027 and the first official monthly CPI on 29 July 2027, alongside the quarterly CPI.

Prompt Packs

Use these in ChatGPT, Claude, Gemini, Mistral, Perplexity, or Grok for consistent source-aware outputs.

Share page X LinkedIn Email