European Central Bank

# Setup

## Launching it

The ECB's reference rates need no key and no account: the Data Portal is
public. Launch the plugin and approve its one role, `data` (a data plugin).
It reads the portal at once, and every hour after.

Its settings, in the dashboard's Settings form:

- **Raw responses window** and **past the window** (the SDK's): how long the
ECB's answers are kept in the plugin's storage, ten years by default, and
whether they are then archived, kept or deleted.
- **Sample data**, on a deployment installed for development only: the
ECB's rates recorded on 19 October 2026, committed with the plugin, in
place of the portal. For trying it offline.

## Its dataset

On the deployment's **Data sources** page (deployment admins):

1. **License `<instance>:ecb_fx`.** The catalogue's default is kept, with
derived use and display, no limit on retention, and not one person's
terms. The ECB asks to be cited as the source; record that in your
licence's note. Confirm the default, or set your own, with a note saying
why.
2. **Entitle** each plugin that reads rates, such as your reporting plugin.
3. **Priority**, where another dataset also prices currencies: put the one
your valuation should read first.

## Your currencies' instruments

Each rate is about the euro's cash instrument, priced in another currency's,
each found by its ISO 4217 code. The Datasets tab shows each currency's
instrument, or why there is none (not found, or two records match). A
currency without one waits: its rates are recorded once it resolves, at the
next check. Until the euro itself resolves, no rate is recorded.

## The calendar

The dataset names the platform's "Euro (TARGET)" calendar. Your deployment
pulls it from the platform the first time the plugin reads it. If it cannot,
Connection says so and the plugin assumes Monday to Friday.