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);