Časté otázky ohľadom API

Posledná aktualizácia: 13. januára 2025

Dokumentácia API丨Knižnice a príklady otvoreného zdroja API 

Aké sú limity?

Prehľad

Existujú tri rôzne typy limitov, z ktorých všetky sa môžu kedykoľvek zmeniť:

1. Pevné limity
2. Limity ML (strojového učenia)
3. Limity WAF (Web Application Firewall)

Pevné limity

• Váha žiadostí 6 000 za minútu (nezabudnite, že to nemusí byť to isté ako 6 000 žiadostí)
• 100 príkazov za 10 sekúnd
• 200 000 príkazov za 24 hodín

Naše pevné limity sú uvedené na koncovom bode [/api/v3/exchangeInfo].

Limity strojového učenia

Obchodné správanie sa hodnotí v porovnaní s priemerným používateľom. Ak sa príliš odchýlite, budete na určitý čas zablokovaný v rozsahu od 5 minút do 3 dní.

Predpokladajme, že máte skóre zneužitia obchodovania. Vaše skóre sa zvýši, ak: 

• V knihe objednávok opakovane „navyšujete“ alebo „predbiehate“ najlepšiu ponuku/požiadavku.
• Spamujete rýchlym vytváraním a zrušením objednávok bez vykonania obchodov.
• Vaša „miera konverzie“ je nízka. „Miera konverzie“ je definovaná ako váš počet obchodov vydelený celkovým počtom vytvorených a zrušených príkazov za 24-hodinové obdobie (počet obchodov / (príkazy + zrušenia)).
• Vaša „váha“ je nízka. „Váha“ je definovaná ako vaša celkovo obchodovaná suma vydelená celkovým počtom vytvorených a zrušených objednávok za 24-hodinové obdobie (celková obchodovaná suma / (objednávky + zrušenia)).
• Keď obchodujete s pármi, ktoré majú BNB ako základné alebo kótovane aktívum, vaše skóre zneužitia sa zvýši.

Konkrétnejšie informácie, ako tie vyššie, nebudú poskytnuté. Na dosiahnutie ideálneho obchodného vzoru použite metódu pokus-omyl alebo diskutujte o optimálnom správaní sa s ostatnými používateľmi API.

Limity brány firewall pre webové aplikácie

Hoci neposkytujeme presné podrobnosti o našich pravidlách WAF, ak sa vám zobrazuje chyba HTTP 403, porušili ste pravidlo. S najväčšou pravdepodobnosťou to bude dôsledok nadmerných požiadaviek v priebehu 5 minút. Ak však posielate požiadavku, ktorá by mohla byť vnímaná ako škodlivá, môže to mať za následok aj zákaz na dlhšie obdobie.

Ak prekročím limity, budem obmedzený účtom, kľúčom API alebo adresou IP?

V prípade pevných limitov bude mať prekročenie celkového limitu váhy požiadaviek za minútu (aktuálne 6 000) za následok zablokovanie IP. Limity objednávok (v súčasnosti je to 10 krát/10 sekúnd a 200 000/24 hodín) budú závisieť od účtu. V prípade prekročenia limitu objednávok budú mať používatelia obmedzené vytváranie nových objednávok na webovej stránke (alebo v našich iných aplikáciách).

V prípade limitov strojového učenia sa na účty budú vzťahovať obmedzenia. Ak ste boli obmedzení systémom ML, môžete skontrolovať dôvod a trvanie pomocou koncového bodu [/sapi/v1/account/status] (uvedené v našej dokumentácii API).

Obmedzenia Web Application Firewall sa budú vzťahovať iba na IP. Zvyčajne bude mať zákaz WAF trvanie 5 minút. Ak však server interpretuje požiadavku používateľa ako škodlivú, môže sa predĺžiť.

Bol som obmedzený/-á za prekročenie limitov, ale opravil/-a som si kód. Bude zákaz čoskoro zrušený?

Nie. Musíte počkať, kým sa zákaz skončí.

Prečo sa mi pri používaní API zobrazila chyba HTTP 403?

Porušili ste pravidlá WAF (Web Application Firewall) s najväčšou pravdepodobnosťou porušením limitu rýchlosti alebo odoslaním škodlivej požiadavky (ako je uvedené v časti s obmedzeniami tohto dokumentu). Tieto bloky zvyčajne trvajú 5 minút.

