БэкендData и ИИPython

Курс валют Банка России на Python: получаем XML и строим график

Получаем официальный курс валют Банка России на Python, правильно разбираем XML, учитываем номинал и строим график динамики без стороннего API.

Кодик

Автор

6 мин чтения

XML Банка России можно освоить на одном небольшом проекте, если сразу видеть вход, действие и результат. Банк России публикует официальные курсы в XML, поэтому учебный проект может работать без коммерческого агрегатора и API-ключа. Ниже вы соберёте работающий пример и проверите обычный и граничный сценарии.

Значение Value относится к Nominal единицам валюты и записано с запятой, поэтому прямое float без учёта номинала даёт неверный результат. Поэтому отделим настройку, входные данные, основное действие и проверку. В этой статье вы соберёте скрипт, который находит USD и CNY в ежедневном XML, считает курс за одну единицу и сохраняет данные для графика. Проверка: XML загружен по HTTPS, нужные CharCode найдены, Decimal правильно разбирает запятую, а курс делится на Nominal.

1Соберите минимум

получить XML_daily.asp с тайм-аутом. Не расширяйте проект до первого успешного запуска.

2Увидьте данные

USD и CNY существуют в документе. Проверяйте значение, а не отсутствие ошибки.

3Измените правило

После успеха добавьте выбор валюты и диапазона дат без дублирования точек. Так копирование станет практикой.

Как устроен учебный проект XML Банка России

requests загружает официальный XML, ElementTree находит элементы Valute, Decimal считает точное значение за единицу, а отдельная функция готовит точки графика. Держите ввод, логику и отображение раздельно: тогда каждый этап можно проверить отдельно.

ЭтапДействиеПроверяемый результат
Загрузкаполучить XML_daily.asp с тайм-аутомответ 200 содержит корень ValCurs
Разборнайти Valute по CharCodeUSD и CNY существуют в документе
Номиналразделить Value на Nominal через Decimalкурс относится к одной единице
Историяповторить запрос для дат и сохранить CSVточки отсортированы по дате

Контрольные точки: загрузка, разбор, номинал и история. Следующий шаг начинается после совпадения с ожидаемым результатом.

Путь данных в проекте XML Банка России
От входных данных до видимого результата. Сначала проверяется вход, затем действие и только потом интерфейс.

Зафиксируйте первый успех Распечатайте атрибут Date корневого элемента и одну запись целиком. Убедитесь, что дата ответа соответствует последней опубликованной котировке. Сохраните команду запуска и ожидаемый вывод.

Собираем рабочий пример шаг за шагом

Материал сверялся с официальной документацией 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 Банка России
Что отличает устойчивый проект от случайного запуска. Явные границы делают ошибку локальной и понятной.

Что происходит внутри и почему это работает

XML состоит из повторяющихся Valute. CharCode выбирает валюту, Value хранит котировку с десятичной запятой, Nominal сообщает количество единиц в этой котировке. Логику держите отдельно от вывода: функция получает аргумент и возвращает значение, а интерфейс показывает его. Официальный курс ЦБ не является предложением обмена банка или биржевой ценой в реальном времени. Подпишите источник и дату на графике.

ЧастьЗа что отвечаетЧто проверить
HTTPзагружает документ на выбранную датупроверены status и тайм-аут
XMLизвлекает Date, CharCode, Nominal и Valueотсутствующая валюта обработана
Decimalделит котировку на номиналконтрольный расчёт совпадает

Не превращайте сетевую ошибку в нулевой курс. Если документ недоступен или валюта отсутствует, сохраните последнее подтверждённое значение с явной датой либо покажите ошибку. Не прячьте поток в одном обработчике: сохраните вход, проверьте его, вызовите операцию и только затем обновите интерфейс.

Проверьте границу Найдите валюту с Nominal больше 1 и сравните сырое Value с результатом деления. Затем запросите выходной день и посмотрите дату публикации. Меняйте одно условие за прогон, чтобы видеть причину.

