Integrate Gold Dec 2025 (GCZ25) Historical Prices using this API

In the ever-evolving landscape of financial technology, the integration of real-time data into trading applications has become paramount. One of the most significant assets in this domain is Gold, represented by the symbol XAU. This blog post delves into how developers can leverage the Metals-API to access historical prices for Gold, specifically focusing on the Dec 2025 futures contract (GCZ25). We will explore the API's capabilities, its innovative features, and how it empowers developers to create next-generation applications that harness the power of real-time metals data.

About Gold (XAU)

Gold has long been a cornerstone of wealth preservation and investment strategy. As a precious metal, it has intrinsic value and serves as a hedge against inflation and economic uncertainty. The digital transformation in precious metals trading has opened new avenues for data analytics and market insights, allowing traders to make informed decisions based on real-time data.

With the rise of technology integration in trading, the ability to access and analyze historical price data has become crucial. The Metals-API offers a robust solution for developers looking to integrate Gold price data into their applications. By utilizing this API, developers can innovate in price discovery and create digital asset solutions that cater to the needs of modern investors.

API Description

The Metals-API is a powerful tool designed to provide developers with access to real-time and historical data for various metals, including Gold. This API is built with innovation in mind, allowing for seamless integration into applications that require accurate and timely metals data.

One of the standout features of the Metals-API is its ability to deliver real-time exchange rates, historical data, and various endpoints that cater to different needs. Whether you are looking to track the latest prices, analyze historical trends, or convert between different metals, the Metals-API has you covered.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that provide different functionalities. 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 that 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 to your query, you can retrieve the price of Gold on that date, allowing for in-depth analysis of market trends.
Bid And Ask Endpoint: This feature enables you to retrieve real-time bid and ask prices for Gold. Understanding these prices is crucial for traders looking to make informed decisions based on market conditions.
Convert Endpoint: The conversion endpoint allows you to convert any amount from one metal to another or to/from USD. This is particularly useful for traders who deal with multiple metals and need to understand their relative values.
Time-Series Endpoint: Query the API for daily historical rates between two dates of your choice. This endpoint is invaluable for analyzing trends over specific periods.
Fluctuation Endpoint: Retrieve information about how Gold prices fluctuate on a day-to-day basis. This data can help traders understand volatility and make strategic decisions.
Carat Endpoint: Access information about Gold rates by carat, which is essential for jewelers and those in the jewelry industry.
Lowest/Highest Price Endpoint: This endpoint allows you to query the API to get the lowest and highest price of Gold over a specified period, providing insights into market extremes.
Open/High/Low/Close (OHLC) Price Endpoint: Get the open, high, low, and close prices for Gold over a specified time frame, which is crucial for technical analysis.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, which is beneficial for comprehensive market analysis.
API Key: Your unique API key is required to access the Metals-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 comes with 14 different endpoints, each providing unique functionalities to cater to various needs.
Supported Symbols Endpoint: This endpoint returns all available metal symbols, allowing developers to easily identify which metals they can query.
News Endpoint: Retrieve the latest news articles related to various metals, keeping you informed about market 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

Understanding the API responses is crucial for effective integration. Below are examples of various API endpoints and their corresponding JSON responses:

Latest Rates Endpoint

{
"success": true,
"timestamp": 1771114755,
"base": "USD",
"date": "2026-02-15",
"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 price of Gold (XAU) is 0.000482 per troy ounce, relative to USD.

Historical Rates Endpoint

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

This response shows the historical price of Gold on February 14, 2026, allowing developers to analyze past market behavior.

Time-series Endpoint

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

This response provides daily rates for Gold over a specified period, enabling developers to visualize trends and fluctuations.

Convert Endpoint

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

This response shows the conversion of 1000 USD to Gold, resulting in 0.482 troy ounces. This functionality is essential for traders who need to quickly assess the value of their investments.

Fluctuation Endpoint

{
"success": true,
"fluctuation": true,
"start_date": "2026-02-08",
"end_date": "2026-02-15",
"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 provides insights into how Gold prices have fluctuated over a specific period, which is crucial for understanding market volatility.

OHLC (Open/High/Low/Close) Endpoint

{
"success": true,
"timestamp": 1771114755,
"base": "USD",
"date": "2026-02-15",
"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, which are essential for technical analysis and trading strategies.

Bid/Ask Endpoint

{
"success": true,
"timestamp": 1771114755,
"base": "USD",
"date": "2026-02-15",
"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, which are critical for traders looking to execute buy or sell orders effectively.

Conclusion

The Metals-API is an invaluable resource for developers seeking to integrate Gold price data into their applications. With its comprehensive range of endpoints, real-time data capabilities, and historical price access, this API empowers developers to create innovative solutions that meet the demands of modern trading.

By utilizing the various features of the Metals-API, such as the Latest Rates, Historical Rates, and Time-Series endpoints, developers can gain insights into market trends and fluctuations. This information is essential for making informed trading decisions and optimizing investment strategies.

As the financial landscape continues to evolve, the integration of advanced technologies and real-time data will play a crucial role in shaping the future of trading. The Metals-API stands at the forefront of this transformation, providing the tools necessary for developers to build next-generation applications that harness the power of metals data.

For more information on how to get started with the Metals-API, refer to the Metals-API Documentation and explore the Metals-API Supported Symbols to find the right data for your needs.

Ready to use Metals-API?

Try it now!

Integrate Gold Dec 2025 (GCZ25) Historical Prices using this API