Access Belize Dollar (BZD) Exchange Rates API Documentation in JSON Format

In the rapidly evolving landscape of financial technology, the ability to access real-time exchange rates is crucial for developers and businesses alike. The Metals-API provides a robust platform for retrieving exchange rates, including the Belize Dollar (BZD) and various metal symbols such as Gold (XAU), Silver (XAG), Platinum (XPT), and Palladium (XPD). This blog post will delve into how to effectively utilize the Metals-API to retrieve exchange rates in JSON format, complete with sample API responses and integration tips.

Understanding Metals-API

The Metals-API is designed to empower developers with real-time data on metal prices and currency conversions. By leveraging advanced data analytics and smart technology integration, the API enables users to build next-generation applications that can respond to market fluctuations with agility. The API supports a wide range of functionalities, including the retrieval of the latest rates, historical data, and conversion capabilities.

Key Features of Metals-API

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 is essential for applications that require up-to-the-minute pricing information.
Historical Rates Endpoint: Access historical rates dating back to 2019 by appending a specific date to your query. This feature is particularly useful for trend analysis and financial forecasting.
Bid and Ask Endpoint: Retrieve real-time Bid and Ask prices, which are crucial for traders looking to make informed decisions based on market spreads.
Convert Endpoint: This endpoint allows you to convert any amount from one currency to another, facilitating seamless transactions across different currencies.
Time-Series Endpoint: Query the API for daily historical rates between two dates of your choice, enabling detailed analysis of price movements over time.
Fluctuation Endpoint: Track how currencies fluctuate on a day-to-day basis, providing insights into market volatility.
Carat Endpoint: Retrieve information about Gold rates by Carat, which is essential for jewelers and investors in precious metals.
Lowest/Highest Price Endpoint: Query the API to get the lowest and highest prices for a specified date range, aiding in market analysis.
Open/High/Low/Close (OHLC) Price Endpoint: Get OHLC data for a specific time period, which is vital for traders looking to analyze market trends.
Historical LME Endpoint: Access historical rates for LME symbols dating back to 2008, providing a comprehensive view of market history.
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.
Supported Symbols Endpoint: Access a constantly updated list of all available currencies and metals supported by the API.
News Endpoint: Retrieve the latest news articles related to various metals, keeping you informed about market developments.

Sample API Responses

Understanding the structure of API responses is crucial for effective integration. Below are examples of JSON responses from various endpoints:

Latest Rates Endpoint

{
"success": true,
"timestamp": 1772532458,
"base": "USD",
"date": "2026-03-03",
"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": 1772446058,
"base": "USD",
"date": "2026-03-02",
"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-02-24",
"end_date": "2026-03-03",
"base": "USD",
"rates": {
"2026-02-24": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-02-26": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-03-03": {
"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": 1772532458,
"rate": 0.000482
},
"result": 0.482,
"unit": "troy ounces"
}

Fluctuation Endpoint

{
"success": true,
"fluctuation": true,
"start_date": "2026-02-24",
"end_date": "2026-03-03",
"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

{
"success": true,
"timestamp": 1772532458,
"base": "USD",
"date": "2026-03-03",
"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": 1772532458,
"base": "USD",
"date": "2026-03-03",
"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 application can significantly enhance its functionality. Here are some practical tips to ensure a smooth integration:

Authentication: Always include your API key in the access_key parameter of your requests. This ensures that your application is authorized to access the data.
Rate Limiting: Be aware of your subscription plan's rate limits to avoid exceeding the allowed number of requests. Implementing caching strategies can help reduce the number of API calls.
Error Handling: Implement robust error handling to manage potential issues such as network failures or invalid requests. This will enhance the user experience by providing meaningful feedback.
Data Validation: Always validate the data received from the API to ensure it meets your application's requirements. This includes checking for null values and ensuring data types are correct.
Performance Optimization: Optimize your API calls by only requesting the data you need. For example, if you only require the latest rates, use the Latest Rates Endpoint instead of querying for historical data.

Common Use Cases

The Metals-API can be utilized in various applications, including:

Financial Applications: Build applications that provide users with real-time metal prices and currency conversions, enabling informed investment decisions.
E-commerce Platforms: Integrate the API to display current metal prices for jewelry or precious metal products, ensuring accurate pricing for customers.
Market Analysis Tools: Develop tools that analyze historical data to identify trends and make predictions about future price movements.

Conclusion

The Metals-API is a powerful tool for developers looking to access real-time exchange rates and historical data for metals and currencies. By understanding its features, endpoints, and integration strategies, you can build applications that leverage this data to provide value to users. For more detailed information, refer to the Metals-API Documentation and explore the Metals-API Supported Symbols for a comprehensive list of available currencies. Embrace the future of financial technology with the Metals-API and unlock the potential of real-time data.

Ready to use Metals-API?

Try it now!

Access Belize Dollar (BZD) Exchange Rates API Documentation in JSON Format