Czym są limity częstotliwości API?

Ostatnia aktualizacja: 1 października 2026

Limity częstotliwości – publiczne (dane rynkowe)

Limity częstotliwości – prywatne (zarządzanie kontem)

Limity częstotliwości – handel (składanie/anulowanie zleceń)

Nasze API REST i WebSocket podlegają limitom częstotliwości, które ograniczają liczbę wywołań możliwych do wykonania w krótkim czasie. Limity częstotliwości chronią API przed atakami (np. atakami DDoS) oraz zapobiegają manipulowaniu naszymi księgami zleceń (np. przez masowe składanie i anulowanie dużych zleceń).

Limity częstotliwości API spot dzielą się na trzy sekcje (publiczna, prywatna, handel) – w zależności od używanego interfejsu API (REST lub WebSocket) oraz rodzaju wywołania (dane rynkowe, zarządzanie kontem, składanie/anulowanie zleceń). Informacje o limitach żądań dla wywołań API kontraktów futures (REST) znajdziesz w naszym artykule pomocy tutaj.

Publiczne (dane rynkowe REST)

Publiczne punkty końcowe spot podlegają limitom częstotliwości według adresu IP i pary walutowej dla wywołań Trades i OHLC, a wyłącznie według adresu IP dla wszystkich pozostałych publicznych punktów końcowych.

Wywołania publicznych punktów końcowych z częstotliwością 1 na sekundę (lub mniejszą) mieszczą się w limitach częstotliwości; przekroczenie tej częstotliwości może spowodować ich ograniczenie. Po osiągnięciu limitów częstotliwości kolejne wywołania będą blokowane przez kilka sekund (lub dłużej, jeśli wywołania będą kontynuowane podczas obowiązywania limitów).

Prywatne (zarządzanie kontem REST)

Prywatne punkty końcowe spot podlegają limitom częstotliwości według klucza API i działają na podstawie licznika, który zaczyna od 0, rośnie z każdym wywołaniem i maleje z upływem czasu. Każdy klucz API ma oddzielny licznik; jeśli licznik przekroczy wartość maksymalną, kolejne wywołania korzystające z tego klucza API zostaną ograniczone. Po osiągnięciu limitów częstotliwości kolejne wywołania będą blokowane przez kilka sekund (lub dłużej, jeśli wywołania będą kontynuowane podczas obowiązywania limitów).

Punkt końcowy API

Wzrost licznika (na żądanie)

Punkty końcowe historii konta (Ledgers, TradesHistory, ClosedOrders)

+4

Punkty końcowe stakingu (Stake, Unstake)

+1

Wszystkie pozostałe punkty końcowe (Balance, TradeBalance itd.)

+1

Punkty końcowe handlu (AddOrder, CancelOrder itd.)

0 (bez wpływu na licznik)
Szczegóły znajdziesz w limitach częstotliwości handlu

Poziom konta

Maksymalna wartość licznika

Zmniejszenie licznika (na sekundę)

Standard

20

-0,5

Wyższe limity

20

-1

Handel (REST i WebSocket – składanie/anulowanie zleceń)

Punkty końcowe handlu spot (REST AddOrder/CancelOrder i WebSocket addOrder/cancelOrder) podlegają limitom częstotliwości na poziomie konta i pary walutowej, zależnie od tego, jak zlecenia oddziałują na księgę zleceń.

W skrócie (wersja TLDR): każde konto i para walutowa mają określoną maksymalną liczbę punktów, które można wykorzystać w ciągu sekundy bez przekroczenia limitów częstotliwości handlu. Składanie, realizacja i anulowanie zleceń zużywa te punkty; z upływem czasu są one uzupełniane. Przekroczenie dozwolonej liczby punktów (zależnej od typu konta) spowoduje nałożenie limitu częstotliwości na kolejne zapytania.

Szczegółowe informacje o limitach częstotliwości handlu pozwalają traderom wyliczyć dokładną liczbę zleceń, które mogą złożyć, zrealizować lub anulować w ramach swojej strategii handlowej (wskaźnik realizacji zleceń, czas życia zlecenia w księdze zleceń itp.). Dla różnych typów kont i podstawowych strategii handlowych dostępne są przykłady, a kalkulator limitów częstotliwości ułatwia wyznaczenie limitów dla bardziej złożonych strategii.