Quickstart

Get started with the ChainSights API in under 5 minutes.

1. Get your API Key

Sign up and create an API key in your API Keys Dashboard. You'll receive a key starting with cs_live_.

Note: You'll need a ChainSights account. Sign in via Magic Link — no password required.

2. Send your first request

curl -H "x-api-key: cs_live_your_key_here" \
  https://chainsights.one/api/v1/daos

That's it. No SDK required, no OAuth flow — just a single header.

3. Understand the response

{
  "data": [
    {
      "space_id": "uniswap",
      "name": "Uniswap",
      "category": "defi",
      "gvs": 7.52,
      "gvs_confidence": "high",
      "rank": 3,
      "components": {
        "hpr": 9.8,
        "dei": 6.2,
        "pdi": 7.1,
        "gpi": 6.9
      },
      "delta_24h": 0.15,
      "last_calculated": "2026-03-25T12:00:00Z"
    }
  ],
  "meta": {
    "total": 47,
    "updated_at": "2026-03-25T12:00:00Z"
  }
}

Field	Description
space_id	Snapshot.org Space ID (unique identifier)
name	DAO display name
category	One of: defi, infrastructure, public_goods, social
gvs	Governance Vitality Score (0–10)
gvs_confidence	high (≥20 proposals) or low (fewer than 20)
rank	Overall GVS ranking position
components.hpr	Human Participation Rate
components.dei	Decentralization Index
components.pdi	Proposal Deliberation Index
components.gpi	Governance Process Index
delta_24h	Score change in last 24 hours
last_calculated	Last GVS calculation timestamp

Time-to-First-Call: Under 5 minutes. If you have your API key, you can make a request right now.

Next steps

• Authentication — Learn about rate limits and error handling
• Endpoint Reference — Full list of available endpoints
• Data Guide — Understand our metrics and methodology