XML Банка России можно освоить на одном небольшом проекте, если сразу видеть вход, действие и результат. Банк России публикует официальные курсы в XML, поэтому учебный проект может работать без коммерческого агрегатора и API-ключа. Ниже вы соберёте работающий пример и проверите обычный и граничный сценарии.
Значение Value относится к Nominal единицам валюты и записано с запятой, поэтому прямое float без учёта номинала даёт неверный результат. Поэтому отделим настройку, входные данные, основное действие и проверку. В этой статье вы соберёте скрипт, который находит USD и CNY в ежедневном XML, считает курс за одну единицу и сохраняет данные для графика. Проверка: XML загружен по HTTPS, нужные CharCode найдены, Decimal правильно разбирает запятую, а курс делится на Nominal.
получить XML_daily.asp с тайм-аутом. Не расширяйте проект до первого успешного запуска.
USD и CNY существуют в документе. Проверяйте значение, а не отсутствие ошибки.
После успеха добавьте выбор валюты и диапазона дат без дублирования точек. Так копирование станет практикой.
Как устроен учебный проект XML Банка России
requests загружает официальный XML, ElementTree находит элементы Valute, Decimal считает точное значение за единицу, а отдельная функция готовит точки графика. Держите ввод, логику и отображение раздельно: тогда каждый этап можно проверить отдельно.
| Этап | Действие | Проверяемый результат |
|---|---|---|
| Загрузка | получить XML_daily.asp с тайм-аутом | ответ 200 содержит корень ValCurs |
| Разбор | найти Valute по CharCode | USD и CNY существуют в документе |
| Номинал | разделить Value на Nominal через Decimal | курс относится к одной единице |
| История | повторить запрос для дат и сохранить CSV | точки отсортированы по дате |
Контрольные точки: загрузка, разбор, номинал и история. Следующий шаг начинается после совпадения с ожидаемым результатом.

От входных данных до видимого результата. Сначала проверяется вход, затем действие и только потом интерфейс.
Собираем рабочий пример шаг за шагом
Материал сверялся с официальной документацией 2 ноября 2026 года. Создайте окружение и установите requests. Для графика добавьте matplotlib, но сначала проверьте две числовые точки в консоли. Проверьте текущую папку через pwd или Get-Location. Вставьте пример целиком, выполните один раз, затем разбирайте по частям.
from decimal import Decimal
from xml.etree import ElementTree
import requests
URL = "https://www.cbr.ru/scripts/XML_daily.asp"
def daily_rates(day: str | None = None) -> tuple[str, dict[str, Decimal]]:
params = {"date_req": day} if day else None
response = requests.get(URL, params=params, timeout=20)
response.raise_for_status()
root = ElementTree.fromstring(response.content)
rates = {}
for item in root.findall("Valute"):
code = item.findtext("CharCode")
nominal = Decimal(item.findtext("Nominal", "1"))
value = Decimal(item.findtext("Value", "0").replace(",", "."))
rates[code] = value / nominal
return root.attrib["Date"], rates
published, rates = daily_rates()
for code in ("USD", "CNY"):
print(published, code, rates[code].quantize(Decimal("0.0001")))- Вывод содержит дату публикации и курс USD и CNY за одну единицу.
- Валюта с Nominal 10 или 100 не завышает график в соответствующее число раз.
- Повторный запуск даёт тот же предсказуемый результат.
- Пустой ввод получает понятное сообщение вместо падения.
Главная функция принимает явный вход и возвращает результат, который можно проверить отдельно от интерфейса. Найдите в примере вход, проверку и место формирования результата.

