Uprawnienia kluczy API giełdy: zasada minimalnych uprawnień

Poradnik · · Zaktualizowano

Łącząc konto na giełdzie z zewnętrzną aplikacją, zwykle nie używasz do tego hasła, a klucza API. Taki klucz ma przypisany konkretny zestaw uprawnień, który decyduje, co dana aplikacja może zrobić z Twoim kontem. Zrozumienie różnicy między uprawnieniami read-only (tylko odczyt), trade (handel) i withdraw (wypłata) to jeden z najprostszych sposobów ochrony środków, gdy testujesz boty, panele czy aplikacje do monitorowania pozycji.

Trzy poziomy uprawnień

W skrócie:

UprawnienieCo może zrobić narzędzieCzy może wyprowadzić środki?Ryzyko przy wycieku klucza
Tylko odczytwidzi pozycje, salda, historięnienajniższe
Handelotwiera, zmienia i zamyka zlecenianie, ale może zmienić twoją ekspozycjęwyższe
Wypłatawysyła środki na zewnętrzny adrestaknajwyższe

Read-only pozwala aplikacji jedynie odczytywać dane konta: otwarte pozycje, saldo, historię zleceń, wykorzystanie depozytu zabezpieczającego. Nie pozwala natomiast składać zleceń, anulować ich ani przesunąć choćby jednej monety. Dla przykładu: jeśli saldo konta wynosi 10 000 USD, a nadasz aplikacji wyłącznie uprawnienie read-only, może ona wyświetlać tę liczbę i śledzić jej zmiany w czasie, ale nie ma żadnej technicznej możliwości dotknięcia tych 10 000 USD.

Trade dodaje możliwość otwierania, modyfikowania i zamykania zleceń. Aplikacja z uprawnieniem trade mogłaby na przykład złożyć zlecenie limit o wartości 500 USD depozytu lub przesunąć stop-loss na otwartej pozycji. Wciąż nie może wypłacić środków, ale może zmieniać Twoją ekspozycję, więc poziom ryzyka jest zauważalnie wyższy niż przy read-only.

Withdraw pozwala na wypłatę środków z giełdy – na zewnętrzny portfel lub inne konto. To zdecydowanie najwyższy poziom ryzyka. W naszym przykładzie, gdyby klucz z uprawnieniem withdraw został przejęty, teoretycznie całe saldo 10 000 USD mogłoby zostać wyprowadzone, a nie tylko wykorzystane w handlu na koncie.

Dlaczego zasada minimalnych uprawnień to reguła, a nie opcja

Zasada minimalnych uprawnień (least privilege) oznacza po prostu: daj aplikacji tylko taki dostęp, jaki jest jej niezbędny do działania, i nic więcej. Monitor pozycji, który ma jedynie odczytywać otwarte transakcje i wysyłać alerty, nie ma żadnego funkcjonalnego powodu, by posiadać uprawnienia trade czy withdraw. Jeśli aplikacja nigdy nie składa zleceń i nie przesuwa środków, nadanie jej tych dodatkowych uprawnień tylko zwiększa potencjalne szkody w razie wycieku klucza, jego niewłaściwego użycia czy ewentualnego naruszenia samej usługi – nie przynosi Ci żadnej korzyści.

To trochę jak hipotetyczny przykład: nie dałbyś opiekunowi, który podlewa kwiatki, kluczy do samochodu i sejfu tylko dlatego, że jest w domu. Zakres dostępu powinien odpowiadać zakresowi zadania. Większość giełd pozwala tworzyć wiele kluczy API dla tego samego konta, każdy z własnym zestawem uprawnień i często własną listą dozwolonych adresów IP, co pozwala w pełni rozdzielić aplikacje do monitorowania, dziennika transakcji i bota handlowego.

Praktyczna lista kontrolna przed podłączeniem aplikacji

  • Sprawdź, czego aplikacja faktycznie potrzebuje – czy tylko wyświetla dane, czy składa zlecenia?
  • Utwórz dedykowany klucz API dla tej konkretnej aplikacji, zamiast używać jednego klucza wszędzie.
  • Wyłącz uprawnienie withdraw, o ile nie masz konkretnego, trwałego powodu, by je włączyć.
  • Jeśli giełda to umożliwia, ustaw whitelistę adresów IP dla klucza.
  • Regularnie przeglądaj i usuwaj nieużywane klucze, zwłaszcza po zakończeniu korzystania z danej aplikacji.
  • Klucze z uprawnieniem wypłaty chroń dodatkowo silnym zabezpieczeniem konta, w tym weryfikacją dwuetapową.

Handel z lewarem na kontraktach futures niesie wysokie ryzyko straty niezależnie od tego, jak starannie zarządzasz uprawnieniami API – higiena uprawnień chroni dostęp do konta, a nie ogranicza ryzyko rynkowe.

Jak to wygląda w praktyce

Większość aplikacji używanych na co dzień potrzebuje jedynie podglądu danych: panele, narzędzia podatkowe czy monitory pozycji zwykle należą do tej kategorii. Narzędzia, które aktywnie zarządzają zleceniami – na przykład automatycznie przesuwają stop-loss – wymagają uprawnienia trade, co jest zupełnie inną decyzją pod kątem zaufania. Uprawnienie withdraw rzadko jest potrzebne jakiejkolwiek zewnętrznej aplikacji i każdą prośbę o nie warto traktować ze szczególną ostrożnością.

BitMe działa właśnie zgodnie z tą zasadą: łączy się z Binance USD-M futures, Binance, Bybit, OKX i BloFin za pomocą klucza z uprawnieniem tylko do odczytu, monitorując pozycje i wysyłając alerty na Telegram, a opcjonalny osobny klucz z uprawnieniem do handlu, chroniony weryfikacją dwuetapową, dostępny jest tylko dla użytkowników, którzy chcą zamykać pozycje lub zmieniać TP/SL na wykresie. Więcej o działaniu uprawnień API i sprawdzeniu własnej konfiguracji znajdziesz na /exchange-api-key-safety.

Treści edukacyjne, nie doradztwo finansowe. Handel instrumentami pochodnymi z dźwignią niesie wysokie ryzyko straty.

Więcej artykułów

Zacznij teraz