Home
Blog
Access Belarusian Ruble (BYR) Exchange Rate API Documentation in JSON Format

Access Belarusian Ruble (BYR) Exchange Rate API Documentation in JSON Format

Access Belarusian Ruble (BYR) Exchange Rate API Documentation in JSON Format

Access Belarusian Ruble (BYR) Exchange Rate API Documentation in JSON Format

In today's rapidly evolving financial landscape, the ability to access real-time exchange rates is crucial for developers and businesses alike. The Metals-API provides a comprehensive solution for retrieving exchange rates in JSON format, including the Belarusian Ruble (BYR). This blog post will delve into the capabilities of the Metals-API, focusing on how to retrieve exchange rates for various metals, including practical examples and integration tips.

Understanding Metals-API

The Metals-API is a powerful tool designed for developers seeking to integrate real-time and historical exchange rate data into their applications. With a focus on metals, this API enables users to access a wealth of information, including the latest rates, historical data, and conversion capabilities. The API is built on a foundation of technological innovation, allowing for seamless integration and data analytics that can transform how businesses operate in the metal markets.

About Tellurium (TE)

As we explore the capabilities of the Metals-API, it's essential to consider the broader context of digital transformation in metal markets. The integration of smart technology and data analytics is revolutionizing how metals are traded and valued. With advancements in technology, developers can leverage real-time data to create applications that provide insights into market trends, enabling businesses to make informed decisions.

For instance, the use of data analytics can help identify fluctuations in metal prices, allowing traders to optimize their strategies. Furthermore, as the market evolves, the potential for future trends—such as the rise of sustainable metals—presents exciting opportunities for developers to innovate and create applications that cater to these emerging needs.

API Features and Capabilities

The Metals-API offers a variety of endpoints, each designed to provide specific functionalities. Here are some of the key features:

  • Latest Rates Endpoint: This endpoint provides real-time exchange rate data for metals, updated every 60 minutes, 10 minutes, or even more frequently, depending on your subscription plan. This feature is essential for applications that require up-to-the-minute pricing information.
  • Historical Rates Endpoint: Users can access historical rates dating back to 2019 by appending a date in the format YYYY-MM-DD. This functionality is crucial for analyzing trends over time and making data-driven decisions.
  • Bid and Ask Endpoint: This feature allows users to retrieve real-time bid and ask prices for metals, providing insights into market liquidity and pricing dynamics.
  • Convert Endpoint: The Metals-API includes a currency conversion endpoint, enabling users to convert amounts between different metals or to/from USD. This is particularly useful for applications that require multi-currency support.
  • Time-Series Endpoint: This endpoint allows users to query daily historical rates between two specified dates, facilitating trend analysis and reporting.
  • Fluctuation Endpoint: Users can track how metal prices fluctuate over time, providing valuable insights into market volatility.
  • Carat Endpoint: This feature allows users to retrieve gold rates by carat, catering to specific market needs.
  • 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 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, allowing for comprehensive market analysis.
  • API Key: Each user is assigned a unique API key, which must be included in API requests to authenticate access.
  • API Response: The Metals-API delivers exchange rates relative to USD by default, ensuring consistency in data presentation.
  • Supported Symbols Endpoint: This endpoint provides a constantly updated list of all available currencies and metals, ensuring users have access to the latest information.
  • News Endpoint: Retrieve the latest news articles related to various metals, keeping users informed about market developments.

Sample API Responses

To illustrate the capabilities of the Metals-API, here are some sample API responses for various endpoints:

Latest Rates Endpoint

{
"success": true,
"timestamp": 1773457667,
"base": "USD",
"date": "2026-03-14",
"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

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

Time-Series Endpoint

{
"success": true,
"timeseries": true,
"start_date": "2026-03-07",
"end_date": "2026-03-14",
"base": "USD",
"rates": {
"2026-03-07": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-03-09": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-03-14": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912
}
},
"unit": "per troy ounce"
}

Convert Endpoint

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

Fluctuation Endpoint

{
"success": true,
"fluctuation": true,
"start_date": "2026-03-07",
"end_date": "2026-03-14",
"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) Price Endpoint

{
"success": true,
"timestamp": 1773457667,
"base": "USD",
"date": "2026-03-14",
"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

{
"success": true,
"timestamp": 1773457667,
"base": "USD",
"date": "2026-03-14",
"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"
}

Integration Tips

Integrating the Metals-API into your applications can significantly enhance your ability to work with metal exchange rates. Here are some practical tips for successful integration:

  • Authentication: Ensure that you include your unique API key in every request. This key is essential for authenticating your access to the API and retrieving data.
  • Rate Limiting: Be aware of the rate limits associated with your subscription plan. Implementing caching strategies can help optimize performance and reduce the number of API calls.
  • Error Handling: Implement robust error handling to manage potential issues, such as network errors or invalid requests. This will enhance the user experience and ensure your application remains functional.
  • Data Validation: Always validate the data received from the API to ensure its accuracy and integrity before processing it further.
  • Performance Optimization: Consider using asynchronous requests to improve the responsiveness of your application when fetching data from the API.

Conclusion

The Metals-API is a transformative tool that empowers developers to access real-time and historical exchange rates for metals, including the Belarusian Ruble (BYR). By leveraging the various endpoints and features offered by the API, developers can create innovative applications that provide valuable insights into the metal markets.

For more information on how to get started, refer to the Metals-API Documentation and explore the Metals-API Supported Symbols for a comprehensive list of available currencies and metals. By integrating the Metals-API into your applications, you can stay ahead of market trends and make informed decisions based on real-time data.

Ready to use Metals-API?

Try it now!

Search

Related Posts

Recent Posts