Ambientes
A API Liqi CaaS está disponível em dois ambientes distintos.
Sandbox (Desenvolvimento)
Ambiente de testes com pools de liquidez reais. Use para validar sua integração antes de ir para produção.
| Tipo | URL |
|---|---|
| REST API | https://api-caas-it-sandbox.liqi.app.br |
| WebSocket | wss://websocket-caas-it-sandbox.liqi.app.br |
Production
Ambiente de produção para operações reais.
| Tipo | URL |
|---|---|
| REST API | https://api.it-caas.com.br |
| WebSocket | wss://ws.it-caas.com.br |
As chaves de API são diferentes para cada ambiente. Certifique-se de usar a chave correta para o ambiente desejado.
Em Sandbox existe a exchange mockexchange, cujo preço você define via
POST /market/setMockPrice. Serve para testar sua integração de forma
determinística — uma ordem a limite dispara na hora que você quiser, sem esperar o mercado se
mover.
O preço definido vale por 1 hora. Para habilitar a exchange na sua conta, fale com o suporte.
Forçando cenários de teste pelo valor da ordem
Na mockexchange você escolhe o desfecho da ordem pelos dois últimos dígitos do valor. Isso
permite reproduzir rejeição e contingência sem depender de oscilação de mercado.
Na compra, o código são os centavos, e vale apenas para valores abaixo de R$ 100. Na
venda, são os dois últimos dígitos das quatro últimas casas da quantidade, precedidos de 77.
| Código | Compra | Venda | O que acontece |
|---|---|---|---|
71 | R$ 50,71 | 0,00017771 | Executa 5% acima do preço definido |
72 | R$ 50,72 | 0,00017772 | Executa 5% abaixo |
73 | R$ 50,73 | 0,00017773 | Executa 10% acima |
74 | R$ 50,74 | 0,00017774 | Executa 10% abaixo |
75 | R$ 50,75 | 0,00017775 | Executa 20% acima |
76 | R$ 50,76 | 0,00017776 | Executa 20% abaixo |
78 | R$ 50,78 | 0,00017778 | A exchange recusa a ordem |
79 | R$ 50,79 | 0,00017779 | A exchange responde com INTERNAL SERVER ERROR |
Qualquer outro valor executa normalmente.
Quando o desvio vira contingência depende do tipo de ordem. Na contingência, a mockexchange
recusa a ordem e ela segue para a próxima exchange da fila, que executa. O resultado aparece
na consulta da ordem, no campo rule, indicando a exchange que atendeu.
| Tipo de ordem | O que decide a recusa |
|---|---|
| Cotação (RFQ) | O desvio do código ultrapassa a margem de slippage configurada para a sua conta. Para que a contingência aconteça, essa margem precisa ser maior que a diferença de preço entre as exchanges da fila e menor que o desvio do código escolhido. |
| Ordem a limite | A mesma regra da cotação: o desvio do código é comparado com a margem de slippage da conta. Se passar, a mockexchange recusa antes de abrir e, se nenhuma exchange da fila aceitar, a ordem volta para OPEN com EXCHANGE_REFUSED. |
| Ordem a mercado | Não há contingência: a ordem executa com o desvio. |
O código 78 é diferente: ele encerra a ordem como rejeitada, sem passar para a próxima exchange.
O código 79 simula o erro genérico da exchange (INTERNAL SERVER ERROR), sem passar para a próxima exchange. Na
ordem a limite, a ordem volta para OPEN e é executada de novo, até 3 execuções. Em cada volta a trilha de
tentativas registra o motivo EXECUTION_ERROR. Esgotadas as 3, a ordem termina como REJECTED. Serve para testar a
sua reação ao retry e à rejeição final. É uma exceção do Sandbox: o erro genérico real, depois das 3 tentativas,
não termina em REJECTED: a ordem vai para a mesa da Liqi (veja Ordem a limite: status e erros).
Diferenças entre Ambientes
| Aspecto | Sandbox | Production |
|---|---|---|
| Dados | Pools de liquidez reais (teste) | Operações reais |
| Chaves de API | Chaves de sandbox | Chaves de produção |
| Endpoints experimentais | Disponíveis | Apenas endpoints estáveis |
Exchange de teste (mockexchange) | Disponível, com preço e cenários definidos por você | Não existe |
| Uso recomendado | Integração e testes | Operações em produção |