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