Documentação da API丨Bibliotecas e exemplos de código aberto da API
Quais são os limites?
Visão Geral
Há três tipos diferentes de limites, todos sujeitos a alterações a qualquer momento:
- Limites Fixos (Hard Limits)
- Limites ML (Machine Learning)
- Limites WAF (Web Application Firewall)
Limites Fixos (Hard Limits)
- Peso de 6.000 solicitações por minuto (tenha em mente que isso não é necessariamente o mesmo que 6.000 solicitações)
- 50 ordens em 10 segundos
- 160.000 ordens em 24 horas
Nossos hard limits são listados no endpoint [/api/v3/exchangeInfo] .
Limites de Machine Learning (Aprendizado de Máquina)
O comportamento de trading é avaliado comparando ao usuário médio. Se você desviar muito, você será banido por um determinado período de tempo, variando de 5 minutos a 3 dias.
Suponhamos que você tenha uma pontuação de trading abusiva. Sua pontuação aumentará se :
- Você repetidamente "aumenta" ou "antecipa" o melhor lance / pedido no livro de ordens.
- Seu processo de criação e cancelamento de ordens de spam é muito rápido e não resulta em execução de trades.
- Sua "taxa de conversão" é baixa. "Taxa de conversão" é definida como o seu número de trades dividido pelo total de ordens criadas e canceladas no período de 24 horas (Número de Trades/ (Ordens + Cancelamentos)).
- Seu "peso" é baixo. "Peso" é definido como sua quantidade total de trade dividido pelo total de ordens criadas e canceladas no período de 24 horas (Quantidade Total de Trades / (Ordens + Cancelamentos)).
- Quando os pares de trading tiverem como base o BNB ou cotação de ativos, sua pontuação de abuso será amplificada.
Informações mais específicas além das prestadas acima não serão fornecidas. Por favor, utilize tentativa e erro para atingir o padrão de trading ideal, ou discuta o comportamento ideal com outros usuários de API.
Limites WAF (Web Application Firewall):
Embora não forneçamos detalhes exatos sobre as regras do nosso WAF, se você receber o erro HTTP 403, você quebrou a regra. Muito provavelmente, será resultado de solicitações excessivas dentro de um período de 5 minutos. No entanto, se você estiver enviando uma solicitação que possa ser compreendida como maliciosa, isso também pode resultar em um banimento por um período mais longo.
Se eu exceder os limites, terei restrições na Conta, Chave API ou Endereço IP?
Para os hard-limits, exceder o limite total de peso de solicitações por minuto (atualmente 6.000) resultará no banimento do IP. Os limites de ordem (atualmente de 50 vezes/10 segundos e 160.000 vezes/24 horas) dependerá da conta. Se o limite de ordem for excedido, você também sofrerá a restrição para criar novas ordens no site (ou em nossos outros aplicativos).
Para limites de Machine Learning (Aprendizado de Máquina), as restrições serão aplicadas às contas. Se você foi restringido pelo sistema de ML, você pode verificar o motivo e a duração utilizando o endpoint [/sapi/v1/account/status] (que consta na Documentação da API).
As limitações WAF serão aplicados ao IP. Normalmente, uma proibição WAF possui a duração de 5 minutos. No entanto, se o servidor interpretar que a solicitação de um usuário foi maliciosa, ela poderá ser estendida.
Eu sofri uma restrição por exceder o limites, mas arrumei meu código. Você irá tirar a banição mais cedo?
Não. Você deve aguardar o término do banimento.
Por que eu recebi um erro HTTP 403 ao usar o API?
Você violou as regras WAF (Web Application Firewall), provavelmente por violar o limite de taxa ou enviar solicitações maliciosas (conforme descrito na seção de limites deste documento). Normalmente, esses banimentos duram o período de 5 minutos.
Por que minhas conexões WebSocket são derrubadas/desconectadas?
A cada 3 minutos, as conexões ativas de WebSocket receberão um ping. Caso você não responda com um ping adequado, a sua conexão será encerrada.
Para o fluxo de dados do usuário, se um keep-alive não for recebido pelo menos a cada 60 minutos, a chave listada expirará. Isso também está detalhado em nossa Documentação da API.
Eu estou usando serviço/wrapper de terceiro, e não está funcionando. Você pode me ajudar?
Infelizmente, não oferecemos suporte para serviços ou ferramentas de terceiros. Por favor, entre em contato com o serviço e/ou desenvolvedores para obter assistência.
Além disso, é um risco secundário inserir sua(s) chave(s) da Binance API e/ou Chave(s) Secreta(s) numa plataforma de terceiros. Utilize os serviços a seu próprio risco.
Mantenha em mente que também evitamos fornecer assistência de programação geral.
Mesmo não tendo alterado nada, de repente passei a receber erros. O que ocorreu?
Infelizmente, não podemos fornecer suporte para esses problemas da sua implementação pessoal. Se você estiver utilizando ferramentas/wrapper de terceiros, entre em contato com a equipe de suporte/desenvolvimento deles para obter assistência.
Eu preciso acessar minha Chave Secreta, mas aparece como "***". Como faço para recuperá-la?
Por motivos de segurança, por padrão, as Chaves Secretas são visíveis apenas no momento da criação da Chave API. Qualquer momento posterior a este, ela será mascarada. Se você a perdeu, ou não a registrou, você precisará criar uma nova Chave API e utilizar a nova chave como sendo a nova Chave Secreta.
Eu posso aumentar meus limites ou largura de fluxos/bandas?
Infelizmente, não oferecemos essa opção no momento. Você deve trabalhar com as limitações fornecidas.
Minha Chave API desapareceu.
Há duas explicações prováveis para uma Chave API "desaparecer":
- Se você não esteve ativo recentemente e utilizou a API antes de 7 de março de 2018, é possível que a(s) sua(s) Chave(s) API foi(ram) desligada(s) da sua conta por motivos de segurança.
- Se você desativou sua conta, isso resultaria na exclusão de toda e qualquer Chave API ativa.
Você pode criar nova(s) Chave(s) API sem qualquer problema.
Estou recebendo "Error -1021 (Mensagem: Tempo para esta solicitação está fora do recvWindow)". Como posso resolver isso?
Normalmente, esse erro apenas ocorre se a hora do servidor e a hora do sistema não estiverem sincronizadas. Você precisará sincronizar o relógio do seu sistema. No entanto, este processo varia dependendo do sistema operacional.
Para o Windows, a seu próprio critério, você pode utilizar a ferramenta "Atomic Clock". Os usuários de Linux e Mac podem tentar sincronizar com "ntpdate" através do command line.
Se o problema persistir, pode estar relacionado à latência (um problema de rede). Tente ajustar seu recvWindow.
Eu posso solicitar novas funcionalidades da API?
Caso não consiga visualizar as funcionalidades que você solicitou na documentação, é provável que elas não estejam disponíveis. Se quiser sugerir um recurso, você pode abrir um ticket de suporte. Analisaremos a sugestão enviada.
Eu acredito que há um problema com a API. Como eu posso relatar isso?
Se você acha que há um problema com o sistema e não com sua implementação, forneça evidências para apoiar sua reivindicação entrando em contato conosco em nosso fórum de desenvolvedores e nós investigaremos. Observe que não aceitamos mensagens vagas como reclamações legítimas.
Última atualização em 24 de outubro de 2023