Specyfikacja techniczna dotycząca opracowania bota do arbitrażu spreadów i stóp fundingowych na giełdach kryptowalut

1. Ogólne informacje

• Opis: Tworzenie aplikacji internetowej (z możliwością dostosowania do urządzeń mobilnych) do automatycznego wyszukiwania i realizacji możliwości arbitrażu na podstawie spreadów cen i funding rates między różnymi giełdami kryptowalut (kontrakty futures USDT-perpetual). Bot powinien monitorować różnicę w cenach i funding rates, generować sygnały, zarządzać pozycjami oraz wysyłać powiadomienia do Telegrama. 
• Cel: Stworzyć narzędzie dla użytkowników, które pozwala zarabiać na arbitrażu bez ryzyka zmiany cen (neutralne wobec rynku), skupiając się na funding rates i spreadach.
• Technologiczny stos(zalecany):
  • Frontend: React.js (tak jak w istniejącej aplikacji).
  • Backend: Node.js lub Python (FastAPI/Django) do obsługi API giełd i logiki arbitrażu.
  • Baza danych: PostgreSQL lub MongoDB do przechowywania pozycji, historii, ustawień użytkowników.
  • Integracje: API giełd (MEXC, Gate.io, Bybit, BingX, Bitget), API bota Telegram.
  • Hosting: AWS, Heroku lub VPS dla aplikacji internetowej.
  • Bezpieczeństwo: Szyfrowanie kluczy API, uwierzytelnianie użytkowników (login/hasło + 2FA).

2. Wymagania funkcjonalne

2.1. Rejestracja i uwierzytelnianie

• Strona "Nowy użytkownik": Formularz do tworzenia nowego użytkownika z polami:
  • Adres IP (automatycznie wypełniany, ale wyświetlany jako 192.168.0.1 na przykład).
  • Login (obowiązkowe).
  • Hasło (obowiązkowe, z możliwością pokazywania/ukrywania).
  • ID Telegrama (obowiązkowe do powiadomień).
• Wsparcie dla wielu użytkowników (multi-konto).
• Uwierzytelnianie za pomocą loginu/hasła.

2.2. Integracja z giełdami

• Przycisk "Add Exchanges API Keys": Formularz do wprowadzania kluczy API dla giełd:
  • MEXC: Klucz publiczny, Klucz tajny (specjalne przetwarzanie, ponieważ nie ma API dla futures; używać cookies lub alternatywnej metody).
  • Gate.io: Klucz publiczny, Klucz tajny.
  • Bybit: Klucz publiczny, Klucz tajny.
  • BingX: Klucz publiczny, Klucz tajny.
  • Bitget: Klucz publiczny, Klucz tajny.
• Przycisk "Add MEXC Key": Oddzielny formularz do wprowadzania cookies MEXC (jeśli API jest niedostępne).
• Wsparcie dla dodatkowych giełd w przyszłości (np. OKX, Binance Futures).
• Automatyczna weryfikacja kluczy (testowe zapytanie do API).

2.3. Ustawienia powiadomień

• Przycisk "Add my own telegram bot": Pole do wpisania nazwy użytkownika Telegram (np. "father") do odbierania sygnałów.
• Przycisk "Test message": Wysyłanie testowej wiadomości do Telegrama w celu sprawdzenia.
• Checkbox "Send Notification to Telegram": Włączenie/wyłączenie powiadomień.

2.4. Ustawienia globalne

• Pole "Profit Rate": Minimalny pożądany procent spreadu (np. 0.5, 2).
• Pole "Volume in USDT Filter": Minimalny wolumen handlu w USDT do filtrowania niepłynnych monet (np. 100000).
• Sekcja "Active exchanges for signals": Checkboxy do wyboru aktywnych giełd (MEXC, Gate.io, Bybit, BingX, Bitget).
• Przycisk "Set Parameters": Zapis ustawień.

2.5. Czarna lista (Blacklist)

• Sekcja do dodawania symboli (coinów) do blacklist (np. BTC, ETH, lub mem-coiny jak 100000COQ).
• Pole "Symbol" do dodania, dropdown "Exchange" (All lub konkretna).
• Przycisk "Add", lista z przyciskami "Delete" do usuwania.
• Przycisk "Expand/Collapse" do pokazywania/ukrywania listy.
• Automatyczne wykluczenie blacklist z wyszukiwania sygnałów.

2.6. Aktywne pozycje (Active positions)

• Tabela z kolumnami: Exchange, Symbol, Side (LONG/SHORT), Amount.
• Podświetlenie "abandonded" pozycji na czerwono (pozycje bez aktywnego bota).
• Przycisk "Add to Blacklist" dla symbolu.
• Automatyczna aktualizacja (refresh) sald i PNL.

