Limites de requisições públicas (dados de mercado)
Limites de requisições privadas (gestão de conta)
Limites de requisições de negociação (colocação/cancelamento de ordens)
As nossas APIs REST e WebSocket têm limites de requisições que afetam o número de chamadas que podem ser efetuadas num curto espaço de tempo. Os limites de requisições destinam-se a proteger as APIs contra ataques (como ataques DDoS) e a impedir a manipulação dos nossos livros de ordens (por exemplo, através da colocação e cancelamento rápido de ordens de grande volume).
Os limites de requisições da API Spot dividem-se em três secções (pública, privada, negociação), consoante a interface API utilizada (REST ou WebSocket) e o tipo de chamada efetuada (dados de mercado, gestão de conta, colocação/cancelamento de ordens). Para os limites de pedidos associados a chamadas à API de Futures (REST), consulte o nosso artigo de apoio aqui.
Pública (REST – dados de mercado)
Os endpoints públicos da API Spot têm limites de requisições por endereço IP e par de moedas para chamadas a Negociações e OHLC, e apenas por endereço IP para chamadas a todos os outros endpoints públicos.
Efetuar chamadas aos endpoints públicos com uma frequência de 1 por segundo (ou inferior) mantém-se dentro dos limites de requisições; ultrapassar esta frequência pode fazer com que as chamadas sejam sujeitas a limitação. Se os limites de requisições forem atingidos, as chamadas adicionais serão bloqueadas durante alguns segundos (ou possivelmente mais tempo, caso continuem a ser efetuadas chamadas enquanto os limites estiverem ativos).
Privada (REST – gestão de conta)
Os endpoints privados da API Spot têm limites de requisições por chave de API e baseiam-se num contador que começa em 0, aumenta a cada chamada e diminui ao longo do tempo. O contador de cada chave de API é independente; se o contador ultrapassar o valor máximo, as chamadas subsequentes com essa chave de API ficarão sujeitas ao limite de requisições. Se os limites de requisições forem atingidos, as chamadas adicionais serão bloqueadas durante alguns segundos (ou possivelmente mais tempo, caso continuem a ser efetuadas chamadas enquanto os limites estiverem ativos).
Endpoint da API | Aumento do contador (por pedido) |
|---|---|
Endpoints de histórico de conta (Livro-razão, TradesHistory, ClosedOrders) | +4 |
Endpoints de staking (Stake, Unstake) | +1 |
Todos os outros endpoints (Balance, TradeBalance, etc.) | +1 |
Endpoints de negociação (AddOrder, CancelOrder, etc.) | 0 (sem efeito no contador) |
Nível de conta | Valor máximo do contador | Diminuição do contador (por segundo) |
|---|---|---|
Padrão | 20 | -0,5 |
Limites superiores | 20 | -1 |
Negociação (REST e WebSocket – colocação/cancelamento de ordens)
Os endpoints de negociação à vista (REST AddOrder/CancelOrder e WebSocket addOrder/cancelOrder) têm limites de requisições por conta e por par de moedas, baseados na forma como as ordens interagem com o livro de ordens.
Em resumo (versão TLDR), cada conta e par de moedas tem um número máximo de pontos que podem ser utilizados por segundo sem atingir os limites de requisições de negociação. Colocar, executar e cancelar ordens consome estes pontos, que são repostos ao longo do tempo. Utilizar mais pontos do que o permitido (consoante o tipo de conta) fará com que as chamadas subsequentes fiquem sujeitas aos limites de requisições.
Os detalhes completos dos limites de requisições de negociação estão disponíveis para que os negociantes possam calcular o número exato de ordens que podem colocar, executar ou cancelar com base na sua estratégia (taxa de execução, tempo de vida da ordem no livro de ordens, etc.). São disponibilizados exemplos para diferentes tipos de conta e estratégias de negociação básicas, bem como uma calculadora de limites de requisições para estratégias mais complexas.