Get time series of exchange rates

Retrieves available working-day exchange-rate observations over a date range. The response boundaries describe the first and last observations returned and can differ from the requested calendar boundaries. To fetch through the present, omit the end date in the actual URL as documented by Frankfurter (`YYYY-MM-DD..`).

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

Request

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

Request parameters

`start_date`

pathstringdaterequired

Start date in ISO 8601 format (YYYY-MM-DD)

2024-01-01

`end_date`

pathstringdaterequired

End date in ISO 8601 format (YYYY-MM-DD). Can be omitted by using format "start_date.." to get all rates from start_date onwards.

2024-01-31

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

TimeSeriesResponseapplication/json

Successful response with time series exchange rates

Properties: amountbasestart_dateend_daterates

`404`

Errorapplication/json

No data available for the specified date range

Properties: message

`422`

Errorapplication/json

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

Properties: message

{
  "amount": 1,
  "base": "EUR",
  "start_date": "2023-12-29",
  "end_date": "2024-01-31",
  "rates": {
    "2024-01-01": {
      "USD": 1.1047,
      "GBP": 0.8692
    },
    "2024-01-02": {
      "USD": 1.1023,
      "GBP": 0.8671
    }
  }
}