Nejčastější dotazy ohledně API

Poslední aktualizace: 13. ledna 2025

Dokumentace API丨Open source knihovny a příklady API 

Jaké jsou limity?

Přehled

Jsou zavedeny tři různé druhy limitů, které se mohou kdykoliv změnit:

1. Pevné limity
2. Limity pro strojové učení
3. Limity pro WAF (firewall webových aplikací)

Pevné limity

• Váha požadavků ve výši 6 000 za minutu (upozorňujeme, že tato hodnota neznamená nutně totéž jako 6 000 požadavků)
• 100 příkazů za 10 sekund
• 200 000 příkazů za 24 hodin

Naše tvrdé limity jsou k dispozici na koncovém bodě [/api/v3/exchangeInfo].

Limity pro strojové učení

Obchodní chování se porovnává s průměrným uživatelem. Pokud se od něj příliš odchýlíte, dostanete zákaz na stanovenou dobu, která se pohybuje od 5 minut do 3 dnů.

Předpokládejme, že se vám přiděluje skóre za nedovolené chování. Takové skóre se zvyšuje, když: 

• Opakovaně zadáváte příkazy tak, aby byly nepatrně výhodnější než nejlepší nabídka/poptávka v knize objednávek (provádíte tzv. „one-up“ či „front-run“);
• Velmi rychle vytváříte a rušíte řadu příkazů, aniž byste obchody provedli.
• Vykazujete nízkou „míru konverze“. „Míra konverze“ je definována jako počet vašich obchodů dělený součtem vytvořených a zrušených příkazů za 24 hodin (počet obchodů / (vytvořené příkazy + zrušené příkazy)).
• Vykazujete nízkou „váhu“. Váha je definována jako celkové zobchodované množství dělené součtem vytvořených a zrušených příkazů za 24 hodin (celkové zobchodované množství / (vytvořené příkazy + zrušené příkazy)).
• při obchodování párů, kde je BNB základním nebo kótovaným aktivem, se skóre udělované za nedovolené chování zvyšuje.

Podrobnější informace o výše popsaném chování nebudeme zveřejňovat. Svůj ideální způsob obchodování zkuste nalézt metodou „pokus – omyl“, případně se o optimálním chování poraďte s dalšími uživateli rozhraní API.

Limity pro firewall webových aplikací

Přesné informace o pravidlech pro firewall webových aplikací sice neposkytujeme, ale pokud se vám zobrazí chyba HTTP 403, porušili jste pravidlo. Nejspíše jde o následek zadání příliš vysokého počtu příkazů v průběhu 5 minut. Za zadaný příkaz, který by mohl být považován za úmyslně škodlivý, však můžete dostat delší zákaz.

Pokud překročím limity, bude omezen můj účet, klíč API nebo IP adresa?

Co se týče tvrdých limitů, překročení celkové váhy požadavků za minutu (aktuálně 6 000) bude mít za následek zákaz vztahující se na IP adresu. Limity pro příkazy (aktuálně 10 za 10 sekund a 200 000 za 24 hodin) budou záviset na účtu. Po překročení limitů pro příkazy vám bude rovněž omezena možnost zadávat nové příkazy na webu (nebo v našich dalších aplikacích).

V případě limitů pro strojové učení se omezení vztahují na účty. Je-li vám omezeno využívání systému strojového učení, můžete si důvod a délku omezení ověřit na koncovém bodu [/sapi/v1/account/status] (jak je uvedeno v naší Dokumentaci k API).

Omezení firewallu webových aplikací se vztahuje pouze na IP adresu. Tento zákaz obvykle trvá 5 minut. Pokud však server uživatelův požadavek vyhodnotí jako škodlivý, může být zákaz prodloužen.

Překročil(a) jsem limity a byl mi omezen přístup, ale kód už jsem opravil(a). Zrušíte mi zákaz dříve?

Ne. Musíte počkat do konce zákazu.

Proč se mi při použití API zobrazila chyba HTTP 403?

