fimathe-trend-ea/README.md

# Fimathe Trend EA

Expert Advisor profissional para MetaTrader 5 baseado na **Técnica Fimathe** de Marcelo Ferreira.

O EA automatiza integralmente o método: identifica a tendência no timeframe superior, aguarda o pullback para a zona de Fibonacci e entra após confirmação de candle — tudo com gestão de capital integrada.

---

## Sumário

- [Como Funciona](#como-funciona)
- [Fluxo de Decisão](#fluxo-de-decisão)
- [Parâmetros de Configuração](#parâmetros-de-configuração)
- [Instalação](#instalação)
- [Requisitos](#requisitos)
- [Aviso Legal](#aviso-legal)

---

## Como Funciona

### Os 7 Pilares da Técnica Fimathe

| # | Pilar | Descrição |
|---|-------|-----------|
| 1 | **Tendência é Soberana** | Opera sempre a favor da tendência principal identificada no TF superior |
| 2 | **Estrutura de Mercado** | Máximas e mínimas recentes formam suportes e resistências que o preço respeita |
| 3 | **Correções Fibonacci** | Após o impulso, aguarda o pullback nas zonas de 61,8% e 78,6% |
| 4 | **Confirmação de Entrada** | Aguarda o fechamento de uma vela na direção da tendência com corpo relevante |
| 5 | **Gestão de Risco** | SL estrutural abaixo/acima do pullback; TP percentual sobre o saldo |
| 6 | **Horário e Liquidez** | Prioriza sessões de Londres (08h–12h) e Nova York (13h–17h) |
| 7 | **Disciplina Operacional** | Máximo 1 posição aberta; sem reentrada imediata após stop |

### Identificação de Tendência

A tendência é confirmada por dois critérios combinados:

- **Estrutura de mercado**: sequência de topos e fundos ascendentes (alta) ou descendentes (baixa)
- **Alinhamento de EMAs**: EMA 20 > EMA 50 > EMA 200 (alta) ou inverso (baixa)

A confirmação é forte quando ambos concordam; parcial quando apenas um está presente.

### Detecção do Setup

**Compra (uptrend):**
1. Localiza o swing high e swing low recentes no TF operacional
2. O swing high deve ser mais recente que o swing low (impulso de alta concluído)
3. Preço recuou para a zona Fibonacci (entre 61,8% e 78,6% do range)
4. Vela de confirmação: bullish, corpo >= mínimo configurado, fechando acima do mínimo da zona

**Venda (downtrend):**
1. O swing low deve ser mais recente que o swing high (impulso de baixa concluído)
2. Preço recuperou para a zona Fibonacci (61,8%–78,6% do range)
3. Vela de confirmação: bearish, corpo >= mínimo configurado, fechando abaixo do máximo da zona

---

## Fluxo de Decisão

```
Tendência TF Superior
        ↓
Impulso Identificado (Swing High / Swing Low)
        ↓
Aguardar Pullback para Zona Fibonacci (0.618 / 0.786)
        ↓
Confirmação de Vela (corpo relevante na direção da tendência)
        ↓
Abertura da Posição
        ↓
Gestão: SL estrutural + TP percentual + Trailing + Breakeven
```

---

## Parâmetros de Configuração

### Gestão de Capital

| Parâmetro | Padrão | Descrição |
|-----------|--------|-----------|
| `UseMoneyMgmt` | `true` | Ativa gestão de capital por risco percentual |
| `RiskPercent` | `1.0` | % do saldo a arriscar por operação |
| `TargetPct` | `2.0` | % de lucro alvo por operação |
| `LotSize` | `0.01` | Lote fixo (usado quando `UseMoneyMgmt = false`) |

### Timeframes

| Parâmetro | Padrão | Descrição |
|-----------|--------|-----------|
| `TrendTF` | `H1` | Timeframe para identificação da tendência |
| `OperTF` | `M5` | Timeframe operacional de entrada |

### Fibonacci

| Parâmetro | Padrão | Descrição |
|-----------|--------|-----------|
| `FibLvl1` | `0.618` | Nível Fibonacci principal (61,8%) |
| `FibLvl2` | `0.786` | Nível Fibonacci secundário (78,6%) |
| `FibTolerance` | `0.015` | Tolerância da zona como fração do range |

### Estrutura e Setup

| Parâmetro | Padrão | Descrição |
|-----------|--------|-----------|
| `StructBars` | `35` | Barras para detectar swing high/low |
| `MinBodyPts` | `60` | Pontos mínimos no corpo da vela de confirmação |
| `NeedBodyClose` | `true` | Exige corpo mínimo na vela de confirmação |

### Stop Loss

| Parâmetro | Padrão | Descrição |
|-----------|--------|-----------|
| `UseATR` | `true` | Calcula SL via ATR |
| `ATRPeriod` | `14` | Período do ATR |
| `ATRMult` | `2.0` | Multiplicador do ATR para o SL |
| `SLBuffer` | `150` | Buffer além da estrutura em pontos (sem ATR) |

### Breakeven e Trailing Stop

| Parâmetro | Padrão | Descrição |
|-----------|--------|-----------|
| `UseBreakEven` | `true` | Ativa breakeven automático |
| `BEPct` | `0.5` | % de lucro no saldo para ativar o breakeven |
| `UseTrailing` | `true` | Ativa trailing stop automático |
| `TSPct` | `1.0` | % de lucro no saldo para ativar o trailing |
| `TSPoints` | `250` | Distância do trailing stop em pontos |

### Horário de Operação

| Parâmetro | Padrão | Descrição |
|-----------|--------|-----------|
| `UseTimeFilter` | `true` | Filtra o horário de operação |
| `StartHour` | `9` | Hora de início (horário do servidor) |
| `StartMin` | `0` | Minuto de início |
| `EndHour` | `18` | Hora de fim (horário do servidor) |
| `EndMin` | `0` | Minuto de fim |
| `CloseAtEnd` | `false` | Fecha posições ao atingir a hora de fim |

### Identificação

| Parâmetro | Padrão | Descrição |
|-----------|--------|-----------|
| `MagicNumber` | `202536` | Número mágico para identificar as ordens do EA |
| `EAComment` | `Fimathe Trend EA` | Comentário nas ordens abertas |

---

## Instalação

1. Abra o **MetaEditor** (atalho `F4` no MetaTrader 5)
2. Copie o arquivo `Fimathe_Trend_EA.mq5` para a pasta:
   ```
   [Dados MT5]\MQL5\Experts\
   ```
   Por padrão em Windows:
   ```
   C:\Users\[SeuUsuário]\AppData\Roaming\MetaQuotes\Terminal\[ID]\MQL5\Experts\
   ```
3. No MetaEditor, abra o arquivo e clique em **Compilar** (`F7`) — o arquivo `.ex5` será gerado automaticamente
4. No MetaTrader 5, vá em **Exibir → Navegador → Expert Advisors**
5. Arraste o `Fimathe_Trend_EA` para o gráfico do ativo desejado
6. Na janela de configuração, ajuste os parâmetros conforme sua estratégia
7. Certifique-se de que o **AutoTrading** está habilitado (botão verde na barra de ferramentas)

---

## Requisitos

- **Plataforma**: MetaTrader 5 (build 3000+)
- **Linguagem**: MQL5
- **Conta**: Real ou Demo com execução automática de ordens habilitada
- **Ativos sugeridos**: Forex, Índices, Commodities com liquidez nas sessões de Londres e Nova York

---

## Aviso Legal

> **Este software é fornecido para fins educacionais e de estudo da Técnica Fimathe.**
>
> Trading automatizado envolve riscos significativos de perda de capital. Resultados passados não garantem resultados futuros. Teste sempre em conta demo antes de operar com capital real. O autor não se responsabiliza por perdas financeiras decorrentes do uso deste software.
>
> A Técnica Fimathe é de autoria de **Marcelo Ferreira**. Este EA é uma implementação técnica independente e não tem vínculo oficial com o autor da técnica.

---

*Fimathe Trend EA v1.00 — MQL5 / MetaTrader 5*