The Easiest Way to Get Gold Mar 2027 (GCH27) Historical Rates with a Simple API Call

In the world of precious metals trading, having access to accurate and timely data is crucial for making informed decisions. One of the most effective ways to obtain historical prices for gold (XAU) is through the Metals-API. This powerful tool allows developers and traders to access a wealth of information about gold and other metals with just a simple API call. In this blog post, we will explore how to retrieve historical prices for gold using the Metals-API, including example endpoints, parameters, and data formats.

About Gold (XAU)

Gold has long been a symbol of wealth and a critical asset in financial markets. As digital transformation continues to reshape the landscape of precious metals trading, the integration of data analytics and technology is becoming increasingly important. The Metals-API provides developers with the tools necessary to harness real-time metals data, enabling innovative applications that enhance price discovery and market insights.

With the rise of digital asset solutions, understanding the historical performance of gold is vital for traders and investors alike. By leveraging the Metals-API, users can access comprehensive historical data, allowing for better analysis and forecasting of market trends. This API not only empowers developers to create next-generation applications but also facilitates a deeper understanding of the dynamics of precious metals trading.

API Description

The Metals-API is a robust JSON API that provides real-time and historical data for various metals, including gold, silver, platinum, and palladium. It is designed to serve developers looking to integrate metals pricing into their applications seamlessly. The API offers a range of endpoints, each tailored to specific functionalities, making it a versatile tool for accessing metals 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 several key features that cater to various needs in the metals trading space. Here are some of the most notable endpoints:

Latest Rates Endpoint: This endpoint provides real-time exchange rate data for metals, updated every 60 minutes, 10 minutes, or even more frequently, depending on your subscription plan. It allows users to quickly access the current market rates for gold and other metals.
Historical Rates Endpoint: Users can retrieve historical rates for gold dating back to 2019 by appending a specific date in the format YYYY-MM-DD. This feature is essential for analyzing past performance and making informed trading decisions.
Bid and Ask Endpoint: This powerful feature enables users to retrieve real-time bid and ask prices for metals, providing insights into market liquidity and pricing dynamics.
Convert Endpoint: The Metals-API includes a currency conversion endpoint, allowing users to convert amounts between different metals or to/from USD. This is particularly useful for traders dealing with multiple currencies.
Time-Series Endpoint: This endpoint allows users to query daily historical rates between two specified dates, facilitating in-depth analysis of price movements over time.
Fluctuation Endpoint: Users can track how metal prices fluctuate on a day-to-day basis, providing valuable insights into market volatility.
Carat Endpoint: This feature allows users to retrieve gold rates based on carat measurements, which is essential for jewelers and those dealing with gold in various forms.
Lowest/Highest Price Endpoint: This endpoint enables users to query the lowest and highest prices for gold within a specified date range, assisting in identifying market extremes.
Open/High/Low/Close (OHLC) Price Endpoint: Users can access OHLC data for a specific time period, which is crucial for technical analysis and trading strategies.
Historical LME Endpoint: This endpoint provides access to historical rates for LME symbols dating back to 2008, offering a broader perspective on metal pricing.
API Key: To access the API, users must include their unique API key in the access_key parameter of the API base URL, ensuring secure and authorized access.
API Response: The Metals-API delivers exchange rates relative to USD by default, with all data returned in a structured JSON format.
Supported Symbols Endpoint: This constantly updated endpoint returns all available metal symbols, allowing users to stay informed about the latest offerings.
News Endpoint: Users can retrieve the latest news articles related to various metals, keeping them updated on market trends and developments.

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

Latest Rates Endpoint

To get real-time exchange rates for all available metals, you can use the following endpoint:

GET https://metals-api.com/api/latest?access_key=YOUR_API_KEY

Example response:

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

Historical Rates Endpoint

Access historical exchange rates for any date since 1999 using the following endpoint:

GET https://metals-api.com/api/historical?access_key=YOUR_API_KEY&date=2026-03-22

Example response:

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

Time-Series Endpoint

To get exchange rates for a specific time period, use the following endpoint:

GET https://metals-api.com/api/timeseries?access_key=YOUR_API_KEY&start_date=2026-03-16&end_date=2026-03-23

Example response:

{
"success": true,
"timeseries": true,
"start_date": "2026-03-16",
"end_date": "2026-03-23",
"base": "USD",
"rates": {
"2026-03-16": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-03-18": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-03-23": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912
}
},
"unit": "per troy ounce"
}

Convert Endpoint

To convert any amount from one metal to another or to/from USD, use the following endpoint:

GET https://metals-api.com/api/convert?access_key=YOUR_API_KEY&from=USD&to=XAU&amount=1000

Example response:

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

Fluctuation Endpoint

To track rate fluctuations between two dates, use the following endpoint:

GET https://metals-api.com/api/fluctuation?access_key=YOUR_API_KEY&start_date=2026-03-16&end_date=2026-03-23

Example response:

{
"success": true,
"fluctuation": true,
"start_date": "2026-03-16",
"end_date": "2026-03-23",
"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"
}

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

To get OHLC data for a specific time period, use the following endpoint:

GET https://metals-api.com/api/open-high-low-close?access_key=YOUR_API_KEY&date=2026-03-23

Example response:

{
"success": true,
"timestamp": 1774235245,
"base": "USD",
"date": "2026-03-23",
"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"
}

Bid/Ask Endpoint

To get current bid and ask prices for metals, use the following endpoint:

GET https://metals-api.com/api/bid-ask?access_key=YOUR_API_KEY

Example response:

{
"success": true,
"timestamp": 1774235245,
"base": "USD",
"date": "2026-03-23",
"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"
}

Conclusion

Accessing historical prices for gold (XAU) has never been easier, thanks to the Metals-API. With its comprehensive range of endpoints, developers can retrieve real-time and historical data, enabling them to make informed trading decisions. By leveraging the power of this API, users can integrate advanced data analytics and market insights into their applications, paving the way for innovative solutions in the precious metals market.

Whether you are a trader looking to analyze past performance or a developer seeking to build next-generation applications, the Metals-API provides the tools you need. For more information on how to get started, visit the Metals-API Documentation and explore the various features available.

In summary, the Metals-API is a transformative tool that empowers users to harness the potential of real-time metals data, driving innovation and enhancing market understanding. With its user-friendly endpoints and extensive capabilities, it is an essential resource for anyone involved in the precious metals trading space.

Ready to use Metals-API?

Try it now!

The Easiest Way to Get Gold Mar 2027 (GCH27) Historical Rates with a Simple API Call