102 lines
3.2 KiB
Markdown
102 lines
3.2 KiB
Markdown
# DeepCoin — WLD MTF · Ground Truth · Simulation · Operations
|
|
|
|
빗썸 KRW-WLD. 프로젝트는 **세 축**으로만 설계됩니다.
|
|
|
|
| 축 | 역할 | 미래 데이터 |
|
|
|----|------|-------------|
|
|
| **Ground Truth** | 벤치마크 타점·leg·배분 | 허용 (사후 라벨) |
|
|
| **Simulation** | 규칙·인과 백테스트·Go/No-Go | 금지 |
|
|
| **Operations** | 시뮬과 동일 규칙·hybrid 배분 실주문 | 금지 |
|
|
|
|
설계 상세: [docs/reference/ARCHITECTURE.md](docs/reference/ARCHITECTURE.md)
|
|
|
|
## 파이프라인 (권장 순서)
|
|
|
|
```bash
|
|
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` (운영 전 봉 동기화)
|
|
|
|
## 디렉터리
|
|
|
|
```text
|
|
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](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](docs/reference/ARCHITECTURE.md) | 3축 설계 (필독) |
|
|
| [GROUND_TRUTH.md](docs/reference/GROUND_TRUTH.md) | GT 타점 |
|
|
| [SIMULATION.md](docs/reference/SIMULATION.md) | 시뮬·Go/No-Go |
|
|
| [OPERATIONS.md](docs/reference/OPERATIONS.md) | 운영 루틴 |
|
|
| [LIVE_TRADING.md](docs/reference/LIVE_TRADING.md) | 06 실거래 |
|
|
|
|
## 면책
|
|
|
|
실거래 손익은 사용자 책임입니다. 본 저장소는 투자 자문이 아닙니다.
|