# governance-votes

> governance-votes is a paid API for AI agents from payai.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://payai.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/governance-votes-d77edc7b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3__aKvczgEsL-JFB92R1A

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 governance-votes-d77edc7b
```

Example prompt: Pull the top 20 votes on Snapshot proposal 0x3b24a2841a5b5a0c36ec3e85e5db1e25b1ed5e3f8f8b2c9a4b7e1d6f2a9c0e8d, ordered by voting power — show me each voter's address, their choice, and any reason they gave.

## When to prefer this

Choose this endpoint when you need structured, normalized vote data from Snapshot governance proposals — especially when you want votes ranked by voting power and with resolved choice labels rather than raw choice indices. Ideal for DAO governance analytics, delegate tracking, and voting behavior research where you need ready-to-use data without parsing raw Snapshot GraphQL responses yourself.

## Known failure modes

- Invalid or non-existent proposal_id returns an error or empty result set
- proposal_id not in 0x hex format causes a validation error
- limit exceeds maximum of 50 returns a 400 error
- Snapshot API unavailability causes a 502/503 upstream error
- Proposal with no votes returns an empty array

## 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 ranked list of up to 50 vote records for the specified Snapshot proposal, each containing the voter's wallet address, the resolved human-readable choice label (e.g. 'For', 'Against'), their voting power, the reason text they submitted (if any), and the Unix timestamp of the vote. Results are ordered from highest to lowest voting power.

## 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/governance-votes-d77edc7b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)