Endpoint Reference

Complete reference for all ChainSights Governance Data API endpoints. All endpoints require an API key via the x-api-key header. See Authentication for details.

Overview

Method	Endpoint	Description	Tier
GET	`/v1/daos`	List all tracked DAOs	Free
GET	`/v1/daos/{space_id}`	DAO detail with scores	Pro
GET	`/v1/daos/{space_id}/risk`	Governance risk assessment	Pro
GET	`/v1/daos/{space_id}/delegates`	EVM delegate data	Free (limited) / Pro
GET	`/v1/daos/{space_id}/graph`	Influence graph	Coming Soon
GET	`/v1/dgi`	Current DGI value	Free
GET	`/v1/dgi/history`	Historical DGI data	Free
GET	`/v1/entities/{entity_id}`	Entity detail	Pro
GET	`/v1/entities?wallet=0x...`	Entity lookup by wallet	Pro

Response Format

All endpoints return a consistent envelope:

Success:

{
  "data": { ... },
  "meta": { ... }
}

Error:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description"
  }
}

GET /v1/daos

Free

List all tracked DAOs with their current Governance Vitality Score (GVS).

Use Cases: Research, portfolio monitoring, DAO tooling, governance dashboards.

Parameters

Parameter	Type	Required	Description
`category`	string	No	Filter by category: `defi`, `infrastructure`, `public_goods`, `social`

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-25T02:15:00.000Z"
    }
  ],
  "meta": {
    "total": 47,
    "updated_at": "2026-03-25T02:15:00.000Z"
  }
}

Response Fields

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

Error Codes

Status	Code	Description
401	`MISSING_API_KEY`	API key required
429	`RATE_LIMIT_EXCEEDED`	Daily limit exceeded

GET /v1/daos/

Pro

Detailed governance data for a specific DAO, including component labels, rankings, and 30-day score history.

Use Cases: Deep DAO analysis, governance reports, trend monitoring.

Parameters

Parameter	Type	Required	Description
`space_id`	path	Yes	Snapshot.org Space ID (e.g., `uniswap`, `aave.eth`)

Response

{
  "data": {
    "space_id": "uniswap",
    "name": "Uniswap",
    "category": "defi",
    "gvs": 7.52,
    "gvs_confidence": "high",
    "data_completeness": 95,
    "components": {
      "hpr": { "score": 9.8, "label": "Excellent" },
      "dei": { "score": 6.2, "label": "Moderate" },
      "pdi": { "score": 7.1, "label": "Strong" },
      "gpi": { "score": 6.9, "label": "Moderate" }
    },
    "rankings": {
      "overall": { "rank": 3, "total": 47 },
      "category": { "rank": 2, "category": "defi", "total": 18 }
    },
    "history": {
      "gvs_30d": [7.1, 7.2, 7.3, 7.5, 7.52],
      "interval": "daily"
    },
    "top_entities": [],
    "last_calculated": "2026-03-25T02:15:00.000Z"
  }
}

Response Fields

Field	Description
`space_id`	Snapshot.org Space ID
`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`
`data_completeness`	Data coverage percentage (0–100)
`components.{key}.score`	Component score (0–10) for hpr, dei, pdi, gpi
`components.{key}.label`	Human-readable label: Excellent, Strong, Moderate, Weak, Critical
`rankings.overall`	Overall GVS rank and total DAOs
`rankings.category`	Rank within DAO category
`history.gvs_30d`	Array of daily GVS values (last 30 days)
`history.interval`	Data interval (currently `daily`)
`top_entities`	Top participating entities (may be empty)
`last_calculated`	Last GVS calculation timestamp

Error Codes

Status	Code	Description
401	`MISSING_API_KEY`	API key required
403	`TIER_INSUFFICIENT`	Requires Pro tier
404	`NOT_FOUND`	DAO not found for given space_id
429	`RATE_LIMIT_EXCEEDED`	Daily limit exceeded

GET /v1/daos//risk

Pro

