Техническое задание на разработку бота для арбитража спредов и 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": Отдельная форма для ввода cookies MEXC (если API недоступно).
• Поддержка дополнительных бирж в будущем (например, OKX, Binance Futures).
• Автоматическая проверка ключей (тестовый запрос к API).

2.3. Настройка уведомлений

• Кнопка "Add my own telegram bot": Поле для ввода Telegram-имени (например, "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.
  • Время сигнала (например, 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 чувствительных данных.
• Интерфейс: Адаптивный дизайн (мобильный/десктоп), аналогично скриншотам (светлая тема, синие кнопки).
• Логирование: История сигналов, позиций, ошибок.
• Тестирование: Юнит-тесты для API, интеграционное тестирование с биржами (тестовые аккаунты).
• Документация: Руководство пользователя (на украинском/английском), API документация.

4. Этапы разработки

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

5. Критерии приемки

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

6. Дополнительные пожелания

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

Свяжитесь для уточнений!