Crypto Module API Reference

Overview

The Crypto Intelligence module provides real-time Web3 project analysis with Trust Score calculation.

Base URL: /api/crypto

---

Endpoints

GET /search

Search for crypto projects.

Parameters:

Name	Type	Required	Description
q	string	Yes	Search query
limit	int	No	Max results (default: 10, max: 50)

Response:

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

---

GET /project/{slug}

Get detailed project data with Trust Score.

Response:

{
  "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}

Force refresh project data from external APIs.

Response:

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

---

GET /top

Get top projects by market cap.

Parameters:

Name	Type	Required	Description
limit	int	No	Max results (default: 20, max: 100)
category	string	No	Filter by category

---

GET /health

Health check endpoint.

Response:

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

---

Trust Score Algorithm

The 4-Pillar Trust Score (0-100) rates Web3 project risk:

Pillar	Weight	Factors
Treasury	30%	Market cap, TVL
Dev Activity	30%	Commits (30d), active devs
Financials	25%	MCap/FDV ratio (inflation risk)
Community	15%	Placeholder (future: TwitterScore)

Risk Levels

Score	Risk Level
75-100	LOW
55-74	MEDIUM
35-54	HIGH
0-34	CRITICAL

Blue-Chip Detection

Mature projects (MCap > $1B) with 0 commits receive neutral dev score (55) instead of penalty.

---

Data Sources

Source	Data	Cache
CoinGecko	Price, MCap, FDV, GitHub URL	24h
GitHub	Commits, contributors	24h
DefiLlama	TVL (planned)	6h

---

Last Updated: December 30, 2025