Step-by-Step Guide to Get Surat Gold 24k (SURA-24k) Historical Prices using this API
Step-by-Step Guide to Get Surat Gold 24k (SURA-24k) Historical Prices using Metals-API
In the world of precious metals, gold (XAU) stands out as a symbol of wealth and stability. As digital transformation reshapes the financial landscape, the demand for accurate and real-time data on gold prices has surged. This guide will walk you through the process of obtaining historical prices for Surat Gold 24k (SURA-24k) using the Metals-API. We will explore the capabilities of this powerful API, its endpoints, and how you can leverage it to gain insights into gold pricing trends.
About Gold (XAU)
Gold has long been considered a safe haven asset, especially during times of economic uncertainty. With the rise of digital asset solutions, the integration of technology in trading precious metals has become more prevalent. The Metals-API provides developers with the tools needed to access real-time and historical data on gold prices, enabling them to create innovative applications that can analyze market trends and provide insights.
As we delve into the capabilities of the Metals-API, we will explore how data analytics can enhance market insights, the role of technology in price discovery, and the potential for innovation in trading practices. By utilizing the API, developers can build next-generation applications that not only track gold prices but also analyze fluctuations and trends over time.
API Description
The Metals-API is a robust JSON API that provides real-time and historical data for various metals, including gold, silver, platinum, and palladium. It empowers developers to create applications that can fetch current prices, historical rates, and perform currency conversions with ease. The API's capabilities extend beyond mere price retrieval; it offers a comprehensive suite of features that can transform how developers interact with precious metals data.
For detailed information on how to use the API, refer to the Metals-API Documentation. This resource provides comprehensive guidance on authentication, endpoints, and response structures.
Key Features and Endpoints
The Metals-API offers a variety of endpoints that cater to different data needs. Here are some of the key features:
- Latest Rates Endpoint: This endpoint provides real-time exchange rate data for metals, updated based on your subscription plan. Depending on the plan, updates can occur every 60 minutes or every 10 minutes, ensuring you have access to the most current pricing information.
- Historical Rates Endpoint: Access historical rates for most currencies dating back to 2019. By appending a specific date in the format YYYY-MM-DD, you can retrieve the historical price of gold and other metals.
- Bid And Ask Endpoint: This feature allows you to retrieve real-time bid and ask prices for metals, providing insights into market dynamics and trading opportunities.
- Convert Endpoint: The API includes a currency conversion feature that enables you to convert amounts from one currency to another, facilitating transactions and analysis.
- Time-Series Endpoint: This endpoint allows you to query daily historical rates between two dates, providing a comprehensive view of price movements over time.
- Fluctuation Endpoint: Track how prices fluctuate on a day-to-day basis, which can be crucial for traders looking to capitalize on market movements.
- Carat Endpoint: Retrieve gold rates by carat, allowing for precise calculations based on the purity of gold.
- Lowest/Highest Price Endpoint: Query the API to get the lowest and highest prices for a specific date, which can help in understanding market extremes.
- Open/High/Low/Close (OHLC) Price Endpoint: This endpoint provides 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, useful for comprehensive market analysis.
- API Key: Your unique API key is essential for accessing the API and must be included in your requests.
- API Response: The API returns exchange rates relative to USD by default, with all data structured in a consistent JSON format.
- Available Endpoints: The Metals-API includes 14 endpoints, each designed to provide specific functionalities related to metals pricing.
- Supported Symbols Endpoint: This endpoint returns a constantly updated list of all available currencies and metals, ensuring you have the latest information.
- News Endpoint: Retrieve the latest news articles related to various metals, keeping you informed about market developments.
For a complete list of supported symbols, refer to the Metals-API Supported Symbols page.
API Endpoint Examples and Responses
Understanding the API's response structure is crucial for effective implementation. 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": 1778113068,
"base": "USD",
"date": "2026-05-07",
"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": 1778026668,
"base": "USD",
"date": "2026-05-06",
"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": "2026-04-30",
"end_date": "2026-05-07",
"base": "USD",
"rates": {
"2026-04-30": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-05-02": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-05-07": {
"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": 1778113068,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}
Fluctuation Endpoint
Track rate fluctuations between two dates:
{
"success": true,
"fluctuation": true,
"start_date": "2026-04-30",
"end_date": "2026-05-07",
"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": 1778113068,
"base": "USD",
"date": "2026-05-07",
"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": 1778113068,
"base": "USD",
"date": "2026-05-07",
"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 provides a comprehensive solution for accessing real-time and historical data on gold prices, including Surat Gold 24k (SURA-24k). By leveraging its various endpoints, developers can create applications that not only track prices but also analyze trends, fluctuations, and market dynamics. The API's capabilities extend beyond simple price retrieval, offering a wealth of information that can be harnessed for advanced analytics and trading strategies.
For further exploration of the API's features, visit the Metals-API Documentation and discover how to integrate these powerful tools into your applications. Additionally, for a complete list of supported symbols, check out the Metals-API Supported Symbols page. Embrace the future of precious metals trading with the innovative solutions offered by the Metals-API Website.