Smart Data Export Indicator는 차트 데이터를 선택한 열로 CSV 또는 JSON Lines 파일에 기록하고, 모든 열을 설명하는 데이터 카드도 함께 만드는 MetaTrader 5용 무료 인디케이터입니다. ChatGPT나 Claude 같은 AI 어시스턴트, 스프레드시트 또는 Python으로 차트를 분석하는 분을 위한 도구입니다. Smart Data Export Indicator MT4는 무료 MetaTrader 4 버전이며, 차이점은 아래에 표시했습니다. 두 버전 모두 제가 무료로 제공하던 SmartDataExportEa를 대체합니다. 이 설명서는 버전 1.00 기준입니다.
내보내는 것
- 데이터 파일(CSV 또는 JSON Lines): 마감된 봉 하나당 한 행, 오래된 순서. 새 봉은 마감될 때마다 추가됩니다.
- 데이터 카드(.md): 단위, 워밍업 행, 시간대, 데이터 품질, 그리고 AI 어시스턴트용 프롬프트.
- AI 스냅샷(.md, MT5 전용): 채팅에 붙여 넣을 수 있도록 마지막 봉들을 표로 담은 파일.
- 딜(선택): 이 계좌의 딜(MT5) 또는 청산된 주문(MT4).
상위 타임프레임 값은 이미 마감된 봉에서만 가져옵니다(미래 참조 없음). 인디케이터는 주문을 내지 않고 DLL과 웹 요청을 사용하지 않으므로, 사용 중인 Expert Advisor와 같은 차트에서 함께 쓸 수 있습니다.
설치
- 상품 페이지(MT5 또는 MT4)에서 Free Download를 클릭하면 MetaTrader가 열립니다. MetaTrader의 Toolbox > Market에서 찾을 수도 있습니다. 설치한 상품은 Toolbox > Market > Purchased에 표시되며, 업데이트도 여기에 나타납니다(Update).
- Navigator > Indicators > Market에서 인디케이터를 차트로 끌어다 놓습니다. 기본값으로도 작동하므로 그대로 OK를 클릭해도 됩니다.
내보내기 순서
- 심볼의 차트를 엽니다. Timeframe of the rows 를 지정하지 않으면 행은 차트의 타임프레임을 사용합니다.
- 인디케이터를 적용하고 Range (기본값은 마감된 최근 5000개 봉), 열, 인디케이터(예: RSI(14); EMA(50); ATR(14) )를 선택한 뒤 OK를 클릭합니다.
- 패널의 상태를 확인합니다. 먼저 무엇을 기다리고 있는지가 표시되고, 이어서 Exporting history... , 그다음 History done - appending new bars as they close 가 표시됩니다(또는 Export finished . After the history 를 중지로 설정한 경우).
상태는 완료되면 녹색, 작업 중이거나 대기 중이면 주황색, 오류가 나면 빨간색으로 표시됩니다. 알 수 없는 인디케이터 이름 같은 경고는 ! 뒤에 주황색으로, 그리고 Experts 탭에 표시됩니다. Export again은 히스토리를 다시 읽어 모든 파일을 다시 씁니다.
파일 위치와 내용
파일은 MQL5\Files\SmartDataExport (MT4: MQL4\Files\SmartDataExport . File > Open Data Folder로 열 수 있음)에, 공용 폴더 입력 파라미터를 켜면 Terminal\Common\Files\SmartDataExport 에 저장됩니다. Strategy Tester에서는 테스터 에이전트의 폴더(MT4: tester\files )에 저장되며, AI 스냅샷은 만들어지지 않습니다.
내보내기를 시작할 때마다(적용, 입력 파라미터 변경, MetaTrader 재시작, Export again) 데이터 파일을 히스토리에서 다시 씁니다. 그 뒤에는 행이 추가되기만 합니다. 이전 파일을 남겨 두려면 복사해 두거나 파일 이름에 {date}를 추가하십시오.
데이터 파일: 예를 들어 XAUUSD_M15.csv (또는 .jsonl ). 각 행은 서버 시간 기준의 봉 시가 시각으로 시작합니다. CSV 파일에는 헤더 행이 있고 소수점은 마침표를 사용하며, 값이 없으면 비워 둡니다(JSON Lines에서는 null). 그 뒤에 다음 열이 이어집니다.
- open, high, low, close, tick_volume , real_volume (MT5, 브로커가 제공하는 경우), spread_pts .
- 포인트 단위: ret_pts (close - open), range_pts, body_pts, upper_wick_pts, lower_wick_pts , gap_pts (open - 직전 봉의 close). 그리고 log_ret = ln(close / 직전 봉의 close).
- time_utc (오프셋을 매주 감지하므로 서머타임도 처리됨), dow_utc (1 = 월요일), hour_utc , session : tokyo(9–18 JST), london(8–17 London), newyork(8–17 New York)이며, 겹치면 +로 이어지고 어느 것에도 해당하지 않으면 off입니다.
- 인디케이터 열은 rsi_14 이나 macd_signal_12_26_9 처럼 설정값을 붙인 이름이 되고, 커스텀 버퍼는 custom_<name>_<buffer> 가 됩니다.
- h4_open 부터 d1_close 까지(기본 타임프레임의 경우): 그 행이 마감되는 시점까지 이미 마감된 마지막 H4 봉과 D1 봉.
데이터 카드( XAUUSD_M15.datacard.md )는 히스토리 내보내기가 끝나면 기록됩니다. 데이터셋, 심볼 사양, 시간대, 단위·의미·워밍업 행을 포함한 모든 열, 품질 보고서(휴장, 공백, 중복된 시각, 변동폭이 없는 봉, 변동폭 급등, MT5에서는 스프레드 급변), 그리고 복사해 쓸 프롬프트가 들어 있습니다. MT4 카드에는 경고도 나열됩니다.
딜: deals_last_365d.csv (MT5)에는 심볼, 유형, 거래량, 가격, 손익, 수수료, 스왑, 매직 넘버, 사유가, closed_orders.csv (MT4)에는 시각, 가격, 손익, 수수료, 스왑, 매직 넘버, 스톱로스가 들어 있습니다.
AI 어시스턴트나 스프레드시트에서 파일 사용하기
- 과거 데이터에 관한 질문. 데이터 파일과 데이터 카드를 채팅에 첨부하고, 카드 끝에 있는 프롬프트를 복사한 뒤 그 마지막 줄에 질문을 적습니다. 이 프롬프트는 어시스턴트에게 각 행을 그 봉이 마감된 시점에야 알 수 있는 정보로 다루고, 워밍업 행을 제외하고, 데이터를 시간 순서로 나누고, 신뢰구간을 제시하도록 요청합니다.
- 현재 시장(MT5). XAUUSD_M15.snapshot.md 를 붙여 넣습니다. 마감된 최근 120개 봉(최대 500개)과 UTC 시각, bid와 ask, 최대 8개의 인디케이터 열, 그리고 프롬프트 예시가 들어 있습니다. 인디케이터가 행을 추가하는 동안 새 봉마다 다시 기록됩니다.
- 어시스턴트는 사용자가 건넨 행만 봅니다. 어시스턴트가 찾아낸 내용은 신호가 아니라 검증해야 할 아이디어로 다루십시오.
- Excel과 Python은 행이 추가되는 동안에도 파일을 읽을 수 있습니다. Excel용 UTF-8 BOM 옵션과 세미콜론 형식이 있습니다. 다른 프로그램이 파일을 잠그면, 새 행은 잠금이 풀릴 때까지 기다립니다.
- 워밍업 행은 데이터 카드에 나열됩니다. MT5에서는 이 행들의 인디케이터 값이 짧은 히스토리로 계산된 값이며, MT4에서는 비워 둡니다.
입력 파라미터
이름은 Inputs 탭에 표시되는 라벨 그대로입니다.
| 입력 파라미터 | 기본값 | 설명 |
|---|---|---|
| Timeframe of the rows | current | current = 차트의 타임프레임. |
| Range | Last N closed bars | 또는 Date range (From / To) , All available history . |
| Last N closed bars (Range = last N bars) | 5000 | 내보낼 봉 수. |
| From (Range = date range) | 2024.01.01 00:00 | 날짜 범위의 시작. |
| To (0 = up to the last closed bar) | 0 | 날짜 범위의 끝. |
| After the history | Keep appending each new closed bar | 또는 Stop after the history export . |
| Open, High, Low, Close | true | 가격 열. |
| Tick volume (and real volume if the broker provides it) | true | 거래량 열. |
| Spread of the bar (points) | true | 스프레드 열. |
| Bar shape: return, range, body, wicks, gap, log return | true | 봉 형태 열. |
| Time features: UTC time, weekday, hour, session | true | 시간 열. |
| Indicators, separated by ; | RSI(14); EMA(20); EMA(50); ATR(14); MACD(12,26,9); BB(20,2) | 아래 참조. 비워 두면 없음. |
| Custom indicators: Name:buffer,buffer; Name2:0 | (빈칸) | 사용자의 커스텀 인디케이터. |
| Higher-timeframe context (last CLOSED bar), separated by ; | H4; D1 | 행의 타임프레임보다 높지 않은 타임프레임은 건너뜁니다. |
| File name ({symbol} {tf} {date}) | {symbol}_{tf} | {date} = 시작 시점의 서버 날짜. |
| Format | CSV, comma separated | 또는 CSV, semicolon separated , JSON Lines (one object per row) . |
| Time format of the 'time' column | ISO 8601 (2026-10-09T15:30:00) | 또는 Unix seconds , MetaTrader (2026.10.09 15:30) . |
| Save in the common folder (Terminal\Common\Files) | false | 공용 폴더. |
| Write the data card (.md) | true | 데이터 카드. |
| AI snapshot: last N rows as a paste-ready .md (0 = off) | 120 | MT5 전용. 최대 500. |
| Add a UTF-8 BOM (for Excel) | false | Excel용. |
| Price decimals (-1 = symbol digits) | -1 | 가격의 소수 자릿수. |
| Also export this account's deals (closed trades) | false | 딜 파일. |
| Deals of the last N days | 365 | MT5 전용. |
| Server GMT offset in hours (-99 = detect automatically) | -99 | 감지된 오프셋이 틀린 경우에만 설정하십시오. |
| Show the status panel | true | 패널. |
| Panel X (pixels) | 12 | MT5 전용. |
| Panel Y (pixels) | 28 | MT5 전용. |
MT4에서는 열 스위치가 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 , Columns: UTC time, weekday, hour, session 이고, 딜 스위치는 Also export this account's closed orders 입니다.
인디케이터 이름: SMA, EMA, SMMA, LWMA, DEMA, TEMA, RSI, ATR, MACD, BB, STOCH, ADX, CCI, MFI, WPR, MOM, STDDEV, OBV, AO, SAR, ICHIMOKU(이후의 봉을 사용하는 Chikou는 제외). 괄호를 생략하면 기본값이 사용됩니다(예: RSI(14) 또는 MACD(12,26,9)). MyIndicator:0,1 은 커스텀 인디케이터의 버퍼 0과 1을 그 인디케이터의 기본 입력값으로 내보냅니다. 이름은 MQL5\Indicators(MT4: MQL4\Indicators) 기준의 상대 경로입니다. 알 수 없는 이름은 경고와 함께 건너뜁니다.
MT4 참고 사항
- 패널은 몇 줄의 텍스트와 Export again 버튼으로 이루어져 있습니다.
- AI 스냅샷, 실거래량, DEMA와 TEMA가 없습니다. MT4는 봉마다 스프레드를 저장하지 않으므로 히스토리 행의 spread_pts 는 비어 있으며, 실시간으로 추가되는 행에는 현재 스프레드가 들어갑니다.
- 행과 같은 타임프레임을 상위 타임프레임으로 지정하면 조용히 건너뛰고, 더 낮은 타임프레임이면 경고와 함께 건너뜁니다. 상위 타임프레임 봉은 브로커 자체의 경계를 따르며, H4 봉을 01:00에 시작하는 브로커도 있습니다.
- 처음에는 H1(시간대 판별용)과 상위 타임프레임을 브로커에서 내려받으며, 인디케이터는 각각 최대 일 분가량 기다립니다( Waiting for higher-timeframe history... ). 상위 타임프레임이 도착하지 않으면 해당 칸은 비어 있게 되고, H1이 없으면 시간대는 GMT+2(미국 서머타임 중에는 GMT+3)로 대체됩니다. 데이터 카드에 그 사실이 기록됩니다.
- 새로 연 차트에는 봉이 약 2,000개밖에 없는 경우가 많습니다. 과거 쪽으로 스크롤하거나 Home 키를 눌러 더 불러온 뒤 Export again을 클릭하십시오. "Max bars in history"와 "Max bars in chart"(Tools > Options > Charts)도 데이터의 깊이를 제한합니다.
- 청산된 주문은 Account History 탭에 표시되는 주문입니다. 더 오래된 주문을 포함하려면 그 탭의 기간을 변경하십시오.
사용자가 자주 묻는 질문
- 요청한 것보다 행이 적습니까? 터미널에 불러온 봉만 내보낼 수 있습니다. MT5에서는 "Max bars in chart"(Tools > Options > Charts)를 늘리고, 히스토리를 더 불러온 뒤 Export again을 클릭하십시오.
- 상태에 is it open in another program? 이 표시됩니다. 그 프로그램에서 파일을 닫고 Export again을 클릭하십시오.
- 상위 타임프레임이 경고와 함께 건너뛰어집니다. H4나 D1 차트에서는 기본값 H4; D1에 행보다 높지 않은 타임프레임이 포함됩니다. 입력 파라미터에서 그 타임프레임을 지우십시오.
- 여러 심볼을 내보내려면? 차트마다 하나씩 적용하십시오. 기본 파일 이름을 쓰면 심볼과 타임프레임마다 별도의 파일이 만들어집니다.
상품 페이지: Smart Data Export Indicator (MT5), Smart Data Export Indicator MT4. 궁금한 점이 있으면 패널의 스크린샷과 Experts 탭의 마지막 몇 줄을 MQL5 개인 메시지로 보내 주십시오.
