Trade Notifier for LINE Discord Telegram
- 유틸리티
-
Kazuma Uezono
MQL5 / MQL4 / Pine Script v6 개발자입니다. MetaTrader 4/5 및 TradingView용 지표, 유틸리티, EA를 개발합니다.
서비스:
- TradingView Pine Script를 MT5/MT4로 변환
- MT4에서 MT5로 이전
- 기존 EA 및 지표의 버그 수정과 기능 추가
- 알림, 패널, 멀티 타임프레임 및 멀티 심볼 도구
주석이 달린 전체 소스 코드를 제공합니다. 사양을 먼저 확인한 후 빠르게 작업합니다.
언어: 일본어, 영어. - 버전: 1.3
- 활성화: 5
Trade Notifier는 MetaTrader 5 계좌에서 일어나는 일을 LINE, Discord, Telegram으로 보냅니다: 포지션 진입과 청산(손익 및 pips 포함), 손절(stop-loss)과 익절(take-profit) 변경, 대기 주문, 낮은 증거금 수준, 큰 평가 손실, 일일 요약. Discord와 Telegram 메시지에는 차트 스크린샷을 첨부할 수 있습니다. 직접 만든 지표와 EA도 작은 텍스트 파일을 작성하여 이 도구를 통해 메시지를 보낼 수 있습니다.
이 도구는 알림 전용입니다. 포지션이나 주문을 절대 열거나 변경하거나 닫지 않으며, 신호나 매매 조언을 제공하지 않습니다. DLL을 사용하지 않습니다. 메시지는 사용자의 터미널에서 사용자 본인의 LINE 공식 계정, Discord 웹후크 또는 Telegram 봇으로 직접 전송되며, 당사의 어떤 서버도 거치지 않습니다.
대상: 자신의 수동 매매나 EA가 무엇을 하고 있는지 휴대폰에서 확인하거나 Discord 채널 또는 LINE이나 Telegram 그룹에서 공유하고 싶은 트레이더(예: VPS에서 EA를 실행하는 동안). LINE Notify(2025년 3월 LINE에 의해 종료됨)를 사용하던 LINE 사용자는 LINE Messaging API를 통해 다시 LINE으로 보낼 수 있으며, 차이점은 아래에서 설명합니다.
기능
- 세 가지 전송 대상, 각각 켜기 또는 끄기, 어떤 조합이든 가능: LINE(Messaging API 푸시, 텍스트만), Discord(웹후크, 텍스트와 차트 스크린샷), Telegram(봇, 텍스트와 차트 스크린샷).
- 이벤트, 각각 켜기 또는 끄기: 포지션 진입, 대기 주문 체결, 손익(스왑 및 수수료 포함)과 pips를 포함한 포지션 청산, SL / TP 변경(포지션 및 대기 주문), 대기 주문 등록·삭제·만료, 설정한 %(기본값 150%) 미만의 증거금 수준, 잔고의 설정한 %(기본값 10%)를 초과하는 평가 손실, 서버 날짜가 바뀔 때의 일일 요약(청산된 거래, 이익 / 손실 건수, 순손익, 잔고, 평가 잔액).
- 다른 프로그램의 메시지: 같은 PC의 어떤 지표, EA 또는 스크립트든 공용 폴더에 텍스트 파일을 작성하면 Trade Notifier가 이를 보냅니다. 스스로 웹 요청을 보낼 수 없는 지표에서도 작동합니다. 파일 형식과 MQL 코드 예제는 사용자 가이드에 있습니다.
- 필터: 모든 심볼, 이 차트의 심볼만, 또는 심볼 목록; 모든 거래, 수동 거래만(magic 0), 또는 매직 넘버 목록.
- 메시지 줄이기: 5초(0-60으로 조정 가능) 이내의 이벤트는 하나의 메시지로 합쳐집니다. LINE에는 사용자가 정한 한도(기본값 180)가 있는 월간 카운터가 있으며, 90%에서 한 번 경고를 받고, 한도에 도달하면 LINE만 멈추고 다른 대상은 계속 전송됩니다.
- 전송되지 않은 메시지는 재시작 후에도 유지되는 대기열에 보관되었다가 나중에 다시 전송됩니다. 각 이벤트는 재시작 후에도 한 번만 전송됩니다.
- 패널의 "테스트 전송"(Test send) 버튼: 켜져 있는 각 대상에 테스트 메시지를 보내고 결과를 표시합니다.
- 패널: 각 대상의 상태(HTTP 코드와 함께 OK, 미설정, URL 허용 안 됨, 전송 속도 제한, 이유와 함께 오류), 이번 달 사용한 LINE 메시지 수, 전송 대기 중인 메시지, 마지막 전송 시각.
- 메시지와 패널은 11개 언어(영어, 일본어, 러시아어, 독일어, 프랑스어, 중국어, 한국어, 터키어, 스페인어, 포르투갈어, 이탈리아어)를 지원하며, 터미널 언어에 따라 자동으로 또는 입력값에서 선택합니다.
- 모든 이벤트와 모든 전송 시도의 CSV 로그. 드라이 런(dry run) 모드는 요청을 전송하는 대신 파일에 기록합니다(토큰은 가려집니다).
주요 설정
- LINE: 전송(기본값 끔), 채널 액세스 토큰, 보낼 곳(본인 사용자 ID 또는 그룹 ID), 월간 한도(기본값 180, 0 = 제한 없음), 수신 인원(기본값 1; LINE은 각 사람을 셉니다).
- Discord: 전송(기본값 끔), 웹후크 URL, 차트 스크린샷 첨부(기본값 켬).
- Telegram: 전송(기본값 끔), 봇 토큰, 채팅 ID, 차트 스크린샷 첨부(기본값 켬).
- 보낼 내용: 포지션 진입, 포지션 청산, SL / TP 변경, 대기 주문(모두 기본값 켬), 증거금 수준 % 미만(기본값 150, 0 = 끔), 잔고의 % 초과 평가 손실(기본값 10, 0 = 끔), 일일 요약(기본값 켬), 다른 프로그램의 메시지(기본값 켬).
- 대상 거래: 심볼(전체 / 이 차트 / 목록), 심볼 목록, 매직 넘버(전체 / 수동만 / 목록), 매직 넘버 목록.
- 전송: 이벤트 합치기 시간(기본값 5초), 미전송 메시지 포기 시간(기본값 24시간, 1-168), 요청 1회의 타임아웃(기본값 5000 ms), 언어, 각 메시지의 제목(비워 두면 = MT5와 계좌 번호 끝 4자리).
- 패널: 표시, 모서리, X / Y 오프셋, 글꼴 크기. 고급: CSV 로그, 드라이 런.
작동 방식
- 설정: LINE 공식 계정과 채널 액세스 토큰, Discord 웹후크 또는 Telegram 봇을 만든 다음, Tools > Options > Expert Advisors > Allow WebRequest for listed URL에 서버 주소를 추가합니다: LINE은 https://api.line.me, Discord는 https://discord.com(웹후크 URL의 호스트; 어느 것을 추가할지 패널에 표시됨), Telegram은 https://api.telegram.org. 그런 다음 "테스트 전송"을 누릅니다. 사용자 가이드에서 공식 메뉴와 함께 모든 단계를 설명합니다.
- 이 도구는 계좌 내역과 포지션 및 주문 목록을 읽고 변경된 내용을 보냅니다. 메시지의 시각은 서버 시간이며 "(server)"로 표시됩니다.
- 터미널이 꺼져 있는 동안에는 아무것도 전송되지 않습니다. 다음 시작 시 도구는 그 사이에 일어난 일을 최대 2일 전까지, 이미 보낸 것은 반복하지 않고 보냅니다. 맨 처음 시작할 때는 과거의 어떤 것도 보내지 않습니다.
- 차트 스크린샷(Discord와 Telegram, 진입·체결·청산된 포지션 및 테스트 전송 시)은 해당 심볼의 차트가 터미널에 열려 있는 경우에만 찍힙니다. 그렇지 않으면 메시지는 이미지 없이 전송됩니다. 이미지는 이 패널과 차트 위의 다른 모든 것을 포함해 차트를 있는 그대로 보여줍니다.
- 전송이 실패하면(연결 없음, 타임아웃, 서버 오류) 10 s, 30 s, 60 s, 2 min, 5 min 후, 그 다음에는 10 min마다 포기 시간(기본값 24시간)까지 재시도합니다. HTTP 429의 경우 서버가 요청하는 만큼 기다립니다. 한 대상으로 가는 메시지는 순서대로 전송되므로, 한 대상이 계속 실패하는 동안에는 그 이후의 메시지도 기다립니다. 다른 대상은 영향을 받지 않습니다.
- LINE 월간 한도: 도구는 서버 시간 기준 달력월 동안 1인당 LINE 메시지를 셉니다. 사용자의 한도에 도달하거나 LINE 자체가 요금제의 월간 한도에 도달했다고 응답하면 LINE은 멈추고 다른 대상은 계속됩니다. LINE은 다음 달에, 또는 월간 한도 입력값을 변경하면 다시 시작됩니다. LINE 자체 한도로 멈춘 경우에는 테스트 전송이 성공해도 다시 시작됩니다. LINE이 멈춘 동안 생성된 LINE용 메시지는 나중에 전송되지 않습니다.
- 계좌당 하나의 차트만 전송합니다. 같은 계좌의 여러 차트에 도구를 붙이면 나머지는 패널만 표시합니다.
- 다른 프로그램의 메시지: 공용 폴더 Terminal\Common\Files\TradeNotifier\queue\의 텍스트 파일은 2초마다 이름 순서로 읽히고 읽은 후 삭제됩니다. 첫 줄(선택 사항): 대상(all, line, discord, telegram)과 스크린샷을 위한 "shot"; 두 번째 줄부터: 본문. 지원 인코딩: UTF-8(BOM 유무 무관), BOM이 있는 UTF-16 LE, ANSI. 파일당 최대 64 KB, 본문 최대 3000자.
- Discord 메시지는 절대 @everyone이나 역할을 호출하지 않습니다(멘션이 꺼져 있음).
참고 및 한계
- 토큰과 웹후크 URL은 EA 입력값과 이를 보관하는 파일에 평문으로 저장됩니다: 저장된 입력값 세트(.set), 차트 프로필과 템플릿(.chr / .tpl). 전략 테스터 로그에도 입력값이 기록됩니다. 이를 입수한 사람은 누구나 사용자의 LINE 계정, Discord 채널 또는 Telegram 봇에 게시할 수 있습니다. 이 파일들을 공유하지 말고, 화면을 공유할 때 입력 창을 보여주지 말며, 공용 PC나 VPS에서는 주의하십시오. 토큰이 유출되면 새로 발급하십시오.
- 기본적으로 모든 메시지는 "MT5"와 계좌 번호 끝 4자리로 시작합니다(예: [MT5 #…1234]). 공유 채널이나 그룹에서는 Title 입력값에 직접 정한 문구를 넣는 것을 권장합니다. 입력하면 그 문구만 제목이 됩니다.
- LINE: 텍스트만 가능하며 이미지는 불가합니다. Messaging API가 활성화된 LINE 공식 계정, 채널 액세스 토큰, 보낼 사용자 ID 또는 그룹 ID가 필요합니다. LINE Notify와 달리 메시지는 LINE 요금제의 월간 메시지 할당량에 포함됩니다(일본에서는 현재 무료 요금제가 월 200건을 허용합니다. 가격, 할당량, 조건은 LINE이 정하며 변경될 수 있습니다). N명의 그룹은 1회 전송당 N건으로 계산됩니다: "수신 인원"을 설정하십시오. 이 도구의 카운터는 추정치이며, 기준이 되는 것은 LINE 자체의 집계(같은 계정에서 다른 방법으로 보낸 메시지 포함)입니다. 그룹 ID는 웹후크로만 확인할 수 있는데, 이 도구는 웹후크를 제공하지 않습니다. 본인 사용자 ID로 보내는 것이 간단한 설정입니다.
- MetaTrader 5가 실행 중이고 연결되어 있으며 도구가 차트에 붙어 있는 동안에만 작동합니다. 지속적인 알림을 위해서는 VPS를 권장합니다.
- 같은 계좌가 두 터미널(예: 사용자의 PC와 VPS)에 로그인되어 있고 둘 다 도구를 실행하면 둘 다 전송하므로 모든 메시지를 두 번 받게 됩니다. 다른 프로그램의 메시지용 공용 폴더는 같은 PC의 모든 터미널이 공유합니다.
- 드문 경우(예: 전송 직후 터미널이 강제 종료된 경우) Discord나 Telegram이 같은 메시지를 두 번 받을 수 있습니다. LINE은 이를 방지하는 재시도 키를 사용합니다.
- 네팅 계좌: 반대 방향 전환은 청산과 새 포지션으로 보고됩니다. 이는 실계좌에서 제한적으로만 확인되었습니다.
- 일일 요약은 서버 날짜가 바뀔 때 작성되며, 그날 청산되어 필터를 통과한 거래를 셉니다(부분 청산은 각각 1건으로 계산). 날짜가 바뀔 때 터미널이 꺼져 있었다면, 터미널이 마지막으로 본 날의 요약이 다음 시작 시 전송됩니다.
- 전략 테스터: 아무것도 전송되지 않습니다. 전송되었을 메시지는 CSV 파일에만 기록됩니다.
- 패널이 원클릭 트레이딩 패널과 겹칠 수 있으므로 기본적으로 더 아래(Y = 100)에 배치됩니다. 모서리와 X / Y 입력값으로 이동하십시오.
호환성 및 지원
- MetaTrader 5, 헤징 및 네팅 계좌, 모든 심볼. 하나의 차트에 붙이십시오. 인터넷 연결과 위 주소에 대한 WebRequest 허용이 필요합니다. Telegram과 Discord 계정은 무료입니다. LINE은 LINE 공식 계정이 필요합니다(일본에는 무료 요금제가 있으며, 다른 국가의 이용 가능 여부와 할당량은 LINE이 정합니다).
- DLL 없음. 파일은 MQL5\Files\TradeNotifier\와 공용 폴더 TradeNotifier\queue\에만 기록됩니다.
- MQL5 메시지를 통한 지원, 영업일 기준 3일 이내 답변: 설치, 설정(LINE, Discord, Telegram, WebRequest) 및 버그 신고. 당사는 사용자의 LINE, Discord 또는 Telegram 계정을 만들거나 운영해 드릴 수 없으며, 매매 조언이나 시장 전망을 제공하지 않습니다.
- LINE, Discord, Telegram은 각 소유자의 상표입니다. 이 제품은 그들이 만들거나 보증하거나 지원하는 제품이 아닙니다.
면책 조항
- 이 제품은 알림용 소프트웨어 도구입니다. 거래를 하지 않으며 투자 조언이 아닙니다. 알림은 터미널, 인터넷 연결 또는 LINE, Discord, Telegram의 서비스로 인해 지연되거나 누락되거나 중복될 수 있습니다. 계좌를 지켜보는 유일한 수단으로 의존하지 마십시오. LINE 요금제의 요금과 조건은 사용자의 책임입니다. 먼저 데모 계좌로 테스트하십시오.
