Технічне завдання на розробку бота для арбітражу спредів та funding rates на криптовалютних біржах

1. Загальна інформація

• Опис: Розробка веб-додатка (з можливістю адаптації для мобільних пристроїв) для автоматизованого пошуку та виконання арбітражних можливостей на основі спредів цін та funding rates між різними криптовалютними біржами (ф'ючерсні контракти USDT-perpetual). Бот повинен моніторити різницю в цінах та funding rates, генерувати сигнали, керувати позиціями та надсилати сповіщення в Telegram. 
• Мета: Створити інструмент для користувачів, що дозволяє заробляти на арбітражі без ризику змін цін (нейтральний до ринку), фокусуючись на funding rates та спредах.
• Технологічний стек(рекомендований):
  • Frontend: React.js (як в існуючому додатку).
  • Backend: Node.js або Python (FastAPI/Django) для обробки API бірж та логіки арбітражу.
  • База даних: PostgreSQL або MongoDB для зберігання позицій, історії, налаштувань користувачів.
  • Інтеграції: API бірж (MEXC, Gate.io, Bybit, BingX, Bitget), Telegram Bot API.
  • Хостинг: AWS, Heroku або VPS для веб-додатка.
  • Безпека: Шифрування API-ключів, аутентифікація користувачів (логін/пароль + 2FA).

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

2.1. Реєстрація та аутентифікація

• Сторінка "New User": Форма для створення нового користувача з полями:
  • IP Address (автоматично заповнюється, але відображається як 192.168.0.1 в прикладі).
  • Login (обов'язкове).
  • Password (обов'язкове, з можливістю показу/приховування).
  • Telegram ID (обов'язкове для сповіщень).
• Підтримка кількох користувачів (мультиаккаунт).
• Аутентифікація за логіном/паролем.

2.2. Інтеграція з біржами

• Кнопка "Add Exchanges API Keys": Форма для введення API-ключів для бірж:
  • MEXC: Public Key, Secret Key (спеціальна обробка, оскільки немає API для ф'ючерсів; використовувати cookies або альтернативний метод).
  • Gate.io: Public Key, Secret Key.
  • Bybit: Public Key, Secret Key.
  • BingX: Public Key, Secret Key.
  • Bitget: Public Key, Secret Key.
• Кнопка "Add MEXC Key": Окрема форма для введення кукісів MEXC (якщо API недоступне).
• Підтримка додаткових бірж у майбутньому (наприклад, OKX, Binance Futures).
• Автоматична перевірка ключів (тестовий запит до API).

2.3. Налаштування сповіщень

• Кнопка "Add my own telegram bot": Поле для введення Telegram-username (наприклад, "father") для отримання сигналів.
• Кнопка "Test message": Надсилання тестового повідомлення в Telegram для перевірки.
• Чекбокс "Send Notification to Telegram": Включення/виключення сповіщень.

2.4. Глобальні налаштування

• Поле "Profit Rate": Мінімальний бажаний відсоток спреду (наприклад, 0.5, 2).
• Поле "Volume in USDT Filter": Мінімальний обсяг торгів в USDT для фільтрації неліліквідних монет (наприклад, 100000).
• Секція "Active exchanges for signals": Чекбокси для вибору активних бірж (MEXC, Gate.io, Bybit, BingX, Bitget).
• Кнопка "Set Parameters": Збереження налаштувань.

2.5. Чорний список (Blacklist)

• Секція для додавання символів (монет) до blacklist (наприклад, BTC, ETH, або мем-коїни як 100000COQ).
• Поле "Symbol" для додавання, dropdown "Exchange" (All або конкретна).
• Кнопка "Add", список з кнопками "Delete" для видалення.
• Кнопка "Expand/Collapse" для показу/приховування списку.
• Автоматичне виключення blacklist з пошуку сигналів.

2.6. Активні позиції (Active positions)

• Таблиця з колонками: Exchange, Symbol, Side (LONG/SHORT), Amount.
• Підсвічування "абандонед" позицій червоним (позиції без активного бота).
• Кнопка "Add to Blacklist" для символу.
• Автоматичне оновлення (refresh) балансів та PNL.

2.7. Сигнали (Signals)

• Список сигналів в реальному часі:
  • Символ (наприклад, ALPACUSDT).
  • Spread (відсоток різниці цін, наприклад, 1.07).
  • Side (SHORT/LONG).
  • Для кожної біржі: Funding Rate, Price, Volume USDT.
  • Signal time (час сигналу, наприклад, 4s).
  • Кнопка "Copy to Form" для копіювання в форму створення.
• Фільтрація за активними біржами, profit rate та volume.
• Сповіщення в Telegram про нові сигнали (формат: "Signal: mexc SHORT - gateio LONG: Symbol: ALPACUSDT Spread: 1.07").

2.8. Детальний вид символу/карти (Card)

• Для кожного символу окрема картка (наприклад, RHEA, RDO, CESSUSDT).
• Поля налаштувань:
  • Side: SHORT/LONG (перемикач).
  • Open Spread: Відсоток спреду для відкриття (наприклад, 0.4, 6.3).
  • Close Spread: Відсоток спреду для закриття (наприклад, -0.2, 4.8).
  • Order Size: Розмір ордера в USDT (наприклад, 4000, 24000, з конвертацією в $).
  • Max Orders: Максимальна кількість ордерів (наприклад, 3, 4).
  • Allowed Size: Обмеження розміру (наприклад, 12000/Max:88500).
  • Force Stop: Чекбокс, поле для $ (наприклад, 400).
  • Is Active?: Кнопки Start/Stop.
• Дані по біржам (наприклад, MEXC vs Gate.io):
  • Funding Rate (наприклад, -0.0121%).
  • Next Funding (час).
  • Ask/Bid Price.
  • Size (в USDT).
  • Adjustment: Notify only / Adjust.
  • Max Size.
  • Price.
  • P/L (прибуток/збиток, наприклад, ≈29.66 $).
  • Enter Spread (%).
  • Orders (кількість).
• Графік спреду: Лінія open/close spread, min/max, історичні дані (червоні/зелені лінії).
• Кнопки Save для кожного поля.
• Загальне: Total cards (кількість оброблених символів).

2.9. Гаманці (Wallets)

• Таблиця: Exchange, Wallet Balance ($), Unrealized PNL ($).
• Кнопка "Refresh balances".
• Обробка помилок (наприклад, "Error" для Bybit).

2.10. Історія (History)

• Фільтр за датами: From/To.
• Кнопка "Load".
• Чекбокс "Show Detailed Info".
• Список PNL по біржам: Total PNL, позиції (наприклад, MEXC: 182.39, Total positions: 707).
• Дисклеймер.

2.11. Автоматизація торгівлі

• Опціонально: Автоматичне відкриття/закриття позицій за сигналами (з підтвердженням або без).
• Моніторинг funding rates для арбітражу (short на біржі з позитивною rate, long на негативній).
• Ризик-менеджмент: Force stop при досягненні збитку.

3. Нефункціональні вимоги

• Продуктивність: Реал-тайм моніторинг (оновлення кожні 5-10 сек), обробка 100+ символів.
• Безпека: Зберігання ключів зашифровано, no-logging sensitive data.
• Інтерфейс: Responsive design (мобільний/десктоп), аналогічно скріншотам (світла тема, сині кнопки).
• Логування: Історія сигналів, позицій, помилок.
• Тестування: Unit-тести для API, інтеграційне тестування з біржами (тестові аккаунти).
• Документація: Посібник користувача (українською/англійською), API docs.

4. Етапи розробки

1. Аналіз та дизайн: 1 тиждень (wireframes на основі скріншотів).
2. Backend: 2 тижні (API інтеграції, логіка арбітражу).
3. Frontend: 2 тижні (UI/UX).
4. Інтеграція та тестування: 1 тиждень.
5. Деплой та підтримка: 1 тиждень.

5. Критерії приймання

• Повна відповідність функціоналу на скріншотах.
• Тестування на реальних даних (надам тестові API-ключі).
• Відсутність багів в сповіщеннях, розрахунках спреду/PNL.
• Код на GitHub з документацією.

6. Додаткові побажання

• Можливість додавання нових бірж без перезапуску.
• Графіки з використанням Chart.js.
• Локалізація: Українська/Англійська.

Зв'яжіться для уточнень!