19. VS Code에서 Python으로 코인 알림 봇 만들기 — 텔레그램 실시간 가격 알림 완벽 가이드

저도 처음에는 테슬라나 비트코인 변동성을 잡겠다고 새벽 2시, 4시마다 알람을 맞춰두고 깨서 거래소 앱을 확인하곤 했습니다. 하루에 앱을 열어본 횟수만 50번이 넘었고, 수면 부족으로 일상생활까지 망가지기 일쑤였죠. 참다못해 파이썬으로 텔레그램 알림 봇을 만들어 '5% 급등락 시에만 사이렌 알림'을 걸어둔 뒤로는, 밤새 차트를 보며 낭비하던 6시간의 수면을 되찾았고 뇌동매매 대신 차분하고 냉정하게 대응할 수 있게 되었습니다

이 글에서는 업비트 공개 API로 코인 실시간 가격을 수집하고, 조건(급등·급락·목표가 도달)이 충족될 때 텔레그램으로 즉시 알림을 발송하는 봇을 — VS Code에서 처음부터 완성까지 단계별로 구축해 드리겠습니다.

코인 알림 봇이 필요한 이유 — 감시하는 사람에서 알림받는 사람으로

24시간 쉬지 않고 움직이는 암호화폐 시장에서 사람이 직접 가격을 모니터링하는 것은 사실상 불가능합니다. 주식은 장이 열리는 시간이 정해져 있지만, 코인은 새벽 3시에도 30%가 움직입니다.

알림 봇은 잠들지 않는 보조 모니터입니다. 사람 대신 24시간 가격을 감시하다가, 설정한 조건이 딱 맞아떨어지는 순간에만 스마트폰을 울립니다. 매일 거래소 앱을 열어 확인하던 습관에서 벗어나, 알림이 왔을 때만 화면을 보는 방식으로 전환할 수 있습니다.

이 봇으로 할 수 있는 것

  • 목표가 도달 알림 — "비트코인이 1억 원을 돌파하면 알려줘"
  • 급등·급락 감지 — "5분 안에 3% 이상 변동이 생기면 알려줘"
  • 거래량 급증 감지 — "평소보다 거래량이 5배 이상 터지면 알려줘"
  • 정기 가격 리포트 — "매일 오전 9시에 주요 코인 가격 요약을 보내줘"

사전 준비 — 텔레그램 봇 생성하기

알림을 받을 텔레그램 봇을 먼저 만들어야 합니다. 코딩 없이 텔레그램 앱 안에서 5분이면 완료됩니다.

봇 생성 순서

  1. 텔레그램 앱에서 @BotFather 를 검색해 대화를 시작합니다.
  2. /newbot 을 입력합니다.
  3. 봇 이름을 입력합니다 (예: My Coin Alert Bot).
  4. 봇 유저네임을 입력합니다 — 반드시 bot으로 끝나야 합니다 (예: mycoin_alert_bot).
  5. 생성 완료 후 HTTP API 토큰을 복사해 저장합니다.


Chat ID 확인하기

봇이 메시지를 보낼 대상(본인 채팅방)의 ID를 확인해야 합니다.

  1. 방금 만든 봇을 검색해 /start 를 입력합니다.
  2. 브라우저에서 아래 URL에 접속합니다 (토큰 부분을 본인 것으로 교체).
https://api.telegram.org/bot8865271761:AAFr73XFgZNcqnAmfN7iZJbgxxxxxxx_9xx/getUpdates
  1. 결과 JSON에서 "chat": {"id": 123456789} 형태의 숫자를 복사합니다.

     4. 위처럼 아무것도 안나오는데 아래 t.me/MyCoinAlert260627_bot을 클릭해줍니다.
     5. 대화방이 열리는데 대화를 시작합니다. ex) hello~

     6. 리프레시 후 아래와 같이 내용이 바뀐것을 확인할수 있습니다.


환경 설정 — 라이브러리 설치 및 키 관리

pip install requests python-dotenv

프로젝트 폴더에 .env 파일을 만들고 아래 내용을 저장합니다.

TELEGRAM_TOKEN=your_bot_token_here
TELEGRAM_CHAT_ID=your_chat_id_here

.gitignore 에 .env 를 추가해 토큰이 외부에 노출되지 않도록 합니다.

# config.py — 환경 변수 로딩
from dotenv import load_dotenv
import os

load_dotenv()

