API-dokumentation丨API-bibliotek med öppen källkod och exempel
Vilka är gränserna?
Översikt
Det finns tre olika typer av gränser, som alla kan ändras när som helst:
- Skarpa gränser
- Maskininlärningsgränser (ML)
- Gränser pga. webbapplikationers brandväggar
Skarpa gränser
- 6 000 förfrågningsviktningar per minut (kom ihåg att detta inte nödvändigtvis är detsamma som 6 000 förfrågningar)
- 50 order per 10 sekunder
- 160 000 order per dygn
Våra skarpa gränser anges i slutpunkten [/api/v3/exchangeInfo].
Gränser för maskininlärning
Handelsbeteende utvärderas mot den genomsnittliga användaren. Om du avviker för mycket kommer du att förbjudas under en bestämd tid som sträcker sig från 5 minuter till 3 dagar.
Anta att du har fått poäng för handelsmissbruk. Din poäng ökar om:
- Du har upprepade gånger legat eller ligger i täten för det bästa köpet/försäljningen i orderboken.
- I likhet med spam postar du och annullerar order mycket snabbt utan att genomföra transaktioner.
- Din "konverteringsfrekvens" är låg. "Konverteringsfrekvens" definieras som ditt antal transaktioner dividerat med den totala orderläggningen och orderannulleringen under en 24-timmarsperiod (antal transaktioner/(order + annulleringar)).
- Din "viktning" är låg. "Viktning" definieras som dina transaktioner dividerat med den totala orderläggningen och orderannulleringen under en 24-timmarsperiod (antal transaktioner/(order + annulleringar)).
- När du handlar med par som har BNB som bas- eller noteringstillgång blir dina poäng för handelsmissbruk högre.
Mer specifik information än ovan kommer inte att ges. Prova dig fram för att uppnå ditt ideala handelsmönster eller diskutera optimalt beteende med andra API-användare.
Gränser pga. webbapplikationers brandväggar (WAF)
Vi tillhandahåller inte exakt information om våra WAF-regler, men om du får ett HTTP 403-fel har du brutit mot en regel. Troligtvis kommer det att vara ett resultat av alltför stora förfrågningar under 5 minuter. Men om du skickar en begäran som kan uppfattas som skadlig kan det också leda till ett längre förbud.
Om jag överskrider gränserna, kommer jag att begränsas via konto, API-nyckel eller IP-adress?
För de skarpa gränserna kommer ett överskridande av den totala förfrågningsviktningen per minut (för närvarande 6 000) att leda till ett IP-förbud. Ordergränserna (för närvarande är det 50 stycken per 10 sekunder och 160 000 per 24 timmar) kommer att bero på kontot. Om ordergränsen har överskridits kommer du också att hindras att lägga nya order på webbplatsen (eller i våra andra applikationer).
För maskininlärningsgränser kommer det att finnas begränsningar för konton. Om du har begränsats av maskininlärningssystemet kan du kontrollera orsaken och löptiden genom att använda slutpunkten [/sapi/v1/konto/status] (angiven i vår API-dokumentation).
Brandväggsbegränsningar för webbapplikationer tillämpas endast via IP. Vanligtvis gäller ett sådant s.k. WAF-förbud 5 minuter. Men om servern har tolkat en användares begäran som skadlig kan den förlängas.
Jag hade en begränsning för att ha överskridit gränserna, men jag fixade min kod. Kommer min blockering att tas bort tidigare?
Nej. Du måste vänta tills blockering är över.
Varför fick jag ett HTTP 403-fel när jag använde API:et?
Du har brutit mot reglerna för webbapplikationsbrandväggen (Web Application Firewall), troligen genom att bryta mot en hastighetsgräns eller skicka en skadlig begäran (som beskrivs i avsnittet om gränser i detta dokument). Vanligtvis varar dessa förbud i fem minuter.
Varför släpps/kopplas mina WebSocket-anslutningar bort?
Var tredje minut får aktiva WebSocket-anslutningar en signal. Om du inte svarar med en korrekt inramad signal avslutas din anslutning.
Om ett "livstecken" inte tas emot minst en gång var 60:e minut när det gäller användardataströmmar, upphör lyssningsknappen. Detta beskrivs också i API-dokumentationen.
Jag använder en tredjepartstjänst/ett tredjepartsskal och det fungerar inte. Kan ni hjälpa?
Tyvärr stöder vi inte tjänster eller verktyg från tredje part. Kontakta tjänsten och/eller utvecklarna för mer hjälp.
Dessutom är det en säkerhetsrisk att ange ens Binance API-nycklar och/eller hemliga nycklar på någon tredjepartsplattform. Använd dessa tjänster efter eget gottfinnande.
Tänk på att vi också undviker att tillhandahålla allmän programmeringshjälp.
Trots att jag inte ändrat något får jag plötsligt felmeddelanden. Vad har hänt?
Tyvärr kan vi inte ge support för problem med din personliga implementering. Om du använder ett omslag / verktyg från tredje part, vänligen kontakta deras support / utvecklingsteam för hjälp.
Jag måste få tillgång till min hemliga nyckel, men den visar "***". Hur kan jag finna den?
Av säkerhetsskäl och utifrån utformningen, är hemliga nycklar bara synliga när API-nyckeln skapas. När som helst efter den tiden kommer den att maskeras. Om du har tappat bort den eller inte skrivit ned den måste du skapa en ny API-nyckel och använda den med en ny hemlig nyckel.
Kan jag öka mina gränser eller dedikerade strömmande/bandbredd?
Tyvärr erbjuds inte detta för närvarande. Det ska vara möjligt att arbeta med de begränsningar som anges.
Min API-nyckel har försvunnit.
Det finns bara två troliga förklaringar för att en API-nyckel ska "försvinna":
- Om du inte har varit aktiv nyligen och du använt API:n före den 7 mars 2018 är det möjligt att din eller dina API-nycklar har rensats för att säkerställa kontots säkerhet.
- Om du har inaktiverat ditt konto skulle detta leda till att alla aktiva API-nycklar raderas.
Du ska kunna skapa en ny API-nyckel utan problem.
Jag får meddelandet "Fel -1021 (Meddelande: Tidsstämpel för denna begäran ligger utanför recvWindow)". Hur kan jag lösa detta?
Vanligtvis inträffar detta fel bara om servertiden och din systemtid inte synkroniseras. Du kan behöva synkronisera systemklockan. Denna process varierar dock beroende på operativsystem.
För Windows kan du, efter eget gottfinnande, använda ett verktyg som "Atomic Clock". Linux- och Mac-användare kan försöka synkronisera med "ntpdate" via kommandoraden.
Om problemet kvarstår kan det vara svarstidsrelaterat (ett nätverksproblem). Försök att justera ditt RecvWindow.
Kan jag begära nya API-funktioner?
Om du inte ser den funktionalitet du begär i vår dokumentation, bör du anta att vi inte tillhandahåller den. Om du vill göra ett funktionsförslag kan du öppna ett supportärende så granskas den.
Jag tror att det är ett problem med API:n. Hur ska jag rapportera det?
Om du anser att det råder ett problem med systemet och inte med din implementering, lämna bevis som stöd för ditt krav genom att kontakta oss i vårt utvecklarforum, så kommer vi att undersöka saken. Observera att vi inte accepterar vaga meddelanden som legitima klagomål.
Senast uppdaterad den 24 oktober 2023