6d2a706a48
왜: 체결이 없어도 마지막가는 유지인데, TTL로 None 만들고 매도/EOD를 건너뛰어 8/5 돌파·금요일 leftover가 남음. 호가필터 TTL 구멍과 같은 병. 넣을 파일 신규: kis_trader/engine/live_sell_price.py kis_trader/strategies/base.py (_ws_last_quote, _resolve_sell_price) 전략: momentum.py scalping.py tail_catch.py breakout.py range_break.py dart_strategy.py updow_strategy.py updown_feed.py us_momentum.py WS: ws_manager.py kis_ws.py kiwoom_ws.py ls_ws.py kis_ws_overseas.py kis_trader/web/live_config_schema.py (WS_PRICE_MAX_AGE_SEC 기본 0) database.py (키 주석 + legacy/ sys.path) kis_trader/execution/order_manager.py (잔고 있는데 40240000 ghost_purge 금지 — 같은 EOD 사고) EOD가 min_hold에 안 막히게 손본 momentum_hts_logic.py / scalping_engine.py / tail_engine.py (이 대화에서 손본 부분만 확인 후) 문서: docs/like_mcp.md/db_erd.md code_architecture.md (가격 TTL 문구) 메시지 초안 fix: 매수·매도 현재가를 TTL로 버리지 않음 (마지막 RAM) 횡보·체결 공백을 죽은 캐시로 오인해 None 처리하면 손절·EOD가 스킵된다. 호가필터와 같이 나이는 무시하고 마지막 체결가를 유지한다. EOD는 매수가 폴백. 영향: 실매 O / 백테·옵투나 봉 경로 거의 무관 (엔진 식 변경 아님) 커밋 2 — 루트 정리 (remove/ vs legacy/) 왜: 루트 단독봇·테스트는 지울 보관함으로. 웹·알람이 아직 쓰는 모듈은 remove에 두면 나중에 폴더째 삭제 때 깨짐. 넣을 파일 이동: 미사용 → remove/legacy_root/ (래퍼, ETF/키움 옛봇, 테스트, kiwoom_rest_api 등) 이동: 사용 중 → legacy/ (holding_bot kis_holding_ver1 news_analyzer kis_long_ver1/2) 신규: kis_trader/utils/legacy_root.py legacy/README.md remove/README.md import 경로: backtest_web.py mm_butler.py mm_remote.py updow_holding_cfg.py dbband_stock_cfg.py param_search_updow*.py dbband_param_search.py param_search_apply_snapshot.py verify_three_paths.py docs/like_mcp.md/code_architecture.md 수동 노트 메시지 초안 chore: 미사용 루트는 remove/, 웹·알람 구모듈은 legacy/ remove는 나중에 통째 삭제 예정. holding_bot·news_analyzer·kis_long은 ensure_legacy_root로 legacy/만 본다. 빼기: scratch/set_ws_price_max_age_zero.py (일회성)
60 lines
2.3 KiB
Markdown
60 lines
2.3 KiB
Markdown
# kiwwom_trader
|
|
|
|
키움 REST API + 웹소켓 기반 스캘핑 봇. KIS `kis_scalping_ver2`와 **동일한 로직·구조**를 유지하며, 키움 증권 API로 전환한 버전입니다.
|
|
|
|
## 폴더 이전 후에도 동작하도록
|
|
|
|
- **프로젝트 루트**: `KIWOOM_TRADER_ROOT` 환경변수로 지정 가능. 미설정 시 이 폴더(`kiwwom_trader`) 기준.
|
|
- **kiwoom_rest_api**: 이 폴더의 **상위 디렉터리** 또는 **형제 디렉터리**에 두면 자동으로 import됩니다.
|
|
- 예: `/home/hoon/kiwwom_trader` + `/home/hoon/kiwoom_rest_api`
|
|
- **database, scalping_engine** (kis_bot): `KIS_BOT_PATH` 환경변수로 kis_bot 루트 지정.
|
|
- 예: `export KIS_BOT_PATH=/home/hoon/kis_bot`
|
|
- 미설정 시 상위의 `kis_bot` 폴더를 참조합니다.
|
|
|
|
## 실행
|
|
|
|
```bash
|
|
# kiwwom_trader 폴더에서
|
|
python run.py
|
|
```
|
|
|
|
이전 후 예시:
|
|
|
|
```bash
|
|
export KIWOOM_TRADER_ROOT=/home/hoon/kiwwom_trader
|
|
export KIS_BOT_PATH=/home/hoon/kis_bot
|
|
cd /home/hoon/kiwwom_trader
|
|
python run.py
|
|
```
|
|
|
|
## 구성
|
|
|
|
| 파일 | 역할 |
|
|
|------|------|
|
|
| `config.py` | ROOT·경로 독립, sys.path 설정, .env 로드 |
|
|
| `run.py` | 진입점 |
|
|
| `scalping_bot.py` | 키움 REST(주문/조회) + 매수신호(scalping_engine) 메인 루프 |
|
|
| `ws_candle_agg.py` | 웹소켓 실시간 체결(0B) → 1분봉 집계 (필요 시 봇에서 연결) |
|
|
|
|
## 웹소켓
|
|
|
|
키움 웹소켓 실시간 타입 **0B(주식체결)** 를 구독하면 1분봉을 메모리/DB에 쌓을 수 있습니다.
|
|
`ws_candle_agg.py`의 `KiwoomCandleAggregator`와 `build_ws_client_with_candle_callback`를 사용해,
|
|
봇 초기화 시 웹소켓 클라이언트를 띄우고 후보 종목 리스트로 등록하면 됩니다.
|
|
(현재 `run()` 루프는 REST 조회 + DB `ws_candles` 기준으로 동작합니다.)
|
|
|
|
## 의존성
|
|
|
|
- `pip install -r requirements.txt` (httpx 등 kiwoom_rest_api 의존성 포함)
|
|
- `kiwoom_rest_api` 패키지는 이 저장소의 `kiwoom_rest_api` 폴더를 상위/형제 경로에 두거나, `PYTHONPATH`에 추가해야 합니다.
|
|
|
|
## 인증
|
|
|
|
`kiwoom_rest_api/.env` 또는 이 폴더의 `.env`에 다음을 설정합니다.
|
|
|
|
- `KIWOOM_API_KEY`
|
|
- `KIWOOM_API_SECRET`
|
|
- `KIWOOM_USE_SANDBOX` (true/false)
|
|
|
|
DB(MariaDB) 접속은 kis_bot과 동일하게 `DB_HOST`, `DB_USER`, `DB_PASS`, `DB_NAME` 등 환경변수를 사용합니다.
|