Access Brazilian Real (BRL) Exchange Rates with API Key Authentication in JSON Format

In today's fast-paced financial landscape, accessing real-time exchange rates is crucial for businesses and developers alike. The Metals-API provides a robust solution for retrieving exchange rates, including the Brazilian Real (BRL), in a convenient JSON format. This blog post will delve into the capabilities of the Metals-API, focusing on its innovative features, practical applications, and how developers can leverage this powerful tool to enhance their applications.

Metals-API Information

The Metals-API is designed to provide real-time and historical data for various metals and currencies, making it an essential resource for developers working in finance, trading, and data analytics. By utilizing API key authentication, users can securely access a wealth of information, including exchange rates for metals like gold, silver, and platinum, as well as currency conversion capabilities.

About Tellurium (TE)

While Tellurium (TE) may not be a primary focus of the Metals-API, it serves as an excellent example of how digital transformation is impacting the metal markets. The integration of smart technology and data analytics is revolutionizing how traders and investors interact with metals. As technological advancements continue to shape the industry, the potential for innovative applications of real-time data is vast.

For instance, developers can create applications that analyze market trends, predict price fluctuations, and provide insights into investment opportunities. By harnessing the power of data analytics, businesses can make informed decisions that drive growth and profitability.

API Description

The Metals-API is a powerful tool that empowers developers to build next-generation applications by providing access to real-time metals data. With a user-friendly interface and comprehensive documentation, the API allows for seamless integration into various applications. Developers can access a wide range of endpoints, each designed to deliver specific functionalities, from retrieving the latest exchange rates to historical data analysis.

To get started, developers can visit the Metals-API Documentation, which provides detailed information on how to authenticate and interact with the API. The documentation covers everything from obtaining an API key to understanding the various endpoints available for use.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that cater to different needs, making it a versatile tool for developers. Here are some of the key features:

Latest Rates Endpoint: This endpoint provides real-time exchange rate data for metals and currencies. Depending on your subscription plan, the API can return updates every 60 minutes, every 10 minutes, or even more frequently. This feature is particularly useful for applications that require up-to-the-minute pricing information.
Historical Rates Endpoint: Access historical exchange rates dating back to 2019. Developers can query the Metals-API for historical rates by appending a specific date in the format YYYY-MM-DD. This functionality is essential for analyzing trends and making informed decisions based on past performance.
Bid And Ask Endpoint: This powerful feature allows users to retrieve real-time bid and ask prices for various metals. Understanding the bid-ask spread is crucial for traders looking to optimize their buying and selling strategies.
Convert Endpoint: The Metals-API includes a currency conversion endpoint, enabling users to convert any amount from one currency to another. This feature is particularly useful for businesses operating in multiple currencies, as it simplifies financial transactions.
Time-Series Endpoint: This endpoint allows developers to query the API for daily historical rates between two specified dates. By analyzing time-series data, businesses can identify trends and make predictions about future price movements.
Fluctuation Endpoint: Track how currencies fluctuate on a day-to-day basis with this endpoint. It provides valuable insights into market volatility, helping traders make informed decisions.
Carat Endpoint: Retrieve information about gold rates by carat. This feature is particularly useful for jewelers and businesses dealing with precious metals.
Lowest/Highest Price Endpoint: Query the API to get the lowest and highest price for a specified date. This information is vital for traders looking to identify optimal buying and selling points.
Open/High/Low/Close (OHLC) Price Endpoint: Access open, high, low, and close prices for a specific time period. This data is essential for technical analysis and understanding market trends.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008. This endpoint is invaluable for businesses that require long-term data for analysis.
API Key: Your API key is a unique identifier that must be included in the API requests to authenticate your access. This ensures that only authorized users can retrieve data from the Metals-API.
API Response: The Metals-API delivers exchange rates relative to USD by default. All data is returned in a structured JSON format, making it easy to integrate into applications.
Available Endpoints: The Metals-API comes with 14 different endpoints, each providing unique functionalities. Developers can explore these endpoints to find the ones that best suit their needs.
Supported Symbols Endpoint: This constantly updated endpoint returns all available currencies and metals. Developers can access the Metals-API Supported Symbols to find the symbols they need for their applications.
News Endpoint: Retrieve the latest news articles related to various metals, keeping users 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 Symbols page. This resource is invaluable for developers looking to integrate specific metals into their applications.

API Endpoint Examples and Responses

Latest Rates Endpoint

Get real-time exchange rates for all available metals:

{
"success": true,
"timestamp": 1777518481,
"base": "USD",
"date": "2026-04-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": 1777432081,
"base": "USD",
"date": "2026-04-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": "2026-04-23",
"end_date": "2026-04-30",
"base": "USD",
"rates": {
"2026-04-23": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-04-25": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-04-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": 1777518481,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}

Fluctuation Endpoint

Track rate fluctuations between two dates:

{
"success": true,
"fluctuation": true,
"start_date": "2026-04-23",
"end_date": "2026-04-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": 1777518481,
"base": "USD",
"date": "2026-04-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": 1777518481,
"base": "USD",
"date": "2026-04-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

In conclusion, the Metals-API offers a comprehensive solution for developers seeking to access real-time and historical exchange rates, including those for the Brazilian Real (BRL). With its robust features, such as the latest rates, historical data, and conversion capabilities, the API empowers developers to create innovative applications that can analyze market trends and optimize trading strategies.

By leveraging the extensive documentation and resources available on the Metals-API Documentation, developers can easily integrate these functionalities into their applications. The ability to access a wide range of metal symbols and exchange rates opens up numerous possibilities for financial analysis and decision-making.

As the financial landscape continues to evolve, the importance of real-time data and analytics cannot be overstated. The Metals-API stands out as a powerful tool that can help businesses and developers navigate this dynamic environment effectively.

Ready to use Metals-API?

Try it now!

Access Brazilian Real (BRL) Exchange Rates with API Key Authentication in JSON Format