Публичный API

API v1 — документация

Официальные курсы ЦБ РФ и ключевые ставки центральных банков в JSON. Без ключа: 60 запросов/мин на IP.

Условия использования · Виджет для сайтов · О методологии

Лимит без ключа

60 req/min

Валют в каталоге

Кэш ответа

до 1 часа

Быстрый старт

Получите курсы: GET /api/v1/rates/latest/
Конвертация: GET /api/v1/convert/?amount=100&from=USD&to=EUR
Укажите атрибуцию «Данные ЦБ РФ» и ссылку на kurs-rublya.ru
Для сайта без кода — используйте embed-виджет

API-ключ (опционально)

Без ключа — 60 запросов/мин на IP. С ключом — до 300–600 req/min по согласованию (условия). Запрос ключа: info@kurs-rublya.ru

Эндпоинты

GET/api/v1/rates/latest/

Все актуальные курсы ЦБ РФ. В ответе: ratePerUnit, value, previousRatePerUnit, changePercent.

cURL

curl -s "https://kurs-rublya.ru/api/v1/rates/latest/" -H "Accept: application/json"

GET/api/v1/rates/by-date/{date}/

Все курсы на календарную дату из архива (YYYY-MM-DD).

cURL

curl -s "https://kurs-rublya.ru/api/v1/rates/by-date/2026-07-17/" -H "Accept: application/json"

GET/api/v1/rates/{code}/

Курс одной валюты (ISO code, например USD) с изменением к предыдущей публикации.

cURL

curl -s "https://kurs-rublya.ru/api/v1/rates/USD/" -H "Accept: application/json"

GET/api/v1/rates/{code}/series/

Временной ряд курса к рублю. Параметры: from, to (YYYY-MM-DD), limit (до 1000).

cURL

curl -s "https://kurs-rublya.ru/api/v1/rates/USD/series/?limit=90" -H "Accept: application/json"

GET/api/v1/convert/

Конвертация суммы по курсам ЦБ. Параметры: amount, from, to (по умолчанию RUB).

cURL

curl -s "https://kurs-rublya.ru/api/v1/convert/?amount=100&from=USD&to=EUR" -H "Accept: application/json"

GET/api/v1/embed/{code}/

HTML-виджет для iframe (партнёры). Возвращает text/html, не JSON.

cURL

curl -s "https://kurs-rublya.ru/api/v1/embed/usd/" -H "Accept: text/html"

GET/api/v1/key-rates/

Снимки ключевых ставок всех центральных банков из реестра.

cURL

curl -s "https://kurs-rublya.ru/api/v1/key-rates/" -H "Accept: application/json"

GET/api/v1/key-rates/{id}/

Текущая ключевая ставка одного ЦБ (id: cbr, fed, ecb, …).

cURL

curl -s "https://kurs-rublya.ru/api/v1/key-rates/cbr/" -H "Accept: application/json"

GET/api/v1/key-rates/{id}/series/

Временной ряд ставки. Параметры: from, to (YYYY-MM-DD), limit (до 1000).

cURL

curl -s "https://kurs-rublya.ru/api/v1/key-rates/cbr/series/?from=2024-01-01&limit=120" -H "Accept: application/json"

GET/api/v1/key-rates/{id}/history/

Журнал решений по ставке. Параметры: offset, limit (до 500).

cURL

curl -s "https://kurs-rublya.ru/api/v1/key-rates/cbr/history/?limit=20" -H "Accept: application/json"

GET/api/v1/key-rates/{id}/meetings/

Последнее/следующее заседание и опубликованный календарь политики.

cURL

curl -s "https://kurs-rublya.ru/api/v1/key-rates/cbr/meetings/" -H "Accept: application/json"

Коды ответов

Код	Значение
200	Успешный ответ
401	Неверный API-ключ
404	Валюта не найдена
429	Превышен лимит запросов
502	Временная ошибка источника данных

Поля ответа JSON

date / dateIso — дата публикации ЦБ РФ
sourceUrl — публичная страница ЦБ
attribution — обязательная формулировка для отображения
currencies — объект курсов: ratePerUnit, nominal

OpenAPI 3.1 — скачать спецификацию

Машиночитаемая спецификация для генерации клиентов и тестов:

https://kurs-rublya.ru/api/v1/openapi/