Referência completa de 26 códigos de erro das APIs da Liqi.
400400
Bad Request
A requisição contém parâmetros inválidos ou está mal formatada.
Solução: Verifique o body e os query params. Consulte a documentação do endpoint.
401401
Unauthorized
Credenciais ausentes, inválidas ou expiradas.
Solução: Verifique o header de autenticação (API Key, JWT ou RSA-SHA256).
403403
Forbidden
Você não tem permissão para acessar este recurso.
Solução: Verifique se sua API key tem os scopes necessários.
404404
Not Found
O recurso solicitado não existe.
Solução: Verifique o ID ou path do recurso.
409409
Conflict
A operação conflita com o estado atual do recurso.
Solução: Verifique o estado atual do recurso antes de tentar a operação.
422422
Unprocessable Entity
A requisição está sintaticamente correta mas semanticamente inválida.
Solução: Verifique os valores dos campos. Os tipos e formatos podem estar errados.
429429
Too Many Requests
Você excedeu o limite de requisições.
Solução: Aguarde o tempo indicado no header Retry-After e implemente exponential backoff.
500500
Internal Server Error
Erro interno no servidor. O time de engenharia é notificado automaticamente.
Solução: Tente novamente em alguns segundos. Se persistir, entre em contato pelo suporte.
503503
Service Unavailable
O serviço está temporariamente indisponível (manutenção ou sobrecarga).
Solução: Aguarde e tente novamente. Verifique a página de status para mais informações.
1001401tidc-v1
Assinatura inválida
A assinatura RSA-SHA256 no header X-Signature não é válida.
Solução: Verifique se está assinando o body completo com a chave privada correta.
1002401tidc-v1
Timestamp expirado
O timestamp no header X-Timestamp está fora da janela de 5 minutos.
Solução: Sincronize o relógio do servidor e envie o timestamp no momento da requisição.
1003401tidc-v1
Chave pública não registrada
Nenhuma chave pública está registrada para o parceiro.
Solução: Registre sua chave pública RSA com o time da Liqi antes de fazer requisições.
2001404tidc-v1
Lote não encontrado
O lote de crédito com o ID informado não existe.
Solução: Verifique o ID do lote. Use GET /credit-batches para listar lotes disponíveis.
2002409tidc-v1
Status inválido para operação
O lote está em um status que não permite a operação solicitada.
Solução: Verifique o status atual do lote. Lotes submetidos não podem ser editados.
2003409tidc-v1
Contrato duplicado no lote
O contrato já está incluído neste lote de crédito.
Solução: Remova o contrato duplicado ou use um lote diferente.
3001404tidc-v1
Lote de baixa não encontrado
O lote de baixa com o ID informado não existe.
Solução: Verifique o ID do lote. Use GET /settlement-batches para listar lotes.
3002422tidc-v1
Recebível já baixado
O recebível já foi baixado anteriormente e não pode ser baixado novamente.
Solução: Verifique o status do recebível com GET /receivables/:id.
CAAS_AUTH_001401caas
Token JWT inválido
O token JWT no header Authorization é inválido ou expirado.
Solução: Obtenha um novo token via POST /auth/signin.
CAAS_AUTH_002401caas
API Key inválida
O par apiKey/secretKey fornecido não é válido.
Solução: Verifique suas credenciais na página de configurações da empresa.
CAAS_PROF_001409caas
Perfil já existe
Um perfil com este documento (CPF/CNPJ) já está cadastrado.
Solução: Use GET /account/fetchProfiles para localizar o perfil existente.
CAAS_ORD_001400caas
Saldo insuficiente
O perfil não tem saldo suficiente para executar a ordem.
Solução: Verifique o saldo com GET /wallet/fetchBalance e faça um depósito se necessário.
CAAS_ORD_002400caas
Mercado não disponível
O par de negociação solicitado não está disponível.
Solução: Use GET /market/fetchMarkets para ver pares disponíveis.
CAAS_ORD_003400caas
Valor mínimo não atingido
O valor da ordem está abaixo do mínimo permitido para este par.
Solução: Consulte os limites do mercado via GET /market/fetchMarkets e ajuste o valor.
CAAS_RFQ_001410caas
Cotação expirada
A cotação RFQ expirou (validade de 30 segundos).
Solução: Solicite uma nova cotação via POST /orders/rfq/createQuote.
CAAS_RFQ_002409caas
Cotação já executada
Esta cotação RFQ já foi utilizada para criar uma ordem.
Solução: Solicite uma nova cotação. Cada cotação só pode ser usada uma vez.
CAAS_WS_001400caas
Canal WebSocket inválido
O canal de WebSocket solicitado não existe ou os parâmetros estão incorretos.
Solução: Canais disponíveis: watchOrders, watchTicker, watchTickers, watchBalance.