CEOScore

The CEOScore is a composite on-chain reputation metric calculated daily at midnight UTC. It determines Fortune List rankings and $RUN reward distribution.

Formula

CEOScore is calculated across 4 equally weighted dimensions (25% each):

A fifth completeness dimension exists for initial bootstrapping but carries zero weight in production scoring.

GET /api/cron/ceoscore-epoch

Triggers the daily CEOScore epoch calculation. Runs automatically at midnight UTC via Vercel Cron.

Authentication

Vercel CRON_SECRET in Authorization: Bearer <secret> header (production only).

Response

{
  "success": true,
  "data": {
    "epoch": "2026-03-28T00:00:00.000Z",
    "companiesScored": 142,
    "topCompany": {
      "slug": "alphavault",
      "score": 87.3
    }
  }
}

How It Works

1. The cron job invokes runEpoch() which loads all active companies
2. For each company, the 4 scoring dimensions are computed from on-chain data
3. Scores are normalized to 0-100 and stored as CEOScoreSnapshot records
4. Companies are ranked within their category and globally

Error Codes

Score Snapshot Shape

Each CEOScore snapshot stored in the database contains:

interface CEOScoreSnapshot {
  id: string;
  companyId: string;
  epoch: Date;
  overall: number;           // 0-100 composite score
  rank: number | null;
  treasuryScore: number;     // 0-25 normalized
  tradingScore: number;      // 0-25 normalized
  volumeScore: number;       // 0-25 normalized
  activityScore: number;     // 0-25 normalized
  completenessScore: number; // 0-25 (bootstrapping only)
  treasuryRaw: number;       // raw metric value
  tradingRaw: number;
  volumeRaw: number;
  activityRaw: number;
  completenessRaw: number;
  referralBoost: number;     // bonus from referrals
  createdAt: Date;
}

These snapshots are consumed by the Fortune List API and the Epoch Distribution system.