How to retrieve Surat Gold 24k (SURA-24k) prices from a public API

Introduction
In today's rapidly evolving financial landscape, the ability to retrieve real-time data on precious metals like gold is crucial for traders, investors, and developers alike. One such valuable resource is the Surat Gold 24k (SURA-24k), which represents a significant market for gold trading. To effectively access and utilize this data, developers can leverage the Metals-API, a powerful tool designed to provide comprehensive insights into metal prices, including gold, silver, platinum, and palladium.
Metals-API Information
About Gold (XAU)
Gold, represented by the symbol XAU, has long been a cornerstone of financial markets, serving as a safe haven during economic uncertainty. The digital transformation in precious metals trading has opened new avenues for data analytics and market insights. With the integration of technology, traders can now access real-time data, enabling them to make informed decisions based on current market conditions.
The innovation in price discovery mechanisms has led to the emergence of digital asset solutions, allowing for more efficient trading practices. By utilizing advanced data analytics, traders can gain insights into market trends, fluctuations, and historical performance, all of which are essential for optimizing trading strategies.
API Description
The Metals-API is designed to empower developers with real-time metals data, enabling the creation of next-generation applications. This API offers a range of capabilities that facilitate seamless integration into various platforms, allowing users to access critical information about metal prices and trends.
With a focus on innovation and technological advancement, the Metals-API provides developers with the tools necessary to build applications that can analyze and visualize metal price data effectively. The transformative potential of real-time data cannot be overstated, as it allows for enhanced decision-making and strategic planning in trading.
Key Features and Endpoints
The Metals-API boasts a variety of endpoints that cater to different needs within the trading community. 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 feature is essential for traders who require up-to-the-minute information on metal prices.
- 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, providing insights into market liquidity and pricing dynamics.
- Convert Endpoint: The conversion endpoint enables users to convert any amount from one metal to another or to/from USD, facilitating transactions and price comparisons across different currencies.
- Time-Series Endpoint: Query the API for daily historical rates between two dates of your choice, allowing for in-depth analysis of price movements over time.
- Fluctuation Endpoint: Retrieve information about how metal prices fluctuate on a day-to-day basis, which is crucial for understanding market volatility.
- Carat Endpoint: This endpoint provides information about gold rates by carat, allowing jewelers and consumers to make informed purchasing decisions.
- Lowest/Highest Price Endpoint: Query the API to get the lowest and highest prices for a specified date range, which can help identify market extremes.
- Open/High/Low/Close (OHLC) Price Endpoint: Access open, high, low, and close prices for a specific time period, which is essential for technical analysis.
- Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, providing a long-term view of metal price trends.
- API Key: Your unique API key is required to access the API, ensuring secure and authorized usage.
- API Response: Exchange rates are delivered relative to USD by default, with all data returned in a structured format for easy integration.
- Available Endpoints: The API includes 14 endpoints, each providing distinct functionalities tailored to various user needs.
- Supported Symbols Endpoint: This constantly updated endpoint returns all available currencies, ensuring users have access to the latest information.
- Gold Price India Endpoint: Retrieve the latest gold price in India using this dedicated endpoint, which is particularly useful for local traders.
- News Endpoint: Stay updated with the latest news articles related to various metals, helping traders stay informed about market 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
Understanding the API responses is crucial for effective integration. Below are examples of various API endpoints and their corresponding JSON responses:
Latest Rates Endpoint
Get real-time exchange rates for all available metals:
{
"success": true,
"timestamp": 1759201248,
"base": "USD",
"date": "2025-09-30",
"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": 1759114848,
"base": "USD",
"date": "2025-09-29",
"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-09-23",
"end_date": "2025-09-30",
"base": "USD",
"rates": {
"2025-09-23": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2025-09-25": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2025-09-30": {
"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": 1759201248,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}
Fluctuation Endpoint
Track rate fluctuations between two dates:
{
"success": true,
"fluctuation": true,
"start_date": "2025-09-23",
"end_date": "2025-09-30",
"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": 1759201248,
"base": "USD",
"date": "2025-09-30",
"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": 1759201248,
"base": "USD",
"date": "2025-09-30",
"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 serves as an invaluable resource for developers looking to access real-time data on precious metals, including Surat Gold 24k (SURA-24k). By leveraging the various endpoints offered by the API, developers can build applications that provide insights into market trends, historical data, and real-time pricing. The ability to convert between different metals and currencies, track fluctuations, and access comprehensive historical data empowers users to make informed trading decisions.
For those interested in integrating this powerful API into their applications, the Metals-API Documentation provides detailed guidance on implementation and usage. Additionally, the Metals-API Supported Symbols page offers a comprehensive list of available metal symbols, ensuring that users can access the data they need. By utilizing the Metals-API Website, developers can stay updated on the latest features and enhancements, ensuring they are equipped with the best tools for their trading strategies.