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 6-Pillar Trust Score (0-100) rates Web3 project risk:

Pillar	Weight	Factors
Security	20%	CertiK audit score, scam alerts
Treasury	20%	Market cap, TVL
Dev Activity	20%	Commits (6m), active devs, team score
Financials	15%	MCap/FDV ratio (inflation risk)
Tokenomics	15%	Backer quality, unlock progress
Community	10%	TweetScout social score

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, Fundraising, Token unlocks	6h
Dropstab	CertiK scores, TweetScout, Vesting	24h
ICODrops	Vesting fallback	24h

---

Last Updated: February 4, 2026