Access Belarusian Ruble (BYN) Conversion API in JSON Format

The Belarusian Ruble (BYN) is an essential currency in the Eastern European market, and accessing its exchange rates in real-time is crucial for developers and businesses operating in this region. The Metals-API provides a robust solution for retrieving exchange rates, including the BYN, in a convenient JSON format. This blog post will delve into the capabilities of the Metals-API, explore its features, and provide practical examples of how to integrate it into your applications.

About Belarusian Ruble (BYN)

The Belarusian Ruble has undergone significant changes over the years, particularly with the rise of digital transformation in metal markets. As technology continues to advance, the integration of smart technologies and data analytics becomes increasingly vital. The Metals-API stands out as a tool that empowers developers to harness real-time metals data, facilitating innovative applications that can adapt to future trends and possibilities.

With the Metals-API, developers can access a wealth of information about the Belarusian Ruble and its exchange rates against various metals. This API is not just about retrieving data; it's about leveraging that data to create insights and drive decision-making processes. The API's capabilities allow for the integration of advanced analytics, enabling businesses to stay ahead in a competitive market.

API Description

The Metals-API is designed to provide developers with real-time and historical exchange rate data for various metals and currencies, including the Belarusian Ruble. This API is particularly beneficial for applications that require up-to-date information on metal prices and currency conversions. The API's innovative architecture allows for seamless integration into existing systems, making it an ideal choice for developers looking to build next-generation applications.

For more detailed information, you can visit the Metals-API Documentation. This resource provides comprehensive guidance on how to utilize the API effectively, including endpoint descriptions and usage examples.

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: This endpoint provides real-time exchange rate data, updated every 60 minutes, 10 minutes, or even more frequently, depending on your subscription plan. It allows developers to access the most current rates for the Belarusian Ruble against various metals.
Historical Rates Endpoint: Access historical rates dating back to 2019. By appending a specific date to the API request, developers can retrieve past exchange rates, which is invaluable for trend analysis and forecasting.
Bid And Ask Endpoint: This powerful feature allows users to retrieve real-time bid and ask prices for metals, providing insights into market dynamics and helping traders make informed decisions.
Convert Endpoint: The conversion endpoint enables users to convert any amount from one currency to another, including from the Belarusian Ruble to various metals. This feature is crucial for businesses that deal with multiple currencies.
Time-Series Endpoint: This endpoint allows querying for daily historical rates between two chosen dates, making it easy to analyze trends over time.
Fluctuation Endpoint: Track how currencies fluctuate on a day-to-day basis. This endpoint provides insights into market volatility, which can be critical for risk management.
Carat Endpoint: Retrieve information about gold rates by carat, which is essential for jewelers and gold traders.
Lowest/Highest Price Endpoint: Query the API to get the lowest and highest prices for a specified date, helping traders identify market extremes.
Open/High/Low/Close (OHLC) Price Endpoint: Get detailed OHLC data for a specific time period, which is vital for technical analysis.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, providing a long-term view of market trends.
API Key: Each user is assigned a unique API key, which is required for authentication when making requests to the API.
API Response: The Metals-API delivers exchange rates relative to USD by default, ensuring consistency in data representation.
Available Endpoints: With 14 different API endpoints, developers have access to a wide range of functionalities tailored to their needs.
Supported Symbols Endpoint: This constantly updated endpoint returns all available currencies, including the Belarusian Ruble, ensuring that developers can always access the latest information.

For a complete list of all supported symbols, including the Belarusian Ruble, refer to the Metals-API Supported Symbols page.

API Endpoint Examples and Responses

To illustrate how the Metals-API works, let's explore some example responses from various endpoints:

Latest Rates Endpoint

Get real-time exchange rates for all available metals:

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

Historical Rates Endpoint

Access historical exchange rates for any date since 1999:

{
"success": true,
"timestamp": 1779178086,
"base": "USD",
"date": "2026-05-19",
"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-05-13",
"end_date": "2026-05-20",
"base": "USD",
"rates": {
"2026-05-13": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-05-15": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-05-20": {
"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": 1779264486,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}

Fluctuation Endpoint

Track rate fluctuations between two dates:

{
"success": true,
"fluctuation": true,
"start_date": "2026-05-13",
"end_date": "2026-05-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"
}

OHLC (Open/High/Low/Close) Endpoint

Get OHLC data for a specific time period:

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

Bid/Ask Endpoint

Get current bid and ask prices for metals:

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

Conclusion

In conclusion, the Metals-API provides a comprehensive solution for accessing Belarusian Ruble (BYN) exchange rates in JSON format. With its array of endpoints, developers can retrieve real-time and historical data, perform currency conversions, and analyze market fluctuations. The API's capabilities extend beyond mere data retrieval; they empower developers to create innovative applications that leverage real-time insights for better decision-making.

For further exploration, visit the Metals-API Website to learn more about its features and capabilities. By integrating the Metals-API into your applications, you can stay ahead of the curve in the rapidly evolving financial landscape.

Ready to use Metals-API?

Try it now!

Access Belarusian Ruble (BYN) Conversion API in JSON Format