Computed governance risk assessment derived from GVS components.

Use Cases: Risk management, due diligence, treasury monitoring.

Parameters

Parameter	Type	Required	Description
`space_id`	path	Yes	Snapshot.org Space ID

Response

{
  "data": {
    "space_id": "uniswap",
    "risk_score": 25,
    "risk_level": "low",
    "factors": {
      "governance_capture_risk": "low",
      "whale_control_pct": 12.5,
      "active_voter_count": 847,
      "delegate_centralization": "medium",
      "proposal_velocity": "normal",
      "checkpoint_voting_pct": 8.3
    },
    "trend": "stable",
    "assessed_at": "2026-03-25T02:15:00.000Z"
  }
}

Response Fields

Field	Description
`risk_score`	Overall risk score (0–100, lower is better)
`risk_level`	`low`, `moderate`, `high`, or `critical`
`factors.governance_capture_risk`	Risk of governance capture
`factors.whale_control_pct`	Percentage of voting power held by top wallets
`factors.active_voter_count`	Number of active voters
`factors.delegate_centralization`	Delegation concentration level
`factors.proposal_velocity`	Rate of proposal activity
`factors.checkpoint_voting_pct`	Percentage of checkbox/batch voting
`trend`	`improving`, `stable`, or `declining`

Error Codes

Status	Code	Description
401	`MISSING_API_KEY`	API key required
403	`TIER_INSUFFICIENT`	Requires Pro tier
404	`NOT_FOUND`	DAO not found for given space_id
429	`RATE_LIMIT_EXCEEDED`	Daily limit exceeded

GET /v1/daos//delegates

Free (top 10) / Pro (up to 100 + historical)

Top delegates for Governor-based DAOs with weight-tier classification.

Use Cases: Delegate analysis, voting power distribution, governance research.

Parameters

Parameter	Type	Required	Description
`space_id`	path	Yes	Snapshot.org Space ID
`limit`	query	No	Number of delegates: `10`, `20`, `50`, `100` (Free max: 10)
`tier`	query	No	Filter by weight tier: `T1`, `T2`, `T3`
`date`	query	No	Historical snapshot date `YYYY-MM-DD` (Pro only)

Response

{
  "data": {
    "dao": "uniswap",
    "fetched_at": "2026-03-25T01:30:00.000Z",
    "total_delegates": 312,
    "delegates": [
      {
        "rank": 1,
        "address": "0x1234...abcd",
        "ens": "delegate.eth",
        "display_name": "delegate.eth",
        "votes_human": 2450000,
        "votes_share_pct": 15.2,
        "delegators_count": 1847,
        "weight_tier": "T1"
      }
    ],
    "summary": {
      "t1_voting_power_pct": 62.5,
      "t2_voting_power_pct": 28.3,
      "t3_voting_power_pct": 9.2,
      "t1_avg_delegators": 1200,
      "t2_avg_delegators": 340
    }
  }
}

Response Fields

Field	Description
`dao`	Snapshot.org Space ID
`fetched_at`	Timestamp of delegate data fetch
`total_delegates`	Total number of delegates for this DAO
`delegates[].rank`	Delegate rank by voting power
`delegates[].address`	Ethereum wallet address
`delegates[].ens`	ENS name (if available)
`delegates[].display_name`	Display name (ENS or truncated address)
`delegates[].votes_human`	Voting power in human-readable units
`delegates[].votes_share_pct`	Percentage of total voting power
`delegates[].delegators_count`	Number of delegators
`delegates[].weight_tier`	Weight tier: `T1`, `T2`, or `T3`
`summary.t1_voting_power_pct`	T1 aggregate voting power percentage
`summary.t2_voting_power_pct`	T2 aggregate voting power percentage
`summary.t3_voting_power_pct`	T3 aggregate voting power percentage

Weight Tiers

Tier	Description
T1	Whale delegates with significant voting power
T2	Mid-range delegates
T3	Smaller delegates

Error Codes

