npp-hft-wdou25-scalper/README.md

# 🤖 Robô HFT WDOU25 Scalper - Nelogica Profit Pro 5.0

## 📋 Visão Geral

Este robô HFT (High Frequency Trading) foi desenvolvido para operar **WDOU25** (Mini Dólar Futuro) durante o horário específico de **abertura do leilão BMF** (08:55 às 09:15), realizando operações de scalping com base na análise do booking de ofertas, Super DOM e Times & Trades.

### ⚠️ **IMPORTANTE: SEMPRE TESTE EM AMBIENTE DE SIMULAÇÃO PRIMEIRO**

---

## 🛠️ Requisitos do Sistema

### Plataforma
- **Nelogica Profit Pro versão 5.0** ou superior
- **Conta ativa** na corretora compatível com Nelogica
- **Conta de treino/simulação** para testes iniciais

### Permissões Necessárias
- ✅ Acesso ao mercado de futuros BMF
- ✅ Permissão para trading automatizado
- ✅ Acesso ao WDOU25 (Mini Dólar Futuro)
- ✅ Dados em tempo real (Level 2 - Booking)

---

## 📥 Instalação Passo a Passo

### 1️⃣ **Preparação dos Arquivos**

1. **Baixe os arquivos do robô:**
   - `robo_hft_wdou25_scalper.ntsl` (código principal)
   - `config_wdou25_scalper.txt` (configurações)
   - `README.md` (este guia)

2. **Crie uma pasta dedicada:**
   ```
   C:\Nelogica\Scripts\WDOU25_HFT_Scalper\
   ```

3. **Copie os arquivos** para esta pasta

### 2️⃣ **Configuração da Plataforma Nelogica**

1. **Abra o Profit Pro 5.0**

2. **Configure a conta de treino:**
   - Vá em `Arquivo` > `Configurações` > `Contas`
   - Selecione **Conta de Simulação/Treino**
   - Defina saldo inicial (recomendado: R$ 50.000)

3. **Ative dados em tempo real:**
   - Menu `Dados` > `Configurações de Mercado`
   - Marque **BMF - Futuros**
   - Ative **Level 2 (Booking de Ofertas)**
   - Confirme **Times & Trades**

### 3️⃣ **Configuração do WDOU25**

1. **Adicione o ativo:**
   - Menu `Mercado` > `Lista de Ativos`
   - Procure por **WDOU25**
   - Adicione à lista de favoritos

2. **Configure parâmetros do ativo:**
   - Clique com botão direito em **WDOU25**
   - Selecione `Propriedades do Ativo`
   - Configure:
     ```
     Tick Size: 0.5
     Valor do Ponto: R$ 0,50
     Lote Mínimo: 1 contrato
     Margem: Conforme sua corretora
     ```

### 4️⃣ **Configuração do Super DOM**

1. **Abra o Super DOM para WDOU25:**
   - Clique com botão direito em **WDOU25**
   - Selecione `Abrir Super DOM`

2. **Configure o Super DOM:**
   - **Níveis de preço:** 20 (10 acima, 10 abaixo)
   - **Atualização:** Tempo real
   - **Agregação de volume:** Ativada
   - **Cores:** 
     - Verde para compras
     - Vermelho para vendas
     - Azul para volumes neutros

3. **Posicione a janela** de forma visível para monitoramento

### 5️⃣ **Configuração do Booking de Ofertas**

1. **Ative o Level 2:**
   - Menu `Janelas` > `Booking de Ofertas`
   - Selecione **WDOU25**

2. **Configure visualização:**
   - **Profundidade:** 10 níveis
   - **Atualização:** Contínua
   - **Colunas visíveis:**
     - Preço de Compra
     - Volume de Compra
     - Preço de Venda
     - Volume de Venda

### 6️⃣ **Configuração do Times & Trades**

1. **Abra a janela Times & Trades:**
   - Menu `Janelas` > `Times & Trades`
   - Selecione **WDOU25**

2. **Configure filtros:**
   - **Volume mínimo:** 5 contratos
   - **Histórico:** Últimas 1000 negociações
   - **Cores por direção:** Ativado

### 7️⃣ **Carregamento do Robô**

1. **Abra o Editor de Scripts:**
   - Menu `Ferramentas` > `Editor NTSL`

2. **Importe o script:**
   - `Arquivo` > `Abrir`
   - Selecione `robo_hft_wdou25_scalper.ntsl`

3. **Compile o script:**
   - Pressione `F7` ou clique em `Compilar`
   - **Verifique se não há erros**

4. **Aplique ao gráfico:**
   - Abra um gráfico de **WDOU25** (tick ou 1 segundo)
   - Arraste o script compilado para o gráfico
   - Ou clique com botão direito > `Inserir Indicador/Sistema`

### 8️⃣ **Configuração de Parâmetros**

