Podłączanie bota do giełdy: uprawnienia API, nadzór i plan awaryjny

Najpierw karta połączenia, potem konfiguracja

Przed podłączeniem bota proponujemy przygotować jedną kartę połączenia: kto odpowiada za automatyzację, do jakiego konta ma ona dostęp, jakie działania dopuszczasz i kiedy należy ją zatrzymać. W tym artykule wszystkie instrukcje dotyczące uprawnień, testów oraz reagowania na problemy są naszą proponowaną procedurą redakcyjną. Nie stanowią potwierdzenia ustawień konkretnej giełdy ani gwarancji bezpieczeństwa.

Dokumentacja MaxData opisuje automatyczne zakupy i sprzedaże wyzwalane przez Pro Alerty, Listingi lub X-GPT. To opis powiązania wyzwalacza z działaniem bota, na którym opieramy strukturę proponowanej karty. Opis botów handlowych.

Zacznij od zdania: „Bot może wykonać określoną akcję na wskazanym rynku po spełnieniu zapisanych warunków”. Uzupełnij je nazwą konta, listą instrumentów, walutą rozliczenia i właścicielem konfiguracji. Osobno zapisz działania zabronione. W naszej procedurze należą do nich wypłaty oraz każde działanie poza zatwierdzonym zakresem testu.

Nie zamieszczamy instrukcji kliknięć w panelu giełdy, adresów IP ani zapewnienia o dostępności konkretnego połączenia. Przed konfiguracją wymagamy ich sprawdzenia w oficjalnej dokumentacji wybranej giełdy i operatora bota. W karcie zostaw miejsce na adres dokumentu, datę własnej weryfikacji i wynik sprawdzenia. Puste pole traktuj jako powód do odłożenia uruchomienia.

Minimalne uprawnienia i wyłączone wypłaty

Nasza proponowana checklista uprawnień zaczyna się od celu połączenia. Dla etapu obserwacji zaplanuj wyłącznie odczyt, jeżeli integracja go obsługuje. Dla etapu wykonawczego dopisz handel spot tylko wtedy, gdy jest potrzebny do zatwierdzonego zadania. Nie włączaj dodatkowych kategorii wyłącznie dlatego, że formularz pozwala je zaznaczyć.

Przy każdej dostępnej pozycji w panelu zapisz: nazwę uprawnienia, uzasadnienie, decyzję i osobę sprawdzającą. Jeżeli opis jest niejednoznaczny, zatrzymaj konfigurację i skieruj konkretne pytanie do dokumentacji lub wsparcia giełdy. Zapytaj o zakres danego przełącznika, zamiast zgadywać na podstawie jego skróconej nazwy.

Dla klucza przeznaczonego do bota przyjmujemy regułę: wypłaty pozostają wyłączone. Jeżeli integracja wymaga ich włączenia, nasza procedura przewiduje przerwanie tego wdrożenia i ponowne wyjaśnienie wymagań. Nie próbuj potwierdzać blokady przez wykonanie rzeczywistej wypłaty. Jako dowód konfiguracji zachowaj zapis ustawień bez sekretów oraz odniesienie do dokumentacji opisującej ich znaczenie.

Proponujemy osobny klucz dla każdego połączenia, jednoznaczną nazwę i wskazanego właściciela. W notatkach przechowuj identyfikator ewidencyjny, a nie sekret. Nie wklejaj sekretu do zgłoszenia pomocy, artykułu ani wspólnego dziennika testów. To nasze zasady organizacyjne; nie przypisujemy im mierzalnego poziomu ochrony.

Whitelista IP jako warunek dopuszczenia

W naszej checkliście „whitelista IP” oznacza punkt wymagający potwierdzenia dozwolonych adresów po stronie operatora oraz odpowiedniego ustawienia po stronie giełdy. Nie podajemy przykładowych adresów do skopiowania. Poproś operatora o oficjalną instrukcję dla konkretnego połączenia i sprawdź, czy opisuje również zmianę infrastruktury.

Przed zapisaniem konfiguracji odpowiedz pisemnie na cztery pytania: skąd pochodzi lista, jakiego środowiska dotyczy, kto zatwierdzi zmianę oraz jak odbędzie się test po zmianie. Nie akceptuj adresu przesłanego bez kontekstu. W proponowanym formularzu umieść pełny odnośnik do instrukcji, datę sprawdzenia i nazwę środowiska, którego dotyczy wpis.

Jeżeli operator nie dostarcza wymaganej informacji albo giełda nie udostępnia oczekiwanego ograniczenia, oznacz warunek jako niespełniony. Nasza procedura nie przewiduje obchodzenia problemu przez rozszerzenie dostępu. Dopuszcza powrót do samej obserwacji lub rezygnację z tego połączenia.

Po każdej zaplanowanej zmianie adresów zaproponuj ponowny przegląd karty połączenia. Zapisz, co zostało zmienione, według jakiego dokumentu i kto wykonał kontrolę. Nie zakładaj, że zatwierdzenie wcześniejszej konfiguracji obejmuje również następną.

Spot: zapisz dokładny zakres działania

Opis botów MaxData wskazuje rynki spot jako obsługiwany zakres handlu. Ten sam materiał opisuje wybór konkretnych tokenów oraz warianty sprzedaży wszystkich posiadanych altcoinów, z BTC lub bez BTC. Przywołujemy treść dokumentacji, bez potwierdzania dostępności konkretnej integracji. Zakres i opcje automatyzacji.

