Access US Midwest Steel CRU Dec 2025 (HVZ25) JSON API for Exchange Rate Retrieval

In today's rapidly evolving digital landscape, the ability to access real-time data is crucial for developers working in the metals market. The Metals-API provides a powerful JSON API that allows users to retrieve exchange rates for various metals, including Gold (XAU). This blog post will delve into the capabilities of the Metals-API, focusing on how to effectively retrieve Gold exchange rates, explore its features, and provide practical integration tips for developers.

About Tellurium (TE)

As the metals market undergoes a digital transformation, the integration of smart technology and data analytics is becoming increasingly important. Tellurium (TE) is a prime example of how technological innovation can reshape the landscape of metal trading. By leveraging data analytics and insights, developers can create applications that not only track prices but also predict market trends and fluctuations. The future of metals trading lies in the ability to harness these technologies to provide real-time insights and enhance decision-making processes.

Metals-API Information

The Metals-API is designed to empower developers by providing access to real-time metals data. With its robust capabilities, the API allows users to build next-generation applications that can analyze market trends, track price fluctuations, and convert currencies seamlessly. The API supports a wide range of endpoints, each tailored to meet specific needs, from retrieving the latest rates to accessing historical data.

For more information, visit the Metals-API Website or check out the Metals-API Documentation for detailed guidance on implementation.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that cater to different requirements. Here are some of the key features:

Latest Rates Endpoint: This endpoint provides real-time exchange rate data for metals, updated based on your subscription plan. Developers can retrieve the latest rates for Gold (XAU) and other metals, enabling them to make informed decisions.
Historical Rates Endpoint: Access historical rates dating back to 2019 by appending a specific date to your query. This feature is invaluable for analyzing past trends and making predictions based on historical data.
Bid And Ask Endpoint: Retrieve real-time bid and ask prices for metals, allowing developers to understand market dynamics and make strategic trading decisions.
Convert Endpoint: This endpoint enables users to convert any amount from one currency to another, facilitating seamless transactions across different currencies.
Time-Series Endpoint: Query the API for daily historical rates between two dates of your choice, providing insights into price movements over time.
Fluctuation Endpoint: Track how currencies fluctuate on a day-to-day basis, helping developers understand market volatility.
Carat Endpoint: Retrieve information about Gold rates by carat, which is essential for jewelers and traders dealing in precious metals.
Lowest/Highest Price Endpoint: Query the API to get the lowest and highest prices for a specified date, aiding in market analysis.
Open/High/Low/Close (OHLC) Price Endpoint: Access OHLC data for a specific time period, which is crucial for technical analysis.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, providing a comprehensive view of market trends.
API Key: Your unique API key is required for authentication and must be included in your requests to access the API.
API Response: The API delivers exchange rates relative to USD by default, ensuring consistency in data presentation.
Available Endpoints: The Metals-API includes 14 endpoints, each designed to provide specific functionalities tailored to user needs.
Supported Symbols Endpoint: Access a constantly updated list of all available currencies and metals supported by the API.

List of Symbols

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

API Endpoint Examples and Responses

Understanding how to interact with the Metals-API is crucial for effective integration. Below are examples of API responses for various endpoints, focusing on retrieving Gold (XAU) exchange rates.

Latest Rates Endpoint

Get real-time exchange rates for all available metals:

{
"success": true,
"timestamp": 1782882460,
"base": "USD",
"date": "2026-07-01",
"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"
}

This response indicates that the current exchange rate for Gold (XAU) is 0.000482 troy ounces per USD. The timestamp and date fields provide context for the data retrieved.

Historical Rates Endpoint

Access historical exchange rates for any date since 1999:

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

This response shows the historical exchange rate for Gold (XAU) on June 30, 2026, which was 0.000485 troy ounces per USD. Historical data is essential for trend analysis and forecasting.

Time-series Endpoint

Get exchange rates for a specific time period:

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

This response provides a time series of Gold (XAU) exchange rates from June 24 to July 1, 2026, allowing developers to analyze trends over that period.

Convert Endpoint

Convert any amount from one metal to another or to/from USD:

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

This response indicates that converting 1000 USD results in 0.482 troy ounces of Gold (XAU) based on the current exchange rate.

Fluctuation Endpoint

Track rate fluctuations between two dates:

{
"success": true,
"fluctuation": true,
"start_date": "2026-06-24",
"end_date": "2026-07-01",
"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"
}

This response shows the fluctuations in Gold (XAU) rates over the specified period, highlighting the changes in value and percentage change.

OHLC (Open/High/Low/Close) Endpoint

Get OHLC data for a specific time period:

{
"success": true,
"timestamp": 1782882460,
"base": "USD",
"date": "2026-07-01",
"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"
}

This response provides the open, high, low, and close prices for Gold (XAU) on July 1, 2026, which is essential for traders conducting technical analysis.

Bid/Ask Endpoint

Get current bid and ask prices for metals:

{
"success": true,
"timestamp": 1782882460,
"base": "USD",
"date": "2026-07-01",
"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"
}

This response provides the current bid and ask prices for Gold (XAU), which are crucial for traders looking to execute buy or sell orders.

Conclusion

In conclusion, the Metals-API offers a comprehensive suite of features that empower developers to access real-time and historical data for metals, including Gold (XAU). By leveraging the various endpoints, developers can create applications that provide valuable insights into market trends, facilitate currency conversions, and track price fluctuations. The ability to retrieve and analyze this data is essential for making informed trading decisions in the dynamic metals market.

For further exploration of the API's capabilities, refer to the Metals-API Documentation and familiarize yourself with the Metals-API Supported Symbols. By integrating these powerful tools into your applications, you can stay ahead in the competitive landscape of metals trading.

Ready to use Metals-API?

Try it now!

Access US Midwest Steel CRU Dec 2025 (HVZ25) JSON API for Exchange Rate Retrieval