# Snapshot Proposal Votes Lookup

> Snapshot Proposal Votes Lookup is a paid API for AI agents from api.agentstools.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-15).

Returns normalized, power-ranked votes on a Snapshot governance proposal, including voter address, resolved choice label, voting power, reason, and timestamp.

## Facts

- Endpoint: GET https://api.agentstools.dev/governance/votes
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/snapshot-proposal-votes-lookup-8d76074a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OVuvmBs-e76bZ29fo-ucZ

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-proposal-votes-lookup-8d76074a
```

Example prompt: Show me the top 20 votes on Snapshot proposal 0x3b24d54aa5c2e3cbb3d43b5fc29d53c5d5e4c8e7 — I want to see each voter's address, how they voted, their voting power, and any reason they gave.

## When to prefer this

Use this endpoint when you need structured, normalized vote data for a specific Snapshot proposal — especially when you need voting power rankings, delegate participation analysis, or per-voter reasoning. Prefer this over raw Snapshot GraphQL queries when you need clean, pre-normalized output without building your own query.

## Known failure modes

- Invalid or malformed proposal_id (non-hex or missing 0x prefix) returns an error
- Proposal ID not found on Snapshot returns empty or 404-style error
- limit exceeds maximum of 50 returns validation error
- Network or upstream Snapshot API unavailability causes 5xx response

## How this service works

Normalized votes on a Snapshot proposal, ordered by voting power: voter address, resolved choice label, voting power, reason and timestamp. Tracks delegate participation and voting behaviour.

## Output

A list of up to 50 votes on the specified Snapshot proposal, each entry including the voter's wallet address, their resolved choice label (e.g. 'For', 'Against'), their voting power, the reason text they provided, and the vote timestamp — sorted by voting power descending.

## 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": [
      "proposal_id"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 50,
       "minimum": 1,
       "description": "Max votes to return (default 20, cap 50)"
      },
      "proposal_id": {
       "type": "string",
       "description": "Snapshot proposal id (0x… hex)"
      }
     }
    }
   },
   "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-proposal-votes-lookup-8d76074a/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)