For builders

API reference

REST endpoints for DAO governance data. Bearer auth, rate-limited per plan.

Authentication

Generate an API key in Settings (Delegate Pro or Fund Suite plan required). Pass it as a bearer token in every request:

Authorization: Bearer gw_xxxxxxxxxxxxxxxxxxxxxxxx

Keys are prefixed gw_. Rotate any time in Settings. Lost keys cannot be recovered — only regenerated.

Rate limits

Free plan

0 /mo

API access requires premium.

Delegate Pro

1,000 /mo

$99/month.

Fund Suite

10,000 /mo

$399/month.

Burst limit: 5 requests per second per key. Every response includes x-ratelimit-remaining-month and x-ratelimit-remaining-burst headers.

Endpoints

GET/api/v1/daos

List all monitored DAOs with current Democracy Score and breakdown.

Request

curl https://daosentinel.xyz/api/v1/daos?limit=5 \
  -H "Authorization: Bearer gw_..."

Response

{
  "data": [
    {
      "slug": "uniswap",
      "name": "Uniswap",
      "chain": "ethereum",
      "governanceToken": "UNI",
      "democracyScore": "67.30",
      "scoreBreakdown": { ... },
      "treasuryUsd": "3100000000.00",
      "totalProposals": 234
    }
  ]
}

GET/api/v1/proposals

Proposals across all DAOs. Filter by state, DAO slug, paginate.

Request

curl "https://daosentinel.xyz/api/v1/proposals?state=active&dao=arbitrum&limit=10" \
  -H "Authorization: Bearer gw_..."

Response

{
  "data": [
    {
      "id": "uuid",
      "externalId": "0xabc...",
      "title": "Activate v4 hooks on Base mainnet",
      "state": "active",
      "endTimestamp": "2026-06-15T20:00:00Z",
      "votesCount": 847,
      "aiSummary": "This proposal activates...",
      "aiRiskLevel": "high",
      "hasWhaleVote": true,
      "daoSlug": "uniswap",
      "daoName": "Uniswap"
    }
  ]
}

GET/api/v1/alerts

Alert feed — whale votes, last-minute swings, score drops. Filter by type and severity.

Request

curl "https://daosentinel.xyz/api/v1/alerts?type=whale_vote&severity=critical&limit=20" \
  -H "Authorization: Bearer gw_..."

Response

{
  "data": [
    {
      "id": "uuid",
      "type": "whale_vote",
      "severity": "critical",
      "title": "🐳 Whale vote on Uniswap: 23.4% VP",
      "description": "0xabc...123 cast 2.1M UNI...",
      "data": { "voter": "0xabc...", "vp": 2100000, "vpPct": 23.4 },
      "createdAt": "2026-06-04T16:42:18Z",
      "daoSlug": "uniswap",
      "daoName": "Uniswap"
    }
  ]
}

Public endpoints (no auth)

GET/api/badge/[slug]

Returns an SVG Democracy Score badge. Embeds anywhere.

<img src="https://daosentinel.xyz/api/badge/uniswap" />

GET/api/alerts/stream

Server-Sent Events stream of new alerts in real time. Open from any client.

const es = new EventSource(
  'https://daosentinel.xyz/api/alerts/stream'
);
es.addEventListener('alert', (e) =>
  console.log(JSON.parse(e.data))
);

Ready to build?

See plans →Read the docs