API docs by Redocly

Frankfurter API (1.0.0)

Download OpenAPI specification:

URL: https://github.com/lineofflight/frankfurter/issues License: MIT

Frankfurter is an open-source API allowing users to retrieve the latest currency rates, historical currency data, as well as currency rates over specific time periods.

Official Frankfurter v1 API documentation

current-rates

Latest working day's currency rates, updated daily around 16:00 CET. The default currency rate is given in euros. Users can either fetch the full list of currencies or restrict the currency rates to a limited set.

Latest working day's currency rates.

Fetch the latest working day's currency rates, updated daily around 16:00 CET.

query Parameters
base
string (baseIn)
Default: "EUR"
Enum: "AUD" "BGN" "BRL" "CAD" "CHF" "CNY" "CZK" "DKK" "EUR" "GBP" "HKD" "HUF" "IDR" "ILS" "INR" "ISK" "JPY" "KRW" "MXN" "MYR" "NOK" "NZD" "PHP" "PLN" "RON" "SEK" "SGD" "THB" "TRY" "USD" "ZAR"

Currency base rate. The default base rate is EUR and all rates are provided relative to the EUR when the default applies.

symbols
Array of strings (base) non-empty
Items Enum: "AUD" "BGN" "BRL" "CAD" "CHF" "CNY" "CZK" "DKK" "EUR" "GBP" "HKD" "HUF" "IDR" "ILS" "INR" "ISK" "JPY" "KRW" "MXN" "MYR" "NOK" "NZD" "PHP" "PLN" "RON" "SEK" "SGD" "THB" "TRY" "USD" "ZAR"

Currency to be provided in the response. One or multiple currencies as comma-separated list. If not specified, the endpoint returns the rates for all available currencies.

Responses

Response samples

Content type
application/json
{
  • "amount": 1,
  • "base": "EUR",
  • "date": "2026-07-24",
  • "rates": {
    }
}

historical-rates

Retrieve rates for a specific date or over a period of time. The Frankfurter API stores dates in UTC. Users can also fetch rates up to the present. Historical data is available from 1999-01-04. Returns 404 when no rate data exists for the requested date. This occurs for dates before the ECB began publishing exchange rates, future dates, and dates falling on weekends or bank holidays when no trading takes place.

Currency rates for a specific date.

Retrieve currency rate for a given date. Date must be specified in the format YYYY-MM-DD. Earliest date available is 1999-01-04. Dates prior to that day return a 404 Not Found. The Frankfurter API stores dates in UTC. Data returned for today may update if new rates are published during the day.

path Parameters
date
required
string <date> (date)
Example: 2024-01-15

Date in YYYY-MM-DD format. Earliest available date is 1999-01-04.

query Parameters
base
string (baseIn)
Default: "EUR"
Enum: "AUD" "BGN" "BRL" "CAD" "CHF" "CNY" "CZK" "DKK" "EUR" "GBP" "HKD" "HUF" "IDR" "ILS" "INR" "ISK" "JPY" "KRW" "MXN" "MYR" "NOK" "NZD" "PHP" "PLN" "RON" "SEK" "SGD" "THB" "TRY" "USD" "ZAR"

Currency base rate. The default base rate is EUR and all rates are provided relative to the EUR when the default applies.

symbols
Array of strings (base) non-empty
Items Enum: "AUD" "BGN" "BRL" "CAD" "CHF" "CNY" "CZK" "DKK" "EUR" "GBP" "HKD" "HUF" "IDR" "ILS" "INR" "ISK" "JPY" "KRW" "MXN" "MYR" "NOK" "NZD" "PHP" "PLN" "RON" "SEK" "SGD" "THB" "TRY" "USD" "ZAR"

Currency to be provided in the response. One or multiple currencies as comma-separated list. If not specified, the endpoint returns the rates for all available currencies.

Responses

Response samples

Content type
application/json
{
  • "amount": 1,
  • "base": "EUR",
  • "date": "2026-07-24",
  • "rates": {
    }
}

Currency rates from a start date to today.