Porušili jste pravidla pro firewall webových aplikací, nejspíše tím, že jste překročili stanovený limit či zadali úmyslně škodlivý příkaz (jak je popsán v oddíle o limitech v tomto dokumentu). Tyto zákazy obvykle trvají 5 minut.

Proč se moje připojení WebSocket přerušují/odpojují?

V rámci aktivních připojení WebSocket proběhne jednou za tři minuty příkaz ping. Pokud neodpovíte správně „zarámovaným“ příkazem ping, bude vaše připojení ukončeno.

U uživatelských datových toků vyprší platnost klíče pro naslouchání tehdy, neobdržíme-li požadavek na zachování připojení alespoň jednou za 60 minut. Podrobnosti naleznete také v naší Dokumentaci k API.

Používám program service wrapper třetí strany a nyní nefunguje. Můžete mi pomoci?

Služby či nástroje třetích stran bohužel nepodporujeme. Potřebujete-li pomoc, obraťte se na poskytovatele a/nebo vývojáře služby.

Kromě toho představuje zadávání klíčů API a/nebo tajných klíčů Binance na platformy třetích stran bezpečnostní riziko. Tyto služby používejte podle svého vlastního uvážení.

Připomínáme, že ani neposkytujeme všeobecnou pomoc při programování.

Neprováděl jsem žádné změny, ale přesto se mi zobrazují chybové hlášky. Co se stalo?

Bohužel nejsme schopni poskytovat podporu při řešení problémů u individuálních implementací. Používáte-li nástroj/wrapper třetí strany, obraťte se pro pomoc na její tým podpory či vývojáře.

Potřebuji získat svůj tajný klíč, ale zobrazuje se pouze „***“. Jak klíč získám? 

Z bezpečnostních důvodů se tajný klíč záměrně zobrazuje pouze při vytváření klíče API. Kdykoliv poté bude skryt. Pokud jste ho ztratili nebo jste si ho nezapsali, budete muset vytvořit nový klíč API a používat ho s novým tajným klíčem.

Mohu zvýšit své limity nebo vyhrazený tok/šířku pásma?

Tuto možnost bohužel v současnosti nenabízíme. Mělo by být možné pracovat s aktuálně poskytovanými limity.

Můj klíč API zmizel.

„Zmizení“ klíče API má pouze dvě pravděpodobná vysvětlení:

• Pokud jste v poslední době nebyli aktivní a API jste používali před 7. březnem 2018, je možné, že vaše klíče API byly v zájmu bezpečnosti vašeho účtu smazány.
• Důvodem pro odstranění aktivních klíčů API také mohla být vaše deaktivace účtu.

Měli byste být schopni bez problémů vytvořit nové klíče API.

Zobrazuje se mi hláška „Chyba – 1021 (Zpráva: Časové razítko tohoto požadavku je mimo rozsah recvWindow)“. Jak to mohu vyřešit?

Tato chyba se obvykle objevuje pouze v případě, že váš systémový čas není synchronizován s časem serveru. Možná budete muset synchronizovat svůj systémový čas. Postup však závisí na operačním systému.

V systému Windows můžete dle svého uvážení využít nástroj „Atomic Clock“ či podobný. Uživatelé systémů Linux a Mac mohou zkusit provést synchronizaci zadáním příkazu „ntpdate“ do příkazového řádku.

Pokud problém přetrvává, může souviset s latencí (problémem sítě). Zkuste upravit parametr recvWindow.

Mohu požádat o nové funkce API?

Pokud jste v naší dokumentaci nenalezli požadovanou funkci, lze předpokládat, že ji neposkytujeme. Jestliže nám chcete zaslat návrh na novou funkci, napište ho formou požadavku na zákaznickou podporu; požadavek posoudíme.

Domnívám se, že s API je problém. Jak ho můžu nahlásit?

Pokud máte pocit, že problém je na straně systému a nikoli ve vaší implementaci, zašlete nám důkazy do fóra pro vývojáře a my záležitost prošetříme. Upozorňujeme, že vágně formulované zprávy nepovažujeme za legitimní stížnost.