Frankfurter API курсів валют
Frankfurter є безкоштовним API курсів для 219 валют та 39 інших активів від 112 центральних банків та офіційних джерел. Курси оновлюються протягом дня. Щоденна історія сягає 1948 року.
Публічний API доступний за адресою api.frankfurter.dev. Ключ API не потрібен. Проєкт має відкритий код, тож ви також можете розгорнути його у себе й мати повний контроль.
Це довідкові курси, а не біржові котирування в реальному часі. Кожне джерело публікує їх один чи кілька разів на день.
Працюєте з AI-агентом? Дайте йому llms.txt або підключіть MCP-сервер.
Курси
Отримайте останні курси.
curl https://api.frankfurter.dev/v2/rates
Змініть базову валюту за допомогою base.
curl https://api.frankfurter.dev/v2/rates?base=usd
Відфільтруйте цільові валюти за допомогою quotes.
curl https://api.frankfurter.dev/v2/rates?quotes=usd,gbp
Історичні курси
Знайдіть курси на конкретну дату.
curl https://api.frankfurter.dev/v2/rates?date=1999-01-04
Часові ряди
Отримайте курси за період за допомогою from і to.
curl https://api.frankfurter.dev/v2/rates?from=2026-01-01"es=usd
Порада: що менше валют, то менша відповідь. Для великих діапазонів дат запитуйте NDJSON, щоб отримувати результати потоково, рядок за рядком.
Групування
Зменште деталізацію часового ряду за допомогою group. Підтримуються week і month.
curl https://api.frankfurter.dev/v2/rates?from=2026-01-01&group=month
Фільтрування за джерелом
Обмежте вибірку конкретними джерелами за допомогою providers.
curl https://api.frankfurter.dev/v2/rates?providers=ecb
За замовчуванням курси зводяться з усіх джерел. Використовуйте providers, щоб отримати курси конкретного джерела, або
маршрути джерел, щоб звертатися до джерела
напряму.
Деякі джерела публікують кілька наборів даних, наприклад щоденні й щотижневі таблиці NBP. Ключ джерела вибирає його набори даних за замовчуванням. Ключ набору даних вибирає лише один набір.
curl https://api.frankfurter.dev/v2/rates?providers=nbp.b&base=pln"es=ars,ngn
Атрибуція джерел
Додайте expand=providers, щоб побачити, які джерела увійшли до
кожного зведеного курсу.
curl https://api.frankfurter.dev/v2/rates?expand=providers
Кожен рядок отримує масив providers із ключами джерел, що увійшли до розрахунку.
Рядки валют із фіксованим курсом не мають цього поля: їхні курси походять із прив’язки,
а не з даних джерел.
Вивід у CSV
Курси також доступні у форматі CSV. Додайте .csv до шляху або встановіть
заголовок Accept у text/csv.
curl https://api.frankfurter.dev/v2/rates.csv
Вивід у NDJSON
Для великих відповідей запитуйте
NDJSON
(JSON, розділений символами нового рядка), встановивши заголовок Accept у
application/x-ndjson. Кожен рядок є окремим об’єктом JSON,
що зручно для потокової обробки великих часових рядів без буферизації всієї
відповіді.
curl https://api.frankfurter.dev/v2/rates?from=2026-01-01
Курс
Отримайте курс для однієї валютної пари. За потреби додайте date або
providers.
curl https://api.frankfurter.dev/v2/rate/eur/usd
Валюти
Отримайте доступні валюти з покриттям джерел.
curl https://api.frankfurter.dev/v2/currencies
Включіть застарілі валюти за допомогою scope.
curl https://api.frankfurter.dev/v2/currencies?scope=all
Валюта
Отримайте подробиці та покриття джерел для однієї валюти.
curl https://api.frankfurter.dev/v2/currency/eur
Джерела
Перелік джерел, на яких працює API.
curl https://api.frankfurter.dev/v2/providers
Отримайте подробиці про одне джерело.
curl https://api.frankfurter.dev/v2/providers/ecb
Кожне джерело перелічує свої набори даних із власними датами, розкладом і валютами.
Курси за джерелом
Запитуйте курси безпосередньо в конкретного джерела. Підтримуються ті самі
параметри, що й у /v2/rates та /v2/rate.
curl https://api.frankfurter.dev/v2/providers/ecb/rates
Отримайте одну валютну пару від цього джерела.
curl https://api.frankfurter.dev/v2/providers/ecb/rate/eur/usd
Поєднуйте з date, діапазонами дат (from і to)
або групуванням. Формати .csv і ndjson тут теж працюють.
curl https://api.frankfurter.dev/v2/providers/ecb/rates?date=2024-05-15
Конвертація
Окремого ендпоінту для конвертації немає. Отримайте курс і сконвертуйте суму кількома рядками коду.
function convert(base, quote, amount) {
const api = "https://api.frankfurter.dev";
return fetch(`${api}/v2/rate/${base}/${quote}`)
.then((r) => r.json())
.then((d) => (amount * d.rate).toFixed(2));
}
convert("eur", "usd", 10).then((result) =>
alert(`10 EUR = ${result} USD`)
);
Помилки
API повертає стандартні коди стану HTTP з тілом у форматі JSON.
{
"status": 422,
"message": "invalid currency: ABC"
}
400- Недійсний параметр або некоректний запит.
404- Валюту, курс або ресурс не знайдено.
422- Запит зрозумілий, але його неможливо обробити.
Власне розгортання
Ви можете розгорнути Frankfurter у Docker. Налаштування для production і ключі API описано в посібнику Deploy.
Часті запитання
- Для кого Frankfurter (і для кого ні)?
- Він добре підходить для білінгу SaaS, електронної комерції, податкової звітності, ERP та облікових систем, а також для академічних досліджень з історичними рядами від 1948 року. Він не створений для торгівлі в реальному часі чи для екзотичних валют із різкими коливаннями протягом дня.
- Чи можна безкоштовно використовувати API в комерційних цілях?
- Так. Зведені курси розраховує сам Frankfurter, і ними можна користуватися безкоштовно. Прямі запити до ендпоінтів окремих джерел підпадають під умови кожного джерела.
- Чи можна зберігати або кешувати курси у власній базі даних?
- Так. Ми радимо зберігати щоденні дані локально для кешування чи історичної аналітики: так навантаження на API залишається невеликим.
- Чи має API обмеження на кількість запитів?
- Квот немає. Частоту запитів обмежено для захисту від зловживань, але щомісячних чи щоденних лімітів немає. Для великих обсягів варто кешувати відповіді, розгорнути власний екземпляр або запитувати набори даних напряму.
- Чи підтримує API GraphQL?
-
Ні. REST API досить простий, тож GraphQL додав би складності
без особливої користі. До того ж він зламав би edge-кешування, завдяки якому
API працює швидко. Використовуйте параметри запиту
base,quotesіfrom/to, щоб отримати саме ті дані, які потрібні. - Чи припиняють підтримку API v1?
- Ні. API v1 має статус deprecated на користь v2, але залишається доступним безстроково. Див. документацію v1. Для даних Європейського центрального банку використовуйте /v2/providers/ecb/rates.
- Яка політика конфіденційності API?
- API не збирає і не записує персональні дані, IP-адреси чи URL запитів. Публічний екземпляр працює за Cloudflare для кешування й захисту від DDoS, і Cloudflare надає лише зведену статистику трафіку.
- Чи потрібно зазначати API в мітках конфіденційності App Store або Google Play?
- Ні. Оскільки запити анонімні, а журнали запитів не зберігаються, за правилами Apple і Google Play вони належать до категорії Data Not Collected (дані не збираються).
- Де повідомити про помилку чи поставити запитання?
- Відкрийте issue, щоб повідомити про помилку, запропонувати функцію чи нове джерело. У Discussions можна ставити запитання або ділитися бібліотекою чи інструментом, які ви створили з Frankfurter.
- Наскільки точні курси?
- Для відповідності вимогам (податки й облік) фільтруйте за конкретним джерелом, щоб отримати офіційні довідкові курси. Для загального використання добре підходять зведені курси за замовчуванням, хоча останні знаки після коми можуть змінюватися з надходженням нових даних.
- Це середні курси, курси купівлі чи продажу?
- API повертає середньоринкові курси. Якщо джерело публікує курси купівлі й продажу замість довідкового курсу, Frankfurter зберігає обидва й обчислює середнє.
- Чи всі курси щоденні?
-
Майже всі. Деякі джерела надають щотижневі, щомісячні або квартальні дані. Такі джерела не входять до зведених курсів. Запитуйте їх напряму за допомогою фільтра
providers. - Чи є курси дорогоцінних металів або криптовалют?
-
Так. Кілька центральних банків щодня публікують ціни на золото (
XAU), срібло (XAG), платину (XPT) і паладій (XPD) за тройську унцію. Для криптовалют ми обмежуємося монетами з ф’ючерсами CME або CME CF Reference Rate (як-отBTC,ETH,SOLіXRP), а такожUSDTіUSDC. Криптовалюти мають лише кілька джерел, тож покриття невелике. - Чому дати деяких старих і нових валют перетинаються?
-
Деякі джерела переносять курси нової валюти на період старої
(наприклад,
TRLзакінчується у 2010 році, аTRYпочинається у 1996-му). Ми зберігаємо дані джерел як є й відфільтровуємо перетини лише під час зведення. - Чому Frankfurter?
-
Бо нашим першим джерелом даних був