Project Stages — Internal Documentation

Module: vartovii/modules/crypto/services/ Last Updated: 2026-01-06

---

Overview

Vartovii Crypto Module supports 3 project stages with adaptive scoring:

Stage	Detection	Scoring	Examples
live_token	CoinGecko has price	5-pillar	SOL, ARB, OP
tokenless	No token, has TVL	4-pillar	Base, zkSync
pre_launch	Testnet/Beta	4-pillar	Monad, MegaETH

---

Stage Detection Logic

File: stage_detector.py

from vartovii.modules.crypto.services.stage_detector import get_stage_detector

detector = get_stage_detector()
stage, info = detector.detect(
    coingecko_data={"current_price": 150, ...},
    defillama_data={"tvl": 5_000_000_000},
    slug="base"
)
# Returns: ("tokenless", {"method": "known_list", "signals": [...]})

Detection Priority:

1. Known lists — KNOWN_TOKENLESS, KNOWN_PRELAUNCH hardcoded sets
2. CoinGecko data — Has price + market_cap = live_token
3. DefiLlama data — Has TVL but no price = tokenless
4. Raises data — Has funding but no product = pre_launch

---

Scoring Formulas

live_token (5-pillar)

Treasury 25% + Dev 25% + Financials 20% + Tokenomics 15% + Community 15%

tokenless (4-pillar)

Treasury 30% + Dev 35% + Traction 20% + Community 15%

Traction Score — based on TVL and volume:

• TVL > $5B: +35 pts
• TVL > $1B: +25 pts
• Volume > $100M/day: +15 pts

pre_launch (4-pillar)

Team 35% + Funding 30% + Dev 20% + Community 15%

Team Score — from TeamAnalyzer:

• GitHub org analysis
• Contributor count
• Org followers

---

Database Schema

ALTER TABLE crypto_projects
ADD COLUMN project_stage VARCHAR(20) DEFAULT 'live_token';
-- Values: 'live_token', 'tokenless', 'pre_launch'

---

API Response Changes

The /api/crypto/project/{slug} endpoint now returns:

{
  "slug": "base",
  "project_stage": "tokenless",
  "trust_score": 72,
  "score_breakdown": {
    "treasury": 85,
    "dev_activity": 78,
    "traction": 65,
    "community": 60
  }
}

---

Files Modified

File	Change
stage_detector.py	NEW — Stage detection service
team_analyzer.py	NEW — GitHub team analysis
risk_engine.py	Updated — 3 scoring formulas
crypto_projects table	Added project_stage column