Официальный источник данных: Банк России (ЦБ РФ) предоставляет официальный веб-сервис для получения данных о ключевой ставке.
В частности, метод KeyRate(fromDate, ToDate) позволяет получить динамику ставки за период.
Отличия API legalcalc.ru: Наше API предоставляет аналогичные данные, но дополненные полем rate474.
Это поле учитывает особый порядок расчета неустойки (пени) за несвоевременное или неполное внесение платы за жилое помещение и коммунальные услуги, установленный Правительством РФ для определенного периода.
Согласно Постановлению Правительства РФ от 26.03.2022 № 474 (действовало до 01.01.2025), расчет пени осуществлялся исходя из минимального значения ключевой ставки ЦБ РФ: действующей на 27.02.2022 и действующей на день фактической оплаты.
С 01.01.2025 года порядок расчета пени регулируется Постановлением Правительства РФ от 18.03.2024 № 329, которое продлевает применение аналогичного правила (учет минимальной ставки) до 01.01.2027 года. Поле rate474 в нашем API отражает именно эту ставку, применяемую для расчетов в сфере ЖКУ в соответствующие периоды.
Для доступа к API необходим токен. Передайте его в параметре token в каждом запросе.
GET /api/public/keyrate
Возвращает список всех ключевых ставок ЦБ РФ.
Параметры:
token - Ваш API токенGET /api/public/keyrate/period
Возвращает список ставок за указанный период.
Параметры:
token - Ваш API токенstart_date - Дата начала периода (YYYY-MM-DD)end_date - Дата окончания периода (YYYY-MM-DD)GET /api/public/keyrate/date
Возвращает значение ключевой ставки, действующее на указанную дату.
Параметры:
token - Ваш API токенdate - Дата (YYYY-MM-DD)GET /api/public/keyrate/calculate
Рассчитывает проценты по ключевой ставке за период.
Параметры:
token - Ваш API токенamount - Суммаstart_date - Дата начала периода (YYYY-MM-DD)end_date - Дата окончания периода (YYYY-MM-DD)API возвращает данные в формате JSON.
Успешный ответ имеет статус 200 и содержит поле "success": true и поле data с результатами.
Объекты, содержащие данные о ставке, включают поля:
date (string) - Дата начала действия ставки (YYYY-MM-DD)rate (number) - Значение основной ключевой ставки (в процентах)rate474 (number|null) - Альтернативное значение ставки для расчетов по Постановлению №474 (если применимо, иначе null)document (string) - Документ, которым введена ставкаВ случае ошибки ответ содержит поле error с описанием проблемы и "success": false.
