Sobre o projeto

Arbitrage Insights é um pequeno kit de ferramentas de arbitragem de câmbio. Ele compara a taxa forward justa de um par de moedas, derivada do preço à vista e das duas taxas de juros, com a taxa forward de mercado, identifica a lacuna e mostra o que resta após os custos de negociação e o imposto. O projeto inclui três páginas. O Live Monitor obtém taxas spot ao vivo a cada minuto, calcula o forward justo para cada par monitorado, compara-o com uma cotação forward fornecida pelo usuário, subtrai os custos e alerta por banner, som e notificação do navegador quando a lacuna vale a pena. O Arbitrage Calculator verifica uma única operação passo a passo. O Investment Calculator recebe capital, par e país e retorna lucro bruto, após custos e após impostos, com uma comparação entre países. Os arquivos compartilhados incluem engine.js para os cálculos, theme.css, monitor.js e monitor_config.json. As taxas spot ao vivo vêm de um feed público (api.fxratesapi.com, com open.er-api.com como alternativa). As taxas de juros e os pontos forward vêm de monitor_config.json; como nenhum feed gratuito fornece cotações forward, o usuário insere ali os pontos forward da sua corretora. Até que isso seja feito, o site é executado em modo de exemplo e não envia notificações. Um alerta é disparado quando a lacuna após custos excede alert_threshold_bp e as entradas passam nas verificações de consistência. Para receber alertas quando nenhuma página estiver aberta, monitor_check.py é executado no GitHub Actions a cada 15 minutos, usa a mesma configuração e o mesmo engine, grava signals.json para a página ler e envia uma mensagem no Telegram quando uma oportunidade aparece e quotes_are_real é verdadeiro. A configuração exige criar um bot do Telegram pelo BotFather, armazenar TELEGRAM_BOT_TOKEN e TELEGRAM_CHAT_ID como segredos do repositório e definir forward_points, quotes_as_of e quotes_are_real reais na configuração. fx_arbitrage.py é a implementação Python de referência, com engine.js como uma porta verificada de forma cruzada. Sua execução imprime quatro exemplos práticos, e monitor_check.py executa uma passagem local do monitor. O README observa que as taxas de juros e as alíquotas de imposto são ilustrativas ou placeholders e devem ser verificadas antes do uso, e que o projeto não constitui aconselhamento de investimento.