Limiti di frequenza API pubblici (dati di mercato)
Limiti di frequenza API privati (gestione account)
Limiti di frequenza API 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 order book (ad esempio, inserendo e annullando rapidamente ordini di grandi dimensioni).
I limiti di frequenza delle API Spot sono divisi in tre sezioni (pubbliche, private, di trading) a seconda dell'interfaccia API utilizzata (REST o WebSocket) e del tipo di chiamata che viene 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.
API pubbliche (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 l'applicazione dei limiti di frequenza alle 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).
API private (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 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 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 superiori | 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 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 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 di limiti di frequenza alle 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 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 per determinare i limiti di frequenza per strategie più complesse.