Skip to main content

​
Sistema de Alertas de Arbitragem

O Sistema de Gerenciamento de Alertas permite que você configure notificações personalizadas para oportunidades de arbitragem de criptomoedas. O sistema monitora continuamente as operações de arbitragem e notifica quando suas condições configuradas são atendidas.
O sistema de alertas está totalmente operacional e monitorando oportunidades em tempo real.

​
🚀 Funcionalidades Principais

​
Configuração Personalizada

  • Criptomoedas: Especifique quais criptomoedas deseja monitorar (ex: BTC, ETH, PEPE)
  • Exchanges: Defina quais exchanges deseja acompanhar (ex: Binance, OKX, Kraken)
  • Spread: Estabeleça condições de spread com operadores logicos
  • Canal de Notificação: Atualmente suporta notificações via Telegram

​
Monitoramento em Tempo Real

  • Frequência de Busca: Alertas do usuário são verificados a cada 5 minutos
  • Processamento: Operações de arbitragem são analisadas a cada 19 segundos
  • Correspondência Inteligente: Compara condições dos alertas com operações encontradas

​
📋 Como Configurar Alertas

​
Exemplo de Configuração

{
  "user_email": "[email protected]",
  "type": "telegram",
  "condition": {
    "exchanges": ["Binance", "OKX"],
    "cryptocurrencies": ["BTC", "ETH"],
    "spread": {
      "operator": ">=",
      "value": 3.0
    }
  }
}

​
Correspondência de Criptomoedas

O sistema implementa uma lógica inteligente para corresponder criptomoedas:

Correspondência Exata

“BTC” = “BTC”

Correspondência por Conteúdo

“PEPE” corresponde a “PEPE-USDT”
Exemplos de Correspondência:
  • Usuário configura: “PEPE” → Sistema detecta: “PEPE-USDT” ✅
  • Usuário configura: “BTC” → Sistema detecta: “BTC-USDC” ✅
  • Usuário configura: “ETH” → Sistema detecta: “ETH-BTC” ✅

​
🔍 Validação de Condições

Para cada operação de arbitragem, o sistema verifica:
  1. Criptomoeda: Se a crypto da operação corresponde ao alerta do usuário
  2. Exchanges: Se pelo menos uma exchange da operação está no alerta
  3. Spread: Se o spread atende à condição configurada (ex: >= 3.0%)

​
📱 Notificações Automáticas

​
Telegram

Quando uma operação atende aos critérios de um alerta, você recebe uma notificação no formato: 
🚨 Alerta de Arbitragem!

💰 PEPE-USDT
📈 Spread: 5.50%
🏪 Exchanges: Binance ↔ OKX
📊 Volume: 100.00
⏰ PEPE-USDT: Spread 5.50% >= 5.00%

​
Estrutura da Mensagem

{
  "type": "ALERT_TELEGRAM_PRIVATE_USER",
  "content": {
    "email": "[email protected]",
    "message": "🚨 Alerta de Arbitragem!\n\n💰 PEPE-USDT..."
  }
}

​
🏗️ Arquitetura Técnica

​
Componentes Principais

AlertManagerService

Serviço principal de gerenciamento

Processor

Lógica de correspondência e validação

Converter

Conversão de dados entre sistemas

EventDispatcher

Envio de notificações via RabbitMQ

​
Fluxo de Processamento

​
📊 Casos de Uso Práticos

​
Caso 1: Alertas de Spread Alto

Cenário: Usuário quer ser notificado quando BTC tiver spread >= 2% entre Binance e OKX Configuração: 
{
  "cryptocurrencies": ["BTC"],
  "exchanges": ["Binance", "OKX"],
  "spread": {"operator": ">=", "value": 2.0}
}
Resultado: Notificação quando spread de BTC entre essas exchanges for >= 2%

​
Caso 2: Monitoramento de Altcoins

Cenário: Usuário monitora PEPE em qualquer exchange com spread >= 5% Configuração: 
{
  "cryptocurrencies": ["PEPE"],
  "exchanges": [],
  "spread": {"operator": ">=", "value": 5.0}
}
Resultado: Notificação para qualquer spread de PEPE >= 5% em qualquer exchange

​
Caso 3: Alertas Específicos de Exchange

Cenário: Usuário quer apenas alertas da Kraken para ETH Configuração: 
{
  "cryptocurrencies": ["ETH"],
  "exchanges": ["Kraken"],
  "spread": {"operator": ">", "value": 1.5}
}
Resultado: Notificação apenas quando ETH na Kraken tiver spread > 1.5%

​
🔗 Integração com Sistema Principal

O sistema está integrado ao processamento principal de arbitragem:
  • processAlerts(): Função chamada a cada ciclo de processamento
  • convertToAlertManagerOperations(): Converte operações para formato do alerta
  • ProcessNotifications(): Envia notificações para alertas compatíveis

​
Endpoint de Alertas

  • URL: https://communication-service-4f4f57e0a956.herokuapp.com/alerts/grouped
  • Método: GET
  • Frequência: A cada 5 minutos
  • Formato: JSON com lista de usuários e seus alertas

​
📈 Métricas e Monitoramento

Alertas Ativos

Contagem de alertas configurados pelos usuários

Notificações Enviadas

Quantidade de notificações processadas

Taxa de Correspondência

Percentual de operações que geram alertas

Tempo de Processamento

Latência entre detecção e notificação

​
🎯 Benefícios para o Negócio

O sistema de alertas oferece múltiplas vantagens para maximizar suas oportunidades de arbitragem.
  1. Automação: Usuários não precisam monitorar manualmente
  2. Personalização: Cada usuário pode configurar seus próprios critérios
  3. Tempo Real: Notificações instantâneas quando condições são atendidas
  4. Escalabilidade: Sistema suporta múltiplos usuários e tipos de alerta
  5. Flexibilidade: Fácil adição de novos tipos de notificação

​
🚧 Roadmap Futuro

Estamos trabalhando para expandir as funcionalidades do sistema de alertas.
  1. Novos Tipos de Notificação: Email, SMS, Push notifications
  2. Alertas Avançados: Condições baseadas em volume, volatilidade
  3. Dashboard: Interface para gerenciamento de alertas
  4. Histórico: Armazenamento de alertas enviados
  5. Machine Learning: Otimização automática de critérios de alerta

​
⚠️ Estados do Sistema

  • Inicialização: Busca alertas iniciais e inicia monitoramento
  • Execução: Processamento contínuo em background
  • Parada: Para o monitoramento e libera recursos
Para dúvidas sobre o sistema de alertas, entre em contato através dos canais de suporte listados na navegação.