Скрипт выборки российских облигаций по параметрам
Уже несколько лет я пользуюсь облигациями в качестве замены депозита, потому что процент дохода, который можно получить со вклада стабильно падает. В отличии от ситуации с депозитом, в облигациях всегда можно найти большую доходность. И в этой ситуации меня не устраивало только количество времени на механическую работу по поиску подходящих вариантов бумаг.
Работа скрипта по поиску облигаций на Московской бирже
Так как сервисов по поиску российских облигаций много, но ни один из них не имеет достаточной гибкости и простоты и поэтому на работу с ними тратится достаточно много времени. Исходя из этого и решил разработать собственный скрипт для поиска облигаций.
Сделал это на Node.js с выводом полученных результатов в локальный html файл с интерактивной таблицей от Google Charts (а в случае, если JavaScript отключен в браузере, что например происходит при открытии этого html файла из мессенджера на iPhone, то отображается статическая версия таблицы, также сгенерированная скриптом).
Существующих сервисов довольно много:
В разное время я пользовался всеми из них, причем некоторые из них были платные. Что мне не нравилось в этих сервисах — так это обилие параметров, в которых легко погрязнуть и которые не ведут к желаемому результату.
Мой желаемый результат — актуальная выборка из всех российских облигаций по следующим параметрам:
- Заданный диапазон текущей доходности.
- Заданный диапазон текущих цен.
- Заданный диапазон дюрации.
- Объем сделок за последние n дней больше порогового.
- Ответ на вопрос — есть ли налоговая льгота для корпоративных облигаций, выпущенных после 1 января 2017 года?
Конкретные цифры диапазонов могут быть любыми, например:
- 5% < Доходность < 11%
- 98% < Цена < 101%
- 4 мес. < Дюрация < 15 мес.
- Объем сделок за n дней > 15 000 шт.
А на выходе я бы хотел получать не больше 2-х десятков вариантов, которые точно попадали бы под моим критерии. Если вариантов находится больше, то лучше ужесточить свои критерии для получения меньшей по размеру выборки, которая бы точно соответствовала моим ожиданиям.
Облигации на Московской бирже доступны внутри основных режимов торгов:
- Т0: Основной режим — безадрес. (до 22.05.2020: 1443 бумаг, в июне — 131 шт.).
- Т+: Основной режим — безадрес. (до 22.05.2020: 295 бумаг, в июне — 1638 шт.).
- Т+: Основной режим (USD) — безадрес. (до 22.05.2020: 125 бумаг, в июне — 128 шт.).
Облигаций много, именно потому автоматизированное решение поиска мне кажется правильным шагом.
Я понимаю, что человек, которому необходим поиск облигации может и не разбираться в программировании, а тому, кто легко разберется в коде этого скрипта облигации могут быть неинтересны. И разбирающихся в программировании на Хабре явно больше, чем тех, кто разбирается облигациях.
Я хотел найти некий баланс — чтобы минимально подкованный человек мог воспользоваться результатами работы этого скрипта.
Ещё одно очень важное отступление — в скрипте всё напрямую зависит от работы API Московской биржи, которое имеет свои особенности.
Если говорить про поиск облигаций, то сразу после открытия торгов значения доходности по средневзвешенной цене (YIELDATWAPRICE) обнуляются.
Схема определения средневзвешенной цены (WAPRICE)
Значение YIELDATWAPRICE на мой взгляд выглядело лучше для целей поиска, но пришлось использовать YIELD, иначе сразу после открытия биржи работа скрипта была невозможна.
Ещё я использую цену предыдущего закрытия (PREVLEGALCLOSEPRICE), из-за того что по некоторым облигациям торгов может не быть несколько дней.
Схема определения цены закрытия (LEGALCLOSEPRICE)
Чтобы уменьшить количество обращений к API Московской биржи я использую значение дюрации (DURATION), а не беру готовое значение количества дней до погашения (DAYSTOREDEMPTION), ведь я пользуюсь собственным скриптом только в личных целях.
Распишу подробно все шаги которые нужны для работы моего скрипта.
Самое главное что понадобится для работы скрипта — Node.js. Это — среда выполнения JavaScript. Если раньше JavaScript можно было запустить только в браузере, но однажды разработчики расширили его, и теперь можно запускать JS на своем компьютере в качестве отдельного приложения.
Исходный код моего скрипта размещен на GitHub, и любой может свободно просматривать, проверять и может быть даже посоветует правки.
Поиск облигаций под Windows
Это будет самый подробный раздел, потому что большинство пользователей, которым это интересно, скорее всего, работают под Windows.
Для Windows доступен установщик Node.js в разделе загрузить официального сайта.
Раздел загрузки сайта проекта Node.js
Далее скачиваем установщик для Windows и запускаем его.
Выбор компонентов для установки Node.js
Кроме компонентов, находящихся на этом экране, больше ничего устанавливать не надо.
Скачиваем код скрипта с гитхаба.
Ссылка на скачивание с GitHub
После этого переходим каталог »/SilverFir-Investment-Report-master/Node.js Release/bond_search_v2/», где находятся скачанные файлы:
Каталог с необходимыми для запуска проекта файлами
И запускаем файл first start.bat, который содержит указание показать установленную текущую версию Node.js и установить необходимую для запуска проекта зависимость node-fetch:
node -v
pause
npm install node-fetch
Несмотря на такое короткое содержание Защитник Windows проявляет бдительность, но если нажать подробнее, то можно увидеть кнопку Выполнить в любом случае:
Первоначальная настройка запуска проекта
Во время выполнения bat файла
После нажатия любой клавиши зависимость будет установлена в эту же папку:
Каталог вместе с добавленными файлами
После этого всё готово для запуска скрипта поиска облигаций. Для этого запускаем файл start.bat:
Выполнение скрипты поиска облигаций. После запуска файла start.bat
Менее чем за минуту будет создан HTML файлов с текущей датой и временем в имени — он и содержит в себе найденные результаты.
Поиск облигаций под macOS
Для macOS доступен установщик Node.js в разделе загрузить официального сайта.
Сам процесс похож на установку под Windows и Linux.
Поиск облигаций под Linux
Если на вашем компьютере установлен Linux, скорее всего вы и сами знаете как лучше сделать. Код скрипта доступен на гитхабе. Перейдите в каталог »/SilverFir-Investment-Report-master/Node.js Release/bond_search_v2/».
Проверьте что Node.js установлена: $ node -v
Проверьте что пакетный менеджер npm для Node.js установлен: $ npm -v
Установите зависимости (в данном случае это только node-fetch): $ npm install
Запустите файл скрипта: $ npm start
Примерно за минуту html файл под именем файл bond_search_${new Date().toLocaleString().replace(/\:/g, '-')}.html будет создан.
Выполнение работы скрипта под Linux
Выборка облигаций
Я не сразу пришел именно к такой форме отчета, потому что я хотел чтобы этот файл отображался на любом устройстве и был удобен для просмотра. Больше всего проблем доставили айфоны — JS на них отключен и при пересылке этого отчета через любой мессенджер вместо интерактивной таблицы открывалось просто пустое место. Так что я дописал генератор обычных html таблиц.
Получились следующие виды:
На компьютере
На Android
На iPhone
Редактирование параметров выборки
Самое важное — настроить именно те параметры, которые важны именно вам, а не те, которые указал я для примера. Сделать это можно в файле index.js, со строки 39.
Задаваемые параметры поиска
Указываете нужные вам цифры, запускаете скрипт заново и примерно за минуту выборка готова.
Надеюсь что скрипт поможет экономить время и находить подходящие результаты, которые устраивают именно вас. Выборка «не является индивидуальной инвестиционной рекомендацией и может не соответствовать вашему инвестиционному профилю» — эту фразу я скопипастил, но она абсолютно верна, ведь сам скрипт это просто инструмент — решение о дальнейшей покупке конкретных найденных бумаг должен принимать уже человек после знакомства с эмитентом.
Скрипт работает только за счет API Московской биржи, которое предоставляет широкие возможности. Также хочу отметить, что я никак не связан с Московской биржей и использую ИСС Мосбиржи только в личных интересах.
Автор: Михаил Шардин,
22 июня 2020 г.
