# ECB Exchange Rates

Official ECB euro reference exchange rates as JSON: any base currency, currency converter and 90 days of history.

The European Central Bank publishes one reference rate a day for about 30 currencies against the euro. This API gives them to you as JSON against any base currency, converts amounts, and looks back over the last 90 days; a weekend or holiday answers with the last published day and says which. Source: European Central Bank. The same data is available free of charge on the ECB's website; you pay here for the JSON, the cross rates and the conversion, which are calculated from the ECB's figures. Reference rates are for information only: the ECB strongly discourages using them for transactions.

- The source is named: the European Central Bank's daily reference rates for about 30 currencies.
- Any base currency: cross rates are calculated for you.
- A weekend or holiday answers with the last published day and says which, so your code never gets an empty answer.

## Calls

### `POST https://readymadeapi.com/v1/fx/rates`

Reference rates for a day, against any base currency. Weekends and holidays answer with the last published day.

- Price: $0.00016 per call
- MCP tool: `fx_rates_rates`
- Answers in the same call.

Request:

```json
{
  "base": "EUR",
  "symbols": ["USD", "RON", "GBP"]
}
```

Answer:

```json
{
  "base": "EUR",
  "date": "2026-11-19",
  "rates": {
    "USD": 1.0992,
    "RON": 5.3473,
    "GBP": 0.83581
  },
  "source": "European Central Bank, euro foreign exchange reference rates",
  "notice": "These rates are available free of charge at ecb.europa.eu. Rates against a base other than EUR and converted amounts are calculated from them. For information only; the ECB discourages their use for transactions."
}
```

### `POST https://readymadeapi.com/v1/fx/convert`

Convert an amount between two currencies at the reference rate of a day.

- Price: $0.00016 per call
- MCP tool: `fx_rates_convert`
- Answers in the same call.

Request:

```json
{
  "amount": 250,
  "from": "USD",
  "to": "RON"
}
```

Answer:

```json
{
  "amount": 250.0,
  "from": "USD",
  "to": "RON",
  "date": "2026-11-19",
  "rate": 4.86472,
  "result": 1216.1799,
  "source": "European Central Bank, euro foreign exchange reference rates",
  "notice": "These rates are available free of charge at ecb.europa.eu. Rates against a base other than EUR and converted amounts are calculated from them. For information only; the ECB discourages their use for transactions."
}
```

## Limits

- About 30 currencies, the last 90 days.

## Questions

**Are these live market rates?**

No. The ECB publishes one reference rate per currency each working day, around 16:00 CET. They are for information: the ECB discourages using them for transactions.

**Can I change the base currency?**

Yes. Send any currency the ECB publishes as the base; the cross rates are calculated from the ECB's euro rates.

**How far back does it go?**

90 days.

**Isn't this data free?**

It is: the ECB publishes it free of charge. You pay here for the JSON, the cross rates and the conversion.

## Using it

- Send `Authorization: Bearer <key>` and a JSON body. Keys and credit: https://readymadeapi.com/account
- Every answer carries `X-Request-Id`, `X-Units` and `X-Charged-Usd`.
- An error is a JSON problem with a `title` to act on and a `detail` in plain words; nothing is charged for it.
- Full schema: https://readymadeapi.com/openapi.json
