Perguntas frequentes

Última atualização: 13 de janeiro de 2025

Documentação da API丨Bibliotecas e exemplos de código aberto da Interface de programação de aplicações (API) 

Quais são os limites?

Visão geral

Existem três tipos diferentes de limites, todos sujeitos a alterações a qualquer momento:

1. Limites rígidos
2. Limites de ML (Aprendizagem Automática)
3. Limites de WAF (Firewall para Aplicações Web)

Limites rígidos

• 6000 corresponde ao peso de pedido por minuto (lembra-te que isso não é necessariamente o mesmo que 6000 pedidos)
• 100 ordens a cada 10 segundos
• 200 000 ordens a cada 24 horas

Os nossos limites rígidos estão listados em: [/api/v3/ExchangeInfo] .

Limites de aprendizagem automática

O comportamento de transação é avaliado face ao utilizador médio. Se te desviares muito, serás banido por um determinado período, variando entre 5 minutos a 3 dias.

Suponha que tem um histórico de abuso de transações. A sua pontuação aumentará se: 

• Tens repetidamente "vantagem" ou "antecipas" a melhor proposta/pedido no Livro de Ordens.
• Crias e cancelas ordens muito rapidamente sem executar transações.
• A tua "taxa de conversão" é baixa. A "taxa de conversão" é definida como o teu número de transações dividido pelo total de criações e cancelamentos de ordens num período de 24 horas (Número de transações/(Ordens + Cancelamentos)).
• O teu "peso" é baixo. O "peso" é definido como a quantidade total transacionada dividida pelo total de criações e cancelamentos de ordens num período de 24 horas (Quantidade total transacionada/(Ordens + Cancelamentos)).
• Ao transacionar pares que tenham BNB como ativos de base ou de cotação, a sua pontuação de abuso será aumentada.

Não serão disponibilizadas informações mais específicas do que as identificadas acima. Utilize um sistema de tentativa e erro para alcançar o seu padrão de transação ideal ou discuta comportamento ideal com outros utilizadores da API.

Limites de firewall para aplicações Web:

Embora não forneçamos detalhes específicos sobre as nossas regras WAF, se receberes um erro HTTP 403, quebraste uma regra. Muito provavelmente, será resultado de pedidos excessivos num limite de tempo de 5 minutos. No entanto, se enviares um pedido que possa ser entendido como malicioso, pode também fazer com que sejas banido por um prazo estendido.

Se eu exceder os limites, o que será restrito: a Conta, a Chave API ou o Endereço IP?

Para os limites rígidos, exceder o limite de peso total do pedido por minuto (atualmente 6000) fará com que o teu Endereço IP seja banido. Os limites de ordens (atualmente é de 10 vezes/10 segundos e 200 000 vezes/24 horas) dependem da conta. Se o limite de ordens for excedido, estarás impedido de criar novas ordens no site (ou nas nossas outras aplicações).

Para os limites de Aprendizagem automática, as restrições serão aplicadas às contas. Se fores impedido pelo sistema ML, poderás verificar o motivo e a duração utilizando o endpoint [/sapi/v1/account/status] (registado na nossa documentação da API).

As limitações de Firewall para Aplicações Web: só serão aplicadas por IP. Normalmente, ser banido por um motivo relacionado com WAF tem uma duração de 5 minutos. No entanto, se o servidor tiver interpretado o pedido de um utilizador como malicioso, este pode ser estendido.

Fui suspendido por exceder os limites, mas corrigi o meu código. Serei aceite mais cedo?

Não. Tem de esperar até deixar de estar banido.

Porque recebi um erro HTTP 403 ao utilizar a API?

Violou as regras WAF (Firewall para Aplicações Web), provavelmente violou um limite de taxa ou enviou um pedido malicioso (conforme descrito na secção de limites deste documento). Normalmente, ser banido por um motivo relacionado com este limite tem uma duração de 5 minutos.

Porque é que as minhas ligações WebSocket estão a ser retiradas/dissociadas?

A cada 3 minutos, as ligações WebSocket ativas receberão um pingue. Se não responderes com um pingue devidamente enquadrado, a tua ligação será encerrada.

Num fluxo de dados de utilizador, se não for recebido um lembrete pelo menos uma vez a cada 60 minutos, a opção de notificação irá expirar. Este processo também está descrito na nossa documentação da API.

Estou a utilizar um serviço/proteção de terceiros, e não está a funcionar. Podem ajudar?

Infelizmente, não oferecemos apoio a serviços ou ferramentas de terceiros. Entre em contacto com o serviço e/ou programadores para obter assistência.

Além disso, é um risco de segurança introduzir as suas chaves API da Binance e/ou Chave(s) Secreta(s) numa plataforma de terceiros. Utilize estes serviços à sua discrição.

Lembre-se que também evitamos disponibilizar assistência geral de programação.

Apesar de não ter feito alterações, estou a receber erros. O que se passa?

Infelizmente, não podemos proporcionar apoio a problemas com a sua implementação pessoal. Se estiver a utilizar uma proteção/ferramenta de terceiros, entre em contacto com a equipa de apoio/desenvolvimento deles para obter assistência.

Preciso de aceder à minha Chave Secreta, mas apenas aparece "***". Como a recupero? 

Por motivos de segurança, as Chaves Secretas foram criadas para só ficarem visíveis no momento em que a chave API é criada. Depois disso permanecerá encriptada. Se a perdeste ou não a gravaste, terás de criar uma nova chave API e utilizá-la com uma nova Chave Secreta.

Posso aumentar os meus limites ou fluxos/banda larga dedicados?

Infelizmente, esta opção não está atualmente disponível... Deverá ser possível trabalhar com as limitações proporcionadas.

A minha chave API desapareceu.

Há apenas duas explicações prováveis para que uma chave API "desapareça":

• Se não estiveste ativo recentemente e se utilizaste a API antes de 7 de março de 2018, é possível que a(s) tua(s) chave(s) API tenha(m) sido eliminada(s) para garantir a segurança da tua conta.
• Se desativaste a tua conta, todas as chaves API ativas foram também eliminadas.

Poderá criar uma (ou mais) nova chave API sem problemas.

Estou a receber "Erro -1021 (Mensagem: O Carimbo de data/hora deste pedido está fora do recvWindow)". Como posso resolver isto?

Normalmente, este erro só ocorre se a hora do servidor e a hora do sistema não estiverem sincronizadas. Talvez seja necessário sincronizar o relógio do sistema. No entanto, esse processo varia dependendo do sistema operativo.

Para o Windows, e à sua discrição, pode utilizar uma ferramenta como o "Relógio atómico". Os utilizadores do Linux e do Mac podem tentar sincronizar com o "ntpdate" através da linha de comando.

Se o problema persistir, pode estar relacionado com a latência (um problema de rede). Tenta ajustar a tua recvWindow.

Posso solicitar novas funcionalidades da API?

Se não encontrares a funcionalidade que solicitaste na nossa documentação, deves assumir que não a proporcionamos. Se desejares sugerir uma funcionalidade, podes abrir um ticket de apoio e este será analisado.

Penso que há um problema com a API. Como devo comunicar?

Se pensas que há um problema com o sistema e não com a tua implementação, envia-nos provas para fundamentar a tua declaração, entrando em contacto connosco através do nosso fórum de programadores, e iremos investigar o caso. Informamos que não aceitamos mensagens vagas como reclamações legítimas.