Skip to main content

📖 Descrição

Endpoint de Server-Sent Events (SSE) que transmite oportunidades de arbitragem detectadas pelo motor WebSocket em tempo real. Cada evento representa uma oportunidade identificada após o debounce de 200ms por símbolo.
SSE é uma conexão HTTP persistente unidirecional. O browser se reconecta automaticamente em caso de queda. Use a API nativa EventSource para consumir este endpoint — não é necessário WebSocket do lado do cliente.

🛠️ Requisição

Método

GET

URL

Headers Necessários

Parâmetros

Nenhum.

Exemplo de Requisição (curl)

Exemplo de Requisição (JavaScript)


📤 Resposta

Headers da Resposta

O header X-Accel-Buffering: no é necessário para que Nginx (ou proxies similares) não bufferizem a resposta, garantindo entrega imediata dos eventos.

Formato dos Eventos SSE

Cada evento segue o protocolo SSE padrão:

Estrutura do Payload JSON

Campos do Payload


🔄 Ciclo de Vida da Conexão

O SSEBroadcaster suporta múltiplos clientes simultâneos via fan-out. Cada cliente recebe um canal dedicado — a lentidão de um cliente não impacta os demais.

⚠️ Considerações

Este endpoint requer ENABLED_WEBSOCKET=1 no ambiente. Se o fluxo WebSocket não estiver ativo, a conexão SSE será estabelecida mas nenhum evento será emitido até que algum handler WebSocket detecte uma oportunidade.

Exemplo de Integração React