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
statusSystem status: "OK" or "INITIALIZING"
last_updatedISO8601 timestamp of last successful data fetch
cache_ageAge of the cache in seconds
history_entriesNumber 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[].nameFull bank name
data[].shortNameBank abbreviation
data[].lastUpdateLast rate update timestamp
data[].rates.{CUR}.buyBuy rate for the currency
data[].rates.{CUR}.sellSell rate for the currency
last_updatedISO8601 timestamp of the response data

Error Responses

{
    "error": "No data for this date"
}
{
    "status": "error",
    "data": null,
    "error": "API returned HTTP 500"
}