1. **Ajuste os parâmetros iniciais:**
   ```
   TakeProfit: 4 pontos
   StopLoss: 6 pontos
   QuantidadeContratos: 1
   MaxOperacoesDia: 20
   HorarioInicioHora: 8
   HorarioInicioMinuto: 55
   HorarioFimHora: 9
   HorarioFimMinuto: 15
   VolumeMinimo: 100
   DiferencaBooking: 2
   ```

2. **Para ajustar parâmetros:**
   - Clique com botão direito no gráfico
   - Selecione `Propriedades do Sistema`
   - Modifique os valores conforme necessário

---

## 🧪 Testes em Ambiente de Simulação

### ⚠️ **CRÍTICO: Sempre teste antes de usar conta real**

1. **Ative o modo simulação:**
   - Certifique-se que está usando conta de treino
   - Verifique o ícone "SIM" na barra de status

2. **Teste durante horário real:**
   - **Segunda a sexta, 08:55 às 09:15**
   - Monitore o comportamento do robô
   - Anote todas as operações realizadas

3. **Verificações importantes:**
   - ✅ Robô ativa apenas no horário correto
   - ✅ Ordens são enviadas corretamente
   - ✅ Stop Loss e Take Profit funcionam
   - ✅ Não excede o limite de operações
   - ✅ Fecha posições ao final do horário

---

## 🔒 Configurações de Segurança

### 1️⃣ **Limites de Risco**

1. **Configure na corretora:**
   - **Limite diário de perda:** R$ 500,00
   - **Limite de posição:** 5 contratos
   - **Limite de operações:** 50 por dia

2. **Monitore constantemente:**
   - Mantenha sempre supervisão visual
   - Tenha botão de "Emergência" configurado

### 2️⃣ **Configuração de Emergência**

1. **Botão de Parada:**
   - Configure hotkey para parar o robô
   - Sugestão: `Ctrl + Shift + S`

2. **Fechamento forçado:**
   - Configure botão para fechar todas as posições
   - Sugestão: `Ctrl + Shift + F`

---

## 📊 Monitoramento e Logs

### 1️⃣ **Logs do Sistema**

1. **Ative logs detalhados:**
   - Menu `Ferramentas` > `Configurações`
   - Seção `Logs e Auditoria`
   - Ative **Log de Trading Automatizado**

2. **Localização dos logs:**
   ```
   C:\Users\[Usuario]\AppData\Local\Nelogica\Logs\
   ```

### 2️⃣ **Monitoramento em Tempo Real**

**Janelas essenciais abertas:**
- ✅ Gráfico com o robô
- ✅ Super DOM do WDOU25
- ✅ Booking de Ofertas
- ✅ Times & Trades
- ✅ Posições abertas
- ✅ Ordens pendentes

**Métricas para acompanhar:**
- Número de operações realizadas
- P&L acumulado
- Drawdown máximo
- Tempo médio em posição

---

## ⚙️ Configurações Avançadas

### 1️⃣ **Otimização de Performance**

1. **Configurações de rede:**
   - Use conexão com baixa latência
   - Configure QoS para priorizar Nelogica
   - Evite outros softwares pesados durante operação

2. **Configurações do Windows:**
   - Desative Windows Update durante horário de operação
   - Configure energia para "Alto desempenho"
   - Feche aplicativos desnecessários

### 2️⃣ **Personalização de Parâmetros**

Para ajustar conforme seu perfil de risco:

**Conservador:**
```
TakeProfit: 3
StopLoss: 4
MaxOperacoesDia: 10
VolumeMinimo: 200
```

**Moderado (padrão):**
```
TakeProfit: 4
StopLoss: 6
MaxOperacoesDia: 20
VolumeMinimo: 100
```

**Agressivo:**
```
TakeProfit: 6
StopLoss: 8
MaxOperacoesDia: 30
VolumeMinimo: 50
```

---

## 🚨 Solução de Problemas

### ❌ **Problemas Comuns**

#### 1. **Robô não executa operações**
**Possíveis causas:**
- Horário fora do permitido (08:55-09:15)
- Volume insuficiente no mercado
- Spread muito alto
- Conta não autorizada para trading automatizado

**Solução:**
- Verifique horário do sistema
- Confirme dados em tempo real ativos
- Verifique configurações da conta

#### 2. **Ordens não são enviadas**
**Possíveis causas:**
- Problemas de conectividade
- Saldo insuficiente
- Limites de risco atingidos

**Solução:**
- Verifique conexão com servidor
- Confirme saldo disponível
- Revise limites de risco

#### 3. **Muitas operações sendo realizadas**
**Possível causa:**
- Parâmetros muito agressivos
- Mercado muito volátil

**Solução:**
- Aumente `DiferencaBooking`
- Diminua `MaxOperacoesDia`
- Aumente `VolumeMinimo`

#### 4. **Take Profit não executando**
**Possíveis causas:**
- Mercado movendo contra a posição
- Gap de preços
- Problemas de liquidez

**Solução:**
- Revise parâmetros de TP/SL
- Monitore spread do mercado
- Considere usar ordens de mercado para saída

### 📞 **Suporte**

