Zanim bot będzie mógł handlować w Twoim imieniu, Freya potrzebuje połączenia z giełdą, na której znajdują się Twoje środki — Binance, OKX lub Bybit. Nie przenosisz w tym celu swoich środków ani nie udostępniasz swojego hasła. Zamiast tego tworzysz API Key: ograniczone poświadczenie, które pozwala Freya składać zlecenia w Twoim imieniu, podczas gdy Twoje pieniądze pozostają na Twoim własnym koncie giełdowym.
Ten przewodnik wyjaśnia dokładnie, które uprawnienia nadać (a których nigdy nie nadawać), jak dodać klucz do Freya oraz co zrobić, gdy połączenie się nie zwaliduje. Jeśli chcesz poznać szerszy obraz tego, dlaczego jest to bezpieczne, przeczytaj najpierw Czy moje pieniądze są bezpieczne na Freya Finance?.
Najważniejsze
- Giełdę podłączasz za pomocą API Key — ograniczonego poświadczenia — a nie przez przenoszenie środków czy udostępnianie hasła do giełdy.
- Klucz potrzebuje uprawnień do odczytu oraz do tradingu Spot i/lub Futures. NIGDY nie może mieć uprawnienia do wypłaty.
- Klucze OKX wymagają passphrase, którą ustawiasz przy ich tworzeniu; Binance i Bybit jej nie używają.
- Dodaj klucz w Freya w sekcji Ustawienia → API Keys → Dodaj API Key, a Freya zwaliduje go natychmiast.
- Jeśli walidacja się nie powiedzie, Freya powie Ci dokładnie dlaczego — nieprawidłowy klucz, IP spoza białej listy albo brakujące uprawnienie — a każdy z tych problemów ma prostą naprawę.
Krótki przegląd kroków
- Utwórz API Key na swojej giełdzie z uprawnieniami do odczytu i tradingu, ale bez wypłaty.
- Skopiuj poświadczenia — API Key, Secret Key oraz (dla OKX) passphrase.
- Dodaj klucz do Freya w sekcji Ustawienia → API Keys → Dodaj API Key i wybierz swoją giełdę.
- Pozwól Freya go zwalidować — Freya od razu sprawdza połączenie i uprawnienia.
- Napraw każdy zgłoszony błąd — Freya powie Ci dokładnie, co jest nie tak, jeśli walidacja się nie powiedzie.
Czym jest API Key — i których uprawnień potrzebuje Freya
API Key to para poświadczeń (klucz i sekret), która pozwala jednej aplikacji komunikować się z Twoim kontem giełdowym w ograniczony sposób. To Ty decydujesz, co ten klucz może robić. Dla Freya włącz wyłącznie:
- Odczyt — aby Freya mogła widzieć Twoje salda, pozycje i status zleceń.
- Trading Spot i/lub trading Futures — aby Twój bot mógł składać potrzebne zlecenia. Włącz to, co odpowiada botom, które planujesz uruchomić.
Freya składa zlecenia; nigdy nie musi wyprowadzać pieniędzy z Twojego konta. Zawsze pozostawiaj uprawnienie do wypłaty wyłączone na kluczu, który podłączasz. To uprawnienie kontrolujesz na giełdzie — gdy jest wyłączone, ani Freya, ani ktokolwiek, kto mógłby zdobyć klucz, nie może wypłacić Twoich środków. To najważniejszy nawyk przy podłączaniu jakiejkolwiek platformy botów.
Krok 1: Utwórz API Key na swojej giełdzie
W sekcji zarządzania API swojej giełdy utwórz nowy API Key:
- Binance — utwórz klucz w API Management, włącz odczyt oraz trading Spot i/lub Futures, a wypłaty pozostaw wyłączone.
- OKX — utwórz klucz i ustaw passphrase (będzie potrzebna w Freya); włącz odczyt i trading, nie wypłaty.
- Bybit — utwórz klucz z uprawnieniami do odczytu i tradingu dla produktów, których będziesz używać, a wypłaty pozostaw wyłączone.
Jeśli Twoja giełda oferuje białą listę IP, dobrą praktyką jest ograniczenie klucza do adresów IP Freya. Jeśli to zrobisz, upewnij się, że dodasz adresy IP Freya do białej listy, w przeciwnym razie połączenie zostanie odrzucone (zobacz tabelę błędów poniżej).
Podczas tworzenia klucza giełda pokazuje Secret Key jednorazowo. Skopiuj go natychmiast i przechowuj w bezpiecznym miejscu. Jeśli go zgubisz, nie odzyskasz go — trzeba będzie usunąć klucz i utworzyć nowy.
Krok 2: Dodaj klucz do Freya
W Freya przejdź do Ustawienia → API Keys i wybierz Dodaj API Key. Następnie:
- Wybierz swoją giełdę (Binance, OKX lub Bybit).
- Wklej API Key i Secret Key. Dla OKX wprowadź także passphrase, którą ustawiłeś.
- Nadaj kluczowi nazwę, aby móc go później rozpoznać.
Możesz podłączyć więcej niż jedną giełdę, a swoimi kluczami zarządzasz lub usuwasz je z tej samej strony w dowolnym momencie.
Krok 3: Freya waliduje Twój klucz
Gdy tylko dodasz klucz, Freya sprawdza połączenie i uprawnienia — bez zgadywania. Jeśli wszystko jest poprawne, klucz zostaje zweryfikowany i gotowy do użycia. Jeśli coś jest nie tak, Freya pokazuje jasny komunikat wyjaśniający dokładnie, co naprawić.
Zrozumienie błędów walidacji
Jeśli walidacja się nie powiedzie, dopasuj komunikat pokazany przez Freya do naprawy poniżej:
| Co pokazuje Freya | Co to oznacza | Jak to naprawić |
|---|---|---|
| Nieprawidłowy API Key | Klucz został błędnie skopiowany lub usunięty na giełdzie | Skopiuj API Key ponownie dokładnie albo utwórz nowy |
| Nieprawidłowy Secret Key | Sekret nie pasuje do klucza | Skopiuj Secret Key ponownie; jeśli go zgubiłeś, utwórz nowy klucz |
| Adres IP spoza białej listy | Klucz jest ograniczony do IP, a adres Freya nie jest dozwolony | Dodaj adresy IP Freya do białej listy klucza albo usuń ograniczenie IP |
| Brak uprawnień | Klucz nie ma uprawnienia do odczytu lub tradingu | Włącz na kluczu odczyt oraz trading Spot/Futures |
| Uprawnienie do odczytu wyłączone | Freya nie może odczytać Twojego konta | Włącz na kluczu uprawnienie do odczytu/podglądu |
| Uprawnienie Spot/Futures wyłączone | Klucz nie może składać zleceń, których potrzebuje Twój bot | Włącz typ tradingu (Spot lub Futures) pasujący do Twojego bota |
| Połączenie nie powiodło się | Tymczasowy problem sieciowy lub po stronie giełdy | Odczekaj chwilę i spróbuj dodać klucz ponownie |
Freya oznaczy również klucz, który jest w trybie „Unrestricted” — czyli nie ma ograniczenia IP. Dla Twojego bezpieczeństwa Freya prosi Cię o włączenie ograniczenia IP i dodanie pokazywanego adresu, zanim klucz będzie mógł zostać zapisany. Włącz wyłącznie odczyt i trading (nigdy wypłatę) i ogranicz klucz do IP Freya. (Więcej o błędach połączenia w artykule Nie możesz podłączyć giełdy?).
Słowo o bezpieczeństwie
Połączenie jest bezpieczne z założenia, ale kilka nawyków utrzymuje ten stan:
- Wypłata zawsze wyłączona — Freya nigdy jej nie potrzebuje.
- Używaj białej listy IP, gdy Twoja giełda ją obsługuje.
- Jeden klucz, jedno przeznaczenie — i usuwaj klucze, których już nie używasz.
Pełny obraz tego, jak chronione są Twoje środki i klucze, znajdziesz w artykułach Czy moje pieniądze są bezpieczne na Freya Finance? oraz Bezpieczeństwo API giełd i ograniczanie ryzyka.
Najczęściej zadawane pytania
Których uprawnień potrzebuje Freya na moim API Key?
Odczytu (aby widzieć Twoje salda, pozycje i zlecenia) oraz tradingu Spot i/lub Futures (aby składać zlecenia Twojego bota). Włącz typ tradingu pasujący do botów, które będziesz uruchamiać. Freya nigdy nie potrzebuje uprawnienia do wypłaty, więc zawsze pozostawiaj je wyłączone.
Czy Freya potrzebuje uprawnienia do wypłaty moich środków?
Nie. Freya jedynie składa zlecenia i zarządza nimi; nie może i nie powinna być w stanie wyprowadzać środków z Twojej giełdy. Zawsze pozostawiaj uprawnienie do wypłaty wyłączone na kluczu, który podłączasz — to uprawnienie kontrolujesz na giełdzie.
Dlaczego Freya wyświetla „Adres IP spoza białej listy”?
Twój API Key jest ograniczony do konkretnych adresów IP, a adresu Freya nie ma na liście. Albo dodaj adresy IP Freya do białej listy klucza na swojej giełdzie, albo usuń ograniczenie IP z klucza. Po jego zaktualizowaniu dodaj klucz w Freya ponownie.
Dlaczego wyświetla się „Nieprawidłowy API Key” lub „Nieprawidłowy Secret Key”?
Zwykle klucz lub sekret został błędnie skopiowany albo klucz został usunięty lub wygenerowany na nowo na giełdzie. Skopiuj oba wartości ponownie, dokładnie. Ponieważ sekret jest pokazywany tylko raz podczas tworzenia klucza, jeśli już go nie masz, usuń klucz na giełdzie i utwórz nowy.
Czym jest passphrase i dlaczego OKX o nią prosi?
Klucze API OKX zawierają passphrase, którą ustawiasz samodzielnie przy tworzeniu klucza — to dodatkowe poświadczenie obok klucza i sekretu. Wprowadź tę samą passphrase w Freya przy dodawaniu klucza OKX. Binance i Bybit nie używają passphrase.
Czy mogę podłączyć więcej niż jedną giełdę?
Tak. Możesz dodać API Keys dla Binance, OKX i Bybit oraz zarządzać nimi lub je usuwać w dowolnym momencie w sekcji Ustawienia → API Keys.
Czy udostępnienie Freya mojego API Key jest bezpieczne?
Tak, gdy klucz jest poprawnie skonfigurowany — tylko odczyt i trading, bez wypłaty i z białą listą IP tam, gdzie to możliwe. Twoje środki pozostają na Twojej własnej giełdzie, a klucz, który udostępniasz, nie może ich przenieść. Pełne wyjaśnienie znajdziesz w artykule Czy moje pieniądze są bezpieczne na Freya Finance?.
Które giełdy obsługuje Freya?
Freya obecnie łączy się z Binance, OKX i Bybit (spot i futures). Z czasem mogą zostać dodane kolejne giełdy. Handlujesz na tej, którą podłączysz — Twoje środki i dostępne rynki pozostają na tej giełdzie.
Którymi monetami lub parami handlowymi mogę handlować?
Dostępne pary pochodzą z własnych listingów Twojej podłączonej giełdy, a nie z osobnej listy Freya — więc jeśli Twoja giełda notuje daną parę (np. BTC/USDT, ETH/USDT), możesz zbudować na niej bota. Większość tradingu odbywa się względem USDT jako waluty kwotowanej. Jeśli giełda wycofa parę z obrotu, przestaje ona być tam dostępna do handlu.