Często zadawane pytania dotyczące interfejsu API

Ostatnia aktualizacja: 13 stycznia 2025 r.

Dokumentacja API丨Przykłady i biblioteki open source interfejsu API 

Jakie są limity?

Przegląd

Istnieją trzy różne rodzaje limitów, z których wszystkie mogą ulec zmianie w dowolnym momencie:

1. Twarde limity
2. Limity Uczenia Maszynowego
3. Limity Firewalla Aplikacji Sieciowych

Twarde limity

• 6000 jednostek wagi żądań na minutę (należy pamiętać, że nie jest to koniecznie to samo co 6000 żądań)
• 100 zleceń na 10 sekund
• 200 000 zleceń w ciągu 24 godzin

Nasze twarde limity są wymienione w punkcie końcowym [/api/v3/exchangeInfo].

Limity uczenia maszynowego

Zachowanie handlowe jest porównywane z przeciętnym użytkownikiem. Jeśli odbiegniesz zbyt daleko od normy, zostaniesz zbanowany(-a) na określony czas, od 5 minut do 3 dni.

Załóżmy, że twój wynik jest określony jako "nadużycie handlowe". Twój wynik wzrośnie, jeśli: 

• Wielokrotnie „przebijesz” lub „wyprzedzisz” najlepszą ofertę zakupu/sprzedaży w księdze zleceń.
• Spamujesz, bardzo szybko tworząc i anulując zlecenia bez realizacji transakcji.
• Twój „wskaźnik konwersji” jest niski. „Wskaźnik konwersji” definiuje się jako liczbę transakcji użytkownika podzieloną przez całkowitą liczbę utworzonych i anulowanych zleceń w ciągu 24 godzin (liczba transakcji / (zlecenia + anulacje)).
• Twoja „waga” jest niska. „Waga” jest zdefiniowana jako całkowita handlowana ilość podzielona przez całkowitą liczbę utworzonych i anulowanych zleceń w ciągu 24 godzin (całkowita handlowana ilość / (zlecenia + anulowania)).
• Kiedy handlujesz parami, które zawierają BNB jako aktywo bazowe lub kwotowe, Twój wskaźnik nadużycia zostanie zwiększony.

Dokładniejsze informacje niż powyższe nie zostaną przekazane. Użyj metody prób i błędów, aby osiągnąć swój idealny model handlu, lub przedyskutuj optymalne działania z innymi użytkownikami API.

Limity firewalla aplikacji sieciowych

Chociaż nie podajemy dokładnych szczegółów dotyczących naszych zasad WAF, jeśli widzisz błąd HTTP 403, to znaczy, że złamano jakąś zasadę. Najprawdopodobniej będzie to wynik nadmiernej ilości żądań w ciągu 5 minut. Jeśli jednak wysyłasz żądanie, które może być postrzegane jako złośliwe, może to również skutkować banem na dłuższy czas.

Czy zostanę ograniczony(-a) przez konto, klucz API lub adres IP, jeśli przekroczę limity?

W przypadku sztywnych limitów przekroczenie całkowitego limitu wagi żądań na minutę (obecnie 6000) spowoduje zablokowanie adresu IP. Limity zleceń (obecnie jest to 10 razy / 10 sekund i 200 000 razy / 24 godziny) będą zależne od konta. Jeśli limit zleceń został przekroczony, nastąpi również zablokowanie tworzenia nowych zleceń na stronie internetowej (lub w naszych aplikacjach).

W przypadku limitów uczenia maszynowego ograniczenia zostaną zastosowane do kont. Jeśli zostałeś(-aś) ograniczony(-a) przez system ML, możesz sprawdzić przyczynę i czas trwania za pomocą punktu końcowego [/sapi/v1/account/status] (odnotowanego w naszej dokumentacji API).

Limity Firewalla Aplikacji Sieciowych będą stosowane tylko przez IP. Zwykle czas trwania bana WAF wynosi 5 minut. Jeśli jednak serwer zinterpretował żądanie użytkownika jako złośliwe, ban może zostać przedłużony.

Zostałem(-am) ograniczony(-a) za przekroczenie limitów, ale naprawiłem(-am) swój kod. Czy odblokujecie mnie wcześniej?

Nie. Musisz poczekać, aż blokada się skończy.

Dlaczego otrzymuję błąd HTTP 403 podczas korzystania z interfejsu API?

Naruszyłeś zasady WAF (Firewall Aplikacji Sieciowych), najprawdopodobniej naruszając limit przepustowości lub wysyłając złośliwe żądanie (jak opisano w sekcji dotyczącej limitów). Na ogół takie blokady trwają 5 minut.

