Crypto Module Overview

The Crypto Intelligence module provides institutional-grade risk assessment for Web3 projects using a multi-source Trust Score algorithm.

🎯 What It Does

We answer the key question for Web3 investors: "Is this project real? Do they have money to survive? Are they actually shipping code?"

Capability	Description
Trust Score	0-100 rating based on 4 pillars
Real-time Data	3 APIs aggregated (CoinGecko, GitHub, DefiLlama)
Blue-chip Detection	Smart scoring for mature protocols
Risk Assessment	LOW / MEDIUM / HIGH / CRITICAL ratings

🏗️ Architecture

┌─────────────────────────────────────────────────────────┐
│                   CRYPTO MODULE                          │
│                                                          │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐     │
│  │  CoinGecko  │  │  GitHub     │  │  DefiLlama  │     │
│  │  Harvester  │  │  Harvester  │  │  Harvester  │     │
│  │  (24h cache)│  │  (24h cache)│  │  (6h cache) │     │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘     │
│         │                │                │             │
│         └────────────────┼────────────────┘             │
│                          ▼                              │
│               ┌─────────────────────┐                   │
│               │    Risk Engine      │                   │
│               │   (4-Pillar Score)  │                   │
│               └──────────┬──────────┘                   │
│                          ▼                              │
│               ┌─────────────────────┐                   │
│               │   PostgreSQL DB     │                   │
│               │  (crypto_projects)  │                   │
│               └─────────────────────┘                   │
└─────────────────────────────────────────────────────────┘

📊 Data Sources

API	Data Collected	Cache TTL	Cost
CoinGecko	Price, MCap, FDV, GitHub URL	24 hours	Free
GitHub	Commits (30d), Active devs, Last commit	24 hours	Free
DefiLlama	TVL, Chain distribution, Category	6 hours	Free

🔌 API Endpoints

Search Projects

GET /api/v2/crypto/search?q=bitcoin&limit=10

Response:

{
  "projects": [
    {
      "slug": "bitcoin",
      "name": "Bitcoin",
      "symbol": "BTC",
      "trust_score": 85,
      "risk_level": "LOW"
    }
  ]
}

Get Project Details

GET /api/v2/crypto/project/aave

Response:

{
  "name": "Aave",
  "symbol": "AAVE",
  "trust_score": 70,
  "risk_level": "MEDIUM",
  "price_usd": 245.50,
  "market_cap": 3650000000,
  "fdv": 4100000000,
  "tvl": 32400000000,
  "category": "Lending",
  "github_org": "aave",
  "commits_30d": 45,
  "active_devs": 12,
  "score_breakdown": {
    "treasury": 80,
    "dev_activity": 55,
    "financials": 80,
    "community": 65
  }
}

Refresh Data

POST /api/v2/crypto/refresh/aave

Rate limited to 1 request per 5 minutes per project.

Health Check

GET /api/v2/crypto/health

---

See Trust Score Algorithm for detailed scoring logic.