TheWise Structural Premises V1

Manual Operacional e Inteligência de Mercado

1. A Lógica na Prática (O "Olho da Mosca")

Muitos traders se perguntam ao utilizar o robô: "Em qual tempo gráfico devo colocar? Por que ele comprou no topo em vez do fundo?". O TheWise TSP foi desenhado para simular a leitura humana discricionária de forma 100% matemática.

O Timeframe do Gráfico vs O Cérebro do Robô

Você pode abrir o robô no gráfico de M1 ou M3. Nossa arquitetura é blindada: não importa o gráfico visual, o "cérebro" consulta independentemente o Semanal, Diário, H2 e M10 no background. Usar gráficos menores permite que o robô leia os ticks mais rápido e reaja aos gatilhos instantaneamente.

Simulando a Visão do Especialista (Setup Sniper)

Se você gosta de operar os gatilhos curtos (ex: a retração do 10 minutos com o gatilho no 1 minuto) para pegar o verdadeiro "olho da mosca", veja como configurar:

  • Mude o Timeframe Estrutural nas configurações para M10.
  • Mantenha o Timeframe de Confirmação no M1 ou M3.
  • Use o Modo 2 (Tend. + Pullback + Falha).
O que acontece na tela? A linha amarela e a caixa verde de Fibonacci vão se adaptar ao 10 minutos. O robô aguarda o preço retrair até a Zona Verde, e quando o gráfico de 1 minuto tentar cair, perder força e reverter (a famosa falha micro), ele entra no melhor ponto possível.
Glossário: Teste, Falha e Rompimento

Para operar como um profissional, você deve entender o que o robô está "enxergando" matematicamente:

O Teste (Pullback)

É o momento em que o preço recua para testar a força da tendência anterior. No robô, isso é representado pelo toque no Retângulo Verde/Vermelho. É a busca pelo "desconto" para comprar barato.

A Falha (O Gatilho Sniper)

Acontece quando o preço testa a zona, tenta continuar caindo, mas perde força e o Timeframe de Confirmação (M1) vira para cima. É o sinal de que os vendedores desistiram e os compradores assumiram o controle no "olho da mosca".

O Rompimento (Nova Tendência)

Ocorre quando o preço ultrapassa a Linha Dourada (Topo/Fundo Estrutural). Isso confirma que a tendência continua e o mercado vai buscar novos níveis. É o ponto onde o robô realiza lucro no modo Alvo Dinâmico ou entra no modo Tendência.

2. Evitando Entradas no Topo

Se o seu robô comprou exatamente na crista do pivô (no rompimento), é porque o seu Sinal de Entrada estava no Modo 0.

Modo 0: Tendência Estrutural

Como ele pensa: "O H2 fez topos e fundos ascendentes? É tendência! Compro a mercado agora mesmo!". Ele não espera recuo.

O Ajuste Ideal: Operando Pullback

Para que o robô aguarde o preço cair até o "desconto" (Zona Verde de Fibonacci), você deve usar o Modo 1 ou Modo 2. Assim, ele ignora o topo e atira apenas quando o preço pisa na retração.

3. Os 8 Modos Estruturais

Você escolhe o quão "exigente" o robô deve ser. Abaixo estão os cenários:

Nível Básico (Foco no Estrutural)

Modo Mecânica
0. Tendência Entra no rompimento, assim que a estrutura é confirmada.
1. Pullback A tendência é de alta, mas espera o recuo para a Zona Fibo (50% a 100%).
2. Pullback + Falha Além do recuo, espera o Timeframe Menor (M3/M1) confirmar que os vendedores falharam.

Nível Avançado (Foco no Score)

O robô avalia o W1, D1, H2 e M10. Só entra se bater a Nota Mínima (ex: 7 pontos).

Modo Mecânica
3. Score Contextual Bateu a nota, ele entra onde estiver.
4. Score + Pullback Nota mínima atingida + Preço na Zona Fibo.
5. A Entrada Suprema Nota 7 alcançada + Preço na Zona + Gráfico micro tentou ir contra e falhou.
6. Score + ADX Contexto nota 7, mas só passa se o ADX confirmar a força da tendência.

