Необходимо создать приложение, которое будет проверять появление новых сделок на…
- User
Необходимо создать приложение, которое будет проверять появление новых сделок на брокерским счёте каждую минуту, используя API Тинькофф инвестиций. При обнаружении новой сделки должна проигрываться мелодия. Прошу писать очень подробно, по шагам, так как у меня нет навыков программирования.
- Assistant
Создание приложения для проверки новых сделок на брокерском счёте Тинькофф Инвестиции с проигрыванием мелодии при обнаружении новой сделки
Давайте по шагам рассмотрим, как вы можете создать такое приложение, даже если у вас нет опыта в программировании. Мы будем использовать готовые инструменты и максимально детально объяснять каждый шаг.
Шаг 1: Установка Python на ваш компьютер
Python – это язык программирования, который мы будем использовать для создания нашего приложения. Вам нужно установить Python на ваш компьютер.
-
Скачайте Python:
- Перейдите на официальный сайт Python: https://www.python.org/downloads/
- На странице вы увидите кнопку "Download Python 3.x.x" (где 3.x.x – это последняя версия Python). Нажмите на эту кнопку, чтобы скачать установщик.
-
Установите Python:
- После скачивания файла запустите установщик (файл с расширением
.exeна Windows). - В первом окне установщика ОБЯЗАТЕЛЬНО поставьте галочку "Add Python 3.x to PATH" (это важно для последующей работы).
- Нажмите "Install Now" и дождитесь завершения установки.
- После скачивания файла запустите установщик (файл с расширением
Шаг 2: Получение API-токена Тинькофф Инвестиций
Для доступа к вашему брокерскому счёту через API Тинькофф Инвестиций вам нужно получить API-токен.
-
Авторизуйтесь в Тинькофф Инвестициях:
- Перейдите на сайт https://www.tinkoff.ru/invest/ и войдите в свой аккаунт.
-
Получите токен через кабинет разработчика:
- Откройте раздел для разработчиков по ссылке: https://tinkoff.github.io/investAPI/
- На странице найдите раздел про получение токена и следуйте инструкциям.
- Обычно для получения токена нужно перейти по ссылке https://www.tinkoff.ru/invest/settings/, найти там раздел "Open API" или "API Токены" и сгенерировать новый токен.
- Сохраните полученный токен в надёжном месте. Важно: Никому не передавайте этот токен, так как он даёт доступ к вашему счёту.
Шаг 3: Установка среды разработки (PyCharm)
PyCharm – это удобная программа для написания и запуска Python-скриптов. Мы будем использовать бесплатную версию PyCharm Community Edition.
-
Скачайте PyCharm:
- Перейдите на сайт https://www.jetbrains.com/pycharm/download/
- В разделе "Community" нажмите "Download".
-
Установите PyCharm:
- Запустите скачанный установщик.
- Следуйте инструкциям установщика, оставляя настройки по умолчанию.
- После установки запустите PyCharm.
Шаг 4: Создание нового проекта в PyCharm
- Создайте новый проект:
- При первом запуске PyCharm вы можете увидеть окно приветствия. Нажмите "Create New Project".
- Выберите место для проекта на вашем компьютере (например, папка "TinkoffChecker" на рабочем столе).
- Оставьте остальные настройки по умолчанию и нажмите "Create".
Шаг 5: Установка необходимых библиотек
Нам понадобятся дополнительные библиотеки для работы с API и воспроизведения звука.
-
Откройте терминал в PyCharm:
- Внизу окна PyCharm есть вкладка "Terminal". Если её нет, вы можете открыть её через меню "View" -> "Tool Windows" -> "Terminal".
-
Установите библиотеку для работы с API Тинькофф Инвестиций:
- В терминале введите команду и нажмите Enter:
pip install tinkoff-investments
- В терминале введите команду и нажмите Enter:
-
Установите библиотеку для воспроизведения звука:
- Для Windows:
- Библиотека
winsoundуже встроена в Python, ничего устанавливать не нужно.
- Библиотека
- Для macOS/Linux:
- Введите команду:
pip install playsound
- Введите команду:
- Для Windows:
Шаг 6: Создание Python-скрипта
-
Создайте новый файл:
- В левом окне PyCharm (панель "Project") щёлкните правой кнопкой мыши на папку вашего проекта.
- Выберите "New" -> "Python File".
- Назовите файл, например,
check_deals.py, и нажмите "Enter".
-
Добавьте код в файл:
Скопируйте и вставьте следующий код в ваш файл
check_deals.py:import time from tinkoff.invest import Client, RequestError import datetime # На Windows импортируем winsound для воспроизведения звука import winsound # Для macOS/Linux # from playsound import playsound TOKEN = "ВАШ_API_ТОКЕН" def play_sound(): # На Windows воспроизводим звуковой сигнал winsound.Beep(1000, 500) # Или проигрываем звуковой файл (разместите свой файл "alert.wav" в папке проекта) # winsound.PlaySound("alert.wav", winsound.SND_FILENAME) # На macOS/Linux воспроизводим звуковой файл # playsound('alert.mp3') def main(): last_operation_time = None with Client(TOKEN) as client: while True: try: # Получаем список операций за последние сутки operations = client.operations.get_operations( account_id=client.users.get_accounts().accounts[0].id, from_=datetime.datetime.now() - datetime.timedelta(days=1), to=datetime.datetime.now(), ).operations if operations: # Находим самую последнюю операцию latest_operation = max(operations, key=lambda x: x.date) if last_operation_time is None or latest_operation.date > last_operation_time: last_operation_time = latest_operation.date print("Обнаружена новая сделка!") play_sound() else: print("Новых сделок нет.") else: print("Сделок не обнаружено.") # Ожидаем 60 секунд перед следующей проверкой time.sleep(60) except RequestError as e: print(f"Ошибка при запросе: {e}") time.sleep(60) except Exception as e: print(f"Неизвестная ошибка: {e}") time.sleep(60) if __name__ == "__main__": main() -
Вставьте ваш API-токен:
- В коде найдите строку
TOKEN = "ВАШ_API_ТОКЕН"и заменитеВАШ_API_ТОКЕНна реальный токен, который вы получили ранее. - Например:
TOKEN = "your_actual_token_here"
- В коде найдите строку
-
Сохраните файл:
- Нажмите Ctrl+S (или Cmd+S на macOS), чтобы сохранить изменения.
Шаг 7: Запуск скрипта
-
Запустите скрипт:
- В верхнем меню PyCharm нажмите "Run" -> "Run...".
- В появившемся окне выберите
check_deals(или как вы назвали свой файл). - Скрипт начнёт работу, и вы увидите вывод в консоли внизу окна PyCharm.
-
Проверьте работу скрипта:
- Скрипт будет выводить сообщения о статусе проверки каждые 60 секунд.
- При обнаружении новой сделки вы увидите сообщение "Обнаружена новая сделка!" и услышите звуковой сигнал или мелодию.
Дополнительные настройки и информация
-
Воспроизведение мелодии:
- На Windows:
- По умолчанию используется функция
winsound.Beep(), которая воспроизводит простой звуковой сигнал. - Если вы хотите проигрывать собственный звуковой файл (например,
alert.wav), разместите его в папке проекта и используйте:winsound.PlaySound("alert.wav", winsound.SND_FILENAME)
- По умолчанию используется функция
- На macOS/Linux:
- Используйте библиотеку
playsoundи воспроизводите файл:from playsound import playsound playsound('alert.mp3') - Убедитесь, что звуковой файл (
alert.mp3) находится в папке проекта.
- Используйте библиотеку
- На Windows:
-
Изменение интервала проверки:
- Интервал проверки установлен на 60 секунд:
time.sleep(60) - Если вы хотите изменить интервал, замените
60на другое количество секунд.
- Интервал проверки установлен на 60 секунд:
-
Обработка ошибок:
- В коде предусмотрена обработка возможных ошибок при запросе к API.
- В случае ошибки скрипт подождёт 60 секунд и продолжит работу.
Шаг 8: Автозапуск скрипта при включении компьютера (опционально)
Если вы хотите, чтобы скрипт запускался автоматически при включении компьютера:
Для Windows:
-
Создайте ярлык для запуска скрипта:
- В проводнике перейдите в папку с вашим проектом (где расположен файл
check_deals.py). - Создайте текстовый файл, назовите его
start_script.bat. - Откройте его в блокноте и вставьте следующую строку:
python путь_к_вашему_скрипту\check_deals.py- Замените
путь_к_вашему_скриптуна полный путь к вашему файлуcheck_deals.py. - Например:
python C:\Users\ВашеИмя\Desktop\TinkoffChecker\check_deals.py
- Замените
- В проводнике перейдите в папку с вашим проектом (где расположен файл
-
Добавьте ярлык в автозагрузку:
- Нажмите Win + R, введите
shell:startupи нажмите Enter. - Откроется папка автозагрузки.
- Скопируйте ваш файл
start_script.batв эту папку.
- Нажмите Win + R, введите
Для macOS:
-
Создайте скрипт для запуска:
- Откройте приложение "Automator".
- Создайте новый документ типа "Application".
- В поиске действий слева введите "Run Shell Script" и перетащите этот элемент в правое окно.
- В поле скрипта введите:
python3 путь_к_вашему_скрипту/check_deals.py- Замените
путь_к_вашему_скриптуна полный путь к вашему файлуcheck_deals.py.
- Замените
- Сохраните приложение, например, как
StartCheckDeals.app.
-
Добавьте в элементы входа:
- Откройте "Системные настройки" -> "Пользователи и группы".
- Выберите свой учётный запись и перейдите во вкладку "Объекты входа".
- Нажмите "+" и добавьте ваше приложение
StartCheckDeals.app.
Поздравляем!
Теперь у вас есть приложение, которое каждые 60 секунд проверяет наличие новых сделок на вашем брокерском счёте в Тинькофф Инвестициях и воспроизводит мелодию при обнаружении новой сделки.
Если возникли трудности или вопросы:
-
Ошибки при запуске скрипта:
- Убедитесь, что вы правильно вставили ваш API-токен.
- Проверьте установку необходимых библиотек.
-
Вопросы по настройке среды:
- Если вы испытываете сложности с PyCharm, вы можете использовать любую другую среду или даже запускать скрипт напрямую из терминала/командной строки:
- Откройте терминал/командную строку.
- Перейдите в папку с вашим скриптом:
cd путь_к_вашей_папке - Запустите скрипт:
python check_deals.py
- Если вы испытываете сложности с PyCharm, вы можете использовать любую другую среду или даже запускать скрипт напрямую из терминала/командной строки:
-
Дополнительная информация по API Тинькофф Инвестиций:
- Ознакомьтесь с официальной документацией: https://tinkoff.github.io/investAPI/
Желаем успехов! Если у вас возникнут дополнительные вопросы или понадобятся уточнения, не стесняйтесь обращаться за помощью.
-