Публичный API

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

Официальные курсы ЦБ РФ и ключевые ставки в JSON. Без ключа — 60 req/min на IP; ключ на 300 req/min — на этой странице по email.

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

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

60 req/min

С ключом

300 req/min

Кэш ответа

до 1 часа

Онлайн

Получить API-ключ

Без ключа — 60 req/min на IP. С ключом — 300 req/min после подтверждения email. Ключ придёт на указанный адрес и отобразится на этой странице один раз.

  1. 1 · Email
  2. 2 · Код
  3. 3 · Ключ

На этот адрес придёт одноразовый код и сам ключ. Получая ключ, вы принимаете условия API.

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

  1. Запросите JSON: GET /api/v1/rates/latest/
  2. Для повышенного лимита передайте заголовок X-API-Key: kr_live_… (ключ — в блоке выше)
  3. Конвертация: GET /api/v1/convert/?amount=100&from=USD&to=EUR
  4. В интерфейсе укажите атрибуцию «Данные ЦБ РФ» и ссылку на
  5. Для сайта без серверного кода — HTML-виджет

Источник курсов — официальные публикации Банка России. Подробности и лимиты — в условиях API.

Проверка с ключом

Вставьте ключ, чтобы вызывать примеры ниже с лимитом 300 req/min. Правила выдачи и использования — в условиях API.

Эндпоинты

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/embed/convert/

HTML-конвертер валют ЦБ РФ для iframe. Параметры: from, to, amount, site.

cURL

curl -s "https://kurs-rublya.ru/api/v1/embed/convert/?from=USD&to=RUB&amount=100" -H "Accept: text/html"
GET/api/v1/embed/board/

HTML-табло нескольких валют для iframe. Параметры: codes (через запятую), site.

cURL

curl -s "https://kurs-rublya.ru/api/v1/embed/board/?codes=USD,EUR,CNY" -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Успешный ответ
400Некорректные параметры запроса
401Неверный или отозванный API-ключ
404Валюта или дата не найдены
429Превышен лимит запросов
502Временная ошибка источника данных

Поля ответа JSON

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

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

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

Документация API v1 — курсы ЦБ РФ и ключевые ставки — Курс рубля