Access Gold Dec 2026 (GCZ26) API Documentation in JSON Format

In the rapidly evolving world of finance, the demand for real-time data has never been higher, especially in the precious metals market. The Metals-API provides developers with the tools to access and integrate gold (XAU) exchange rates and other metal data in JSON format. This blog post will explore the capabilities of the Metals-API, focusing on how to retrieve gold exchange rates, sample API responses, and integration tips for developers looking to leverage this powerful tool.

About Gold (XAU)

Gold has long been considered a safe haven asset, and its value is influenced by various factors, including market demand, geopolitical stability, and economic indicators. As digital transformation continues to reshape financial markets, the integration of data analytics and technology in trading has become essential. The Metals-API empowers developers to harness real-time data for innovative applications, enabling them to gain market insights and enhance price discovery.

With the rise of digital asset solutions, understanding how to effectively utilize APIs for precious metals trading can significantly impact investment strategies. The Metals-API allows developers to build next-generation applications that can analyze trends, track fluctuations, and convert currencies seamlessly.

API Description

The Metals-API is designed to provide comprehensive access to real-time and historical data for various metals, including gold (XAU). This API enables developers to create applications that can retrieve exchange rates, historical data, and perform conversions between different currencies. The transformative potential of real-time metals data is immense, allowing for enhanced decision-making and strategy formulation in trading.

For more detailed information, you can refer to the Metals-API Documentation, which outlines all available features and endpoints.

Key Features and Endpoints

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

Latest Rates Endpoint: This endpoint provides real-time exchange rate data, updated based on your subscription plan. Depending on your plan, you can receive updates every 60 minutes, every 10 minutes, or even more frequently.
Historical Rates Endpoint: Access historical rates for most currencies dating back to 2019. You can query the Metals-API for historical rates by appending a date in the format YYYY-MM-DD.
Bid And Ask Endpoint: Retrieve real-time bid and ask prices for metals, allowing you to make informed trading decisions.
Convert Endpoint: This feature enables you to convert any amount from one currency to another, facilitating seamless transactions.
Time-Series Endpoint: Query the API for daily historical rates between two dates of your choice, providing insights into market trends over time.
Fluctuation Endpoint: Track how currencies fluctuate on a day-to-day basis, which is crucial for understanding market dynamics.
Carat Endpoint: Retrieve information about gold rates by carat, which is essential for jewelers and consumers alike.
Lowest/Highest Price Endpoint: Get the lowest and highest price for a specified date, helping you identify market extremes.
Open/High/Low/Close (OHLC) Price Endpoint: Access OHLC data for a specific time period, which is vital for technical analysis.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, useful for analyzing long-term trends.
API Key: Your unique API key is essential for accessing the API and should be included in the base URL's access_key parameter.
API Response: Exchange rates delivered by the Metals-API are relative to USD by default, and all data is returned in a structured JSON format.
Available Endpoints: The Metals-API comprises 14 endpoints, each providing different functionalities tailored to various needs.
Supported Symbols Endpoint: Access a constantly updated list of all available currencies and metals.

List of Symbols

The 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

Get real-time exchange rates for all available metals:

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

Historical Rates Endpoint

Access historical exchange rates for any date since 1999:

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

Time-series Endpoint

Get exchange rates for a specific time period:

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

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

Fluctuation Endpoint

Track rate fluctuations between two dates:

{
"success": true,
"fluctuation": true,
"start_date": "2026-05-24",
"end_date": "2026-05-31",
"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) Endpoint

Get OHLC data for a specific time period:

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

Get current bid and ask prices for metals:

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

Integration Tips

Integrating the Metals-API into your applications can enhance your trading strategies and provide valuable insights. Here are some tips for effective integration:

Authentication: Ensure that you securely manage your API key. This key is essential for accessing the API and should be kept confidential.
Rate Limiting: Be aware of the rate limits associated with your subscription plan. Implementing caching strategies can help reduce the number of API calls and improve performance.
Error Handling: Implement robust error handling to manage potential issues such as network failures or invalid requests. This will enhance the user experience and ensure data integrity.
Data Validation: Validate the data received from the API to ensure it meets your application's requirements. This can prevent errors in processing and improve reliability.
Performance Optimization: Optimize your API calls by requesting only the data you need. This can reduce latency and improve the responsiveness of your application.

Conclusion

The Metals-API offers a powerful solution for developers looking to access gold (XAU) exchange rates and other precious metals data in JSON format. By leveraging the various endpoints and features available, developers can create innovative applications that provide real-time insights and facilitate informed trading decisions. Whether you are interested in historical data, real-time rates, or currency conversion, the Metals-API has the tools you need to succeed.

For more information on how to get started, visit the Metals-API Documentation and explore the Metals-API Supported Symbols page for a comprehensive list of available symbols. With the right integration strategies and a solid understanding of the API's capabilities, you can unlock the full potential of real-time metals data.

Ready to use Metals-API?

Try it now!

Access Gold Dec 2026 (GCZ26) API Documentation in JSON Format