Coinmarket API + Google Sheets + Lunarcrush API

Техническое задание (ТЗ) для мониторинга резкого роста криптовалют по объемам и engagement

Цель проекта

Создать таблицы для анализа и мониторинга данных по 50–100 криптовалютам с возможностью масштабирования до 250 валют в одном Google Sheet или добавления новых документов. Основная задача — фиксировать и анализировать резкий рост объемов торговли и engagement, используя средние значения за разные временные периоды.

Таблицы должны быть динамичными, выделять криптовалюты с резкими изменениями (например, рост на 50% за последние 3 часа) или поднимать их в верх таблицы.

Функциональные требования

1. Данные по объемам

   • Средние значения:
     • Средний дневной объем за последние 30 дней.
     • Средний дневной объем за последние 7 дней.
     • Средние значения за 3 дня, 2 дня и вчера.
   • Изменения:
     • Объем за последние 3 часа (почасовые данные).
     • Объем за последние 6 часов (агрегированные данные).
     • Объем за последние 12 часов (агрегированные данные).

2. Данные по engagement (LunarCrush)

   • Средние значения:
     • Средний дневной engagement за последние 30 дней.
     • Средний дневной engagement за последние 7 дней.
     • Средние значения за 3 дня, 2 дня и вчера.
   • Изменения:
     • Engagement за последние 3 часа, 6 часов, 12 часов.

3. Анализ и выделение

   • Формулы для анализа:
     • Процентное изменение за 3, 6, 12 часов относительно средних значений.
     • Если изменение >= 50%, строка автоматически выделяется или поднимается в верх таблицы.
   • Выделение данных:
     • Красный цвет для резкого падения.
     • Зеленый цвет для резкого роста.
   • Таблица должна быть удобной для мониторинга.

4. Масштабируемость

   • В одной таблице хранится информация о 50–100 криптовалютах.
   • Возможность:
     • Добавления новых строк для валют в пределах одной таблицы (до 250 строк).
     • Создания новых таблиц для других валют с помощью готового шаблона.

Технические требования

Python

1. Сбор данных:
   • API CoinMarketCap для объемов:
     • Метрики: объем торгов (volume_24h), рыночная капитализация (market_cap).
   • API LunarCrush для engagement:
     • Метрики: engagement, mentions, social_volume.
2. Обновление данных:
   • Почасовое обновление.
   • Сохранение данных в Google BigQuery.
3. Агрегация:
   • Скрипт для вычисления средних значений:
     • Средние за 30 дней, 7 дней, 3 дня, 2 дня и вчера.
     • Почасовые данные за последние 12 часов.

BigQuery

1. Таблицы:
   • LiveData:
     • Сохраняет данные за последние 7 дней (почасовые записи).
   • AggregatedData:
     • Сохраняет дневные агрегаты за 30 дней.
2. Запросы:
   • Вычисление средних значений за разные периоды.
   • Выборка данных для Google Sheets.

Google Sheets

1. Подключение:
   • Google Data Connector для вывода данных из BigQuery.
2. Формулы:
   • Процентное изменение:

     excel=IF(B2<>0, (C2-B2)/B2, 0)
     
     

     Где B2 — среднее значение за 30 дней, C2 — текущий объем за последние 3 часа.
   • Выделение изменений:
     • Условное форматирование для изменений >= 50%.
3. Шаблон:
   • Таблица с:
     • Почасовыми данными.
     • Средними значениями за 30, 7, 3, 2 дня и вчера.
     • Динамическим выделением строк.

Этапы реализации

1. Сбор данных (1 день):

   • Настройка Python-скрипта для сбора данных из API CoinMarketCap и LunarCrush.

2. Обновление данных в BigQuery (1–2 дня):

   • Создание таблиц LiveData и AggregatedData.
   • Настройка скрипта для загрузки данных в BigQuery.

3. Интеграция с Google Sheets (1 день):

   • Настройка Data Connector.
   • Создание первой таблицы на 50–100 валют.

4. Формулы и выделение (1 день):

   • Добавление формул для вычислений процентных изменений.
   • Настройка условного форматирования.

5. Масштабируемость (1 день):

   • Документация для добавления новых валют.
   • Шаблон для создания новых таблиц.

Критерии завершения

1. Таблица с данными по 50–100 криптовалют:
   • Обновление почасово.
   • Средние значения и почасовые изменения.
   • Выделение резких изменений (рост >= 50%).
2. Возможность добавления валют в текущую таблицу (до 250 строк).
3. Легкость создания новых таблиц.

Сроки выполнения

4–6 дней, если все доступы и ключи будут предоставлены вовремя.

Если нужны дополнительные уточнения или детали, дайте знать!