Limiti di frequenza (rate limits) pubblici (dati di mercato)
Limiti di frequenza (rate limits) privati (gestione account)
Limiti di frequenza (rate limits) di trading (inserimento/annullamento ordini)
Le nostre API REST e WebSocket hanno limiti di frequenza (rate limits) che influenzano il numero di chiamate che possono essere effettuate in un breve periodo di tempo. I limiti di frequenza (rate limits) sono progettati per proteggere le API da attacchi (come gli attacchi DDoS) e per prevenire la manipolazione dei nostri order book (ad esempio, inserendo e annullando rapidamente ordini di grandi dimensioni).
I limiti di frequenza (rate limits) delle API Spot sono suddivisi in tre sezioni (pubbliche, private, di trading) a seconda dell'interfaccia API utilizzata (REST o WebSocket) e del tipo di chiamata effettuata (dati di mercato, gestione account, inserimento/annullamento ordini). Per i limiti di richiesta associati alle chiamate API Futures (REST), La preghiamo di consultare il nostro articolo di supporto qui.
Pubblici (dati di mercato REST)
Gli endpoint pubblici Spot sono soggetti a limiti di frequenza (rate limits) per indirizzo IP e coppia di valute per le chiamate a Trades e OHLC, e solo per indirizzo IP per le chiamate a tutti gli altri endpoint pubblici.
Chiamare gli endpoint pubblici con una frequenza di 1 al secondo (o meno) rientrerebbe nei limiti di frequenza (rate limits), ma superare questa frequenza potrebbe causare l'applicazione dei limiti di frequenza alle chiamate.
Se i limiti di frequenza (rate limits) vengono raggiunti, le chiamate aggiuntive verrebbero limitate per alcuni secondi (o possibilmente più a lungo se le chiamate continuano a essere effettuate mentre i limiti di frequenza sono attivi).
Privati (gestione account REST)
Gli endpoint privati Spot sono soggetti a limiti di frequenza (rate limits) per chiave API e si basano su un contatore che parte da 0, aumenta a ogni chiamata e diminuisce nel tempo. Il contatore di ogni chiave API è separato e, se il contatore supera il valore massimo, le chiamate successive che utilizzano quella chiave API sarebbero soggette a limiti di frequenza. Se i limiti di frequenza (rate limits) vengono raggiunti, le chiamate aggiuntive verranno limitate per alcuni secondi (o possibilmente più a lungo se le chiamate continuano a essere effettuate mentre i limiti di frequenza sono attivi).
Endpoint API | Aumento del contatore (per richiesta) |
|---|---|
Endpoint della cronologia dell'account (Ledgers, TradesHistory, ClosedOrders) | +4 |
Endpoint di Staking (Stake, Unstake) | +1 |
Tutti gli altri endpoint (Balance, TradeBalance, ecc.) | +1 |
Endpoint di trading (AddOrder, CancelOrder, ecc.) | 0 (nessun effetto sul contatore) |
Livello di verifica dell'account | Valore massimo del contatore | Diminuzione del contatore (al secondo) |
|---|---|---|
Verificato | 20 | -0.5 |
Verificato con limiti più elevati | 20 | -1 |
Trading (inserimento/annullamento ordini REST e WebSocket)
Gli endpoint di trading Spot (REST AddOrder/CancelOrder e WebSocket addOrder/cancelOrder) sono soggetti a limiti di frequenza (rate limits) per account e per coppia di valute, e si basano su come gli ordini interagiscono con l'order book.
In breve (la versione TLDR), ogni account e coppia di valute ha un numero massimo di punti che possono essere utilizzati ogni secondo senza raggiungere i limiti di frequenza (rate limits) di trading. L'inserimento, l'esecuzione e l'annullamento degli ordini utilizzano questi punti, mentre il tempo li ripristina. L'utilizzo di più punti del consentito (in base al tipo di account) causerebbe l'applicazione dei limiti di frequenza alle chiamate successive.
Dettagli completi sui limiti di frequenza (rate limits) di trading sono forniti in modo che i nostri trader possano calcolare il numero preciso di ordini che possono inserire/eseguire/annullare in base alla loro strategia di trading (tasso di riempimento degli ordini, durata dell'ordine sull'order book, ecc.). Esempi per diversi tipi di account e strategie di trading di base sono forniti per comodità, insieme a un calcolatore di limiti di frequenza (rate limits) per determinare i limiti di frequenza per strategie più complesse.