Access Ethiopian Birr (ETB) API Documentation for JSON Exchange Rates

In today's rapidly evolving financial landscape, accessing real-time exchange rates is crucial for developers and businesses alike. The Metals-API provides a robust solution for retrieving Ethiopian Birr (ETB) exchange rates in JSON format, enabling seamless integration into applications. This blog post will delve into the capabilities of the Metals-API, focusing on its innovative features, potential applications, and how to effectively utilize its endpoints for accessing exchange rates.

Metals-API Information

About Tellurium (TE)

As the world embraces digital transformation, the metal markets are undergoing significant changes driven by technological innovation and advancement. Tellurium (TE), a lesser-known but essential metal, exemplifies this shift. The integration of smart technology and data analytics is reshaping how metals are traded and valued. Developers can leverage these advancements to create applications that provide insights into market trends, enabling users to make informed decisions.

With the rise of data-driven strategies, the future of metal markets looks promising. The Metals-API stands at the forefront of this transformation, offering developers the tools needed to harness real-time data for Tellurium and other metals. By utilizing the API, developers can build applications that not only track current prices but also analyze historical trends, providing a comprehensive view of the market landscape.

API Description

The Metals-API is a powerful JSON API that provides access to real-time and historical exchange rates for various metals, including the Ethiopian Birr (ETB). This API empowers developers to create next-generation applications that require accurate and timely data. With its user-friendly interface and extensive documentation, the Metals-API simplifies the process of integrating metal price data into 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, parameter details, and example responses.

Key Features and Endpoints

The Metals-API offers a variety of endpoints that cater to different needs, allowing developers to access a wealth of information. 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.
Historical Rates Endpoint: Access historical exchange rates dating back to 2019. By appending a specific date in the format YYYY-MM-DD, developers can retrieve past 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 liquidity and pricing dynamics.
Convert Endpoint: The Metals-API includes a dedicated currency conversion endpoint, enabling users to convert amounts between different currencies seamlessly.
Time-Series Endpoint: This endpoint allows developers to query daily historical rates between two specified dates, facilitating in-depth analysis of price movements over time.
Fluctuation Endpoint: Track how currencies fluctuate on a day-to-day basis, providing insights into market volatility and trends.
Carat Endpoint: Retrieve information about gold rates by carat, which is particularly useful for jewelers and traders in the gold market.
Lowest/Highest Price Endpoint: Query the API to get the lowest and highest price for a specified date, helping users identify market extremes.
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 requests to authenticate access to the API.
API Response: The API delivers exchange rates relative to USD by default, ensuring consistency in data presentation.
Available Endpoints: The Metals-API features 14 different endpoints, each designed to provide specific functionalities tailored to user needs.
Supported Symbols Endpoint: This endpoint returns a constantly updated list of all available currencies, ensuring users have access to the latest information.
Intraday Endpoint: Query intraday exchange rate data for a single symbol, which is crucial for high-frequency trading applications.

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

List of Symbols

The Metals-API provides access to a comprehensive range of metal symbols. This extensive list ensures that developers can find the specific metals they need for their applications. For more information on the available symbols and their specifications, please visit the Symbols page.

API Endpoint Examples and Responses

Latest Rates Endpoint

The Latest Rates Endpoint allows developers to get real-time exchange rates for all available metals. Here is an example response:

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

In this response, the "success" field indicates whether the request was successful, while the "rates" object contains the current exchange rates for various metals, with values expressed per troy ounce.

Historical Rates Endpoint

Accessing historical exchange rates is essential for analyzing market trends. Here’s an example response from the Historical Rates Endpoint:

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

This response provides historical rates for a specific date, allowing developers to analyze past performance and make informed predictions.

Time-series Endpoint

The Time-series Endpoint enables developers to retrieve exchange rates for a specific time period. Here’s an example response:

{
"success": true,
"timeseries": true,
"start_date": "2026-08-11",
"end_date": "2026-08-18",
"base": "USD",
"rates": {
"2026-08-11": {
"XAU": 0.000485,
"XAG": 0.03825,
"XPT": 0.000915
},
"2026-08-13": {
"XAU": 0.000483,
"XAG": 0.0382,
"XPT": 0.000913
},
"2026-08-18": {
"XAU": 0.000482,
"XAG": 0.03815,
"XPT": 0.000912
}
},
"unit": "per troy ounce"
}

This response provides a time series of exchange rates, allowing for detailed analysis of price movements over the specified period.

Convert Endpoint

The Convert Endpoint allows users to convert any amount from one metal to another or to/from USD. Here’s an example response:

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

This response shows the conversion of 1000 USD to troy ounces of gold (XAU), providing both the conversion rate and the result.

Fluctuation Endpoint

The Fluctuation Endpoint tracks rate fluctuations between two dates. Here’s an example response:

{
"success": true,
"fluctuation": true,
"start_date": "2026-08-11",
"end_date": "2026-08-18",
"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"
}

This response provides detailed information about how rates have changed over a specified period, including both absolute and percentage changes.

OHLC (Open/High/Low/Close) Endpoint

The OHLC Endpoint provides open, high, low, and close prices for a specific time period. Here’s an example response:

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

This response provides essential data for traders and analysts looking to understand market behavior over a specific timeframe.

Bid/Ask Endpoint

The Bid/Ask Endpoint allows users to get current bid and ask prices for metals. Here’s an example response:

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

This response provides crucial information for traders, including the current bid and ask prices, as well as the spread, which is essential for making trading decisions.

Conclusion

In conclusion, the Metals-API offers a comprehensive solution for accessing Ethiopian Birr (ETB) exchange rates and other metal pricing data in JSON format. With its extensive range of endpoints, developers can retrieve real-time and historical data, perform conversions, and analyze fluctuations with ease. The API's capabilities empower developers to create innovative applications that leverage real-time data for informed decision-making.

For more information on how to get started with the Metals-API, visit the Metals-API Website and explore the Metals-API Documentation for detailed guidance on each endpoint. By utilizing the API effectively, developers can unlock the full potential of real-time metals data and enhance their applications.

Ready to use Metals-API?

Try it now!

Access Ethiopian Birr (ETB) API Documentation for JSON Exchange Rates