Understanding how to Get Surat Gold 18k (SURA-18k) Historical Prices using this API

In the world of precious metals trading, understanding historical prices is crucial for making informed decisions. One of the most sought-after metals is gold, represented by the symbol XAU. With the rise of digital transformation in the precious metals market, developers and traders alike are leveraging APIs to access real-time and historical data. One such powerful tool is the Metals-API, which provides comprehensive data on various metals, including gold. This blog post will delve into how to retrieve historical prices for Surat Gold 18k (SURA-18k) using the Metals-API, exploring its features, capabilities, and practical applications.

About Gold (XAU)

Gold has long been a symbol of wealth and stability, often serving as a hedge against inflation and economic uncertainty. In recent years, the digital transformation of the precious metals market has opened new avenues for trading and investment. The integration of data analytics and technology in trading has revolutionized how investors approach the market. With the advent of APIs like Metals-API, traders can now access real-time market insights and historical data, enabling them to make data-driven decisions.

Data analytics plays a pivotal role in understanding market trends and price movements. By utilizing the Metals-API, developers can create applications that analyze historical gold prices, identify patterns, and forecast future trends. This innovation in price discovery is essential for traders looking to optimize their strategies and maximize returns.

Metals-API Overview

The Metals-API is a robust API that provides real-time and historical data for various metals, including gold, silver, platinum, and palladium. It empowers developers to build next-generation applications that can access and analyze metal prices efficiently. The API offers a range of endpoints, each designed to cater to specific data needs, from retrieving the latest rates to accessing historical data dating back to 2019.

One of the standout features of the Metals-API is its ability to deliver real-time exchange rate data. Depending on your subscription plan, the API can provide updates every 60 minutes, every 10 minutes, or even more frequently. This flexibility allows developers to tailor their applications to meet specific requirements, ensuring that users have access to the most current data available.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that can be utilized for different purposes. Here are some of the key features:

Latest Rates Endpoint: This endpoint provides real-time exchange rates for all available metals. For example, a request to this endpoint might return the current price of gold (XAU) in USD.
Historical Rates Endpoint: Users can access historical rates for most currencies dating back to 2019. By appending a specific date to the API request, developers can retrieve historical prices for gold, allowing for in-depth analysis.
Bid And Ask Endpoint: This feature enables users to retrieve real-time bid and ask prices for metals, which is crucial for traders looking to execute transactions at optimal prices.
Convert Endpoint: The Metals-API includes a currency conversion endpoint that allows users to convert amounts between different metals or to/from USD, facilitating seamless transactions.
Time-Series Endpoint: This endpoint allows users to query the API for daily historical rates between two specified dates, making it easier to analyze trends over time.
Fluctuation Endpoint: Users can track how metal prices fluctuate on a day-to-day basis, providing insights into market volatility.
Carat Endpoint: This endpoint provides information about gold rates by carat, which is particularly useful for jewelers and consumers interested in purchasing gold jewelry.
Lowest/Highest Price Endpoint: Users can query the API to get the lowest and highest prices for a specified date, which can help in 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: This endpoint provides access to historical rates for LME symbols dating back to 2008, which is essential for traders focused on industrial metals.
API Key: Each user is assigned a unique API key that must be included in requests to authenticate access to the API.
API Response: The API delivers exchange rates relative to USD by default, ensuring consistency across data retrieval.
Available Endpoints: The Metals-API features 14 different endpoints, each offering unique functionalities tailored to various data needs.
Supported Symbols Endpoint: This endpoint provides a constantly updated list of all available metal symbols, ensuring users have access to the latest information.
News Endpoint: Users can retrieve the latest news articles related to various metals, keeping them informed about market developments.

API Endpoint Examples and Responses

To illustrate the capabilities of the Metals-API, let’s explore some example responses from key endpoints:

Latest Rates Endpoint

{
"success": true,
"timestamp": 1771546772,
"base": "USD",
"date": "2026-02-20",
"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 current price of gold (XAU) is 0.000482 per troy ounce, providing a snapshot of the market at that moment.

Historical Rates Endpoint

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

This example shows the historical price of gold on a specific date, allowing users to analyze past performance and trends.

Time-Series Endpoint

{
"success": true,
"timeseries": true,
"start_date": "2026-02-13",
"end_date": "2026-02-20",
"base": "USD",
"rates": {
"2026-02-13": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-02-15": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-02-20": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912
}
},
"unit": "per troy ounce"
}

The time-series response provides daily rates for gold over a specified period, enabling users to visualize trends and fluctuations.

Convert Endpoint

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

This response demonstrates the conversion of an amount from USD to gold (XAU), showing that $1000 is equivalent to 0.482 troy ounces of gold.

Fluctuation Endpoint

{
"success": true,
"fluctuation": true,
"start_date": "2026-02-13",
"end_date": "2026-02-20",
"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 response provides insights into how the price of gold has changed over a specified period, highlighting both the absolute change and the percentage change.

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

{
"success": true,
"timestamp": 1771546772,
"base": "USD",
"date": "2026-02-20",
"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 the market performance for gold, including the opening, highest, lowest, and closing prices for a specific date.

Bid/Ask Endpoint

{
"success": true,
"timestamp": 1771546772,
"base": "USD",
"date": "2026-02-20",
"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 response provides critical information for traders, indicating the current bid and ask prices for gold, along with the spread, which is essential for executing trades effectively.

Practical Use Cases and Integration Strategies

Integrating the Metals-API into applications can unlock numerous possibilities for developers and traders. Here are some practical use cases:

Market Analysis Tools: Developers can build applications that analyze historical gold prices, providing users with insights into market trends and potential investment opportunities.
Trading Bots: By leveraging real-time data from the Metals-API, developers can create automated trading bots that execute trades based on predefined criteria, optimizing trading strategies.
Portfolio Management: Investors can use the API to track the performance of their gold investments, allowing for better portfolio management and decision-making.
Financial Reporting: Businesses dealing in precious metals can integrate the API into their reporting systems, ensuring accurate and up-to-date financial data.

Common Developer Questions

As developers explore the Metals-API, they may encounter common questions regarding its usage:

How do I authenticate my requests? Each request must include your unique API key as a parameter to authenticate access to the API.
What is the rate limit for API requests? Rate limits vary based on your subscription plan. Be sure to check the documentation for specific details.
How can I handle errors in API responses? The API provides error codes and messages in its responses. Developers should implement error handling to manage these scenarios effectively.

Conclusion

In conclusion, the Metals-API is a powerful tool for accessing historical prices and real-time data for precious metals like gold. By leveraging its various endpoints, developers can create innovative applications that enhance trading strategies, market analysis, and investment decision-making. With the ability to retrieve historical rates, track fluctuations, and convert between different metals, the API empowers users to navigate the complex world of precious metals trading with confidence.

For more information on how to get started with the Metals-API, refer to the Metals-API Documentation and explore the Metals-API Supported Symbols for a comprehensive list of available metals. Whether you are a seasoned trader or a developer looking to integrate precious metals data into your applications, the Metals-API offers the tools you need to succeed.

Ready to use Metals-API?

Try it now!

Understanding how to Get Surat Gold 18k (SURA-18k) Historical Prices using this API