Access Gold Bid (XAU-BID) - Per Ounce Historical Prices via Metals-API

In the ever-evolving landscape of precious metals trading, the ability to access real-time and historical data is paramount for developers and traders alike. The Metals-API provides a robust solution for obtaining historical prices of gold (XAU) and other metals, enabling users to make informed decisions based on accurate data. This blog post delves into the capabilities of the Metals-API, focusing on how to retrieve historical prices for gold and the innovative features that set this API apart in the digital transformation of precious metals trading.

About Gold (XAU)

Gold, represented by the symbol XAU, has long been a cornerstone of wealth preservation and investment. As a digital transformation unfolds in the precious metals market, the integration of technology and data analytics is reshaping how traders and investors engage with gold. The Metals-API stands at the forefront of this transformation, offering developers the tools to harness real-time data and historical insights.

With the rise of digital asset solutions, the demand for accurate and timely information has never been greater. The Metals-API empowers developers to build next-generation applications that leverage market insights, enabling them to innovate in price discovery and trading strategies. By utilizing advanced data analytics, users can gain a competitive edge in the market, making informed decisions based on comprehensive historical data.

API Description

The Metals-API is designed to provide seamless access to metals prices and currency conversion through a simple JSON API. This API is particularly valuable for developers looking to integrate precious metals data into their applications. With a focus on innovation and technological advancement, the Metals-API allows users to access real-time and historical data, empowering them to create applications that meet the demands of modern trading.

One of the standout features of the Metals-API is its ability to deliver real-time exchange rate data, updated frequently based on the user's subscription plan. This ensures that developers have access to the most current information, which is crucial for making timely trading decisions. Additionally, the API supports a wide range of endpoints, each designed to cater to specific needs, from retrieving the latest rates to accessing historical data dating back to 2019.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that provide different functionalities, allowing developers to tailor their applications to specific use cases. Here are some of the key features:

Latest Rates Endpoint: This endpoint returns real-time exchange rate data for metals, updated based on the user's subscription plan. For example, users can receive updates every 60 minutes or every 10 minutes, ensuring they have the latest market information at their fingertips.
Historical Rates Endpoint: Users can access historical rates for gold and other metals dating back to 2019. By appending a specific date to the API request, developers can retrieve historical price data, which is essential for trend analysis and market research.
Bid And Ask Endpoint: This powerful feature allows users to retrieve real-time bid and ask prices for metals. Understanding the bid-ask spread is crucial for traders looking to optimize their entry and exit points in the market.
Convert Endpoint: The Metals-API includes a currency conversion endpoint, enabling users to convert amounts from one metal to another or to/from USD. This feature is particularly useful for traders operating in multiple currencies.
Time-Series Endpoint: This endpoint allows users to query daily historical rates between two specified dates, providing insights into price movements over time. This is invaluable for identifying trends and making data-driven decisions.
Fluctuation Endpoint: Users can track how metal prices fluctuate on a day-to-day basis, which is essential for understanding market volatility and making informed trading decisions.
Carat Endpoint: This feature provides information about gold rates by carat, allowing users to understand the value of gold in different purities.
Lowest/Highest Price Endpoint: Users can query the API to find the lowest and highest prices for gold on a specific date, which is useful for identifying market extremes.
Open/High/Low/Close (OHLC) Price Endpoint: This endpoint provides open, high, low, and close prices for a specific date, offering a comprehensive view of market performance.
Historical LME Endpoint: For users interested in LME symbols, this endpoint provides historical rates dating back to 2008, allowing for in-depth analysis of market trends.
API Key: Each user is assigned a unique API key, which is required to access the API's features. This ensures secure and authorized access to the data.
API Response: The Metals-API delivers exchange rates relative to USD by default, with all data returned in a structured JSON format, making it easy for developers to integrate into their applications.
Available Endpoints: The API comes with a comprehensive list of endpoints, each designed to provide specific functionalities, ensuring that developers have the tools they need to build effective applications.
Supported Symbols Endpoint: This endpoint provides a constantly updated list of all available currencies and metals, allowing users to stay informed about the symbols they can work with.
Gold Price India Endpoint: Users can retrieve the latest gold price in India using this dedicated endpoint, which is particularly useful for traders operating in the Indian market.
News Endpoint: The Metals-API also provides access to the latest news articles related to various metals, keeping users 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. This resource is invaluable for developers looking to understand the various metals and currencies available through the API.

API Endpoint Examples and Responses

Understanding the API's response structure is crucial for effective integration. Below are examples of JSON responses for various endpoints:

Latest Rates Endpoint

{
    "success": true,
    "timestamp": 1743728579,
    "base": "USD",
    "date": "2025-04-04",
    "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 a successful request, providing the latest exchange rates for gold (XAU) and other metals relative to USD. The timestamp and date fields help users understand when the data was last updated.

Historical Rates Endpoint

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

This example demonstrates how to retrieve historical rates for a specific date. Developers can use this data to analyze past market performance and identify trends.

Time-series Endpoint

{
    "success": true,
    "timeseries": true,
    "start_date": "2025-03-28",
    "end_date": "2025-04-04",
    "base": "USD",
    "rates": {
        "2025-03-28": {
            "XAU": 0.000485,
            "XAG": 0.03825,
            "XPT": 0.000915
        },
        "2025-03-30": {
            "XAU": 0.000483,
            "XAG": 0.0382,
            "XPT": 0.000913
        },
        "2025-04-04": {
            "XAU": 0.000482,
            "XAG": 0.03815,
            "XPT": 0.000912
        }
    },
    "unit": "per troy ounce"
}

The time-series response provides daily rates for the specified period, allowing users to visualize price movements and analyze trends over time.

Convert Endpoint

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

This response illustrates how to convert an amount from one currency to another. In this case, it shows the conversion of 1000 USD to gold (XAU), providing the equivalent amount in troy ounces.

Fluctuation Endpoint

{
    "success": true,
    "fluctuation": true,
    "start_date": "2025-03-28",
    "end_date": "2025-04-04",
    "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 metal prices have changed over a specified period, highlighting both the absolute change and the percentage change. This information is vital for traders looking to understand market volatility.

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

{
    "success": true,
    "timestamp": 1743728579,
    "base": "USD",
    "date": "2025-04-04",
    "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 provides a comprehensive view of market performance for a specific date, detailing the opening, highest, lowest, and closing prices. This data is crucial for traders looking to analyze daily market behavior.

Bid/Ask Endpoint

{
    "success": true,
    "timestamp": 1743728579,
    "base": "USD",
    "date": "2025-04-04",
    "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 critical information for traders, including the current bid and ask prices for metals, along with the spread. This data is essential for making informed trading decisions.

Conclusion

The Metals-API is a powerful tool for developers looking to access real-time and historical data for gold and other precious metals. With its comprehensive range of endpoints and innovative features, the API empowers users to build applications that leverage market insights and data analytics. By integrating the Metals-API into their systems, developers can enhance their trading strategies and make informed decisions based on accurate data.

For more information on how to get started with the Metals-API, refer to the Metals-API Documentation. To explore the full range of supported symbols, visit the Metals-API Supported Symbols page. The Metals-API Website provides additional resources and support for developers looking to harness the power of metals data.

Ready to use Metals-API?

Try it now!

Documentation

API Endpoints

Knowledge Base

Access Gold Bid (XAU-BID) - Per Ounce Historical Prices via Metals-API