TELEGRAM_TOKEN = os.getenv("TELEGRAM_TOKEN")
TELEGRAM_CHAT_ID = os.getenv("TELEGRAM_CHAT_ID")

STEP 1 — 텔레그램 메시지 발송 함수 만들기

import requests


def send_telegram(message: str) -> bool:
    url = f"https://api.telegram.org/bot{TELEGRAM_TOKEN}/sendMessage"
    payload = {
        "chat_id": TELEGRAM_CHAT_ID,
        "text": message,
        "parse_mode": "HTML",  # 굵게, 기울임 등 HTML 서식 사용 가능
    }

    try:
        response = requests.post(url, data=payload, timeout=10)
        response.raise_for_status()
        return True
    except Exception as e:
        print(f"텔레그램 발송 실패: {e}")
        return False

# 테스트 발송
send_telegram("✅ 코인 알림 봇이 정상 작동 중입니다.")

코드를 실행하면 텔레그램으로 메시지가 즉시 도착합니다. 이것만으로도 알림 기능의 절반은 완성된 것입니다.


STEP 2 — 업비트 API로 실시간 코인 가격 수집하기

업비트는 별도 API 키 없이 공개 REST API를 통해 실시간 시세를 무료로 제공합니다.

import requests

def get_upbit_price(ticker: str) -> dict:
    """
    ticker 예시: "KRW-BTC", "KRW-ETH", "KRW-XRP"
    """
    url = "https://api.upbit.com/v1/ticker"
    params = {"markets": ticker}
    headers = {"accept": "application/json"}

    try:
        response = requests.get(url, params=params, headers=headers, timeout=5)
        response.raise_for_status()
        data = response.json()[0]

        return {
            "ticker": ticker,
            "current": data["trade_price"],          # 현재가
            "open": data["opening_price"],            # 시가
            "high": data["high_price"],               # 고가
            "low": data["low_price"],                 # 저가
            "change_rate": data["signed_change_rate"] * 100,  # 전일 대비 등락률(%)
            "volume_24h": data["acc_trade_price_24h"],        # 24시간 거래대금
        }

    except Exception as e:
        print(f"가격 조회 실패 ({ticker}): {e}")
        return {}

# 테스트
btc = get_upbit_price("KRW-BTC")
print(f"비트코인 현재가: {btc['current']:,.0f}원 ({btc['change_rate']:+.2f}%)")



STEP 3 — 알림 조건 설정하기

목표가 도달 알림

def check_target_price(ticker: str, target: float, direction: str = "above") -> None:
    """
    direction: "above" = 목표가 이상, "below" = 목표가 이하
    """
    data = get_upbit_price(ticker)
    if not data:
        return

    current = data["current"]
    hit = current >= target if direction == "above" else current <= target

    if hit:
        emoji = "🚀" if direction == "above" else "📉"
        msg = (
            f"{emoji} <b>목표가 도달 알림</b>\n\n"
            f"종목: {ticker}\n"
            f"현재가: {current:,.0f}원\n"
            f"목표가: {target:,.0f}원\n"
            f"조건: {'이상' if direction == 'above' else '이하'} 도달"
        )
        send_telegram(msg)
        print(f"알림 발송: {ticker} {current:,.0f}원")

급등·급락 감지 알림

def check_sudden_change(ticker: str, threshold: float = 3.0) -> None:
    """
    threshold: 변동률 기준 (%) — 기본값 3%
    """
    data = get_upbit_price(ticker)
    if not data:
        return

    change = data["change_rate"]

    if abs(change) >= threshold:
        emoji = "🔴" if change < 0 else "🟢"
        direction = "급락" if change < 0 else "급등"
        msg = (
            f"{emoji} <b>{direction} 감지 알림</b>\n\n"
            f"종목: {ticker}\n"
            f"현재가: {data['current']:,.0f}원\n"
            f"전일 대비: {change:+.2f}%\n"
            f"24시간 거래대금: {data['volume_24h']/1e8:.1f}억원"
        )
        send_telegram(msg)

정기 가격 리포트 발송

from datetime import datetime

def send_price_report(tickers: list) -> None:
    now = datetime.now().strftime("%Y-%m-%d %H:%M")
    lines = [f"📊 <b>코인 가격 리포트</b>\n{now}\n"]

    for ticker in tickers:
        data = get_upbit_price(ticker)
        if data:
            name = ticker.replace("KRW-", "")
            emoji = "🔴" if data["change_rate"] < 0 else "🟢"
            lines.append(
                f"{emoji} <b>{name}</b>: {data['current']:,.0f}원 "
                f"({data['change_rate']:+.2f}%)"
            )

    send_telegram("\n".join(lines))

