O que a plataforma faz
A Nzila transforma uma regra de leitura do mercado em um processo que pode ser repetido e auditado. O motor observa preços, verifica condições e registra por que uma tentativa avançou ou foi descartada. Quando existe um plano válido, a conta paper simula a abertura, a condução e o encerramento da posição.
- Experimento
- A configuração que você salva: nome, fonte de preços, instrumento, presets, saldo inicial e risco. Pense nele como a receita do teste.
- Execução (run)
- Uma rodada do motor, identificada por um número e uma configuração. Um experimento com dois presets cria duas runs independentes. Nem toda run do sistema tem uma conta paper: também existem execuções de análise e replay.
- Conta simulada
- O saldo, a posição e os resultados associados a uma run paper. Cada preset recebe seu próprio saldo inicial, sem dividir uma carteira comum.
- Operação
- Uma posição de compra ou venda dentro da conta. Pode estar aberta, com resultado ainda variável, ou encerrada, com resultado realizado.
Histórico, monitoramento e paper não são a mesma coisa
Replay descreve o uso de velas históricas para repetir uma sequência. Monitor observa e registra as decisões, sem executar uma conta paper. Paper acrescenta a simulação financeira e pode usar histórico ou um feed de mercado. No dashboard, iniciar um experimento aciona paper com a fonte escolhida. Um preço ao vivo não torna a operação real.
Preços, velas e direção
O instrumento identifica o mercado: EURUSD é euro cotado em dólar; BTCUSDT é bitcoin cotado em USDT. Na simulação de compra, uma saída acima da entrada gera resultado bruto positivo. Na de venda, ocorre o contrário: o resultado bruto é positivo quando a saída fica abaixo da entrada. O tamanho da posição e os custos completam a conta.
- Abertura e fechamento
- O primeiro e o último preço de um intervalo. A distância entre eles forma o corpo da vela.
- Máxima e mínima
- Os extremos atingidos no intervalo. As partes que ultrapassam o corpo são os pavios.
- Timeframe
- A duração de cada vela. Os experimentos atuais usam M1: cada vela resume um minuto. Isso não significa que a tela recebe uma atualização a cada segundo.
- Vela fechada
- Um intervalo já concluído. O motor decide com essas velas, em ordem, em vez de mudar de decisão enquanto o mesmo candle ainda está se formando.
O desenho da vela resume o intervalo, mas não informa toda a ordem dos movimentos dentro dele. Por isso uma simulação baseada em candles precisa de regras explícitas para situações ambíguas, como stop e alvo alcançados na mesma vela.
Entrada, stop, alvo e risco
- Entrada
- O nível definido para iniciar a operação. O preço preenchido pela execução paper também considera o spread configurado.
- Stop
- O nível de encerramento defensivo. Na regra atual, nasce além do extremo da vela que voltou à zona, com um pequeno deslocamento técnico.
- Alvos
- Níveis favoráveis medidos a partir da entrada. A regra usa uma escada de dez alvos para conduzir a posição; não são dez ordens de realização parcial.
- 1 R
- A distância inicial da entrada ao stop é o risco em pontos. Na conta, o resultado em R divide o lucro ou prejuízo pelo orçamento monetário de risco daquela operação.
- Risco em bps
- Pontos-base da porcentagem do saldo: 1 bps = 0,01%; 100 bps = 1%; 1.000 bps = 10%. O orçamento é recalculado com o saldo no momento de cada nova operação.
Um exemplo, do saldo ao resultado
Considere apenas para entender a conta: saldo simulado de 1.000 unidades monetárias, risco de 100 bps (1%), compra no preço 100 e stop no preço 98. Sem custos e supondo que uma unidade de posição valha uma unidade monetária por ponto:
- O orçamento de risco é 1.000 × 1% = 10.
- A distância até o stop é 100 − 98 = 2 pontos.
- O tamanho teórico é 10 ÷ 2 = 5 unidades.
- Uma saída no stop resulta em −10 (−1 R); uma saída no preço 104 resulta em +20 (+2 R).
O sistema usa a especificação de cada contrato para converter pontos em dinheiro e respeitar o lote mínimo, o passo e o limite de tamanho. Por isso a quantidade não é apenas saldo dividido pelo preço. Se o orçamento não comportar o lote mínimo, o sinal pode não produzir uma posição.
Como o motor decide
O motor não entra porque uma única vela parece favorável. Ele acompanha uma sequência de condições. A cada etapa, a tentativa pode avançar, continuar aguardando ou ser invalidada. Os nomes técnicos aparecem nos eventos para permitir reconstruir essa decisão depois.
Preparando diagrama…
- 1. Impulsão
- Identifica uma perna direcional que atende aos critérios da regra. Nos presets com sweep, também verifica a varredura de um extremo anterior.
- 2. Correção e falha
- Acompanha o recuo contra a impulsão e procura evidência de que essa correção perdeu continuidade.
- 3. Retomada
- Exige rompimento por fechamento com corpo (CISD) e a formação de uma faixa entre velas chamada FVG. Um simples pavio além do nível não substitui a confirmação exigida.
- 4. Zona ancorada
- Guarda o FVG ligado à sequência que o originou. A zona precisa continuar válida; não é qualquer espaço no gráfico.
- 5. Mitigação
- Espera o retorno do preço à zona. Os presets atuais permitem uma espera de até 15 velas; ultrapassar a janela ou invalidar a estrutura descarta a tentativa.
- 6. Confirmação
- Classifica a resposta à zona como convicção ou absorção, conforme proporções do corpo, pavios e fechamento definidas pela política.
- 7. Sinal e risco
- Registra o sinal, calcula o stop e a escada de alvos e valida o plano. A conta paper ainda precisa conseguir dimensionar a posição.
O que acontece depois da entrada
Com fechamento no segundo alvo ou além dele, o stop pode ir para a entrada. No terceiro, passa a proteger pelo menos o primeiro alvo. A partir do quinto, acompanha os extremos das velas sem afrouxar a proteção. O encerramento ocorre pelo stop ou pelo fechamento no alvo final, o décimo.
Em cada vela, o motor primeiro verifica se o stop que já estava vigente foi atingido. Se a mesma vela também alcança um alvo, o stop tem prioridade. Só depois são avaliados os avanços da escada. Isso evita usar um movimento favorável posterior para apagar uma perda que poderia ter ocorrido antes.
As três versões da regra
Preset é uma configuração nomeada da estratégia, não uma classificação de rentabilidade. As três opções compartilham a sequência principal e a gestão por alvos, mas mudam as condições aceitas.
- baseline
- Referência da implementação do método, sem os filtros adicionais de varredura ou fluxo estrutural dos outros presets. Serve como base de comparação.
- sweep-sniper
- Exige uma varredura de liquidez na janela configurada de até três velas antes da impulsão e aceita o perfil de FVG classificado como sniper. Esse perfil usa proporções entre as velas, não uma avaliação visual subjetiva.
- sweep-structure
- Exige a varredura na primeira vela da impulsão e valida o fluxo estrutural. Não é simplesmente o sweep-sniper com outro nome: os filtros são diferentes.
Ao marcar dois presets, você acompanha duas contas independentes recebendo as mesmas velas do experimento. Para uma comparação interpretável, mantenha instrumento, fonte, período, saldo e risco equivalentes. Compare também os descartes e os custos, não apenas o saldo final. Um filtro adicional não garante operações melhores.
Do preço ao painel
Preparando diagrama…
- Fonte de preços
- Binance fornece o feed de cripto sem chave neste adaptador. Twelve Data depende de uma chave configurada. OANDA depende das credenciais do feed practice. O símbolo precisa existir na fonte escolhida.
- Supervisor
- Lê o estado desejado dos experimentos e inicia ou interrompe os processos correspondentes. O botão Iniciar solicita essa mudança; não executa o motor dentro do navegador.
- Runner e motor
- Um runner por experimento compartilha o feed entre os presets. Cada preset mantém seu próprio motor e, em paper, sua própria conta.
- Banco e API
- Guardam e disponibilizam configurações, velas, eventos e posições. O dashboard consulta esses registros; abrir uma página não cria uma nova operação.
- Notificador
- Procura os sinais elegíveis e processa os alertas. O envio de e-mail depende do serviço, da configuração de entrega e das preferências do usuário.
Ao iniciar, o feed pode trazer velas anteriores para aquecer o estado do motor. Essa leitura histórica ajuda a reconstruir o contexto, mas não significa abrir retroativamente uma posição paper para cada sinal antigo. O tempo até a primeira atualização depende da fonte, do intervalo de consulta, das credenciais e da disponibilidade dos dados.
Seu primeiro experimento
Antes de criar, confirme que a API e o banco estão acessíveis e que o supervisor está ativo. A tela de Execuções mostra o estado da API e do banco. Para fontes autenticadas, as chaves precisam estar configuradas no ambiente do serviço, não no campo de nome do experimento.
- Abra Experimentos e escolha “novo experimento”. Use um nome que identifique o teste, por exemplo “comparação BTC M1”.
- Combine fonte e instrumento. Por exemplo, Binance e BTCUSDT para o feed de cripto. Um código de câmbio não passa a existir na Binance por estar preenchido no formulário.
- Selecione os presets. Um preset testa uma configuração; vários permitem comparação lado a lado. Cada um recebe o saldo informado, integralmente, em sua própria conta simulada.
- Revise saldo e risco em bps. Confira a conversão antes de criar: 100 não é 100%, é 1%. Os valores preenchidos no formulário são parâmetros de simulação, não uma recomendação de risco.
- Crie e clique em iniciar. Aguarde a criação das runs e verifique o estado e a última vela. “Rodando” não significa que já existe uma operação.
- Escolha a conta no Board. Comece por “Todas as contas”, “Ao vivo”, “O que o motor viu” e “Últimas operações”. Primeiro confirme a chegada dos dados; depois acompanhe as decisões.
- Registre um período de observação. Anote a configuração e as datas, acompanhe operações encerradas e exporte os resultados. Para testar outra hipótese, duplique o experimento e altere apenas o que deseja comparar.
Estados e reinícios
- Parado
- O experimento está cadastrado, mas não está executando. Sua configuração pode ser preparada antes do próximo início.
- Iniciando
- O supervisor criou o processo e aguarda a inicialização das runs. Se permanecer assim, verifique o processo e a fonte de dados.
- Rodando
- O runner informou as runs criadas. Confirme também a data da última vela: esse estado, sozinho, não comprova que o feed continua atualizado.
- Reiniciando
- O processo saiu, mas o estado desejado ainda é rodando. O supervisor tentará iniciá-lo novamente; consulte o erro para entender a interrupção.
- Erro ou encerrado
- Erro indica uma falha registrada. Encerrado indica que o processo saiu e não está mais solicitado como rodando. Verifique os detalhes antes de iniciar novamente.
Editar salva a configuração para o próximo início; não altera o motor já em execução. Duplicar prepara outro teste. Parar interrompe o processo: não pausa uma operação para continuar exatamente do mesmo ponto.
Como ler cada widget
O Board é uma visão de acompanhamento. O seletor de conta define qual run alimenta os widgets individuais. Antes de interpretar qualquer número, confira o identificador da run, o preset, o instrumento e a última atualização.
Widgets da conta selecionada
- Como está a conta
- Resume o saldo, a variação desde o início, a maior queda registrada e as operações. É o ponto de partida, não uma avaliação isolada da estratégia.
- Ganhou ou perdeu
- Separa operações encerradas com ganho das demais e mostra quanto cada grupo movimentou. Compare o tamanho dos ganhos e das perdas, além da quantidade.
- Saldo ao longo do tempo
- Reconstrói o saldo a partir dos encerramentos. A referência tracejada é o saldo inicial. Não é uma cotação contínua da posição aberta, mesmo quando o gráfico usa preenchimento em área.
- Resultado por dia
- Agrupa o resultado das operações pelo dia de encerramento. Uma posição ainda aberta não aparece como lucro ou prejuízo realizado naquele dia.
- Mercado agora
- Mostra uma janela de velas M1 com marcações de entrada e saída. Relacione o movimento às operações, sem confundir a janela visível com todo o histórico da conta.
- Últimas operações
- Detalha direção, horários, preços, tamanho, risco e resultado. Diferencia posições abertas de encerradas para você não tratar um resultado pendente como definitivo.
- Sinais por dia
- Conta os sinais encontrados no conjunto consultado. Sinal é uma decisão do motor, não necessariamente uma posição executada ou uma operação lucrativa.
- O que o motor viu
- Mostra as contagens do funil: impulsões, falhas da correção, rompimentos, zonas, confirmações, sinais e encerramentos. Ajuda a localizar onde as tentativas deixam de avançar.
- Ao vivo
- Lista os eventos recentes do motor em linguagem legível. Uma sequência de descartes pode ser atividade normal; ausência de operações não equivale a ausência de processamento.
Widgets que não seguem o seletor de conta
- Todas as contas
- Compara as contas paper retornadas pela consulta: saldo, resultado, operações e última vela. Use o número da run para distinguir testes do mesmo instrumento.
- Alertas
- Exibe as tentativas recentes em todos os canais — e-mail e WhatsApp — com o destino, a run e o estado: enviado, falhou, ou não enviado com o motivo. O cabeçalho mostra quais canais estão ligados para você. Não é uma lista de todas as decisões do motor.
- Moedas em reais
- Compara séries de câmbio contra o real. O gráfico normaliza o início de cada série em 100 para comparar variações; 100 não é a cotação em reais. Não altera a moeda nem o saldo das contas paper.
Você pode adicionar ou remover widgets, mover pelo cabeçalho e redimensionar pelas alças. Quando disponível, o seletor de visualização alterna a apresentação do gráfico sem mudar os dados. O arranjo fica salvo na sua conta. Consultas periódicas e eventos atualizam o painel; abas em segundo plano reduzem a atividade e retomam a atualização quando você volta.
Como interpretar resultados
- Saldo × equity
- Saldo considera resultados realizados. Equity inclui a marcação da posição aberta. Eles podem divergir enquanto há uma operação em andamento; verifique qual medida cada gráfico apresenta.
- Lucro e prejuízo (PnL)
- A variação monetária de uma operação ou período. Nas posições paper encerradas, o preenchimento já incorpora o spread da simulação, mas não todos os possíveis custos de uma conta real.
- Taxa de acerto
- A proporção de operações encerradas com resultado positivo. Sozinha, não revela se o total ganhou ou perdeu: uma perda grande pode superar vários ganhos pequenos.
- Resultado médio em R
- A média dos resultados divididos pelo risco monetário de cada operação. Ajuda a comparar operações de tamanhos diferentes, mas não é uma previsão do próximo resultado.
- Drawdown
- A queda a partir de um pico anterior. A maior queda mostra parte do caminho percorrido até o saldo atual; um saldo final positivo pode esconder perdas relevantes durante o teste.
- Amostra e período
- Quantidade de operações, tempo observado e condições de mercado. Contagens recentes de widgets podem ter limites de consulta e não corresponder a todo o histórico disponível.
Por que acertar mais não basta
Num exemplo sem custos, quatro ganhos de +2 R e seis perdas de −1 R somam +2 R em dez operações: 40% de acerto e média de +0,2 R. Já oito ganhos de +0,25 R e duas perdas de −1 R somam zero: 80% de acerto sem ganho total. Custos ainda precisam ser considerados. Os exemplos explicam a métrica, não descrevem o resultado de um preset.
Ao comparar, separe períodos usados para ajustar a regra dos períodos usados para avaliá-la. Registre mudanças de configuração e evite escolher apenas a melhor run depois de testar muitas combinações. Observe resultado líquido simulado, drawdown, distribuição dos resultados e estabilidade entre períodos, em vez de concluir pelo último ganho ou pelo maior saldo.
Alertas, histórico e exportação
Siga uma operação até a origem
- Em Execuções, escolha a run pelo identificador e confira instrumento, modo e configuração.
- Consulte os sinais e o histórico de eventos para localizar a confirmação, o plano de risco e os motivos de descarte.
- Relacione esses registros às velas na visão de mercado e à entrada, às mudanças de stop e à saída da conta paper.
- Compare o resultado monetário com o risco e os preços preenchidos. Um evento de sinal isolado não comprova que houve execução.
Quando um alerta vira e-mail
O notificador processa sinais elegíveis conforme os modos e a janela de busca configurados. É necessário que ele esteja ativo, com entrega SMTP configurada, e que o usuário esteja habilitado para receber alertas. Sem SMTP, o serviço pode registrar no log em vez de entregar um e-mail. Uma impulsão ou um descarte não é, por si só, um alerta de entrada.
Confira o estado em “Alertas”, o destino, a run e o horário. “Não enviado” não é falha: é o portão de evidência segurando o aviso de uma célula que ainda não fechou trades suficientes, ou o canal desligado nas suas configurações. Um registro de envio não garante chegada à caixa principal: a mensagem ainda pode ir para spam ou sofrer tratamento pelo provedor. O alerta informa uma decisão registrada; não envia uma ordem para sua corretora.
Leve os registros para fora do painel
Em Exportar, o ZIP reúne resumo, contas, posições, eventos, notificações, experimentos e configurações das runs. Os arquivos CSV e JSON permitem conferir os cálculos e relacionar registros pelo identificador da execução. Consulte o conteúdo e os limites do arquivo gerado antes de tratá-lo como um histórico integral.
Dúvidas e diagnóstico
Cliquei em iniciar, mas o experimento não começa. O que verifico?
Confira primeiro API e banco em Execuções. Depois verifique se o supervisor está rodando: o dashboard salva a intenção, mas depende desse processo para iniciar o runner. No local, just stack sozinho não inclui o supervisor. Se houver erro, consulte os logs do supervisor e do runner e confira as credenciais e o símbolo da fonte.
O experimento está rodando, mas não abre operações. Está travado?
Compare o horário da última vela com o mercado observado e consulte “Ao vivo” e o funil. Se chegam velas e eventos, o motor pode estar aguardando a sequência completa ou descartando tentativas inválidas. Não existe prazo garantido para o primeiro sinal. Se a última vela parou de avançar, investigue o feed, o horário de negociação e os limites de consulta.
Existe um sinal, mas não aparece uma posição na conta. Por quê?
Sinal, plano de risco e posição são registros diferentes. A execução pode ser monitor, o sinal pode pertencer ao aquecimento histórico, o plano pode ser invalidado ou o tamanho calculado pode ficar abaixo do lote mínimo. Confira a run correta, os eventos e os logs do runner; não presuma que todo sinal foi executado.
Mudei o risco ou o preset, mas a conta continua igual.
As alterações do experimento só entram no próximo início. Parar e iniciar cria novas runs com a nova configuração; não reescreve os resultados antigos.
Reiniciei e apareceu outra conta com saldo inicial. Perdi o histórico?
O runner inicia uma nova conta por preset, em vez de retomar a anterior. Consulte as runs antigas em Execuções. Uma posição aberta na run interrompida pode continuar registrada como aberta, pois parar o processo não gera um encerramento financeiro.
Não recebi o e-mail de um sinal. Por onde começo?
Confira se o sinal está nos modos e no período processados pelo notificador, se o serviço está ativo, se há SMTP configurado e se o usuário está habilitado para receber alertas. Consulte o estado de envio e os logs; depois verifique destinatário e spam. Não receber e-mail não significa, por si só, que o motor deixou de funcionar.
Por que o saldo, os sinais e os gráficos mostram quantidades diferentes?
Confira se está comparando a mesma run e o mesmo período. Sinais não equivalem a posições; posições abertas não entram como resultado realizado. Alguns widgets consultam apenas registros recentes, enquanto outros mostram totais da conta. “Todas as contas” e alertas também têm abrangência própria, independente do seletor do Board.
Qual preset é melhor? Quando posso considerar a estratégia validada?
A plataforma não atribui um vencedor universal nem valida uma estratégia ao atingir uma contagem fixa. Compare configurações em condições equivalentes, custos, quedas, períodos distintos e dados não usados no ajuste. Resultado favorável no histórico ou em paper não garante desempenho futuro nem equivalência com execução real.
Glossário de consulta
- Alavancagem
- Relação entre exposição da posição e capital da conta. Uma exposição calculada na simulação não comprova margem disponível ou aprovação de uma corretora.
- Alvo
- Nível favorável usado para acompanhar a progressão da operação. Na regra atual, os níveis intermediários orientam a proteção e o último pode encerrar a posição.
- Bootstrap
- Reamostragem dos resultados já observados para construir cenários. Depende da amostra e não cria evidência nova.
- Bps
- Pontos-base de porcentagem. Cem bps correspondem a 1%. Não confundir com pontos de preço.
- CISD
- Nome usado pelo motor para o rompimento confirmado por fechamento com corpo além da referência da estrutura.
- Confirmação
- Resposta à zona que atende a um dos modelos aceitos: convicção ou absorção. Não significa certeza sobre o movimento seguinte.
- Correção
- Movimento contrário à impulsão que está sendo acompanhada.
- Drawdown
- Queda desde um pico de valor da conta. O máximo registra a maior dessas quedas observadas.
- Equity
- Valor da conta considerando a marcação da posição aberta, além do saldo realizado.
- Feed
- Adaptador que fornece as velas ao motor, a partir de uma fonte de mercado ou de um arquivo histórico.
- FVG
- Fair Value Gap: faixa entre velas identificada pela regra. Pode ser ancorada como zona de interesse; não há garantia de retorno ou reação do preço.
- Impulsão
- Perna direcional reconhecida pelos critérios do motor, que dá origem ao acompanhamento de uma tentativa.
- Lote
- Unidade de tamanho de posição definida pelo contrato. Valor por ponto, tamanho mínimo e incrementos variam conforme o instrumento.
- M1 / candle / vela
- M1 é o intervalo de um minuto. Candle e vela são o mesmo registro de abertura, máxima, mínima e fechamento de um intervalo.
- Mitigação
- Retorno do preço à zona de FVG ancorada, dentro das condições e da janela de espera da regra.
- Paper
- Execução financeira simulada. Pode usar preços de mercado sem movimentar dinheiro real.
- Pip / ponto
- Unidades de variação de preço. Na escala EURUSD usada pelo motor, um pip equivale a dez pontos; essa escala não deve ser aplicada automaticamente a todos os instrumentos.
- PnL
- Profit and loss: lucro ou prejuízo. Confira se o valor é realizado, não realizado, bruto ou já inclui os custos modelados.
- Preset
- Conjunto nomeado de parâmetros e filtros do motor.
- R
- Unidade relativa ao risco inicial da operação. Na conta paper, o resultado em R usa o orçamento monetário de risco registrado para aquela posição.
- Replay / backtest
- Processamento de dados históricos para observar decisões e resultados sob regras e hipóteses definidas.
- Run
- Execução identificável do motor, com configuração e histórico próprios. Uma nova inicialização cria outra run.
- Setup
- Tentativa de formação da sequência exigida pela estratégia. Pode ser descartada antes de gerar sinal ou operação.
- Spread
- Diferença entre os lados de compra e venda. O paper usa um valor configurado por instrumento como custo de execução.
- Stop / trailing stop
- Nível de proteção da operação. Trailing é sua movimentação favorável conforme a regra, sem afrouxar o stop anterior.
- Sweep
- Varredura: o preço ultrapassa um extremo anterior e retorna conforme os critérios da estratégia. A leitura de candles não comprova quais ordens de terceiros foram executadas.
- UTC
- Referência de horário usada nos registros exportados. Considere o fuso ao agrupar por dia ou comparar com o relógio local.