Identificação no Dashboard (Siglas)

Para facilitar a leitura rápida, o painel do robô exibe as seguintes siglas:

  • TREND: Modo 0 (Tendência Pura)
  • PULLBACK: Modo 1 (Retração Fibo)
  • SNIPER: Modo 2 (Retração + Falha Micro)
  • SCORE: Modo 3 (Contexto Nota Mínima)
  • SC+PB: Modo 4 (Nota + Retração)
  • SUPREME: Modo 5 (Nota + Retração + Falha)
  • SC+ADX: Modo 6 (Nota + Força de Tendência)
4. Saídas e Proteções

Uma vez posicionado, o motor base (padrão base original) assume o controle da trincheira com seu gerenciamento pesado.

Saídas Estruturais

Não dependem de alvo fixo. Ex: Se a configuração for Inversão de Tendência, e o H2 virar para baixa enquanto você está comprado, o robô encerra o trade na hora assumindo lucro ou prejuízo, pois o contexto morreu.

Alvos Fixos e Móveis

  • Take Profit e Stop Loss: Definidos em pontos fixos.
  • Breakeven: Andou X pontos a favor? Puxa o Stop para o zero a zero.
  • Trailing Stop: O "Surf". Puxa o Stop degrau por degrau atrás do preço.
  • Saídas Parciais: Realiza lucro aos poucos no caminho até o alvo final.
5. Guia de Parametrização do Robô

Entenda como configurar cada grupo de parâmetros dentro do MetaTrader para moldar o robô ao seu estilo de trade.

Bloco: Confirmação de Sinais

Aplicação: Define o gatilho principal da inteligência estrutural.

  • Sinal entrada compra/venda: Escolha os Modos Estruturais (0 a 7). Ex: Modo 2 (Tendência + Pullback + Falha) para o setup Sniper.
  • Sinal saída compra/venda: Escolha o modo de saída do TSP:
    • [TSP] Inversão Estrutural: Modo "Botão de pânico". O robô só sai se a estrutura inteira de H2 reverter contra você.
    • [TSP] Desativado / Alvo Fixo: Deixa a saída exclusivamente para o Takeprofit/Stoploss numérico do robô base.
    • [TSP] Alvo Dinâmico (Topo/Fundo): Modo Sniper original. O robô coloca o alvo invisível na origem da retração e fecha o lucro automaticamente assim que testar o topo.
    • [TSP] Abortar Inversão Micro: O robô foge imediatamente do trade se o 1 Minuto virar contra, poupando seu capital de um drawdown maior.

Bloco: [TSP] Timeframes Hierárquicos

Aplicação: Onde você amarra os tempos gráficos para o cálculo da Tendência e dos Pivôs.

  • Timeframe Estrutural: O mais importante. Onde o robô traça os pivôs amarelos e a zona verde. Ex: H2 para trades mais longos ou M10 para simular a visão de scalper mais agressivo.
  • Timeframe de Confirmação: O "Olho da Mosca". Geralmente M1 ou M3. Serve para validar falhas micro a favor da estrutura maior.

Bloco: [TSP] Pullback / Zonas

Aplicação: Calibração da área de desconto (A Zona Verde no gráfico).

  • Fibo Superior (Ex: 50%): O limite mais raso do recuo. O robô passa a considerar compra a partir daqui.
  • Fibo Inferior (Ex: 100%): O limite máximo da retração. Abaixo disso, o movimento pode estar sendo revertido de vez.
  • Tolerância da Zona (Pontos): Ex: 50 pontos. Permite que o robô compre se o preço chegar muito perto da linha da fibo (front-running).

Bloco: [TSP] Score

Aplicação: Se você usa os Modos de Score (3, 4, 5 ou 6), o robô fará a somatória das forças antes de entrar.

  • Pontos por TF (Macro, Estrutural, Setup): Defina o peso de cada tempo. Ex: Se H2 em alta vale 5 pontos e D1 vale 3, o robô entende que a força compradora é 8.
  • Score Mínimo para Compra/Venda: A "Nota de Corte". Se você colocar 7, o robô só atira se a soma das forças atingir 7. Bloqueia entradas em mercados "rabiscados" e sem direção.

