refactor: 프로젝트명 bithumb으로 변경 및 futures 파이프라인 제거
deepcoin 패키지를 bithumb으로 rename하고, 3단계 live 운영·사이징 튜닝·텔레그램 알림을 통합한다. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
45
README.md
45
README.md
@@ -1,15 +1,15 @@
|
||||
# DeepCoin
|
||||
# Bithumb
|
||||
|
||||
빗썸 KRW 마켓 암호화폐 캔들 수집 및 **현물**·**선물** 매매 전략 파이프라인.
|
||||
빗썸 KRW 마켓 암호화폐 캔들 수집 및 **현물** 매매 전략 파이프라인.
|
||||
|
||||
- **기본 축:** 3분봉 현물 BTC, 최근 **10년** 캔들 (`DOWNLOAD_DAYS=3650`)
|
||||
- **데이터·문서 분류:** `common` (공유) · `spot` (현물) · `futures` (선물)
|
||||
- **데이터·문서 분류:** `common` (공유) · `spot` (현물)
|
||||
- **현재 운영 전략:** `fractal_swing` + MTF off — paper/live tick 운영 구현 완료
|
||||
|
||||
## 주요 기능
|
||||
|
||||
- 빗썸 Public API(v1) 분·일·주·월봉 캔들 수집 (11개 TF, 1분봉 포함)
|
||||
- SQLite 공유 DB (`data/common/coins.db`) — 현물·선물·MTF 공용
|
||||
- SQLite 공유 DB (`data/common/coins.db`) — 현물·MTF 공용
|
||||
- Ground Truth(GT) 벤치마크 → 39종 인과 기법 분석 → **실거래 운영(paper/live)**
|
||||
- 운영 tick: 캔들 증분 sync, 신호 tail 갱신, 슬리피지·일 체결 상한, 텔레그램 체결 알림
|
||||
|
||||
@@ -21,7 +21,7 @@
|
||||
## 설치
|
||||
|
||||
```bash
|
||||
cd DeepCoin
|
||||
cd Bithumb
|
||||
conda activate ncue # 또는 xavis
|
||||
pip install -r requirements.txt
|
||||
cp .env.example .env # API 키·텔레그램 등 로컬 설정
|
||||
@@ -56,7 +56,6 @@ OPS_DAILY_MAX_TRADES=100
|
||||
| **spot 1단계** | GT 타점 완벽 추종 sim 상한선 | GT 자체가 사후 | 불가 |
|
||||
| **spot 2단계** | 39종 인과 기법 평가·MTF 규칙 | 미사용 | 불가 |
|
||||
| **spot 3단계** | paper/live tick 운영 | 미사용 | **가능** |
|
||||
| **futures 0단계** | 현물 GT → 선물 롱·숏 마커 | — | — |
|
||||
|
||||
### 현물 3단계 운영 아키텍처 (fractal_swing)
|
||||
|
||||
@@ -93,8 +92,8 @@ flowchart TD
|
||||
## 폴더 구조
|
||||
|
||||
```text
|
||||
DeepCoin/
|
||||
├── src/deepcoin/
|
||||
Bithumb/
|
||||
├── src/bithumb/
|
||||
│ ├── api/ # 빗썸 Public·Private REST
|
||||
│ ├── data/ # 캔들 수집·DB·로더
|
||||
│ ├── ground_truth/ # GT 타점·sim·차트
|
||||
@@ -112,16 +111,14 @@ DeepCoin/
|
||||
│ │ ├── techniques/ # 2단계 기법 결과 (fractal_swing.json 등)
|
||||
│ │ ├── mtf/ # mtf_rules_v3.json
|
||||
│ │ └── operations/ # fractal_ops_state.json
|
||||
│ └── futures/ground_truth/ # 선물 GT JSON
|
||||
│
|
||||
└── docs/
|
||||
├── live/ # 운영 백테스트 매매 차트 (index.html)
|
||||
├── spot/
|
||||
│ ├── 0_ground_truth/ # GT 차트 HTML
|
||||
│ ├── 1_simulation/ # 1단계 sim 차트
|
||||
│ ├── 2_analysis/ # 2단계 리포트·설계 가이드
|
||||
│ └── 3_operations/ # 운영·백테스트 JSON 리포트
|
||||
└── futures/0_ground_truth/ # 선물 GT 차트
|
||||
└── spot/
|
||||
├── 0_ground_truth/ # GT 차트 HTML
|
||||
├── 1_simulation/ # 1단계 sim 차트
|
||||
├── 2_analysis/ # 2단계 리포트·설계 가이드
|
||||
└── 3_operations/ # 운영·백테스트 JSON 리포트
|
||||
```
|
||||
|
||||
테이블명: `{SYMBOL}_{인터벌분}` (예: `BTC_3`, `BTC_1440`). 인터벌: 분봉=분 숫자, 일=`1440`, 주=`10080`, 월=`43200`.
|
||||
@@ -136,7 +133,6 @@ flowchart LR
|
||||
B --> C[1_ground_truth_sim]
|
||||
C --> D[2_run_stage2_all]
|
||||
D --> E[3_run_operations]
|
||||
B --> F[0_ground_truth_futures]
|
||||
```
|
||||
|
||||
| 순서 | 단계 | 스크립트 | 산출물 |
|
||||
@@ -146,7 +142,6 @@ flowchart LR
|
||||
| 2 | spot 1단계 | `1_ground_truth_sim.py` | `docs/spot/1_simulation/` |
|
||||
| 3 | spot 2단계 | `2_run_*.py`, `2_run_stage2_all.sh` | `data/spot/techniques/`, `docs/spot/2_analysis/` |
|
||||
| 4 | spot 3단계 | `3_run_*.py`, `3_run_fractal_ops.sh` | `data/spot/operations/`, `docs/spot/3_operations/` |
|
||||
| — | futures 0단계 | `0_ground_truth_futures.py` | `data/futures/ground_truth/`, `docs/futures/0_ground_truth/` |
|
||||
|
||||
### 권장 명령
|
||||
|
||||
@@ -163,9 +158,6 @@ python scripts/0_ground_truth.py --interval 3 --days 3650 --tier all
|
||||
python scripts/1_ground_truth_sim.py --tier all
|
||||
bash scripts/2_run_stage2_all.sh
|
||||
|
||||
# futures 0단계
|
||||
python scripts/0_ground_truth_futures.py --tier all
|
||||
|
||||
# spot 3단계 — fractal_swing 운영
|
||||
python scripts/3_run_filtered_backtest.py # 운영 조건 3년 sim 검증
|
||||
python scripts/3_render_live_chart.py # docs/live 매매 차트
|
||||
@@ -274,12 +266,6 @@ OPS_TREND_GATE_ENABLED=true
|
||||
OPS_DAILY_MAX_TRADES=20
|
||||
```
|
||||
|
||||
### futures 0단계 — 선물 GT
|
||||
|
||||
현물 GT buy/sell → 롱·숏 4색 마커 (L↑/L↓/S↑/S↓).
|
||||
산출: `data/futures/ground_truth/`, `docs/futures/0_ground_truth/`
|
||||
선물 1~3단계는 예정.
|
||||
|
||||
---
|
||||
|
||||
## 환경 변수
|
||||
@@ -359,7 +345,7 @@ OPS_DAILY_MAX_TRADES=20
|
||||
|
||||
## 현물 2단계 인과 기법 (39종)
|
||||
|
||||
`src/deepcoin/techniques/` — 단일 33 + 복합 6, 미래 데이터 미사용.
|
||||
`src/bithumb/techniques/` — 단일 33 + 복합 6, 미래 데이터 미사용.
|
||||
|
||||
| ID | 기법 | 유형 |
|
||||
|----|------|------|
|
||||
@@ -412,18 +398,17 @@ OPS_DAILY_MAX_TRADES=20
|
||||
| common | 캔들 수집·증분 sync | 구현됨 |
|
||||
| spot | 0~2단계 (GT·기법·MTF) | 구현됨 |
|
||||
| spot | 3단계 (fractal paper/live·백테스트·텔레그램) | **구현됨** |
|
||||
| futures | 0단계 GT | 구현됨 |
|
||||
| futures | 1~3단계 | 예정 |
|
||||
|
||||
---
|
||||
|
||||
## 변경 이력
|
||||
|
||||
- 2026-06-13: 프로젝트명 **Bithumb**으로 변경, 선물(futures) 파이프라인 제거
|
||||
- 2026-06-13: 텔레그램 매수·매도 체결 알림 (`notifications/telegram.py`)
|
||||
- 2026-06-13: `docs/live/` 운영 백테스트 매매 차트 (`3_render_live_chart.py`)
|
||||
- 2026-06-13: fractal_swing live 운영 — 슬리피지·일 체결 상한·전 TF 증분 sync·신호 tail 갱신
|
||||
- 2026-06-13: 운영 백테스트 **+1,873,140%** (3년, 슬리피지 0.05%, 일 100회) 검증
|
||||
- 2026-06-12: `data/`·`docs/` common/spot/futures 3유형 구조 재편
|
||||
- 2026-06-12: `data/`·`docs/` common/spot 구조 재편
|
||||
- 2026-06-12: 3단계 운영 파이프라인 초기 구현 (composite_v3 + MTF paper/live)
|
||||
- 2026-06-12: 2단계 인과 기법 분석 파이프라인 완료
|
||||
- 2026-06-08: Ground Truth v1/v2/v3
|
||||
|
||||
Reference in New Issue
Block a user