STEP 4 — 전체 봇 통합 + 스케줄러 연동

지금까지 만든 함수들을 하나로 묶고, 주기적으로 자동 실행되도록 연결합니다.

pip install schedule

import schedule
import time
from datetime import datetime

# 감시할 종목 및 조건 설정
WATCH_LIST = ["KRW-BTC", "KRW-ETH", "KRW-XRP", "KRW-SOL"]

TARGET_ALERTS = [
    {"ticker": "KRW-BTC", "target": 100_000_000, "direction": "above"},  # 비트코인 1억 돌파
    {"ticker": "KRW-ETH", "target": 4_000_000,   "direction": "above"},  # 이더리움 400만 돌파
]

SURGE_THRESHOLD = 5.0  # 5% 이상 변동 시 급등·급락 알림

def run_monitoring():
    print(f"[{datetime.now().strftime('%H:%M:%S')}] 모니터링 실행 중...")

    # 목표가 확인
    for alert in TARGET_ALERTS:
        check_target_price(alert["ticker"], alert["target"], alert["direction"])

    # 급등·급락 확인
    for ticker in WATCH_LIST:
        check_sudden_change(ticker, threshold=SURGE_THRESHOLD)

def run_daily_report():
    send_price_report(WATCH_LIST)

# 스케줄 설정
schedule.every(5).minutes.do(run_monitoring)          # 5분마다 조건 체크
schedule.every().day.at("09:00").do(run_daily_report) # 매일 오전 9시 리포트
schedule.every().day.at("22:00").do(run_daily_report) # 매일 오후 10시 리포트

# 시작 알림
send_telegram("🤖 코인 알림 봇이 시작되었습니다.\n5분마다 조건을 모니터링합니다.")
print("봇 시작. 종료하려면 Ctrl+C를 누르세요.")

while True:
    schedule.run_pending()
    time.sleep(30)



중복 알림 방지 — 같은 조건에서 반복 알림 차단하기

목표가가 달성된 뒤에도 계속 알림이 오는 문제를 방지합니다. 한 번 알림이 발송된 조건은 당일 안에 다시 발송되지 않도록 상태를 기록합니다.

from datetime import date

# 발송 기록 저장
sent_alerts = {}

def check_target_price_safe(ticker: str, target: float, direction: str = "above") -> None:
    alert_key = f"{ticker}_{target}_{direction}_{date.today()}"

    # 오늘 이미 발송한 알림이면 건너뜀
    if alert_key in sent_alerts:
        return

    data = get_upbit_price(ticker)
    if not data:
        return

    current = data["current"]
    hit = current >= target if direction == "above" else current <= target

    if hit:
        emoji = "🚀" if direction == "above" else "📉"
        msg = (
            f"{emoji} <b>목표가 도달 알림</b>\n\n"
            f"종목: {ticker}\n"
            f"현재가: {current:,.0f}원\n"
            f"목표가: {target:,.0f}원"
        )
        if send_telegram(msg):
            sent_alerts[alert_key] = True  # 발송 성공 시 기록

자주 발생하는 오류와 해결법

오류 1 — 텔레그램 메시지가 오지 않는 경우

원인: 토큰 또는 Chat ID 오류
해결: .env 파일의 값이 정확한지 재확인, 봇에게 /start 메시지를 먼저 보냈는지 확인

오류 2 — 업비트 API가 429 오류(Too Many Requests)를 반환하는 경우

원인: 분당 요청 횟수 초과 (업비트 공개 API는 분당 600회 제한)
해결: 모니터링 주기를 5분 이상으로 설정, 종목 수가 많다면 요청 사이에 time.sleep(0.1) 추가

오류 3 — 봇을 종료했다가 재시작하면 중복 알림이 다시 발송되는 경우

원인: sent_alerts 딕셔너리가 메모리에만 저장되어 재시작 시 초기화됨
해결: 발송 기록을 json 파일이나 sqlite3에 저장해 영속성 확보

import json, os

SENT_LOG = "sent_alerts.json"

def load_sent_alerts():
    if os.path.exists(SENT_LOG):
        with open(SENT_LOG, "r") as f:
            return json.load(f)
    return {}

