Mensagens de Erro Comuns de Bot e Ordem (e o Que Significam)
Quando um bot não consegue fazer algo, ele exibe uma mensagem curta — mas nem sempre é óbvio o que fazer a respeito. Este é um guia de consulta rápida: encontre a mensagem que você viu, entenda o que significa e saiba se é algo que você corrige ou algo que a exchange resolve sozinha. Para aprofundamentos, cada grupo traz um link para o guia de troubleshooting dedicado.
Key Takeaways
- A maioria dos erros se enquadra em algumas categorias: saldo/margem, chave de API, alavancagem/modo de margem, limites de ordem, pares deslistados, colocação de ordens de saída e instabilidades temporárias da exchange.
- Muitas mensagens vêm do lado da exchange e não são culpa sua (modo somente-cancelamento, limites de taxa, timeouts) — a Freya tenta novamente de forma automática.
- As que você corrige normalmente são saldo, tamanho da ordem, permissões de API ou configurações de alavancagem/margem.
- Se uma mensagem disser “verifique sua posição manualmente”, sua posição pode estar desprotegida — defina seu take-profit/stop-loss na exchange imediatamente.
- Erros persistentes ou não reconhecidos → entre em contato com [email protected] informando os detalhes do bot e do deal.
Saldo e Margem
| Mensagem que você vê | O que significa | O que fazer |
|---|---|---|
| "Saldo insuficiente. Verifique os fundos da sua conta." | Não há fundos livres suficientes na exchange para esta ordem. | Adicione fundos na exchange ou reduza o valor da ordem do bot. |
| "Margem insuficiente. Reduza o tamanho da posição ou adicione margem." | Futuros: margem insuficiente para a posição nesta alavancagem. | Adicione margem, reduza o tamanho da posição ou ajuste a alavancagem. |
| "Valor da ordem muito pequeno. Aumente o valor do seu bot." | Abaixo do tamanho mínimo de ordem do par. | Aumente o valor do bot acima do mínimo do par. |
➡️ Aprofunde-se: Por Que Meu Bot Pausou ou Parou? e Quanto Capital Seu Bot Precisa.
Chave de API e Permissões
| Mensagem que você vê | O que significa | O que fazer |
|---|---|---|
| "Erro na chave de API. Verifique se sua chave de API é válida e tem permissões de trading." | A chave é inválida, foi revogada ou não tem permissão de trade. | Verifique novamente ou recrie a chave com trading habilitado. |
| "A chave de API está restrita por IP. Adicione o IP do servidor à sua whitelist." | A lista de IPs permitidos da chave não inclui o IP do servidor da Freya. | Adicione o IP exibido na tela de conexão à whitelist da chave. |
➡️ Aprofunde-se: Não Consegue Conectar Sua Exchange? Erros de Chave de API.
Alavancagem e Modo de Margem (Futuros)
| Mensagem que você vê | O que significa | O que fazer |
|---|---|---|
| "Valor de alavancagem inválido. Verifique as configurações da sua exchange." | A alavancagem não é aceita para este par. | Escolha uma alavancagem dentro da faixa permitida do par. |
| "O valor da posição excede o máximo permitido para esta alavancagem. Reduza a alavancagem ou o tamanho da posição." | O valor nocional é grande demais para o nível de alavancagem escolhido. | Reduza a alavancagem ou o tamanho da posição. |
| "Incompatibilidade de modo de posição. Verifique as configurações de modo Hedge/One-Way." | A direção do bot conflita com o modo de posição da sua exchange. | Alinhe o modo Hedge/One-Way da exchange com o bot — veja Modo Hedge vs One-Way. |
| "O modo multi-ativo conflita com a margem isolada. Mude para margem cruzada ou desative o modo multi-ativo." | A margem multi-ativo não pode ser combinada com margem isolada. | Mude para margem cruzada ou desligue o modo multi-ativo na exchange. |
➡️ Relacionado: Tipo de Margem: Cruzada vs Isolada · Modo Hedge vs One-Way.
Problemas com Ordens
| Mensagem que você vê | O que significa | O que fazer |
|---|---|---|
| "Número máximo de ordens abertas atingido. Feche algumas ordens primeiro." | Você atingiu o limite de ordens abertas da exchange. | Cancele algumas ordens abertas e tente novamente. |
| "O preço da ordem se desvia demais do preço de mercado. Tente novamente." | Um preço limite está fora da faixa permitida pela exchange em relação ao mercado. | Tente novamente; para uma entrada limite, defina um preço mais próximo do mercado. |
| "Ordem reduce-only rejeitada. A posição pode já estar fechada." | Uma ordem somente-de-fechamento foi rejeitada — normalmente não há mais nada a fechar. | Verifique a posição na exchange; ela provavelmente já está fechada. |
| "O mercado está em modo somente-cancelamento. Novas ordens não podem ser colocadas agora." | A exchange colocou o mercado em modo somente-cancelamento (manutenção/liquidação). | Aguarde — isso se resolve quando a exchange reabrir. Não é culpa sua. |
| "Ordem não encontrada na exchange. Ela pode ter sido executada ou cancelada." | A ordem referenciada não existe mais. | Geralmente inofensivo — ela foi executada ou cancelada. Verifique o deal. |
➡️ Aprofunde-se (problemas de fechamento): Meu Deal Não Fecha.
Par de Trading (Deslistagem)
| Mensagem que você vê | O que significa | O que fazer |
|---|---|---|
| "Par de trading não encontrado. Ele pode ter sido deslistado da exchange." | O par foi removido ou renomeado na exchange. | Mude o bot para um par ativo e listado. |
| "Par de trading não encontrado na exchange. Ele pode ter sido deslistado." | A exchange informa que o instrumento não existe. | Escolha um par atualmente listado. |
Essas são mudanças do lado da exchange, não culpa sua — se uma exchange deslista uma moeda, nenhum bot consegue continuar operando com ela.
Colocação de Ordens de Saída ("Verifique Sua Posição Manualmente")
| Mensagem que você vê | O que significa | O que fazer |
|---|---|---|
| "Falha ao colocar a ordem de take profit/stop loss. Verifique sua posição manualmente." | Sua entrada foi executada, mas a proteção de saída não pôde ser colocada — sua posição pode estar desprotegida. | Defina você mesmo o take-profit/stop-loss na exchange agora e depois verifique o bot. |
| "Falha ao atualizar TP/SL após execução de DCA. Verifique sua posição manualmente." | Após a execução de uma ordem de segurança, a saída não pôde ser atualizada para a nova média. | Confirme se seus níveis de saída refletem a nova média de entrada. |
| "Sua ordem de saída (TP/SL) foi cancelada fora da Freya Finance. Sua posição não está mais protegida." | Uma ordem de saída foi cancelada na exchange, fora da Freya. | Reproteja a posição (defina TP/SL) ou feche-a. |
Qualquer mensagem de “verifique sua posição manualmente” significa que uma posição pode estar rodando sem sua proteção de saída. Abra sua exchange, confirme a posição e defina você mesmo o stop-loss / take-profit até que o bot possa assumir novamente.
Instabilidades Temporárias (a Freya Tenta Novamente)
| Mensagem que você vê | O que significa | O que fazer |
|---|---|---|
| "Limite de taxa da exchange atingido. Tentará novamente de forma automática." | Requisições em excesso; throttle por um breve período. | Nada — a Freya tenta novamente sozinha. |
| "A conexão com a exchange expirou. Tente novamente." | Uma requisição não foi concluída a tempo. | Aguarde um momento; normalmente se resolve. |
| "Erro de conexão de rede. Tente novamente." | Uma falha de rede ao alcançar a exchange. | Tente novamente em instantes. |
| "Erro de sincronização do horário do servidor. Isso geralmente se resolve automaticamente." | Um desvio de relógio/timestamp em relação à exchange. | Costuma se autocorrigir; nenhuma ação. |
| "O servidor da exchange está ocupado. Tente novamente em um instante." | A exchange retornou uma resposta de ocupado/indisponível. | Aguarde e tente novamente. Não é culpa sua. |
Ainda Travado?
Se você vir "Ocorreu um erro inesperado na exchange. Verifique sua posição manualmente." ou "Erro interno do sistema. Tente novamente ou entre em contato com o suporte." — verifique sua posição na exchange e, se o problema persistir, entre em contato com [email protected] informando os detalhes do bot e do deal. Para liquidação especificamente, veja Entendendo a Liquidação.
Perguntas Frequentes
Meu bot exibiu um erro — é culpa da plataforma?
Depende da mensagem. Erros de saldo, tamanho da ordem, chave de API e alavancagem/margem normalmente são configurações que você corrige. Modo somente-cancelamento, limites de taxa, timeouts, pares deslistados e "servidor ocupado" vêm do lado da exchange e não são culpa sua — a Freya tenta novamente os temporários de forma automática.
O que significa "verifique sua posição manualmente"?
Significa que sua entrada foi executada, mas a Freya não conseguiu colocar ou atualizar a proteção de saída, então a posição pode estar rodando sem stop-loss ou take-profit. Abra sua exchange, confirme a posição e defina você mesmo os níveis de saída imediatamente — depois verifique o bot.
Recebi "saldo insuficiente" mas tenho fundos — por quê?
Seus fundos podem não estar livres (já comprometidos com outras ordens/posições), estar na subconta errada ou estar abaixo do que a ordem precisa depois de incluídas as taxas. Libere saldo ou reduza o valor da ordem do bot. Veja Por Que Meu Bot Pausou ou Parou?
Meu par diz que foi deslistado — e agora?
A exchange removeu ou renomeou aquele par de trading, então nenhum bot consegue mais operá-lo. Mude o bot para um par atualmente listado. Isso é uma mudança da exchange, não um problema da Freya.
O erro diz "limite de taxa / timeout / servidor ocupado" — preciso fazer algo?
Não. Essas são condições temporárias do lado da exchange, e a Freya tenta novamente de forma automática. Se um bot continuar travado muito tempo depois que a exchange se recuperar, verifique seu status e entre em contato com o suporte se necessário.
Onde consigo ajuda detalhada para erros de chave de API ou de fechamento?
Para erros de chave de API / IP / permissão, veja Não Consegue Conectar Sua Exchange? Para posições que não fecham ou ordens remanescentes, veja Meu Deal Não Fecha. Para saber por que um bot parou, veja Por Que Meu Bot Pausou ou Parou?