npp-hft-winv25-scalper/Manual_Configuracao_Robot_HFT_WINQ25.md

# Manual de Configuração - Robô HFT Scalper WINV25

## 📋 Índice
1. [Visão Geral](#visão-geral)
2. [Pré-requisitos](#pré-requisitos)
3. [Instalação do Robô](#instalação-do-robô)
4. [Configuração da Plataforma](#configuração-da-plataforma)
5. [Configuração dos Parâmetros](#configuração-dos-parâmetros)
6. [Ativação e Monitoramento](#ativação-e-monitoramento)
7. [Configurações de Segurança](#configurações-de-segurança)
8. [Solução de Problemas](#solução-de-problemas)
9. [Backtest e Otimização](#backtest-e-otimização)

---

## 🎯 Visão Geral

Este robô HFT (High Frequency Trading) foi desenvolvido para operar no futuro WINV25 da BMF usando estratégias de scalping baseadas em price action. O robô executa operações de curta duração com foco em pequenos lucros consistentes.

### Características Principais:
- ⏰ Operação: 08:55 às 18:00 (Segunda a Sexta)
- 📊 Timeframe: M1 (1 minuto)
- 📈 Estratégia: Price Action + Scalping
- 🎯 Take Profit: 15 pontos (configurável)
- 🛡️ Stop Loss: 10 pontos (configurável)
- ⚡ Tempo máximo em posição: 5 minutos

---

## ✅ Pré-requisitos

### 1. Software Necessário
- **Nelogica Profit Pro versão 5.0** ou superior
- Conta de treino ou real na corretora
- Conexão estável com a internet (recomendado: banda >= 10Mbps)

### 2. Configurações do Sistema
- **RAM**: Mínimo 8GB (recomendado 16GB)
- **Processador**: Intel i5 ou AMD Ryzen 5 (ou superior)
- **Latência**: Menor que 50ms para os servidores da BMF

### 3. Permissões de Conta
- Autorização para operar futuros BMF
- Limite de capital suficiente para as operações
- API habilitada para trading automatizado

---

## 🚀 Instalação do Robô

### Passo 1: Preparar o Arquivo
1. Salve o arquivo `WINV25_HFT_Scalper.ntsl` em uma pasta de fácil acesso
2. Verifique se a extensão do arquivo está correta (.ntsl)

### Passo 2: Abrir a Plataforma Nelogica
1. Inicie o **Nelogica Profit Pro 5.0**
2. Faça login com suas credenciais
3. Certifique-se de estar conectado aos feeds de dados da BMF

### Passo 3: Acessar o Editor de Estratégias
1. No menu principal, clique em **"Análise"**
2. Selecione **"Editor de Estratégias"** ou pressione `Ctrl+E`
3. Uma nova janela do editor será aberta

### Passo 4: Importar o Código
1. No editor, clique em **"Arquivo"** → **"Novo"**
2. Copie todo o conteúdo do arquivo `WINV25_HFT_Scalper.ntsl`
3. Cole no editor da Nelogica
4. Salve com o nome: **"WINV25_HFT_Scalper"**

### Passo 5: Compilar o Código
1. Pressione `F7` ou clique em **"Compilar"**
2. Verifique se não há erros na janela de output
3. Se houver erros, revise o código e corrija

---

## ⚙️ Configuração da Plataforma

### Passo 1: Configurar o Gráfico
1. Abra um gráfico do **WINV25**
2. Configure o timeframe para **1 minuto (M1)**
3. Certifique-se de que o histórico está carregado (mínimo 200 barras)

### Passo 2: Aplicar a Estratégia
1. Clique com o botão direito no gráfico
2. Selecione **"Inserir"** → **"Estratégia"**
3. Escolha **"WINV25_HFT_Scalper"** da lista
4. Clique em **"OK"**

### Passo 3: Configurar Conta de Trading
1. Vá em **"Trading"** → **"Configurações de Conta"**
2. Selecione sua conta de treino/real
3. Configure o **valor do tick** para WINV25: **R$ 0,20**
4. Defina o **tamanho do contrato**: **1 ponto = R$ 0,20**

---

## 🎛️ Configuração dos Parâmetros

### Parâmetros Principais

#### 1. **Gestão de Risco**
```
TakeProfit = 15          // Lucro alvo em pontos
StopLoss = 10            // Perda máxima em pontos
MaxPosicao = 1           // Quantidade máxima de contratos
TempoMaxPosicao = 5      // Tempo máximo em posição (minutos)
```

#### 2. **Break Even**
```
UsarBreakEven = true     // Ativar break even automático
PontosBreakEven = 8      // Pontos para ativar break even
```

#### 3. **Price Action**
```
PeriodoMA = 9            // Período da média móvel
MinVariacao = 5.0        // Variação mínima para entry
VolumeMinimo = 100       // Volume mínimo para validar sinal
```

### Configuração Recomendada para Iniciantes
```
TakeProfit = 10          // Mais conservador
StopLoss = 8             // Menor exposição ao risco
MaxPosicao = 1           // Apenas 1 contrato
TempoMaxPosicao = 3      // Posições ainda mais rápidas
UsarBreakEven = true
PontosBreakEven = 6
```

### Configuração para Contas Maiores
```
TakeProfit = 20          // Maior potencial de lucro
StopLoss = 12            // Stop proporcional
MaxPosicao = 2           // Até 2 contratos
TempoMaxPosicao = 7      // Mais tempo para desenvolver
```

---

## 🎮 Ativação e Monitoramento

### Passo 1: Ativar o Robô
1. No gráfico com a estratégia aplicada, clique com o botão direito
2. Selecione **"Propriedades da Estratégia"**
3. Na aba **"Execução"**, marque:
   - ✅ **"Executar em tempo real"**
   - ✅ **"Enviar ordens automaticamente"**
   - ✅ **"Confirmar ordens automaticamente"**

### Passo 2: Configurar Alertas
1. Vá em **"Ferramentas"** → **"Alertas"**
2. Configure alertas para:
   - Abertura de posição
   - Fechamento de posição
   - Ativação de stop loss
   - Problemas de conexão

### Passo 3: Monitorar o Log
1. Mantenha a janela **"Output"** aberta
2. Monitore as mensagens do robô:
   - `"COMPRA executada em: [preço]"`
   - `"VENDA executada em: [preço]"`
   - `"Break Even ativado"`
   - `"Posição fechada: [motivo]"`

### Passo 4: Acompanhar Performance
1. Use a aba **"Relatórios"** para ver:
   - Número de operações
   - Taxa de acerto
   - Profit Factor
   - Drawdown máximo

---

## 🛡️ Configurações de Segurança

### 1. Limites de Perda
```
- Configure stop loss diário: R$ 500 (exemplo)
- Limite de operações por dia: 50
- Desligar robô após 3 stops consecutivos
```

### 2. Configuração no Profit Pro
1. Vá em **"Trading"** → **"Configurações de Risco"**
2. Configure:
   - **Perda máxima diária**: R$ 500,00
   - **Número máximo de operações**: 50
   - **Stop automático**: Após 3 perdas consecutivas

### 3. Backup e Monitoramento
1. Salve logs diariamente
2. Configure alertas no celular
3. Mantenha sempre um plano B manual

---

## 🔧 Solução de Problemas

### Problema 1: Robô não executa ordens
**Possíveis causas:**
- Conta não autorizada para trading automatizado
- Configuração de execução desabilitada
- Problemas de conexão

**Soluções:**
1. Verificar configurações de conta
2. Reativar execução automática
3. Verificar status da conexão

### Problema 2: Muitas operações perdendo
**Possíveis causas:**
- Mercado lateral
- Parâmetros inadequados
- Condições de mercado atípicas

**Soluções:**
1. Ajustar `MinVariacao` para 7.0
2. Aumentar `IntervaloCooldown` para 5 minutos
3. Reduzir `MaxPosicao` para 1

### Problema 3: Robô para de funcionar
**Possíveis causas:**
- Erro de compilação
- Falta de dados históricos
- Problemas de memória

**Soluções:**
1. Recompilar o código
2. Recarregar histórico do gráfico
3. Reiniciar a plataforma

---

## 📊 Backtest e Otimização

### Passo 1: Executar Backtest
1. No gráfico, clique com botão direito
2. Selecione **"Executar Backtest"**
3. Configure o período: **últimos 3 meses**
4. Execute e analise os resultados

### Passo 2: Métricas Importantes
- **Profit Factor**: > 1.3 (bom), > 1.5 (excelente)
- **Taxa de Acerto**: > 55%
- **Drawdown Máximo**: < 15%
- **Sharpe Ratio**: > 1.0

### Passo 3: Otimização de Parâmetros
1. Use o **Otimizador da Nelogica**
2. Otimize em ordem de prioridade:
   - `TakeProfit` (range: 10-25)
   - `StopLoss` (range: 6-15)
   - `PeriodoMA` (range: 6-15)
   - `MinVariacao` (range: 3-10)

### Passo 4: Validação Forward
1. Após otimização, teste em período out-of-sample
2. Use conta demo por pelo menos 1 semana
3. Só depois migre para conta real

---

## 📞 Suporte e Contato

### Em caso de dúvidas:
1. Consulte a documentação da Nelogica
2. Verifique os logs do sistema
3. Teste sempre em conta demo primeiro

### Boas Práticas:
- ✅ Sempre monitore o robô durante as primeiras operações
- ✅ Mantenha backups das configurações
- ✅ Atualize regularmente os parâmetros baseado na performance
- ✅ Nunca deixe o robô operar sem supervisão inicial
- ✅ Use stop loss diário para proteção adicional

---

## ⚠️ Disclaimer

**ATENÇÃO:** Trading automatizado envolve riscos significativos. Este robô é fornecido apenas para fins educacionais e de teste. Sempre teste extensivamente em conta demo antes de usar capital real. O desenvolvedor não se responsabiliza por perdas financeiras decorrentes do uso deste software.

---

**Versão do Manual:** 1.0  
**Data:** 2024  
**Compatibilidade:** Nelogica Profit Pro 5.0+