Limiti di frequenza pubblici (dati di mercato)
Limiti di frequenza privati (gestione account)
Limiti di frequenza di trading (inserimento/annullamento ordini)
Le nostre API REST e WebSocket hanno limiti di frequenza che influenzano il numero di chiamate che possono essere effettuate in un breve lasso di tempo. I limiti di frequenza sono progettati per proteggere le API da attacchi (come gli attacchi DDoS) e per prevenire la manipolazione dei nostri registri ordini (come l'inserimento e l'annullamento rapido di ordini di grandi dimensioni).
I limiti di frequenza dell'API Spot sono divisi in tre sezioni (pubblica, privata, 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), si prega di consultare il nostro articolo di supporto qui.
Pubblico (dati di mercato REST)
Gli endpoint pubblici Spot sono soggetti a limiti di frequenza 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, ma superare questa frequenza potrebbe causare la limitazione delle chiamate. Se i limiti di frequenza 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).
Privato (gestione account REST)
Gli endpoint privati Spot sono soggetti a limiti di frequenza per chiave API e si basano su un contatore che parte da 0, aumenta con 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 verrebbero limitate. Se i limiti di frequenza 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 contatore (per richiesta) |
|---|---|
Endpoint cronologia 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 contatore (al secondo) |
|---|---|---|
Verificato | 20 | -0.5 |
Verificato con limiti più elevati | 20 | -1 |
Trading (REST e WebSocket per l'inserimento/annullamento di ordini)
Gli endpoint di trading Spot (REST AddOrder/CancelOrder e WebSocket addOrder/cancelOrder) sono soggetti a limiti di frequenza per account e per coppia di valute, e si basano su come gli ordini interagiscono con il book degli ordini.
In breve (la versione concisa), ogni account e coppia di valute ha un numero massimo di punti che possono essere utilizzati ogni secondo senza raggiungere i limiti di frequenza 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 la limitazione delle chiamate successive.
Dettagli completi sui limiti di frequenza 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 nel book degli ordini, ecc.). Esempi per diversi tipi di account e strategie di trading di base sono forniti per comodità, insieme a un calcolatore dei limiti di frequenza per determinare i limiti di frequenza per strategie più complesse.