mtcli-percentlevels
Plugin do mtcli para exibição de níveis percentuais verticais em relação ao fechamento D-1 ou ajuste D-1, com foco em preparação de pregão, leitura objetiva de risco e definição prévia de zonas de preço.
Projetado para day trade na B3, com saída 100% textual, compatível com NVDA / JAWS, e integração natural com metodologias baseadas em VWAP, Auction Market Theory e RA-VWAP.
Funcionalidade
O plugin exibe níveis percentuais simétricos, calculados a partir de um preço de referência do pregão anterior.
📌 Preço de referência (configurável)
close→ Fechamento D-1 (padrão)ajuste→ Ajuste D-1
📌 Variações percentuais
- Passo configurável (padrão: 0,5%)
- Variação total configurável (padrão: 3%)
- Cálculo simétrico (acima e abaixo do referencial)
📌 Layout de saída
- Exibição vertical
- Preço de referência centralizado
- Variações positivas acima
- Variações negativas abaixo
- Ordenação decrescente em ambos os lados
- Positivos:
+3.0 → +0.5 - Negativos:
-0.5 → -3.0
- Positivos:
Exemplo de saída
Ativo: WING26
----------------------------------------
+3.0% 169141
+2.5% 168320
+2.0% 167498
+1.5% 166677
+1.0% 165856
+0.5% 165035
----------------------------------------
CLOSE 164215
----------------------------------------
-0.5% 163394
-1.0% 162573
-1.5% 161752
-2.0% 160931
-2.5% 160109
-3.0% 159288
Instalação
Requisitos
- Python 3.10+
- MetaTrader 5 instalado e configurado
- Biblioteca Python
MetaTrader5 mtcli
Instalação local
pip install .
Ou via Poetry (desenvolvimento):
poetry install
Uso
mt pl --symbol WING26
Opções do comando
| Opção | Descrição | Padrão |
|---|---|---|
--symbol, -s |
Ativo negociado no MT5 | obrigatório |
--ref |
Preço de referência (close ou ajuste) |
close |
--step |
Passo percentual | 0.5 |
--total |
Variação percentual total | 3.0 |
Exemplos
mt pl --symbol WING26
mt pl --symbol WING26 --ref ajuste
mt pl --symbol WING26 --step 1 --total 5
Arquitetura
O plugin segue o padrão MVC explícito, adotado no ecossistema mtcli.
mtcli_percentlevels/
├── cli.py # Interface Click
├── controller.py # Orquestração
├── model.py # Dados e cálculos
├── view.py # Formatação e saída
├── conf.py # Configurações globais
└── __init__.py
Model
-
Usa
copy_rates_from_pos -
Não depende de datas ou timezone
-
Funciona corretamente em:
- dias úteis
- fins de semana
- feriados
-
Preço de referência sempre do último pregão válido
View
- Responsável apenas pela apresentação
- Formatação numérica baseada em
DIGITOS - Saída linear e previsível (acessibilidade)
Controller
- Coordena model e view
- Sem regras de negócio
Decisões de projeto
🔑 Identificação do pregão
O pregão anterior nunca é identificado por data, apenas pela posição do candle diário no MT5.
Isso evita erros comuns relacionados a:
- timezone
- execução fora do horário de pregão
- feriados e fins de semana
🔑 Preço central como âncora
O preço de referência (close ou ajuste) é tratado como:
- ponto neutro
- base para risco
- eixo de decisão pré-trade
Integração com outros plugins
Este plugin é complementar a:
mtcli-prevsessionmtcli-vwapmtcli-vapmtcli-timesales
Permitindo:
- checklist pré-trade automático
- definição objetiva de zonas
- leitura de confluência com volume
Limitações conhecidas
- O ajuste utilizado corresponde ao close do candle D1
- Ajuste oficial da B3 pode diferir
Versões futuras podem incorporar ajuste oficial via Times & Trades.
Roadmap (ideias futuras)
- Flag
--json - Destaque de zonas (ex: equilíbrio / extensão)
- Integração direta com checklist RA-VWAP
- Ajuste oficial da B3
Licença
GPL
Autor
Valmir França Day trader · Desenvolvedor Python · Arquitetura CLI Volume · VWAP · Auction Market Theory
Metadata
Release files for mtcli-percentlevels 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mtcli_percentlevels-1.0.0.tar.gz | 17.9 kB | Without provenance | Details for mtcli_percentlevels-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mtcli_percentlevels-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for mtcli_percentlevels-1.0.0-py3-none-any.whl |
Total release size: 37.4 kB
Release files / mtcli_percentlevels-1.0.0.tar.gz
| Download URL | mtcli_percentlevels-1.0.0.tar.gz |
|---|---|
| Size | 17.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c37a6ef96470b6a70f761c0d5d69dbfbee661399c42a649af3f53ac62b48f3c6
|
|
BLAKE2b-256 checksum How to use checksums |
eb0cf6eaa4d7fb0058f5040ec3e1e61213d74cba384c7dcd2be7cfa4ec97885b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.2.1 CPython/3.13.7 Windows/11
|
Release files / mtcli_percentlevels-1.0.0-py3-none-any.whl
| Download URL | mtcli_percentlevels-1.0.0-py3-none-any.whl |
|---|---|
| Size | 19.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8f4b9ca2fcc74845032d147f0308368789b48afb343d0ea7b55635b30e32fc88
|
|
BLAKE2b-256 checksum How to use checksums |
fdf1512542bbff3bdaf0ab0ae644753fe7f7173067b292f2d752c9c615a5a811
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.2.1 CPython/3.13.7 Windows/11
|
Security for mtcli-percentlevels 1.0.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.