GET /v1/stats

{
  "version": "v2",
  "as_of_time": "2026-03-12T14:00:00Z",
  "data_semantics": "candidate_payment_activity_with_verified_subset",
  "erc8004": {
    "known_agents": 47200,
    "by_chain": {
      "base": 35000,
      "ethereum": 8000,
      "arbitrum": 2500,
      "optimism": 1200
    },
    "metadata_quality_distribution": {
      "real": 12000,
      "placeholder": 20000,
      "unknown": 15200
    }
  },
  "reputation": {
    "total_addresses": 55000,
    "scored_addresses": 52000,
    "entity_distribution": {
      "agent": 28000,
      "service": 12000,
      "wallet": 8000,
      "hybrid": 3000,
      "unknown": 1000
    },
    "score_distribution": {
      "A": 5200,
      "B": 12000,
      "C": 18000,
      "D": 10000,
      "F": 6800
    }
  },
  "payments": {
    "addresses_with_candidate_payment_activity": 37200,
    "addresses_with_verified_payment_activity": 1200,
    "total_candidate_transactions": 7300000,
    "total_verified_transactions": 45000,
    "verification_status_summary": {
      "candidate": 7255000,
      "verified": 45000
    }
  },
  "caveats": [
    "Transaction counts reflect candidate payment activity. Only transactions with definitive evidence are marked as verified.",
    "Scores are based on available on-chain and metadata evidence."
  ]
}