def save_sent_alerts(data: dict):
    with open(SENT_LOG, "w") as f:
        json.dump(data, f)

마무리 — 핵심 요약

✅ 코인 알림 봇 구축 체크리스트

  1. 텔레그램 봇 생성 — BotFather에서 토큰 발급, Chat ID 확인
  2. 환경 변수 관리 — .env 파일에 토큰 저장, .gitignore 등록 필수
  3. 업비트 공개 API — API 키 없이 무료로 실시간 시세 수집 가능
  4. 알림 조건 3종 — 목표가 도달, 급등·급락 감지, 정기 리포트
  5. 스케줄러 연동 — schedule 라이브러리로 5분마다 자동 체크
  6. 중복 알림 방지 — 발송 기록을 파일로 저장해 재시작 후에도 유지

다음으로 알아두면 좋은 것

이 봇에 이전 시리즈에서 배운 Streamlit 대시보드를 연결하면, 텔레그램 알림과 웹 화면 모니터링을 동시에 운영할 수 있습니다. 또한 업비트 Open API(인증 필요)를 활용하면 가격 조회에서 더 나아가 자동 주문까지 구현할 수 있지만, 실제 자산이 걸린 자동매매는 충분한 테스트와 리스크 관리 전략을 반드시 먼저 수립하신 후 진행하시길 권장합니다.



댓글

댓글 쓰기

이 블로그의 인기 게시물

1.Python 설치부터 실행까지 10분 만에 끝내기 — 초보자도 바로 따라 하는 완벽 가이드

이미지
프로그래밍을 처음 시작하기로 결심한 날, 많은 분들이 유튜브를 켜고 이렇게 검색합니다. "파이썬 설치 방법." 영상을 따라가다 보면 어느 순간 화면 속 강사의 컴퓨터와 내 컴퓨터가 달라지기 시작합니다. "명령어를 찾을 수 없습니다", "PATH가 설정되지 않았습니다" 같은 오류 메시지가 등장하고, 결국 설치도 못 한 채 탭을 닫아버리게 됩니다. 이 글은 바로 그 지점을 해결하기 위해 쓰였습니다. 설치 과정에서 실제로 막히는 이유, 놓치기 쉬운 체크박스 한 칸의 의미, 그리고 첫 코드를 실행하는 순간까지 — 군더더기 없이 안내해 드리겠습니다. 저도 처음 설치때 1시간을 소비 했습니다.이제 해매지 마세요~!!  Python이 실제로 하는 일 — 번역가 비유로 이해하기 Python을 설치하기 전에, Python이 무엇인지 정확히 이해하면 이후 과정이 훨씬 자연스러워집니다. 컴퓨터는 본래 0과 1, 즉 기계어만 이해합니다. 사람이 "파일을 열어줘"라고 말해도 컴퓨터는 알아듣지 못합니다. Python은 바로 이 간극을 메우는 번역가 역할을 합니다. 우리가 사람에게 말하듯 작성한 코드를 컴퓨터가 이해할 수 있는 언어로 변환해 주는 것입니다. 여기서 핵심이 있습니다. 번역가가 없으면 대화가 불가능합니다. Python을 설치한다는 것은 곧 이 번역가를 내 컴퓨터에 고용하는 일입니다. 설치가 완료된 순간부터 여러분의 컴퓨터는 Python이라는 언어를 이해하기 시작합니다. Python을 선택해야 하는 이유 문법이 자연어에 가깝습니다 — if 날씨 == "맑음": 나가기() 처럼, 코드가 한국어 문장 구조와 유사합니다. 범용성이 압도적입니다 — 데이터 분석, 웹 개발, 자동화, AI 모델 구축까지 하나의 언어로 가능합니다. 생태계가 방대합니다 — 전 세계 개발자들이 만든 50만 개 이상의 라이브러리가 무료로 제공됩니다. 취업 시장에서 가장 수요가 높습니다 ...
자세한 내용 보기

30.Python pyautogui로 마우스와 키보드 자동화하기: VSCode 실전 가이드

