курсрубля
Публичный API

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

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

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

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

60 req/min

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

55

Кэш ответа

до 1 часа

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

  1. Получите курсы: GET /api/v1/rates/latest/
  2. Укажите атрибуцию «Данные ЦБ РФ» и ссылку на kurs-rublya.ru
  3. Для сайта без кода — используйте embed-виджет

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

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

Эндпоинты

GET/api/v1/rates/latest/

Все актуальные курсы ЦБ РФ на последнюю дату публикации.

cURL

curl -s "https://kurs-rublya.ru/api/v1/rates/latest/" -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/embed/{code}/

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

cURL

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

Коды ответов

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

Поля ответа JSON

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

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

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