Skip to content

Repository files navigation

프로젝트 개요

거래소의 캔들 데이터를 로컬 SQLite에 적재하고, 자체 구현한 7차 피벗 전략의 신호를 실시간으로 감지해 텔레그램으로 알림을 보내는 개인용 트레이딩 보조 도구입니다. 동시에 Lightweight-Charts 기반 웹 차트로 전략 진입/청산 지점과 월별 백테스트 결과를 시각적으로 검토할 수 있습니다.

구성

  • DB 적재 & 공용 모듈: scripts/hl_ingest_candles.py — Hyperliquid REST에서 캔들 받아 SQLite 테이블 생성/적재. 다른 스크립트들이 이 모듈의 INTERVAL_MS, candles_table, cmd_sync_recent, load_config를 공유함. make hl-db-backfill-all로 최초 1회 전체 백필.
  • 데이터 수집: scripts/hl_sync_recent_multi.py — REST API에서 1m/3m/5m/15m/30m 캔들을 받아 data/hl_market.db에 저장 (1분마다 실행)
  • 시그널 워처: scripts/hl_live_strat7_watch.py — DB를 읽어 7차 전략 조건을 평가하고 신규 신호 발생 시 텔레그램 메시지 전송
  • 백엔드 API: server.py — 차트가 사용할 캔들/시그널 데이터를 제공
  • 프론트엔드 차트: index.html — 30분봉 차트 위에 7차 전략 진입/청산 마커와 월별 PnL 리포트 표시
  • 전략 정의/스캐너: scripts/hl_strat7_signals.py, scripts/hl_strat7_param_scan.py — 전략 로직 본체와 파라미터 탐색 스크립트
  • 설정: scripts/hl_candles_config.json — 백필 대상 coin × interval 목록

7차 전략 요약

직전 N봉(피벗 K=10)을 기준으로 유사 가격대(±0.25%)에서 피벗을 잡고, 최대 35봉 이내에 다음 피벗이 형성되면 트레일링 SL 스위칭 방식으로 추세를 따라가는 단순 피벗 추세 전략. 진입은 종가, 손절은 직전 고저 근사, 왕복 수수료 약 0.090% 반영.

사용 흐름

  1. 최초 1회 make hl-db-backfill-all로 과거 데이터 적재
  2. 스케쥴링 등록 → 매 분마다 신규 캔들 수신 + 신호 발생 시 텔레그램 알림
  3. make dev로 웹 차트를 띄워 결과 검토

사전 요구사항

  • Python 3.10+, Node.js 18+ (pnpm)
  1. 설치
git clone https://github.com/fe-w/hl-viewer
cd hl-viewer

python3 -m venv .venv
./.venv/bin/pip install -r requirements.txt

corepack enable
pnpm install
  1. .env
TELEGRAM_BOT_TOKEN=
TELEGRAM_CHAT_ID=
  1. 데이터 축적 및 봇 신호 전송 스케쥴링 등록 (1m 기준)
* * * * * cd /Users/경로 && echo "--- $(date '+\%F \%T')" >> /Users/경로/logs/hl_sync.log && ./.venv/bin/python scripts/hl_sync_recent_multi.py --coins BTC --intervals 1m 3m 5m 15m 30m >> /Users/경로/logs/hl_sync.log 2>&1 && set -a && . ./.env && set +a && ./.venv/bin/python -m scripts.hl_live_strat7_watch --once --skip-fetch --intervals 1m 3m 5m 15m 30m >> /Users/경로/logs/hl_watch.log 2>&1

실행

make dev

http://127.0.0.1:5173/

실행 화면

Strategy Backtest Chart

About

HL Viewer with Strat7 strategy

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages