API v1 имеет статус deprecated в пользу v2, но продолжит работать.

Получайте последние курсы, исторические курсы или временные ряды.

Последние курсы

Получите курсы за последний рабочий день; они обновляются ежедневно около 16:00 CET.

curl https://api.frankfurter.dev/v1/latest

Смените базовую валюту параметром base. По умолчанию используется EUR.

curl https://api.frankfurter.dev/v1/latest?base=USD

Ограничьте ответ конкретными целевыми валютами.

curl https://api.frankfurter.dev/v1/latest?symbols=CHF,GBP

Исторические курсы

Получите курсы на конкретную дату.

curl https://api.frankfurter.dev/v1/1999-01-04

Смените базовую валюту и отфильтруйте целевые валюты.

curl https://api.frankfurter.dev/v1/1999-01-04?base=USD&symbols=EUR

Примечание: Frankfurter хранит даты в UTC, поэтому в другом часовом поясе вы можете запросить не ту календарную дату, которую ожидаете. Сегодняшние курсы ещё могут измениться, если опубликуют новые.

Временные ряды

Получите курсы за период.

curl https://api.frankfurter.dev/v1/2000-01-01..2000-12-31

Получите курсы по текущую дату.

curl https://api.frankfurter.dev/v1/2024-01-01..

Совет: фильтруйте валюты, чтобы уменьшить ответ и ускорить работу.

curl https://api.frankfurter.dev/v1/2024-01-01..?symbols=USD

Доступные валюты

Получите поддерживаемые коды валют и их полные названия.

curl https://api.frankfurter.dev/v1/currencies

Конвертация валют

Получите курс и выполните конвертацию в своём коде.

function convert(from, to, amount) {
  fetch(`https://api.frankfurter.dev/v1/latest?base=${from}&symbols=${to}`)
    .then((resp) => resp.json())
    .then((data) => {
      const convertedAmount = (amount * data.rates[to]).toFixed(2);
      alert(`${amount} ${from} = ${convertedAmount} ${to}`);
    });
  }

convert("EUR", "USD", 10);