Formato de Resposta de Erro
Todos os erros seguem um formato consistente:Códigos de Status HTTP
- 200 OK: Requisição bem-sucedida;
- 400 Bad Request: Parâmetros de requisição inválidos;
- 401 Unauthorized: Chave de API ausente ou inválida;
- 403 Forbidden: Chave de API não tem permissões necessárias ou IP não permitido;
- 406 Not Acceptable: Requisição não pode ser processada (ex: mercado fechado);
- 429 Too Many Requests: Limite de taxa excedido;
- 500 Internal Server Error: Erro do servidor.
Códigos de Erro
Erros de Colocação de Ordem
Descrição: Preço é inválido (deve estar entre 0-100 ticks para ordens limitadas, ou value_cents deve ser positivo para ordens a mercado)Descrição: Quantidade é inválida (deve ser positiva)
Descrição: Conta não tem saldo suficiente para fazer a ordem
Descrição: Conta não tem contratos suficientes para vender
Descrição: Mercado não tem liquidez suficiente para executar a ordem
Descrição: Ordem não encontrada (ao tentar cancelar)
Descrição: Usuário não está autorizado a realizar esta ação
Descrição: Mercado está fechado e não está mais aceitando ordens
Descrição: Ocorreu um erro inesperado
Erros de Autenticação
401 Unauthorized
- Cabeçalho
X-Api-Keyausente - Chave de API inválida
- Chave de API expirou
- Chave de API está desabilitada
403 Forbidden
- Seu endereço IP não está na whitelist da chave de API
Limitação de Taxa
429 Too Many Requests
Retry-After: Número de segundos para esperar antes de tentar novamente
Boas Práticas de Tratamento de Erros
- Verificar Códigos de Status: Sempre verifique códigos de status HTTP antes de processar respostas
- Tratar Limites de Taxa: Implemente backoff exponencial para erros de limite de taxa
- Validar Entrada: Valide todos os parâmetros antes de enviar requisições
- Verificar Status do Mercado: Verifique se o mercado está aberto antes de fazer ordens
- Monitorar Saldo: Verifique o saldo disponível antes de fazer ordens
- Registrar Erros: Registre códigos e mensagens de erro para depuração