Что отличает устойчивый проект от случайного запуска. Явные границы делают ошибку локальной и понятной.
Что происходит внутри и почему это работает
XML состоит из повторяющихся Valute. CharCode выбирает валюту, Value хранит котировку с десятичной запятой, Nominal сообщает количество единиц в этой котировке. Логику держите отдельно от вывода: функция получает аргумент и возвращает значение, а интерфейс показывает его. Официальный курс ЦБ не является предложением обмена банка или биржевой ценой в реальном времени. Подпишите источник и дату на графике.
| Часть | За что отвечает | Что проверить |
|---|---|---|
| HTTP | загружает документ на выбранную дату | проверены status и тайм-аут |
| XML | извлекает Date, CharCode, Nominal и Value | отсутствующая валюта обработана |
| Decimal | делит котировку на номинал | контрольный расчёт совпадает |
Не превращайте сетевую ошибку в нулевой курс. Если документ недоступен или валюта отсутствует, сохраните последнее подтверждённое значение с явной датой либо покажите ошибку. Не прячьте поток в одном обработчике: сохраните вход, проверьте его, вызовите операцию и только затем обновите интерфейс.
Проверяем проект и добавляем свою функцию
Соберите динамику USD за 30 дней, пропускайте повторяющиеся даты публикации и добавьте подпись Источник: Банк России. До правки запишите ожидаемое поведение одним предложением. После граничного теста повторите обычный сценарий.
- Сохраните ожидаемый результат: XML загружен по HTTPS, нужные CharCode найдены, Decimal правильно разбирает запятую, а курс делится на Nominal.
- Измените правило: добавьте выбор валюты и диапазона дат без дублирования точек. Сначала предскажите итог.
- Передайте граничное значение и убедитесь, что приложение не падает.
- Верните корректные данные и объясните роли трёх основных частей.
- ответ 200 содержит корень ValCurs
- USD и CNY существуют в документе
- курс относится к одной единице
- точки отсортированы по дате
После изменения повторите основной и ошибочный сценарии, чтобы новое поведение не сломало исходный результат. Полезная правка проходит от нового ввода до видимого результата.

Четыре проверки перед следующим шагом. Каждый следующий этап начинается после наблюдаемого результата.
Что запомнить и куда двигаться дальше
Для рабочего сервиса добавьте кеш, ограничение частоты запросов и явный час обновления. Не называйте данные реальным курсом покупки или продажи. Для закрепления откройте в графике данных через pandas, в приложении с внешним API и в небольшом проекте Python.
Как изучить тему в Кодике
Сначала разберите формат входных данных и одну функцию, затем подключайте внешний сервис или интерфейс. Сначала восстановите главную функцию и проверьте её на трёх значениях.
| Шаг | Что разобрать | Мини-проверка |
|---|---|---|
| 1. Основа | Функции, словари, Decimal и исключения Python | Объясните вход и выход функции. |
| 2. Инструмент | HTTP-параметры и XML ElementTree | Повторите команду по памяти. |
| 3. Проект | Нормализацию курса по Nominal | Проверьте два сценария. |
| 4. Рефакторинг | CSV, график, кеш и подпись источника | Разделите ввод, логику и вывод. |
Закрепите проект, восстановив ключевую функцию по памяти и добавив собственный граничный случай. Базовый синтаксис закрепите через курс Python.
Value может относиться к 10 или 100 единицам. Делите на Nominal.
Строка 92,1234 не разбирается напрямую. Замените запятую и используйте Decimal.
Пользователь примет его за настоящий курс. Показывайте ошибку и дату.
Банк или биржа могут предлагать другую цену. Подписывайте тип данных.
Что получится в итоге

Финальный экран показывает результат, состояние операции и понятное сообщение об ошибке без раскрытия секретов.
Зачем делить Value на Nominal?
Value показывает котировку указанного количества единиц, а графику обычно нужен курс одной единицы.
Почему Decimal удобнее float?
Он точнее сохраняет десятичные значения и предсказуемо округляет финансовые данные.
Что проверять первым, если XML Банка России не запускается?
Версию среды, текущую папку, команду запуска и первую строку ошибки.
Как понять, что проект XML Банка России работает?
Проверьте основной сценарий, неверный ввод, повторный запуск и один граничный случай.
Можно ли начать с готового кода?
Да. Добейтесь результата, измените одно правило и восстановите ключевую функцию без копирования.
Выберите одно улучшение и проведите его от ввода до результата.
Если не хватает основы, перейдите курс Python, затем восстановите ключевую функцию без подсказки.