The Easiest Way to Get Gold May 2027 (GCK27) Historical Rates through API Access

In the rapidly evolving world of finance, obtaining accurate and timely data is crucial for making informed decisions. For those interested in precious metals, particularly gold (XAU), the Metals-API provides a robust solution for accessing historical prices and real-time data. This blog post will guide you through the process of retrieving historical gold prices using the Metals-API, detailing its features, capabilities, and practical applications.

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 technology and data analytics has become essential. The Metals-API stands at the forefront of this transformation, offering developers the tools needed to harness real-time metals data for innovative applications.

With the rise of digital asset solutions, understanding market insights through data analytics is more important than ever. The Metals-API empowers developers to create next-generation applications that can analyze trends, track fluctuations, and provide insights into price discovery. By leveraging the API, you can access a wealth of information that can enhance trading strategies and investment decisions.

API Description

The Metals-API is designed to provide developers with seamless access to real-time and historical data for various metals, including gold. The API allows you to retrieve exchange rates, historical prices, and other valuable information with ease. With its focus on innovation and technological advancement, the Metals-API is transforming how developers interact with precious metals data.

For more information, you can visit the Metals-API Website or explore the comprehensive Metals-API Documentation.

Key Features and Endpoints

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

Latest Rates Endpoint: This endpoint provides real-time exchange rate data for gold and other metals. Depending on your subscription plan, the API updates this data every 60 minutes or every 10 minutes, ensuring you have the most current information at your fingertips.
Historical Rates Endpoint: Access historical rates for gold dating back to 2019. By appending a specific date in the format YYYY-MM-DD, you can retrieve past exchange rates, allowing for in-depth analysis and trend tracking.
Bid and Ask Endpoint: This feature allows you to retrieve real-time bid and ask prices for gold, providing insights into market liquidity and pricing dynamics.
Convert Endpoint: The Metals-API includes a currency conversion feature, enabling you to convert amounts from one metal to another or to/from USD. This is particularly useful for traders dealing with multiple currencies.
Time-Series Endpoint: Query the API for daily historical rates between two specified dates. This endpoint is invaluable for analyzing trends over time and understanding market movements.
Fluctuation Endpoint: Track how gold prices fluctuate on a day-to-day basis. This endpoint provides insights into market volatility and can help traders make informed decisions.
Carat Endpoint: Retrieve information about gold rates by carat, allowing for precise calculations in jewelry and other applications.
Lowest/Highest Price Endpoint: This endpoint allows you to query the API for the lowest and highest prices of gold over a specified period, providing insights into market extremes.
Open/High/Low/Close (OHLC) Price Endpoint: Get detailed OHLC data for gold, which is essential for technical analysis and trading strategies.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, providing a broader context for market analysis.
API Key: Your unique API key is required to access the API, ensuring secure and authenticated requests.
API Response: The API delivers exchange rates relative to USD by default, with all data returned in a structured JSON format.
Available Endpoints: The Metals-API features 14 different endpoints, each offering unique functionalities to cater to various data needs.
Supported Symbols Endpoint: This endpoint provides a constantly updated list of all available currencies and metals, ensuring you have access to the latest information.

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 implementation. Below are examples of various endpoints, including their JSON responses and explanations of each field.

Latest Rates Endpoint

Get real-time exchange rates for all available metals:

{
"success": true,
"timestamp": 1779426565,
"base": "USD",
"date": "2026-05-22",
"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"
}

In this response:

success: Indicates whether the request was successful.
timestamp: The time at which the data was retrieved.
base: The base currency against which the rates are quoted (USD in this case).
date: The date for which the rates are applicable.
rates: An object containing the exchange rates for various metals, including gold (XAU).
unit: Specifies the measurement unit for the rates (per troy ounce).

Historical Rates Endpoint

Access historical exchange rates for any date since 1999:

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

In this response:

success: Indicates whether the request was successful.
timestamp: The time at which the data was retrieved.
base: The base currency against which the rates are quoted.
date: The specific date for which the historical rates are provided.
rates: An object containing the exchange rates for various metals on that date.
unit: Specifies the measurement unit for the rates.

Time-Series Endpoint

Get exchange rates for a specific time period:

{
"success": true,
"timeseries": true,
"start_date": "2026-05-15",
"end_date": "2026-05-22",
"base": "USD",
"rates": {
"2026-05-15": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-05-17": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-05-22": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912
}
},
"unit": "per troy ounce"
}

In this response:

success: Indicates whether the request was successful.
timeseries: Indicates that the response contains time-series data.
start_date: The starting date for the time series.
end_date: The ending date for the time series.
base: The base currency against which the rates are quoted.
rates: An object containing the exchange rates for various metals on specific dates.
unit: Specifies the measurement unit for the rates.

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": 1779426565,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}

In this response:

success: Indicates whether the request was successful.
query: An object detailing the conversion request, including the source and target metals and the amount to convert.
info: Contains additional information about the conversion, such as the timestamp and the conversion rate used.
result: The result of the conversion, indicating how many troy ounces of gold correspond to the specified amount.
unit: Specifies the measurement unit for the result.

Fluctuation Endpoint

Track rate fluctuations between two dates:

{
"success": true,
"fluctuation": true,
"start_date": "2026-05-15",
"end_date": "2026-05-22",
"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"
}

In this response:

success: Indicates whether the request was successful.
fluctuation: Indicates that the response contains fluctuation data.
start_date: The starting date for the fluctuation analysis.
end_date: The ending date for the fluctuation analysis.
base: The base currency against which the rates are quoted.
rates: An object containing fluctuation data for various metals, including start and end rates, changes in value, and percentage changes.
unit: Specifies the measurement unit for the rates.

OHLC (Open/High/Low/Close) Endpoint

Get OHLC data for a specific time period:

{
"success": true,
"timestamp": 1779426565,
"base": "USD",
"date": "2026-05-22",
"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"
}

In this response:

success: Indicates whether the request was successful.
timestamp: The time at which the data was retrieved.
base: The base currency against which the rates are quoted.
date: The specific date for which the OHLC data is provided.
rates: An object containing OHLC data for various metals, including opening, highest, lowest, and closing prices.
unit: Specifies the measurement unit for the rates.

Bid/Ask Endpoint

Get current bid and ask prices for metals:

{
"success": true,
"timestamp": 1779426565,
"base": "USD",
"date": "2026-05-22",
"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"
}

In this response:

success: Indicates whether the request was successful.
timestamp: The time at which the data was retrieved.
base: The base currency against which the rates are quoted.
date: The specific date for which the bid and ask prices are provided.
rates: An object containing bid and ask prices for various metals, including the spread between them.
unit: Specifies the measurement unit for the rates.

Conclusion

Accessing historical gold prices through the Metals-API is a straightforward process that can significantly enhance your trading strategies and market analysis. By leveraging the various endpoints offered by the API, developers can create powerful applications that provide real-time insights and historical data. Whether you are interested in tracking fluctuations, converting currencies, or analyzing trends, the Metals-API equips you with the necessary tools to succeed in the precious metals market.

For further exploration of the API's capabilities, be sure to check out the Metals-API Documentation and familiarize yourself with the Metals-API Supported Symbols. With the right knowledge and tools, you can navigate the complexities of gold trading with confidence.

Ready to use Metals-API?

Try it now!

The Easiest Way to Get Gold May 2027 (GCK27) Historical Rates through API Access