2.7. Sygnały (Signals)

• Lista sygnałów w czasie rzeczywistym:
  • Symbol (np. ALPACUSDT).
  • Spread (procent różnicy cen, np. 1.07).
  • Side (SHORT/LONG).
  • Dla każdej giełdy: Funding Rate, Price, Volume USDT.
  • Czas sygnału (np. 4s).
  • Przycisk "Copy to Form" do kopiowania do formularza tworzenia.
• Filtrowanie po aktywnych giełdach, profit rate i volume.
• Powiadomienia w Telegramie o nowych sygnałach (format: "Signal: mexc SHORT - gateio LONG: Symbol: ALPACUSDT Spread: 1.07").

2.8. Szczegółowy widok symbolu/karty (Card)

• Dla każdego symbolu osobna karta (np. RHEA, RDO, CESSUSDT).
• Pola ustawień:
  • Side: SHORT/LONG (przełącznik).
  • Open Spread: procent spreadu do otwarcia (np. 0.4, 6.3).
  • Close Spread: procent spreadu do zamknięcia (np. -0.2, 4.8).
  • Order Size: rozmiar zlecenia w USDT (np. 4000, 24000, z konwersją na $).
  • Max Orders: maksymalna liczba zleceń (np. 3, 4).
  • Allowed Size: ograniczenie rozmiaru (np. 12000/Max:88500).
  • Force Stop: checkbox, pole na $ (np. 400).
  • Is Active?: przyciski Start/Stop.
• Dane dla giełd (np. MEXC vs Gate.io):
  • Funding Rate (np. -0.0121%).
  • Next Funding (godzina).
  • Ask/Bid Price.
  • Size (w USDT).
  • Adjustment: Notify only / Adjust.
  • Max Size.
  • Price.
  • P/L (zysk/strata, np. ≈29.66 $).
  • Enter Spread (%).
  • Zlecenia (liczba).
• Wykres spreadu: Linia open/close spread, min/max, dane historyczne (czerwone/zielone linie).
• Przyciski Save dla każdego pola.
• Ogólnie: Total cards (liczba obsługiwanych symboli).

2.9. Portfele (Wallets)

• Tabela: Exchange, Wallet Balance ($), Unrealized PNL ($).
• Przycisk "Refresh balances".
• Obsługa błędów (np. "Error" dla Bybit).

2.10. Historia (History)

• Filtr po datach: From/To.
• Przycisk "Load".
• Checkbox "Show Detailed Info".
• Lista PNL według giełd: Total PNL, pozycje (np. MEXC: 182.39, Total positions: 707).
• Disclaimery.

2.11. Automatyzacja handlu

• Opcjonalnie: Automatyczne otwieranie/zamykanie pozycji na podstawie sygnałów (z potwierdzeniem lub bez).
• Monitorowanie funding rates dla arbitrażu (short na giełdzie z dodatnim rate, long na ujemnym).
• Zarządzanie ryzykiem: Force stop przy osiągnięciu straty.

3. Wymagania niefunkcjonalne

• Wydajność: Monitorowanie w czasie rzeczywistym (aktualizacja co 5-10 sek), obsługa ponad 100 symboli.
• Bezpieczeństwo: Przechowywanie kluczy zaszyfrowane, brak logowania wrażliwych danych.
• Interfejs: Responsywny design (mobilny/desktopy), podobny do zrzutów ekranu (jasny motyw, niebieskie przyciski).
• Logowanie: Historia sygnałów, pozycji, błędów.
• Testowanie: Testy jednostkowe dla API, testy integracyjne z giełdami (konta testowe).
• Dokumentacja: Podręcznik użytkownika (w języku ukraińskim/angielskim), dokumentacja API.

4. Etapy rozwoju

1. Analiza i projekt: 1 tydzień (wireframes na podstawie zrzutów ekranu).
2. Backend: 2 tygodnie (API integracji, logika arbitrażu).
3. Frontend: 2 tygodnie (UI/UX).
4. Integracja i testowanie: 1 tydzień.
5. Deployment i wsparcie: 1 tydzień.

5. Kryteria akceptacji

• Pełne dopasowanie funkcjonalności do zrzutów ekranu.
• Testowanie na danych rzeczywistych (dostarczę testowe klucze API).
• Brak błędów w powiadomieniach, obliczeniach spreadu/PNL.
• Kod na GitHub z dokumentacją.

6. Dodatkowe życzenia

• Możliwość dodawania nowych giełd bez restartu.
• Wykresy z użyciem Chart.js.
• Lokalizacja: Ukraiński/Angielski.

Skontaktuj się w celu doprecyzowania!