Gyakran ismételt kérdések az API kapcsán

Közzététel időpontja: 2018-06-05 09:38

Utolsó frissítés: 2025. január 13.

API-dokumentációAPI nyílt forráskódú könyvtárak és példák 

Mik a korlátok?

Áttekintés

Három különböző típusú korlát létezik, amelyek bármikor változhatnak:

  1. Kemény korlátok
  2. ML (gépi tanulás) korlátai
  3. WAF (webalkalmazás-tűzfal) korlátai

Kemény korlátok

  • 6000 kérelem súlya percenként (ne feledd, hogy ez nem feltétlenül ugyanaz, mint 6000 kérelem)
  • 100 megbízás / 10 mp
  • 200 000 megbízás / 24 óra

A kemény korlátaink az [/api/v3/exchangeInfo] végponton vannak listázva.

Gépi tanulás korlátai

A kereskedési magatartást az átlagos felhasználóhoz viszonyítva értékelik. Ha ettől túlzottan eltérsz, egy meghatározott időtartamra ki leszel tiltva, ami 5 perctől 3 napig terjedhet.

Tegyük fel, hogy van egy pontszámod, amely a kereskedési visszaéléseket méri. A pontszámod növekedni fog, ha: 

  • Folyamatosan „beelőzöd” a legjobb vételi/eladási árat a megbízási könyvben.
  • Gyorsan hozol létre és törölsz kéretlen megbízásokat anélkül, hogy kereskedéseket hajtanál végre.
  • A „váltási arányod” alacsony. A „váltási arány” definíciója: a kereskedéseid száma osztva egy 24 órás időszak alatt létrehozott és törölt megbízások összegével (kereskedések száma / (megbízások + törlések)).
  • A „súlyozásod” alacsony. A „súlyozás” definíciója: a teljesen kereskedett mennyiség osztva egy 24 órás időszak alatt létrehozott és törölt megbízások összegével (teljesen kereskedett mennyiség / (megbízások + törlések)).
  • Amikor olyan kereskedési párokkal kereskedsz, amelyeknél a BNB az alapeszköz vagy ajánlat eszköze, a visszaélési pontszámod növekszik.

A fenti információnál részletesebb információt nem fogunk adni. Kérjük, próbálkozz addig, amíg eléred az ideális kereskedési mintádat, vagy beszélgess más API-felhasználókkal az optimális magatartásról.

A webalkalmazás-tűzfal (WAF) korlátai

Bár nem adunk meg pontos részleteket a WAF szabályainkról, ha HTTP 403 hibát kapsz, akkor megsértettél egy szabályt. Ezt valószínűleg az okozza, hogy túl sok kérelmet küldesz 5 percen belül. Ha azonban olyan kérést küldesz, amelyet rosszindulatúnak lehet tekinteni, az hosszabb időtartamú kitiltást is eredményezhet.

Ha túllépem a korlátokat, akkor a fiókom, az API-kulcsom vagy az IP címem alapján kerülök korlátozásra?

Ami a szigorú korlátokat illeti, a percenkénti összes kérelem súlyára vonatkozó korlát (jelenleg 6000) túllépése IP-tiltást eredményez. A megbízási limitek (jelenleg 10 alkalom/10 másodperc és 200 000 alkalom/24 óra) a fióktól függenek. Ha túllépted a megbízási limitet, nem hozhatsz létre új megbízásokat a weboldalon (vagy más alkalmazásainkban).

A gépi tanulási korlátok esetében a korlátozások a fiókokat érintik. Ha az ML rendszer szabott ki rád korlátozást, ellenőrizheted az okot és az időtartamot a [/sapi/v1/account/status] végpont használatával (feltüntetve az API dokumentációnkban).

A webalkalmazások tűzfalának korlátozásai csak az IP-címre vonatkoznak. Egy WAF tilalom időtartama általában 5 perc. Ha azonban a szerver egy felhasználói kérelmet rosszindulatúnak értelmez, ez meghosszabbítható.

Korlátoztak a korlátok túllépése miatt, de javítottam a kódom. Feloldják korábban a tiltásomat?

Nem. Várnod kell, amíg a feloldásra kerül a tiltás.

Miért kaptam HTTP 403 hibát az API használata során?

Megszegted a WAF (Web Application Firewall, webalkalmazás-tűzfal) szabályait, valószínűleg azzal, hogy túllépted a sebességkorlátot, vagy rosszindulatú kérelmet küldtél (ahogy azt a dokumentum korlátozásokat leíró szakasza részletezi). Jellemzően ezek a tilalmak 5 percig tartanak.

