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.liqi-caas.com.br |
| WebSocket | wss://ws.liqi-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 |
Qualquer outro valor executa normalmente.
Desvio maior que a margem da conta vira contingência. Quando o desvio do código ultrapassa a
margem de slippage configurada para a sua conta, a mockexchange recusa a ordem e ela segue para
a próxima exchange da fila, que executa. É assim que você reproduz uma execução em
contingência. O resultado aparece na consulta da ordem, no campo rule, indicando a exchange que
atendeu.
O código 78 é diferente: ele encerra a ordem como rejeitada, sem passar para a próxima exchange.
Para que a contingência aconteça, a margem de slippage da sua conta precisa ser maior que a diferença de preço entre as exchanges da fila e menor que o desvio do código escolhido. :::
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 |