MEXC Pump/Dump Alert Bot

Бот для мониторинга резких изменений цен криптовалют на бирже MEXC с уведомлениями в Telegram.

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

• ⚡ Мониторинг всех торговых пар на MEXC в реальном времени
• 📊 Уведомления о резких изменениях цен (pump/dump)
• 💰 Точный расчет объема торгов за период изменения цены
• 🚫 Система блэклиста для предотвращения спама
• 🤖 Управление через Telegram команды
• 🎨 Красивые эмодзи-индикаторы для визуального отображения активности
• 🔄 Автоматический перезапуск при ошибках
• 🐳 Поддержка Docker

📋 Требования

• Go 1.21+ (для компиляции из исходников)
• Telegram Bot Token
• MEXC API доступ (публичные endpoints, не требует авторизации)

⚙️ Конфигурация

Создайте .env файл на основе .env.example:

# Telegram Bot Configuration
TELEGRAM_TOKEN=1234567890:ABCdefGHIjklMNOpqrsTUVwxyz  # Токен вашего бота
TELEGRAM_CHAT_ID=@your_channel                        # ID канала или чата
TELEGRAM_ALLOWED_USER_ID=123456789                    # Ваш Telegram User ID

# Monitoring Configuration
INTERVAL_SECONDS=60      # Интервал мониторинга (сек)
PRICE_CHANGE_PCT=10.0    # Минимальное изменение цены (%)
VOLUME_USD=50000         # Минимальный объем торгов (USD)

🛠️ Установка и запуск

Быстрый запуск

git clone <repository-url>
cd MexcPumpDumpAlert
cp .env.example .env
# Отредактируйте .env файл с вашими настройками
go build -o mexc-alert .
./mexc-alert

Docker

cp .env.example .env
# Настройте переменные в .env
docker-compose up -d

🤖 Telegram команды

Команда	Описание	Пример
/config	Показать текущую конфигурацию	/config
/setinterval <секунды>	Установить интервал мониторинга	/setinterval 30
/setpercent <процент>	Установить минимальный процент изменения	/setpercent 15.5
/setvolume <объем>	Установить минимальный объем в USD	/setvolume 100000
/blacklist <символ> <часы>	Добавить монету в чёрный список	/blacklist BTCUSDT 2.5
/listblacklist	Показать чёрный список	/listblacklist

📱 Формат уведомлений

BTCUSDT 🟢
15.25% 🔵🔵
75000 $ 👁️🔥

Расшифровка индикаторов:

• 🟢 - рост цены / 🔴 - падение цены
• 🔵 - кружки показывают силу движения (по одному за каждые 10%)
• Объем торгов в USD с индикаторами активности за период изменения цены:
  • 👁️ - объем от $10k до $50k за период
  • 🔥 - объем от $50k+ за период (количество огоньков зависит от объема)

🎯 Особенности расчета объема

Бот использует QuoteAssetVolume из MEXC API - это точный объем торгов в USD/USDT за каждую минуту периода изменения цены. Это гораздо точнее, чем приблизительные расчеты.

Формула: Volume USD = Σ(QuoteAssetVolume) за каждую минуту периода

Благодаря этому подходу:

• Объемы точно отражают реальные торги в USD
• Нет необходимости в дополнительных конвертациях
• Данные соответствуют тому, что видят трейдеры на бирже
• Лучше видно реальную активность во время pump/dump

🏗️ Архитектура проекта

MexcPumpDumpAlert/
├── main.go                    # Главная точка входа
├── internal/
│   ├── api/mexc.go          # MEXC API клиент
│   ├── monitor/monitor.go    # Логика мониторинга цен
│   ├── telegram/telegram.go # Telegram бот
│   ├── config/config.go     # Управление конфигурацией
│   └── blacklist/blacklist.go # Система чёрного списка
├── .env.example             # Шаблон конфигурации
├── docker-compose.yml       # Docker композиция
└── Dockerfile              # Docker образ

🔌 API Endpoints MEXC

Бот использует следующие публичные API endpoints MEXC:

• GET /api/v3/ticker/24hr - получение данных о всех тикерах
• GET /api/v3/klines - получение исторических данных с QuoteAssetVolume

🚀 Миграция с BitMart

Этот проект является адаптацией оригинального BitMart мониторинга под MEXC API. Основные улучшения:

1. ✅ Заменен API клиент с BitMart на MEXC
2. ✅ Точный расчет объемов через QuoteAssetVolume
3. ✅ Более реалистичные пороговые значения
4. ✅ Улучшенная обработка ошибок с fallback системой
5. ✅ Обновлена документация и примеры

📄 Лицензия

MIT License