Pogosto zastavljena vprašanja o API

Nazadnje posodobljeno: 13. januarja 2025

Dokumentacija API丨Odprtokodne knjižnice in primeri API 

Kakšne so omejitve?

Pregled

Obstajajo tri različne vrste omejitev, ki se lahko kadar koli spremenijo:

1. Trdna omejitev
2. Omejitve strojnega učenja
3. Omejitve požarnega zidu za spletne aplikacije

Trdna omejitev

• 6000 teže v zahtevah na minuto (upoštevajte, da to ni nujno enako 6000 zahtevam)
• 100 naročil na 10 sekund
• 200.000 naročil na 24 ur

Naše trdne omejitve so navedene na končni točki [/api/v3/exchangeInfo].

Omejitve strojnega učenja

Vedenje pri trgovanju se ocenjuje glede na povprečnega uporabnika. Če odstopate predaleč, boste za določen čas izključeni, od 5 minut do 3 dni.

Predpostavimo, da imate ocenjevanje zlorabe trgovanja. Vaš rezultat se bo povečal, če: 

• pri najboljši ponudbi/povpraševanju v knjigi naročil večkrat zaporedoma uporabite prakso, imenovano »one-upping« ali »front-running«;
• zelo hitro klikate na ustvarjanje in preklic naročila, ne da bi kdaj izvedli trgovanje.
• vaša »stopnja pretvorbe« je nizka. »Stopnja pretvorbe« je opredeljena kot vaše število trgovanj, deljeno s skupnim številom ustvarjenih in preklicanih naročil v 24-urnem obdobju (število trgovanj / (naročila + preklici)).
• Vaša »teža« je nizka. »Teža« je opredeljena kot skupna količina vaših trgovanj, deljena s skupnim številom ustvarjenih in preklicanih naročil v 24-urnem obdobju (skupna količina trgovanj / (naročila + preklici)).
• Pri trgovanju s pari, ki imajo BNB kot osnovno ali kotirano sredstvo, se bo vaš rezultat zlorabe povečal.

Bolj podrobne informacije od zgoraj navedenih ne bodo posredovane. Uporabite metodo poskušanja in delanja napak, da najdete svoj idealen vzorec trgovanja, ali se o optimalnem vedenju pogovorite z drugimi uporabniki API-ja.

Omejitve požarnega zidu za spletne aplikacije

Čeprav ne zagotavljamo natančnih podrobnosti o naših pravilih glede požarnega zidu za spletne aplikacije, ste, če prejmete napako HTTP 403, prekršili pravilo. Najverjetneje bo to posledica prevelikega števila zahtev v 5 minutah. Če pa pošiljate zahtevo, ki bi jo lahko zaznali kot zlonamerno, lahko to povzroči tudi daljšo prepoved.

Ali bom, če presežem omejitve, omejen/-a z računom, ključem API ali naslovom IP?

Pri trdih omejitvah bo prekoračitev skupne teže zahteve na minuto (trenutno 6000) povzročila prepoved IP-ja. Omejitve naročil (trenutno je 10-krat/10 sekund in 200.000-krat/24 ur) bodo odvisne od računa. Če je bila omejitev naročil presežena, vam bo onemogočeno tudi ustvarjanje novih naročil na spletni strani (ali naših drugih aplikacijah).

Za omejitve strojnega učenja bodo za račune uporabljene omejitve. Če ste bili omejeni s sistemom ML, lahko preverite razlog in trajanje s končno točko [/sapi/v1/account/status] (navedeno v naši dokumentaciji API).

Omejitve požarnega zidu za spletne aplikacije bodo uporabljene samo za naslov IP. Običajno bo prepoved požarnega zidu za spletne aplikacije trajala 5 minut. Če pa si strežnik zahtevo uporabnika razlaga kot zlonamerno, se prepoved lahko podaljša.

Bil/-a sem omejen/-a zaradi preseganja omejitev, vendar sem svojo kodo popravil/-a. Ali se bo moja prepoved končala prej?

Ne. Počakati morate, da se prepoved konča.

Zakaj sem pri uporabi API-ja prejel/-a napako HTTP 403?

