Access US Midwest Steel CRU Dec 2025 (HVZ25) API Documentation in JSON Format

Introduction

In the rapidly evolving landscape of metal markets, the ability to access real-time data is paramount for developers and businesses alike. The Metals-API offers a powerful solution for retrieving Gold (XAU) exchange rates in JSON format, enabling developers to create innovative applications that leverage this data. This blog post will delve into the capabilities of the Metals-API, focusing on how to effectively retrieve and utilize Gold exchange rates, along with sample API responses and integration tips.

Understanding Metals-API

The Metals-API is designed to provide developers with comprehensive access to metal prices and currency conversion data. It empowers users to build next-generation applications by offering real-time exchange rates, historical data, and various endpoints tailored to specific needs. By integrating this API, developers can harness the power of data analytics and insights, driving digital transformation in the metal markets.

About Tellurium (TE)

While our primary focus is on Gold (XAU), it's worth noting the broader context of metals like Tellurium (TE). The digital transformation in metal markets is characterized by technological innovation and advancement, where data analytics plays a crucial role. The integration of smart technologies allows for real-time tracking and analysis, paving the way for future trends and possibilities in the industry.

API Description

The Metals-API provides a robust suite of features that enable developers to access real-time and historical metal prices. With a focus on innovation and technological advancement, this API allows for the seamless integration of metals data into applications. Developers can utilize the API to create tools that analyze market trends, perform currency conversions, and track price fluctuations.

For detailed information on how to get started, refer to the Metals-API Documentation.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that cater to different functionalities, allowing developers to retrieve essential data efficiently. Here are some of the key features:

Latest Rates Endpoint

The Latest Rates endpoint provides real-time exchange rate data for Gold (XAU) and other metals. Depending on your subscription plan, this endpoint can return data updated every 60 minutes or every 10 minutes. This feature is crucial for applications that require up-to-the-minute pricing information.

{
"success": true,
"timestamp": 1778432871,
"base": "USD",
"date": "2026-05-10",
"rates": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912,
"XPD": 0.000744
},
"unit": "per troy ounce"
}

Historical Rates Endpoint

Accessing historical rates is essential for market analysis. The Historical Rates endpoint allows users to query rates dating back to 2019 by appending a specific date in the format YYYY-MM-DD. This feature is particularly useful for developers looking to analyze trends over time.

{
"success": true,
"timestamp": 1778346471,
"base": "USD",
"date": "2026-05-09",
"rates": {
"XAU": 0.000485,
"XAG": 0.03825
},
"unit": "per troy ounce"
}

Bid and Ask Endpoint

The Bid and Ask endpoint provides real-time bid and ask prices for Gold and other metals. This feature is invaluable for traders who need to make informed decisions based on current market conditions.

{
"success": true,
"timestamp": 1778432871,
"base": "USD",
"date": "2026-05-10",
"rates": {
"XAU": {
"bid": 0.000481,
"ask": 0.000483,
"spread": 2.0e-6
}
},
"unit": "per troy ounce"
}

Convert Endpoint

The Convert endpoint allows users to convert any amount from one metal to another or to/from USD. This feature is particularly useful for applications that require currency conversion capabilities.

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

Time-Series Endpoint

The Time-Series endpoint allows developers to query the API for daily historical rates between two specified dates. This feature is essential for applications that require trend analysis over a defined period.

{
"success": true,
"timeseries": true,
"start_date": "2026-05-03",
"end_date": "2026-05-10",
"base": "USD",
"rates": {
"2026-05-03": {
"XAU": 0.000485
},
"2026-05-10": {
"XAU": 0.000482
}
},
"unit": "per troy ounce"
}

Fluctuation Endpoint

The Fluctuation endpoint provides insights into how prices fluctuate over a specified period. This feature is beneficial for developers looking to track market volatility.

{
"success": true,
"fluctuation": true,
"start_date": "2026-05-03",
"end_date": "2026-05-10",
"base": "USD",
"rates": {
"XAU": {
"start_rate": 0.000485,
"end_rate": 0.000482,
"change": -3.0e-6,
"change_pct": -0.62
}
},
"unit": "per troy ounce"
}

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

The OHLC endpoint provides open, high, low, and close prices for a specific date. This data is crucial for traders and analysts who need to assess market performance over time.

{
"success": true,
"timestamp": 1778432871,
"base": "USD",
"date": "2026-05-10",
"rates": {
"XAU": {
"open": 0.000485,
"high": 0.000487,
"low": 0.000481,
"close": 0.000482
}
},
"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 developers working with industrial metals.

{
"success": true,
"timestamp": 1778346471,
"base": "USD",
"date": "2026-05-09",
"rates": {
"XCU": 0.294118
},
"unit": "per troy ounce"
}

API Key and Response

Your API Key is essential for accessing the Metals-API. It must be included in the API base URL's access_key parameter. The API responses are structured to provide clarity, with exchange rates delivered relative to USD by default.

Available Endpoints

The Metals-API offers a total of 14 endpoints, each designed to provide specific functionalities. Developers can explore these endpoints to find the best fit for their application needs.

Supported Symbols Endpoint

The Supported Symbols endpoint returns a constantly updated list of all available currencies and metals. This feature is essential for developers to ensure they are using the correct symbols in their queries. For a complete list of supported symbols, refer to the Metals-API Supported Symbols.

News Endpoint

The News endpoint allows users to retrieve the latest news articles related to various metals. This feature can enhance applications by providing users with current market insights and trends.

Integration Tips

Integrating the Metals-API into your application can significantly enhance its functionality. Here are some tips for successful integration:

• Authentication: Ensure that you securely store your API key and include it in all requests to authenticate your application.
• Error Handling: Implement robust error handling to manage API response errors gracefully. This includes handling rate limits and unexpected downtime.
• Data Validation: Validate all incoming data to prevent issues related to incorrect or malformed requests.
• Performance Optimization: Utilize caching strategies to minimize API calls and improve application performance.
• Security Best Practices: Follow security best practices, such as using HTTPS for all API requests and regularly rotating your API key.

Conclusion

The Metals-API provides a comprehensive solution for developers looking to access Gold (XAU) exchange rates and other metal prices in JSON format. By leveraging the various endpoints and features offered by the API, developers can create powerful applications that analyze market trends, perform currency conversions, and track price fluctuations. With a focus on innovation and technological advancement, the Metals-API is poised to transform the way businesses interact with metal market data. For more information, visit the Metals-API Website and explore the Metals-API Documentation for detailed guidance on implementation.