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 evitar a manipulação dos nossos livros de ordens (por exemplo, através da colocação e cancelamento rápidos de ordens de grande dimensão).
Os limites de requisições da API Spot dividem-se em três secções (pública, privada, negociação), consoante a interface de 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 às chamadas à API de Futures (REST), consulte o nosso artigo de apoio aqui.
Pública (dados de mercado REST)
Os endpoints públicos Spot têm limites de requisições por endereço IP e par de moedas para chamadas a Trades e OHLC, e apenas por endereço IP para chamadas a todos os restantes endpoints públicos.
Chamar os endpoints públicos com uma frequência de 1 por segundo (ou inferior) mantém-se dentro dos limites de requisições; exceder esta frequência pode levar a que as chamadas fiquem sujeitas a esses limites. Se os limites de requisições forem atingidos, as chamadas adicionais serão restringidas durante alguns segundos (ou possivelmente mais, caso continuem a ser efetuadas chamadas enquanto os limites estiverem ativos).
Privada (gestão de conta REST)
Os endpoints privados 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 aos limites de requisições. Se os limites de requisições forem atingidos, as chamadas adicionais serão restringidas durante alguns segundos (ou possivelmente mais, caso continuem a ser efetuadas chamadas enquanto os limites estiverem ativos).
Endpoint de API | Incremento do contador (por pedido) |
|---|---|
Endpoints de histórico de conta (Ledgers, 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, com base na forma como as ordens interagem com o livro de ordens.
Em resumo (a versão TLDR), cada conta e par de moedas dispõe de 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. Ultrapassar o número de pontos permitido (consoante o tipo de conta) fará com que as chamadas subsequentes fiquem sujeitas ao limite de requisições.
Consulte os detalhes completos dos limites de requisições de negociação para que os negociantes possam calcular o número exato de ordens a colocar/executar/cancelar com base na sua estratégia (taxa de execução de ordens, tempo de vida das ordens no livro de ordens, etc.). São também fornecidos 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.