docs: update README/ARCHITECTURE with per-symbol strategy params
- Add per-symbol env var override examples to README strategy section - Add per-symbol env vars to environment variable reference table - Update ARCHITECTURE multi-symbol section with SymbolStrategyParams - Update CLAUDE.md configuration section - Update test counts to 138 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
38
README.md
38
README.md
@@ -110,6 +110,8 @@ Discord 웹훅을 설정했다면 진입/청산 시 실시간 알림을 받게
|
||||
|
||||
환경변수로 전략 파라미터를 조절할 수 있습니다. 기본값은 Walk-Forward 백테스트 스윕 결과에서 선정된 값입니다.
|
||||
|
||||
**전역 기본값** (심볼별 오버라이드 없을 때 적용):
|
||||
|
||||
| 환경변수 | 기본값 | 설명 |
|
||||
|---------|--------|------|
|
||||
| `ATR_SL_MULT` | `2.0` | 손절 ATR 배수 |
|
||||
@@ -118,6 +120,23 @@ Discord 웹훅을 설정했다면 진입/청산 시 실시간 알림을 받게
|
||||
| `ADX_THRESHOLD` | `25` | ADX 횡보장 필터 (0=비활성) |
|
||||
| `VOL_MULTIPLIER` | `2.5` | 거래량 급증 감지 배수 |
|
||||
|
||||
**심볼별 오버라이드**: `{환경변수}_{심볼}` 형태로 심볼마다 독립 설정 가능. 미설정 시 전역 기본값 사용.
|
||||
|
||||
```env
|
||||
# 예시: 2026-03-17 스윕 최적화 결과
|
||||
ATR_SL_MULT_XRPUSDT=1.5
|
||||
ATR_TP_MULT_XRPUSDT=4.0
|
||||
ADX_THRESHOLD_XRPUSDT=30
|
||||
|
||||
ATR_SL_MULT_TRXUSDT=1.0
|
||||
ATR_TP_MULT_TRXUSDT=4.0
|
||||
ADX_THRESHOLD_TRXUSDT=30
|
||||
|
||||
ATR_SL_MULT_DOGEUSDT=2.0
|
||||
ATR_TP_MULT_DOGEUSDT=2.0
|
||||
ADX_THRESHOLD_DOGEUSDT=30
|
||||
```
|
||||
|
||||
### ML 필터
|
||||
|
||||
ML 필터는 기술 지표 신호를 한 번 더 검증하여 오진입을 차단합니다. 기본적으로 **비활성화** 상태입니다.
|
||||
@@ -189,11 +208,16 @@ docker compose up -d
|
||||
| `MARGIN_DECAY_RATE` | `0.0006` | | 잔고 증가 시 감소 속도 |
|
||||
| `NO_ML_FILTER` | `true` | | ML 필터 비활성화 |
|
||||
| `ML_THRESHOLD` | `0.55` | | ML 예측 확률 임계값 |
|
||||
| `ATR_SL_MULT` | `2.0` | | 손절 ATR 배수 |
|
||||
| `ATR_TP_MULT` | `2.0` | | 익절 ATR 배수 |
|
||||
| `SIGNAL_THRESHOLD` | `3` | | 최소 가중치 점수 |
|
||||
| `ADX_THRESHOLD` | `25` | | ADX 횡보장 필터 (0=비활성) |
|
||||
| `VOL_MULTIPLIER` | `2.5` | | 거래량 급증 배수 |
|
||||
| `ATR_SL_MULT` | `2.0` | | 손절 ATR 배수 (전역 기본값) |
|
||||
| `ATR_TP_MULT` | `2.0` | | 익절 ATR 배수 (전역 기본값) |
|
||||
| `SIGNAL_THRESHOLD` | `3` | | 최소 가중치 점수 (전역 기본값) |
|
||||
| `ADX_THRESHOLD` | `25` | | ADX 횡보장 필터 (전역 기본값, 0=비활성) |
|
||||
| `VOL_MULTIPLIER` | `2.5` | | 거래량 급증 배수 (전역 기본값) |
|
||||
| `ATR_SL_MULT_{SYMBOL}` | — | | 심볼별 손절 ATR 배수 오버라이드 |
|
||||
| `ATR_TP_MULT_{SYMBOL}` | — | | 심볼별 익절 ATR 배수 오버라이드 |
|
||||
| `SIGNAL_THRESHOLD_{SYMBOL}` | — | | 심볼별 최소 가중치 점수 오버라이드 |
|
||||
| `ADX_THRESHOLD_{SYMBOL}` | — | | 심볼별 ADX 필터 오버라이드 |
|
||||
| `VOL_MULTIPLIER_{SYMBOL}` | — | | 심볼별 거래량 배수 오버라이드 |
|
||||
| `DASHBOARD_API_URL` | `http://10.1.10.24:8000` | | 대시보드 API 주소 (주간 리포트용) |
|
||||
| `BINANCE_TESTNET_API_KEY` | — | | Testnet API 키 |
|
||||
| `BINANCE_TESTNET_API_SECRET` | — | | Testnet API 시크릿 |
|
||||
@@ -246,7 +270,7 @@ cointrader/
|
||||
│ └── weekly/ # 주간 리포트 JSON 저장
|
||||
├── logs/ # 로그 파일
|
||||
├── docs/plans/ # 설계 문서 및 구현 플랜
|
||||
├── tests/ # 테스트 코드 (15파일, 136개 케이스)
|
||||
├── tests/ # 테스트 코드 (15파일, 138개 케이스)
|
||||
├── Dockerfile
|
||||
├── docker-compose.yml
|
||||
├── Jenkinsfile
|
||||
@@ -270,7 +294,7 @@ cp .env.example .env
|
||||
## 테스트
|
||||
|
||||
```bash
|
||||
# 전체 테스트 (136개)
|
||||
# 전체 테스트 (138개)
|
||||
bash scripts/run_tests.sh
|
||||
|
||||
# 특정 키워드 필터
|
||||
|
||||
Reference in New Issue
Block a user