Filtros

Nesta página, você encontrará informações sobre os filtros, para que servem e como eles podem ajudar a melhorar a confiabilidade das estratégias no ScriptBot.

O que é um filtro?

Os filtros são um sistema avançado de validação em camadas, baseado em regras lógicas personalizadas e atribuídas com pesos específicos. Cada filtro funciona de forma independente, mas contribui para a decisão final com seu valor de importância. A soma dos pesos define se a operação será confirmada ou rejeitada.

Diversos filtros podem ser criados para compras e vendas, cada um com configurações personalizáveis:

Definir como obrigatório ou opcional;
Atribuir um peso personalizado;
Estabelecer condições lógicas baseadas em indicadores ou sinais de mercado;
Escolher diferentes métodos de validação.

Os filtros são acionados automaticamente após o Gatilho de Confirmação, iniciando a análise para autorizar ou não a entrada no mercado.

Para que servem?

Os filtros garantem que entradas de compra ou venda só ocorram quando condições específicas forem atendidas, oferecendo ao usuário um controle mais rigoroso e personalizado sobre suas operações.

O sistema funciona com base na soma dos pesos dos filtros validados. Quando esse total atinge (ou supera) o peso mínimo definido, a ordem é autorizada. Caso contrário, a entrada é bloqueada, e a ordem não é enviada ao mercado.

Em resumo, os filtros servem para:

Evitar entradas impulsivas ou fora dos critérios definidos;
Apoiar decisões com validações objetivas e consistentes;
Adicionar camadas de verificação que aumentam a segurança da estratégia;
Organizar e simplificar validações complexas, especialmente quando há múltiplas condições envolvidas.

Configurando os filtros

A configuração dos filtros é simples e intuitiva. Abaixo, você pode visualizar uma imagem que ilustra a estrutura dos filtros no sistema:

Cada filtro pode ser configurado de forma personalizada, de acordo com as necessidades do usuário. A estrutura de configuração se divide em duas partes: Geral e Filtro.

Geral

[01] - Peso mínimo de validação: Define o valor mínimo que a soma dos pesos dos filtros deve atingir para que o sistema autorize a entrada da ordem.

Filtro

[01] - Tipo: Define o comportamento do filtro durante a validação. As opções são:
- Desativado: O filtro é ignorado no processo de validação.
- Obrigatório:
  - O filtro é sempre executado e deve ser validado com sucesso para que a ordem seja autorizada.
  - Este filtro também contribui para a pontuação total quando validado com sucesso.
- Opcional:
  - O filtro é executado apenas se a soma total dos pesos ainda não tiver atingido o valor necessário.
  - Seu resultado contribui para a pontuação, seja validado ou não.
[02] - Peso de Sucesso: Valor somado à pontuação total caso o filtro seja validado com sucesso.
[03] - Peso de Falha: Valor somado à pontuação caso o filtro não seja validado. Pode ser zero, positivo ou negativo, conforme a estratégia adotada.
[04 & 05] - Cálculos de Validação: São expressões condicionais que o sistema executa quando o filtro for chamado.

Entendendo os filtros

Os filtros são, essencialmente, validações em camadas. Cada validação tem um peso associado, que influencia a pontuação total da ordem. Se a soma dos pesos dos filtros atingir ou superar o valor do peso mínimo, a ordem é autorizada.

Primeiro exemplo:

Neste exemplo, os filtros são utilizados de forma complementar. O sistema considera uma entrada válida (compra ou venda) quando a soma dos pesos dos filtros validados atinge um valor mínimo.

Exemplo da configuração:

Se ao menos dois filtros forem validados com sucesso (2 × 25 = 50), o sistema considera que o critério mínimo foi atingido e confirma a entrada de compra ou venda.

Cálculos da Validação:

Filtro 01 (complementar): "(25 + 25) >= 50" → verdadeiro → +25
Filtro 02 (complementar): "(25 + 25) >= 50" → verdadeiro → +25
Filtro 03 (complementar): "50 < 25"         → falso      → +0

Soma dos pesos: 25 + 25 + 0 = 50

Resultado:
Como a soma dos pesos dos filtros validados atingiu o mínimo exigido (50), a entrada é confirmada.

Segundo exemplo:

Neste exemplo, são utilizados filtros complementares e obrigatórios. O sistema exige que:

A soma dos pesos dos filtros validados atinja o valor mínimo configurado.
Todos os filtros obrigatórios também sejam validados com sucesso.

Exemplo da configuração:

Mesmo que a soma dos filtros complementares atinja o peso mínimo, se algum filtro obrigatório falhar, a entrada não será confirmada.

Cálculos da Validação:

Filtro 01 (complementar): "(25 + 25) >= 50" → verdadeiro → +25
Filtro 02 (complementar): "(25 + 25) >= 50" → verdadeiro → +25
Filtro 03 (obrigatório):  "50 < 25"         → falso      → +0

Soma dos pesos: 25 + 25 + 0 = 50

Resultado:
Embora a soma dos filtros validados tenha atingido o mínimo necessário (50), o filtro obrigatório não foi validado, portanto a entrada não é confirmada.

Terceiro exemplo:

Neste exemplo, são utilizados filtros complementares e obrigatórios. O sistema exige que:

A soma dos pesos dos filtros validados atinja o valor mínimo configurado.
Todos os filtros obrigatórios também sejam validados com sucesso.

Exemplo da configuração:

Mesmo que a soma dos filtros complementares atinja o peso mínimo, se algum filtro obrigatório falhar, a entrada não será confirmada.

Cálculos da Validação:

Filtro 01 (obrigatório):  "(25 + 25) >= 50" → verdadeiro → +25
Filtro 02 (complementar): "(25 + 25) >= 50" → verdadeiro → +25
Filtro 03 (complementar): "50 < 25"         → falso      → +0

Soma dos pesos: 25 + 25 + 0 = 50

Resultado:
A soma dos filtros validados atingiu o mínimo necessário (50) e o filtro obrigatório foi validado. Portanto, a entrada é confirmada.

Quarto exemplo:

Neste exemplo, são utilizados apenas filtros obrigatórios. Nesse caso, o sistema não depende da soma mínima de pesos, mas sim da validação de todos os filtros obrigatórios.

Exemplo da configuração:

Mesmo que os filtros validados acumulem peso suficiente, a entrada não será confirmada se qualquer filtro obrigatório falhar.

Cálculos da Validação:

Filtro 01 (obrigatório): "(25 + 25) >= 50" → verdadeiro → +25
Filtro 02 (obrigatório): "(25 + 25) >= 50" → verdadeiro → +25
Filtro 03 (obrigatório): "50 < 25"         → falso      → +0

Soma dos pesos: 25 + 25 + 0 = 50

Resultado:
Apesar da soma dos pesos atingir 50, o filtro obrigatório “Filtro 03” não foi validado. Como nem todos os filtros obrigatórios foram validados, a entrada não é confirmada.