Есть вопросы или проблемы? Пишите в 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.