API dokumentācija丨API atvērtā pirmkoda bibliotēkas un piemēri
Kādi ir ierobežojumi?
Pārskats
Pastāv trīs dažādi ierobežojumu veidi, kas var mainīties jebkurā brīdī:
- Aparatūras ierobežojumi
- MM (mašīnmācīšanās) ierobežojumi
- TLU (tīmekļa lietojumprogrammu ugunsmūra) ierobežojumi
Aparatūras ierobežojumi
- 6000 svērtie pieprasījumi minūtē (atceries, ka tas nav tas pats, kas 6000 pieprasījumi)
- 50 orderi 10 sekundēs
- 160 000 orderi 24 stundās
Mūsu aparatūras ierobežojumi ir uzskaitīti [/api/v3/exchangeInfo] galapunktā.
Mašīnmācīšanās ierobežojumi
Tirdzniecības darbība tiek salīdzināta ar vidējā lietotāja darbību. Ja tava tirdzniecības darbība pārāk ļoti atšķirsies, tu tiksi bloķēts uz noteiktu laiku – no 5 minūtēm līdz 3 dienām.
Ņem vērā, ka tev ir tirdzniecības pārkāpumu rādītājs. Tavs rādītājs pieaugs, ja:
- Tu atkārtoti "pārsit" labāko cenu vai izmanto citiem nepieejamu informāciju orderu grāmatā.
- Tu ļoti lielā ātrumā veido un atcel orderus, neveicot darījumus.
- Tavs konvertācijas koeficients ir zems. Konvertācijas koeficients tiek noteikts, dalot tavu darījumu skaitu ar kopējo izveidoto un atcelto orderu skaitu 24 stundu periodā (darījumu skaits / (izveidotie + atceltie orderi)).
- Tavs "svars" ir zems. Svars tiek noteikts, dalot tavu darījumu apjomu ar kopējo izveidoto un atcelto orderu skaitu 24 stundu periodā (kopējais darījumu apjoms / (izveidotie + atceltie orderi)).
- Tirgojot pārus, kuriem pamata vai kotācijas aktīvs ir BNB, tavs pārkāpumu rādītājs tiks palielināts.
Sīkāka informācija par pārkāpumu rādītāju netiks sniegta. Lūdzu, patstāvīgi veic tirdzniecības darbības, lai noteiktu tev vislabāk atbilstošo tirdzniecības modeli vai apspried optimālas tirdzniecības stratēģijas ar citiem API lietotājiem.
Tīmekļa lietotņu ugunsmūra ierobežojumi
Mēs nesniedzam detalizētu informāciju par mūsu TLU noteikumiem, bet, ja tev tiek rādīta kļūda "HTTP 403", tas nozīmē, ka pārkāpi kādu noteikumu. Visticamāk, 5 minūšu laikā tika veikts pārmērīgs pieprasījumu skaits. Ja tu izsūtīsi pieprasījumus, kas var tikt uzskatīti par ļaunprātīgiem, tavs konts var tikt bloķēts uz ilgāku laiku.
Ja es pārsniegšu ierobežojumus, vai tiks bloķēts mans konts, API atslēga vai IP adrese?
Pārsniedzot maksimālo ierobežojumu attiecībā uz kopējo svērto pieprasījumu skaitu minūtē (pašlaik: 6000), tiks bloķēta IP adrese. Orderu skaita ierobežojumi (pašlaik: 50 reizes 10 sekundēs un 160 000 reizes 24 stundās) ir atkarīgi no konkrētā konta. Ja tiks pārsniegts orderu skaita ierobežojums, lietotājs nevarēs arī veidot jaunus orderus vietnē (vai citās mūsu lietotnēs).
Mašīnmācīšanās ierobežojumu pārkāpumu gadījumā kontiem tiks piemēroti ierobežojumi. Ja tava konta darbību ierobežoja MM sistēma, tu vari apskatīt konta darbības ierobežojumu iemeslu un ilgumu, izmantojot [/sapi/v1/account/status] galapunktu (norādīts mūsu API dokumentācijā).
Tīmekļa lietojumprogrammu ugunsmūra ierobežojumu pārkāpumu gadījumā tiks bloķēta IP adrese. Parasti TLU pārkāpumu rezultātā bloķēšana ilgst 5 minūtes. Bloķēšanas laiks var būt ilgāks, ja serveris uzskatīs lietotāja darbības par ļaunprātīgām.
Mani bloķēja ierobežojumu pārkāpumu dēļ, bet es savedu kārtībā savu kodu. Vai mans konts tiks atbloķēts agrāk?
Nē. Tev jāgaida līdz bloķēšanas laika beigām.
Kāpēc man tiek parādīta kļūda "HTTP 403", kad izmantoju API?
Tu pārkāpi TLU (tīmekļa lietojumprogrammu ugunsmūra) noteikumus, visdrīzāk pārkāpjot ierobežojuma koeficientu vai nosūtot ļaunprātīgu pieprasījumu (kā aprakstīts šī dokumenta limitu sadaļā). Parasti bloķēšana par šiem pārkāpumiem ilgst 5 minūtes.
Kāpēc mani WebSocket savienojumi tiek pārtraukti/atvienoti?
Reizi 3 minūtēs uz aktīvajiem WebSocket savienojumiem tiks nosūtīts signāls. Ja noteiktajā laikā netiks saņemts atbildes signāls, tavs savienojums tiks pārtraukts.
Lietotāju datu plūsmu gadījumā, ja savienojuma signāls netiek saņemts vismaz reizi 60 minūtēs, beidzas atslēgas darbības termiņš. Papildinformācija par to ir sniegta mūsu API dokumentācijā.
Es izmantoju trešās puses pakalpojumu, bet tas nedarbojas. Vai varat palīdzēt?
Diemžēl mēs neatbalstām trešo pušu pakalpojumus vai rīkus. Lūdzu, sazinies ar pakalpojuma sniedzējiem un/vai izstrādātājiem, lai saņemtu atbalstu.
Tavas Binance API atslēgas un/vai slepeno atslēgu ievadīšana trešo pušu platformās ir uzskatāma par drošības risku. Veicot šādas darbības, tu uzņemies visu atbildību un riskus.
Ņem vērā, ka mēs sniedzam vispārīgu atbalstu programmēšanā.
Es neveicu nekādas izmaiņas, bet pēkšņi sāku saņemt kļūdu paziņojumus. Kas notika?
Diemžēl mēs nespējam palīdzēt ar tava risinājuma izstrādes problēmām. Ja tu izmanto trešās puses rīku, lūdzu, sazinies ar tā atbalsta dienestu/izstrādātāju komandu.
Vēlos piekļūt savai slepenajai atslēgai, bet redzu tikai "***". Kā varu uzzināt slepeno atslēgu?
Drošības iemeslu dēļ slepenās atslēgas ir redzamas tikai API atslēgas izveides brīdī. Pēc tam šī atslēga būs vienmēr slēpta. Ja tu nozaudēji vai nepierakstīji šo atslēgu, tev būs jāizveido jauna API atslēga un jāizmanto tā ar jaunu slepeno atslēgu.
Vai es varu palielināt manus limitus vai izmantot atsevišķu plūsmu/joslas platumu?
Diemžēl pašlaik šādu iespēju mēs nepiedāvājam. Lietotājiem ir jāstrādā mūsu noteikto ierobežojumu ietvaros.
Mana API atslēga pazuda.
Ir divi iespējamie iemesli API atslēgas "pazušanai":
- Ja pēdējā laikā nebiji aktīvs un izmantoji API, kas tika izveidots pirms 2018. gada 7. marta, ir iespējams, ka tavas API atslēgas tika dzēstas, lai garantētu tava konta drošību.
- Ja atspējoji savu kontu, visas aktīvās API atslēgas tiks dzēstas.
Tu vari bez problēmām veidot jaunas API atslēgas.
Es saņemu kļūdas paziņojumu "Kļūda-1021 (ziņojums: šī pieprasījuma laika zīmogs ir ārpus recvWindow)". Kā novērst šo kļūdu?
Parasti šī kļūda notiek tad, ja servera laiks un tavas sistēmas laiks atšķiras. Tev var būt nepieciešams veikt sistēmas pulksteņa sinhronizāciju. Šis process ir atkarīgs no operētājsistēmas.
Windows operētājsistēmā tu vari pēc saviem ieskatiem izmantot tādus rīkus kā "Atomic Clock". Linux un Mac operētājsistēmu lietotāji var izmantot komandu "ntpdate" komandrindā, lai veiktu sinhronizāciju.
Ja problēmu neizdodas novērst, tā var būt saistīta ar latentumu (tīkla problēma). Mēģini pielāgot savu recvWindow.
Vai varu pieprasīt jaunas API funkcijas?
Ja neatrodi vēlamo funkciju mūsu dokumentācijā, tad mēs šo funkciju nenodrošinām. Ja vēlies ieteikt funkciju, vari atvērt atbalsta biļeti ar savu ieteikumu, un mēs to izskatīsim.
Domāju, ka pastāv problēma ar API. Kā par to ziņot?
Ja tu domā, ka problēma ir saistīta ar sistēmu, nevis tavu risinājumu, lūdzu, iesniedz pamatojumu, sazinoties ar mums izstrādātāju forumā, un mēs to izskatīsim. Ņem vērā, ka mēs nepieņemam kā pamatotas sūdzības nekonkrētus ziņojumus.
Pēdējoreiz atjaunināts: 2023. gada 24. oktobrī