Status	Code	Description
401	`MISSING_API_KEY`	API key required
403	`TIER_INSUFFICIENT`	Requires Pro tier (for limit > 10 or date parameter)
429	`RATE_LIMIT_EXCEEDED`	Daily limit exceeded

GET /v1/daos//graph

Coming Soon

Returns the delegation and influence graph for a DAO, showing voting power flows between delegates.

This endpoint is part of Epic 26 (DAO Influence Graph) and is not yet available. Documentation will be updated when the endpoint launches.

GET /v1/dgi

Free

Current Decentralized Governance Index (DGI) — an aggregate governance health score across all tracked DAOs.

Use Cases: Market-wide governance monitoring, benchmarking, research reports.

Parameters

No parameters required.

Response

{
  "data": {
    "composite": 5.87,
    "components": {
      "hpr": 7.2,
      "dei": 4.8,
      "pdi": 5.6,
      "gpi": 5.9
    },
    "dao_count": 47,
    "calculated_at": "2026-03-25T02:15:00.000Z"
  }
}

Response Fields

Field	Description
`composite`	Overall DGI score (0–10)
`components.hpr`	Aggregate Human Participation Rate
`components.dei`	Aggregate Decentralization Index
`components.pdi`	Aggregate Proposal Deliberation Index
`components.gpi`	Aggregate Governance Process Index
`dao_count`	Number of DAOs included in calculation
`calculated_at`	Timestamp of last calculation

Error Codes

Status	Code	Description
401	`MISSING_API_KEY`	API key required
429	`RATE_LIMIT_EXCEEDED`	Daily limit exceeded

GET /v1/dgi/history

Free

Historical DGI values with component breakdown over time.

Use Cases: Governance trend analysis, reporting, time-series visualizations.

Parameters

Parameter	Type	Required	Description
`period`	query	No	Time period: `30d`, `90d`, `365d` (default: `30d`)

Response

{
  "data": {
    "period": "30d",
    "values": [
      {
        "date": "2026-02-24",
        "composite": 5.72,
        "components": {
          "hpr": 7.1,
          "dei": 4.6,
          "pdi": 5.4,
          "gpi": 5.8
        }
      }
    ]
  }
}

Response Fields

Field	Description
`period`	Requested time period (`30d`, `90d`, or `365d`)
`values[].date`	Date of the data point (YYYY-MM-DD)
`values[].composite`	Overall DGI score for that date
`values[].components.hpr`	Aggregate Human Participation Rate
`values[].components.dei`	Aggregate Decentralization Index
`values[].components.pdi`	Aggregate Proposal Deliberation Index
`values[].components.gpi`	Aggregate Governance Process Index

Error Codes

Status	Code	Description
401	`MISSING_API_KEY`	API key required
429	`RATE_LIMIT_EXCEEDED`	Daily limit exceeded

GET /v1/entities/

Pro

Entity data including associated wallets and DAO participations.

Use Cases: Entity research, wallet-to-entity mapping, cross-DAO analysis.

Parameters

Parameter	Type	Required	Description
`entity_id`	path	Yes	Entity identifier (e.g., `ent_abc123`)

Alternatively, look up by wallet address:

GET /v1/entities?wallet=0x...

Privacy: Returns 404 if the entity has opted out of the public API (publicApiOptOut = true).

Response

{
  "data": {
    "entity_id": "ent_abc123",
    "label": "a16z Crypto",
    "wallets": ["0xabc...", "0xdef..."],
    "dao_participations": []
  }
}

Response Fields

Field	Description
`entity_id`	Unique entity identifier
`label`	Entity display name (e.g., "a16z Crypto")
`wallets`	Array of associated Ethereum wallet addresses
`dao_participations`	Array of DAOs the entity participates in

Error Codes

Status	Code	Description
401	`MISSING_API_KEY`	API key required
403	`TIER_INSUFFICIENT`	Requires Pro tier
404	`NOT_FOUND`	Entity not found or opted out
429	`RATE_LIMIT_EXCEEDED`	Daily limit exceeded