# Snapshot Governance Votes Lookup

> Snapshot Governance Votes Lookup is a paid API for AI agents from x402helper.xyz, paid per call via x402, $0.009/call, status unknown (last checked 2026-10-31).

Retrieves votes cast on a specific Snapshot governance proposal, paginated and filtered by proposal ID.

## Facts

- Endpoint: GET https://x402helper.xyz/89e509/governance/votes?utm_source=zero.xyz
- Price: $0.009/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/snapshot-governance-votes-lookup-bb38104e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_w-RygPqrFPhoMB-AIEaUB

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-governance-votes-lookup-bb38104e
```

Example prompt: Show me the votes on Snapshot proposal 0x4b3c2a1d… — return up to 30 votes so I can see who participated and what they chose.

## When to prefer this

Use this endpoint when you need to retrieve vote-level detail for a specific Snapshot governance proposal — including voter addresses, choices, and voting power — and when you are operating in an x402 micropayment-enabled agent context that can pay 0.009 USDC per call. Prefer this over direct Snapshot GraphQL API calls when you need a simple REST GET interface with built-in payment gating.

## Known failure modes

- Missing or invalid proposal_id returns an error or empty result
- Proposal ID not found on Snapshot returns empty votes array
- limit exceeding 50 is rejected or capped
- Payment of 0.009 USDC via x402 not provided results in 402 Payment Required
- Network or upstream Snapshot API unavailability returns a failure response

## How this service works

X402 micropayments server — AI agents pay USDC for OFAC screening, rates, and billing verification.

## Output

Returns a JSON object with a success flag and a result object containing an array of vote records for the specified Snapshot proposal. Each record typically includes voter address, choice, voting power, and timestamp, up to the requested limit (default 20, max 50).

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "proposal_id"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": null,
       "maximum": 50,
       "minimum": 1,
       "description": "Max votes to return (default 20, cap 50)"
      },
      "proposal_id": {
       "type": "string",
       "default": null,
       "description": "Snapshot proposal id (0x… hex)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {},
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/snapshot-governance-votes-lookup-bb38104e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402helper.xyz](https://www.zero.xyz/host/x402helper.xyz/llms.txt)