Gdy dodajesz API Key exchange, Freya sprawdza go przed zapisaniem — a jeśli coś jest nie tak, mówi Ci, co poprawić. Ten przewodnik pomoże Ci odczytać ten wynik i go naprawić. (Jeśli Twój klucz połączył się poprawnie, ale bot później się zatrzymał, to inny problem — zobacz Dlaczego mój bot się wstrzymał lub zatrzymał?.)
Jeśli dopiero konfigurujesz wszystko od zera, zacznij od Jak połączyć swój exchange; ten artykuł dotyczy tego, co zrobić, gdy to połączenie się nie uda.
Najważniejsze
- Gdy dodajesz klucz, Freya sprawdza, czy się łączy i ma odpowiednie uprawnienia, zanim go zapisze — jeśli coś zawiedzie, komunikat błędu wskazuje, co poprawić.
- „Invalid API Key/Secret” zwykle oznacza potknięcie przy kopiowaniu/wklejaniu lub klucz, który został wygenerowany na nowo; błędy „IP” oznaczają, że ograniczenie IP klucza nie zgadza się z tym, czego potrzebuje Freya.
- Twój klucz musi mieć uprawnienia do odczytu i tradingu (nigdy do wypłat) oraz być włączony dla właściwego rynku — spot lub futures — aby pasował do Twojego bota.
- Klucze OKX wymagają passphrase, które musi zgadzać się dokładnie; w przypadku kluczy futures Freya automatycznie przygotowuje Twoje konto, aby bot mógł handlować poprawnie.
- Ogólne „Connection Failed” to często chwilowa usterka sieci lub exchange — po prostu spróbuj ponownie.
Gdy klucz nie chce się połączyć
Dodanie klucza to nie zapis w ciemno — Freya weryfikuje, że klucz działa i ma odpowiednie uprawnienia, zanim zostanie zapisany, zaszyfrowany. Jeśli coś jest nie tak, błąd kieruje Cię prosto do przyczyny — zazwyczaj do klucza lub secretu, ograniczenia IP albo brakującego uprawnienia. Poniższe sekcje przeprowadzą Cię przez każdy błąd i sposób jego naprawienia.
„Invalid API Key” lub „Invalid Secret Key”
Najczęstszy błąd połączenia i zwykle najprostszy:
- Potknięcie przy kopiowaniu/wklejaniu — zabłąkana spacja lub brakujący znak. Skopiuj ponownie i klucz, i secret, uważnie.
- Secret jest pokazywany tylko raz. Exchange'y ujawniają Secret Key jednorazowo w momencie jego tworzenia. Jeśli go nie zapisałeś, nie możesz go odzyskać — utwórz nowy klucz.
- Klucz został usunięty lub wygenerowany na nowo na exchange, więc już się nie zgadza.
Naprawa: wprowadź ponownie klucz i secret dokładnie tak, jak są, albo utwórz świeży klucz i spróbuj ponownie.
Błędy ograniczenia IP
Freya łączy się z własnych serwerów, więc ustawienia IP klucza mają znaczenie. Istnieją dwa odrębne przypadki:
- „IP Not Whitelisted” — Twój klucz ma ograniczenie IP, ale adres serwera Freya nie znajduje się na jego liście dozwolonych. Ekran dodawania API Key pokazuje Ci adres(y) IP do dodania (z przyciskiem kopiowania) — dodaj je do białej listy klucza na exchange.
- „Unrestricted” — Twój klucz nie ma żadnego ograniczenia IP. Dla Twojego bezpieczeństwa Freya prosi Cię o włączenie ograniczenia IP i dodanie pokazywanego adresu, a następnie ponowną próbę.
W obu przypadkach naprawa opiera się na tej samej idei: ogranicz klucz do adresu IP, który Freya wyświetla w oknie.
Błędy uprawnień
Klucz się połączył, ale nie może zrobić tego, czego potrzebuje Twój bot:
- Odczyt wyłączony — włącz uprawnienie do odczytu/podglądu na kluczu.
- Brak uprawnienia do tradingu — włącz trading (spot i/lub futures, pasujący do Twojego bota).
- Niezgodność Spot vs Futures — bot futures potrzebuje klucza z włączonym tradingiem futures; bot spot potrzebuje tradingu spot. Jeśli dodałeś klucz tylko spot dla bota futures (lub odwrotnie), Freya to zasygnalizuje. Upewnij się, że włączony rynek klucza pasuje do bota, którego budujesz.
Pamiętaj: Freya zawsze potrzebuje wyłącznie uprawnień do odczytu i tradingu — nigdy do wypłat. Klucz bez uprawnienia do wypłat to dokładnie to, czego chcesz.
Pułapki specyficzne dla exchange
- OKX potrzebuje passphrase. Gdy tworzysz klucz OKX, ustawiasz passphrase — wprowadź to samo passphrase w Freya, dokładnie tak, jak je ustawiłeś. Błędne passphrase to częsta przyczyna nieudanego połączenia OKX.
- Konfiguracja OKX futures. Trading futures na OKX wymaga określonego trybu konta, który Freya konfiguruje za Ciebie automatycznie — nie musisz ustawiać go ręcznie.
- Hedge Mode (futures). Freya używa Hedge Mode dla kont futures. Jeśli masz już otwarte kolidujące pozycje One-Way, możesz zobaczyć ostrzeżenie, a nie błąd — klucz i tak się zapisuje, a Twój bot może handlować, gdy te istniejące pozycje zostaną zamknięte.
- Binance i Bybit nie używają passphrase — dla nich nie ma pola passphrase.
„Connection Failed” bez wyraźnej przyczyny
Ogólny błąd połączenia często nie jest Twoją winą — to chwilowa usterka sieci lub przejściowe obciążenie exchange. Poczekaj chwilę i spróbuj ponownie. Jeśli po kilku próbach nadal się nie udaje, sprawdź ponownie klucz/secret oraz ustawienia IP opisane powyżej.
Nadal utknąłeś? Szybka lista kontrolna
- Utwórz klucz na nowo na exchange z uprawnieniami tylko do odczytu + tradingu (nigdy do wypłat).
- Ogranicz go do adresu IP, który Freya pokazuje na ekranie dodawania API Key.
- Dopasuj rynek — klucz spot dla bota spot, klucz futures dla bota futures.
- OKX: wprowadź dokładne passphrase.
- Nadal się nie udaje? Skontaktuj się z [email protected].
Najczęściej zadawane pytania
Freya mówi „Invalid API Key”, ale jestem pewien, że skopiowałem go poprawnie — co jest nie tak?
Zwykle do klucza lub secretu wkradł się ukryty znak lub spacja, albo klucz został wygenerowany na nowo/usunięty na exchange, więc już się nie zgadza. Skopiuj ponownie oba pola uważnie i pamiętaj, że secret jest pokazywany tylko raz przy tworzeniu — jeśli go nie masz, utwórz świeży klucz.
Jaka jest różnica między „IP Not Whitelisted” a „Unrestricted”?
„IP Not Whitelisted” oznacza, że Twój klucz ma ograniczenie IP, ale adres serwera Freya nie jest jeszcze dozwolony — dodaj adres, który Freya pokazuje, do białej listy klucza. „Unrestricted” oznacza, że klucz nie ma żadnego ograniczenia IP; dla bezpieczeństwa Freya prosi Cię o włączenie ograniczenia IP i dodanie swojego adresu przed zapisaniem.
Mój klucz OKX nie chce się połączyć — czy potrzebuję passphrase?
Tak. Klucze OKX mają passphrase, które ustawiasz podczas tworzenia klucza. Musisz wprowadzić dokładnie to passphrase w Freya — błędne lub brakujące passphrase to częsta przyczyna nieudanego połączenia OKX. Binance i Bybit go nie używają.
Freya mówi, że mój klucz nie może składać zleceń — jak to naprawić?
Twój klucz nie ma włączonego tradingu dla rynku, którego używa Twój bot. Na exchange włącz uprawnienie do tradingu — trading spot dla bota spot, trading futures dla bota futures — a następnie połącz ponownie. Freya potrzebuje uprawnień do odczytu i tradingu, nigdy do wypłat.
Mój klucz futures wymaga dodatkowej konfiguracji (tryb konta / Hedge Mode) — czy to problem?
Nie. Trading futures wymaga określonego trybu konta i Hedge Mode, które Freya konfiguruje za Ciebie automatycznie. Jeśli masz istniejące pozycje One-Way, możesz zobaczyć ostrzeżenie o Hedge Mode zamiast błędu — klucz i tak się zapisuje, a Twój bot może handlować, gdy te pozycje zostaną zamknięte.
Dodałem klucz spot, ale mój bot futures nie chce go używać (lub odwrotnie) — dlaczego?
Klucz jest włączony dla określonego rynku. Bot futures potrzebuje klucza z włączonym tradingiem futures, a bot spot potrzebuje tradingu spot. Jeśli się nie zgadzają, Freya to sygnalizuje. Połącz klucz, którego włączony rynek pasuje do bota, którego tworzysz.
Połączenie po prostu „się nie udało” bez wyraźnej przyczyny — to ja czy exchange?
Często to chwilowa usterka sieci lub exchange, a nie Twoje ustawienia. Spróbuj ponownie za chwilę. Jeśli nadal się nie udaje, sprawdź ponownie klucz i secret pod kątem błędów kopiowania i potwierdź, że ograniczenie IP zgadza się z adresem, który Freya pokazuje.