Уведомления о курсе Bitcoin

автор

Приветствуем в специальной рубрике Python Проекты для новичков!

В данной статье мы будем создавать сервис уведомлений о ценах на биткоин. В ходе этого проекта, вы узнаете больше о запросах HTTP и о том, как их рассылать при помощи (как удобно) пакета requests.

Содержание:

Вы узнаете побольше о webhook, и как их использовать для подключения вашего приложения Python к внешним сервисам, таким как уведомления в телефоне или сообщения Telegram.

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

Приступим!

Уведомления о цене на биткоин при помощи Python

Как мы знаем, курс биткоина – вещь непостоянная. Нельзя с уверенностью сказать, какой курс будет к концу дня. Так что вместо того, чтобы постоянно мониторить различные ресурсы, чтобы узнать последние обновления, мы создадим приложение Python, которое будет выполнять всю работу за вас!

Для этого мы используем популярный сайт автоматизации IFTTT. IFTTT (с анг. if this, then that. Букв. Перевод – если это, значит то) – это веб сервис, который соединяет разрыв между различными приложениями и устройствами.

Мы создадим два апплета IFTTT:

  • Один для срочных уведомлений, когда курс биткоина упадет ниже определенной отметки;
  • Второй для регулярных уведомлений в Telegram о курсе биткоина.

Оба апплета будут инициированы нашим приложением Python, которое будет использовать данные из Coinmarketcap.

Апплет IFTTT состоит из двух частей: триггер и действие.

В нашем случае, триггером будет сервис webhook (далее – вебхук), предоставляемый IFTTT. Вы можете расценивать webhook как «пользовательские обратные вызовы HTTP», с которыми вы можете поближе ознакомиться в интернете.

Наше приложение Python будет создавать HTTP запрос для URL вебхука, который вызовет действие. Сейчас веселая часть – этим действием может быть практически все, что придет в голову. IFTTT предоставляет множество действий, таких как отправка email, обновление таблиц Google, даже звонок на ваш телефон.

Настройка проекта

Начнем с настройки виртуальной среды. Запустите эту команду, чтобы получить новую виртуальную среду Python 3:

Перед тем, как продолжить, вам нужно активировать виртуальную среду и установить необходимые зависимости:

Вы можете деактивировать виртуальное пространство, запустив команду оболочки deactivate.

Получаем цену на биткоин

Теперь немного грязной работы. Мы можем начать с получения последней цены на биткоин из интерфейса Coinmarketcap в консоли Python:

Для начала, нам нужно импортировать модуль requests и определить переменную bitcoin_api_url, которая содержит URL интерфейса Coinmarketcap для биткоина.

Далее, мы отсылаем запрос HTTP GET по ссылке, используя функцию requests.get() и сохраняем ответ. Так как интерфейс (API) выдает ответ в формате json, мы можем конвертировать его в объект Python, вызвав функцию .json() в ответе. Как вы видите, интерфейс выдал список с одним элементом, содержащим данные о курсе биткоина:

Результат:

Вещь, которая нас интересует больше всего – это ‘price_usd‘ — цена на биткоин в долларах США.

Отправка тестового уведомления IFTTT

Теперь мы можем перейти к части IFTTT. Чтобы использовать IFTTT, вам, в первую очередь, нужно завести новый аккаунт и установить их мобильное приложение (если вы хотите получать уведомления от вашего приложения Python именно на телефон). После того, как вы сделаете это, мы перейдем к созданию нового апплета IFTTT для тестовых нужд.

Для создания нового тестового апплета, нужно выполнить следующее:

  1. нажать на большую кнопку “this”;
  2. найти сервис “webhooks” и выбрать триггер “Receive a web request”;
  3. назовем событие test_event;
  4. теперь жмем на большую кнопку “that”;
  5. ищем сервис уведомлений “notifications” и выбираем “Send a notification from the IFTTT app” (отправить уведомление с приложения IFTTT);
  6. Меняем сообщение на «I just triggered my first IFTTT action!» ( с анг. я только что тригернул мое первое действие в IFTTT!) и жмем на “Create action”;
  7. Нажимаем на кнопку “Finish”. Это все.

Рекомендуем ознакомиться с документацией об использовании вебхуков IFTTT. Документация содержит URL вебхука, который выглядит вот так:

Далее, нам нужно заменить часть {event} любым названием, которое вы дали в третьем шаге, создавая апплет. Часть {your-IFTTT-key} уже заполнена вашим ключом IFTTT.

Теперь копируем URL вебхука и запускаем еще одну консоль Python. Мы снова импортируем модуль requests и определяем переменную URL вебхука. Теперь нам остается только запрос HTTP POST URL-у вебхука IFTTT используя функцию requests.post():

После запуска последней строки, вы должны увидеть уведомление в вашем телефоне:

Создание апплетов IFTTT

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

