📊 BTC Forecast Bot

Автоматический бот для технического анализа Bitcoin с AI прогнозом на неделю, месяц и год. Публикует прогнозы в Telegram канал.

🎯 Возможности

• ✅ Технический анализ BTC на трех таймфреймах (1h, 1d, 1w)
• ✅ Расчет индикаторов: RSI, MACD, EMA, Bollinger Bands
• ✅ Макроэкономический анализ: корреляция с S&P 500, ставка ФРС
• ✅ AI прогноз на неделю, месяц и год от GPT-4
• ✅ Автоматическая публикация в Telegram через GitHub Actions
• ✅ Вероятностный подход к прогнозированию

📋 Требования

• Python 3.11+
• Telegram Bot Token
• OpenAI API Key
• FRED API Key (опционально, для данных ФРС)

🚀 Быстрый старт

1. Клонируйте репозиторий

git clone https://github.com/ваш-username/btc-forecast-bot.git
cd btc-forecast-bot

2. Установите зависимости

pip install -r requirements.txt

3. Настройте переменные окружения

Скопируйте .env.example в .env:

cp .env.example .env

Заполните .env вашими API ключами:

TELEGRAM_BOT_TOKEN=your_bot_token_here
TELEGRAM_CHANNEL_ID=@your_channel
OPENAI_API_KEY=sk-your-openai-key
FRED_API_KEY=your_fred_key  # опционально

4. Запустите бота локально

python main.py

🔧 Настройка GitHub Actions

1. Получите необходимые API ключи

Telegram Bot Token

1. Найдите @BotFather в Telegram
2. Отправьте /newbot и следуйте инструкциям
3. Скопируйте токен

Telegram Channel ID

1. Создайте канал в Telegram
2. Добавьте вашего бота как администратора канала
3. ID канала в формате @channel_name или -100XXXXXXXXX

OpenAI API Key

1. Зайдите на platform.openai.com
2. Создайте API ключ в разделе API Keys

FRED API Key (опционально)

1. Зарегистрируйтесь на fred.stlouisfed.org
2. Создайте API ключ в Account Settings

2. Настройте Secrets в GitHub

1. Откройте Settings → Secrets and variables → Actions
2. Добавьте следующие secrets:
   • TELEGRAM_BOT_TOKEN
   • TELEGRAM_CHANNEL_ID
   • OPENAI_API_KEY
   • FRED_API_KEY (опционально)

3. Настройте расписание

По умолчанию бот запускается каждый понедельник в 12:00 UTC. Измените в .github/workflows/forecast.yml:

schedule:
  - cron: '0 12 * * 1'  # Понедельник 12:00 UTC

Примеры других расписаний:

• '0 9 * * *' - каждый день в 09:00 UTC
• '0 12 * * 1,3,5' - Пн, Ср, Пт в 12:00 UTC
• '0 */6 * * *' - каждые 6 часов

4. Запустите вручную

1. Откройте Actions → BTC Forecast Bot
2. Нажмите "Run workflow"

📊 Пример вывода

🚀 BTC ПРОГНОЗ 🚀

💰 Текущая цена: $45,234.56
📊 Тренд: восходящий
🎯 Поддержка: $44,000
🎯 Сопротивление: $46,500

📅 НЕДЕЛЬНЫЙ ПРОГНОЗ (1-7 дней):
Вероятность 65% консолидации в диапазоне $44,000-$46,500. 
Ключевой уровень сопротивления $46,500. При пробое возможен 
рост к $48,000.

📊 МЕСЯЧНЫЙ ПРОГНОЗ (30 дней):
Целевой диапазон $42,000-$50,000. Сильная корреляция с S&P 500 
(0.78) указывает на зависимость от макро. При сохранении 
позитива на фондовых рынках вероятен тест $50,000.