Blocos: Saídas e Metas (O Padrão Base Original)

Aplicação: Gestão de risco e alvos através do motor base.

  • Stoploss: Perda máxima aceitável. Distância a ser colocada a partir do preço de entrada ou preço médio.
  • Takeprofit: Alvo de ganho máximo da operação.
  • Movimento Stop Loss (Breakeven):
    • Início do Breakeven SL: Distância a partir da entrada em que será acionada a movimentação do stop.
    • Distância do Breakeven SL: Distância em que o stoploss será reposicionado, contando a partir do início do breakeven.
    💡 Exemplo prático: Está comprado no preço de 100.500. É definido o Início em 300 pontos e a Distância em 100 pontos. Quando o preço chegar em 100.800 (Início), o stoploss será movido para 100.700 (100 pts de distância do início).
  • Movimento Stop Loss (Trailing Stop):
    • Início do Trailing: A distância a favor que ativará a movimentação contínua do stop.
    • Passo do Trailing: O tamanho do movimento (em pontos) que o stop dará a cada avanço do preço.
    💡 Exemplo prático: Compra em 100.500 com stoploss inicial em 100.100. Trailing definido para Início de 200 pts e Passo de 10 pts. Quando o preço bater 100.700 (Início), o stoploss move 10 pontos para 100.110. Se o preço for para 100.710, o stop vai para 100.120, e assim por diante!
  • Saídas Parciais: Permite realizar o lucro ao longo do caminho. Ex: Entrou com 5 contratos, o robô vende 2 no primeiro alvo e deixa os outros 3 navegarem no Trailing Stop.
Novo na V6: Motor Sintético, Smart Grid e Tesouraria

A versão 6 traz as maiores atualizações estruturais já feitas para validação e sobrevivência no longo prazo.

Motor Sintético de Rolagem (Backtest Invencível)

No MetaTrader, contratos futuros vencem e o histórico morre. O V6 introduziu o Motor Matemático de Rolagem. Agora você pode rodar backtests em séries contínuas (WIN@N, WDO@N, CCM@N) e o robô calculará a data exata em que ocorreu o vencimento no passado, executando uma Zeragem Compulsória idêntica à vida real, entregando um relatório de performance blindado contra ilusões de ganhos irreais.

Smart Grid Dinâmico

O antigo sistema de preço médio foi transformado em um Smart Grid. O robô agora gerencia até 20 níveis de aumento (a favor e contra), reposicionando seu médio dinamicamente baseado em pivôs. Quando o mercado toma a direção correta, ele utiliza um Trailing Stop agressivo para "espremer" a tendência até o fim.

Tesouraria Global & Anti-Spam

Duas novas barreiras institucionais:

  • Filtro Anti-Spam: Protege o envio excessivo de mensagens para a corretora (Erro 10013) caso haja rejeição em massa de lotes ou rejeição de modificação de ordens pendentes.
  • Memória Cross-Contract: No passado, ao rolar o contrato de WINM para WINQ, o robô perdia o histórico de lucro daquele mês. Agora, a Meta da Conta permite que o robô leia todo o histórico de operações do seu Magic Number, independente de qual ativo foi operado antes, mantendo a proteção do seu saldo global intacta.
6. Referência Completa: Módulos Base

O Padrão Base Original fornece uma infraestrutura robusta de gestão institucional. Abaixo estão explicações aplicadas de cada módulo de gerenciamento do robô.

Parametrização Inicial (Ambiente e Identidade)

Magic Number (O CPF do Robô): Como o robô "carimba" suas ordens. Se você rodar dois robôs iguais na mesma conta (ex: um em WIN e outro em WDO), mude o Magic Number de um deles. Caso contrário, um tentará fechar a ordem do outro.

Tipo de Mercado (Execução da Corretora): Diferentes mercados têm diferentes regras no MetaTrader 5:

  • B3 (Ações e Futuros): Geralmente exige envio Return ou FOK (Fill or Kill).
  • Forex / Mercado Internacional: Geralmente usa o modelo padrão de mercado global.
  • Deriv / Criptomoedas: O robô se adapta à liquidez contínua. Se a sua corretora rejeitar uma ordem dizendo "Unsupported filling mode", é aqui que você altera.

