MetaTrader 5 봇의 기능
커뮤니티 기반 metatrader-5-bot은 로컬 MetaTrader 5 터미널을 Discord, Telegram 또는 두 플랫폼 모두에 연결하는 Windows 데스크톱 애플리케이션입니다. 전략 선택, 거래 실행 제어, 시장 정보 확인, 포지션 모니터링, 런타임 설정 변경 및 보고서 생성을 위한 채팅 명령을 제공합니다.
독립 실행형 Windows x64 빌드에는 사용 가능한 모듈과 자동화 루틴이 하나의 패키지로 포함되어 있습니다. 로컬에서 실행되며 필수 클라우드 서비스가 필요하지 않습니다. 관련 Discord 또는 Telegram API와의 통신을 제외하면 메시징 플랫폼 토큰과 봇 설정은 컴퓨터에 저장됩니다.
주요 기능
- 로컬 실행: 봇과 설정이 Windows 컴퓨터에서 실행됩니다.
- Discord 및 Telegram 지원: 한 플랫폼만 활성화하거나 두 메시징 프런트엔드를 동시에 실행할 수 있습니다.
- 전략 제어: 전략을 찾아보고, 활성 전략을 선택하고, 매개변수를 확인하며, 실행을 일시 중지하거나 재개할 수 있습니다.
- 시장 및 계정 모니터링: 시세, 캔들, 지표, 신호, 포지션, 주문, 잔액 정보 및 보고서를 요청할 수 있습니다.
- 편집 가능한 설정: 소스 코드를 수정하지 않고 권한, 명령 동작, 위험 한도, 랏 크기, 관심 목록, 로깅 및 알림을 조정할 수 있습니다.
- 사전 구성된 기본값: 포함된 기본값은 초기 설정 작업을 줄이면서도 편집할 수 있도록 구성되어 있습니다.
- 커뮤니티 개발: 버그 보고, 설정 아이디어 및 기능 요청이 유지 관리 방향을 정하는 데 도움이 됩니다.
자동 거래는 금전적 손실을 초래할 수 있습니다. 실거래 실행을 활성화하기 전에 모든 설정을 확인하고, 전략을 신중하게 테스트하며, 봇이 의도한 터미널과 계정에 연결되어 있는지 확인하십시오.
요구 사항
봇을 설치하기 전에 컴퓨터가 프로젝트에 문서화된 요구 사항을 충족하는지 확인하십시오.
- Windows 10 또는 Windows 11
- PowerShell 5.1 이상( PowerShell 7 포함)
- 활성 네트워크 연결
- Windows x64 데스크톱 환경
설치 프로그램에는 관리자 권한이 필요하지 않습니다. 또한 로컬 MetaTrader 5 터미널과 활성화하려는 각 메시징 플랫폼의 자격 증명 또는 토큰이 필요합니다.
데스크톱 빌드 설치
저장소는 수동 종속성 설치 절차 대신 PowerShell 설정 페이지를 제공합니다. Windows 컴퓨터에서 프로젝트의 PowerShell 설정 버튼 페이지를 열고 표시되는 설정 지침을 따르십시오.
- Windows 10 또는 Windows 11을 사용 중인지 확인합니다.
- PowerShell을 열고 컴퓨터에서 사용할 수 있는지 확인합니다.
- 프로젝트 설정 페이지를 방문하여 표시된 설치 지침을 검토합니다.
- 일반 사용자 계정으로 제공된 설정 프로세스를 실행합니다. README에 따르면 관리자 권한은 필요하지 않습니다.
- 설정이 완료되면 설치된 데스크톱 빌드를 실행합니다.
README에는 정확한 설치 디렉터리, 실행 파일 이름, 설정 파일 이름 또는 설치 프로그램에 표시되는 모든 프롬프트가 명시되어 있지 않습니다. 릴리스마다 다를 수 있는 경로나 명령을 가정하지 말고 현재 설정 페이지를 따르십시오. 다운로드한 PowerShell 설정 프로세스와 마찬가지로 실행하기 전에 소스와 지침을 검토하십시오.
Discord 및 Telegram 구성
봇은 애플리케이션과 함께 설치된 하나의 중앙 설정 파일에서 설정을 읽습니다. 기본 백업 파일도 함께 포함되어 있습니다. README에는 파일의 정확한 이름이나 스키마가 제공되지 않으므로 설치된 패키지에서 설정 파일을 찾아 기존 구조를 유지한 채 편집하십시오.
- 파일 기반 설정을 변경하기 전에 봇을 중지합니다.
- 현재 설정과 포함된 기본 백업의 별도 복사본을 만듭니다.
- 일반 텍스트 편집기에서 활성 설정 파일을 엽니다.
- 해당 필드에 Discord 토큰, Telegram 토큰 또는 두 토큰을 모두 입력합니다.
- 사용할 메시징 프런트엔드만 활성화합니다.
- 채널 권한과 역할 기반 접근 제어를 구성합니다.
- 파일을 저장하고 봇을 다시 시작하여 변경 사항을 적용합니다.
토큰은 비밀 정보로 취급해야 합니다. 공개 이슈, 스크린샷, 보고서 또는 공유 설정 예시에 토큰을 붙여 넣지 마십시오. 프로젝트에 따르면 토큰은 로컬에 보관되며 해당 플랫폼 API로만 전송됩니다.
명령 액세스를 신중하게 설정
설정은 명령 접두사, 슬래시 명령 기본 설정, 채널 권한 및 역할 기반 액세스 등급을 지원합니다. 일반 사용자는 읽기 전용 정보를 요청할 수 있도록 허용하고 거래 및 설정 명령은 신뢰할 수 있는 역할로 제한하는 방식이 실용적입니다.
- 읽기 전용 명령의 예로는
/quote,/history,/indicators및/signals가 있습니다. - 계정 관련 명령으로는
/positions,/orders및/balance가 있습니다. /start trade,/close all및/config set과 같은 거래 제어 명령에는 가장 엄격한 액세스 제어를 적용해야 합니다.
초기 연결 확인
전략을 변경하거나 실행을 활성화하기 전에 정보 제공 명령부터 시작하십시오. 권한이 부여된 Discord 또는 Telegram 채널에서 다음 명령을 전송합니다.
/start
/help
/version
/status/start는 봇을 열고 소개를 표시합니다. /help는 카테고리별 명령을 나열하고, /version은 설치된 빌드 버전을 표시하며, /status는 연결 상태, 활성 전략, 세션 가동 시간을 보고합니다.
다음으로 봇을 로컬 데스크톱 터미널에 연결합니다:
/connect
/status계속하기 전에 반환된 상태를 확인합니다. 연결이 예상대로 작동하지 않으면 구성을 검토하고 /logs를 사용해 최근 활동을 확인합니다.
전략 선택 및 확인
봇에는 포함된 전략을 탐색하고 재시작 없이 활성 선택 항목을 변경할 수 있는 명령이 있습니다.
/strategies
/strategy set
/strategy params
/signals/strategies는 포함된 전략 라이브러리를 표시합니다. /strategy set을 사용해 활성 전략을 전환한 다음, /strategy params를 사용해 매개변수를 확인하거나 조정합니다. README에는 인수 구문이나 포함된 전략 이름이 문서화되어 있지 않으므로 설치된 빌드에 표시되는 안내와 출력을 따릅니다. 선택한 전략의 가장 최근 출력을 확인하려면 /signals를 사용합니다.
거래 매개변수 구성
중앙 구성은 손절 및 익절 수준, 거래당 위험 한도, 랏 크기 규칙, 심볼 관심 목록을 지원합니다. 런타임 환경설정은 다음 구성 명령으로 확인하고 조정할 수도 있습니다:
/config view
/config set먼저 /config view를 사용해 현재 활성 값을 파악합니다. 위험 또는 규모 조정 제어 항목을 변경할 때는 한 번에 하나의 설정만 조정하고 계속하기 전에 결과 구성을 확인합니다. 중앙 구성 파일을 직접 수정한 경우 봇을 재시작해 새 값을 불러옵니다.
시장 데이터 및 모니터링 명령 사용
거래 실행을 허용하기 전에 봇이 예상되는 시장 및 계정 정보를 가져올 수 있는지 확인합니다.
시장 정보
/quote
/history
/indicators
/signals/quote는 지원되는 심볼의 최신 매수호가와 매도호가를 요청합니다./history는 선택한 시간 간격의 최근 캔들을 가져옵니다./indicators는 사용 가능한 기본 제공 지표와 현재 값을 나열합니다./signals는 활성 전략의 최근 출력을 표시합니다.
포트폴리오 및 계정 정보
/positions
/orders
/balance
/report/positions는 진입가, 규모, 변동 손익을 포함한 열린 포지션을 나열합니다./orders는 대기 중인 주문과 발동 수준을 표시합니다./balance는 잔액, 자산, 마진 사용량을 반환합니다./report는 세션 또는 일일 성과 요약을 생성합니다.
기록을 위해 최신 보고서를 로컬에 저장하려면 /export를 사용합니다.
거래 세션 제어
터미널 연결, 활성 전략, 매개변수, 권한, 계정 정보를 확인한 후 사용할 수 있는 세션 제어 명령은 다음과 같습니다:
/start trade
/pause
/resume
/close all/start trade는 활성 구성으로 실거래를 시작합니다. /pause는 세션을 유지하면서 거래 실행을 일시적으로 중지하고, /resume은 세션을 계속 진행합니다. /close all은 봇이 관리하는 모든 열린 포지션을 종료합니다.
연결 테스트로
/start trade를 사용하지 마세요. 먼저 상태, 시장 데이터, 신호, 계정 명령으로 설정을 검증합니다. 실거래 실행과/close all은 모두 신뢰할 수 있는 사용자로 제한하세요.
로깅, 알림 및 복구
구성에서 로그 상세도와 알림 동작을 선택할 수 있습니다. 알림은 조용한 백그라운드 작업부터 선택한 채널로 거래별 업데이트를 보내는 방식까지 다양하게 설정할 수 있습니다. 다음 유틸리티 명령은 일상적인 운영을 지원합니다:
/notify
/logs
/reset/notify는 거래 이벤트에 대한 데스크톱 및 봇 알림을 전환합니다./logs는 모니터링 및 문제 해결을 위해 최근 활동을 가져옵니다./reset은 깨끗한 구성으로 시작해야 할 때 기본값을 복원합니다.
/reset을 사용하기 전에 사용자 지정 구성을 백업하세요. 파일을 직접 수정한 후에는 봇을 재시작해 구성을 다시 불러오도록 합니다.
고급 팁
정보 접근 권한과 실행 권한 분리
시장 조회, 계정 데이터, 거래 작업을 구분하는 권한 등급을 만드세요. 공개 또는 광범위한 커뮤니티 역할에는 제한된 정보만 제공하고, 신뢰할 수 있는 운영자에게 구성 및 실행 명령에 대한 독점 권한을 부여할 수 있습니다.
한 번에 하나의 매개변수만 변경
정상 작동이 확인된 구성의 사본을 보관하고, 값을 하나만 수정한 뒤 필요한 경우 재시작하고 상태, 로그, 신호를 비교하세요. 이렇게 하면 예기치 않은 동작의 원인을 추적하기 쉽고 롤백도 간단해집니다.
모든 세션에서 보고서 사용
/report로 세션 또는 일일 요약을 생성한 다음 /export로 저장하세요. 예기치 않은 동작을 조사하거나 재현 가능한 버그 보고서를 제출할 때 관련 로그와 보고서를 함께 사용하세요.
프로젝트 변경 사항 모니터링
/changelog를 사용해 현재 빌드에서 변경된 내용을 확인하세요. 저장소에서는 릴리스 노트를 확인하고 로컬 독립 실행형 설치 프로그램을 검증된 릴리스에 맞춰 유지할 것을 권장합니다.
커뮤니티 명령 사용
/tips
/changelog
/feedback/tips는 커뮤니티와 유지 관리자들의 실용적인 제안을 반환합니다. /changelog는 빌드 변경 사항을 표시하고, /feedback은 아이디어를 공유하거나 특이 사항을 보고할 수 있는 경로를 제공합니다.
유용한 버그 보고서 작성
문제를 보고할 때는 Windows 버전, 활성화된 메시징 플랫폼, 예상 동작, 실제 동작, 재현 단계 및 관련 로그를 포함하세요. 파일이나 스크린샷을 공유하기 전에 토큰, 계정 자격 증명 및 기타 개인 정보를 삭제하세요.
결론
MetaTrader 5 봇은 Windows 거래 터미널과 Discord 또는 Telegram 사이에 로컬 브리지를 제공합니다. 신중한 설정은 PowerShell 설치 페이지 확인, 안전한 토큰 구성, 제한적인 명령 권한 및 읽기 전용 확인 명령으로 시작됩니다. 연결과 전략 매개변수를 검증한 후에는 봇을 통해 거래 세션을 관리하고, 계정 활동을 모니터링하며, 보고서를 내보내고, 채팅 기반 워크플로에서 구성 가능한 알림을 지원할 수 있습니다.