Get historical exchange rates

Retrieves rates for a calendar date. Frankfurter stores dates in UTC. Non-working dates resolve to the latest available working-day observation on or before the requested date; the returned `date` therefore may differ from the requested date. Today's result can change when new rates arrive. v1 EUR history begins on 1999-01-04.

Query ECB reference rates, currencies, and historical time series without an API key; this collection covers the still-available v1.

Request

operationId: getHistoricalRates
Server: https://api.frankfurter.dev/v1
Authentication: None

Request parameters

`date`

pathstringdaterequired

Date in ISO 8601 format (YYYY-MM-DD)

2024-01-15

`amount`

querynumberdouble

The amount to be converted (default is 1)

`base`

querystring

Base currency code (three-letter ISO 4217 code)

EUR

`symbols`

querystring

Comma-separated list of currency codes to limit the response

Responses

`200`

ExchangeRateResponseapplication/json

Successful response with historical exchange rates

Properties: amountbasedaterates

`404`

Errorapplication/json

No data available for the specified date

Properties: message

`422`

Errorapplication/json

Unprocessable date or query parameter, for example an invalid calendar date or amount

Properties: message

{
  "amount": 1,
  "base": "EUR",
  "date": "2026-01-23",
  "rates": {
    "USD": 1.0445,
    "GBP": 0.8342,
    "JPY": 161.23,
    "CHF": 0.9234,
    "AUD": 1.6111
  }
}