Smart Data Export Indicator (MT5/MT4): Manual do usuário, arquivos CSV e JSON Lines, colunas e configurações
Smart Data Export Indicator é um indicador gratuito para MetaTrader 5 que grava os dados do gráfico em arquivos CSV ou JSON Lines, com as colunas que você escolher e uma ficha de dados (data card) que explica cada coluna. Ele é para quem analisa os próprios gráficos com um assistente de IA como o ChatGPT ou o Claude, com uma planilha ou com Python. Smart Data Export Indicator MT4 é a versão gratuita para MetaTrader 4; as diferenças são indicadas abaixo. Os dois substituem o meu SmartDataExportEa gratuito. Este manual vale para a versão 1.00.
O que ele exporta
- Arquivo de dados (CSV ou JSON Lines): uma linha por barra fechada, da mais antiga para a mais recente. As novas barras são acrescentadas à medida que fecham.
- Ficha de dados (.md): unidades, linhas de aquecimento (warm-up), fuso horário e qualidade dos dados, além de um prompt para um assistente de IA.
- Snapshot para IA (.md, só no MT5): as últimas barras como uma tabela para colar em um chat.
- Deals (opcional): os deals desta conta (MT5) ou as ordens fechadas (MT4).
Os valores de tempos gráficos superiores vêm apenas de barras que já estavam fechadas (sem look-ahead). O indicador não envia ordens, não usa DLL e não faz requisições web, então pode dividir o gráfico com o seu Expert Advisor.
Instalação
- Na página do produto (MT5 ou MT4), clique no botão de download gratuito (Free Download); isso abre o MetaTrader. Você também pode encontrá-lo no MetaTrader em Toolbox > Market. Os produtos instalados ficam em Toolbox > Market > Purchased, onde aparecem as atualizações (Update).
- Arraste o indicador de Navigator > Indicators > Market para um gráfico. Os valores padrão funcionam, então você pode simplesmente clicar em OK.
Exportação passo a passo
- Abra um gráfico do símbolo. As linhas usam o tempo gráfico atual, a menos que você defina Timeframe of the rows .
- Coloque o indicador no gráfico, escolha o Range (por padrão, as últimas 5000 barras fechadas), as colunas e os indicadores, por exemplo RSI(14); EMA(50); ATR(14) , e clique em OK.
- Acompanhe o status no painel: o que ele está aguardando, depois Exporting history... e depois History done - appending new bars as they close (ou Export finished , se After the history estiver definido para parar).
O status fica verde quando termina, laranja enquanto trabalha ou aguarda e vermelho depois de um erro. Avisos, como um nome de indicador desconhecido, aparecem em laranja depois de um ! e na aba Experts. Export again lê o histórico de novo e reescreve todos os arquivos.
Onde ficam os arquivos e o que há neles
Os arquivos vão para MQL5\Files\SmartDataExport (MT4: MQL4\Files\SmartDataExport ; File > Open Data Folder) ou para Terminal\Common\Files\SmartDataExport com o parâmetro da pasta comum. No Strategy Tester, eles vão para a pasta do agente do testador (MT4: tester\files ), sem snapshot para IA.
Cada início da exportação (colocar o indicador no gráfico, mudar um parâmetro, reiniciar o MetaTrader, Export again) grava o arquivo de dados de novo a partir do histórico; depois disso, as linhas são apenas acrescentadas. Para manter um arquivo mais antigo, copie-o ou adicione {date} ao nome do arquivo.
Arquivo de dados, por exemplo XAUUSD_M15.csv (ou .jsonl ). Cada linha começa com o horário de abertura da barra no horário do servidor. Os arquivos CSV têm uma linha de cabeçalho e usam ponto decimal; valores ausentes ficam vazios (null em JSON Lines). Em seguida vêm:
- open, high, low, close, tick_volume , real_volume (MT5, se a corretora fornecer), spread_pts .
- Em pontos: ret_pts (close - open), range_pts, body_pts, upper_wick_pts, lower_wick_pts , gap_pts (open - close anterior); e log_ret = ln(close / close anterior).
- time_utc (deslocamento detectado por semana, então o horário de verão é tratado), dow_utc (1 = segunda-feira), hour_utc , session : tokyo (9–18 JST), london (8–17 Londres), newyork (8–17 Nova York), unidas com + ou off.
- Indicadores com nomes conforme as configurações, como rsi_14 ou macd_signal_12_26_9 ; buffers personalizados como custom_<name>_<buffer> .
- h4_open até d1_close (tempos gráficos padrão): as últimas barras H4 e D1 que já tinham fechado no fechamento da linha.
Ficha de dados, XAUUSD_M15.datacard.md , gravada quando a exportação do histórico termina: conjunto de dados, especificação do símbolo, fuso horário, cada coluna com unidade, significado e linhas de aquecimento, um relatório de qualidade (pausas, lacunas, horários duplicados, barras de amplitude zero, picos de amplitude e, no MT5, saltos de spread) e um prompt para copiar. A ficha do MT4 também lista os avisos.
Deals: deals_last_365d.csv (MT5) com símbolo, tipo, volume, preço, lucro, comissão, swap, magic number e motivo, ou closed_orders.csv (MT4) com horários, preços, lucro, comissão, swap, magic number e stop loss.
Como usar os arquivos com um assistente de IA ou uma planilha
- Perguntas sobre o histórico. Anexe o arquivo de dados e a ficha de dados ao chat, copie o prompt do fim da ficha e escreva a sua pergunta na última linha dele. O prompt pede ao assistente que trate cada linha como conhecida apenas no seu fechamento, descarte as linhas de aquecimento, divida os dados no tempo e dê intervalos de confiança.
- O mercado atual (MT5). Cole o XAUUSD_M15.snapshot.md : as últimas 120 barras fechadas (até 500) com horários UTC, o bid e o ask, até 8 colunas de indicadores e uma sugestão de prompt. Ele é reescrito a cada nova barra enquanto o indicador acrescenta linhas.
- O assistente vê apenas as linhas que você lhe dá. Trate as conclusões dele como ideias a verificar, não como sinais.
- Excel e Python podem ler o arquivo enquanto as linhas são acrescentadas. Há uma opção de UTF-8 BOM para o Excel e um formato com ponto e vírgula. Se um programa bloquear o arquivo, as novas linhas aguardam até ele ser liberado.
- As linhas de aquecimento estão listadas na ficha de dados. No MT5, os valores de indicador delas vêm de pouco histórico; o MT4 as deixa vazias.
Parâmetros de entrada
Os nomes são os rótulos que aparecem na aba Inputs.
| Parâmetro | Padrão | O que faz |
|---|---|---|
| Timeframe of the rows | current | current = o tempo gráfico em uso no gráfico. |
| Range | Last N closed bars | Ou Date range (From / To) ou All available history . |
| Last N closed bars (Range = last N bars) | 5000 | Barras a exportar. |
| From (Range = date range) | 2024.01.01 00:00 | Início do intervalo de datas. |
| To (0 = up to the last closed bar) | 0 | Fim do intervalo de datas. |
| After the history | Keep appending each new closed bar | Ou Stop after the history export . |
| Open, High, Low, Close | true | Colunas de preço. |
| Tick volume (and real volume if the broker provides it) | true | Colunas de volume. |
| Spread of the bar (points) | true | Coluna de spread. |
| Bar shape: return, range, body, wicks, gap, log return | true | Colunas de formato da barra. |
| Time features: UTC time, weekday, hour, session | true | Colunas de tempo. |
| Indicators, separated by ; | RSI(14); EMA(20); EMA(50); ATR(14); MACD(12,26,9); BB(20,2) | Veja abaixo. Vazio = nenhum. |
| Custom indicators: Name:buffer,buffer; Name2:0 | (vazio) | Os seus próprios indicadores. |
| Higher-timeframe context (last CLOSED bar), separated by ; | H4; D1 | Tempos gráficos que não sejam superiores ao das linhas são ignorados. |
| File name ({symbol} {tf} {date}) | {symbol}_{tf} | {date} = data do servidor no início. |
| Format | CSV, comma separated | Ou CSV, semicolon separated ou JSON Lines (one object per row) . |
| Time format of the 'time' column | ISO 8601 (2026-10-09T15:30:00) | Ou Unix seconds ou MetaTrader (2026.10.09 15:30) . |
| Save in the common folder (Terminal\Common\Files) | false | Pasta comum. |
| Write the data card (.md) | true | Ficha de dados. |
| AI snapshot: last N rows as a paste-ready .md (0 = off) | 120 | Só no MT5. Até 500. |
| Add a UTF-8 BOM (for Excel) | false | Para o Excel. |
| Price decimals (-1 = symbol digits) | -1 | Casas decimais do preço. |
| Also export this account's deals (closed trades) | false | Arquivo de deals. |
| Deals of the last N days | 365 | Só no MT5. |
| Server GMT offset in hours (-99 = detect automatically) | -99 | Defina somente se o deslocamento detectado estiver errado. |
| Show the status panel | true | Painel. |
| Panel X (pixels) | 12 | Só no MT5. |
| Panel Y (pixels) | 28 | Só no MT5. |
No MT4, as chaves de colunas são Columns: open, high, low, close , Columns: tick volume , Columns: spread (only rows appended live; MT4 bars have no spread) , Columns: return, range, body, wicks, gap, log return e Columns: UTC time, weekday, hour, session , e a chave dos deals é Also export this account's closed orders .
Nomes de indicadores: SMA, EMA, SMMA, LWMA, DEMA, TEMA, RSI, ATR, MACD, BB, STOCH, ADX, CCI, MFI, WPR, MOM, STDDEV, OBV, AO, SAR e ICHIMOKU (sem a Chikou, que usa barras posteriores). Sem parênteses, são usados os valores padrão, por exemplo RSI(14) ou MACD(12,26,9). MyIndicator:0,1 exporta os buffers 0 e 1 de um indicador personalizado com os parâmetros padrão dele; o nome é relativo a MQL5\Indicators (MT4: MQL4\Indicators). Nomes desconhecidos são ignorados com um aviso.
Notas sobre o MT4
- O painel é formado por algumas linhas de texto com um botão Export again.
- Sem snapshot para IA, sem volume real, sem DEMA nem TEMA. spread_pts fica vazio nas linhas do histórico, porque o MT4 não armazena um spread para cada barra; as linhas acrescentadas em tempo real recebem o spread atual.
- Um tempo gráfico superior igual ao das linhas é ignorado sem aviso; um inferior, com aviso. As barras de tempos gráficos superiores seguem os limites da própria corretora; algumas corretoras começam as barras H4 à 01:00.
- Na primeira vez, o H1 (para o fuso horário) e os tempos gráficos superiores são baixados da corretora; o indicador espera até cerca de um minuto por cada um ( Waiting for higher-timeframe history... ). Se um tempo gráfico superior não chegar, as células dele ficam vazias; sem o H1, o fuso horário passa a ser GMT+2 (GMT+3 no horário de verão dos EUA). A ficha de dados informa isso.
- Um gráfico recém-aberto costuma ter cerca de 2,000 barras. Role para trás ou pressione Home para carregar mais e depois clique em Export again. "Max bars in history" e "Max bars in chart" (Tools > Options > Charts; no terminal em português: Ferramentas > Opções > Gráficos) também limitam a profundidade.
- As ordens fechadas são as mostradas na aba Account History; mude o período dela para incluir ordens mais antigas.
Perguntas frequentes dos usuários
- Menos linhas do que pedi? Só as barras carregadas no terminal podem ser exportadas. No MT5, aumente "Max bars in chart" (Tools > Options > Charts), carregue mais histórico e clique em Export again.
- O status mostra is it open in another program? Feche o arquivo nesse programa e clique em Export again.
- Um tempo gráfico superior é ignorado com um aviso. Em um gráfico H4 ou D1, o padrão H4; D1 contém um tempo gráfico que não é superior ao das linhas. Remova-o do parâmetro.
- Vários símbolos? Coloque uma cópia em cada gráfico. Com o nome de arquivo padrão, cada símbolo e tempo gráfico recebe o seu próprio arquivo.
Páginas dos produtos: Smart Data Export Indicator (MT5) e Smart Data Export Indicator MT4. Se algo não estiver claro, envie-me uma mensagem privada no MQL5 com uma captura de tela do painel e as últimas linhas da aba Experts.
