Documentația API丨Biblioteci open source și exemple API
Care sunt limitele?
Prezentare generală
Există trei tipuri diferite de limite, care pot fi modificate în orice moment:
- Limite stricte
- Limite ML (Machine Learning)
- Limite WAF (Web Application Firewall)
Limite stricte
- O încărcătură de 6.000 de solicitări pe minut (rețineți că aceasta nu este neapărat același lucru cu 6.000 de solicitări)
- 50 de ordine per 10 secunde
- 160.000 de ordine per 24 de ore
Limitele noastre stricte sunt listate în punctul final [/api/v3/exchangeInfo].
Limitele de învățare automată
Comportamentul de tranzacționare este evaluat prin raportare la utilizatorul mediu. Dacă vă abateți prea mult de la acesta, vi se va interzice accesul pentru o perioadă determinată de timp, variind de la 5 minute la 3 zile.
Să presupunem că aveți un scor de abuz de tranzacționare. Scorul dvs. va crește dacă:
- Ați efectuat în mod repetat operațiuni de „one-up” sau „front-run” în ceea ce privește cele mai bune prețuri Bid/Ask din registrul de ordine.
- Faceți spam în crearea și anularea ordinelor, fără a executa efectiv tranzacțiile.
- „Rata dvs. de conversie” este mică. „Rata de conversie” este definită ca numărul dvs. de tranzacții împărțit la numărul total de ordine create și anulate într-o perioadă de 24 de ore (nr. tranzacții/ (ordine + anulări)).
- „Încărcătura” dvs. este mică. „Încărcătura” este definită drept cantitatea totală tranzacționată împărțită la numărul total de ordine create și anulate într-o perioadă de 24 de ore (cantitatea totală tranzacționată/ (ordine + anulări)).
- Când tranzacționați perechi care au BNB ca activ de bază sau de cotare, scorul dvs. de abuz va fi amplificat.
Nu vor fi furnizate informații mai detaliate decât cele de mai sus. Utilizați încercări repetate pentru a găsi modelul ideal de tranzacționare sau discutați despre comportamentul optim cu alți utilizatori API.
Limite Web Application Firewall
Deși nu oferim detalii exacte despre regulile noastre WAF, dacă primiți o eroare HTTP 403, înseamnă că ați încălcat o regulă. Cel mai probabil, este rezultatul unor solicitări excesive într-o durată de 5 minute. Cu toate acestea, dacă trimiteți o solicitare care ar putea fi percepută ca dăunătoare, aceasta ar putea duce la interzicerea pe o durată mai mare.
Dacă depășesc limitele, restricția se va aplica contului, cheii API sau adresei IP?
În ceea ce privește limitele stricte, depășirea încărcăturii totale pe minut (în prezent 6.000) va duce la o interdicție de IP. Limitele ordinului (în prezent, 50 de ori/10 secunde și 160 000 de ori/24 de ore) vor depinde de cont. Dacă limita ordinelor a fost depășită, vi se va interzice și crearea de noi ordine pe site-ul web (sau alte aplicații ale noastre).
Pentru limitele de învățare automată, vor fi aplicate restricții conturilor. Dacă ați avut accesul restricționat de sistemul ML, puteți verifica motivul și durata utilizând punctul final [/sapi/v1/account/status] (indicat în documentația API).
Limitele Web Application Firewall vor fi aplicate doar IP-ului. De obicei, o interdicție WAF are o durată de 5 minute. Cu toate acestea, dacă serverul a interpretat solicitarea unui utilizator ca fiind dăunătoare, aceasta poate fi extinsă.
Am fost restricționat pentru depășirea limitelor, dar mi-am corectat codul. Mi se va ridica restricția mai devreme?
Nu. Trebuie să așteptați până la finalul perioadei de restricție.
De ce primesc o eroare HTTP 403 când folosesc API-ul?
Ați încălcat regulile WAF (Web Application Firewall), cel mai probabil prin încălcarea unei limite de tarifare sau trimiterea unei cereri dăunătoare (așa cum este subliniat în secțiunea privind limitele din acest document). De obicei, aceste interdicții au o perioadă de 5 minute.
De ce sunt conexiunile mele WebSocket întrerupte/deconectate?
La fiecare 3 minute, conexiunile WebSocket active vor primi un ping. Dacă nu răspundeți cu un ping corespunzător, conexiunea dvs. va fi întreruptă.
Pentru fluxurile de date ale utilizatorilor, dacă un keep-alive nu este primit cel puțin o dată la fiecare 60 de minute, cheia de ascultare va expira. Acest lucru este detaliat și în documentația API.
Folosesc un serviciu/wrapper terț și nu funcționează. Puteți să mă ajutați?
Din păcate, nu acceptăm servicii sau instrumente de la terți. Contactați serviciul și/sau dezvoltatorii pentru asistență suplimentară.
În plus, introducerea cheii dvs. API Binance și/sau a cheii secrete pe orice platformă terță reprezintă un risc de securitate. Utilizați aceste servicii la propria discreție.
Rețineți că, de asemenea, nu oferim asistență generală pentru programare.
În ciuda faptului că nu am făcut modificări, primesc brusc erori. Ce s-a întâmplat?
Din păcate, nu putem oferi asistență pentru probleme legate de implementarea dvs. personală. Dacă utilizați un wrapper/instrument de la o terță parte, contactați echipa lor de asistență/dezvoltare pentru ajutor.
Trebuie să accesez cheia mea secretă, dar afișează „***”. Cum o pot recupera?
Din motive de securitate, cheile secrete sunt proiectate să devină vizibile numai în momentul creării cheii API. Oricând după acest moment, acestea vor fi ascunse. Dacă ați pierdut cheia sau nu ați înregistrat-o, va trebui să creați o cheie API nouă și să o utilizați cu o nouă cheie secretă.
Îmi pot crește limitele sau fluxul/lățimea de bandă dedicată?
Din păcate, în prezent nu există această posibilitate. Ar trebui să puteți lucra respectând limitele stabilite.
Cheia mea API a dispărut.
Există doar două explicații posibile pentru „dispariția” unei chei API:
- Dacă nu ați fost activ recent și ați utilizat API-ul înainte de 7 martie 2018, este posibil ca cheia/cheile dvs. API să fie eliminate pentru a asigura securitatea contului dvs.
- Dacă v-ați dezactivat contul, acest lucru ar putea duce la ștergerea tuturor cheilor API active.
Ar trebui să puteți crea o nouă cheie API fără probleme.
Primesc „Eroare -1021 (Mesaj: Intervalul de timp pentru această cerere este în afara recvWindow)”. Cum pot rezolva acest lucru?
De obicei, această eroare apare doar dacă ora serverului și ora sistemului dvs. nu se sincronizează. Este posibil să fie nevoie să sincronizați ceasul sistemului. Acest proces variază în funcție de sistemul de operare.
Pentru Windows, puteți utiliza un instrument precum „Ceas atomic”, la discreția dvs. Utilizatorii Linux și Mac pot încerca sincronizarea cu „ntpdate” prin linia de comandă.
Dacă problema persistă, poate fi legată de latență (o problemă de rețea). Încercați să ajustați recvWindow.
Pot solicita noi funcționalități API?
Dacă nu găsiți în documentația noastră funcționalitatea pe care o solicitați, este posibil să nu o furnizăm. Dacă doriți să ne trimiteți o sugestie în ceea ce privește funcțiile, puteți deschide un bilet de asistență cu sugestia dvs. și aceasta va fi examinată.
Cred că există o problemă cu API-ul. Cum ar trebui să o raportez?
Dacă credeți că există o problemă cu sistemul și nu cu implementarea dvs., furnizați dovezi care să susțină reclamația dvs., contactându-ne în forumul dezvoltatorilor și vom investiga problema. Vă rugăm să rețineți că nu acceptăm mesaje vagi drept reclamații legitime.
Ultima actualizare pe 24 octombrie 2023