Kršili ste pravila požarnega zidu za spletne aplikacije, najverjetneje s kršitvijo omejitve hitrosti ali pošiljanjem zlonamerne zahteve (kot je opisano v razdelku o omejitvah tega dokumenta). Običajno te prepovedi trajajo 5 minut.

Zakaj se moje povezave WebSocket ukinjajo/prekinjajo?

Aktivne povezave WebSocket bodo vsake 3 minute prejele ping. Če se ne odzovete s pravilno uokvirjenim pingom, bo vaša povezava prekinjena.

Pri pretokih uporabniških podatkov bo ključ za poslušanje potekel, če obvestilo o ohranjanju ni prejeto vsaj enkrat vsakih 60 minut. To je tudi podrobno opisano v naši dokumentaciji API.

Uporabljam storitev/ovoj zunanjega ponudnika, a ta ne deluje. Mi lahko pomagate?

Žal ne podpiramo storitev ali orodij zunanjih ponudnikov. Za nadaljnjo pomoč se obrnite na storitev in/ali razvijalce.

Poleg tega vnašanje vaših ključev za API Binance in/ali skrivnih ključev v katero koli platformo zunanjih ponudnikov velja za varnostno tveganje. S trgovanjem začnite po lastni presoji.

Upoštevajte, da se izogibamo tudi splošni pomoči pri programiranju.

Kljub temu, da nisem opravil nobenih sprememb, sem nenadoma začel prejemati sporočila o napakah. Kaj se je zgodilo?

Žal ne moremo zagotoviti podpore pri težavah z vašo osebno implementacijo. Če uporabljate ovoj/orodje zunanjega ponudnika, se za pomoč obrnite na njihovo skupino za podporo/razvoj.

Potrebujem dostop do svojega skrivnega ključa, vendar vidim le »***«. Kako pridem do njega? 

Iz varnostnih razlogov so skrivni ključi po zasnovi vidni samo takrat, ko je ključ API ustvarjen. Kadar koli po tej točki bo zamaskiran. Če ste ga izgubili ali si ga niste zabeležili, boste morali ustvariti nov ključ API in ga uporabiti z novim skrivnim ključem.

Ali lahko povečam svoje omejitve ali namenski tok/pasovno širino?

Na žalost to trenutno ni na voljo. Moralo bi biti možno delati z navedenimi omejitvami.

Moj ključ API je izginil.

Obstajata samo dve verjetni razlagi za »izginotje« ključa API:

• Če v zadnjem času niste bili aktivni in ste API uporabljali pred 7. marcem 2018, je možno, da so bili vaši ključi API počiščeni zaradi varnosti vašega računa.
• Če ste svoj račun onemogočili, je to povzročilo izbris vseh aktivnih ključev API.

Nove ključe API bi morali imeti možnost ustvariti brez težav.

Prejemam sporočilo o napaki »Error -1021 (Sporočilo: časovni žig za to zahtevo je zunaj recvWindow)«. Kako lahko to rešim?

Običajno se ta napaka pojavi le, če se čas strežnika in sistemski čas ne sinhronizirata. Morda boste morali sinhronizirati uro svojega sistema. Vendar se ta postopek razlikuje glede na operacijski sistem.

Na operacijskem sistemu Windows lahko po lastni presoji uporabite orodje, na primer »Atomska ura«. Uporabniki operacijskih sistemov Linux in Mac lahko poskusijo sinhronizirati z »ntpdate« prek ukazne vrstice.

Če se težava nadaljuje, je morda povezana z zakasnitvijo (težava z omrežjem). Poskusite prilagoditi recvWindow.

Ali lahko zahtevam nove funkcije API-ja?

Če v naši dokumentaciji ne vidite funkcije, ki jo zahtevate, to razumite kot znak, da te funkcije ne ponujamo. Če želite podati predlog za funkcijo, lahko odprete zahtevo za podporo, ta pa bo pregledana.

Predvidevam, da je težava v API-ju. Kako naj to prijavim?

Če menite, da je težava s sistemom in ne z vašo implementacijo, predložite dokaze, ki podpirajo vašo trditev, tako da stopite v stik z nami na našem forumu za razvijalce in raziskali bomo. Upoštevajte, da nejasnih sporočil ne sprejemamo kot upravičene pritožbe.