Erros Comuns

Lista dos erros mais frequentes e como resolvê-los.

401 Unauthorized - Invalid API Key

Mensagem: Invalid API Key or revoked

Causas:

API Key digitada incorretamente
API Key expirada ou revogada
Usando key de um ambiente diferente (dev vs prod)

Solução:

Verifique a API Key em seu dashboard
Se não conseguir encontrar, crie uma nova
Certifique-se de estar usando a key correta para o ambiente

400 Bad Request - Missing Required Fields

Mensagem: Parâmetro 'amount' é obrigatório

Causas:

Esqueceu de enviar um parâmetro obrigatório
Parâmetro enviado em local errado (body vs query)
Tipo de dado incorreto (string vs number)

Solução:

Consulte a documentação do endpoint
Use a estrutura exata sugerida
Valide os tipos de dados

409 Conflict - Insufficient Collateral

Mensagem: Garantias insuficientes para esta operação

Causas:

Colateral não é suficiente para o empréstimo solicitado
Preço da garantia caiu (market risk)
Colateral já está sendo usado em outro empréstimo

Solução:

Verifique o health_factor do seu colateral
Considere depositar mais garantias
Reduza o valor do empréstimo

429 Too Many Requests

Mensagem: Rate limit exceeded, retry after 5 seconds

Causas:

Suas requisições estão excedendo o limite da sua tier
Múltiplas requisições simultâneas

Solução:

Implemente backoff exponencial
Batch suas requisições
Solicite aumento de limit no dashboard

503 Service Unavailable

Mensagem: Serviço temporariamente indisponível

Causas:

Manutenção programada
Falha da infraestrutura
Pico de tráfego

Solução:

Verifique o status em https://status.fortbix.com
Implemente retry automático
Aguarde alguns minutos e tente novamente

Erro: Colateral não confirmado

Mensagem: Collateral status is pending

Causas:

O depósito de colateral ainda não foi confirmado na blockchain
Pode levar 10-30 minutos dependendo da rede

Solução:

Aguarde confirmações da blockchain
Verifique o hash da transação em um explorador (etherscan, mempool, etc)
Consulte o endpoint de detalhes da garantia para status atual