Modo Operacional (Validade da Ordem):

  • Daytrade (B3): Use a validade Day. Ordens não executadas expiram no fim do dia automaticamente, evitando que sejam ativadas acidentalmente no dia seguinte.
  • Swing Trade / Forex: Use GTC (Good Till Canceled). A ordem pendente ficará no servidor até ser ativada, não importando quantos dias demore.

Horários e Zeragem (Gestão de Tempo)

O controle temporal define quando o robô pode "trabalhar" e quando ele deve abortar a missão.

  • Horário Inicial / Final: A janela em que ele tem permissão para abrir novas ordens. Fora disso, ele apenas gerencia as abertas.
  • Horário de Zeragem: Ação compulsória. Ex: 17:30. O robô fechará a mercado qualquer operação aberta.
    💡 Aplicação Daytrade B3: Obrigatório ativar para evitar ser pego pela margem punitiva da corretora no leilão de fechamento.
    💡 Aplicação Forex / Swing Trade: Desative a zeragem, para que o robô carregue a posição durante a madrugada e os finais de semana.

Aumentos e Gradiente Linear

Módulos de gestão de posição avançada para alterar o tamanho da sua "mão" durante o trade.

  • Aumentos a Favor (Pirâmide): O robô adiciona lotes conforme o trade dá lucro, surfando tendências fortes e alavancando ganhos.
  • Aumentos Contra (Preço Médio): Se o trade ficar negativo, o robô realiza compras fracionadas abaixo da entrada. Isso reduz o seu preço médio de entrada, permitindo sair no empate ou lucro com uma simples correção. (Exige controle rigoroso de margem).
  • Gradiente Linear: Cria uma "malha" ou "grade" de operações no gráfico.
    💡 Como usar: Se o preço entra num "Range" (mercado lateral), você configura a Distância da grade (ex: 50 pts). O robô espalhará limite de compras a cada 50 pontos caindo, e ordens de venda a cada 50 subindo. Ele transforma um mercado parado em uma máquina de moer pequenos lucros contínuos.

Metas do Expert e Metas da Conta

O escudo patrimonial do robô possui duas camadas de defesa.

  • Metas do Expert: Analisa SOMENTE o P/L das ordens abertas com o Magic Number. Ex: Gain de R$ 500. Se este robô bater 500, ele para e encerra o dia, mesmo que você esteja operando outros ativos manualmente na mesma conta.
  • Metas da Conta: Analisa o saldo GERAL da corretora. Se você configurou um Loss Diário de -R$ 1.000,00 e tomou uma pancada operando pelo celular, o robô vê que o patrimônio global sofreu o limite. Ele interrompe o próprio funcionamento no MT5 para defender a sua conta de ruínas maiores.

Cross Order

Ferramenta fundamental para o mercado de Futuros do Brasil (B3).

  • O Problema: Gráficos do mês vigente (ex: WINM24) têm buracos e pouco histórico na abertura do contrato, prejudicando médias e indicadores. O gráfico contínuo perpétuo (WIN@N) é limpo, mas a corretora não aceita ordens de compra nele.
  • Como aplicar: Você arrasta o robô para o WIN@N. Nas opções, ativa o Cross Order e digita WINM24 no campo do ativo. O robô lê os pivôs e faz as análises matemáticas na perfeição do gráfico perpétuo, mas envia a execução silenciosamente para o contrato do mês.

Licenciamento e Validade

O robô agora suporta até 10 contas simultâneas por licença. A data de expiração é exibida em tempo real no painel do gráfico. Para renovar, contate o suporte.

Nome do Setup Inteligente

Se você deixar o campo "Nome do Setup" como Setup Padrão, o robô gerará automaticamente um nome técnico seguindo o padrão: [Ativo] [Tempo Gráfico] - [Gatilho Selecionado].

Estratégia Avançada: Operação Multi-Gráficos

