Care sunt limitele de rată ale API?

Ultima actualizare: 1 octombrie 2026

API-urile noastre REST și WebSocket au limite de rată care afectează numărul de apeluri ce pot fi efectuate într-un interval scurt de timp. Limitele de rată sunt concepute pentru a proteja API-urile împotriva atacurilor (cum ar fi atacurile DDoS) și pentru a preveni manipularea registrelor de ordine (de exemplu, prin plasarea și anularea rapidă a unor ordine de volum mare).

Limitele de rată ale API-ului Spot sunt împărțite în trei secțiuni (publică, privată, tranzacționare), în funcție de interfața API utilizată (REST sau WebSocket) și de tipul apelului efectuat (date de piață, gestionarea contului, plasarea/anularea ordinelor). Pentru limitele de solicitare asociate apelurilor API pentru contracte futures (REST), consultă articolul nostru de suport aici.

Public (date de piață REST)

Endpointurile publice Spot au limite de rată stabilite pe baza adresei IP și a perechii de monede pentru apelurile către Trades și OHLC, respectiv doar pe baza adresei IP pentru toate celelalte endpointuri publice.

Apelarea endpointurilor publice cu o frecvență de cel mult 1 pe secundă se încadrează în limitele de rată, însă depășirea acestei frecvențe poate determina restricționarea apelurilor. Dacă limitele de rată sunt atinse, apelurile suplimentare vor fi restricționate pentru câteva secunde (sau mai mult dacă apelurile continuă în timp ce limitele de rată sunt active).

Privat (gestionarea contului REST)

Endpointurile private Spot au limite de rată stabilite pe baza cheii API și funcționează pe baza unui contor care pornește de la 0, crește cu fiecare apel și scade în timp. Contorul fiecărei chei API este independent; dacă depășește valoarea maximă, apelurile ulterioare efectuate cu acea cheie API vor fi restricționate. Dacă limitele de rată sunt atinse, apelurile suplimentare vor fi restricționate pentru câteva secunde (sau mai mult dacă apelurile continuă în timp ce limitele de rată sunt active).

Endpoint API	Creșterea contorului (per solicitare)
Endpointuri pentru istoricul contului (Ledgers, TradesHistory, ClosedOrders)	+4
Endpointuri pentru staking (Stake, Unstake)	+1
Toate celelalte endpointuri (Balance, TradeBalance etc.)	+1
Endpointuri de tranzacționare (AddOrder, CancelOrder etc.)	0 (fără efect asupra contorului) Vezi detalii despre limitele de rată pentru tranzacționare

Nivel cont	Valoare maximă contor	Scădere contor (pe secundă)
Standard	20	-0.5
Limite superioare	20	-1

Tranzacționare (REST și WebSocket – Plasare/Anulare ordine)

Endpoint-urile de tranzacționare Spot (REST AddOrder/CancelOrder și WebSocket addOrder/cancelOrder) au limite de rată per cont și per pereche de monede, bazate pe modul în care ordinele interacționează cu registrul de ordine.

Pe scurt (TL;DR), fiecare cont și pereche de monede are un număr maxim de puncte utilizabile pe secundă fără a atinge limitele de rată pentru tranzacționare. Plasarea, executarea și anularea ordinelor consumă aceste puncte, iar trecerea timpului le reîncarcă. Dacă folosești mai multe puncte decât sunt permise (în funcție de tipul contului tău), apelurile ulterioare vor fi limitate de rată.

Detaliile complete ale limitelor de rată pentru tranzacționare sunt disponibile pentru ca traderii să poată calcula numărul exact de ordine pe care le pot plasa/executa/anula în funcție de strategia lor de tranzacționare (rata de onorare a ordinelor, durata ordinului în registrul de ordine etc.). Sunt disponibile exemple pentru diferite tipuri de conturi și strategii de bază de tranzacționare, împreună cu un calculator al limitelor de rată pentru strategii mai complexe.