CryptoSpikeBot 설치 및 사용법 가이드

vBot.py

0.04MB

CryptoSpikeBot은 바이낸스 선물 시장의 거래량 및 가격 급등을 실시간으로 감지하여 텔레그램을 통해 사용자에게 알림을 전송하는 파이썬 기반 봇입니다. 이 봇은 바이낸스 API(웹소켓 및 REST)를 활용하여 5분봉 데이터를 분석하고, 사용자가 설정한 기준(거래량 배율, 가격 변동률)에 따라 알림을 제공합니다. 주요 기능은 다음과 같습니다:

• 실시간 거래량 급등 감지: 직전 두 개 5분봉의 평균 거래량 대비 설정된 배율 이상일 때 알림.
• 실시간 가격 변동 감지: 직전 5분봉 종가 대비 설정된 변동률(%) 이상일 때 알림.
• 텔레그램 명령어 기반 설정: 사용자가 원하는 종목, 배율, 변동률, 쿨다운 시간을 설정 가능.
• 채널 멤버십 관리: 텔레그램 채널 가입 여부에 따라 사용자 접근 제어.
• 관리자 기능: 승인된 사용자 목록 조회 및 최대 사용자 수 제한.
• 쿨다운 설정: 알림 간 최소 시간 간격 설정으로 과도한 알림 방지.

이 봇은 관리자와 제한된 수의 사용자(기본값: 10명)를 지원하며, 사용자는 최대 5개의 종목을 구독할 수 있습니다. 기본적으로 BTCUSDT와 ETHUSDT에 대한 알림 설정이 제공됩니다.

사용법과 예시

CryptoSpikeBot은 텔레그램에서 명령어를 통해 설정 및 관리됩니다. 아래는 주요 명령어와 사용 예시입니다.

1. /start - 봇 시작 및 현재 설정 확인

• 설명: 봇을 시작하고 현재 설정된 거래량 및 가격 알림 목록을 확인합니다. 신규 사용자는 기본 설정(BTCUSDT, ETHUSDT)이 자동 적용됩니다.
• 예시:

  /start
  

• 응답 예시:

  🤖 *Crypto Spike Alert Bot* 🤖
  바이낸스 선물 급등락을 실시간 알람 봇
  
  🛰️ *현재 구독 설정*
  ─
  *거래량 알림:*
    - *BTCUSDT*: 3.6배 (15분)
    - *ETHUSDT*: 2.5배 (10분)
  ─
  *가격 변동 알림:*
    - *BTCUSDT*: 0.35% (15분)
    - *ETHUSDT*: 0.45% (10분)
  
  *🔥 거래량 알림 설정* - 직전 5분봉 2틱 평균 대비
  /volume [종목] [배율(x)] [쿨타임(분)]
  예: /volume BTCUSDT 4.5 15 | 삭제: /volume BTCUSDT 0
  
  *⚡️ 가격 변동 알림 설정* - 직전 5분봉 종가 대비
  /price [종목] [등락값(%)] [쿨타임(분)]
  예: /price ETHUSDT 0.35 10 | 삭제: /price ETHUSDT 0
  
  *쿨다운*: 알람 후 설정된 시간 동안 쿨다운 됩니다. (최소 5분)
  

2. /volume [종목] [배율] [쿨타임(분)] - 거래량 알림 설정

• 설명: 특정 종목의 거래량 급등 알림을 설정하거나 삭제합니다. 배율은 최소 1.1배, 쿨다운은 최소 5분입니다. 삭제하려면 배율을 0으로 설정합니다.
• 예시:

  /volume SOLUSDT 3.0 10
  

  • SOLUSDT의 거래량이 직전 두 개 5분봉 평균의 3배 이상일 때, 10분 쿨다운으로 알림.

  /volume SOLUSDT 0
  

  • SOLUSDT의 거래량 알림 삭제.
• 응답 예시:

  🛫 *SOLUSDT*가 3.0x 배율, 쿨다운 *10분*으로 설정되었습니다.
  

  또는

  🛬 *SOLUSDT* 거래량 알림이 삭제되었습니다.
  

3. /price [종목] [변동률(%)] [쿨타임(분)] - 가격 알림 설정

• 설명: 특정 종목의 가격 변동 알림을 설정하거나 삭제합니다. 변동률은 최소 0.1%, 쿨다운은 최소 5분입니다. 삭제하려면 변동률을 0으로 설정합니다.
• 예시:

  /price XRPUSDT 0.5 15
  

  • XRPUSDT의 가격이 직전 5분봉 종가 대비 ±0.5% 이상 변동 시, 15분 쿨다운으로 알림.

  /price XRPUSDT 0
  

  • XRPUSDT의 가격 알림 삭제.
• 응답 예시:

  🛫 *XRPUSDT* 가격 알림이 0.5% 임계값, 쿨다운 *15분*으로 설정되었습니다.
  

  또는

  🛬 *XRPUSDT* 가격 알림이 삭제되었습니다.
  