Muitos traders perguntam se é possível pegar "todos os movimentos" (Rompimento + Pullback) ao mesmo tempo. A resposta é SIM, mas a forma correta é através de múltiplos gráficos.

Uma Estratégia por Gráfico

Para evitar que o robô confunda as posições e o gerenciamento de risco, o ideal é abrir dois ou mais gráficos do mesmo ativo (ex: dois gráficos de WIN M1).

Magic Numbers Diferentes

REGRA DE OURO: Cada gráfico deve ter um Magic Number único (ex: Gráfico 1 = 111111, Gráfico 2 = 222222). Isso garante que o robô do Pullback não tente fechar a ordem do robô de Rompimento.

Exemplo Sniper + Trend

  • Gráfico 1: Configurado com o set Sniper (Modo 2 - Falha de Pullback). Ele busca comprar barato no recuo.
  • Gráfico 2: Configurado com o set Trend (Modo 0 - Rompimento). Ele busca surfar a explosão da nova tendência.

Assim, você transforma seu MetaTrader em uma estação de comando completa, capturando todas as fases do mercado de forma organizada e profissional.

Guia de Otimização e Robustez Quantitativa (WFA & Métrica Customizada)

O robô TheWise Structural Premises V1 foi construído sob uma forte filosofia quantitativa de eliminação de sorte e ajuste excessivo de curvas (overfitting). Para isso, implementamos suporte nativo para análises institucionais avançadas de robustez.

A Métrica Customizada de Robustez (TWR Score)

O robô injeta diretamente no testador do MetaTrader 5 o TWR (TheWise Robustness Score) via código na função de otimização customizada (OnTester). A fórmula é calculada a cada rodada da seguinte forma:

TWR = (Lucro Líquido / Drawdown Máximo) × Fator de Lucro × Penalização Estatística
  • Drawdown Máximo de Capital: Em vez de otimizar apenas pelo lucro nominal, a nossa métrica divide o lucro pelo rebaixamento máximo de capital líquido. Isso prioriza setups com baixíssimo risco patrimonial.
  • Fator de Lucro: Acelera o score dos setups que possuem um histórico com alta taxa de acerto e proporção ganho/perda de elite.
  • Penalização Estatística Rigorosa: Se o setup realizar menos de 30 operações no período histórico selecionado, o score sofre uma redução drástica (penalização quadrática). Isso força o otimizador genético a descartar setups que deram "lucro de sorte" em poucos trades e focar na consistência estatística de grandes amostras de dados.

Como Otimizar usando o Genético do MT5

  1. Abra o Provador de Estratégias (Ctrl + R) no seu MetaTrader 5.
  2. Selecione o robô TheWise Structural Premises V1.mq5.
  3. Ative a opção de Otimização e mude para "Algoritmo Genético Completo".
  4. No seletor de critério ao lado, escolha "Métrica Personalizada" (ou Custom Criterion).
  5. Marque as caixas de variáveis dos parâmetros que você quer otimizar (ex: m_tsp_score_min de 5 a 15, Fibo Sup de 38 a 61, etc.) e clique em Iniciar.

O Teste Definitivo: Walk Forward Analysis (WFA)

O Walk Forward divide o período de testes em duas etapas automáticas: In-Sample (onde o robô aprende e otimiza os parâmetros) e Out-of-Sample / Forward (onde o robô é executado em dados de mercado inéditos que ele nunca viu).

  • Configuração sugerida: Ative a aba Forward no MT5 e defina como 1/4 ou 1/3.
  • Verificação de Robustez: Se as configurações otimizadas passarem com lucro e baixo drawdown no período Forward (o último 1/4 do tempo total), você tem um setup blindado e matematicamente provado contra as mudanças de comportamento do mercado.

Solução de Erros Comuns & Praticidade com Arquivos .SET

Erro: "no optimized parameter selected, please check input(s) to be optimized and set start, step and stop values"

Este erro ocorre quando você ativa a otimização no MT5, mas não seleciona quais parâmetros ele deve alterar durante os testes. Para resolver:

  1. Vá na aba Parâmetros de Entrada (Inputs) no Strategy Tester.
  2. Marque a caixinha de seleção (checkbox) na coluna esquerda dos parâmetros que deseja otimizar (ex: m_tsp_score_min).
  3. Configure os valores das colunas Início (Start), Passo (Step) e Fim (Stop) para definir a faixa de testes do MT5.

💡 Como automatizar usando Arquivos de Parâmetros (.SET):

Para não precisar marcar e configurar as caixinhas de variáveis manualmente todas as vezes:

  • Salvar Configuração: Clique com o botão direito sobre a tabela de parâmetros de entrada no Strategy Tester e clique em Salvar (Save) para gerar um arquivo .set.
  • Carregar Configuração: Em qualquer outro ativo ou teste futuro, clique com o botão direito sobre a tabela de parâmetros, selecione Carregar (Load), abra o arquivo .set e o MT5 preencherá automaticamente todas as caixas, inícios, passos e fins!
TheWise Portfolio Sentinel (TWS) — O Espião de Elite

O TheWise Portfolio Sentinel (TWS) é um terminal quantitativo de portfólio standalone que opera integrado em tempo real ao MetaTrader 5, monitorando, consolidando e segmentando todas as operações da conta de forma autônoma.

Funcionamento e Transmissão Global

O robô espião TheWise_Portfolio_Monitor.mq5 deve ser colocado em apenas um gráfico qualquer da sua conta. Em vez de ler apenas aquele gráfico, ele monitora silenciosamente a **conta inteira de forma global**, capturando:

  • Saldo, Patrimônio Líquido, Margem Usada e Margem Livre da Corretora.
  • Todas as posições abertas na conta (lotes, preço de entrada, SL, TP e P/L).
  • O histórico recente de operações fechadas (lucro líquido consolidado).

Painel de Telemetria no MT5 (On-Chart Comment)

Ao compilar e arrastar o espião para o gráfico, ele desenha um painel de status dinâmico e discreto no topo esquerdo do gráfico do seu MetaTrader 5 para dar a você total feedback visual:

  • CONECTADO 🟢 (Sincronizado com Sucesso): Indica que o servidor local Flask (porta 5000) está ativo e recebendo as atualizações. A hora do último sinal é atualizada na tela a cada 5 segundos.
  • ERRO DE CONEXÃO 🔴 (Causa: URL NÃO AUTORIZADA): O MetaTrader barrou o envio dos dados. Vá em Ferramentas ➡️ Opções ➡️ Experts, marque a caixa de WebRequest e adicione a URL http://127.0.0.1:5000.
  • ERRO DE CONEXÃO 🔴 (Código MT5: 4060): O servidor web está desligado. Execute o arquivo LIGAR_PORTFOLIO.bat na pasta do Sentinel para reativar a porta 5000.

Segmentação por Magic Numbers

O painel web do Sentinel divide as operações de forma inteligente baseado nos Magic Numbers (IDs de robô):

  • Operações Manuais: Ordens enviadas por cliques manuais possuem Magic = 0. O Sentinel as categoriza como "Manual" 👤.
  • Robô TSP: O robô de premissas estruturais opera com Magic = 2026. O Sentinel as agrupa como "TSP Robô" 🤖.
  • Outros Robôs: Qualquer outra ordem com número mágico diferente é agrupada separadamente, mantendo o gráfico de pizza de volume e lucro líquido sempre preciso!

Switcher de 4 Temas & Gráficos Adaptativos

O painel web do Sentinel conta com um seletor dinâmico no topo do cabeçalho que permite alternar instantaneamente entre quatro temas premium:

  • 🌌 Classic Navy (TSP Era): Visual institucional azul profundo e realces dourados.
  • ⚡ Cyberpunk Glow: Visual de alta tecnologia com tons pretos e neons rosa e azul.
  • 🟢 Matrix Green: Visual de terminal hacker clássico em verde fosforescente.
  • ⚪ Institutional Light: Visual claro limpo, com fundo cinza e realces em azul royal.

💡 Gráficos Adaptativos: Os gráficos de patrimônio e ativos (Chart.js) lêem as cores do CSS ativo no navegador e se pintam automaticamente com as mesmas cores do tema selecionado, mantendo a harmonia visual na hora!