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?
-
Потому что нашим первым источником данных был