mtcli-vwap
Plugin VWAP (Volume Weighted Average Price) para o ecossistema mtcli, desenvolvido para análise intraday, automação e integração entre plugins.
Compatível com MetaTrader 5, com foco em VWAP ancorada, bandas estatísticas e saída acessível em terminal.
Principais recursos
- VWAP intraday tradicional
- VWAP ancorada por:
- abertura do dia
- ajuste
- horário específico
- máxima do período
- mínima do período
- Bandas de VWAP configuráveis
- desvio padrão
- desvio ponderado por volume
- Saída textual acessível (NVDA / JAWS)
- Saída em JSON estruturado para automação
- Arquitetura clara em MVC
Instalação
pip install mtcli-vwap
Requisitos
- Python >= 3.10
- MetaTrader 5 instalado
- mtcli configurado corretamente
Uso rápido
mt vwp
Exemplo completo:
mt vwp \
--symbol WIN$N \
--minutes 1 \
--limit 600 \
--anchor abertura \
--bands 2
⚓ VWAP ancorada
Abertura do dia
mt vwp --anchor abertura
Ajuste
mt vwp --anchor ajuste
Horário específico
mt vwp --anchor hora --anchor-time "2026-01-29 09:00"
Máxima / mínima do período
mt vwp --anchor maxima
mt vwp --anchor minima
Bandas de VWAP
mt vwp --bands 2
Saída vertical (compatível com leitores de tela):
banda_sup_2
banda_sup_1
VWAP
banda_inf_1
banda_inf_2
Saída em JSON
Indicada para automações e integração com outros plugins do mtcli:
mt vwp --bands 2 --json
Exemplo de saída:
{
"vwap": 123456.0,
"anchor_type": "abertura",
"anchor_time": null,
"banda_sup_1": 123600.0,
"banda_inf_1": 123300.0
}
Configuração
O plugin aceita configuração por:
- Variáveis de ambiente
- Arquivo de configuração do mtcli
- Valores padrão
Parâmetros suportados:
SYMBOLMINUTESLIMITANCHORBANDSDIGITOS
🧱 Estrutura do projeto
mtcli_vwap/
├── cli.py # Interface de linha de comando
├── controller.py # Orquestração
├── model.py # Cálculo da VWAP
├── view.py # Saída acessível
├── conf.py # Configurações
└── plugin.py # Registro no mtcli
Acessibilidade
- Saída exclusivamente textual
- Ordem previsível e estável
- Compatível com NVDA, JAWS e leitores de tela similares
Licença
MIT
Autor
Valmir França
Desenvolvedor de ferramentas quantitativas, automação de trading e CLIs acessíveis.
Contribuições
Contribuições são bem-vindas via issues ou pull requests.
Projeto pensado para traders discricionários, automação quantitativa e leitura de contexto de fluxo.
Metadata
Release files for mtcli-vwap 2.0.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_vwap-2.0.2.tar.gz | 7.7 kB | Without provenance | Details for mtcli_vwap-2.0.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mtcli_vwap-2.0.2-py3-none-any.whl | Python 3 | none | any | Details for mtcli_vwap-2.0.2-py3-none-any.whl |
Total release size: 18.0 kB
Release files / mtcli_vwap-2.0.2.tar.gz
| Download URL | mtcli_vwap-2.0.2.tar.gz |
|---|---|
| Size | 7.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
885bd52500e9515bf32474e9aaff7f45ee3e249cc4448ba872af13d0896460cf
|
|
BLAKE2b-256 checksum How to use checksums |
7ed28f77a4cdfcfb769f469612ff26277ade98d3421bf8806cea6acb9c5128b0
|
| 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_vwap-2.0.2-py3-none-any.whl
| Download URL | mtcli_vwap-2.0.2-py3-none-any.whl |
|---|---|
| Size | 10.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
143b5fa56e4b4e3738fa704de9cd676aa57e48a8d2ad2e15a598b75656b76661
|
|
BLAKE2b-256 checksum How to use checksums |
99ae1214d923c6c9dfc2765504a54303cf3b4ddac3c66988db215a5e6e5a1d02
|
| 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-vwap 2.0.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.