Access Bulgarian Lev (BGN) Exchange Rates with API Endpoint Documentation in JSON Format

In today's fast-paced financial landscape, having access to real-time exchange rates is crucial for businesses and developers alike. The Metals-API provides a powerful solution for retrieving exchange rates, including the Bulgarian Lev (BGN), in a structured JSON format. This blog post will delve into the capabilities of the Metals-API, focusing on how developers can leverage its endpoints to access and utilize exchange rate data effectively.

Metals-API Information

The Metals-API is designed to provide developers with real-time and historical data on metal prices and currency exchange rates. With its robust architecture, the API enables seamless integration into applications, allowing for advanced data analytics and insights. The API supports a wide range of currencies and metals, making it a versatile tool for financial applications.

About Neodymium (ND)

Neodymium, a rare earth metal, plays a significant role in the digital transformation of metal markets. As industries increasingly rely on technological innovation and advancement, the demand for neodymium is expected to rise. The integration of smart technology and data analytics into metal trading can lead to improved decision-making processes and enhanced market insights. Developers can utilize the Metals-API to track neodymium prices and analyze market trends, paving the way for future possibilities in the metal industry.

API Description

The Metals-API offers a comprehensive suite of features that empower developers to build next-generation applications. By providing real-time metals data, the API facilitates the creation of innovative solutions that can transform how businesses operate in the financial sector. Developers can access various endpoints to retrieve exchange rates, historical data, and more, all while ensuring technical accuracy and reliability.

For more information, visit the Metals-API Website or check the Metals-API Documentation.

Key Features and Endpoints

The Metals-API provides a variety of endpoints, each designed to cater to specific needs. Here are some of the key features:

Latest Rates Endpoint: This endpoint returns real-time exchange rate data for metals, updated every 60 minutes, 10 minutes, or according to your subscription plan. Developers can easily access the latest rates for BGN and other currencies.
Historical Rates Endpoint: Access historical rates dating back to 2019 by appending a date in the YYYY-MM-DD format. This feature is particularly useful for analyzing trends over time.
Bid And Ask Endpoint: Retrieve real-time bid and ask prices for metals, allowing developers to implement trading strategies based on current market conditions.
Convert Endpoint: This endpoint enables currency conversion, allowing users to convert any amount from one currency to another, including BGN.
Time-Series Endpoint: Query the API for daily historical rates between two dates, providing insights into market fluctuations over time.
Fluctuation Endpoint: Track how currencies fluctuate on a day-to-day basis, offering valuable information for traders and analysts.
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 specific date, helping users make informed decisions.
Open/High/Low/Close (OHLC) Price Endpoint: Access OHLC data for a specific time period, which is crucial for technical analysis.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, providing a wealth of data for analysis.
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 JSON format.
Available Endpoints: The Metals-API features 14 endpoints, each providing distinct functionalities for developers.
Supported Symbols Endpoint: Access a constantly updated list of all available currencies, including BGN, to ensure accurate data retrieval.

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

Latest Rates Endpoint

Get real-time exchange rates for all available metals:

{
"success": true,
"timestamp": 1783188452,
"base": "USD",
"date": "2026-07-04",
"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": 1783102052,
"base": "USD",
"date": "2026-07-03",
"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-06-27",
"end_date": "2026-07-04",
"base": "USD",
"rates": {
"2026-06-27": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-06-29": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-07-04": {
"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": 1783188452,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}

Fluctuation Endpoint

Track rate fluctuations between two dates:

{
"success": true,
"fluctuation": true,
"start_date": "2026-06-27",
"end_date": "2026-07-04",
"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": 1783188452,
"base": "USD",
"date": "2026-07-04",
"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": 1783188452,
"base": "USD",
"date": "2026-07-04",
"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

Accessing Bulgarian Lev (BGN) exchange rates through the Metals-API offers developers a powerful tool for integrating real-time financial data into their applications. With a variety of endpoints available, including the latest rates, historical data, and conversion capabilities, developers can create sophisticated financial applications that meet the needs of their users. By leveraging the API's features, such as the fluctuation and OHLC endpoints, developers can gain deeper insights into market trends and make informed decisions.

For further exploration of the Metals-API's capabilities, refer to the Metals-API Documentation and the Metals-API Supported Symbols page. By utilizing these resources, developers can maximize the potential of the Metals-API and enhance their applications with real-time metals data.

Ready to use Metals-API?

Try it now!

Access Bulgarian Lev (BGN) Exchange Rates with API Endpoint Documentation in JSON Format