mtcli-volume
Plugin do mtcli para cálculo e visualização de Volume Profile diretamente no terminal, com foco em:
- Precisão técnica (distribuição High–Low)
- Leitura profissional de mercado
- Total acessibilidade (screen reader friendly)
- Integração com MetaTrader 5
Principais recursos
-
Volume Profile por faixa High–Low
- O volume de cada candle é distribuído uniformemente entre todas as faixas de preço tocadas entre o LOW e o HIGH
- Modelo mais próximo do Volume Profile clássico (VAP)
-
Estatísticas de Market Profile
- POC (Point of Control)
- Área de Valor (70%)
- HVNs e LVNs com critérios profissionais
-
⚙️ Critérios avançados para HVN/LVN
- Baseado na média (multiplicadores)
- Baseado em percentis (ex: 80% / 20%)
-
100% acessível
- Saída textual linear
- Compatível com NVDA, JAWS e leitores de tela
- Sem dependência de cores ou gráficos visuais
-
Arquitetura MVC
- Model: cálculos e dados
- Controller: fluxo de negócio
- View: apresentação no terminal
- CLI: interface de linha de comando
Instalação
Via PyPI:
pip install mtcli-volume
Ou com Poetry:
poetry add mtcli-volume
⚠️ Requer MetaTrader 5 instalado e configurado corretamente no sistema.
Uso básico
Após a instalação, o comando é registrado automaticamente no mtcli:
mt vp
Exemplo completo:
mt vp \
--symbol WING26 \
--period m1 \
--limit 500 \
--range 100 \
--volume tick \
--hvn-criterio media \
--verbose
🔧 Opções disponíveis
| Opção | Descrição |
|---|---|
--symbol, -s |
Símbolo do ativo (ex: WIN, WDO, PETR4) |
--period, -p |
Timeframe (m1, m5, m15, h1, etc.) |
--limit, -l |
Quantidade de candles analisados |
--range, -r |
Tamanho da faixa de preço |
--volume, -v |
Tipo de volume (tick ou real) |
--inicio, -i |
Data/hora inicial (YYYY-MM-DD HH:MM) |
--fim, -f |
Data/hora final (YYYY-MM-DD HH:MM) |
--timezone, -tz |
Fuso horário para exibição |
--hvn-criterio |
Critério de HVN/LVN (media ou percentil) |
--verbose, -vv |
Exibe informações detalhadas |
Metodologia de cálculo
Volume Profile
- Cada candle contribui volume para todas as faixas de preço entre seu
lowehigh - O volume é distribuído uniformemente
- Evita o viés de concentrar volume apenas no preço de fechamento
HVN / LVN
Critérios disponíveis:
-
Média
- HVN: volume ≥ média × multiplicador
- LVN: volume ≤ média × multiplicador
-
Percentil
- HVN: acima do percentil superior (ex: 80%)
- LVN: abaixo do percentil inferior (ex: 20%)
Acessibilidade
Este plugin foi projetado para uso total com leitores de tela:
- Tabelas em texto puro
- Distribuição expressa em percentuais
- Estatísticas narráveis
- Sem gráficos ASCII ruidosos
Funciona corretamente com:
- NVDA
- JAWS
- VoiceOver (terminal)
Arquitetura
mtcli_volume/
├── cli.py # Interface de linha de comando
├── controller.py # Orquestração do fluxo
├── model.py # Cálculos e acesso ao MT5
├── view.py # Apresentação acessível
├── conf.py # Configurações padrão
└── plugin.py # Registro no mtcli
Exemplo de saída
Volume Profile — WING26
Preço | Volume | Distribuição
-------------------------------------------------------
186300.00 | 18.250 | 72.4% do máximo
186200.00 | 25.190 | 100.0% do máximo
186100.00 | 14.880 | 59.1% do máximo
Estatísticas
POC : 186200.00
Área de Valor : 185900.00 → 186300.00
HVNs : 186200.00, 186100.00
LVNs : 185700.00
Testes
O plugin foi projetado para facilitar testes unitários do cálculo no model.py,
permitindo validação independente do MetaTrader 5.
Contribuição
Pull requests são bem-vindos, especialmente para:
- Novos critérios de HVN/LVN
- Value Area expandida a partir do POC
- Modo TPO
- Integração com VWAP e Footprint
Licença
MIT License
Metadata
Release files for mtcli-volume 2.5.2
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_volume-2.5.2.tar.gz | 9.1 kB | Without provenance | Details for mtcli_volume-2.5.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mtcli_volume-2.5.2-py3-none-any.whl | Python 3 | none | any | Details for mtcli_volume-2.5.2-py3-none-any.whl |
Total release size: 20.2 kB
Release files / mtcli_volume-2.5.2.tar.gz
| Download URL | mtcli_volume-2.5.2.tar.gz |
|---|---|
| Size | 9.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6b32bb5f2364e16d374f4277288ddc6f9608b7f95ca6e4f188b5ef13d9271f82
|
|
BLAKE2b-256 checksum How to use checksums |
72792ef6dcab8f4ec9b0f9a798c9dc50468384bda6eca1656a90a14a2044f265
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.2.1 CPython/3.13.12 Windows/11
|
Release files / mtcli_volume-2.5.2-py3-none-any.whl
| Download URL | mtcli_volume-2.5.2-py3-none-any.whl |
|---|---|
| Size | 11.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
436f80c35d4955be140c70a5203d2ec981477e25d11ee49eebd41189e2acc618
|
|
BLAKE2b-256 checksum How to use checksums |
02f660b23c0b4f6d47ba32a3e801d06278797ea8b33b6283933dad4d6aa53706
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.2.1 CPython/3.13.12 Windows/11
|
Security for mtcli-volume 2.5.2
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.