Returns currency rates from a specific start date up to the present. If the start date falls before 1999-01-04, the API silently adjusts it to 1999-01-04, which is the earliest date for which data is available. The adjusted start date is reflected in the response body. Dates are stored in UTC. Results only include working days — weekends and bank holidays are excluded.

path Parameters
start_date
required
string <date> (date)
Example: 2024-01-15

The start date of the given period

query Parameters
base
string (baseIn)
Default: "EUR"
Enum: "AUD" "BGN" "BRL" "CAD" "CHF" "CNY" "CZK" "DKK" "EUR" "GBP" "HKD" "HUF" "IDR" "ILS" "INR" "ISK" "JPY" "KRW" "MXN" "MYR" "NOK" "NZD" "PHP" "PLN" "RON" "SEK" "SGD" "THB" "TRY" "USD" "ZAR"

Currency base rate. The default base rate is EUR and all rates are provided relative to the EUR when the default applies.

symbols
Array of strings (base) non-empty
Items Enum: "AUD" "BGN" "BRL" "CAD" "CHF" "CNY" "CZK" "DKK" "EUR" "GBP" "HKD" "HUF" "IDR" "ILS" "INR" "ISK" "JPY" "KRW" "MXN" "MYR" "NOK" "NZD" "PHP" "PLN" "RON" "SEK" "SGD" "THB" "TRY" "USD" "ZAR"

Currency to be provided in the response. One or multiple currencies as comma-separated list. If not specified, the endpoint returns the rates for all available currencies.

Responses

Response samples

Content type
application/json
{
  • "amount": 1,
  • "base": "EUR",
  • "start_date": "2025-10-01",
  • "end_date": "2025-10-15",
  • "rates": {
    }
}

Currency rates over a given period.

Returns currency rates from a specific start date up to an end date. If the start date falls before 1999-01-04, the API silently adjusts it to 1999-01-04, which is the earliest date for which data is available. If the end date falls in the future, the API silently adjusts it to the latest working day. If the end date is before the start date, the API returns a 404 Not Found error. The adjusted start date is reflected in the response body. Dates are stored in UTC. Results only include working days — weekends and bank holidays are excluded.

path Parameters
start_date
required
string <date> (date)
Example: 2024-01-15

The start date of the given period

end_date
required
string <date> (date)
Example: 2024-01-15

The end date of the given period

query Parameters
base
string (baseIn)
Default: "EUR"
Enum: "AUD" "BGN" "BRL" "CAD" "CHF" "CNY" "CZK" "DKK" "EUR" "GBP" "HKD" "HUF" "IDR" "ILS" "INR" "ISK" "JPY" "KRW" "MXN" "MYR" "NOK" "NZD" "PHP" "PLN" "RON" "SEK" "SGD" "THB" "TRY" "USD" "ZAR"

Currency base rate. The default base rate is EUR and all rates are provided relative to the EUR when the default applies.

symbols
Array of strings (base) non-empty
Items Enum: "AUD" "BGN" "BRL" "CAD" "CHF" "CNY" "CZK" "DKK" "EUR" "GBP" "HKD" "HUF" "IDR" "ILS" "INR" "ISK" "JPY" "KRW" "MXN" "MYR" "NOK" "NZD" "PHP" "PLN" "RON" "SEK" "SGD" "THB" "TRY" "USD" "ZAR"

Currency to be provided in the response. One or multiple currencies as comma-separated list. If not specified, the endpoint returns the rates for all available currencies.

Responses

Response samples

Content type
application/json
{
  • "amount": 1,
  • "base": "EUR",
  • "start_date": "2025-10-01",
  • "end_date": "2025-10-15",
  • "rates": {
    }
}

metadata

Get a complete list of supported currency symbols and their full names. The currency code format is given according to ISO 4217.

List of supported currency symbols and their full names.

Get a complete list of supported currency symbols and their full names. The currency code format is given according to ISO 4217.

Responses

Response samples

Content type
application/json
{
  • "AUD": "Australian Dollar",
  • "EUR": "Euro",
  • "USD": "United States Dollar"
}