Апплет для срочных уведомлений о курсе биткоина:

  1. Выбираем сервис “webhooks”, после этого выбираем триггер “Receive a web request” (получить веб запрос);
  2. Называем событие bitcoin_price_emergency
  3. Для действия выбираем сервис “Notifications” и выбираем действие “Send a rich notification from the IFTTT app” (прислать подробное уведомление от приложение IFTTT);
  4. Выбираем заголовок, например «Курс биткоина, срочно!»
  5. Прописываем сообщение, например: «Курс биткоина в долларах США {{Value1}} Покупайте или продавайте сейчас!» (мы вернемся к {{Value1}} попозже);
  6. На свой вкус вы можете добавить линк URL-а страницы биткоина Coinmarketcap.
  7. Создаем действие и заканчиваем настройку апплета.

Апплет для регулярных уведомлений:

  1. Снова выбираем сервис “webhooks” и выбираем триггер “Receive a web request”;
  2. Называем событие bitcoin_price_update;
  3. Для действия выбираем сервис “Telegram” и выбираем действие “Send message”;
  4. Прописываем текст сообщение, например: «Актуальная цена на биткоин: {{Value1}}»
  5. Создаем действие и заканчиваем с апплетом.

Обратите внимание: При создании апплета вам нужно провести авторизацию бота IFTTT в Telegram.

Собираем все это вместе

Теперь, когда у нас есть IFTTT, приступим к написанию кода! Вам нужно будет начать с создания стандартного командного скелета приложения Python, показанного ниже. Используйте этот код и сохраните файл под названием bitcoin_notifications.py:

Далее, нам нужно перенести две предыдущие сессии консоли Python в две функции, которые будут выдавать последние данные о курсе биткоина и постить в вебхук IFTTT соответственно. Добавьте следующие функции над основными функциями:

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

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

Поэтому нам нужен параметр value: При настройке наших апплетов мы оставили тег {{Value1}} в поле сообщения. Это тег был заменен на текст ‘value1‘ из данных JSON. Функция requests.post() позволяет нам отправлять дополнительные данные JSON, просто добавив ключевое слово json.

Теперь мы можем перейти к ядру нашего приложения в функции main. Она будет состоять из вечного цикла while True, поскольку мы хотим, чтобы наше приложение работало всегда. В цикле мы можем вызвать интерфейс Coinmarketcap для получения последних данных о курсе биткоина и записать актуальные дату и время.

На основании нынешнего курса, мы будем решать, нужно ли отправлять срочное уведомление. Для регулярных обновлений в Telegram мы добавим нынешний курс и дату в список bitcoin_history. После того, как содержимое списка достигнет определенного количества (к примеру, 5), мы отформатируем содержимое, отправим обновление в Telegram и сбросим историю для будущих обновлений.

Фух! Как видите, в этом приложении происходит много всякого. Если вы испытываете сложности в понимании происходящего, сделайте небольшой перерыв и перечитайте предыдущий раздел еще раз, внимательно. Это не самая простая затея, так что уделите время и не переживайте из-за того, что с первого раза все выйдет не совсем гладко.

Важный момент: старайтесь не рассылать запросы слишком часто. На это есть две причины:

  • В Coinmarketcap утверждают, что они обновляют свои данные каждые 5 минут, так что нет смысла в обновлении данных о курсе на биткоин чаще этого интервала;
  • Если ваше приложение отправляет слишком много запросов Coinmarketcap, ваш IP могут отправить в бан, или временно заблокировать.

По этой причине нам нужно «пойти отдохнуть» (остановить выполнение цикла) как минимум на 5 минут, перед получением новых данных. Написанный ниже код выполняет все необходимые функции, которые только что были упомянуты:

Мы почти закончили! Единственное, чего не хватает – это функции format_bitcoin_history. Она принимает bitcoin_history в качестве аргумента и форматирует его, используя несколько базовых HTML тегов, принимаемых в Telegram, таких как <br>, <b>, <i> и т.д. Скопируйте эту функцию над главной функцией:

Результат в вашем телефоне должен выглядеть следующим образом:

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

Ву а ля! Вложившись в 50 строк кода Python, вы создали собственное приложение для уведомлений о курсе биткоина. Поздравляем! Ниже будет изложен целый код, чтобы вы могли сравнить его со своим:

Закрепляем и идем дальше

В данной статье мы создали собственное приложение, которое мониторит и уведомляет о курсе биткоина. Вы узнали, как рассылать запросы HTTP GET и POST при помощи пакета requests. Вы увидели, как легко подключить ваше приложение Python к внешним сервисам при помощи вебхуков и IFTTT.

Что же теперь? С Python и IFTTT – море по колено. Однако, существует несколько интересных предложений, которые помогут вам начать:

  • Любите таблицы? Используйте действие IFTTT, которое будет добавлять цены на биткоин в таблицы Google;
  • Вы можете улучшить условие if price < BITCOIN_PRICE_THRESHOLD для получения уведомлений только раз в день (в противном случае, это будет раздражать, если биткоин будет постоянно на низкой позиции);
  • Предпочитаете Ethereum/Litecoin/Dogecoin? Поменяйте get_latest_bitcoin_price на get_latest_cryptocurrency_price, которая выберет любую криптовалюту в качестве параметра и выдаст её курс;
  • Хотите видеть курс в другой валюте? Проверьте Coinmarketcap параметр конвертации Coinmarketcap;

Желаем удачи в работе с Python! Дайте знать, что за приложение вы лично построили при помощи Python и IFTTT в коментарях!

Вам может быть интересно

Scroll Up