mtcli-risco 1.0.0

Plugin do mtcli

mtcli-risco

Plugin para controle de risco diário integrado ao mtcli. Bloqueia automaticamente o envio de ordens caso o limite de prejuízo do dia seja ultrapassado.

---

Instalação

Instale via pip (com mtcli já instalado):

pip install mtcli-risco

---

Requisitos

• Python 3.10+
• MetaTrader 5 instalado e configurado
• Conta de negociação conectada no MT5
• mtcli instalado e funcionando

---

Como usar

Executar o comando:

mt risco

Exemplo com limite personalizado:

mt risco --limite -300

Isso bloqueará novas ordens quando o lucro total do dia (realizado + em aberto) for menor ou igual a -300.

---

📁 Arquivo de estado

O estado do risco diário é salvo no arquivo:

bloqueio_risco.json

Exemplo de conteúdo:

{
  "data": "2025-09-20",
  "bloqueado": true
}

Esse arquivo é reavaliado a cada novo dia. O bloqueio se aplica apenas ao dia corrente.

---

Lógica

1. Consulta as negociações realizadas no dia (buy/sell).
2. Soma os lucros/prejuízos dessas operações.
3. Adiciona o lucro/prejuízo da posição atual em aberto.
4. Se o total for menor ou igual ao limite definido, bloqueia novas ordens.

---

Rodar testes

Execute os testes com:

pytest tests/

---

Desenvolvimento

Clone e instale em modo editável:

git clone https://github.com/seuuser/mtcli-risco.git
cd mtcli-risco
pip install -e .