Principais mensagens de erro da Hyperliquid explicadas
Ao operar na Hyperliquid, é comum encontrar mensagens de erro ocasionais. Muitas delas são curtas e não explicam o motivo em detalhes, o que pode confundir principalmente quem está usando a plataforma pela primeira vez.
Neste guia, reunimos os erros mais comuns da Hyperliquid, explicamos o que eles significam e mostramos como você pode resolver cada situação.
Visão geral dos tipos de erro
Os erros da Hyperliquid geralmente se encaixam em quatro categorias:
- Status da conta: margem insuficiente, conta não inicializada, entre outros
- Parâmetros da ordem: preço fora do intervalo, tamanho inválido etc.
- Contrato ou par de negociação: mercado pausado, limite de posição excedido etc.
- Conexão e assinatura: falha na assinatura da carteira, timeout de conexão etc.
Erros relacionados ao status da conta
"Insufficient margin" / Margem insuficiente
O que significa: ao enviar uma ordem, a margem disponível na conta não é suficiente para cobrir a margem inicial exigida pela posição.
Como resolver:
- Reduza o tamanho da ordem
- Use uma alavancagem menor
- Deposite mais USDC na conta
- Feche parte das posições existentes para liberar margem
A lógica de cálculo de margem pode ser consultada na documentação da Hyperliquid. Entender a diferença entre margem cruzada e margem isolada ajuda a prever quando esse erro pode aparecer.
"Account not found" / Conta não encontrada
O que significa: o endereço da carteira ainda não possui um registro inicializado na Hyperliquid. Isso costuma acontecer no primeiro uso.
Como resolver: faça o primeiro depósito e assine as transações necessárias de inicialização. Depois disso, a conta será ativada. Verifique também se você está usando o endereço correto da carteira.
"Leverage too high" / Alavancagem acima do limite
O que significa: a alavancagem definida é maior do que o máximo permitido para aquele par de negociação.
Como resolver: antes de enviar a ordem, confira o limite máximo de alavancagem do par e ajuste para um valor permitido.
Erros relacionados aos parâmetros da ordem
"Price out of range" / Preço fora do intervalo
O que significa: o preço enviado em uma ordem limite está distante demais do preço de marcação atual e ultrapassa o intervalo permitido pelo protocolo.
Como resolver: ajuste o preço da ordem limite para mais perto do preço de mercado. A Hyperliquid aplica limites de desvio em ordens pendentes para evitar envios acidentais com preços extremos.
"Size too small" / Tamanho muito pequeno
O que significa: o tamanho da ordem está abaixo da unidade mínima de negociação daquele par.
Como resolver: aumente a quantidade da ordem ou escolha um par com unidade mínima menor.
"Invalid order type" / Tipo de ordem inválido
O que significa: a combinação de parâmetros da ordem é inválida. Por exemplo, determinado tipo de ordem pode ter sido usado em uma condição de mercado que não o suporta.
Como resolver: revise os parâmetros da ordem e confirme se o tipo escolhido é compatível com o estado atual do mercado.
Erros relacionados a contratos e pares de negociação
"Market is paused" / Mercado pausado
O que significa: o par de negociação está temporariamente pausado. Isso pode ocorrer por manutenção do protocolo, mecanismo de proteção contra anomalias de preço ou outros motivos operacionais.
Como resolver: aguarde a normalização do mercado. Acompanhe os anúncios oficiais da Hyperliquid para verificar o status mais recente. Em geral, posições já abertas permanecem inalteradas durante a pausa do mercado.
"Position size limit exceeded" / Limite de posição excedido
O que significa: o valor nocional da posição da conta naquele par atingiu o limite definido pelo protocolo.
Como resolver: reduza o tamanho da nova ordem ou feche parte da posição antes de operar novamente. Esse limite existe para reduzir o risco de manipulação de mercado por uma única conta.
"Max open orders exceeded" / Limite de ordens abertas excedido
O que significa: a conta atingiu o número máximo de ordens em aberto, seja em um par específico ou no limite global.
Como resolver: cancele ordens pendentes que não são mais necessárias e tente enviar a nova ordem depois de liberar espaço.
Erros de conexão e assinatura
"Signature invalid" / Assinatura inválida
O que significa: a verificação da assinatura da carteira falhou. Possíveis causas incluem assinatura expirada, troca de conta na carteira ou dados de assinatura incompletos por instabilidade de rede.
Como resolver:
- Atualize a página e solicite a assinatura novamente
- Desconecte e reconecte a carteira
- Verifique se a conta selecionada na carteira é a mesma vinculada à Hyperliquid
Ao usar a carteira OneKey, cada solicitação de assinatura mostra claramente os detalhes da operação no dispositivo, facilitando a conferência e reduzindo o risco de assinar algo inesperado. O padrão de assinatura estruturada EIP-712 permite que o usuário veja dados em um formato mais legível, em vez de apenas um hash.
"Wallet not connected" / Carteira não conectada
O que significa: a interface não detecta uma carteira conectada.
Como resolver: conecte a carteira novamente na página. Se estiver usando WalletConnect com uma carteira mobile, confira se a sessão ainda está ativa e consulte a documentação do WalletConnect para os passos de reconexão.
"Transaction rejected" / Transação rejeitada
O que significa: o usuário recusou manualmente a solicitação de assinatura na carteira ou a assinatura expirou por timeout.
Como resolver: envie a operação novamente e confirme a solicitação de assinatura na carteira dentro do tempo disponível.
Erros relacionados a fundos
"Withdrawal amount exceeds available balance" / Valor de saque excede o saldo disponível
O que significa: o valor solicitado para saque é maior do que o saldo disponível, ou parte dos fundos está comprometida com margem de posições ainda abertas ou não liquidadas.
Como resolver: verifique o PnL não realizado, a margem em uso e o saldo realmente disponível para saque. Depois, tente novamente com um valor compatível. O painel de saldo do Hyperliquid App pode ajudar nessa conferência.
Checklist rápido de diagnóstico
Para evitar erros recorrentes ao operar na Hyperliquid:
- Antes de abrir uma ordem, confira o saldo de margem e a alavancagem configurada
- Use um navegador estável e evite deixar solicitações de assinatura expirarem
- Acesse a Hyperliquid por meio do OneKey Perps para ter um fluxo de assinatura mais claro e estável com a carteira OneKey, reduzindo erros causados pela camada da carteira
- Salve o Discord oficial da Hyperliquid para consultar respostas da equipe em caso de erros desconhecidos
Perguntas frequentes
Q1: Se aparecer um erro, meus fundos podem ser perdidos?
Normalmente, não. A maioria dos erros apenas indica que a operação não foi executada, então os fundos permanecem na conta. Porém, se o evento for uma liquidação, a margem pode ser parcial ou totalmente consumida. Liquidação não é uma mensagem de erro, mas parte normal do mecanismo de risco em contratos perpétuos.
Q2: O que fazer se o mesmo erro continuar aparecendo?
Anote a mensagem de erro e os passos que levaram ao problema. Em seguida, descreva o caso na comunidade oficial da Hyperliquid ou entre em contato pelo canal de suporte disponível no Hyperliquid App.
Q3: Se houver erro no saque, meus fundos ficam bloqueados?
Na maioria dos casos, não. Uma falha no saque geralmente significa que a operação não foi enviada ou não foi concluída, então os fundos continuam na conta. Aguarde alguns minutos e tente novamente. Se persistir, procure o suporte oficial.
Q4: Como saber se o problema foi causado por uma ação minha ou por um bug do protocolo?
Você pode verificar os dados on-chain para confirmar se a operação foi registrada. Se não houver nenhum registro on-chain, é mais provável que seja um problema do cliente, da interface ou da carteira. Se houver registro on-chain e o resultado parecer inconsistente, vale reportar o caso à equipe oficial.
Q5: MetaMask ou OneKey: qual é mais estável na Hyperliquid?
Ambas são suportadas. A OneKey é totalmente open source, com código disponível no OneKey GitHub, e oferece uma interface de assinatura transparente. Para usuários que valorizam auditoria, clareza e segurança operacional, isso pode trazer uma camada extra de confiança.
Conclusão
Encontrar uma mensagem de erro na Hyperliquid não significa necessariamente que algo grave aconteceu. Na maioria dos casos, são situações conhecidas com soluções claras. Usando as categorias acima, você normalmente consegue identificar a causa e voltar a operar em poucos minutos.
Se você quer negociar perpétuos da Hyperliquid em um fluxo mais organizado, com assinatura transparente e melhor controle da carteira, experimente baixar a OneKey e acessar o mercado pelo OneKey Perps.
Aviso de risco: este conteúdo é apenas informativo e não constitui recomendação de investimento, consultoria financeira ou orientação legal. A negociação de criptoativos envolve alto risco, incluindo volatilidade de mercado, falhas técnicas e riscos regulatórios. Avalie cuidadosamente sua situação e os riscos antes de operar.
