Limiti di frequenza pubblici (dati di mercato)
Limiti di frequenza privati (gestione account)
Limiti di frequenza per il trading (presentazione/annullamento degli ordini)
Le nostre API REST e WebSocket hanno limiti di frequenza che determinano il numero massimo di chiamate effettuabili in un breve intervallo di tempo. I limiti di frequenza sono progettati per proteggere le API da attacchi (come gli attacchi DDoS) e per prevenire la manipolazione dei libri ordini (ad esempio tramite il piazzamento e la cancellazione rapida di ordini di grandi dimensioni).
I limiti di frequenza dell'API spot sono suddivisi in tre sezioni (pubblica, privata, trading) in base all'interfaccia API utilizzata (REST o WebSocket) e al tipo di chiamata effettuata (dati di mercato, gestione account, inserimento/cancellazione ordini). Per i limiti di richiesta relativi alle chiamate API futures (REST), consulta il nostro articolo di supporto qui.
Pubblico (dati di mercato REST)
Gli endpoint pubblici spot hanno limiti di frequenza basati sull'indirizzo IP e sulla coppia di valute per le chiamate a Trades e OHLC, e basati solo sull'indirizzo IP per le chiamate a tutti gli altri endpoint pubblici.
Chiamare gli endpoint pubblici con una frequenza di 1 al secondo (o inferiore) consente di restare entro i limiti di frequenza; superare questa soglia potrebbe causare il blocco delle chiamate. Se i limiti di frequenza vengono raggiunti, le chiamate aggiuntive saranno bloccate per alcuni secondi (o anche più a lungo se le chiamate continuano mentre i limiti sono attivi).
Privato (gestione account REST)
Gli endpoint privati Spot prevedono limiti di frequenza per API key basati su un contatore che parte da 0, aumenta a ogni richiesta e diminuisce nel tempo. Il contatore di ogni chiave API è indipendente: se supera il valore massimo, le chiamate successive che utilizzano quella chiave API verranno bloccate dai limiti di frequenza. Se i limiti di frequenza vengono raggiunti, le chiamate aggiuntive saranno bloccate per alcuni secondi (o anche più a lungo se le chiamate continuano mentre i limiti sono attivi).
Endpoint API | Incremento del contatore (per richiesta) |
|---|---|
Endpoint storico account (Ledgers, TradesHistory, ClosedOrders) | +4 |
Endpoint staking (Stake, Unstake) | +1 |
Tutti gli altri endpoint (Balance, TradeBalance, ecc.) | +1 |
Endpoint di trading (AddOrder, CancelOrder, ecc.) | 0 (nessun effetto sul contatore) |
Livello account | Valore massimo del contatore | Decremento del contatore (al secondo) |
|---|---|---|
Standard | 20 | -0,5 |
Limiti superiori | 20 | -1 |
Trading (REST e WebSocket – Inserimento/Cancellazione ordini)
Gli endpoint per lo spot trading (AddOrder/CancelOrder su REST API e addOrder/cancelOrder su API WebSocket) prevedono limiti di frequenza per account e coppia di valute e si basano sulle interazioni fra gli ordini registrati nel libro ordini.
In breve (la versione TLDR): ogni account e coppia di valute dispone di un numero massimo di punti utilizzabili ogni secondo senza superare i limiti di frequenza del trading. Questi punti vengono consumati durante le operazioni di presentazione, esecuzione e annullamento degli ordini e ricaricati col passare del tempo. Superare il numero di punti consentiti (in base al tipo di account) comporta la limitazione di frequenza per le chiamate successive.
Affinché gli utenti della nostra piattaforma possano calcolare il numero preciso di ordini che possono presentare/eseguire/annullare in base alla propria strategia di trading (tasso di esecuzione degli ordini, ciclo di vita degli ordini nei relativi libri, ecc.) vengono loro fornite informazioni dettagliate sui limiti di frequenza applicati al trading. Per comodità vengono illustrati esempi relativi a diversi tipi di account e strategie di trading di base, unitamente a uno strumento di calcolo per determinare i limiti di frequenza in caso di strategie più complesse.