HomeBank User manual

Currencies dialog

The currencies dialog is used to add, modify and manage the currencies available for the wallets.

Dialog call


Using currencies dialog

General

Update on-line Trigger an update exchanges rate on-line. This is disabled when you only have a single currency.
 Please see the additional notes below

Currencies list

display currency ISO code, name, symbol, exchange rate and last modified date

Buttons

Add open a dialog to add a new currency
+ see the notes below.
Edit open a dialog to edit the selected currency
Delete delete the selected currency
Set as base set the selected currency to be the base currency

Notes: add a currency

- you can pick up new currencies from the official ISO 4217 list
- you can define a custom currency for discontinued or cryptocurrency

When you define a custom currency, please take care of the following:
- the Name must be at least 3 chars long
- the ISO code is optional, but you cannot change it easily later on
- the ISO code must be 3 chars long and cannot be the same an existing ISO 4217 one

Notes: Online Currency Update

  This is an extra feature relying on a third party web service.

Your currencies may not be supported:
- as base currency: and nothing will update
- as a target currency: this currency will not be updated

Current API (since 5.7)

Compatible API

Previous used API

- until 5.7: https://frankfurter.app
- until 5.2: https://api.fixer.io, see ⧉ #1785210
- until 5.1.7: yahoo, see ⧉ #1730527

Changing the API (with a compatible one)

This is for advanced users only.
It can be done into the preference file, with 2 parameters:
- APIRateUrl=https://api.exchangerate.host
- APIRateKey=sfp4btv2dksahegay66d4tx3w57wvzwj