Є запитання чи проблеми? Пишіть у GitHub Discussions.

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&quotes=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.