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 днів, якщо всі доступи та ключі будуть надані вчасно.

Якщо потрібні додаткові уточнення або деталі, дайте знати!