Frankfurter API (1.0.0)

Download OpenAPI specification:

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

Frankfurter is an open-source API for current and historical foreign exchange rates, sourcing currency data from public providers like the European Central Bank.

current-rates

Latest foreign exchange rates

Get the latest rates

Returns the last working day's rates

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" Base currency to convert from
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" Example: symbols=USD,GBP Comma-separated list of currencies to convert to

Responses

Response samples

200
404

Content type

application/json

{"amount": 0,
"base": "AUD",
"date": "2024-01-15",
"rates": {"AUD": 1.91,
"CAD": 1.8004,
"CHF": 1.6168,
"CYP": 0.58231
}
}

historical-rates

Historical exchange rates for specific dates and periods

Get rates for a past date

Returns historical rates for the working day closest to the specified date

path Parameters

date

required

string <date> (date)

Example: 2024-01-15

The date for the historical rates

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" Base currency to convert from
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" Example: symbols=USD,GBP Comma-separated list of currencies to convert to

Responses

Response samples

200
404

Content type

application/json

{"amount": 0,
"base": "AUD",
"date": "2024-01-15",
"rates": {"AUD": 1.91,
"CAD": 1.8004,
"CHF": 1.6168,
"CYP": 0.58231
}
}

Get rates for a time period

Returns historical rates for every day within a time period starting from the provided date until today.

path Parameters

start_date

required

string <date> (date)

Example: 2024-01-15

The start date for the 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" Base currency to convert from
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" Example: symbols=USD,GBP Comma-separated list of currencies to convert to

Responses

Response samples

200
404

Content type

application/json

{"amount": 0,
"base": "AUD",
"start_date": "2024-01-15",
"end_date": "2024-01-15",
"rates": {"1999-01-04": {"AUD": 1.91
},
"1999-01-05": {"AUD": 1.8944
},
"1999-01-06": {"AUD": 1.882
}
}
}

Get rates for a time period

Returns historical rates for every day within a time period. The end date defaults to today if not provided.

path Parameters

start_date required	string <date> (date) Example: 2024-01-15 The start date for the period
end_date required	string <date> (date) Example: 2024-01-15 The end date for the 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" Base currency to convert from
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" Example: symbols=USD,GBP Comma-separated list of currencies to convert to

Responses

Response samples

200
404

Content type

application/json

{"amount": 0,
"base": "AUD",
"start_date": "2024-01-15",
"end_date": "2024-01-15",
"rates": {"1999-01-04": {"AUD": 1.91
},
"1999-01-05": {"AUD": 1.8944
},
"1999-01-06": {"AUD": 1.882
}
}
}

metadata

API reference data like available currencies

Get available currencies

Returns a list of available currencies with their full names

Responses

Response samples

200

Content type

application/json

{"AUD": "Australian Dollar",
"BGN": "Bulgarian Lev",
"EUR": "Euro",
"USD": "US Dollar"
}