این پروژه یک بات تلگرامی ساده است که به کاربر امکان میدهد برای قیمت ارزهای دیجیتال هشدار ثبت کند. اگر قیمت به سطح تعیینشده برسد، بات بهصورت خودکار هشدار را به کاربر ارسال میکند.
- اضافه کردن هشدار قیمت برای هر رمزارز دلخواه (BTCUSDT, ETHUSDT, ...)
- حذف هشدار
- نمایش لیست هشدارهای فعال
- ذخیره هشدارها به صورت دائمی در فایل JSON
- پشتیبانی از دو نوع هشدار:
- ⬆️ صعودی (اگر قیمت بالاتر از هدف شود)
- ⬇️ نزولی (اگر قیمت پایینتر از هدف شود)
- Python 3.10 یا بالاتر
- کتابخانههای زیر نصب باشند:
pip install python-telegram-bot requestsتوکن بات تلگرام خود را از BotFather دریافت کرده و در فایل main.py مقدار TELEGRAM_TOKEN را تنظیم کنید.
فایل را اجرا کنید:
python main.pyبه بات خود در تلگرام پیام بدهید تا Chat ID شما ثبت شود و سپس از دستورات زیر استفاده کنید.
| دستور | توضیح |
|---|---|
/start |
نمایش Chat ID |
/add SYMBOL PRICE D/U |
اضافه کردن هشدار. مثلا: /add BTCUSDT 60000 D |
/list |
نمایش لیست هشدارهای ثبتشده |
/delete ID |
حذف هشدار با شناسه مشخص. مثلا: /delete 1 |
- D برای زمانی است که بخواهید هشدار هنگام ریزش قیمت فعال شود.
- U برای زمانی است که بخواهید هشدار هنگام افزایش قیمت فعال شود.
فایل alerts.json ساختاری مانند زیر دارد:
{
"123456789": [
{
"ID": 1,
"symbol": "BTCUSDT",
"target": 60000,
"Goal": "D"
}
]
}
- هر Chat ID مجموعهای از هشدارهای خودش را دارد.
⏱ بررسی قیمتها ربات هر ۱۵ ثانیه یکبار قیمتها را از Binance API بررسی میکند. در صورت رسیدن به هدف، تنها یکبار هشدار برای هر مورد ارسال میشود.
📌 نکات تکمیلی
-
اگر فایل alerts.json وجود نداشته باشد، بهصورت خودکار ایجاد میشود.
-
اگر با ارور timezone در ویندوز روبرو شدید، فقط کتابخانه pytz را نصب کنید یا کد را بدون استفاده از apscheduler اجرا کنید (که اینجا نیازی نیست).
-
این پروژه فقط برای استفاده شخصی طراحی شده. اگر قصد استفاده عمومی دارید، باید سیستم احراز هویت و امنیت اضافه شود.
📬 ارتباط با من اگر سوالی داشتید خوشحال میشم کمک کنم 😄 📧 ایمیل: 1380.tadas@gmail.com Telegram: @Taha_t_80