MagicTradeBot 5.2+ Motor de Dimensionamento de Posição – Guia do Usuário Completo

  • Home
  • Documentation
  • MagicTradeBot 5.2+ Motor de Dimensionamento de Posição – Guia do Usuário Completo

MagicTradeBot 5.2+ apresenta um Motor de Dimensionamento de Posições completamente redesenhado, separando a alocação de capital da lógica de trading e DCA para maior clareza, flexibilidade e controle de risco.

Esta atualização centraliza todos os cálculos de tamanho de posição em:

position_sizing.yaml

🚀 O que mudou na versão 5.2+

✅ 1. Novo arquivo de configuração dedicado

Toda a lógica de valor do trade e exposição foi movida para:

position_sizing.yaml

Isso garante:

  • Arquitetura mais limpa
  • Sem sobreposição entre lógica DCA e lógica de capital
  • Maior precisão nas simulações
  • Suporte futuro para modelos avançados de dimensionamento (Kelly, risco de ruína, baseado em volatilidade, etc.)

✅ 2. Configurações antigas substituídas

As seguintes configurações agora estão obsoletas:

Configuração Antiga Status
CalculateAmountDynamically ❌ Removida
TradeAmountPer ❌ Removida

Elas foram completamente substituídas por:

auto_calculate_initial_amount: true

✅ 3. initial_trade_amount movido

Anteriormente localizado em trading.yaml, agora foi movido para:

position_sizing.yaml

Isso garante que toda a lógica de dimensionamento de posições fique em um único lugar.

📂 Nova estrutura de configuração

# --------------------------------------------------------------------------
# Valor do Trade & Alocação de Capital
# --------------------------------------------------------------------------
initial_trade_amount: 10.0
# --------------------------------------------------------------------------
# Cálculo do Tamanho da Posição
# --------------------------------------------------------------------------
auto_calculate_initial_amount: true
balance: 5000
total_percent_investment_per_trade: 2.0
# --------------------------------------------------------------------------
# Recursos Avançados de Dimensionamento
# --------------------------------------------------------------------------
mode: percent
kelly_fraction: 0.5
target_risk_of_ruin_percent: 1.0
max_drawdown_threshold: 40.0

⚙️ Como funciona o Dimensionamento de Posições (Fluxo Lógico)

1️⃣ Modo Fixo

Se:

auto_calculate_initial_amount: false

Então o bot:

  • Usa initial_trade_amount
  • Não realiza cálculo de exposição
  • Ignora cálculos DCA
  • Ignora lógica percentual

✔ Ideal para traders com lotes fixos
✔ Simples e previsível

2️⃣ Modo Cálculo Automático

Se:

auto_calculate_initial_amount: true

Então:

  • O valor inicial é calculado dinamicamente a partir do saldo
  • A exposição total (Inicial + Todos os DCA + Grid DCA) é limitada por:
total_percent_investment_per_trade

3️⃣ Modos Avançados

Critério de Kelly

- Usa taxa histórica de acerto e PnL médio por trade
- Fração de Kelly pode ser aplicada via kelly_fraction
- Reduz a volatilidade mantendo o potencial de crescimento

Risco de Ruína

- Calcula o tamanho máximo da posição para manter uma probabilidade segura de ruína da conta
- Controlado por target_risk_of_ruin_percent
- Impõe max_drawdown_threshold para evitar perdas catastróficas
- Ideal para gestão de risco de longo prazo

🧮 Regras de Cálculo de Exposição

Caso A — DCA Desativado + Grid Desativado

Se ambos estiverem desativados, o bot simplesmente usa:

10% do saldo

(Nenhum cálculo geométrico aplicado.)

Caso B — DCA Ativado

O sistema calcula:

  • Série geométrica para todos os ordens DCA
  • Exposição baseada em multiplicador
  • Unidades totais

O capital é então distribuído proporcionalmente.

Caso C — Grid DCA Ativado

A exposição do Grid é adicionada como unidades extras:

grid_orders × order_percent

Essas unidades são incluídas no cálculo da exposição total.

Caso D — DCA + Grid Combinados

Ambos os modelos de exposição são mesclados em um único limite total:

Exposição Total ≤ total_percent_investment_per_trade % do saldo

O valor inicial é derivado de:

target_total_investment / total_units

💰 Comportamento do Saldo

Modo Live

Se:

balance: 0

O bot usa o saldo real da exchange.

Modo Demo

Se:

balance: 5000

O bot usa:

balance ± total_pnl

Isso garante uma simulação precisa de capitalização composta.

🎯 Explicação de total_percent_investment_per_trade

Isso define a máxima exposição de capital por trade, incluindo:

  • Entrada inicial
  • Todos os ordens DCA
  • Todos os ordens Grid DCA

Exemplos

Valor Comportamento
2.0 Conservador
5.0 Equilibrado
10.0 Agressivo

🔥 Exemplo de Cenário

Saldo = 5000
total_percent_investment_per_trade = 2%

Exposição máxima permitida:

5000 × 2% = 100 USDT

O bot calculará o tamanho da ordem inicial de forma que:

Inicial + Todos os DCA + Ordens Grid = 100 USDT

Sem nunca ultrapassar esse limite.

🏗️ Por que essa arquitetura é melhor

  • ✔ Separação mais clara de responsabilidades
  • ✔ Nenhuma lógica de capital dentro do módulo DCA
  • ✔ Controle determinístico de risco
  • ✔ Compatível com otimização por IA
  • ✔ Simulação idêntica ao comportamento em produção
  • ✔ Preparado para o futuro com Kelly / Risco de Ruína

⚠️ Checklist de Migração (a partir da 5.1.x)

  1. Remover:
    • CalculateAmountDynamically
    • TradeAmountPer
  2. Mover:
    • initial_trade_amount → position_sizing.yaml
  3. Mover:
    • balance
    • auto_calculate_initial_amount
    • total_percent_investment_per_trade
    • mode
    • kelly_fraction
    • target_risk_of_ruin_percent
    • max_drawdown_threshold
  4. Verificar:
    • Configurações DCA permanecem em dca.yaml
    • Execução de trades permanece em trading.yaml

📌 Perfis de Configuração Recomendados

🛡 Conservador

auto_calculate_initial_amount: true
total_percent_investment_per_trade: 2.0
mode: percent

⚖ Equilibrado

auto_calculate_initial_amount: true
total_percent_investment_per_trade: 5.0
mode: percent

🚀 Agressivo

auto_calculate_initial_amount: true
total_percent_investment_per_trade: 10.0
mode: percent

🧠 Para Usuários Avançados

A versão 5.2+ estabelece a base para:

  • Dimensionamento pelo Critério de Kelly
  • Alvo de Risco de Ruína
  • Dimensionamento baseado em volatilidade
  • Compartimentos de capital por estratégia
  • Exposição otimizada por IA

Todos os modelos futuros serão integrados no position_sizing.yaml.

✅ Resumo

MagicTradeBot 5.2+ introduz:

  • Um Motor de Dimensionamento de Posições dedicado
  • Remoção de opções antigas de dimensionamento dinâmico
  • Controle centralizado de capital
  • Limite determinístico de exposição total
  • Modos avançados: Kelly & Risco de Ruína
  • Desativação automática do módulo de gerenciamento de dinheiro no modo auto

Essa atualização melhora significativamente o controle de risco, a clareza e a escalabilidade a longo prazo.

📎 Related Topics