ТЗ на створення Telegram бота.

## 1. Суть проекту

Створення Telegram бота для управління угодами купівлі та продажу мем-койнів на біржах Fanfan та Radium.

## 2. Торговельна платформа

- Варіанти платформ: BullX, Axiom Pro, GMGN

- Вибрана платформа: BullX Neo

## 3. Додаткові сервіси

- DEX Screener: Використовується для пошуку перспективних токенів.

- Боти для перевірки на ризик: Інтеграція з зовнішніми сервісами для оцінки ризиків.

## 4. Алгоритм відкриття позиції

### Умова 1: Пошук перспективного токена

- Платформа: DEX Screener

- Фільтри:

  - Блокчейн: Solana

  - Капіталізація: < 300K

  - Вік токена: < 720 годин

  - Обсяг на M5: > 200

- Дія: Адреса контракту (CA) знайденого токена переноситься на торгову платформу BullX Neo.

### Умова 2: Час котирувань

- Перші котирування токена повинні збігатися з початком кожної години доби.

- Час пошуку токенів: Встановлюється користувачем, наприклад, з 10:00 до 23:00 за істинним часом.

### Умова 3: Зелені кола

- Обидва зелені кола повинні бути активні.

### Умова 4: Кількість бандлів

- Кількість бандлів повинна бути < 20%.

### Умова 5: Розумні гаманці

- В токени повинні зайти розумні гаманці з 300 заданих.

### Умова 6: Поява вхідних патернів

- Точка входу №1: Графік ТФ M1, будь-яка ціна ATH (All Time High).

- Точка входу №2: (Опис відсутній, потрібне уточнення).

## 5. Функціональні вимоги

- Інтеграція з біржами: Fanfan, Radium.

- Інтеграція з торговою платформою: BullX Neo.

- Інтеграція з DEX Screener: Для пошуку токенів.

- Інтеграція з ботами для перевірки ризиків: Для оцінки ризиків.

- Управління угодами: Відкриття та закриття позицій на основі заданих умов.

- Сповіщення: Відправка сповіщень користувачу про виконання умов та відкриття/закриття позицій.

## 6. Технічні вимоги

- Мова програмування: Python (рекомендується).

- Бібліотеки: Telegram API, Web3.py, CCXT (для інтеграції з біржами).

- База даних: Для зберігання інформації про токени, угоди та налаштування користувача.

- Безпека: Захист API ключів та даних користувача.

## 7. Інтерфейс користувача

- Команди бота:

  - /start: Початок роботи з ботом.

  - /settings: Налаштування (час пошуку токенів, список розумних гаманців тощо).

  - /status: Поточний статус пошуку токенів та відкритих позицій.

  - /history: Історія угод.

  - /help: Довідка по командах.

- Сповіщення:

  - Відправка повідомлень про виконання умов.

  - Відправка повідомлень про відкриття/закриття позицій.

## 8. Тестування

- Функціональне тестування: Перевірка всіх умов та функцій бота.

- Інтеграційне тестування: Перевірка інтеграції з біржами, торговою платформою та зовнішніми сервісами.

- Навантажувальне тестування: Перевірка роботи бота при великій кількості користувачів та угод.

## 9. Документація

- Користувацька документація: Інструкції по використанню бота.

- Технічна документація: Опис архітектури, використаних технологій та API.