Get Surat Gold 18k (SURA-18k) prices using this API

Introduction

In the ever-evolving landscape of precious metals trading, the demand for accurate and real-time data has never been more critical. Gold, represented by the symbol XAU, remains a cornerstone of investment portfolios and a safe haven during economic uncertainty. To navigate this dynamic market effectively, developers and traders alike can leverage the power of the Metals-API. This API provides comprehensive access to gold prices, market insights, and advanced analytics, enabling the creation of innovative applications that can transform how we interact with precious metals.

About Gold (XAU)

Gold has long been revered not only for its intrinsic value but also for its role as a hedge against inflation and currency fluctuations. The digital transformation in precious metals trading has opened new avenues for data analytics and market insights. By integrating technology into trading practices, investors can make informed decisions based on real-time data. The Metals-API Documentation provides a detailed overview of how developers can utilize this powerful tool to access gold prices and other metal data seamlessly.

Digital Transformation in Precious Metals

The integration of technology in the precious metals market has led to significant advancements in price discovery and trading efficiency. The Metals-API empowers developers to build applications that can analyze market trends, track fluctuations, and provide insights into historical data. This capability is essential for traders looking to capitalize on market movements and optimize their investment strategies.

Data Analytics and Market Insights

With the Metals-API, users can access a wealth of data that can be analyzed to uncover market trends and insights. For instance, the API's historical rates endpoint allows users to retrieve data dating back to 2019, enabling comprehensive analysis of price movements over time. This data can be crucial for making informed trading decisions and understanding market dynamics.

Technology Integration in Trading

The Metals-API offers various endpoints that facilitate the integration of real-time data into trading platforms. For example, the latest rates endpoint provides up-to-date exchange rates for gold and other metals, allowing traders to react swiftly to market changes. This level of integration is vital for maintaining a competitive edge in the fast-paced world of precious metals trading.

Innovation in Price Discovery

Price discovery in the gold market has been revolutionized by the availability of real-time data through APIs like Metals-API. By utilizing features such as the bid and ask endpoint, traders can access current bid and ask prices, enabling them to make timely decisions based on market conditions. This innovation enhances transparency and efficiency in the trading process.

Digital Asset Solutions

The Metals-API is not just limited to providing price data; it also offers digital asset solutions that can be integrated into various applications. Developers can utilize the convert endpoint to facilitate currency conversions, making it easier for users to understand the value of gold in different currencies. This feature is particularly useful for international traders and investors.

API Description

The Metals-API is a robust tool designed to provide developers with access to real-time metals data, including gold prices. Its capabilities extend beyond mere price retrieval; it empowers users to build next-generation applications that can analyze, visualize, and interpret market data effectively. The API supports a wide range of functionalities, making it an invaluable resource for anyone involved in precious metals trading.

Key Features and Endpoints

The Metals-API boasts a variety of endpoints, each designed to cater to specific needs within the metals trading ecosystem. Here are some of the key features:

• Latest Rates Endpoint: Depending on your subscription plan, this endpoint returns real-time exchange rate data updated every 60 minutes, every 10 minutes, or even more frequently. This ensures that traders always have access to the most current market information.
• Historical Rates Endpoint: Users can query historical rates for most currencies dating back to 2019. By appending a date in the format YYYY-MM-DD, traders can analyze past price movements and trends.
• Bid And Ask Endpoint: This powerful feature allows users to retrieve real-time bid and ask prices, providing insights into the current market spread and facilitating better trading decisions.
• Convert Endpoint: The Metals-API includes a separate currency conversion endpoint, enabling users to convert any amount from one currency to another, enhancing usability for international transactions.
• Time-Series Endpoint: This endpoint allows users to query the API for daily historical rates between two dates of their choice, providing a comprehensive view of price trends over time.
• Fluctuation Endpoint: Users can track how currencies fluctuate on a day-to-day basis, gaining insights into market volatility and trends.
• Carat Endpoint: This feature allows users to retrieve information about gold rates by carat, catering to jewelers and consumers interested in specific gold qualities.
• Lowest/Highest Price Endpoint: Users can query the API to get the lowest and highest prices for a specified date, aiding in market analysis.
• Open/High/Low/Close (OHLC) Price Endpoint: This endpoint provides users with the open, high, low, and close prices for a specific date, essential for technical analysis.
• Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, providing a long-term view of market trends.
• API Key: Each user receives a unique API key that must be included in requests to authenticate and authorize access to the API.
• API Response: Exchange rates delivered by the Metals-API are relative to USD, ensuring consistency in data interpretation.
• Available Endpoints: The API offers 14 endpoints, each providing different functionalities to cater to diverse user needs.
• Supported Symbols Endpoint: This constantly updated endpoint returns all available currencies, ensuring users have access to the latest information.

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

API Endpoint Examples and Responses

Understanding the API's response structure is crucial for effective integration. 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": 1782259818,
"base": "USD",
"date": "2026-06-24",
"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 that the API successfully retrieved the latest rates, with the base currency being USD. The rates for various metals are provided, allowing users to see the current market values.

Historical Rates Endpoint

Access historical exchange rates for any date since 1999.

{
"success": true,
"timestamp": 1782173418,
"base": "USD",
"date": "2026-06-23",
"rates": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915,
"XPD": 0.000748
},
"unit": "per troy ounce"
}

This response shows the historical rates for a specific date, allowing users to analyze past market performance.

Time-series Endpoint

Get exchange rates for a specific time period.

{
"success": true,
"timeseries": true,
"start_date": "2026-06-17",
"end_date": "2026-06-24",
"base": "USD",
"rates": {
"2026-06-17": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-06-19": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-06-24": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912
}
},
"unit": "per troy ounce"
}

This response provides a time series of rates between two specified dates, allowing for trend analysis over time.

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": 1782259818,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}

This response demonstrates the conversion of an amount from USD to gold (XAU), providing the resulting value in troy ounces.

Fluctuation Endpoint

Track rate fluctuations between two dates.

{
"success": true,
"fluctuation": true,
"start_date": "2026-06-17",
"end_date": "2026-06-24",
"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 information on how the rates have changed over a specified period, offering insights into market volatility.

OHLC (Open/High/Low/Close) Endpoint

Get OHLC data for a specific time period.

{
"success": true,
"timestamp": 1782259818,
"base": "USD",
"date": "2026-06-24",
"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 a specific date, which is crucial for technical analysis and trading strategies.

Bid/Ask Endpoint

Get current bid and ask prices for metals.

{
"success": true,
"timestamp": 1782259818,
"base": "USD",
"date": "2026-06-24",
"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 various metals, allowing traders to assess market conditions and make informed decisions.

Conclusion

The Metals-API is a powerful tool that offers developers and traders access to real-time and historical data on precious metals, including gold (XAU). By leveraging its various endpoints, users can gain valuable insights into market trends, track fluctuations, and make informed trading decisions. The integration of technology into precious metals trading has transformed the landscape, enabling innovative applications that enhance trading efficiency and transparency.

For those looking to delve deeper into the capabilities of the Metals-API, the Metals-API Documentation provides comprehensive guidance on how to utilize its features effectively. Additionally, the Metals-API Supported Symbols page offers a complete list of available symbols, ensuring users have access to the latest market information.

As the market for precious metals continues to evolve, the Metals-API stands out as an essential resource for developers and traders seeking to harness the power of real-time data in their trading strategies.