Miért szűnnek meg/kapcsolódnak le a WebSocket kapcsolataim?

Az aktív WebSocket kapcsolatok 3 percenként egy pinget fognak kapni. Ha nem válaszolsz megfelelően keretezett pinggel, a kapcsolat megszakításra kerül.

A felhasználói adatközvetítések esetén, ha 60 percenként legalább egyszer nem érkezik keep-alive üzenet, lejár a listen key. Ez az API dokumentációban is részletesen szerepel.

Harmadik fél által nyújtott szolgáltatást/wrappert használok, és nem működik. Kaphatok segítséget?

Sajnos nem nyújtunk támogatást harmadik felek szolgáltatásaihoz vagy eszközeihez. Kérjük, lépj kapcsolatba a szolgáltatással és/vagy a fejlesztőkkel további segítségért.

Ráadásul biztonsági kockázatot jelent, ha megadod a Binance API kulcsaid és/vagy titkos kulcsaid egy harmadik fél platformján. Kérjük, ezeket a szolgáltatásokat saját belátásod szerint használd.

Ne feledd, hogy általános programozási segítséget sem nyújtunk.

Nem módosítottam semmit, mégis hirtelen hibákat kapok. Mi történt?

Sajnos nem tudunk támogatást nyújtani a saját megvalósításoddal kapcsolatos problémákhoz. Ha harmadik fél által készített wrappert/eszközt használsz, kérjük, segítségért lépj kapcsolatba az adott fél ügyfélszolgálatával/fejlesztőcsapatával.

Szükségem van a titkos kulcsomra, de csak „***” jelenik meg. Hogyan tudom ezt visszanyerni? 

A rendszer biztonsági okokból úgy van kialakítva, hogy a titkos kulcsok csak az API-kulcs létrehozásakor láthatók. Azután mindig el lesz rejtve. Ha elvesztetted, vagy nem rögzítetted, új API kulcsot kell létrehoznod, és azt egy új titkos kulccsal kell használnod.

Megnövelhetem a korlátaimat vagy a dedikált sávszélességemet?

Sajnos ilyesmi jelenleg nem elérhető... A megadott korlátokkal dolgozhatsz.

Eltűnt az API kulcsom.

Csak két valószínű magyarázat létezik arra, hogy egy API kulcs „eltűnjön”:

  • Ha az utóbbi időben nem voltál aktív, és 2018. március 7. előtt használtad az API-t, lehetséges, hogy az API kulcsaidat törölték a fiókod biztonsága érdekében.
  • Ha letiltottad a fiókodat, minden aktív API kulcsod törlésre került.

Minden gond nélkül létrehozhatsz új API-kulcs(ok)at.

A következő hibaüzenetet kapom: „Error -1021 (Üzenet: A kérelem időbélyege kívül esik a recvWindow időablakán)”. Hogyan tudom ezt megoldani?

Jellemzően ez a hiba csak akkor fordul elő, ha a szerveridő és a rendszeridő nem szinkronizálódik. Lehet, hogy szinkronizálnod kell a rendszerórát. Azonban ez a folyamat az operációs rendszertől függően változhat.

Windows esetén saját belátása szerint használhatsz egy olyan eszközt, mint az „Atomic Clock”. A Linux és Mac felhasználók megpróbálhatják a szinkronizálást a parancssoron keresztül az „ntpdate” paranccsal.

Ha a probléma továbbra is fennáll, az a késleltetéssel (hálózati problémával) lehet összefüggésben. Kérjük, próbáld meg módosítani a recvWindow értékét.

Kérhetek új API funkciókat?

Ha nem találod a kért funkciót a dokumentációnkban, valószínűleg nem biztosítjuk azt. Ha szeretnél funkciójavaslatot tenni, bejelentést kell tehetsz a támogatási oldalunkon, és felülvizsgáljuk a javaslatot.

Úgy vélem, hogy probléma van az API-val. Hogyan jelentsem a problémát?

Ha úgy érzed, hogy a rendszerrel van probléma, és nem a te megvalósításoddal, kérjük, nyújts be bizonyítékot a panaszod alátámasztására, és lépj kapcsolatba velünk a fejlesztői fórumunkon, és kivizsgáljuk az esetet. Kérjük, vedd figyelembe, hogy nem fogadunk el homályos megfogalmazású üzeneteket hivatalos panaszokként.