4. /users - 사용자 목록 조회 (관리자 전용)

• 설명: 관리자가 승인된 사용자 목록을 확인합니다. 최대 사용자 수와 현재 사용자 수를 표시합니다.
• 예시:

  /users
  

• 응답 예시:

  🐳 *모든 사용자 목록*
  (최대 사용자 수: *10*, 현재: *3*명)
  
  😄 *승인된 사용자 (채널 멤버)*:
  • `123456789`: John Doe (@JohnDoe) (관리자)
  • `987654321`: Jane Smith (@JaneSmith)
  • `456789123`: Bob Wilson (@BobWilson)
  

알림 메시지 예시

• 거래량 급등 알림:

  🔥 *BTCUSDT 거래량 급등!* 🔥
  현재 5분 거래량: 1.2M
  평균 거래량 (2개 봉): 300K
  감지된 급등: 4.00배
  가격 변동: 60,000.00 (+0.50%)
  알림 쿨타임: 15분
  

• 가격 변동 알림:

  🥑 *ETHUSDT 가격 변동!* 🥑
  현재 가격: 3,500.00
  가격 변동률: +0.75%
  이전 5분봉 종가: 3,474.00
  감지된 볼륨 (5분봉): 450K
  알림 쿨타임: 10분
  

설치법

CryptoSpikeBot을 설치하고 실행하려면 다음 단계를 따르세요.

1. 필수 요구사항

• Python 3.8 이상
• 필수 패키지:
  • python-telegram-bot==21.4
  • websocket-client==1.8.0
  • httpx==0.27.2
  • python-dotenv==1.0.1
• 운영 환경:
  • 텔레그램 봇 토큰 (Telegram BotFather에서 생성)
  • 바이낸스 선물 시장 API 접근 (웹소켓 및 REST)
  • 텔레그램 채널 (선택 사항, 멤버십 제한 사용 시)

2. 설치 단계

1. 저장소 클론 또는 코드 다운로드:
   • GitHub 저장소에서 코드를 클론하거나, 제공된 vBot.py 파일을 다운로드합니다.

   git clone <repository_url>
   cd <repository_directory>
   

2. 가상환경 설정:
3. python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate
4. 필수 패키지 설치:
5. pip install python-telegram-bot==21.4 websocket-client==1.8.0 httpx==0.27.2 python-dotenv==1.0.1
6. 환경 변수 설정:
   • 프로젝트 루트 디렉토리에 .env 파일을 생성합니다.
   • 다음 환경 변수를 추가합니다:

     TELEGRAM_BOT_TOKEN=your_bot_token_here
     TELEGRAM_ADMIN_ID=your_admin_telegram_id
     TELEGRAM_CHANNEL_USERNAME=@YourChannelUsername  # 선택 사항
     

   • TELEGRAM_BOT_TOKEN: Telegram BotFather에서 발급받은 토큰.
   • TELEGRAM_ADMIN_ID: 관리자의 텔레그램 사용자 ID.
   • TELEGRAM_CHANNEL_USERNAME: 사용자 제한을 위한 텔레그램 채널의 @username (선택).
7. 봇 실행:
8. python vBot.py

3. 추가 설정

• user_settings.json: 봇 실행 시 자동 생성되며, 사용자 설정이 저장됩니다. 수동으로 수정하지 마세요.
• 최대 사용자 수 및 종목 제한: vBot.py의 MAX_USERS (기본: 10)와 MAX_SYMBOLS_PER_USER (기본: 5)를 수정하여 조정 가능.
• 쿨다운 및 기본값: DEFAULT_COOLDOWN_MINUTES (기본: 15분), MIN_COOLDOWN_MINUTES (최소: 5분), MIN_VOLUME_MULTIPLIER (최소: 1.1배), MIN_PRICE_THRESHOLD (최소: 0.1%)를 필요에 따라 수정.

4. 문제 해결

• 봇이 응답하지 않음:
  • .env 파일의 토큰과 관리자 ID를 확인하세요.
  • 텔레그램에서 봇을 차단하지 않았는지 확인하세요.
• 웹소켓 연결 오류:
  • 인터넷 연결 상태를 확인하세요.
  • 바이낸스 API 상태를 확인하세요 (https://status.binance.com).
• 채널 멤버십 오류:
  • TELEGRAM_CHANNEL_USERNAME이 올바르게 설정되었는지 확인하세요.
  • 봇이 채널의 관리자 권한을 가지고 있는지 확인하세요.

CryptoSpikeBot은 바이낸스 선물 시장의 급등락을 실시간으로 모니터링하고 텔레그램으로 알림을 제공하는 강력한 도구입니다. 간단한 설치와 직관적인 명령어로 트레이더와 투자자에게 유용한 정보를 제공합니다. 설정을 커스터마이징하여 원하는 종목과 조건에 맞춘 알림을 받아보세요!

샘플 봇 https://t.me/CryptoSpikeAlert_Bot