Prečo sa moje pripojenia WebSocket rušia/odpájajú?

Každé 3 minúty dostanú aktívne pripojenia WebSocket ping. Ak neodpoviete správne formátovaným pingom, vaše pripojenie sa ukončí.

V prípade používateľských dátových tokov platí, že ak sa keep-alive neprijme aspoň raz za 60 minút, platnosť kľúča na počúvanie vyprší. Toto je tiež podrobne uvedené v našej dokumentácii API.

Používam službu/obal tretej strany a nefunguje to. Môžete pomôcť?

Bohužiaľ, nepodporujeme služby ani nástroje tretích strán. Ak potrebujete ďalšiu pomoc, obráťte sa na službu a/alebo vývojárov.

Okrem toho je bezpečnostným rizikom zadať váš kľúč(-e) Binance API a/alebo kľúč(-e) Secret Key do akejkoľvek platformy tretej strany. Tieto služby používajte podľa vlastného uváženia.

Majte na pamäti, že sa vyhýbame aj poskytovaniu všeobecnej programovacej pomoci.

Napriek tomu, že som nevykonal žiadne zmeny, sa mi zrazu zobrazujú chyby. Čo sa stalo?

Žiaľ, nemôžeme vám poskytnúť podporu pri problémoch s vašou osobnou implementáciou. Ak používate obal/nástroj tretej strany, požiadajte o pomoc ich tím podpory/vývoja.

Potrebujem získať prístup k svojmu kľúču Secret Key, ale zobrazuje sa „***“. Ako ho získam? 

Z bezpečnostných dôvodov sú tajné kľúče naschvál viditeľné iba v čase vytvorenia kľúča API. Kedykoľvek po tomto bode budú maskované. Ak ste ho stratili alebo ste si ho nezaznamenali, budete musieť vytvoriť nový kľúč API a použiť ho s novým tajným kľúčom.

Môžem zvýšiť svoje limity alebo vyhradený stream/šírku pásma?

Žiaľ momentálne to nie je v ponuke. Malo by byť možné pracovať s poskytnutými obmedzeniami.

Môj kľúč API zmizol.

Existujú iba dve pravdepodobné vysvetlenia pre „zmiznutie“ kľúča API:

• Ak ste nedávno neboli aktívni a používali ste rozhranie API pred 7. marcom 2018, je možné, že vaše kľúče API boli vymazané, aby sa zaistila bezpečnosť vášho účtu.
• Ak ste deaktivovali svoj účet, viedlo by to k vymazaniu všetkých aktívnych kľúčov API.

Mali by ste byť schopní bez problémov vytvoriť nový kľúč API.

Zobrazuje sa mi „Chyba -1021 (Správa: Časová pečiatka pre túto požiadavku je mimo recvWindow).“ Ako to môžem vyriešiť?

Táto chyba sa zvyčajne vyskytuje iba vtedy, ak sa čas servera a váš systémový čas nesynchronizujú. Možno budete musieť synchronizovať systémové hodiny. Tento proces sa však líši v závislosti od operačného systému.

V systéme Windows môžete podľa vlastného uváženia použiť nástroj ako „atómové hodiny.“ Používatelia systémov Linux a Mac môžu vyskúšať synchronizáciu s „ntpdate“ cez príkazový riadok.

Ak problém pretrváva, môže to súvisieť s latenciou (problém so sieťou). Pokúste sa upraviť svoje recvWindow.

Môžem požiadať o nové funkcie API?

Ak v našej dokumentácii nevidíte funkciu, ktorú požadujete, mali by ste predpokladať, že ju neposkytujeme. Ak by ste chceli navrhnúť funkciu, môžete otvoriť lístok podpory a ten bude preskúmaný.

Domnievam sa, že existuje problém s rozhraním API. Ako by som to mal nahlásiť?

Ak máte pocit, že sa vyskytol problém so systémom a nie s vašou implementáciou, poskytnite nám dôkazy na podporu svojho tvrdenia tak, že nás budete kontaktovať na našom fóre pre vývojárov a my to prešetríme. Upozorňujeme, že nejasné správy neakceptujeme ako oprávnené sťažnosti.