Retrieve Saudi Riyal (SAR) Historical Prices using this API
Retrieve Saudi Riyal (SAR) Historical Prices using this API
In today's fast-paced financial landscape, the ability to access historical currency prices is crucial for developers and analysts alike. The Saudi Riyal (SAR) is a significant currency in the Middle East, and retrieving its historical prices can provide valuable insights into market trends and economic conditions. The Metals-API offers a robust solution for accessing historical prices, making it an essential tool for developers looking to integrate real-time and historical data into their applications.
About Australian Dollar (AUD)
The Australian Dollar (AUD) has become increasingly relevant in the global market, particularly in the context of metals trading. As digital transformation reshapes the metal markets, the integration of technological innovations and advancements is paramount. The Metals-API stands at the forefront of this transformation, providing developers with the tools necessary to harness data analytics and insights effectively.
With the rise of smart technology integration, the future of trading in metals, including the Australian Dollar, looks promising. Developers can leverage the Metals-API to create applications that not only track real-time prices but also analyze historical data, enabling them to make informed decisions based on comprehensive market insights.
API Description
The Metals-API is a powerful tool designed to provide developers with real-time and historical metals data, including currency exchange rates. This API empowers developers to build next-generation applications that require accurate and timely information. By utilizing the Metals-API, developers can access a wide range of features that enhance their applications' capabilities.
For more information, visit the Metals-API Website or check the Metals-API Documentation for detailed guidance on implementation.
Key Features and Endpoints
The Metals-API offers a variety of endpoints that cater to different needs. Here are some of the key features:
- Latest Rates Endpoint: Depending on your subscription plan, this endpoint provides real-time exchange rate data updated every 60 minutes, every 10 minutes, or even more frequently. This feature is essential for applications that require up-to-the-minute pricing information.
- Historical Rates Endpoint: Access historical rates for most currencies dating back to 2019. By appending a date in the format YYYY-MM-DD, developers can query the Metals-API for historical rates, allowing for in-depth analysis of price trends over time.
- Bid And Ask Endpoint: This powerful feature enables developers to retrieve real-time Bid and Ask prices, which are crucial for trading applications that require precise pricing information.
- Convert Endpoint: The Metals-API includes a currency conversion endpoint, allowing users to convert any amount from one currency to another. This feature is particularly useful for applications that deal with multiple currencies.
- Time-Series Endpoint: Developers can query the API for daily historical rates between two dates of their choice. This endpoint is invaluable for analyzing trends over specific periods.
- Fluctuation Endpoint: This endpoint provides information about how currencies fluctuate on a day-to-day basis, helping developers understand market volatility.
- Carat Endpoint: Retrieve information about Gold rates by Carat. This feature is particularly useful for jewelers and traders dealing with precious metals.
- Lowest/Highest Price Endpoint: Query the API to get the lowest and highest price for a specified date, providing insights into market extremes.
- Open/High/Low/Close (OHLC) Price Endpoint: This endpoint allows developers to get 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 comprehensive view of metal prices over time.
- API Key: Each user receives a unique API Key that must be passed into the API base URL's access_key parameter for authentication.
- API Response: Exchange rates delivered by the Metals-API are by default relative to USD, ensuring consistency in data interpretation.
- Available Endpoints: The Metals-API includes 14 endpoints, each offering different functionalities to cater to various needs.
- Supported Symbols Endpoint: This endpoint returns all available currencies, ensuring developers have access to the most up-to-date information.
List of Symbols
The 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 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": 1785197893,
"base": "USD",
"date": "2026-07-28",
"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": 1785111493,
"base": "USD",
"date": "2026-07-27",
"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-07-21",
"end_date": "2026-07-28",
"base": "USD",
"rates": {
"2026-07-21": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-07-23": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-07-28": {
"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": 1785197893,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}
Fluctuation Endpoint
Track rate fluctuations between two dates.
{
"success": true,
"fluctuation": true,
"start_date": "2026-07-21",
"end_date": "2026-07-28",
"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": 1785197893,
"base": "USD",
"date": "2026-07-28",
"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": 1785197893,
"base": "USD",
"date": "2026-07-28",
"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 developers seeking to retrieve historical prices for the Saudi Riyal (SAR) and other currencies. With its extensive range of endpoints, including the Latest Rates, Historical Rates, and Time-Series endpoints, developers can access real-time and historical data to enhance their applications.
By leveraging the capabilities of the Metals-API, developers can create innovative applications that provide valuable insights into market trends and fluctuations. The API's robust features, combined with its user-friendly documentation, make it an ideal choice for those looking to integrate financial data into their projects.
For further exploration of the API's capabilities, visit the Metals-API Documentation and discover how you can harness the power of real-time metals data in your applications.