Home
Blog
How to retrieve Gold Bid (XAU-BID) prices using this API

How to retrieve Gold Bid (XAU-BID) prices using this API

How to retrieve Gold Bid (XAU-BID) prices using this API

How to Retrieve Gold Bid (XAU-BID) Prices Using the Metals-API

In the world of finance, the ability to access real-time data is crucial, especially when it comes to precious metals like gold. The Metals-API provides developers with a powerful tool to retrieve Gold Bid (XAU-BID) prices and other metal rates efficiently. This blog post will explore the significance of gold in the financial markets, the innovative capabilities of the Metals-API, and how you can leverage its features to enhance your applications.

Metals-API Information

About Gold (XAU)

Gold, represented by the symbol XAU, has long been a cornerstone of wealth and value. As a precious metal, it plays a pivotal role in various markets, from jewelry to investment. The digital transformation in precious metals trading has ushered in a new era where data analytics and market insights are paramount. With the integration of technology, traders can now access real-time data, enabling them to make informed decisions swiftly.

The innovation in price discovery has been remarkable, with digital asset solutions allowing for more transparent and efficient trading. The Metals-API stands at the forefront of this transformation, offering developers the tools needed to build next-generation applications that can tap into the dynamic world of precious metals trading.

API Description

The Metals-API is designed to provide real-time and historical data for various metals, including gold, silver, platinum, and palladium. This API empowers developers to create applications that can analyze market trends, track price fluctuations, and convert currencies seamlessly. By utilizing the Metals-API, developers can harness the transformative potential of real-time metals data, enabling them to build robust financial applications.

For more information, visit the Metals-API Website or check out the Metals-API Documentation for detailed guidance on implementation.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that cater to different needs. Here’s a closer look at 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 applications that require up-to-the-minute pricing information.
  • Historical Rates Endpoint: Access historical rates for most currencies dating back to 2019. By appending a specific date to your query, you can retrieve past prices, which is invaluable for trend analysis and forecasting.
  • Bid And Ask Endpoint: This powerful feature allows you to retrieve real-time Bid and Ask prices for metals. Understanding the spread between these prices is crucial for traders looking to optimize their transactions.
  • Convert Endpoint: The Metals-API includes a currency conversion endpoint, enabling you to convert any amount from one metal to another or to/from USD. This feature simplifies transactions across different currencies.
  • Time-Series Endpoint: Query the API for daily historical rates between two dates of your choice. This endpoint is particularly useful for analyzing trends over specific periods.
  • Fluctuation Endpoint: Retrieve information about how currencies fluctuate on a day-to-day basis. This endpoint helps traders understand market volatility and make informed decisions.
  • Carat Endpoint: Get information about Gold rates by Carat. This feature is particularly useful for jewelers and those in the jewelry industry.
  • Lowest/Highest Price Endpoint: Query the API to get the lowest and highest price for a specific date. This information is crucial for traders looking to identify market extremes.
  • Open/High/Low/Close (OHLC) Price Endpoint: This endpoint provides the open, high, low, and close prices for a given date, allowing traders to analyze market performance comprehensively.
  • Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, providing a wealth of data for analysis.
  • API Key: Your unique API Key is essential for accessing the API. It must be included in the API base URL's access_key parameter.
  • API Response: The exchange rates delivered by the Metals-API are relative to USD by default. All data is returned in a structured JSON format, making it easy to integrate into applications.
  • Available Endpoints: The Metals-API offers multiple endpoints, each providing different functionalities to cater to various needs.
  • Supported Symbols Endpoint: This endpoint returns all available currencies, ensuring you have access to the latest symbols.
  • Gold Price India Endpoint: Retrieve the latest gold price in India using this dedicated endpoint, which is particularly useful for regional traders.
  • News Endpoint: Stay updated with the latest news articles related to various metals, helping you keep track of market trends and 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

Latest Rates Endpoint

Get real-time exchange rates for all available metals.

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

Historical Rates Endpoint

Access historical exchange rates for any date since 1999.

{
    "success": true,
    "timestamp": 1746237741,
    "base": "USD",
    "date": "2025-05-03",
    "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": "2025-04-27",
    "end_date": "2025-05-04",
    "base": "USD",
    "rates": {
        "2025-04-27": {
            "XAU": 0.000485,
            "XAG": 0.03825,
            "XPT": 0.000915
        },
        "2025-04-29": {
            "XAU": 0.000483,
            "XAG": 0.0382,
            "XPT": 0.000913
        },
        "2025-05-04": {
            "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": 1746324141,
        "rate": 0.000482
    },
    "result": 0.482,
    "unit": "troy ounces"
}

Fluctuation Endpoint

Track rate fluctuations between two dates.

{
    "success": true,
    "fluctuation": true,
    "start_date": "2025-04-27",
    "end_date": "2025-05-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"
}

OHLC (Open/High/Low/Close) Endpoint

Get OHLC data for a specific time period.

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

Bid/Ask Endpoint

Get current bid and ask prices for metals.

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

Conclusion

The Metals-API is a powerful tool for developers looking to integrate real-time and historical data for precious metals into their applications. With features like the Latest Rates Endpoint, Historical Rates Endpoint, and Bid/Ask Endpoint, developers can create sophisticated trading applications that provide users with valuable insights into the metals market.

By leveraging the capabilities of the Metals-API, you can enhance your applications with real-time data, enabling better decision-making and improved trading strategies. For more information on how to implement these features, refer to the Metals-API Documentation and explore the Metals-API Supported Symbols for a comprehensive list of available metals.

In a rapidly evolving financial landscape, staying informed and having access to accurate data is crucial. The Metals-API provides the tools necessary to navigate this landscape effectively, making it an essential resource for any developer working with precious metals.

Ready to use Metals-API?

Try it now!

Search

Recent Posts