OKX API i WebSocket - co zmieni się 31 października 2026 i jak przygotować bota tradingowego?
Osoby korzystające z OKX wyłącznie przez stronę internetową lub aplikację mobilną mogą nawet nie zauważyć jednej z nadchodzących zmian technicznych. Inaczej wygląda sytuacja w przypadku traderów używających botów, własnych skryptów, narzędzi do analizy rynku lub automatycznych systemów zarządzania zleceniami. OKX zapowiedziało, że 31 października 2026 roku zakończy obsługę połączeń WebSocket korzystających z portu 8443. Jeśli Twoja integracja nadal korzysta z tego portu, warto sprawdzić ją przed terminem, zamiast czekać na problemy w trakcie handlu.
ZAŁÓŻ KONTO NA OKX I ODBIERZ BONUS DLA NOWYCH
To nie jest zmiana dotycząca samych kryptowalut, par handlowych czy wysokości prowizji. Chodzi o sposób, w jaki zewnętrzne aplikacje łączą się z infrastrukturą giełdy i odbierają dane w czasie rzeczywistym. Dla części użytkowników będzie to drobna korekta konfiguracji. Dla innych może oznaczać konieczność przetestowania integracji, zanim przestanie działać dotychczasowe połączenie.
Co dokładnie zmienia OKX?
WebSocket to mechanizm komunikacji, który pozwala utrzymywać otwarte połączenie między aplikacją a serwerem. Zamiast wielokrotnie wysyłać zapytania o aktualną cenę, system może otrzymywać nowe informacje przez aktywne połączenie. Takie rozwiązanie jest przydatne między innymi w botach tradingowych, panelach monitorujących rynek i aplikacjach analizujących zmiany arkusza zleceń.
OKX poinformowało o zakończeniu obsługi połączeń WebSocket na porcie 8443. Zgodnie z komunikatem giełdy połączenia przez port 443 pozostają dostępne. Zmiana nie obejmuje połączeń REST API ani połączeń colo, dlatego nie należy interpretować jej jako wyłączenia całego API OKX.
W praktyce najważniejsze pytanie brzmi: czy Twój bot lub program korzysta z adresu WebSocket zawierającego port 8443? Jeśli tak, konfiguracja wymaga sprawdzenia. Jeśli aplikacja korzysta już z portu 443, ta konkretna zmiana nie powinna wymagać takiej samej korekty.
Jak sprawdzić, czy Twój bot korzysta z portu 8443?
Nie każdy użytkownik API samodzielnie napisał swojego bota. Część korzysta z gotowych aplikacji, bibliotek programistycznych lub narzędzi udostępnianych przez zewnętrznych dostawców. Dlatego pierwszym krokiem powinno być ustalenie, w jaki sposób oprogramowanie łączy się z OKX.
Jeżeli masz dostęp do kodu źródłowego, konfiguracji albo plików środowiskowych, wyszukaj w nich ciąg 8443. Szczególną uwagę zwróć na adresy serwerów WebSocket. Jeżeli znajdziesz adres zawierający ten port, sprawdź dokumentację integracji i przygotuj zmianę zgodną z aktualnymi wytycznymi OKX.
Giełda wymienia między innymi następujące domeny produkcyjne: ws.okx.com, wseea.okx.com oraz wsus.okx.com. W środowisku demonstracyjnym wskazane są także wspap.okx.com, wseeapap.okx.com i wsuspap.okx.com. Sama domena nie wystarcza jednak do stwierdzenia, czy konfiguracja jest prawidłowa. Liczy się pełny adres połączenia, wykorzystywany port i rodzaj środowiska.
Jeśli korzystasz z gotowego bota, nie musisz od razu edytować kodu ani zmieniać ustawień na własną rękę. Najpierw sprawdź komunikaty producenta, dokumentację oraz dostępność aktualizacji. W przypadku komercyjnego oprogramowania odpowiedzialność za dostosowanie połączenia może spoczywać na jego twórcy. Warto jednak uzyskać potwierdzenie, że aktualna wersja została przygotowana na zmianę zapowiedzianą przez OKX.
Jak przygotować integrację przed 31 października?
Najbezpieczniejsze podejście polega na przeprowadzeniu kontroli z wyprzedzeniem, a następnie wykonaniu testów. Samo usunięcie numeru portu z adresu nie powinno być traktowane jako uniwersalna instrukcja dla każdego programu. Zmianę należy przeprowadzić zgodnie z aktualną dokumentacją giełdy i sposobem działania konkretnej integracji.
W pierwszej kolejności ustal, czy aplikacja korzysta z WebSocket, REST API, czy obu mechanizmów. Następnie sprawdź adresy połączeń oraz ustawienia portów. Jeżeli konfiguracja używa portu 8443, przygotuj przejście na obsługiwany port 443, zgodnie z dokumentacją właściwą dla używanego endpointu.
Po wprowadzeniu zmian przetestuj połączenie. Sprawdź, czy aplikacja może się połączyć, poprawnie uwierzytelnia użytkownika, odbiera dane rynkowe i obsługuje komunikaty o błędach. Jeśli bot wykonuje zlecenia, dodatkowo upewnij się, że jego logika nie zakłada nieprzerwanego działania starego połączenia. Przetestuj ponowne łączenie po rozłączeniu oraz zachowanie programu w przypadku chwilowego braku danych.
Dobrą praktyką jest również zapisanie aktualnej konfiguracji przed zmianą. Dzięki temu łatwiej porównać ustawienia i zdiagnozować ewentualny problem. Nie oznacza to jednak, że po terminie będzie można bezpiecznie wrócić do starego portu. Jeśli port 8443 przestanie być obsługiwany, przywrócenie poprzedniej konfiguracji nie rozwiąże problemu.
Co może się stać, jeśli zignorujesz komunikat?
Skutki zależą od sposobu, w jaki dana aplikacja korzysta z WebSocket. Jeżeli bot opiera się na połączeniu przez port 8443, po zakończeniu jego obsługi może utracić możliwość prawidłowego odbierania danych przez tę konfigurację. To z kolei może prowadzić do przerw w aktualizacji cen, utraty bieżących informacji o rynku lub błędów w działaniu strategii.
Nie oznacza to automatycznie, że każdy bot przestanie działać ani że wszystkie zlecenia użytkownika zostaną anulowane. Nie należy też zakładać, że każdy problem z API po 31 października będzie wynikał właśnie z tej zmiany. Przyczyną mogą być również błędy uwierzytelniania, limity zapytań, nieprawidłowa obsługa komunikatów lub problemy po stronie samej aplikacji.
Szczególnie ostrożni powinni być użytkownicy strategii krótkoterminowych. Jeżeli system podejmuje decyzje na podstawie danych otrzymywanych w czasie rzeczywistym, przerwa w aktualizacji może wpłynąć na sposób podejmowania decyzji. W takim przypadku warto przewidzieć mechanizm, który rozpozna utratę połączenia i ograniczy wykonywanie działań na podstawie nieaktualnych danych.
Czy trzeba zmieniać REST API?
Nie należy utożsamiać zapowiedzianego wyłączenia portu WebSocket z całkowitym wyłączeniem API OKX. Według komunikatu giełdy zmiana dotyczy połączeń WebSocket na porcie 8443, a REST API i połączenia colo nie są nią objęte.
REST API służy do wykonywania zapytań do serwera, na przykład pobierania określonych informacji lub przesyłania żądań. WebSocket jest natomiast często wykorzystywany do otrzymywania strumieni danych w czasie rzeczywistym. Jedna aplikacja może korzystać z obu rozwiązań, dlatego sprawdzenie wyłącznie jednego rodzaju połączenia może nie wystarczyć.
Jeżeli Twój program korzysta jedynie z REST API, sama zapowiedziana zmiana portu WebSocket nie powinna wymagać modyfikacji tego mechanizmu. Jeżeli jednak aplikacja używa jednocześnie REST API i WebSocket, należy sprawdzić część odpowiedzialną za połączenie WebSocket.
Jak podejść do zmiany, jeśli dopiero zaczynasz korzystać z API OKX?
Jeśli dopiero budujesz własne narzędzie, nie warto opierać konfiguracji na starych przykładach znalezionych w internecie bez sprawdzenia ich aktualności. Kod opublikowany kilka miesięcy temu może nadal działać, ale może też wykorzystywać ustawienia, które wkrótce przestaną być wspierane.
Najlepszym punktem wyjścia jest aktualna dokumentacja API OKX. Korzystaj z oficjalnych przykładów, sprawdzaj adresy środowiska produkcyjnego i demonstracyjnego oraz upewnij się, że biblioteka, której używasz, jest kompatybilna z aktualnymi ustawieniami giełdy. Nie kopiuj automatycznie adresu z przypadkowego poradnika tylko dlatego, że znajduje się w działającym przykładzie.
Pamiętaj również, że API nie eliminuje ryzyka związanego z handlem. Bot może działać technicznie poprawnie, a mimo to generować straty w wyniku błędnej strategii, poślizgu cenowego, zmienności rynku czy nieprawidłowo ustawionego zarządzania ryzykiem. Przed uruchomieniem automatycznego handlu warto przetestować system w środowisku demonstracyjnym i ustawić limity ograniczające potencjalne straty.
Podsumowanie: nie czekaj do ostatniego dnia
Wyłączenie portu WebSocket 8443 przez OKX to techniczna zmiana, która nie musi dotyczyć każdego klienta giełdy. Może być jednak istotna dla osób korzystających z botów, własnych skryptów i innych integracji pobierających dane w czasie rzeczywistym.
Najważniejsze jest sprawdzenie, czy używane oprogramowanie korzysta z tego portu, oraz przygotowanie i przetestowanie ewentualnej zmiany na port 443. REST API i połączenia colo nie są objęte tym konkretnym komunikatem, ale w aplikacjach wykorzystujących kilka metod komunikacji warto sprawdzić każdy element osobno.
Przed wdrożeniem zmian zapoznaj się z aktualnym komunikatem i dokumentacją techniczną OKX. Nie zakładaj, że każda integracja wymaga identycznej modyfikacji. W przypadku botów działających na realnym kapitale nawet pozornie drobny problem techniczny może mieć znaczenie, dlatego lepiej sprawdzić konfigurację wcześniej niż diagnozować awarię w trakcie handlu.
