How to retrieve Gold Jan 2027 (GCF27) prices with an API

Introduction

In the evolving landscape of financial technology, the ability to retrieve real-time data on precious metals such as Gold (XAU) is crucial for traders, investors, and developers alike. This blog post will explore how to retrieve Gold Jan 2027 (GCF27) prices using the Metals-API. We will delve into the API's capabilities, its various endpoints, and how it can empower developers to create innovative applications that leverage real-time metals data.

Metals-API Information

About Gold (XAU)

Gold has long been a symbol of wealth and stability, often serving as a hedge against inflation and currency fluctuations. In recent years, the digital transformation in precious metals has opened new avenues for trading and investment. The integration of data analytics and market insights has enabled traders to make informed decisions based on real-time data. With the advent of technology in trading, innovations in price discovery have emerged, allowing for more accurate valuations and trading strategies.

The rise of digital asset solutions has further revolutionized the way investors interact with Gold. By utilizing APIs like Metals-API, developers can access a wealth of information about Gold prices, historical trends, and market fluctuations, enabling them to build next-generation applications that cater to the needs of modern traders.

API Description

The Metals-API is a powerful tool designed to provide real-time and historical data on various metals, including Gold, Silver, Platinum, and Palladium. This API allows developers to access a wide range of functionalities, enabling them to create applications that can analyze market trends, track price fluctuations, and convert between different metal values.

With its innovative approach to data delivery, Metals-API empowers developers to build applications that can respond to market changes in real-time. The API's capabilities include retrieving the latest rates, historical data, bid and ask prices, and much more. By leveraging this data, developers can create tools that enhance trading strategies and improve decision-making processes.

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: Depending on your subscription plan, this endpoint provides real-time exchange rate data updated every 60 minutes, every 10 minutes, or even more frequently. This feature is essential for traders who need the most current pricing information.
• Historical Rates Endpoint: Access historical rates for most currencies dating back to 2019. By appending a specific date, developers can query the API for past rates, which is invaluable for trend analysis and forecasting.
• Bid And Ask Endpoint: This powerful feature allows users to retrieve real-time bid and ask prices, providing insights into market liquidity and pricing dynamics.
• Convert Endpoint: This endpoint enables the conversion of any amount from one currency to another, facilitating transactions and calculations across different metals.
• Time-Series Endpoint: Developers can query the API for daily historical rates between two chosen dates, allowing for in-depth analysis of price movements over time.
• Fluctuation Endpoint: This feature provides information about how currencies fluctuate on a day-to-day basis, helping traders understand market volatility.
• Carat Endpoint: Users can retrieve information about Gold rates by Carat, which is particularly useful for jewelers and those in the luxury goods market.
• Lowest/Highest Price Endpoint: This endpoint allows users to query the API for the lowest and highest prices over a specified period, aiding in market analysis.
• Open/High/Low/Close (OHLC) Price Endpoint: Users can obtain OHLC data for a specific time period, which is crucial for technical analysis.
• Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, providing a comprehensive view of market trends.
• API Key: The unique key required to access the API, ensuring secure and authorized usage.
• API Response: Exchange rates are delivered relative to USD by default, with all data returned in a structured JSON format.
• Available Endpoints: The API features 14 endpoints, each offering different functionalities to cater to various user needs.
• Supported Symbols Endpoint: This constantly updated endpoint returns all available currencies, allowing users to stay informed about the latest offerings.
• News Endpoint: Retrieve the latest news articles related to various metals, keeping users updated on 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 how to interact with the Metals-API is crucial for effective implementation. Below are examples of various endpoints and their corresponding JSON responses:

Latest Rates Endpoint

Get real-time exchange rates for all available metals.

{
"success": true,
"timestamp": 1771114094,
"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 the success of the request and provides the latest 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.

{
"success": true,
"timestamp": 1771027694,
"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 rates for Gold and other metals on a specific date, allowing for analysis of past market conditions.

Time-series Endpoint

Get exchange rates for a specific time period.

{
"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 a time series of rates for Gold and other metals, enabling users to analyze trends over the specified period.

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": 1771114094,
"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, demonstrating the utility of the Convert Endpoint.

Fluctuation Endpoint

Track rate fluctuations between two dates.

{
"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 and other metals fluctuated over the specified period, highlighting both the absolute and percentage changes.

OHLC (Open/High/Low/Close) Endpoint

Get OHLC data for a specific time period.

{
"success": true,
"timestamp": 1771114094,
"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 and other metals, essential for traders conducting technical analysis.

Bid/Ask Endpoint

Get current bid and ask prices for metals.

{
"success": true,
"timestamp": 1771114094,
"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, Silver, and Platinum, along with the spread, which is crucial for traders looking to execute orders efficiently.

Conclusion

The Metals-API is an invaluable resource for developers and traders looking to access real-time and historical data on precious metals like Gold. By utilizing its various endpoints, users can retrieve the latest rates, analyze historical trends, track fluctuations, and convert between different metals. The API's capabilities empower developers to create innovative applications that enhance trading strategies and improve decision-making processes.

For more detailed information on how to implement these features, refer to the Metals-API Documentation. To explore the full range of supported symbols, visit the Metals-API Supported Symbols page. With the right tools and knowledge, developers can harness the power of real-time metals data to drive their applications forward.