이미지
 저도 처음에 PATH에서 막혔는데, 매일 반복되는 사내 시스템 클릭 작업을 자동화해보려고 pyautogui 를 설치했지만 VSCode에서 실행할 때마다 "No module named 'pyautogui'"라는 오류만 계속 나왔던 기억이 있습니다. 분명 터미널에서는 설치가 잘 됐다고 나왔는데, 알고 보니 VSCode가 바라보고 있던 Python 인터프리터 경로와 제가 패키지를 설치한 경로가 서로 달랐던 것이 원인이었습니다. 인터프리터를 올바르게 맞춰주고 나서야 마우스가 제 손을 대신해 화면을 클릭하고 키보드를 두드리는 신기한 광경을 볼 수 있었습니다. 이번 글에서는 그때의 시행착오를 바탕으로, VSCode 환경에서 Python pyautogui를 활용해 마우스와 키보드를 자동화하는 방법을 정리해보려 합니다. pyautogui란 무엇인가 마우스와 키보드를 코드로 제어하는 라이브러리 pyautogui 는 Python 코드로 마우스 움직임과 클릭, 키보드 입력을 프로그래밍적으로 제어할 수 있게 해주는 GUI 자동화 라이브러리입니다. 웹 브라우저나 애플리케이션 내부 요소를 직접 다루는 Selenium과 달리, pyautogui는 화면 좌표와 픽셀을 기준으로 동작하기 때문에 특정 프로그램에 국한되지 않고 컴퓨터 화면에서 벌어지는 거의 모든 작업을 자동화할 수 있습니다. 비유하자면 pyautogui는 마치 컴퓨터 앞에 보이지 않는 손 하나를 앉혀두는 것과 같습니다. 이 손은 사람이 시키는 대로 정확한 좌표를 클릭하고, 정해진 문장을 타이핑하며, 화면 속 특정 이미지를 찾아내기까지 하는데, 사람과 다른 점은 지치지 않고 똑같은 작업을 몇 번이고 정확하게 반복한다는 것입니다. pyautogui가 유용한 대표적인 상황 반복적인 클릭 작업이 많은 사내 시스템 업무 자동화 특정 시간마다 실행해야 하는 프로그램 작업 자동화 게임이나 소프트웨어 테스트 시 반복 입력 시뮬레이션 화면 캡처와 이미지 인식을 결합한 자동 작업 흐름 구성 매크로 프로그램을 대...
자세한 내용 보기

Python 오류 해결: pip install 오류 해결하기 완벽 가이드

이미지
  저도 처음에 PATH에서 막혔는데, Python을 새로 설치하고 필요한 패키지를 받으려고 pip install 을 입력했더니 "pip is not recognized as an internal or external command"라는 낯선 문구만 계속 나와서 당황했던 기억이 있습니다. 분명 설치 프로그램에서 "Next"만 눌렀을 뿐인데 왜 안 되는지 이해할 수 없어서 인터넷을 뒤지다가, 결국 문제는 Python 자체가 아니라 컴퓨터가 pip라는 명령어의 위치를 찾지 못하는 환경변수 문제라는 것을 알게 되었습니다. 이번 글에서는 그때 겪었던 경험을 바탕으로, VSCode에서 Python을 사용하다 마주치는 pip install 오류들을 유형별로 정리하고 해결하는 방법을 안내해보겠습니다. pip install 오류가 발생하는 이유 pip란 무엇인가 pip는 Python Package Index의 줄임말로, 다른 개발자들이 만들어놓은 라이브러리를 손쉽게 다운로드하고 설치할 수 있게 해주는 패키지 관리 도구입니다. Python을 설치하면 대부분 함께 설치되지만, 설치 과정이나 환경 설정에 따라 제대로 작동하지 않는 경우가 종종 발생합니다. 비유하자면 pip는 마치 동네 편의점 같은 존재입니다. 필요한 라이브러리(물건)를 코드 한 줄로 바로 주문하면 알아서 배달해주는데, 이 편의점으로 가는 길(환경변수)이 막혀 있거나 편의점 자체가 문을 닫아버리면 아무리 주문을 해도 물건을 받을 수 없는 상황이 벌어집니다. 자주 발생하는 오류 유형 pip 명령어 자체를 인식하지 못하는 경우 패키지 설치 권한이 부족한 경우 특정 패키지의 버전 호환성 문제 인터넷 연결이나 사내 네트워크 프록시 문제 여러 Python 버전이 충돌하는 경우 VSCode에서 pip 인식 오류 해결하기 pip 명령어를 찾지 못하는 경우 VSCode 터미널에 pip install 명령어를 입력했는데 "pip is not recognize...
자세한 내용 보기