Довідник API криптомодуля

Огляд

Модуль Crypto Intelligence забезпечує аналіз Web3-проєктів у реальному часі з розрахунком Trust Score.

Базова URL-адреса: /api/crypto

---

Кінцеві точки

GET /search

Пошук криптопроєктів.

Параметри: | Назва | Тип | Обов'язковий | Опис | |------|------|----------|-------------| | q | string | Так | Пошуковий запит | | limit | int | Ні | Максимальна кількість результатів (за замовчуванням: 10, максимум: 50) |

Відповідь:

{
  "source": "coingecko",
  "results": [
    {
      "slug": "bitcoin",
      "name": "Bitcoin",
      "symbol": "BTC",
      "market_cap_rank": 1,
      "thumb": "https://..."
    }
  ]
}

---

GET /project/{slug}

Отримати детальні дані проєкту з Trust Score.

Відповідь:

{
  "source": "database",
  "project": {
    "slug": "bitcoin",
    "name": "Bitcoin",
    "symbol": "BTC",
    "price_usd": 88153,
    "market_cap": 1760396827937,
    "fdv": 1850000000000,
    "trust_score": 81,
    "risk_level": "low",
    "score_breakdown": {
      "treasury": 90,
      "dev_activity": 65,
      "financials": 85,
      "community": 65
    },
    "commits_last_30d": 45,
    "active_devs": 12,
    "github_org": "bitcoin"
  }
}

---

POST /refresh/{slug}

Примусово оновити дані проєкту із зовнішніх API.

Відповідь:

{
  "status": "refreshed",
  "project": { ... }
}

---

GET /top

Отримати найкращі проєкти за ринковою капіталізацією.

Параметри: | Назва | Тип | Обов'язковий | Опис | |------|------|----------|-------------| | limit | int | Ні | Максимальна кількість результатів (за замовчуванням: 20, максимум: 100) | | category | string | Ні | Фільтрувати за категорією |

---

GET /health

Кінцева точка перевірки стану.

Відповідь:

{
  "status": "healthy",
  "module": "crypto",
  "cached_projects": 5
}

---

Алгоритм Trust Score

Trust Score за 6 стовпами (0-100) оцінює ризики Web3-проєктів:

Стовп	Вага	Фактори
Безпека	20%	Оцінка аудиту CertiK, попередження про шахрайство
Казначейство	20%	Market cap, TVL
Активність розробки	20%	Комміти (6 міс.), активні розробники, оцінка команди
Фінанси	15%	Співвідношення MCap/FDV (інфляційний ризик)
Токеноміка	15%	Якість спонсорів, прогрес розблокування
Спільнота	10%	Соціальний показник TweetScout

Рівні ризику

Оцінка	Рівень ризику
75-100	НИЗЬКИЙ
55-74	СЕРЕДНІЙ
35-54	ВИСОКИЙ
0-34	КРИТИЧНИЙ

Виявлення Blue-Chip

Зрілі проєкти (MCap > 1 млрд доларів США) з 0 коммітів отримують нейтральний показник активності розробників (55) замість штрафу.

---

Джерела даних

Джерело	Дані	Кеш
CoinGecko	Ціна, MCap, FDV, URL-адреса GitHub	24h
GitHub	Комміти, контриб'ютори	24h
DefiLlama	TVL, Залучення коштів, Розблокування токенів	6h
Dropstab	Оцінки CertiK, TweetScout, Vesting	24h
ICODrops	Резервне vesting	24h

---

Останнє оновлення: 4 лютого 2026 р.