--- slug: "cbr" name: "ЦБ РФ — курсы валют и ставки (XML и DailyInfo)" vendor: "Банк России" industry: "finance" docsUrl: "https://www.cbr.ru/development/SXML/" version: 2 updatedAt: "2026-10-24" --- # ЦБ РФ — курсы валют и ставки (XML и DailyInfo) Отрасль: Платежи и финансы. Актуально на 2026-10-24. Открытые сервисы Банка России для получения официальных данных: курсы валют на дату и их динамика, справочник валют, цены драгоценных металлов, ставки межбанковского рынка и депозитных операций, ключевая ставка, RUONIA, остатки на корсчетах, международные резервы, справочник БИК. Есть два интерфейса: простые XML-скрипты (GET-запросы) и SOAP-сервис DailyInfoWebServ. Авторизация не нужна. ## Сценарии ### Получить официальные курсы валют на дату Курс доллара, евро и юаня ЦБ РФ на сегодня или на нужную дату — для пересчёта цен, отчётов и бухгалтерии. Ключ и регистрация не нужны. 1. Запроси курсы: GET /scripts/XML_daily.asp с date_req в формате дд/мм/гггг. Без параметра вернутся курсы на последнюю зарегистрированную дату. 2. В ответе XML: для каждой валюты Valute с CharCode (USD, EUR, CNY), Nominal, Value и VunitRate — курс за одну единицу. 3. Курс в Value указан за Nominal единиц, а дробная часть отделена запятой — замени её на точку перед преобразованием в число. 4. Курсы на завтра ЦБ публикует днём — если запросить будущую дату, придут курсы на ближайшую установленную дату; проверяй атрибут Date в корне ответа. ```python import requests, xml.etree.ElementTree as ET xml = requests.get("https://www.cbr.ru/scripts/XML_daily.asp", params={"date_req": "24/10/2026"}).content root = ET.fromstring(xml) rates = {v.findtext("CharCode"): float(v.findtext("VunitRate").replace(",", ".")) for v in root.findall("Valute")} print(root.get("Date"), rates["USD"], rates["EUR"], rates["CNY"]) ``` ### Динамика курса валюты за период График курса или пересчёт сумм по курсу на каждую дату периода. 1. Узнай внутренний код валюты: GET /scripts/XML_val.asp (d = 0 — валюты с ежедневными курсами). Для доллара это R01235, евро — R01239. 2. Запроси динамику: GET /scripts/XML_dynamic.asp с date_req1, date_req2 (дд/мм/гггг) и VAL_NM_RQ — внутренним кодом. 3. В ответе — записи Record с атрибутом Date и значениями Nominal и Value (с запятой). 4. Внутренний код может меняться при смене названия или номинала валюты. Для надёжной связи между системами используй общий код из справочника EnumValutes SOAP-сервиса. ```bash curl -G https://www.cbr.ru/scripts/XML_dynamic.asp \ -d date_req1=01/10/2026 -d date_req2=24/10/2026 -d VAL_NM_RQ=R01235 ``` ### Узнать ключевую ставку Ключевая ставка ЦБ на дату или история её изменений — для расчёта пеней, процентов и аналитики. 1. Вызови операцию KeyRate SOAP-сервиса DailyInfo: POST на /DailyInfoWebServ/DailyInfo.asmx с fromDate и ToDate (DateTime). 2. В ответе — таблица ставок по датам. Ставка действует с указанной даты до следующего изменения. 3. Если нужна только текущая ставка вместе с другими показателями (резервы, денежная база), проще вызвать MainInfoXML — без параметров. ```bash curl -X POST https://www.cbr.ru/DailyInfoWebServ/DailyInfo.asmx \ -H 'Content-Type: text/xml; charset=utf-8' \ -H 'SOAPAction: "http://web.cbr.ru/KeyRate"' \ -d ' 2026-01-01 2026-10-24 ' ``` ### Цены драгоценных металлов Учётные цены золота, серебра, платины и палладия за период. 1. Запроси цены: GET /scripts/xml_metall.asp с date_req1 и date_req2 (дд/мм/гггг). 2. В ответе — записи Record с датой и кодом металла: 1 — золото, 2 — серебро, 3 — платина, 4 — палладий. Цена за грамм, дробная часть — через запятую. 3. Тот же ряд через SOAP — операция DragMetDynamic с FromDate и ToDate. 4. С 01.07.2008 дата в ответе — дата действия цены, до неё — дата установления. ```bash curl -G https://www.cbr.ru/scripts/xml_metall.asp -d date_req1=01/10/2026 -d date_req2=24/10/2026 ``` ### Найти банк по БИК Проверить реквизиты при вводе платёжки: название банка по БИК. 1. Запроси справочник: GET /scripts/XML_bic.asp с bic — БИК из 9 цифр, или с name — частью названия банка. 2. Без параметров вернётся полный список кредитных организаций — его можно загрузить себе и обновлять раз в день. ```bash curl -G https://www.cbr.ru/scripts/XML_bic.asp -d bic=044525225 ``` ## Базовые URL - Боевой (XML-скрипты): `https://www.cbr.ru` - Боевой (SOAP DailyInfo): `http://www.cbr.ru/DailyInfoWebServ/DailyInfo.asmx` ## Авторизация Тип: Без авторизации Сервисы публичные, ключ и регистрация не требуются. ``` https://www.cbr.ru/scripts/XML_daily.asp?date_req=02/03/2002 ``` ## Методы ### GET /scripts/XML_daily.asp — Курсы валют на дату Английская версия — `/scripts/XML_daily_eng.asp`. Схема ответа — `ValCurs.xsd`. | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `date_req` | query | string | нет | Дата дд/мм/гггг; без параметра — последняя зарегистрированная дата | ### GET /scripts/XML_val.asp — Справочник кодов валют Полный справочник с ISO-кодами — `/scripts/XML_valFull.asp`. | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `d` | query | integer | нет | 0 — валюты с ежедневными курсами, 1 — с ежемесячными | ### GET /scripts/XML_dynamic.asp — Динамика курса валюты | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `date_req1` | query | string | да | Начало периода дд/мм/гггг | | `date_req2` | query | string | да | Конец периода | | `VAL_NM_RQ` | query | string | да | Внутренний код валюты (из XML_daily или XML_val) | ### GET /scripts/xml_metall.asp — Цены драгоценных металлов | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `date_req1` | query | string | да | Начало периода | | `date_req2` | query | string | да | Конец периода | ### GET /scripts/xml_mkr.asp — Ставки межбанковского кредитного рынка Аналогично: `xml_depo.asp` (ставки по депозитным операциям), `XML_ostat.asp` (остатки на корсчетах), `xml_swap.asp` (ставки валютного свопа), `XMLCoinsBase.asp` (цены на инвестиционные монеты). | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `date_req1` | query | string | да | Начало периода | | `date_req2` | query | string | да | Конец периода | ### GET /scripts/XML_bic.asp — Справочник БИК кредитных организаций Без параметров — полный список. | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `name` | query | string | нет | Часть названия | | `bic` | query | string | нет | БИК (9 знаков) | ### POST /DailyInfoWebServ/DailyInfo.asmx — GetCursOnDate: курсы на дату (SOAP) Возвращает таблицу `ValuteCursOnDate`: `Vname`, `Vnom`, `Vcurs`, `Vcode`, `VchCode`, `VunitRate`. | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `On_date` | body | string | да | Дата (DateTime) | ### POST /DailyInfoWebServ/DailyInfo.asmx — GetCursDynamic: динамика курса (SOAP) | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `FromDate` | body | string | да | Начало периода (DateTime) | | `ToDate` | body | string | да | Конец периода (DateTime) | | `ValutaCode` | body | string | да | Внутренний код валюты | ### POST /DailyInfoWebServ/DailyInfo.asmx — KeyRate: ключевая ставка (SOAP) | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `fromDate` | body | string | да | Начало периода (DateTime) | | `ToDate` | body | string | да | Конец периода (DateTime) | ### POST /DailyInfoWebServ/DailyInfo.asmx — MainInfoXML: основные показатели (SOAP) Без параметров. Простой XML: ключевая ставка, золотовалютные резервы, денежная база, денежная масса. ### POST /DailyInfoWebServ/DailyInfo.asmx — DragMetDynamic: учётные цены металлов (SOAP) Таблица `DrgMet`; `CodMet`: 1 — золото, 2 — серебро, 3 — платина, 4 — палладий. | Параметр | Где | Тип | Обяз. | Описание | |---|---|---|---|---| | `FromDate` | body | string | да | Начало периода (DateTime) | | `ToDate` | body | string | да | Конец периода (DateTime) | ## Нюансы - Даты в XML-скриптах — `дд/мм/гггг`. - Внутренний код валюты (`Vcode`, `VAL_NM_RQ`) может меняться при смене названия, номинала или кода валюты; для связи используйте `VcommonCode` из `EnumValutes`. - Для металлов с 01.07.2008 дата в ответе — дата действия цены, до неё — дата установления. - В SOAP-сервисе есть также `Ruonia`, `MKR`, `DepoDynamic`, `OstatDynamic`, `Bliquidity`, `mrrf` (международные резервы), `EnumValutes`, `GetLatestDateTime` и др.; простые XML без схем — `MainInfoXML`, `XVolXML`, `OmodInfoXML`, `AllDataInfoXML`. - `XML_daily.asp` с параметром `d=1` устарел. - Схемы ответов (XSD): `ValCurs.xsd`, `Valuta.xsd`, `ValCurs_dynamics.xsd`, `XML_valFull.xsd`. ## Источники - [Получение данных, используя XML](https://www.cbr.ru/development/SXML/) - [Веб-сервис DailyInfoWebServ](https://www.cbr.ru/development/DWS/) --- Если этого недостаточно — официальная документация: https://www.cbr.ru/development/SXML/ JSON: https://mcp-everything.ru/api/integrations/cbr. MCP: https://mcp-everything.ru/mcp