W naszej proponowanej konfiguracji początkowej wybierz jawnie wskazany instrument i zapisaną wielkość pojedynczej akcji. Nie wybieraj szerokiego zakresu sprzedaży przed osobnym przeglądem jego znaczenia. W karcie określ również, czy zatwierdzasz zakup, sprzedaż, czy oba działania. Nie zastępuj tej decyzji ogólnym zdaniem „bot może handlować”.

Dodaj własny limit łącznego zaangażowania, liczbę dopuszczonych działań w okresie testu i warunek zakończenia obserwacji. Nie proponujemy uniwersalnej kwoty ani poziomu procentowego. Wybór tych wartości pozostaw poza artykułem; tutaj chodzi o zapisanie granic zadania i sprawdzenie, czy konfiguracja je odzwierciedla.

Od alertu do kontrolowanego testu

Dokumentacja rozróżnia Alert uruchamiany przez jeden warunek i Pro Alert oparty na kilku warunkach. Opisuje też okno czasowe oraz czas uśpienia po wywołaniu Pro Alertu. Definicje i parametry alertów.

Nasz proponowany test rozpocznij od przepisania warunków własnymi słowami. Zapisz nazwę metryki, źródło danych, interwał, próg, okno spełnienia warunków i wybraną regułę ponownego uruchomienia. Dodaj horyzont obserwacji oraz miejsce na zmierzone opóźnienie. Nie wpisuj deklarowanego czasu jako wyniku pomiaru.

Najpierw sprawdź samą interpretację warunku. Następnie, jeżeli wybrane narzędzie udostępnia odpowiedni tryb, przeprowadź próbę bez rzeczywistych zleceń. Dopiero po zatwierdzeniu tej próby zaplanuj ograniczony test wykonawczy. W protokole porównuj oczekiwane działanie z potwierdzonym wynikiem, a nie tylko z otrzymaną notyfikacją.

Dokumentacja backtestów opisuje analizę historycznych wywołań Pro Alertów, historii ceny instrumentu i symulacji wyjścia przez TP, SL lub zamknięcie po czasie. Wskazuje również poślizg i prowizje jako możliwe różnice w rzeczywistej egzekucji. Opis backtestów.

W naszym arkuszu oddziel wyniki historyczne od oczekiwań dotyczących testu. Zanotuj liczbę zdarzeń, okres danych, przyjęte koszty, założenia dotyczące płynności i wielkości zlecenia. Dodaj pytanie o ryzyko dopasowania parametrów do historii. Nie przyjmuj wyniku backtestu jako kryterium potwierdzającego poprawność połączenia API.

Monitoring: jedna karta zdarzenia

Proponujemy dziennik, w którym każdy test ma osobny wpis: identyfikator, wersję konfiguracji, czas danych, czas wyzwolenia, planowaną akcję, odpowiedź giełdy i wynik ręcznego sprawdzenia. W tej konwencji „potwierdzenie” oznacza wyłącznie dowód wymagany przez twój protokół, a nie ogólne zapewnienie o poprawnym działaniu.

Ustal interwał przeglądu dziennika i osobę odpowiedzialną za reakcję. Dla opóźnienia zapisuj zarówno wartość pomiaru, jak i metodę jego uzyskania. Jeśli nie masz danych do porównania znaczników czasu, oznacz wynik jako nieustalony. Nie uzupełniaj braków szacunkiem przedstawionym jako pomiar.

Przy rozbieżności rozważ w formularzu kilka hipotez: inny zakres instrumentów, inna wersja warunków, problem z autoryzacją albo niepełne potwierdzenie wykonania. To propozycje pytań diagnostycznych, nie ustalenie przyczyny. Wniosek unieważnij, gdy późniejszy zapis przeczy jego podstawie. Zostaw miejsce na dowód oraz decyzję o dalszym teście.

Plan awaryjny i warunki restartu

Nasz proponowany plan awaryjny przygotuj przed pierwszym testem wykonawczym. Wpisz konkretne zdarzenia wymagające zatrzymania: nieuzgodnione zlecenie, niewyjaśniona zmiana konfiguracji, brak wymaganego potwierdzenia lub podejrzenie ujawnienia sekretu. Wyznacz osobę podejmującą decyzję i sposób skontaktowania się z nią.

Zaproponowana kolejność działań to: wstrzymanie nowych uruchomień, kontrola konta bezpośrednio na giełdzie, rozpatrzenie odebrania dostępu kluczowi i zabezpieczenie dziennika bez sekretów. Osobno określ sposób przeglądu otwartych zleceń. Nie traktuj odnotowania „bot zatrzymany” jako potwierdzenia zakończenia całej procedury.

Restart uzależnij od wyjaśnienia rozbieżności, sprawdzenia uprawnień, ponownego zatwierdzenia listy IP oraz powtórzenia ograniczonego testu. Zapisz osobę zatwierdzającą i zakres zgody. Jeżeli nie potrafisz odtworzyć zdarzenia, nasza procedura przewiduje pozostawienie automatyzacji wyłączonej.

Następny krok w MaxData

Help Hub przedstawia MaxData Info Bot jako asystenta odpowiadającego na pytania o MaxData i workspace. MaxData Help Hub.

Proponujemy wykorzystać tę ścieżkę do pytań o dokumentację: gdzie znaleźć instrukcję połączenia, jak potwierdzić zakres integracji i gdzie uzyskać wymagane informacje o IP. Nie przesyłaj w pytaniu sekretu klucza. Link do założenia konta poniżej jest zaproszeniem do produktu; nie oznacza zatwierdzenia twojej konfiguracji ani rekomendacji transakcji.