빠른 시작

요구사항

• Python 3.11 이상
• Git

설치

# uv 설치 (없는 경우)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 프로젝트 클론
git clone https://github.com/geniuskey/moneymax.git
cd moneymax

# 의존성 설치 (가상환경 자동 생성)
uv sync

환경변수 설정

cp .env.example .env

.env 파일을 열어 필요한 API 키를 입력합니다.

최소 설정 (Paper 모드)

Paper Trading만 사용할 경우 Binance API 키만 있으면 됩니다 (데이터 조회용).

# Binance (데이터 조회 — API 키 없이도 public 데이터 접근 가능)
BINANCE_API_KEY=
BINANCE_API_SECRET=

# Telegram 알림 (선택)
TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_CHAT_ID=your_chat_id

전체 설정

# Discord
DISCORD_BOT_TOKEN=your_discord_bot_token
DISCORD_GUILD_ID=your_guild_id

# Binance
BINANCE_API_KEY=your_binance_api_key
BINANCE_API_SECRET=your_binance_api_secret

# Upbit (한국 크립토)
UPBIT_ACCESS_KEY=your_upbit_access_key
UPBIT_SECRET_KEY=your_upbit_secret_key

# 한국투자증권 (한국 주식)
KIS_APP_KEY=your_kis_app_key
KIS_APP_SECRET=your_kis_app_secret
KIS_ACCOUNT_NO=your_account_number

# 감성 분석 데이터
NEWSAPI_KEY=your_newsapi_key
REDDIT_CLIENT_ID=your_reddit_client_id
REDDIT_CLIENT_SECRET=your_reddit_client_secret

# Telegram
TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_CHAT_ID=your_chat_id

첫 실행

Paper Trading (모의투자)

uv run python scripts/auto_trader.py --paper

기본 설정:

• 초기 자본: 10,000 USDT
• 전략: crypto_momentum (1시간), crypto_scalp (5분)
• 심볼: BTC/USDT, ETH/USDT, SOL/USDT, BNB/USDT

옵션

# 초기자본 변경
uv run python scripts/auto_trader.py --paper --balance 50000

# Telegram 알림 비활성화
uv run python scripts/auto_trader.py --paper --no-telegram

# 도움말
uv run python scripts/auto_trader.py --help

실행 확인

정상 실행 시 콘솔에 Rich 테이블이 표시됩니다:

──────────────────── MoneyMax Auto-Trader ────────────────────
  Total: 10,000.00 USDT  |  Cash: 10,000.00  |  PnL: +0.00  |  Return: +0.00%

  No open positions

───────────────────── Recent Signals ─────────────────────
  Time     Symbol    Action  Strategy          Confidence  Price
  14:30:00 BTC/USDT  BUY     crypto_momentum   0.87        97,500.00

다음 단계

• 전략 이해하기 — 4가지 전략의 동작 원리
• 자동매매 엔진 — 엔진 구조와 동작 흐름
• Telegram 설정 — 실시간 알림 설정
• 서버 배포 — Oracle Cloud에서 24시간 운영