Home › Library › Currencies

Currencies

The system supports multiple currencies with automatic exchange rate updates from the National Bank of Ukraine.

Base Currency

Euro (EUR) is the base currency. All exchange rates are calculated relative to EUR.

€ EUR Euro

Supported Currencies

The following currencies are currently supported in the system:

Code Name Numeric Code
EUREuro978
USDUS Dollar840
UAHUkrainian Hryvnia980
GBPBritish Pound826
PLNPolish Zloty985
CZKCzech Koruna203
CHFSwiss Franc756
MDLMoldovan Leu498
RONRomanian Leu946
ILSIsraeli Shekel376

Exchange Rates

Exchange rates are updated daily from the National Bank of Ukraine. Rates are stored per date, allowing historical rate lookups.

Rate Format

Rates are stored as the amount of currency per 100 EUR (multiplier = 100). For example, if the rate is 117.50 for USD, it means 100 EUR = 117.50 USD.

Data Source

Exchange rates are fetched from the National Bank of Ukraine (NBU) official API. Rates are converted from UAH base to EUR base for consistency.

API Endpoints

Currency and exchange rate data is available via the public API (no authentication required):

GET /api/v1/currencies
GET /api/v1/currency-rates
GET /api/v1/currency-rates?date=2024-01-15
GET /api/v1/currency-rates/dates