Securely Redirecting...

Connecting to Stripe

Back to API Index

Currency in Circulation (NZD)

Currency held by the public. M1 sub-component A1.

Category: Money & Credit

API Endpoint

/api/nzd/money_supply_currency
Or view detailed, interactive documentation: Open Swagger Docs

Data Source

Primary Source

RBNZ

Official Series ID

hc50.xlsx (Currency held by public)

Data Format and Properties

Data Frequency

Monthly

Unit of Measure

NZD millions

JSON Response Structure

The endpoint returns a chronological list of observations in JSON format. 

[
  {
    "date": "YYYY-MM-DD", 
    "val": 0.00
  },
  {
    "date": "2024-07-01", 
    "val": 4.2 
  },
  // ... history 
]

Request Parameters & Usage

Parameter Required Format Description
start_date YES YYYY-MM-DD The start date for the data retrieval.
end_date NO YYYY-MM-DD The end date for the data retrieval. Defaults to today's date.
api_key CONDITIONAL string Required for non-USD and paid access. USD endpoints are available free without an API key.

Example Usage

To retrieve the Currency in Circulation data for NZD starting from the beginning of 2023: 

GET https://fxmacrodata.com/api/nzd/money_supply_currency?start_date=2023-01-01&end_date=2023-12-31&api_key=YOUR_API_KEY