Runbooks

Checklist completo de prontidão da mesa e testes de certificação de integração.

Checklist de Prontidão da Mesa

Antes de entrar em produção, verifique:

Conectividade da API

• Endpoints de produção configurados
• Endpoint de health check respondendo
• Conexão WebSocket estável

Autenticação

• Assinatura EIP-712 funcionando
• Autorização de agente configurada (se aplicável)
• Gerenciamento de nonce implementado
• Verificação de assinatura testada

Sistema de Cotação

• Envio de ordens em lote testado
• Reconciliação do ciclo de vida das ordens verificada
• Rastreamento de execuções implementado
• Funcionalidade de cancelamento testada

Controles de Risco

• MMP configurado e testado
• Modelo de margem compreendido
• Restrições de tier verificadas
• Monitoramento do portfólio implementado

Monitoramento

• Feeds WebSocket assinados
• Reconciliação de ordens/execuções automatizada
• Health checks configurados
• Alertas configurados

Kill Switch

• Capacidade de cancelar todas as ordens
• Capacidade de desconectar imediatamente
• Procedimentos de emergência documentados

Hedge

• Integração com os perpétuos da Hyperliquid verificada
• Estratégia de hedge de delta implementada
• Cálculo de margem dos perpétuos compreendido

Liquidação

• Tratamento de vencimento testado
• Liquidação de posições verificada
• Fonte do preço de referência compreendida

Testes de Certificação de Integração

Teste 1: Envio de Ordem

Passos:

1. Envie uma única ordem via POST /order
2. Verifique se o status da resposta da ordem é ACKED ou OPEN
3. Confira se a ordem aparece em GET /orders?wallet=...
4. Verifique se order_updates foi recebido via WebSocket

Esperado: Ordem enviada com sucesso, atualizações de status recebidas

Teste 2: Envio de Ordens em Lote

Passos:

1. Envie 10 ordens via POST /bulk_order
2. Verifique se todas as ordens foram aceitas
3. Confira os status das ordens via REST e WS
4. Verifique que não há erros de assinatura/autenticação

Esperado: Todas as ordens enviadas com sucesso

Teste 3: Rastreamento de Execuções

Passos:

1. Envie uma ordem que será executada
2. Monitore o canal WebSocket fills
3. Verifique se a execução foi recebida com o order_id correto
4. Confira se a execução aparece em GET /fills?wallet=...
5. Verifique se o status da ordem é atualizado para FILLED

Esperado: Execuções rastreadas corretamente, status da ordem atualizado

Teste 4: Rastreamento de Execuções Parciais

Passos:

1. Envie uma ordem que será parcialmente executada
2. Monitore os canais WebSocket fills e order_updates
3. Verifique se a execução parcial chega em fills
4. Verifique se order_updates informa PARTIALLY_FILLED com um filled_size cumulativo
5. Agregue as execuções por order_id e confira se o total é igual a filled_size

Esperado: Quantidades por execução em fills, tamanho executado cumulativo em order_updates

Teste 5: Cancelamento de Ordem

Passos:

1. Envie uma ordem via POST /order
2. Cancele a ordem via DELETE /order
3. Verifique o status da ordem: CANCELED
4. Confira se order_updates foi recebido via WebSocket

Esperado: Ordem cancelada com sucesso, atualizações de status recebidas

Teste 6: Disparo do MMP

Passos:

1. Configure o MMP via POST /mmp-config assinado. Envie X-Hypercall-Fence-Wait: 1 quando o cliente for ler a projeção imediatamente e guarde o valor de X-Hypercall-Fence retornado.
2. Envie ordens com MMP habilitado
3. Dispare o MMP excedendo os limites
4. Verifique se as ordens foram canceladas com o motivo MMP
5. Confira se as demais ordens com MMP habilitado também foram canceladas

Esperado: O MMP dispara corretamente, ordens canceladas

As leituras da configuração do MMP também exigem autenticação. Assine GetMmpConfig e envie a expiração e a assinatura nos headers X-Hypercall-Expires-At-Ms e X-Hypercall-Signature. Repita o valor de X-Hypercall-Fence da resposta da escrita neste GET para aguardar exatamente aquela configuração confirmada. Escritas sem X-Hypercall-Fence-Wait: 1 intencionalmente não retornam o header de fence.

Teste 7: Rejeição por Margem

Passos:

1. Envie uma ordem que exceda a margem
2. Verifique se a ordem foi rejeitada com o motivo "Insufficient margin"
3. Confira se o motivo da rejeição inclui os valores de margem exigida, patrimônio e déficit
4. Verifique o status da ordem: REJECTED

Esperado: Ordem rejeitada com motivo claro

Teste 8: Restrição de Tier

Passos:

1. Use uma carteira cujo tier permita apenas vendas cobertas (confira GET /risk/limits?wallet=...)
2. Tente enviar uma ordem de venda sem posição comprada
3. Verifique se a ordem foi rejeitada com o motivo de tier
4. Envie uma ordem de compra (deve ser aceita)
5. Envie uma ordem de venda para fechar a posição (deve ser aceita)

Esperado: Restrições de tier aplicadas corretamente

Teste 9: Reconexão do WebSocket

Passos:

1. Conecte-se ao WebSocket
2. Assine os canais
3. Desconecte o WebSocket
4. Reconecte com backoff exponencial
5. Assine os canais novamente
6. Consulte a API REST para recuperar as atualizações perdidas

Esperado: Reconexão funciona, estado recuperado

Teste 10: Reconciliação do Portfólio

Passos:

1. Envie ordens e obtenha execuções
2. Confira o portfólio via GET /portfolio?wallet=...
3. Verifique se as posições batem com as execuções
4. Confira se o uso de margem está correto
5. Reconcilie com as atualizações WebSocket de portfolio

Esperado: Estado do portfólio preciso, reconciliação bem-sucedida

Prontidão para Produção

Checklist de Pré-Produção

• Todos os testes de integração aprovados
• Monitoramento e alertas configurados
• Kill switch testado
• Procedimentos de emergência documentados
• Equipe treinada em resposta a incidentes
• Contatos de suporte identificados

Checklist de Go-Live

• Testes de certificação aprovados com tamanho pequeno em produção
• Endpoints de produção verificados
• Dashboards de monitoramento prontos
• Alertas configurados
• Escala de plantão da equipe definida
• Documentação revisada

Referências

• Início rápido: Quickstart
• Referência da API: REST API
• Erros e rejeições: Errors
• Playbook de incidentes: Incidents