MagicTradeBot을 처음 실행하기 전에 어떤 설정을 구성해야 하나요?

초기 설정 가이드

MagicTradeBot을 처음 시작하기 전에 봇이 올바르게 시작되고, 거래소에 안전하게 연결되며, 오류 없이 작동하도록 소수의 필수 및 권장 설정을 구성해야 합니다.

MagicTradeBot은 안전한 기본값으로 설계되었으므로 모든 파일을 미리 구성할 필요가 없습니다. 아래 단계는 원활한 첫 실행을 위한 최소 필수 및 권장 설정을 다룹니다.

1. application.yaml에서 거래소 구성

MagicTradeBot이 연결할 거래소를 지정해야 합니다.

Exchange:
  Name: "bybit"

지원되는 거래소:

Binance
Bybit
OKX
Bitget
Hyperliquid

⚠️ 중요: 각 거래소에는 엄격한 포지션 모드 요구 사항(원웨이 vs 헤지)이 있습니다. 봇을 실행하기 전에 거래소 계정이 이에 따라 구성되어 있는지 확인하세요.

2. 거래소 API 자격 증명 설정 (필수)

MagicTradeBot은 거래를 실행하고 관리하기 위해 API 액세스가 필요합니다.

권장 방법: 환경 변수 (모범 사례)

특히 프로덕션 환경에서는 환경 변수 사용을 강력히 권장합니다. 그 이유는:

API 키가 파일에 저장되지 않음
키가 더 안전하고 교체하기 쉬움
환경 변수가 YAML 값을 자동으로 재정의함

운영 체제별 환경 변수 설정

✅ Windows (PowerShell)

setx BINANCE_API_KEY "여기에_your_api_key_입력"
setx BINANCE_API_SECRET "여기에_your_api_secret_입력"

변수를 설정한 후 터미널(또는 시스템)을 다시 시작하세요.

✅ Linux / macOS (터미널)

export BINANCE_API_KEY="여기에_your_api_key_입력"
export BINANCE_API_SECRET="여기에_your_api_secret_입력"

영구적으로 적용하려면 다음 파일에 줄을 추가하세요:

~/.bashrc
~/.zshrc
셸 프로필 파일

✅ Docker / Docker Compose

environment:
  - BINANCE_API_KEY=${BINANCE_API_KEY}
  - BINANCE_API_SECRET=${BINANCE_API_SECRET}

지원되는 환경 변수 이름

예시:

BINANCE_API_KEY, BINANCE_API_SECRET
BYBIT_API_KEY, BYBIT_API_SECRET
OKX_API_KEY, OKX_API_SECRET, OKX_PASSPHRASE
BITGET_API_KEY, BITGET_API_SECRET, BITGET_PASSPHRASE
HYPERLIQUID_PRIVATE_KEY

🔐 API 키에 출금 권한을 절대 활성화하지 마세요.

3. 라이선스 키 제공

application.yaml 파일에서:

License:
  Key: "여기에_라이선스_키_입력"

라이선스 키를 얻는 방법

https://magictradebot.com에 로그인
다운로드로 이동
라이선스 키 복사

중요 참고 사항

봇은 라이선스 없이도 실행될 수 있습니다
그러나 기능이 제한됩니다
라이선스 검증은 시작 시 수행됩니다

4. 기본 거래 설정 검토 (trading.yaml)

처음 사용하는 사용자의 경우 이 파일은 필수 변경이 필요하지 않습니다.

선택적으로 다음을 검토하거나 조정할 수 있습니다:

초기 거래 금액
기본 레버리지
위험 한도

확실하지 않은 경우 기본값을 그대로 두십시오. 초기 실행 및 데모 모드에서 안전합니다.

5. 최초 심볼 및 레버리지 설정 (매우 중요)

1단계: 심볼 동기화 활성화 (첫 실행만)

trading.yaml(또는 심볼 구성 파일)에서:

SyncSymbolsOnStartup: true

이 작업은 다음을 수행합니다:

거래소에서 지원되는 모든 심볼 가져오기
symbols.json 생성 또는 업데이트
상장 폐지된 심볼 제거
새로 상장된 심볼 추가

➡️ 봇을 실행하고 심볼 동기화가 완료될 때까지 기다립니다
➡️ symbols.json 파일을 모니터링합니다
➡️ 동기화가 완료되면 봇을 중지합니다

2단계: 심볼 동기화 비활성화 (선택 사항)

첫 번째 동기화 후 다음을 설정할 수 있습니다:

SyncSymbolsOnStartup: false

자동 심볼 업데이트를 원하면 영구적으로 true로 유지하세요.

3단계: 일회성 레버리지 설정 (선택 사항이지만 권장됨)

MagicTradeBot이 레버리지를 자동으로 구성하도록 하려면:

SetLeverageStartup: true
SetMaxLeverage: false

이렇게 하면 구성된 레버리지(예: 10배)가 지원되는 모든 심볼에 적용됩니다
봇을 한 번 실행합니다
레버리지 업데이트를 위해 몇 분 기다립니다
그런 다음 두 옵션을 모두 false로 다시 설정합니다

⚠️ 이러한 옵션을 영구적으로 활성화된 상태로 두지 마십시오. 그렇지 않으면 다시 시작할 때마다 레버리지가 재설정됩니다.

최대 레버리지 (스캘핑 사용 사례)

거래소에서 허용하는 최대 레버리지를 원하는 경우:

SetMaxLeverage: true

이것은 한 번만 사용하고 다시 비활성화하세요.

6. 거래할 심볼 선택 (선택 사항)

다음을 할 수 있습니다:

동기화된 모든 심볼(500개 이상) 거래
또는 선택된 심볼로만 거래 제한

예시:

BTCUSDT
ETHUSDT
SOLUSDT
XRPUSDT

모든 심볼을 거래하는 경우 다음을 유지하세요:

SyncSymbolsOnStartup: true

7. 알림 구성 (매우 권장됨)

notification.yaml에서 최소한 하나의 알림 채널을 설정하세요:

Telegram
Discord

이렇게 하면 다음을 받을 수 있습니다:

거래 실행
오류 및 실패
시장 조사 경고
긴급 이벤트

알림 없이 실행하는 것은 가능하지만 권장되지 않습니다.

최종 확인 목록 (첫 실행)

MagicTradeBot을 시작하기 전에 다음을 확인하세요:

✅ application.yaml에서 거래소 선택됨
✅ API 자격 증명 설정됨 (가급적 환경 변수를 통해)
✅ 라이선스 키 추가됨 (선택 사항이지만 권장됨)
✅ 첫 실행을 위해 심볼 동기화 활성화됨
✅ 선택적 레버리지 설정이 한 번 완료됨
✅ 알림 채널 구성됨

그게 다입니다.
안전하고 올바르게 거래를 시작하는 데 필요한 다른 구성은 없습니다.