← Back to Home
Ethiopian Banks API
Access live exchange rates from Commercial Bank of Ethiopia (CBE) and other major Ethiopian banks. Get current rates, historical data, and health monitoring for the exchange rate system.
Available Endpoints
GET Exchange Rates
/et-banks/cbe/api
Fetch current exchange rates from Ethiopian banks including CBE, Dashen, Awash, and more. Returns buy/sell rates for major currencies (USD, EUR, GBP, AED, SAR) along with bank names and last update times.
GET History
/et-banks/cbe/api/history
Get a list of available historical rate snapshots. Append ?date=YYYY-MM-DD to retrieve rates for a specific date.
GET Health Check
/et-banks/cbe/api/health
Monitor the status of the exchange rate system. Returns cache age, last update time, and number of history entries.
Try the API
Click to fetch live exchange rates from Ethiopian banks:
Response:
Click a button to see the response here...
Exchange Rates Endpoint
Example Request
GET /et-banks/cbe/api
Example Response
{
"status": "success",
"data": [
{
"id": 1,
"name": "Commercial Bank of Ethiopia",
"shortName": "CBE",
"lastUpdate": "2026-07-09T08:30:00.000Z",
"rates": {
"USD": { "buy": 156.50, "sell": 158.00 },
"EUR": { "buy": 178.20, "sell": 180.50 },
"GBP": { "buy": 208.10, "sell": 211.30 },
"AED": { "buy": 42.40, "sell": 43.10 },
"SAR": { "buy": 41.50, "sell": 42.20 }
}
},
{
"id": 2,
"name": "Dashen Bank",
"shortName": "Dashen",
"lastUpdate": "2026-07-09T08:25:00.000Z",
"rates": {
"USD": { "buy": 156.20, "sell": 157.80 }
}
}
],
"last_updated": "2026-07-09T08:30:00+00:00"
}
History Endpoint
List Available Dates
GET /et-banks/cbe/api/history
Response
{
"available_dates": [
"2026-07-09",
"2026-07-08",
"2026-07-07"
],
"count": 3
}
Get Specific Date
GET /et-banks/cbe/api/history?date=2026-07-08
Response
{
"date": "2026-07-08",
"data": [ ... ],
"timestamp": 1750000000
}
Health Check Endpoint
Example Request
GET /et-banks/cbe/api/health
Example Response
{
"status": "OK",
"last_updated": "2026-07-09T08:30:00+00:00",
"cache_age": 120,
"history_entries": 7
}
Response Fields
| Field | Description |
|---|---|
| status | System status: "OK" or "INITIALIZING" |
| last_updated | ISO8601 timestamp of last successful data fetch |
| cache_age | Age of the cache in seconds |
| history_entries | Number of available historical snapshots |
Features
🏦 Major Ethiopian Banks
Rates from CBE, Dashen, Awash, and more
💰 Major Currencies
USD, EUR, GBP, AED, SAR buy/sell rates
📈 Historical Data
Access past exchange rate snapshots by date
💾 Smart Caching
1-hour cache with stale-while-revalidate fallback
📈 Historical Archive
Daily snapshots saved for historical reference
💚 Health Monitoring
Dedicated health endpoint for system monitoring
Response Fields
| Field | Description |
|---|---|
| status | "success" or error message |
| data[].name | Full bank name |
| data[].shortName | Bank abbreviation |
| data[].lastUpdate | Last rate update timestamp |
| data[].rates.{CUR}.buy | Buy rate for the currency |
| data[].rates.{CUR}.sell | Sell rate for the currency |
| last_updated | ISO8601 timestamp of the response data |
Error Responses
{
"error": "No data for this date"
}
{
"status": "error",
"data": null,
"error": "API returned HTTP 500"
}