Dlaczego moje połączenia WebSocket są przerywane/rozłączane?

Aktywne połączenia WebSocket będą otrzymywać ping co 3 minuty. Jeśli nie odpowiesz prawidłowo sformułowanym pingiem, Twoje połączenie zostanie przerwane.

W przypadku udostępniania danych użytkownika, jeśli informacja o utrzymaniu aktywności nie zostanie odebrana co najmniej raz na 60 minut, klucz nasłuchu wygaśnie. Jest to również szczegółowo opisane w naszej dokumentacji API.

Używam usługi/wrappera innej firmy i nie działa. Czy możecie pomóc?

Niestety nie obsługujemy usług ani narzędzi innych firm. Aby uzyskać dodatkową pomoc, skontaktuj się z obsługą i/lub deweloperami.

Dodatkowo, wprowadzenie klucza(ów) API Binance i/lub tajnego(ych) klucza(ów) do jakiejkolwiek platformy strony trzeciej jest zagrożeniem dla bezpieczeństwa. Korzystaj z tych usług wedle własnego uznania.

Pamiętaj, że unikamy również udzielania ogólnej pomocy programistycznej.

Mimo że nie wprowadziłem żadnych zmian, to nagle pojawiają się błędy. Co się stało?

Niestety, nie jesteśmy w stanie zapewnić wsparcia technicznego w przypadku problemów z implementacją. Jeśli używasz wrappera/narzędzia innej firmy, skontaktuj się z ich zespołem wsparcia/deweloperskim.

Potrzebuję uzyskać dostęp do mojego Tajnego Klucza, ale wyświetla się "***". Jak mogę go uzyskać? 

Ze względów bezpieczeństwa tajne klucze są widoczne z założenia tylko w momencie tworzenia klucza API. W dowolnym późniejszym momencie klucz zostanie ukryty. Jeśli go zgubiłeś(-aś) lub nie zapisałeś(-aś), będzie trzeba utworzyć nowy klucz API i użyć nowego klucza wraz z nowym tajnym kluczem.

Czy mogę zwiększyć swoje limity lub dedykowany strumień/przepustowość?

Niestety obecnie nie jest to oferowane. Praca z podanymi ograniczeniami powinna być możliwa.

Mój klucz API zniknął.

Istnieją tylko dwa prawdopodobne wyjaśnienia „zniknięcia” klucza API:

• Jeśli nie byłeś(-aś) ostatnio aktywny(-a), a korzystałeś(-aś) z API przed 7 marca 2018 r., możliwe, że Twoje klucze API zostały usunięte, aby zapewnić bezpieczeństwo Twojego konta.
• Jeśli wyłączyłeś(-aś) swoje konto, spowoduje to usunięcie wszystkich aktywnych kluczy API.

Powinieneś móc utworzyć nowy klucz(e) API bez żadnych problemów.

Otrzymuję błąd "Error -1021 (Message: Timestamp for this request is outside of the recvWindow)". Jak mogę go rozwiązać?

Zazwyczaj ten błąd występuje tylko wtedy, gdy godzina na serwerze i godzina w Twoim systemie nie są zsynchronizowane. Konieczne może być zsynchronizowanie zegara systemowego. Proces ten różni się jednak w zależności od systemu operacyjnego.

W przypadku systemu Windows możesz, według własnego uznania, użyć narzędzia takiego jak "Atomic Clock". Użytkownicy systemów Linux i Mac mogą spróbować synchronizacji za pomocą programu "ntpdate" w wierszu poleceń.

Jeśli problem będzie się powtarzał, może być związany z opóźnieniami (problem z siecią). Spróbuj dostosować recvWindow.

Czy mogę prosić o nowe funkcjonalności API?

Jeśli nie widzisz danej funkcjonalności w naszej dokumentacji, powinieneś(-naś) założyć, że jej nie zapewniamy. Jeśli chcesz zasugerować funkcję, możesz otworzyć zgłoszenie do pomocy technicznej, a zostanie ona sprawdzona.

Wydaje mi się, że jest problem z API. Jak mam to zgłosić?

Jeśli uważasz, że wystąpił problem z systemem, a nie z implementacją, przekaż dowody na poparcie swojego roszczenia, kontaktując się z nami na forum deweloperów, a my zbadamy sprawę. Uwaga: niejasne wiadomości nie są traktowane jako uzasadnione reklamacje.