Ofte stillede spørgsmål om API

Udgivet den 2018-06-05 09:38

Sidst opdateret: 13. januar 2025

API-dokumentationAPI Open Source-biblioteker og eksempler 

Hvad er grænserne?

Oversigt

Der er tre forskellige typer grænser, som alle kan ændres til enhver tid:

  1. Ufleksible grænser
  2. ML-grænser (maskinlæring)
  3. WAF-begrænsninger (Web Application Firewall)

Ufleksible grænser

  • 6.000 forespørgsler pr. minut (husk, at dette ikke nødvendigvis er det samme som 6.000 forespørgsler)
  • 100 ordrer pr. 10 sekunder
  • 200.000 ordrer pr. 24 timer

Vores ufleksible grænser er angivet på [/api/v3/exchangeInfo]-slutpunktet.

Grænser for maskinlæring

Handelsadfærd evalueres i forhold til den gennemsnitlige bruger. Hvis du afviger for meget, bliver du udelukket i en bestemt periode, der spænder fra 5 minutter til 3 dage.

Antag, at du har en score for handelsmisbrug. Din score vil stige, hvis: 

  • Du "overgår" eller "løber foran" det bedste bud/ønske i ordrebogen gentagne gange.
  • Du spammer ordreoprettelse og -annullering meget hurtigt uden at udføre handler.
  • Din "konverteringsfrekvens" er lav. "Konverteringsfrekvensen" er defineret som dit antal handler divideret med de samlede ordreoprettelser og -annulleringer i løbet af en 24-timers periode (antal handler / (ordrer + annulleringer)).
  • Din "vægt" er lav. "Vægt" defineres som din samlede handlede mængde divideret med de samlede ordreoprettelser og annulleringer i løbet af en 24-timers periode (samlet handlet mængde / (ordrer + annulleringer)).
  • Når du handler par, der har BNB som basis- eller kursaktiv, vil din misbrugsscore blive forstærket.

Der angives ikke mere specifikke oplysninger end ovenstående. Prøv dig frem for at opnå dit ideelle handelsmønster, eller drøft optimal adfærd med andre API-brugere.

Firewallgrænser for webapplikationer

Vi angiver ikke præcise detaljer om vores WAF-regler, men hvis du modtager en HTTP 403-fejl, har du brudt en regel. Det vil sandsynligvis være et resultat af for mange forespørgsler inden for en periode på 5 minutter. Men hvis du sender en anmodning, der kan opfattes som ondsindet, kan det også resultere i en udelukkelse af længere varighed.

Hvis jeg overskrider grænserne, vil jeg så blive begrænset af konto, API-nøgle eller IP-adresse?

For de ufleksible grænser vil overskridelse af den samlede vægtgrænse af anmodninger pr. minut (i øjeblikket 6.000) resultere i en IP-blokering. Ordregrænserne (er i øjeblikket 10 gange/10 sekunder og 200.000 gange/24 timer) vil afhænge af kontoen. Hvis ordregrænsen er overskredet, vil du også blive forhindret i at oprette nye ordrer på websitet (eller vores andre applikationer).

For maskinlæringsgrænser vil der blive anvendt begrænsninger på konti. Hvis du er blevet begrænset af ML-systemet, kan du tjekke årsagen og varigheden ved at bruge slutpunktet[/sapi/v1/account/status] (se vores API Dokumentation).

Firewallbegrænsninger for webapplikationer vil kun blive anvendt af IP. Normalt varer en WAF-udelukkelse 5 minutter. Men hvis serveren har fortolket en brugers anmodning som værende ondsindet, kan den blive forlænget.

Jeg blev begrænset, fordi jeg overskred grænserne, men jeg har rettet min kode. Vil du fjerne min udelukkelse?

Nej. Du skal vente, indtil udelukkelsesperioden er overstået.

Hvorfor fik jeg en HTTP 403-fejl, da jeg brugte API'en?

