Bieži uzdotie jautājumi (BUJ) par API

Binance
2021-05-10 01:28

API dokumentācijaNeoficāli API 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ī:
  1. Aparatūras ierobežojumi
  2. MM (mašīnmācīšanās) ierobežojumi
  3. TLU (tīmekļa lietojumprogrammu ugunsmūra) ierobežojumi
Aparatūras ierobežojumi:
  • 1200 svērtie pieprasījumi minūtē (atceries, ka tas nav tas pats, kas 1200 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, un, ja tava tirdzniecības darbība pārlieku 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 lietojumprogrammu 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 aparatūras ierobežojumu attiecībā uz kopējo svērto pieprasījumu skaitu minūtē (pašlaik 1200) tiks bloķēta IP adrese. Orderu skaita ierobežojumu (pašlaik 50 reižu 10 sekundēs un 160 000 reižu 24 stundās) pārkāpumu gadījumā tiks bloķēts konts. Ja tiks pārsniegts orderu skaita ierobežojums, lietotājs nevarēs veidot jaunus orderus vietnē (vai citās mūsu lietojumprogrammās).
Mašīnmācīšanās ierobežojumu pārkāpumu gadījumā kontiem tiks piemēroti ierobežojumi. Ja lietotāja konta darbību ierobežoja MM sistēma, lietotājs var 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.

Es izmantojot API saņemu kļūdu "HTTP 403". Kāpēc tā?

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 ierobežojumu sadaļā). Parasti bloķēšana par šiem pārkāpumiem ilgst 5 minūtes.

Kāpēc mani WebSocket savienojumi tiek pārtraukti/atvienoti?

Uz aktīvajiem WebSocket savienojumiem ik pēc 3 minūtēm tiek nosūtīts signāls. Ja noteiktajā laikā netiek saņemts atbilstošs atbildes signāls, tavs savienojums tiek pārtraukts.
Lietotāju datu plūsmu gadījumā, ja atbildes 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 tāpat mēs nesniedzam 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ās jaunā slepenā atslēga.

Vai es varu palielināt savus 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. Palīdziet!

Ir divi iespējamie iemesli API atslēgas pazušanai:
  1. 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.
  2. Visas aktīvās API atslēgas tiek dzēstas arī tad, ja tu izvēlies atspējot savu kontu.
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 jāveic sistēmas pulksteņa sinhronizācija. Š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 nav iespējams novērst, tā var būt saistīta ar datu pārraides ātrumu (tīkla problēma), kā rezultātā var būt nepieciešama recvWindow pielāgošana.

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 domā, ka pastāv problēma ar sistēmu nevis ar tavu risinājumu, lūdzu, iesniedz pamatojumu, sazinoties ar mums mūsu Telegram API tērzētavā, un mēs to izskatīsim. Lūdzu, ņem vērā, ka mēs nepieņemam nekonkrētus ziņojumus kā pamatotas sūdzības. Ņem vērā, ka tā nav oficiālā programmēšanas atbalsta grupa, bet gan Binance API lietotāju kopienas grupa.