LION·QUANTEDGE
Bot Manager

O Lion QuantEdge Bot Manager é um sistema autónomo que lê os dados do scraper de futebol (ficheiro unified_data.json), aplica modelos matemáticos de probabilidade para calcular Expected Value (EV) real de cada mercado, compara com as odds disponíveis, e envia automaticamente as value bets que passam nos filtros configurados para um canal do Telegram.

Fluxo de funcionamento

O bot partilha exatamente o mesmo motor matemático do Lion QuantEdge. A diferença é que no QuantEdge você explora os cálculos interativamente; aqui, o bot executa automaticamente com as configurações guardadas.

Modelo por Mercado

Cada mercado pode ter o seu próprio modelo independente, substituindo o modelo global. Esta funcionalidade permite, por exemplo:

Parâmetros recomendados por contexto

Cada mercado tem os seus próprios thresholds independentes. Esta configuração granular é a principal vantagem do sistema — permite exigir critérios diferentes para mercados com características distintas.

Os 4 parâmetros por mercado

Configurações recomendadas por mercado

Como o EV mínimo afeta o volume de dicas

Fração de Kelly — qual usar?

Quando usar % da Banca

A stake por percentagem (ex: 1%) é ideal para quem ainda está a validar o sistema ou prefere uma gestão mais simples e controlada. Com 1%, mesmo 20 dicas perdidas consecutivas reduzem a banca em apenas ~18%, mantendo sempre capital para recuperar.

Os filtros globais aplicam-se antes das regras individuais de cada mercado. Atualmente o único filtro global disponível é o Nível de Liga.

Filtro por Nível de Liga

Os níveis no sistema seguem a numeração do scraper. Deixar o campo vazio aceita todas as ligas.

O painel Fechamento é onde se regista o resultado final de cada dica enviada. Cada utilizador tem o seu histórico completamente separado.

Fechamento Manual

Para cada dica pendente, clicar no botão ✏️ Fechar e selecionar:

Ao fechar, é enviada automaticamente uma notificação ao canal Telegram do utilizador com o resultado. Se a mensagem original ainda estiver disponível, é editada no próprio Telegram.

Filtros do Fechamento

Auto-Fechamento Automático

Quando activado pelo administrador, o sistema fecha as dicas automaticamente usando resultados reais da API-Football — sem precisar de intervenção manual. Quando um jogo termina, o bot verifica o placar e regista GREEN, RED ou VOID conforme o mercado apostado, notificando o Telegram.

Performance por Mercado

No painel Fechamento, clicar em "📊 Ver Performance por Mercado" para ver ROI%, Win Rate e Lucro separados por mercado. Isto permite identificar rapidamente quais mercados estão a gerar retorno real e ajustar as configurações.

O Simulador lê o unified_data.json atual e passa todos os jogos pelos filtros configurados sem enviar nada ao Telegram. Ideal para testar e afinar configurações antes de ligar o bot.

Como interpretar os resultados

Configuração de referência para começar — baseada nos padrões usados em ambiente real.

Perfil Conservador (baixo volume, alta seletividade)

Modelo global:     Dixon-Coles  ρ = -0.13
Stake:             1% da banca  (ou Kelly ¼)
Intervalo:         30 minutos

Over 2.5 Gols
  EV ≥ +15%  |  Prob ≥ 65%  |  Odd 1.48 – 2.20  |  Modelo: Biv.Poisson

BTTS — Ambas Marcam
  EV ≥ +15%  |  Prob ≥ 65%  |  Odd 1.50 – 2.20  |  Modelo: Biv.Poisson

Under 3.5 Gols
  EV ≥ +15%  |  Prob ≥ 70%  |  Odd 1.40 – 2.00  |  Modelo: Dixon-Coles

Perfil Moderado (volume médio, equilibrado)

Modelo global:     Biv. Poisson  cov = 0.15
Stake:             2% da banca
Intervalo:         30 minutos

Over 1.5 Gols
  EV ≥ +8%   |  Prob ≥ 72%  |  Odd 1.20 – 1.80  |  Modelo: global

Over 2.5 Gols
  EV ≥ +10%  |  Prob ≥ 60%  |  Odd 1.40 – 2.50  |  Modelo: global

BTTS — Ambas Marcam
  EV ≥ +10%  |  Prob ≥ 60%  |  Odd 1.45 – 2.20  |  Modelo: global

Under 2.5 Gols
  EV ≥ +8%   |  Prob ≥ 50%  |  Odd 1.30 – 2.20  |  Modelo: Dixon-Coles

Dicas gerais de calibração

Sinais de que os filtros estão bem calibrados