Du har overtrådt WAF-reglerne (Web Application Firewall), sandsynligvis ved at overskride en hastighedsgrænse eller sende en ondsindet anmodning (som beskrevet i afsnittet om grænser i dette dokument). Typisk varer disse udelukkelser 5 minutter.

Hvorfor bliver mine WebSocket-forbindelser droppet/afbrudt?

Hvert 3. minut vil aktive WebSocket-forbindelser modtage en ping. Hvis du ikke svarer med en korrekt indrammet ping, vil din forbindelse blive afbrudt.

For brugerdatastrømme gælder det, at hvis der ikke modtages en "keep-alive" mindst én gang hvert 60. minut, så udløber listenøglen. Dette er også beskrevet i vores API-dokumentation.

Jeg bruger en tredjeparts service/wrapper, og det virker ikke. Kan du hjælpe?

Desværre understøtter vi ikke tredjepartstjenester eller -værktøjer. Kontakt tjenesten og/eller udviklerne for yderligere hjælp.

Derudover er det en sikkerhedsrisiko at indtaste din(e) Binance API-nøgle(r) og/eller hemmelige nøgle(r) på en tredjepartsplatform. Brug disse tjenester efter eget skøn.

Husk, at vi også undgår at yde generel programmeringsassistance.

Selvom jeg ikke har foretaget nogen ændringer, modtager jeg pludselig fejl. Hvad sker der?

Desværre kan vi ikke yde support til problemer med din personlige implementering. Hvis du bruger tredjeparts wrapper/værktøj, bedes du kontakte deres support/udviklingsteam for at få hjælp.

Jeg skal have adgang til min hemmelige nøgle, men den viser "***". Hvordan finder jeg det? 

Af sikkerhedsmæssige årsager er hemmelige nøgler kun synlige på det tidspunkt, hvor API-nøglen oprettes. Når som helst herefter vil den blive maskeret. Hvis du har mistet den, eller du ikke har registreret den, skal du oprette en ny API-nøgle og bruge den med en ny hemmelig nøgle.

Kan jeg øge mine grænser eller min dedikerede stream/båndbredde?

Desværre tilbydes dette ikke i øjeblikket. Det burde være muligt at arbejde med de givne begrænsninger.

Min API-nøgle er forsvundet.

Der er kun to sandsynlige forklaringer på, at en API-nøgle "forsvinder":

  • Hvis du ikke har været aktiv for nylig, og du brugte API'en før den 7. marts 2018, er det muligt, at din(e) API-nøgle(r) blev slettet af hensyn til din kontosikkerhed.
  • Hvis du har valgt at deaktivere din konto, vil det resultere i sletning af alle aktive API-nøgler.

Du bør kunne oprette en eller flere nye API-nøgler uden problemer.

Jeg modtager "Fejl -1021 (Besked: Tidsstemplet for denne anmodning er uden for recvWindow)". Hvordan kan jeg løse det?

Denne fejl opstår typisk kun, hvis servertiden og din systemtid ikke er synkroniseret. Det kan være nødvendigt at synkronisere dit systemur. Denne proces varierer dog afhængigt af operativsystemet.

Til Windows kan du efter eget valg bruge et værktøj som "Atomur". Linux- og Mac-brugere kan prøve at synkronisere med "ntpdate" via kommandolinjen.

Hvis problemet fortsat opstår, kan det være latensrelateret (et netværksproblem). Prøv at justere dit recvWindow.

Kan jeg anmode om nye API-funktionaliteter?

Hvis du ikke kan se den ønskede funktionalitet i vores dokumentation, skal du gå ud fra, at vi ikke tilbyder den. Hvis du gerne vil komme med et forslag til en funktion, kan du åbne en supportticket, og den vil blive gennemgået.

Jeg tror, der er et problem med API'en. Hvordan skal jeg rapportere det?

Hvis du mener, at der er et problem med systemet og ikke med din implementering, bedes du fremlægge dokumentation for din påstand ved at kontakte os i vores udviklerforum. Så undersøger vi det. Bemærk, at vi ikke accepterer vage beskeder som legitime klager.