OI-OI Bot 🤖

암호화폐 선물 시장의 미결제약정(Open Interest) 데이터를 모니터링하여 청산 위험을 텔레그램으로 알려주는 봇입니다.

주요 기능

• BTC 미결제약정(OI) 데이터 실시간 수집
• OI 급증률 및 시가총액 대비 비율 분석
• 위험도 점수 (0-100) 자동 계산
• 텔레그램 한글 알림
• 4시간 주기 자동 모니터링

빠른 시작

1. 설치

git clone https://github.com/early-developer-club/oi-oi-bot.git
cd oi-oi-bot
pip install -r requirements.txt

2. 텔레그램 봇 설정

1. @BotFather에서 /newbot으로 봇 생성
2. 봇 토큰 받기
3. 봇과 대화 시작 후 getUpdates에서 chat_id 확인

3. 환경 변수 설정

.env 파일 생성:

TELEGRAM_BOT_TOKEN=your_bot_token
TELEGRAM_CHAT_ID=your_chat_id
CHECK_INTERVAL_HOURS=4
ALERT_THRESHOLD_SCORE=70

4. 실행

# 즉시 리포트 전송 테스트
python send_report_now.py

# 메인 봇 실행 (4시간마다 자동)
python main.py

위험도 점수

점수	수준	설명
80-100	🔴 치명적	대규모 청산 위험
60-79	🟠 높음	상당한 청산 위험
40-59	🟡 보통	주의 필요
20-39	🟢 낮음	경미한 위험
0-19	⚪ 매우낮음	안정적

기술 스택

• Python 3.10+
• python-telegram-bot
• ccxt (Binance API)
• requests, schedule

라이선스

MIT License