Robo GR Estrategista Trader
Manual de Utilizacao - Versao 5.5
Guia completo de instalacao, configuracao e operacao
estrategistatrader.com.br
1. Introducao
O Robo GR Estrategista Trader e uma plataforma de automacao para operacoes em Day Trade, projetada para trabalhar em conjunto com plataformas de negociacao como Profit Ultra e BlackArrow Ultra. O sistema utiliza leitura OCR (Reconhecimento Optico de Caracteres) para monitorar indicadores da plataforma em tempo real e executar acoes automaticas de gestao de risco e reducao de posicao.
Principais funcionalidades:
- Monitoramento em tempo real de MEP, MEN, Resultado Aberto e Resultado do Dia
- Zeragem automatica ao atingir metas de ganho ou limites de perda
- Reducao escalonada de posicao (sizing) para controle de lote
- Hedge entre contas e protecao contra inversao de posicao
- Suporte a multiplos profits simultaneos (modo Multi - plano PRO)
- Diagnostico OCR com screenshots e metricas de qualidade
- Interface web moderna com painel de indicadores em tempo real
IMPORTANTE
O robo NAO executa ordens de compra/venda por conta propria. Ele atua exclusivamente na GESTAO DE RISCO: zerando posicoes quando metas sao atingidas e reduzindo lotes quando limites sao ultrapassados. As entradas (trades) sao feitas pelo trader.
2. Primeiros Passos
2.1 Instalacao
Execute o instalador RoboGRProfit_Setup_v5.5.exe. O instalador ira:
- Copiar os arquivos do programa para a pasta escolhida
- Verificar se o Tesseract OCR esta instalado (necessario para leitura)
- Criar atalhos no Desktop e Menu Iniciar
- Instalar o WebView2 Runtime (se necessario)
PRE-REQUISITO: TESSERACT OCR
O Tesseract OCR e obrigatorio para o funcionamento do robo. Se nao estiver instalado, baixe em: github.com/tesseract-ocr/tesseract
Instale na pasta padrao: C:\Program Files\Tesseract-OCR
O instalador tenta detectar automaticamente, mas verifique a instalacao.
2.2 Primeiro Login
Ao abrir o programa pela primeira vez, voce vera a tela de login. Se ainda nao possui uma conta:
- Clique em "Criar conta" na tela de login
- Preencha usuario, senha e email
- O sistema criara sua conta com status "pendente"
- Aguarde a ativacao pelo administrador (o admin define seu plano e licenca)
- Apos ativacao, faca login normalmente
2.3 GR-ID (Identificador de Instalacao)
O GR-ID e um identificador unico gerado automaticamente para cada instalacao do programa. Ele serve para:
- Identificar sua maquina junto ao administrador
- Controlar o licenciamento (1 licenca por instalacao)
- Voce pode ver e copiar seu GR-ID no perfil (canto superior direito)
2.4 Fluxo Correto para Comecar
Siga esta sequencia para configurar e iniciar o robo:
- Abra a plataforma de negociacao (Profit ou BlackArrow)
- Posicione a janela no monitor desejado
- Abra o Robo GR e faca login
- Va em Config > Selecione o monitor correto
- Adicione/edite o profit (associar a janela da plataforma)
- Calibre as regioes de leitura OCR e botoes
- Use "Preview" para testar cada calibracao
- Volte para Inicio e clique "Iniciar"
3. Interface do Painel
A interface e dividida em 3 abas principais acessiveis pela barra de navegacao superior: Inicio, Config e Ajuda.
3.1 Aba Inicio (Home)
A aba principal mostra:
- Controles: Botoes Iniciar, Pausar, Retomar e Encerrar o robo
- Seletor de modo: Single ou Multi, selecao de plataforma e profit
- Painel de indicadores em tempo real (faixa colorida):
| Indicador | Descricao | Cor |
|---|
| MEP | Maior Exposicao Positiva (pico de ganho) | Verde |
| MEN | Maior Exposicao Negativa (pico de perda) | Vermelho |
| Res.Aberto | Resultado aberto da posicao atual | Azul/Verm. |
| Res.Dia | Resultado acumulado do dia | Verde/Verm. |
| Lotes | Numero de contratos na posicao | Azul |
| Excedente | Contratos acima do lote maximo | Laranja |
| Reduzidos | Contratos ja reduzidos na sessao | Cyan |
| Direcao | Comprado (C) ou Vendido (V) | Verde/Verm. |
- Informacoes de conta: Conta Padrao e Conta Geral
- Acoes rapidas: Atualizar Leitura, Limpar dados, Limpar logs, Copiar logs
- Status: OCR % (qualidade de leitura), Status de monitoramento, Dia bloqueado
- Cards de profit (modo Multi): painel individual por profit com indicadores
3.2 Aba Config (Configuracoes)
A aba de configuracao permite:
- Selecionar o monitor onde a plataforma esta aberta
- Visualizar e selecionar janelas de plataforma disponiveis
- Adicionar, editar e remover profits
- Calibrar regioes OCR e posicoes de botoes
- Configurar parametros de risco e sizing por profit
- Salvar/carregar templates de calibracao
- Ajustar timers globais (ciclo, transicao, zeragem)
3.3 Aba Ajuda
Contem FAQ com perguntas frequentes organizadas por categoria, alem do link para download deste manual.
3.4 Perfil (Canto Superior Direito)
Ao clicar no icone de perfil, voce ve:
- Seu GR-ID (com botao de copiar)
- Plano atual (Free, Starter ou Pro)
- Validade da licenca e dias restantes
- Botao de logout
4. Configuracao de Profits
Um "profit" representa uma instancia da plataforma de negociacao que o robo ira monitorar. Cada profit tem sua propria configuracao de regioes OCR, botoes e parametros de risco.
4.1 Adicionando um Profit
- Va em Config
- Selecione o monitor onde a plataforma esta aberta
- Clique em "Atualizar janelas" para listar as plataformas disponiveis
- Selecione a janela desejada na lista
- De um nome ao profit (ex: "Mini Indice", "Mini Dolar")
- Clique em "Adicionar" para criar o profit
4.2 Calibracao de Regioes OCR
A calibracao define quais areas da tela o robo deve ler via OCR. Cada regiao e definida por coordenadas [x, y, largura, altura].
| Regiao | O que le | Obrigatorio |
|---|
| regiao_risco | Painel de risco (MEP/MEN) | Sim (se risco ativo) |
| regiao_res_aberto | Resultado aberto da posicao | Sim |
| regiao_res_dia | Resultado acumulado do dia | Sim |
| regiao_pos_total | Total de contratos | Sim (se sizing) |
| regiao_conta_padrao | Valor conta padrao | Se hedge ativo |
| regiao_conta_geral | Valor conta geral | Se hedge ativo |
| regiao_aviso_sem_pos | Aviso "Sem posicao" | Recomendado |
| regiao_direcao_sizing | Direcao (C/V) | Se sizing ativo |
| regiao_total | Total para sizing | Se sizing ativo |
Para calibrar: clique no botao "Calibrar" ao lado de cada regiao. O sistema ira capturar a area selecionada. Use "Preview" para verificar se a leitura OCR esta correta antes de salvar.
4.3 Calibracao de Botoes
O robo precisa saber a posicao exata dos botoes na plataforma para executar acoes de zeragem e envio de ordens.
| Botao | Funcao |
|---|
| pos_zerar | Botao de zeragem da posicao |
| pos_zerar_popup | Confirmacao do popup de zeragem |
| pos_zerar_seg | Botao de zeragem de seguranca |
| pos_zerar_seg_popup | Confirmacao do popup de seguranca |
| pos_compra | Botao de compra |
| pos_venda | Botao de venda |
| pos_qtd_boleta | Campo de quantidade na boleta |
| pos_enviar_popup | Botao de envio/confirmacao |
4.4 Preview e Teste
Apos calibrar cada regiao, utilize a funcao "Preview" para verificar:
- Imagem capturada (original e processada para OCR)
- Texto extraido pelo OCR
- Valor numerico interpretado (para regioes financeiras)
- Cor detectada (verde para ganho, vermelho para perda)
DICA: TEMPLATES DE CALIBRACAO
Voce pode salvar a calibracao de um profit como template e reutilizar em outros profits que usam a mesma plataforma/resolucao. Va em Config > Templates para gerenciar seus templates salvos.
5. Modos de Execucao
5.1 Modo Single
No modo Single, o robo opera UM unico profit por vez. A plataforma fica em foco exclusivo e o robo le e age continuamente naquela janela.
- Disponivel para: todos os planos (Starter e Pro)
- Selecao: escolha qual profit operar no seletor da aba Inicio
- Vantagem: leitura mais rapida e estavel (sem troca de janela)
5.2 Modo Multi
No modo Multi, o robo opera VARIOS profits simultaneamente, alternando entre as janelas em sistema round-robin (rodizio).
- Disponivel para: plano PRO apenas (ate 3 profits)
- O robo alterna entre as janelas a cada ciclo
- Cada profit tem seu proprio painel de indicadores na aba Inicio
- Delay de transicao configuravel entre as trocas de janela
NOTA: PLANO STARTER
Usuarios do plano Starter estao limitados ao modo Single com 1 profit. O modo Multi e exclusivo do plano PRO.
6. Gestao de Risco
O sistema de gestao de risco e o nucleo do robo. Ele monitora indicadores da plataforma e executa zeragem automatica quando limites sao atingidos.
6.1 Meta Dia (Meta de Ganho e Limite de Perda)
Voce define dois limites diarios por profit:
- Meta de Ganho (meta_ganho): valor em R$ de lucro diario desejado
- Limite de Perda (meta_perda): valor em R$ de perda maxima diaria aceita
Quando o resultado do dia atinge qualquer uma dessas metas, o robo executa a zeragem automatica da posicao e bloqueia o dia.
6.2 MEP e MEN (Pico de Ganho e Perda)
MEP (Maior Exposicao Positiva) e MEN (Maior Exposicao Negativa) sao os picos de resultado registrados durante a sessao. O robo tambem pode acionar zeragem quando o pico atinge a meta:
- PICO_GANHO: MEP >= meta_ganho → zeragem automatica
- PICO_PERDA: MEN <= meta_perda (negativo) → zeragem automatica
6.3 Dia Bloqueado
Quando qualquer meta e atingida, o dia entra em estado "Bloqueado". Isso significa:
- O robo para de executar acoes de trading
- Se uma nova posicao surgir, o robo zera automaticamente
- O status "Dia Bloqueado: Sim" aparece no painel em laranja
- O bloqueio persiste ate o fim da sessao ou reset manual
6.4 Indicadores em Tempo Real
| Indicador | Descricao |
|---|
| Res. Aberto | Resultado financeiro da posicao aberta atual |
| Res. Dia | Resultado financeiro acumulado do dia |
| Lotes | Numero de contratos na posicao atual |
| Excedente | Lotes acima do lote maximo configurado |
| Direcao | C = Comprado (long) / V = Vendido (short) |
| OCR % | Percentual de leituras OCR bem-sucedidas |
7. Modulos de Protecao (PRO)
Os modulos de protecao estao disponiveis no plano PRO e oferecem camadas adicionais de seguranca para suas operacoes.
7.1 Reducao de Posicao (Sizing)
O modulo de Sizing monitora o numero de contratos e reduz a posicao quando ela excede o lote maximo configurado.
- lote_max: numero maximo de contratos aceitos na posicao
- lote_minimo: incremento minimo de lote (0.01, 0.1 ou 1)
- A reducao e feita de forma escalonada, enviando ordens parciais
- max_contratos_reducao: limite de contratos por ordem de reducao
- preco_contrato: valor unitario do contrato (para calculo financeiro)
7.2 Hedge entre Contas (Sobreposicao)
Compara o valor da Conta Padrao com a Conta Geral para detectar discrepancias entre contas (posicoes em contas diferentes).
- sobreposicao_tolerancia: diferenca tolerada (0 = qualquer diferenca aciona)
- Quando a diferenca excede a tolerancia, o robo age para corrigir
- Requer calibracao de: regiao_conta_padrao e regiao_conta_geral
7.3 Limite de Posicao
Impede que a posicao ultrapasse um numero maximo de contratos.
- hedge_max_contratos: limite maximo de contratos permitidos
- hedge_auto_max_contratos: limite para acionamento automatico
- hedge_pct_limite: percentual do limite (100% = limite total)
7.4 Emergencia de Lotes
Protecao de ultimo recurso quando a posicao atinge niveis criticos.
- emergencia_qtd_limite: quantidade que aciona a emergencia
- emergencia_qtd_acao: acao a tomar:
- "so_excedente": reduz apenas o excedente
- "zerar_tudo": zera toda a posicao
- Executa com prioridade maxima, ignorando delays normais
7.5 Anti-Inversao
Detecta inversao inesperada de posicao (ex: estava comprado e virou vendido sem ordem do trader) e executa zeragem de emergencia.
- inversao_protecao: ativar/desativar o modulo
- Requer calibracao da regiao de direcao (regiao_direcao_sizing)
- inversao_acao: acao ao detectar inversao (padrao: "zerar_tudo")
8. Planos e Licenciamento
O Robo GR opera com sistema de planos que definem os recursos disponiveis.
| Recurso | Free | Starter | Pro |
|---|
| Profits simultaneos | 0 | 1 | Ate 3 |
| Modo Single | Nao | Sim | Sim |
| Modo Multi | Nao | Nao | Sim |
| Monitor de Risco | Nao | Sim | Sim |
| Meta Dia (ganho/perda) | Nao | Sim | Sim |
| Reducao de Posicao | Nao | Nao | Sim |
| Hedge entre Contas | Nao | Nao | Sim |
| Limite de Posicao | Nao | Nao | Sim |
| Emergencia de Lotes | Nao | Nao | Sim |
| Anti-Inversao | Nao | Nao | Sim |
8.1 Licenca
Cada usuario possui uma licenca com:
- Chave unica (formato GR-XXXXX)
- Data de validade (definida pelo administrador)
- Numero maximo de profits (conforme o plano)
- A licenca e verificada a cada login
Para renovar sua licenca, entre em contato com o administrador. A quantidade de dias restantes e exibida no perfil.
9. Diagnostico e Logs
9.1 Tipos de Log
O robo gera logs detalhados organizados por data:
- geral.txt: log em texto simples (legivel por humanos)
- geral.jsonl: log estruturado em JSON (1 evento por linha)
- Localizacao: pasta logs/YYYY-MM-DD/ dentro do diretorio do programa
9.2 Tipos de Evento
| Tipo | Descricao |
|---|
| INICIO | Sessao iniciada |
| LEITURA | Leitura OCR realizada |
| RISCO | Acao de risco/zeragem executada |
| SIZING | Reducao de posicao executada |
| HEDGE | Acao de hedge executada |
| META | Meta de ganho/perda atingida |
| ALERTA | Aviso (sem posicao, descasamento) |
| ERRO | Erro de execucao ou leitura |
| ENCERRAMENTO | Sessao encerrada |
9.3 Screenshots de Diagnostico
Quando o OCR falha 3 vezes consecutivas na mesma regiao, o robo salva automaticamente uma screenshot da area para diagnostico. As imagens ficam em logs/YYYY-MM-DD/ocr_diag/ e podem ser visualizadas na aba de logs.
9.4 Indicador OCR %
O indicador OCR % mostra a taxa de sucesso das leituras. Valores abaixo de 80% indicam problemas de calibracao. Verifique:
- Se a janela da plataforma esta visivel e nao sobreposta
- Se a resolucao do monitor nao mudou desde a calibracao
- Se as regioes calibradas ainda correspondem aos indicadores corretos
9.5 Acoes de Log no Painel
- Copiar logs: copia os logs do mini-log para a area de transferencia
- Limpar logs: apaga todos os arquivos de log do dia atual e diagnosticos OCR
- Limpar dados: reseta o estado do gestor (indicadores, memoria, contadores)
10. Parametros Avancados
Estes parametros controlam o comportamento fino do robo. Altere com cuidado.
| Parametro | Padrao | Descricao |
|---|
| timer | 10s | Intervalo do ciclo principal de leitura |
| delay_transicao | 3s | Delay entre troca de janela (Multi) |
| timer_zeragem | 1s | Intervalo do ciclo de zeragem |
| delay_clique | 0.5s | Delay entre cliques em botoes |
| max_valor_plausivel | variavel | Valor OCR maximo aceito (acima = rejeitado) |
| preco_contrato | variavel | Valor unitario do contrato (R$) |
| max_contratos_reducao | variavel | Maximo de contratos por ordem de reducao |
| lote_minimo | 1 | Incremento minimo de lote (0.01/0.1/1) |
CUIDADO
Reduzir o "timer" para valores muito baixos (abaixo de 5s) pode causar uso excessivo de CPU e leituras instaveis. O valor recomendado e 10 segundos.
11. Problemas Comuns e Solucoes
O robo nao encontra a janela da plataforma
- Verifique se a plataforma (Profit/BlackArrow) esta aberta e visivel
- Clique em "Atualizar janelas" na aba Config
- Verifique se o monitor correto esta selecionado
- A janela nao pode estar minimizada
Os numeros nao atualizam / DESCASAMENTO
- Recalibre as regioes OCR (a janela pode ter mudado de posicao)
- Use "Preview" para testar cada regiao
- Verifique o indicador OCR % (deve estar acima de 80%)
- Nao sobreponha outras janelas sobre a plataforma
Erro de OCR frequente
- Aumente o valor de "max_valor_plausivel" se leituras validas estao sendo rejeitadas
- Verifique se o Tesseract OCR esta instalado corretamente
- Tente recalibrar com a plataforma em zoom 100%
- Veja as screenshots de diagnostico em logs/ocr_diag/
Licenca expirada ou inexistente
- Verifique os dias restantes no perfil
- Contate o administrador para renovacao
- O GR-ID deve corresponder ao registrado no sistema
O robo nao executa zeragem
- Verifique se o modulo de risco esta ativo (risco_ativo = true)
- Verifique se as metas estao configuradas (meta_ganho e meta_perda)
- Verifique se os botoes de zeragem estao calibrados corretamente
- Veja os logs para mensagens de erro
Interface nao abre / Tela em branco
- Verifique se o WebView2 Runtime esta instalado
- Tente executar como Administrador
- Verifique o arquivo logs/launcher_stderr.txt para erros
12. Suporte e Contato
Para suporte tecnico, duvidas ou renovacao de licenca:
estrategistatrader.com.br
Ao entrar em contato, tenha em maos:
- Seu GR-ID (visivel no perfil)
- Descricao do problema
- Screenshots da tela (se aplicavel)
- Logs do dia (use "Copiar logs" no painel)
Robo GR Estrategista Trader v5.5 — Todos os direitos reservados
estrategistatrader.com.br