Access Gold May 2027 (GCK27) API Integration Guide in JSON Format

In the rapidly evolving landscape of digital finance, the integration of real-time data APIs has become essential for developers looking to build innovative applications. One such powerful tool is the Metals-API, which provides comprehensive access to precious metals data, including Gold (XAU) exchange rates. This guide will delve into the capabilities of the Metals-API, focusing on how to retrieve Gold exchange rates in JSON format, along with practical integration tips and sample API responses.

Metals-API Information

About Gold (XAU)

Gold has long been a symbol of wealth and stability, and its significance in the financial markets continues to grow. As digital transformation sweeps through various sectors, the precious metals market is no exception. The integration of data analytics and market insights into trading platforms is revolutionizing how investors interact with Gold. By leveraging technology, traders can gain innovative price discovery methods and utilize digital asset solutions that enhance their trading strategies.

The Metals-API serves as a bridge between developers and real-time metals data, enabling the creation of next-generation applications that can respond to market changes instantaneously. With a focus on technological advancement, this API empowers developers to harness the full potential of real-time data, making it an invaluable resource for anyone involved in trading or investing in precious metals.

API Description

The Metals-API offers a robust set of features designed to provide developers with the tools they need to access and manipulate precious metals data efficiently. With its user-friendly interface and comprehensive documentation, developers can quickly integrate the API into their applications. The API supports a variety of endpoints that allow users to retrieve real-time exchange rates, historical data, and much more.

For detailed information on the API's capabilities, visit the Metals-API Documentation. This resource provides in-depth explanations of each endpoint, including usage examples and best practices for integration.

Key Features and Endpoints

The Metals-API boasts several key features that enhance its utility for developers:

Latest Rates Endpoint: This endpoint provides real-time exchange rate data for Gold and other metals, updated based on your subscription plan. Depending on the plan, updates can occur every 60 minutes or every 10 minutes, ensuring you have the most current data at your fingertips.
Historical Rates Endpoint: Access historical rates dating back to 2019 by appending a specific date to your query. This feature is essential for analyzing trends and making informed trading decisions.
Bid And Ask Endpoint: Retrieve real-time bid and ask prices for Gold and other metals. This endpoint is crucial for traders looking to execute orders at optimal prices.
Convert Endpoint: This endpoint allows you to convert any amount from one metal to another or to/from USD, facilitating seamless transactions across different currencies.
Time-Series Endpoint: Query daily historical rates between two dates of your choice, enabling detailed analysis of price movements over time.
Fluctuation Endpoint: Track how Gold and other metals fluctuate on a day-to-day basis, providing insights into market volatility.
Carat Endpoint: Retrieve information about Gold rates by carat, which is particularly useful for jewelers and consumers interested in specific gold purity levels.
Lowest/Highest Price Endpoint: Query the API to get the lowest and highest price of Gold for a specified date, aiding in market analysis.
Open/High/Low/Close (OHLC) Price Endpoint: Obtain OHLC data for a specific time period, which is vital for technical analysis and trading strategies.
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 to access the API, ensuring secure and authorized usage.
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 includes 14 distinct endpoints, each offering unique functionalities tailored to different 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. This resource is invaluable for developers looking to understand the full scope of available data.

API Endpoint Examples and Responses

Latest Rates Endpoint

To retrieve real-time exchange rates for all available metals, you can use the Latest Rates Endpoint. Below is a sample JSON response:

{
"success": true,
"timestamp": 1782692418,
"base": "USD",
"date": "2026-06-29",
"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, the "rates" object contains the current exchange rates for various metals, with Gold (XAU) priced at 0.000482 per troy ounce.

Historical Rates Endpoint

Access historical exchange rates for any date since 1999 using the Historical Rates Endpoint. Here’s an example response:

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

This response provides the historical rates for Gold and other metals on a specific date, allowing for trend analysis and market research.

Time-Series Endpoint

The Time-Series Endpoint allows you to get exchange rates for a specific time period. Below is a sample response:

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

This response illustrates how Gold rates have changed over a specified period, providing insights into market trends.

Convert Endpoint

The Convert Endpoint allows you to convert any amount from one metal to another or to/from USD. Here’s an example response:

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

This response shows the conversion of 1000 USD to Gold (XAU), resulting in 0.482 troy ounces based on the current exchange rate.

Fluctuation Endpoint

Track rate fluctuations between two dates using the Fluctuation Endpoint. Below is a sample response:

{
"success": true,
"fluctuation": true,
"start_date": "2026-06-22",
"end_date": "2026-06-29",
"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 and other metals have fluctuated over the specified period, highlighting both the numerical change and percentage change.

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

To get OHLC data for a specific time period, you can use the OHLC Price Endpoint. Here’s a sample response:

{
"success": true,
"timestamp": 1782692418,
"base": "USD",
"date": "2026-06-29",
"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 a comprehensive view of the price movements for Gold and other metals over a specific day, which is essential for traders conducting technical analysis.

Bid/Ask Endpoint

Retrieve current bid and ask prices for metals using the Bid/Ask Endpoint. Below is a sample response:

{
"success": true,
"timestamp": 1782692418,
"base": "USD",
"date": "2026-06-29",
"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, allowing traders to make informed decisions based on the spread.

Conclusion

Integrating the Metals-API into your applications provides a powerful tool for accessing real-time Gold exchange rates and other precious metals data. With its extensive features, including the Latest Rates, Historical Rates, and various conversion endpoints, developers can create sophisticated trading platforms that respond to market changes in real-time. By leveraging the API's capabilities, you can enhance your applications with valuable insights and data-driven decision-making tools.

For further exploration of the API's features and to access the complete documentation, visit the Metals-API Documentation. To view the full list of supported symbols, check out the Metals-API Supported Symbols page. The potential for innovation in the precious metals market is vast, and with the right tools, developers can lead the charge into a new era of digital finance.

Ready to use Metals-API?

Try it now!

Access Gold May 2027 (GCK27) API Integration Guide in JSON Format