This repository has been archived on 2025-12-11. You can view files and clone it, but you cannot make any changes to its state, such as pushing and creating new issues, pull requests or comments.
npp-hft-wdou25-scalper/README.md
Marcos Paulo cfdfc5bdad dbg hft
2025-07-31 10:25:28 -03:00

521 lines
No EOL
12 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🤖 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!**