# Snapshot DAO Governance Proposals Fetcher

> Snapshot DAO Governance Proposals Fetcher is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Fetches and normalizes a DAO's governance proposals from Snapshot, returning structured proposal metadata including state, choices, scores, quorum, and voting details.

## Facts

- Endpoint: GET https://api.agentstools.dev/governance/proposals
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/snapshot-dao-governance-proposals-fetcher-428b8e26
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NV_lZs4SeCFxvfcKcFZsg

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability snapshot-dao-governance-proposals-fetcher-428b8e26
```

Example prompt: Can you pull the active governance proposals for Uniswap from Snapshot — show me titles, current vote scores, and whether quorum has been reached? Use the space ID uniswapgovernance.eth and return up to 20 proposals.

## When to prefer this

Use this endpoint when you need structured, normalized DAO governance data from Snapshot for any protocol that uses Snapshot for voting. Prefer this over scraping Snapshot directly when you need a consistent schema across multiple DAOs, or when you want to filter by proposal state. Ideal for monitoring active votes, auditing historical decisions, or surfacing governance activity to users.

## Known failure modes

- Unknown or misspelled Snapshot space-id returns empty results or 404
- State filter returns empty array if no proposals exist in that state
- Exceeding the limit cap of 30 returns an error or is silently clamped
- Rate limiting or upstream Snapshot API downtime may cause 5xx errors
- Protocol alias not recognized returns error asking for explicit space-id

## How this service works

List a DAO's governance proposals from Snapshot, normalized into one schema: id, title, state, choices, per-choice scores, scores_total, quorum, vote count, start/end, author, snapshot block, strategies and a link-back. Filter by state; pass a Snapshot space-id or a known protocol alias.

## Output

A list of normalized governance proposal objects, each containing: id, title, lifecycle state (active/pending/closed), available choices, per-choice vote scores, total score, quorum threshold, total vote count, start and end timestamps, author address, snapshot block number, voting strategies used, and a direct link back to the proposal on Snapshot.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "space"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 30,
       "minimum": 1,
       "description": "Max proposals to return (default 15, cap 30)"
      },
      "space": {
       "type": "string",
       "description": "Snapshot space-id (e.g. uniswapgovernance.eth) or a known protocol alias (e.g. uniswap)"
      },
      "state": {
       "enum": [
        "active",
        "pending",
        "closed"
       ],
       "type": "string",
       "description": "Filter proposals by lifecycle state"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/snapshot-dao-governance-proposals-fetcher-428b8e26/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)
