How to retrieve Surat Gold (XAU-SURA) prices with this API

Introduction

In the ever-evolving landscape of financial technology, the ability to retrieve real-time data on precious metals like Gold (XAU) has become increasingly essential for developers and traders alike. The Metals-API provides a robust solution for accessing up-to-date pricing information, historical data, and various analytical insights. This blog post will delve into the intricacies of retrieving Surat Gold (XAU-SURA) prices using the Metals-API, exploring its features, capabilities, and the transformative potential of real-time metals data.

Metals-API Information

About Gold (XAU)

Gold, represented by the symbol XAU, is not just a precious metal; it is a digital asset that has undergone significant transformation in the age of technology. The digital transformation in precious metals trading has led to enhanced data analytics and market insights, allowing traders to make informed decisions based on real-time data. The integration of technology in trading has revolutionized the way investors approach the gold market, enabling them to leverage innovative price discovery methods.

With the rise of digital asset solutions, the demand for accurate and timely gold pricing has surged. The Metals-API stands at the forefront of this evolution, offering developers the tools necessary to build next-generation applications that can harness the power of real-time metals data. By utilizing this API, developers can create applications that not only track gold prices but also analyze market trends, providing users with valuable insights into their investments.

API Description

The Metals-API is designed to empower developers by providing access to a comprehensive suite of features that facilitate the retrieval of metals pricing data. With a focus on innovation and technological advancement, this API allows users to build applications that can respond to market changes in real-time. The API supports a variety of endpoints, each tailored to meet specific needs, from retrieving the latest rates to accessing historical data.

For detailed documentation on how to implement these features, developers can refer to the Metals-API Documentation. This resource provides comprehensive guidance on how to utilize the API effectively, including examples and best practices.

Key Features and Endpoints

The Metals-API offers a range of endpoints that cater to different aspects of metals trading. Here’s a closer look at some of the key features:

• Latest Rates Endpoint: This endpoint provides real-time exchange rate data for precious metals. Depending on your subscription plan, the API can return updates every 60 minutes, every 10 minutes, or even more frequently. This feature is crucial for traders who need to make quick decisions based on the latest market data.
• Historical Rates Endpoint: Access to historical rates dating back to 2019 allows developers to analyze trends over time. By appending a specific date to the API request, users can retrieve past pricing data, which is essential for conducting thorough market analysis.
• Bid And Ask Endpoint: This powerful feature provides real-time bid and ask prices for metals, enabling traders to understand the market dynamics better. The bid price represents the highest price a buyer is willing to pay, while the ask price is the lowest price a seller is willing to accept.
• Convert Endpoint: The Metals-API includes a currency conversion endpoint, allowing users to convert any amount from one metal to another or to/from USD. This feature is particularly useful for traders who operate in multiple currencies.
• Time-Series Endpoint: This endpoint allows users to query daily historical rates between two specified dates. It is beneficial for analyzing price movements over a defined period, helping traders identify patterns and make informed decisions.
• Fluctuation Endpoint: By utilizing the fluctuation endpoint, users can track how metal prices fluctuate on a day-to-day basis. This feature provides insights into market volatility, which is crucial for risk management.
• Carat Endpoint: This unique feature allows users to retrieve information about gold rates by carat, providing a more granular view of gold pricing based on purity.
• Lowest/Highest Price Endpoint: Users can query the API to get the lowest and highest prices for a specified date, which is essential for understanding market extremes.
• Open/High/Low/Close (OHLC) Price Endpoint: This endpoint provides open, high, low, and close prices for a specific time period, allowing traders to analyze market performance comprehensively.
• Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, enabling users to analyze long-term trends in the metals market.
• API Key: The API key is a unique identifier that must be included in the API requests to authenticate and authorize access to the data.
• API Response: The API delivers exchange rates relative to USD by default, ensuring consistency in data representation.
• Available Endpoints: The Metals-API offers a total of 14 endpoints, each designed to provide different functionalities, ensuring comprehensive coverage of metals data.
• Supported Symbols Endpoint: This endpoint returns a constantly updated list of all available currencies and metals, allowing users to stay informed about the options available for trading.
• News Endpoint: Retrieve the latest news articles related to various metals, providing users with context and insights into market movements.

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 integrate metals data into their applications.

API Endpoint Examples and Responses

Understanding the structure of API responses is crucial for effective integration. Below are examples of various API responses for different endpoints:

Latest Rates Endpoint

Get real-time exchange rates for all available metals:

{
"success": true,
"timestamp": 1766019623,
"base": "USD",
"date": "2025-12-18",
"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": 1765933223,
"base": "USD",
"date": "2025-12-17",
"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-12-11",
"end_date": "2025-12-18",
"base": "USD",
"rates": {
"2025-12-11": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2025-12-13": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2025-12-18": {
"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": 1766019623,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}

Fluctuation Endpoint

Track rate fluctuations between two dates:

{
"success": true,
"fluctuation": true,
"start_date": "2025-12-11",
"end_date": "2025-12-18",
"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": 1766019623,
"base": "USD",
"date": "2025-12-18",
"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": 1766019623,
"base": "USD",
"date": "2025-12-18",
"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

In conclusion, the Metals-API offers a comprehensive and innovative solution for developers looking to retrieve real-time data on precious metals like Gold (XAU). With its extensive range of endpoints, the API empowers users to access the latest rates, historical data, and analytical insights that are crucial for making informed trading decisions. By leveraging the capabilities of the Metals-API, developers can create powerful applications that not only track prices but also analyze market trends and fluctuations.

For those interested in exploring the full potential of the Metals-API, it is recommended to review the Metals-API Documentation for detailed implementation guidance. Additionally, the Metals-API Supported Symbols page provides valuable information on the various metals available for trading. As the financial landscape continues to evolve, staying informed and utilizing advanced tools like the Metals-API will be key to success in the precious metals market.