JavaScript
SDK не потрібен. fetch є в кожному браузері, Node, Deno, Bun та edge-середовищі. CORS відкритий, а ключа, який міг би витекти, немає, тож API можна викликати прямо з клієнтського коду.
Швидкий старт
Отримайте курс і сконвертуйте:
const res = await fetch("https://api.frankfurter.dev/v2/rate/usd/eur");
const data = await res.json();
const total = 100 * data.rate;
Відповідь є одним пласким об’єктом: {"date": "2026-07-17", "base": "USD", "quote": "EUR", "rate": 0.8739}. fetch виконується успішно навіть за помилок HTTP, тож перевіряйте res.ok; недійсний код валюти повертає 422 з повідомленням у JSON.
Форматування через Intl
Не розставляйте символи валют вручну. Intl.NumberFormat знає символ, його позицію та кількість знаків після коми для кожної валюти в кожній локалі:
const res = await fetch("https://api.frankfurter.dev/v2/rate/usd/eur");
const { rate } = await res.json();
const eur = new Intl.NumberFormat("en", {
style: "currency",
currency: "EUR",
});
eur.format(100 * rate); // "€87.39"
Символи та знаки після коми
Не потрібно тягнути власну таблицю метаданих про розмінні одиниці чи символи. Запитайте форматувальник:
const yen = new Intl.NumberFormat("en", {
style: "currency",
currency: "JPY",
});
yen.resolvedOptions().maximumFractionDigits; // 0, the yen has no subunits
yen.formatToParts(1).find((part) => part.type === "currency").value; // "¥"
Перегляньте всі валюти Frankfurter з їхніми кодами й символами.
Кілька валют одразу
/v2/rates повертає плаский масив, по рядку на кожну валюту. Перетворіть його на словник за допомогою Object.fromEntries. Пропустіть quotes, щоб отримати всі валюти.
const api = "https://api.frankfurter.dev";
const res = await fetch(`${api}/v2/rates?base=usd"es=eur,gbp,jpy`);
const rows = await res.json();
const rates = Object.fromEntries(rows.map((row) => [row.quote, row.rate]));
// { EUR: 0.8739, GBP: 0.74388, JPY: 162.33 }
Закріплення офіційного джерела
За замовчуванням ви отримуєте курс, зведений з усіх джерел. Додайте providers, щоб закріпити одну конкретну установу. Це важливо, коли юрисдикція вимагає курс, опублікований її центральним банком, як-от довідковий курс ЄЦБ для ПДВ у ЄС.
const api = "https://api.frankfurter.dev";
const res = await fetch(`${api}/v2/rate/usd/eur?providers=ecb`);
Перегляньте всі джерела. Закріплене джерело публікує дані за власним розкладом, тож його останній курс може відставати від останнього зведеного на день.
Спробуйте наживо
Складайте запити й дивіться відповіді, не виходячи з браузера, у Playground.