{"openapi":"3.1.0","info":{"title":"kurs-rublya.ru Public API","version":"1.1.0","description":"Официальные курсы валют ЦБ РФ к рублю и ключевые ставки центральных банков. Курсы — только ЦБ РФ. Ключевые ставки — официальные источники ЦБ (см. sourceLabelRu). При использовании указывайте атрибуцию и ссылку на kurs-rublya.ru.","termsOfService":"https://kurs-rublya.ru/api-terms/"},"servers":[{"url":"https://kurs-rublya.ru"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Опционально. Без ключа — 60 req/min на IP. Ключ на 300 req/min — подтверждение email на /api-docs/. Повышенный лимит — по запросу (условия: /api-terms/)."}}},"security":[{"ApiKeyAuth":[]}],"paths":{"/api/v1/rates/latest/":{"get":{"summary":"Все актуальные курсы ЦБ РФ","description":"Курсы на последнюю дату публикации ЦБ. Для каждой валюты: ratePerUnit, value (за nominal), previousRatePerUnit и changePercent к предыдущей публикации.","security":[{},{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Курсы на последнюю дату публикации ЦБ"},"429":{"description":"Превышен лимит запросов"}}}},"/api/v1/convert/":{"get":{"summary":"Конвертация суммы по курсам ЦБ РФ","description":"Пересчёт через рубль по официальным курсам. Параметры: amount, from, to (ISO; to по умолчанию RUB).","security":[{},{"ApiKeyAuth":[]}],"parameters":[{"name":"amount","in":"query","required":true,"schema":{"type":"number","example":100}},{"name":"from","in":"query","required":true,"schema":{"type":"string","example":"USD"}},{"name":"to","in":"query","schema":{"type":"string","example":"EUR","default":"RUB"}}],"responses":{"200":{"description":"result, rate, formula, дата курсов"},"400":{"description":"Некорректные параметры"},"404":{"description":"Пара валют недоступна"},"429":{"description":"Превышен лимит запросов"}}}},"/api/v1/rates/by-date/{date}/":{"get":{"summary":"Все курсы ЦБ РФ на календарную дату (архив БД)","description":"Курсы на календарную дату из архива сайта (как на /kurs-na-datu/). 404 — нет публикации ЦБ РФ на эту дату.","security":[{},{"ApiKeyAuth":[]}],"parameters":[{"name":"date","in":"path","required":true,"schema":{"type":"string","format":"date","example":"2026-07-17"}}],"responses":{"200":{"description":"Курсы на указанную дату (формат как /rates/latest/)"},"400":{"description":"Некорректная дата"},"404":{"description":"Нет данных на эту дату в архиве"},"429":{"description":"Превышен лимит запросов"}}}},"/api/v1/rates/{code}/":{"get":{"summary":"Курс одной валюты (ISO code)","description":"ratePerUnit, value, previousRatePerUnit, changePercent к предыдущей публикации ЦБ.","security":[{},{"ApiKeyAuth":[]}],"parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","example":"USD"}}],"responses":{"200":{"description":"Курс валюты"},"404":{"description":"Валюта не найдена"},"429":{"description":"Превышен лимит запросов"}}}},"/api/v1/rates/{code}/series/":{"get":{"summary":"Временной ряд курса валюты к рублю","security":[{},{"ApiKeyAuth":[]}],"parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","example":"USD"}},{"name":"from","in":"query","schema":{"type":"string","format":"date","example":"2025-01-01"}},{"name":"to","in":"query","schema":{"type":"string","format":"date","example":"2026-07-01"}},{"name":"limit","in":"query","schema":{"type":"integer","default":400,"maximum":1000}}],"responses":{"200":{"description":"Точки ряда: dateIso, ratePerUnit"},"400":{"description":"Некорректные параметры даты"},"404":{"description":"Валюта не найдена"},"429":{"description":"Превышен лимит запросов"}}}},"/api/v1/embed/{code}/":{"get":{"summary":"HTML-виджет курса для iframe (партнёры)","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","example":"usd"}},{"name":"site","in":"query","schema":{"type":"string","example":"example.ru"},"description":"Опциональный домен .ru партнёра"}],"responses":{"200":{"description":"Минимальный HTML для встраивания"}}}},"/api/v1/embed/convert/":{"get":{"summary":"HTML-конвертер валют ЦБ РФ для iframe","parameters":[{"name":"from","in":"query","schema":{"type":"string","example":"USD"}},{"name":"to","in":"query","schema":{"type":"string","example":"RUB"}},{"name":"amount","in":"query","schema":{"type":"number","example":100}},{"name":"site","in":"query","schema":{"type":"string","example":"example.ru"}}],"responses":{"200":{"description":"Интерактивный HTML-конвертер для iframe"}}}},"/api/v1/embed/board/":{"get":{"summary":"HTML-табло нескольких валют для iframe","description":"Параметры: codes (через запятую, до 12 ISO-кодов), theme (light|dark), site (домен .ru).","security":[{},{"ApiKeyAuth":[]}],"parameters":[{"name":"codes","in":"query","schema":{"type":"string","example":"USD,EUR,CNY"}},{"name":"theme","in":"query","schema":{"type":"string","enum":["light","dark"],"default":"dark"}},{"name":"site","in":"query","schema":{"type":"string","example":"example.ru"}}],"responses":{"200":{"description":"HTML-табло курсов для iframe"}}}},"/api/v1/key-rates/":{"get":{"summary":"Снимки ключевых ставок всех центральных банков","security":[{},{"ApiKeyAuth":[]}],"responses":{"200":{"description":"Текущие ставки и заседания по всем банкам из реестра"},"429":{"description":"Превышен лимит запросов"}}}},"/api/v1/key-rates/{id}/":{"get":{"summary":"Ключевая ставка одного центрального банка","security":[{},{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"cbr"},"description":"Идентификатор ЦБ (cbr, fed, ecb, …)"}],"responses":{"200":{"description":"Текущая ставка, изменение, ссылки на series/history/meetings"},"404":{"description":"Центральный банк не найден"},"429":{"description":"Превышен лимит запросов"}}}},"/api/v1/key-rates/{id}/series/":{"get":{"summary":"Временной ряд ключевой ставки","security":[{},{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"cbr"}},{"name":"from","in":"query","schema":{"type":"string","format":"date","example":"2024-01-01"}},{"name":"to","in":"query","schema":{"type":"string","format":"date","example":"2026-01-01"}},{"name":"limit","in":"query","schema":{"type":"integer","default":500,"maximum":1000}}],"responses":{"200":{"description":"Точки ряда: effectiveDate, ratePercent, changeBp"},"400":{"description":"Некорректные параметры даты"},"404":{"description":"Центральный банк не найден"},"429":{"description":"Превышен лимит запросов"}}}},"/api/v1/key-rates/{id}/history/":{"get":{"summary":"Журнал решений по ключевой ставке","security":[{},{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"cbr"}},{"name":"offset","in":"query","schema":{"type":"integer","default":0}},{"name":"limit","in":"query","schema":{"type":"integer","default":100,"maximum":500}}],"responses":{"200":{"description":"Решения с пагинацией"},"404":{"description":"Центральный банк не найден"},"429":{"description":"Превышен лимит запросов"}}}},"/api/v1/key-rates/{id}/meetings/":{"get":{"summary":"Заседания и календарь политики","security":[{},{"ApiKeyAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"cbr"}}],"responses":{"200":{"description":"Последнее/следующее заседание и опубликованный календарь"},"404":{"description":"Центральный банк не найден"},"429":{"description":"Превышен лимит запросов"}}}},"/api/v1/keys/request/":{"post":{"summary":"Запросить код подтверждения для API-ключа","description":"Отправляет одноразовый код на email. Только с origin сайта. Не для сервер-сервер интеграций.","security":[],"responses":{"200":{"description":"Код отправлен на email"},"400":{"description":"Некорректный email"},"403":{"description":"Запрос с недопустимого origin"},"429":{"description":"Слишком много запросов"},"502":{"description":"Не удалось отправить письмо"},"503":{"description":"Выдача ключей временно недоступна"}}}},"/api/v1/keys/verify/":{"post":{"summary":"Подтвердить код и получить API-ключ","description":"Возвращает ключ один раз в JSON и дублирует на email. Повторный выпуск для того же email отзывает предыдущий ключ.","security":[],"responses":{"200":{"description":"Ключ выдан (apiKey в JSON и на email)"},"400":{"description":"Неверный или просроченный код"},"403":{"description":"Запрос с недопустимого origin"},"429":{"description":"Слишком много попыток"},"503":{"description":"Выдача ключей временно недоступна"}}}}}}