HomeBank User manual

# Currencies dialog

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

## Dialog call

- main window menu: Manage / Currencies
- main window tool bar.

## 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)

- ⧉ exchangerate.host
  (free): 170 world currencies, including Bitcoin, Gold and Silver rates. listed here

### Compatible API

- ⧉ frankfurter.app
  (free): 30 currencies, Euro limited listed here
- ⧉ fixer.io
  (apikey): 170 world currencies, including Bitcoin, Gold and Silver rates. listed here

### 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
`