File README.md of Package fint-bot

# investRobot

I-FINT - это робот для алгоритмической торговли на бирже [Тинькофф Инвестиций](https://www.tinkoff.ru/invest/)
посредством [Tinkoff Invest API](https://github.com/Tinkoff/investAPI).

## Функциональные возможности

* Автоматическая торговля любыми ценными бумагами
* Реализация собственного торгового алгоритма
* Выставление и отмена как рыночных, так и лимитных торговых поручений
* Ведение статистики, выдача краткого результата
* Логирование всех операций, возможность установки уровня логирования
* Подключение визуализации


## Запуск робота

1. Установите зависимости `python3.10 -m pip install -r requirements.txt`;
2. Получите токен и сохраните его и ID аккаунта в переменные окружения TINKOFF_TOKEN и TINKOFF_ACCOUNT соответственно;
3. Запустите файл [main.py](main.py) `python3.10 main.py`.

## Торговая стратегия

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

# 🚀 Торговый робот Tinkoff Invest API

**Профессиональная система алгоритмической торговли для Московской биржи**  
*С расширенной системой безопасности и аналитикой*

[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Tinkoff API](https://img.shields.io/badge/Tinkoff-API-orange.svg)](https://tinkoff.github.io/investAPI/)

## 📋 Содержание

- [🌟 Особенности](#-особенности)
- [⚡ Быстрый старт](#-быстрый-старт)
- [🏗️ Архитектура](#-архитектура)
- [🔧 Установка](#-установка)
- [⚙️ Настройка](#️-настройка)
- [🚀 Запуск](#-запуск)
- [📊 Стратегии](#-стратегии)
- [🛡️ Безопасность](#️-безопасность)
- [📈 Визуализация](#-визуализация)
- [📊 Статистика](#-статистика)
- [🔄 Бэктестирование](#-бэктестирование)
- [🧩 Модули](#-модули)
- [❓ FAQ](#-faq)
- [⚠️ Важные предупреждения](#️-важные-предупреждения)
- [📄 Лицензия](#-лицензия)

## 🌟 Особенности

### 🛡️ **Безопасность**
- Многоуровневая проверка безопасности перед запуском
- Разделение токенов песочницы и реальной торговли
- Интерактивное подтверждение для реальных сделок
- Валидация всех конфигурационных параметров

### 📊 **Аналитика**
- Встроенный бэктестинг с обучением и тестированием
- Подробная статистика по сделкам
- Графическая визуализация торговли
- Автоматическое сохранение отчетов

### ⚡ **Производительность**
- Асинхронная работа с Tinkoff Invest API
- Оптимизированные алгоритмы анализа
- Поддержка нескольких бэкендов визуализации
- Эффективное управление памятью

### 🔧 **Гибкость**
- Модульная архитектура
- Настраиваемые торговые стратегии
- Гибкая система конфигурации
- Поддержка SUSE Tumbleweed и других Linux

## ⚡ Быстрый старт

### 1. Клонирование репозитория
```bash
git clone https://github.com/yourusername/trading-robot.git
cd trading-robot