mtcli-renko

Plugin Renko profissional para o mtcli.

O mtcli-renko adiciona ao CLI mt a capacidade de gerar blocos Renko diretamente no terminal, utilizando dados do MetaTrader 5 ou de outras fontes configuradas no mtcli.

O plugin foi projetado para análise de fluxo e price action, oferecendo geração de Renko baseada em ticks ou candles, múltiplos estilos de cálculo, e saída acessível para ambientes CLI.

---

Características

• geração de Renko a partir de ticks
• geração de Renko a partir de candles
• modo candle determinístico
• modo tick híbrido (blocos confirmados + bloco em formação)
• reconstrução do caminho do candle (path reconstruction)
• ancoragem opcional na abertura do pregão
• ajuste automático de UTC do servidor da corretora
• margem de segurança na abertura do pregão
• saída em texto puro, ideal para terminal e leitores de tela
• arquitetura MVC modular

---

Requisitos

• Python 3.10+
• MetaTrader 5
• mtcli

Projeto relacionado:

https://github.com/vfranca/mtcli

---

Instalação

Via pip:

pip install mtcli-renko

Ou com poetry:

poetry add mtcli-renko

Após a instalação o plugin será automaticamente carregado pelo mtcli.

---

Comando

O plugin adiciona o comando:

mt rk

Exemplo simples:

mt rk

Exemplo com parâmetros:

mt rk --brick 60

---

Exemplo de saída

=== GRAFICO RENKO ===
Total de blocos: 5

METRICAS:
Up: 2
Down: 3
Delta: -1

PADROES:
H1

DOWN 181915 181855
UP 181855 181915
DOWN 181915 181855
DOWN 181855 181795
UP 181795 181855

Quando o modo tick híbrido está ativo, o último bloco pode aparecer como em formação.

---

Modos de geração

O plugin suporta dois modos principais de dados.

Tick mode

Os blocos Renko são gerados diretamente a partir de ticks do mercado.

Vantagens:

• maior precisão
• captura movimentos intra-candle
• ideal para análise de fluxo

Disponibiliza três estilos:

estrutural
agressivo
hibrido

Híbrido

Modo recomendado.

Exibe:

• blocos confirmados
• último bloco em formação

---

Candle mode

Os blocos Renko são gerados a partir de candles históricos.

Características:

• cálculo determinístico
• reconstrução do caminho interno do candle
• resultados consistentes entre execuções

---

Configuração

As configurações são definidas em:

mtcli.ini

Seção:

[renko]

Exemplo completo:

[renko]

symbol = WIN$N
digits = 0

period = m1
data_mode = tick

bars = 566

brick = 60

max_ticks = 5000000

tick_style = hibrido

modo = simples

limit_bricks = 0

session_open = 09:00

session_open_offset_seconds = 0

broker_utc_offset = -3

---

Parâmetros

symbol

Ativo utilizado para gerar o Renko.

Exemplo:

symbol = WIN$N

---

digits

Número de casas decimais do ativo.

Exemplo:

digits = 0

---

period

Timeframe utilizado quando:

data_mode = candle

Exemplo:

period = m1

---

data_mode

Define a fonte de dados utilizada.

Valores possíveis:

tick
candle

---

bars

Quantidade de candles carregados quando:

data_mode = candle

---

brick

Tamanho do bloco Renko.

Exemplo:

brick = 60

---

max_ticks

Número máximo de ticks carregados quando:

data_mode = tick

Isso evita consumo excessivo de memória.

---

tick_style

Define o estilo de cálculo no modo tick.

Valores possíveis:

estrutural
agressivo
hibrido

estrutural

Renko mais conservador.

agressivo

Gera blocos mais rapidamente.

híbrido

Combina estabilidade e reatividade e permite mostrar:

• blocos confirmados
• bloco em formação

---

modo

Define o algoritmo base de cálculo.

Valores possíveis:

simples
classico

---

limit_bricks

Limita a quantidade de blocos exibidos.

Exemplo:

limit_bricks = 200

---

session_open

Hora oficial de abertura do pregão.

Formato:

HH:MM

Exemplo:

session_open = 09:00

---

session_open_offset_seconds

Margem de segurança aplicada à abertura do pregão.

Algumas corretoras enviam os primeiros ticks alguns segundos após a abertura oficial.

Esse parâmetro evita problemas de ancoragem.

Exemplo:

session_open_offset_seconds = 47

---

broker_utc_offset

Offset UTC do servidor da corretora.

Exemplo:

broker_utc_offset = -3

---

Exemplos de uso

Renko padrão

mt rk

---

Definir tamanho do brick

mt rk --brick 30

---

Limitar quantidade de blocos

mt rk --limit-bricks 200

---

Usar modo candle

mt rk --data-mode candle

---

Arquitetura

O plugin segue arquitetura MVC, separando responsabilidades:

mtcli_renko/

commands/
    renko.py

controllers/
    renko_controller.py

models/
    renko_model.py

views/
    renko_view.py

conf.py
plugin.py

Model

Responsável por:

• geração dos blocos Renko
• cálculo dos algoritmos
• reconstrução de path do candle
• lógica de tick e candle

Controller

Responsável por:

• fluxo da execução
• carregamento de dados
• integração com o mtcli

View

Responsável por:

• exibir os blocos no terminal
• saída compatível com leitores de tela
• formatação textual simples

---

Desenvolvimento

Clone o repositório:

git clone https://github.com/vfranca/mtcli-renko

Instale dependências:

poetry install

---

Testes

Execute:

pytest

---

Licença

MIT License

---

Autor

Valmir França