# Snapshot DAO Governance API

> DAO governance from Snapshot: spaces, proposals with live results, and votes by voting power

- Vendor: `snapshotdaogovernanceapi` · version 1.0 · category Blockchain · tags snapshot api, dao governance api, dao proposals api, dao votes api, web3 governance api, crypto voting api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/snapshotdaogovernanceapi
- This document: https://apiclay.com/docs/snapshotdaogovernanceapi.md
- OpenAPI 3.1: https://apiclay.com/api/snapshotdaogovernanceapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `snapshotdaogovernanceapi`
- Updated: 2026-11-18

## About

## Snapshot DAO Governance API

Read DAO governance from Snapshot, the off-chain voting hub used by Uniswap, Aave, ENS, Arbitrum and thousands of other DAOs: a space's profile and admins, its proposals with choices, timing, state and live scores, and the votes on each proposal ranked by voting power.

Data comes from **snapshot.org** (https://snapshot.box). Every route calls the source's own public JSON endpoint (found with the live-URL scan of https://snapshot.box) and returns it unchanged.

Typical flow: `/space` with a space id (its ENS name, e.g. `uniswapgovernance.eth`), `/proposals` for that space, then `/proposal` and `/votes` with a proposal `id`.

### Routes

Every route is a POST with a JSON body `{"variables": {...}}`; the GraphQL query is fixed.

#### POST `/space` - Space profile
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| variables.id | body | string | yes | Space id, e.g. `uniswapgovernance.eth`. |

Returns: `data.space` (`name`, `about`, `network`, `symbol`, `members`, `admins`, `followersCount`, `proposalsCount`, `strategies`).

#### POST `/proposals` - Proposals of a space
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| variables.space | body | string | yes | Space id. |
| variables.state | body | string | no | `active`, `pending` or `closed`. |
| variables.first | body | number | no | Up to 1000. |
| variables.skip | body | number | no | Offset. |

Returns: `data.proposals[]` (`id`, `title`, `choices`, `start`, `end`, `state`, `author`, `scores`, `scores_total`, `votes`), newest first.

#### POST `/proposal` - Proposal
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| variables.id | body | string | yes | Proposal `id` from `/proposals`. |

Returns: `data.proposal` with `body` (markdown), `quorum`, `type`, `discussion`, live `scores`.

#### POST `/votes` - Votes on a proposal
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| variables.proposal | body | string | yes | Proposal `id`. |
| variables.first | body | number | no | Up to 1000. |
| variables.skip | body | number | no | Offset. |

Returns: `data.votes[]` (`voter` address, `vp` voting power, `choice`, `created`, `reason`), largest voting power first.

### Caveats

- Snapshot votes are off-chain signatures; on-chain execution is separate.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by snapshot.org.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### POST /space — Space
- Gateway: `POST https://api.apiclay.com/v1/api/snapshotdaogovernanceapi/space`
- Body sample (JSON):

```json
{"variables": {"id": "uniswapgovernance.eth"}}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /proposals — Proposals
- Gateway: `POST https://api.apiclay.com/v1/api/snapshotdaogovernanceapi/proposals`
- Body sample (JSON):

```json
{"variables": {"space": "uniswapgovernance.eth", "first": 5, "skip": 0}}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /proposal — Proposal
- Gateway: `POST https://api.apiclay.com/v1/api/snapshotdaogovernanceapi/proposal`
- Body sample (JSON):

```json
{"variables": {"id": "0x0000000000000000000000000000000000000000000000000000000000000000"}}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### POST /votes — Votes
- Gateway: `POST https://api.apiclay.com/v1/api/snapshotdaogovernanceapi/votes`
- Body sample (JSON):

```json
{"variables": {"proposal": "0x0000000000000000000000000000000000000000000000000000000000000000", "first": 10}}
```

- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X POST "https://api.apiclay.com/v1/api/snapshotdaogovernanceapi/space" \
  -H "token: <YOUR_APICLAY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"variables": {"id": "uniswapgovernance.eth"}}'
```

Index of every published API: https://apiclay.com/llms.txt
