시작하기 · v6.0+ · Latest stable

시스템 요구 사항

MagicTradeBot v6.0Rust로 구축된 경량 고성능 트레이딩 자동화 시스템입니다. 최소한의 하드웨어에서도 효율적으로 실행되도록 설계되었으며, 확장, 다중 봇 배포, 외부 신호 연동을 위한 선택적 고급 구성 요소를 지원합니다.

⚙️ 시스템 개요

MagicTradeBot은 모듈식 설정 시스템을 갖춘 네이티브 컴파일 바이너리로 실행됩니다. 무설정(Zero-configuration) 환경과 고급 프로덕션 배포 모두를 지원합니다.

  • ✅ 런타임 의존성 없음 (Node, Python, Java 등 불필요)
  • ✅ 단일 실행 파일로 동작
  • ✅ 모듈식 /settings 설정 시스템
  • ✅ 확장 및 통합을 위한 선택적 외부 서비스 지원

💻 시스템 요구사항

구성 요소 요구사항
운영체제 Windows 10+, macOS (Intel/Apple Silicon), Linux (Ubuntu, Debian, CentOS, Alpine)
런타임 외부 런타임 불필요 (네이티브 Rust 바이너리)
CPU / RAM 최소: 1 vCPU / 512 MB RAM • 권장: 1–2 vCPU / 1 GB+ RAM
저장 공간 < 100 MB (로그 및 설정 포함)
네트워크 거래소 API 사용을 위한 안정적인 인터넷 연결 필요
설정 /settings 디렉터리 내 모듈식 YAML 파일

🗄️ 데이터베이스 및 저장 옵션

MagicTradeBot v6.0은 배포 환경에 따라 유연한 저장소 백엔드를 제공합니다:

옵션 설명 사용 사례
SQLite (기본) 임베디드 경량 데이터베이스 (설정 불필요) 단일 봇, 로컬 환경
PostgreSQL 여러 봇 인스턴스 간 공유 데이터베이스 다중 봇 배포, 중앙 모니터링
💡 SQLite는 별도 설정 없이 자동으로 실행됩니다.
💡 PostgreSQL은 여러 봇 간 상태 공유가 가능한 고급 환경을 제공합니다.

⚡ 선택적 서비스 및 통합

1. Redis + RedisMarketBridge (선택 사항)

Redis는 고속 시장 데이터 스트리밍 및 공유 상태 캐싱에 사용됩니다.

  • Redis 서버 필요 (로컬 또는 원격)
  • RedisMarketBridge 어댑터 애플리케이션 필요
  • 실시간 시장 데이터를 Redis로 스트리밍
⚠️ 설정에서 Redis가 활성화된 경우 RedisMarketBridge가 반드시 실행 중이어야 합니다.
그렇지 않으면 봇이 시장 데이터를 수신할 수 없습니다.

2. TradingView Signal Bridge (TradingView 신호 필수)

TradingView 외부 신호를 사용하려면 중간 브리지 서비스가 필요합니다.

  • TradingView → 웹훅 알림 전송
  • TV Signal Bridge → 신호 검증 및 스트리밍
  • MagicTradeBot → 신호 수신 및 거래 실행
⚠️ TV Signal Bridge가 없으면 TradingView 신호는 동작하지 않습니다.

🚀 배포

추가 기능이 있어도 배포 과정은 간단하게 유지됩니다:

  • 패키지 다운로드 및 압축 해제
  • Bot Configurator를 통해 설정 (권장)
  • /settings 디렉터리 교체
  • API 키 환경 변수 설정
  • 바이너리 실행
# Linux / macOS
./MagicTradeBot

# Windows
MagicTradeBot.exe

  • 단일 봇: SQLite 사용
  • 다중 봇 환경: PostgreSQL 사용
  • 고급 시장 데이터 스트리밍 시에만 Redis 활성화
  • 24/7 운영을 위해 VPS 사용 권장
✅ 최소 구성 → SQLite만 사용
✅ 확장 구성 → PostgreSQL + Redis
✅ 고급 신호 → TradingView Bridge

MagicTradeBot v6.0은 단순성과 확장성을 균형 있게 제공하여, 초기에는 무설정으로 시작하고 시스템이 성장함에 따라 점진적으로 고급 기능을 활성화할 수 있도록 설계되었습니다.

+