설치 가이드

사전 요구사항

• Docker Desktop (Redis를 사용하는 경우에만 필요)
• API 키가 있는 지원 거래소 계정
• 서버의 공용 IP 주소 (API 화이트리스트용)

목차

1. 봇 설정
2. API 키 설정
3. Redis 설정
4. RedisMarketBridge
5. 봇 실행
6. 문제 해결
7. TradingView 연동

1. 봇 설정

모든 설정은 온라인 컨피규레이터를 통해 진행됩니다.

1. 열기: Configurator
2. MagicTradeBot 선택
3. 설정 구성:

설정 내보내기:

1. Export All YAML 클릭
2. 압축 해제
3. 프로젝트의 /settings 폴더 교체

magictradebot/
├── settings/  ← 교체
├── MagicTradeBot
├── MagicTradeBot.exe
└── .env

2. API 키 설정

🔐 보안: 항상 환경 변수를 사용하세요. 설정 파일에 API 키를 저장하지 마세요.

IP 화이트리스트 등록

curl ifconfig.me

이 IP를 거래소 API 화이트리스트에 추가하세요.

.env 사용

BINANCE_API_KEY=your_key
BINANCE_API_SECRET=your_secret

⚠️ .env 파일을 .gitignore에 추가하세요

3. Redis 설정 (선택 사항)

Redis가 활성화된 경우에만 필요합니다.

Docker로 Redis 실행

docker run -d \
--name magictradebot-redis \
-p 6379:6379 \
--restart unless-stopped \
redis:latest

확인

docker exec -it magictradebot-redis redis-cli ping

예상 결과: PONG

4. RedisMarketBridge

이 컴포넌트는 실시간 시장 데이터를 Redis로 전달합니다.

⚠️ 거래소 + 페어 + 타임프레임은 반드시 봇 설정과 정확히 일치해야 합니다

단계:

1. 컨피규레이터에서 설정
2. YAML 내보내기
3. adapters/redismarketbridge/settings 교체

5. 봇 실행

실행 순서

1. Redis 시작
2. RedisMarketBridge 시작
3. 2분 대기
4. MagicTradeBot 실행

Linux / macOS

chmod +x MagicTradeBot
./MagicTradeBot

Windows

MagicTradeBot.exe

💡 로그 확인을 위해 터미널에서 실행하세요

6. 문제 해결

API 오류

• IP 화이트리스트 확인
• 권한 확인
• 환경 변수 확인

시장 데이터 없음

• RedisMarketBridge 시작 후 2분 대기
• 설정 일치 여부 확인

Redis 문제

• Docker 실행 여부 확인
• 포트 6379 열림 확인

7. TradingView 시그널 연동

MagicTradeBot은 TradingView의 외부 시그널을 Webhook을 통해 지원합니다.

작동 방식

• TradingView 알림 전송 → webhook
• MagicTradeBot 시그널 수신
• 자동으로 거래 실행

Step 1 — 봇에서 Webhook 활성화

봇 설정에서:

• Signals → Webhook 활성화
• Webhook URL 복사

예시:

http://your-server:port/webhook

Step 2 — TradingView 알림 생성

1. TradingView 차트 열기
2. 지표 또는 전략 추가
3. Alert 클릭
4. Webhook URL 활성화
5. 봇 Webhook URL 붙여넣기

Step 3 — 알림 메시지 정의

JSON 예시:

{
  "symbol": "BTCUSDT",
  "action": "buy",
  "price": "{{close}}",
  "time": "{{time}}"
}

지원 액션

• buy
• sell
• close

중요 사항

• 심볼은 봇 설정과 정확히 일치해야 함
• 타임프레임 정렬 확인
• 소액으로 먼저 테스트

⚠️ 잘못된 payload 형식 = 시그널 무시됨

테스트

Webhook 테스트:

curl -X POST http://your-server/webhook \
-H "Content-Type: application/json" \
-d '{"symbol":"BTCUSDT","action":"buy"}'

✅ 올바르게 설정된 경우, 봇이 거래를 실행합니다

💡 자세한 내용은 공식 TradingView 문서를 참고하세요.