📈 ГОДОВОЙ ПРОГНОЗ (365 дней):
Бычий сценарий (55%): рост к $75,000-$85,000 при смягчении 
политики ФРС. Медвежий сценарий (45%): коррекция к $30,000-$35,000 
при ужесточении монетарной политики.

⚠️ РИСКИ:
- Повышение ставки ФРС может привести к резкой коррекции
- Усиление регуляторного давления в США

🤖 Автоматический анализ на основе TA + AI
⏰ Обновлено: 24.12.2024 12:00 UTC

🛠️ Архитектура

Технические индикаторы

Недельный прогноз (1h таймфрейм):

• RSI (14) - Индекс относительной силы
• MACD (12,26,9) - Схождение/расхождение скользящих средних
• EMA (20) - Экспоненциальная скользящая средняя
• Bollinger Bands - Полосы Боллинджера

Месячный прогноз (1d таймфрейм):

• EMA (50, 200) - Долгосрочные тренды
• Поддержка/сопротивление - Ключевые уровни
• Volume analysis - Анализ объемов

Годовой прогноз (1w таймфрейм):

• MA (200) - 200-недельная средняя
• Долгосрочные тренды

Макроэкономические данные

• S&P 500 - Корреляция с традиционными рынками
• Federal Funds Rate - Ставка ФРС (через FRED API)
• Корреляция BTC-SPX - Коэффициент корреляции за 30 дней

AI анализ

GPT-4 анализирует:

• Технические индикаторы на всех таймфреймах
• Макроэкономическую ситуацию
• Корреляции с традиционными рынками
• Генерирует вероятностный прогноз с указанием рисков

📁 Структура проекта

btc-forecast-bot/
├── main.py                 # Основной скрипт
├── requirements.txt        # Зависимости
├── .env.example           # Пример конфигурации
├── .gitignore             # Игнорируемые файлы
├── README.md              # Документация
└── .github/
    └── workflows/
        └── forecast.yml   # GitHub Actions workflow

🔍 Как это работает

1. Сбор данных: Получение OHLCV данных BTC с Binance через ccxt
2. Технический анализ: Расчет индикаторов с помощью pandas-ta
3. Макроданные: Получение S&P 500 (yfinance) и ставки ФРС (FRED API)
4. Корреляция: Расчет корреляции BTC-SPX за последние 30 дней
5. AI прогноз: GPT-4 анализирует все данные и генерирует прогноз
6. Публикация: Отправка в Telegram через python-telegram-bot

🔐 Безопасность

• ✅ Все API ключи хранятся в GitHub Secrets
• ✅ .env файл в .gitignore
• ✅ Используется .env.example для документации
• ✅ Логирование не содержит чувствительных данных

📈 Дальнейшее развитие (Roadmap)

Этап 2 (следующая неделя):

• Визуализация графиков с индикаторами
• Сохранение истории прогнозов для анализа точности
• Добавление альткоинов (ETH, SOL)

Этап 3 (через 2 недели):

• Веб-интерфейс для просмотра статистики
• Telegram команды для получения прогноза по запросу
• Алерты при достижении ключевых уровней

📝 Логирование

Бот логирует все основные операции:

• Получение данных с бирж
• Расчет индикаторов
• Генерация AI прогноза
• Публикация в Telegram
• Ошибки и исключения

Логи выводятся в консоль и доступны в GitHub Actions.

⚠️ Disclaimer

Этот бот создан в образовательных целях. Прогнозы не являются финансовым советом. Криптовалютные рынки высоко волатильны, и прошлые результаты не гарантируют будущую прибыль.

Всегда проводите собственное исследование (DYOR) перед принятием инвестиционных решений.

📞 Поддержка

Если у вас возникли проблемы:

1. Проверьте логи в GitHub Actions
2. Убедитесь, что все API ключи правильно настроены
3. Проверьте права бота в Telegram канале

📄 Лицензия

MIT License - используйте свободно, но на свой риск.

---

Создано с ❤️ для криптосообщества