Get New Zealand Dollar (NZD) prices using this API

Introduction

In the ever-evolving landscape of financial markets, obtaining accurate and real-time data is crucial for developers and businesses alike. One of the most sought-after currencies in the global market is the New Zealand Dollar (NZD). With the help of the Metals-API, developers can access comprehensive data on NZD prices and much more. This blog post delves into the capabilities of the Metals-API, focusing on its innovative features, endpoints, and how it can transform the way we interact with metal markets.

Understanding Neodymium (ND) and Its Market

Neodymium, a rare earth metal, plays a pivotal role in various technological advancements, particularly in the fields of electronics, renewable energy, and automotive industries. As digital transformation sweeps across metal markets, the demand for neodymium is expected to rise. This surge is driven by its application in high-strength magnets, which are essential for electric vehicles and wind turbines.

Technological innovation in the extraction and processing of neodymium has led to enhanced efficiency and reduced environmental impact. Data analytics and insights derived from real-time market data can empower businesses to make informed decisions, optimizing their operations and supply chains. The integration of smart technology in metal markets allows for better tracking of resources, pricing, and demand forecasting.

As we look to the future, the possibilities for neodymium and other metals are vast. The Metals-API stands at the forefront of this transformation, providing developers with the tools needed to harness real-time data for innovative applications.

API Description

The Metals-API is a powerful tool designed to provide real-time and historical data on metal prices and currency conversions. It empowers developers to build next-generation applications that require accurate and timely information. With its user-friendly interface and comprehensive documentation, the Metals-API enables seamless integration into various platforms and applications.

For developers looking to access detailed information about the API's capabilities, the Metals-API Documentation offers extensive guidance on how to utilize its features effectively. The API supports a wide range of symbols, including neodymium, and provides access to real-time exchange rates, historical data, and more through its various endpoints.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that cater to different needs, making it an invaluable resource for developers. Here are some of the key features:

Latest Rates Endpoint

The Latest Rates Endpoint provides real-time exchange rate data for metals, including the NZD. Depending on your subscription plan, this endpoint can return updated rates every 60 minutes or even every 10 minutes. This feature is essential for applications that require up-to-the-minute pricing information.

{
"success": true,
"timestamp": 1783728617,
"base": "USD",
"date": "2026-07-11",
"rates": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912,
"XPD": 0.000744,
"XCU": 0.294118,
"XAL": 0.434783,
"XNI": 0.142857,
"XZN": 0.344828
},
"unit": "per troy ounce"
}

Historical Rates Endpoint

Accessing historical rates is crucial for trend analysis and forecasting. The Historical Rates Endpoint allows users to retrieve data dating back to 2019. By appending a specific date in the format YYYY-MM-DD, developers can query the Metals-API for past rates, enabling them to analyze market trends over time.

{
"success": true,
"timestamp": 1783642217,
"base": "USD",
"date": "2026-07-10",
"rates": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915,
"XPD": 0.000748
},
"unit": "per troy ounce"
}

Bid and Ask Endpoint

The Bid and Ask Endpoint is a powerful feature that provides real-time bid and ask prices for metals. This data is essential for traders and investors who need to make informed decisions based on current market conditions. Depending on your subscription plan, this endpoint can deliver accurate pricing information that reflects the latest market movements.

{
"success": true,
"timestamp": 1783728617,
"base": "USD",
"date": "2026-07-11",
"rates": {
"XAU": {
"bid": 0.000481,
"ask": 0.000483,
"spread": 2.0e-6
},
"XAG": {
"bid": 0.0381,
"ask": 0.0382,
"spread": 0.0001
},
"XPT": {
"bid": 0.000911,
"ask": 0.000913,
"spread": 2.0e-6
}
},
"unit": "per troy ounce"
}

Convert Endpoint

The Convert Endpoint allows users to convert any amount from one currency to another, including conversions involving the NZD. This feature is particularly useful for applications that require currency conversion for transactions or financial reporting.

{
"success": true,
"query": {
"from": "USD",
"to": "XAU",
"amount": 1000
},
"info": {
"timestamp": 1783728617,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}

Time-Series Endpoint

The Time-Series Endpoint enables developers to query the API for daily historical rates between two specified dates. This feature is invaluable for analyzing price movements over time and understanding market dynamics.

{
"success": true,
"timeseries": true,
"start_date": "2026-07-04",
"end_date": "2026-07-11",
"base": "USD",
"rates": {
"2026-07-04": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-07-06": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-07-11": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912
}
},
"unit": "per troy ounce"
}

Fluctuation Endpoint

The Fluctuation Endpoint provides insights into how currencies fluctuate on a day-to-day basis. By tracking rate changes between two dates, developers can gain valuable insights into market volatility and trends.

{
"success": true,
"fluctuation": true,
"start_date": "2026-07-04",
"end_date": "2026-07-11",
"base": "USD",
"rates": {
"XAU": {
"start_rate": 0.000485,
"end_rate": 0.000482,
"change": -3.0e-6,
"change_pct": -0.62
},
"XAG": {
"start_rate": 0.03825,
"end_rate": 0.03815,
"change": -0.0001,
"change_pct": -0.26
},
"XPT": {
"start_rate": 0.000915,
"end_rate": 0.000912,
"change": -3.0e-6,
"change_pct": -0.33
}
},
"unit": "per troy ounce"
}

Open/High/Low/Close (OHLC) Price Endpoint

The OHLC Price Endpoint provides essential data for traders by delivering the open, high, low, and close prices for a specific time period. This information is critical for technical analysis and decision-making in trading.

{
"success": true,
"timestamp": 1783728617,
"base": "USD",
"date": "2026-07-11",
"rates": {
"XAU": {
"open": 0.000485,
"high": 0.000487,
"low": 0.000481,
"close": 0.000482
},
"XAG": {
"open": 0.03825,
"high": 0.0383,
"low": 0.0381,
"close": 0.03815
},
"XPT": {
"open": 0.000915,
"high": 0.000918,
"low": 0.00091,
"close": 0.000912
}
},
"unit": "per troy ounce"
}

Historical LME Endpoint

The Historical LME Endpoint provides access to historical rates for LME symbols dating back to 2008. This endpoint is particularly useful for businesses involved in trading or investing in metals, as it allows for comprehensive market analysis.

API Key and Response

To access the Metals-API, users must obtain an API Key, which is passed into the API base URL's access_key parameter. This key ensures secure access to the API and helps manage usage limits.

All exchange rates delivered by the Metals-API are relative to USD by default, and the data is returned in a structured JSON format, making it easy to integrate into applications.

List of Symbols

The Metals-API provides access to a comprehensive range of metal symbols, including neodymium and many others. For a complete list of all supported symbols and their specifications, refer to the Metals-API Supported Symbols page.

Conclusion

The Metals-API is a transformative tool for developers looking to access real-time and historical data on metal prices, including the New Zealand Dollar (NZD). With its extensive range of endpoints and features, the API empowers businesses to make informed decisions based on accurate market data. By leveraging the capabilities of the Metals-API, developers can create innovative applications that enhance the way we interact with metal markets.

For more information on how to get started with the Metals-API, visit the Metals-API Website and explore the Metals-API Documentation for detailed guidance on implementation and usage.