Bithumb/README.md

DeepCoin — WLD MTF · Ground Truth · Simulation · Operations

빗썸 KRW-WLD. 프로젝트는 세 축으로만 설계됩니다.

축	역할	미래 데이터
Ground Truth	벤치마크 타점·leg·배분	허용 (사후 라벨)
Simulation	규칙·인과 백테스트·Go/No-Go	금지
Operations	시뮬과 동일 규칙·hybrid 배분 실주문	금지

설계 상세: docs/reference/ARCHITECTURE.md

파이프라인 (권장 순서)

conda activate ncue   # 또는 xavis

# 데이터
python scripts/01_download.py

# Ground Truth
python scripts/02_ground_truth.py
python scripts/03_analyze_enrich.py
python scripts/03_analyze_trades.py
python scripts/03_gt_mtf_profile.py
python scripts/05_chart_truth.py

# Simulation
python scripts/04_match_rules.py
python scripts/04_simulation_report.py

# Operations (LIVE_TRADING_ENABLED=1)
python scripts/06_verify_live.py
python scripts/check_balance.py
python scripts/06_execute_live.py --once
python scripts/06_execute_live.py

선택: 05_run_monitor.py (알림만), 07_daily_pnl_telegram.py (매일 24h 수익률), 00_sync_ops.py (운영 전 봉 동기화)

디렉터리

DeepCoin/
├── scripts/              # CLI 진입점 (GT / Sim / Ops)
├── deepcoin/
│   ├── data/             # 01
│   ├── ground_truth/     # GT
│   ├── analysis/         # GT 입력 (03)
│   ├── matching/         # Sim (04)
│   └── ops/              # Ops (05·06)
├── data/                 # coins.db, ground_truth/, ops/
└── docs/
    ├── reference/        # ARCHITECTURE, SIMULATION, OPERATIONS …
    └── 02~05/              # 재생성 산출물

환경

파일	용도
.env	API 키·전역 설정 (Git 제외)
config.py	.env 로드

scripts/_bootstrap.py가 루트 .env를 자동 로드합니다.

주요 변수

변수	기본	축
CHART_LOOKBACK_DAYS	365	GT·Sim
GT_INITIAL_CASH_KRW	400000	GT·Sim·Ops 배분
GENERAL_ANALYSIS_INTERVALS	3m~일봉+주·월	Sim 스캔
GT_SIGNAL_CAUSAL	1	Sim·Ops (인과)
LIVE_TRADING_ENABLED	1	Ops (0이면 06 기동 불가)

전체: .env.example, docs/05_ops/env.recommended.md

산출물

경로	축
data/ground_truth/ground_truth_trades.json	GT
docs/02_ground_truth/wld_ground_truth_chart.html	GT 차트 (05_chart_truth.py 재생성)
docs/04_matching/matched_rules.json	Sim
docs/04_matching/simulation_report.html	Sim
data/ops/live_trades.jsonl	Ops

문서

문서	내용
ARCHITECTURE.md	3축 설계 (필독)
GROUND_TRUTH.md	GT 타점
SIMULATION.md	시뮬·Go/No-Go
OPERATIONS.md	운영 루틴
LIVE_TRADING.md	06 실거래

면책

실거래 손익은 사용자 책임입니다. 본 저장소는 투자 자문이 아닙니다.