dsyoon
b52d61b777
로고스/루트 레거시를 제거하고 deepcoin 패키지·scripts 01~05 CLI·docs/reference로 데이터·GT·분석·매칭·운영 단계를 정리했다. config와 .env 기반 설정, trade_anaysis.html 동기화 포함. Co-authored-by: Cursor <cursoragent@cursor.com>
DeepCoin — WLD MTF 분석·정답·운영
빗썸 KRW-WLD. 1, 3, 5, 10, 15, 30, 60, 240, 1440분 봉을 적재하고,
Ground Truth·기술적 분석·(예정) 규칙 매칭·1분 모니터까지 단계별 폴더로 관리합니다.
로드맵
| 단계 | 목적 | 실행 |
|---|---|---|
| 01 데이터 | 1년치 봉 적재 | python scripts/01_download.py |
| 02 Ground Truth | 매수·매도 정답 타점 | python scripts/02_ground_truth.py |
| 03 분석 | 8TF 기술 지표 enrich | python scripts/03_analyze_enrich.py |
| 03b 분석 | GT 타점 MTF 스냅샷 | python scripts/03_analyze_trades.py |
| 04 매칭 | GT 근접 규칙 선택 (예정) | python scripts/04_match_rules.py |
| 05 운영 | 차트·1분 모니터 | scripts/05_chart_*.py, 05_run_monitor.py |
디렉터리 구조
DeepCoin/
├── .env, config.py
├── scripts/ # ★ 단계별 CLI (유일한 진입점)
├── deepcoin/
│ ├── api/bithumb.py # 빗썸 API
│ ├── data/ # 01 다운로드
│ ├── ground_truth/ # 02 정답 타점
│ ├── analysis/ # 03·03b 지표·스냅샷
│ ├── matching/ # 04 규칙 매칭 (예정)
│ └── ops/ # 05 모니터·차트
├── data/ # coins.db, ground_truth/, ops/
└── docs/
├── reference/ # 가이드·기법 명세 (Git)
└── 02~05, charts/ # 단계별 HTML·CSV (재생성)
상세: docs/reference/STRUCTURE.md · docs/README.md
환경 변수
| 파일 | 용도 |
|---|---|
.env |
전역 설정·API 키 (Git 제외, 프로젝트 루트에 필수) |
config.py와 scripts/_bootstrap.py가 프로젝트 루트 .env를 python-dotenv로 자동 로드합니다. 새 환경에서는 팀에서 .env를 전달받거나 기존 로컬 파일을 복사하세요.
pip install -r requirements.txt
빠른 시작
python scripts/01_download.py
python scripts/02_ground_truth.py
python scripts/03_analyze_enrich.py
python scripts/03_analyze_trades.py
python scripts/05_chart_truth.py
주요 설정 (config.py / .env)
| 항목 | 설명 |
|---|---|
BITHUMB_ACCESS_KEY |
빗썸 API (다운로드·시세) |
DB_PATH |
data/coins.db (.env로 변경 가능) |
GROUND_TRUTH_FILE |
data/ground_truth/ground_truth_trades.json |
CHART_LOOKBACK_DAYS |
기본 365일 |
DOWNLOAD_MONTHS |
3분 이상 봉 12개월 |
MONITOR_LOOP_SLEEP_SEC |
05 모니터 루프 주기(초) |
산출물
| 경로 | 내용 |
|---|---|
data/coins.db |
전 간격 OHLCV |
data/ground_truth/ground_truth_trades.json |
정답 타점 |
docs/charts/wld_bb_chart.html |
3분 BB 차트 |
docs/02_ground_truth/wld_ground_truth_chart.html |
정답 차트 |
docs/03_analysis/latest/*_latest.csv |
간격별 최근 봉 전 기법 |
docs/03_analysis/general_analysis_trades.csv |
GT 타점 MTF 스냅샷 |
면책
실거래는 사용자 책임입니다. 본 저장소는 주문 실행을 포함하지 않습니다.