Pular para o conteúdo principal

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.

TipoURL
REST APIhttps://api-caas-it-sandbox.liqi.app.br
WebSocketwss://websocket-caas-it-sandbox.liqi.app.br

Production​

Ambiente de produção para operações reais.

TipoURL
REST APIhttps://api.it-caas.com.br
WebSocketwss://ws.it-caas.com.br
aviso

As chaves de API são diferentes para cada ambiente. Certifique-se de usar a chave correta para o ambiente desejado.

Exchange de teste

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ódigoCompraVendaO que acontece
71R$ 50,710,00017771Executa 5% acima do preço definido
72R$ 50,720,00017772Executa 5% abaixo
73R$ 50,730,00017773Executa 10% acima
74R$ 50,740,00017774Executa 10% abaixo
75R$ 50,750,00017775Executa 20% acima
76R$ 50,760,00017776Executa 20% abaixo
78R$ 50,780,00017778A exchange recusa a ordem
79R$ 50,790,00017779A 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 ordemO 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 limiteA 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 mercadoNã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​

AspectoSandboxProduction
DadosPools de liquidez reais (teste)Operações reais
Chaves de APIChaves de sandboxChaves de produção
Endpoints experimentaisDisponíveisApenas endpoints estáveis
Exchange de teste (mockexchange)Disponível, com preço e cenários definidos por vocêNão existe
Uso recomendadoIntegração e testesOperações em produção