Files

dsyoon b52d61b777 WLD DeepCoin 단계별 구조 재편 및 설정·문서 통합

로고스/루트 레거시를 제거하고 deepcoin 패키지·scripts 01~05 CLI·docs/reference로
데이터·GT·분석·매칭·운영 단계를 정리했다. config와 .env 기반 설정, trade_anaysis.html 동기화 포함.

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-05-30 22:58:25 +09:00

3.2 KiB

Raw Blame History

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`

상세: docs/reference/ROADMAP.md

디렉터리 구조

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 스냅샷

면책

실거래는 사용자 책임입니다. 본 저장소는 주문 실행을 포함하지 않습니다.

3.2 KiB Raw Blame History