Passo 2 de 5

Como o Robô Exporta Dados

Entenda a função ExportRobotData() e o formato JSON

Visão Geral da Função

A função ExportRobotData() é chamada a cada tick do mercado e realiza as seguintes operações:

  1. Coleta dados da conta (saldo, patrimônio, lucro)
  2. Coleta dados das posições abertas
  3. Calcula estatísticas gerais
  4. \n
  5. Monta um JSON estruturado
  6. Salva em arquivo: robot_data.json
Frequência de Exportação
Por que a cada 5 segundos?
ExportaçãoA cada 5 segundos
MotivoBalanço entre atualização e performance
ArquivoMQL5/Files/robot_data.json
Latência~5-8 segundos até o painel
Estrutura do JSON Exportado
Exemplo completo com todos os campos
{
  "timestamp": "2026-02-20 15:30:45",
  "balance": 3250.00,
  "equity": 3375.50,
  "profit": 125.50,
  "current_phase": 1,
  "phase_progress": 62.5,
  "open_positions": 1,
  "trades": [
    {
      "ticket": 123456,
      "type": "BUY",
      "volume": 0.10,
      "open_price": 1.0950,
      "current_price": 1.0965,
      "sl": 1.0900,
      "tp": 1.1050,
      "profit": 15.00,
      "open_time": "2026-02-20 15:25:30"
    }
  ],
  "statistics": {
    "total_trades": 45,
    "win_trades": 28,
    "win_rate": 62.22,
    "total_profit": 1250.00,
    "avg_profit": 27.78,
    "max_drawdown": 5.50
  }
}
Campos Explicados

timestamp

Data e hora da exportação em formato legível

balance

Saldo atual da conta em R$

equity

Patrimônio atual (saldo + lucro/prejuízo das posições abertas)

profit

Lucro ou prejuízo total (equity - balance)

current_phase

Fase atual do robô (1-10 baseado no saldo)

phase_progress

Progresso na fase atual em percentual (0-100%)

open_positions

Número de trades abertos no momento

trades

Array contendo detalhes de cada trade aberto

statistics

Objeto com estatísticas gerais do robô

Estrutura de Cada Trade

ticket

ID único da operação no MT5

type

Tipo de operação: BUY (compra) ou SELL (venda)

volume

Quantidade de lotes negociados

open_price

Preço de entrada da operação

current_price

Preço atual do ativo

sl (Stop Loss)

Nível de proteção contra perdas

tp (Take Profit)

Nível de fechamento automático com lucro

profit

Lucro ou prejuízo atual do trade

open_time

Hora em que o trade foi aberto

Campos de Estatísticas

total_trades

Total de operações fechadas

win_trades

Número de operações com lucro

win_rate

Percentual de operações vencedoras

total_profit

Lucro total acumulado

avg_profit

Lucro médio por operação

max_drawdown

Maior queda percentual do saldo

Exemplo Prático
Interpretando um JSON real

Se você vê um JSON com "balance": 3250.00 e "equity": 3375.50, isso significa:

  • Seu saldo inicial foi de R$ 2.000
  • Você ganhou R$ 1.250 em operações fechadas
  • Você tem R$ 125,50 em lucro não realizado (operações abertas)
  • Seu saldo total é de R$ 3.250