Проверяем проект и добавляем свою функцию

Соберите динамику USD за 30 дней, пропускайте повторяющиеся даты публикации и добавьте подпись Источник: Банк России. До правки запишите ожидаемое поведение одним предложением. После граничного теста повторите обычный сценарий.

Проверка своими руками
  1. Сохраните ожидаемый результат: XML загружен по HTTPS, нужные CharCode найдены, Decimal правильно разбирает запятую, а курс делится на Nominal.
  2. Измените правило: добавьте выбор валюты и диапазона дат без дублирования точек. Сначала предскажите итог.
  3. Передайте граничное значение и убедитесь, что приложение не падает.
  4. Верните корректные данные и объясните роли трёх основных частей.
Готово, если выполняются все пункты
  • ответ 200 содержит корень ValCurs
  • USD и CNY существуют в документе
  • курс относится к одной единице
  • точки отсортированы по дате

После изменения повторите основной и ошибочный сценарии, чтобы новое поведение не сломало исходный результат. Полезная правка проходит от нового ввода до видимого результата.

Четыре контрольные точки XML Банка России
Четыре проверки перед следующим шагом. Каждый следующий этап начинается после наблюдаемого результата.

Что запомнить и куда двигаться дальше

Для рабочего сервиса добавьте кеш, ограничение частоты запросов и явный час обновления. Не называйте данные реальным курсом покупки или продажи. Для закрепления откройте в графике данных через pandas, в приложении с внешним API и в небольшом проекте Python.

Как изучить тему в Кодике

Сначала разберите формат входных данных и одну функцию, затем подключайте внешний сервис или интерфейс. Сначала восстановите главную функцию и проверьте её на трёх значениях.

ШагЧто разобратьМини-проверка
1. ОсноваФункции, словари, Decimal и исключения PythonОбъясните вход и выход функции.
2. ИнструментHTTP-параметры и XML ElementTreeПовторите команду по памяти.
3. ПроектНормализацию курса по NominalПроверьте два сценария.
4. РефакторингCSV, график, кеш и подпись источникаРазделите ввод, логику и вывод.

Закрепите проект, восстановив ключевую функцию по памяти и добавив собственный граничный случай. Базовый синтаксис закрепите через курс Python.

Игнорирование Nominal

Value может относиться к 10 или 100 единицам. Делите на Nominal.

float с запятой

Строка 92,1234 не разбирается напрямую. Замените запятую и используйте Decimal.

Ноль при ошибке сети

Пользователь примет его за настоящий курс. Показывайте ошибку и дату.

Курс ЦБ назван обменным

Банк или биржа могут предлагать другую цену. Подписывайте тип данных.

Сверяйтесь с первичной документацией. Команды и ограничения примера проверены по официальной странице XML Банка России. Если версия инструмента изменилась, официальный источник важнее старого скриншота.

Что получится в итоге

Готовый результат проекта: Курс валют Банка России на Python: получаем XML и строим график
Финальный экран показывает результат, состояние операции и понятное сообщение об ошибке без раскрытия секретов.

Короткие ответы
Зачем делить Value на Nominal?

Value показывает котировку указанного количества единиц, а графику обычно нужен курс одной единицы.

Почему Decimal удобнее float?

Он точнее сохраняет десятичные значения и предсказуемо округляет финансовые данные.

Что проверять первым, если XML Банка России не запускается?

Версию среды, текущую папку, команду запуска и первую строку ошибки.

Как понять, что проект XML Банка России работает?

Проверьте основной сценарий, неверный ввод, повторный запуск и один граничный случай.

Можно ли начать с готового кода?

Да. Добейтесь результата, измените одно правило и восстановите ключевую функцию без копирования.

Сделайте один осознанный шаг дальше

Выберите одно улучшение и проведите его от ввода до результата.

Если не хватает основы, перейдите курс Python, затем восстановите ключевую функцию без подсказки.