#### Logs importantes para diagnóstico:
1. **Log de execução do robô**
2. **Log de ordens da corretora**
3. **Configurações atuais dos parâmetros**
4. **Horário exato do problema**

---

## 📈 Análise de Performance

### 📊 **Métricas Recomendadas**

Monitore diariamente:

1. **Operacionais:**
   - Número de trades por dia
   - Taxa de acerto (%)
   - Profit Factor
   - Drawdown máximo

2. **Financeiras:**
   - P&L diário
   - P&L acumulado semanal
   - Custo médio por operação
   - Retorno sobre margem

3. **Risco:**
   - Maior perda individual
   - Sequência de perdas
   - Exposição máxima
   - Tempo médio em risco

### 📝 **Planilha de Controle**

Crie uma planilha com as colunas:
```
Data | Hora | Tipo | Entrada | Saída | Resultado | Observações
```

---

## ⚖️ **Aspectos Legais e Éticos**

### ⚠️ **Responsabilidades**

1. **O usuário é totalmente responsável:**
   - Por todas as operações realizadas
   - Por perdas financeiras
   - Por configurações inadequadas
   - Por uso em conta real sem testes

2. **Este robô é fornecido "como está":**
   - Sem garantias de lucro
   - Sem garantias de funcionamento
   - Para fins educacionais e de teste

3. **Recomendações:**
   - Sempre opere com capital que pode perder
   - Mantenha supervisão constante
   - Teste exaustivamente antes do uso real
   - Consulte profissionais qualificados

---

## 🔄 **Atualizações e Manutenção**

### 📅 **Manutenção Periódica**

**Diariamente:**
- Verificar logs de erro
- Revisar performance
- Backup das configurações

**Semanalmente:**
- Analisar métricas de performance
- Ajustar parâmetros se necessário
- Verificar atualizações da plataforma

**Mensalmente:**
- Revisar estratégia completa
- Avaliar necessidade de ajustes
- Documentar lições aprendidas

### 🔄 **Versionamento**

**Versão atual:** 1.0
- Funcionalidade base implementada
- Horário de operação configurado
- Sistema de segurança básico

**Próximas versões planejadas:**
- v1.1: Melhorias na análise de volume
- v1.2: Filtros adicionais de entrada
- v1.3: Dashboard de monitoramento

---

## 💡 **Dicas de Otimização**

### 🎯 **Para Melhor Performance**

1. **Ambiente ideal:**
   - Computador dedicado para trading
   - Conexão de internet estável e rápida
   - Monitor duplo (recomendado)
   - UPS (No-break) para energia

2. **Configuração de workspace:**
   - Salve layout das janelas
   - Configure alertas sonoros
   - Mantenha calculadora de risco aberta

3. **Preparação diária:**
   - Chegue 10 minutos antes (08:45)
   - Verifique conexões
   - Confirme dados em tempo real
   - Teste função de parada de emergência

### 📚 **Aprendizado Contínuo**

1. **Estude o mercado:**
   - Comporte-se do WDOU25 na abertura
   - Padrões de volume e volatilidade
   - Correlações com outros ativos

2. **Mantenha registro:**
   - Screenshot de operações importantes
   - Anotações sobre condições de mercado
   - Ideias para melhorias

---

## 📞 **Contato e Suporte**

### 🆘 **Em caso de problemas**

1. **Primeiro:** Pause o robô imediatamente
2. **Segundo:** Feche posições abertas manualmente
3. **Terceiro:** Documente o problema com screenshots
4. **Quarto:** Revise este guia para soluções

### 📧 **Informações para suporte**

Sempre inclua:
- Versão da Nelogica Profit Pro
- Configurações utilizadas
- Logs de erro
- Horário exato do problema
- Descrição detalhada do comportamento inesperado

---

## ✅ **Checklist de Instalação**

Use este checklist para garantir instalação completa:

### Pré-requisitos
- [ ] Nelogica Profit Pro 5.0 instalado
- [ ] Conta de simulação configurada
- [ ] Acesso ao WDOU25 confirmado
- [ ] Dados em tempo real ativos

### Arquivos
- [ ] `robo_hft_wdou25_scalper.ntsl` baixado
- [ ] Arquivo compilado sem erros
- [ ] Script aplicado ao gráfico

### Configurações de Mercado
- [ ] Super DOM configurado
- [ ] Booking de ofertas ativo
- [ ] Times & Trades configurado
- [ ] Parâmetros ajustados

### Segurança
- [ ] Conta de simulação selecionada
- [ ] Limites de risco configurados
- [ ] Botão de emergência testado
- [ ] Logs ativados

### Teste
- [ ] Robô testado em horário real
- [ ] Operações executadas corretamente
- [ ] Performance monitorada
- [ ] Documentação das operações

---

**⚠️ LEMBRE-SE: Este robô é uma ferramenta. O sucesso depende de configuração adequada, monitoramento constante e gestão de risco responsável.**

**🎯 BOA SORTE E TRADE COM RESPONSABILIDADE!**