How to Retrieve Gold Aug 2026 (GCQ26) Historical Prices using this API

In the ever-evolving landscape of financial markets, the demand for accurate and timely data has never been more critical. For those interested in precious metals, particularly gold, retrieving historical prices is essential for making informed trading decisions. This blog post will guide you through the process of obtaining historical prices for Gold (XAU) using the Metals-API. We will explore the capabilities of this API, its innovative features, and how it can empower developers to create next-generation applications.

About Gold (XAU)

Gold has long been regarded as a safe-haven asset, a hedge against inflation, and a store of value. In recent years, the digital transformation in precious metals trading has opened new avenues for investors and traders alike. The integration of data analytics and market insights has revolutionized how market participants approach trading strategies. With the advent of technology, the price discovery process has become more transparent and efficient.

As digital asset solutions gain traction, the importance of real-time data cannot be overstated. The Metals-API provides a robust platform for accessing gold prices and other precious metals, enabling developers to build applications that leverage this data for trading, analysis, and investment purposes. By utilizing the Metals-API, you can access a wealth of information, including historical prices, real-time rates, and market fluctuations.

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, silver, platinum, and palladium. This API is built on the principles of innovation and technological advancement, allowing users to retrieve data seamlessly and efficiently.

One of the standout features of the Metals-API is its ability to deliver real-time exchange rate data, updated at intervals depending on your subscription plan. This means that whether you are a casual trader or a professional investor, you can access the latest market information to inform your decisions.

The API offers a variety of endpoints that cater to different needs, such as retrieving the latest rates, historical prices, bid and ask prices, and even currency conversion. Each endpoint is designed to provide specific functionalities, making it easier for developers to integrate the API into their applications.

Key Features and Endpoints

Understanding the various endpoints available in the Metals-API is crucial for effectively retrieving the data you need. 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, you can receive updates every 60 minutes or even every 10 minutes. This is particularly useful for traders who need to stay informed about market movements.
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 over time.
Bid and Ask Endpoint: This feature allows you to retrieve real-time bid and ask prices for gold. Understanding the spread between these prices is essential for making informed trading decisions.
Convert Endpoint: The Metals-API includes a currency conversion endpoint, enabling you to convert amounts between different metals or to/from USD. This is particularly useful for traders dealing with multiple currencies.
Time-Series Endpoint: This endpoint allows you to query daily historical rates between two dates of your choice. This is ideal for analyzing price movements over specific periods.
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 better decisions.
Carat Endpoint: Retrieve information about gold rates by carat. This is particularly useful for jewelers and those in the jewelry industry.
Lowest/Highest Price Endpoint: Query the API to get the lowest and highest prices for gold over a specified period. This information can be critical for identifying market trends.
Open/High/Low/Close (OHLC) Price Endpoint: This endpoint provides the open, high, low, and close prices for gold, allowing traders to analyze price movements comprehensively.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008. This is particularly useful for those involved in futures trading.
API Key: Your unique API key is essential for accessing the Metals-API. It must be included in your requests to authenticate your access.
API Response: The API delivers exchange rates relative to USD by default, ensuring consistency in the data you receive.
Supported Symbols Endpoint: This endpoint provides a constantly updated list of all available currencies and metals, ensuring you have access to the latest information.
Gold Price India Endpoint: Retrieve the latest gold price in India using this dedicated endpoint, which can be particularly useful for traders in that region.
News Endpoint: Stay updated with the latest news articles related to various metals, helping you stay informed about market developments.

API Endpoint Examples and Responses

To illustrate how to use the Metals-API effectively, let's take a closer look at some example responses for various endpoints.

Latest Rates Endpoint

{
    "success": true,
    "timestamp": 1759356035,
    "base": "USD",
    "date": "2025-10-01",
    "rates": {
        "XAU": 0.000482,
        "XAG": 0.03815,
        "XPT": 0.000912,
        "XPD": 0.000744
    },
    "unit": "per troy ounce"
}

The response above indicates a successful request for the latest rates, showing the price of gold (XAU) per troy ounce along with other metals.

Historical Rates Endpoint

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

This example shows how to retrieve historical rates for a specific date, providing valuable insights into past market performance.

Time-Series Endpoint

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

The time-series endpoint allows you to analyze price movements over a specified period, which is essential for identifying trends and making predictions.

Convert Endpoint

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

This example demonstrates how to convert an amount from USD to gold (XAU), providing a clear understanding of how much gold you can purchase with a specific amount of currency.

Fluctuation Endpoint

{
    "success": true,
    "fluctuation": true,
    "start_date": "2025-09-24",
    "end_date": "2025-10-01",
    "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"
}

The fluctuation endpoint provides insights into how gold prices have changed over a specified period, which can be invaluable for traders looking to capitalize on market movements.

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

{
    "success": true,
    "timestamp": 1759356035,
    "base": "USD",
    "date": "2025-10-01",
    "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 endpoint allows traders to analyze the price movements of gold throughout the trading day, providing critical data for making informed decisions.

Bid/Ask Endpoint

{
    "success": true,
    "timestamp": 1759356035,
    "base": "USD",
    "date": "2025-10-01",
    "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"
}

The bid/ask endpoint provides essential information for traders, allowing them to understand the current market conditions and make informed decisions based on the spread between buying and selling prices.

Conclusion

In conclusion, the Metals-API is an invaluable resource for anyone interested in trading precious metals, particularly gold. By leveraging its various endpoints, developers can access real-time and historical data, enabling them to make informed decisions based on accurate market information. Whether you are retrieving the latest rates, analyzing historical prices, or tracking fluctuations, the Metals-API provides the tools necessary for success in the precious metals market.

For more detailed information on how to implement these features, refer to the Metals-API Documentation. Additionally, you can explore the Metals-API Supported Symbols to find the specific metals you are interested in. With the right tools and data at your disposal, you can navigate the complexities of the precious metals market with confidence.

Ready to use Metals-API?

Try it now!

How to Retrieve Gold Aug 2026 (GCQ26) Historical Prices using this API