# Halowerk DAO Snapshot Reader

> Halowerk DAO Snapshot Reader is a paid API for AI agents from ident.halowerk.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Reads a Snapshot governance space and returns per-proposal voting data including choices, scores, leading option, voter count, quorum status, and voting deadline with time remaining.

## Facts

- Endpoint: POST https://ident.halowerk.com/v1/dao-snapshot
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-dao-snapshot-reader-e5dd3fa8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3b8CGUBE0n7ujmYoz390y

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 halowerk-dao-snapshot-reader-e5dd3fa8 -d '<json body>'
```

Example prompt: Pull the current voting results for the Snapshot proposal on the Uniswap governance space — I need to know which option is leading, whether quorum has been met, how many voters have participated, and how much time is left before it closes.

## When to prefer this

Use this endpoint when an agent needs structured, actionable voting data from a Snapshot governance space — particularly when you need quorum status, score finality flags, or time-remaining calculations that raw Snapshot GraphQL queries don't surface cleanly. Prefer this over direct Snapshot API calls when you want a normalized, agent-ready summary without building your own parsing logic.

## Known failure modes

- Invalid or nonexistent Snapshot space ID returns an error or empty result
- Proposal not found within the specified space
- Scores marked as pending may shift if read before Snapshot finalizes them asynchronously
- Network or Snapshot API downtime causes lookup failure
- Malformed POST body (missing required space or proposal identifiers) returns a validation error

## How this service works

Reads a Snapshot space and returns what a voter or an observer needs to act. Per proposal: the choices with their scores and share, total voting power cast, the leading option, the number of voters, the quorum and whether it is met, when voting closes and how much time is left. Scores are marked final or pending — Snapshot computes them asynchronously, and a pending score can still move, so a result read too early is not a result.

## Output

Returns per-proposal data including: each choice with its raw score and percentage share of total voting power, the total voting power cast, the current leading option, the number of distinct voters, the quorum value and whether it has been met, the timestamp when voting closes, the remaining time until close, and a flag indicating whether scores are final or still pending (since Snapshot computes them asynchronously).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 5,
   "maximum": 20,
   "minimum": 1,
   "description": "How many proposals."
  },
  "space": {
   "type": "string",
   "maxLength": 128,
   "description": "Snapshot space id, e.g. ens.eth, aavedao.eth, uniswapgovernance.eth."
  },
  "state": {
   "enum": [
    "active",
    "closed",
    "pending",
    "all"
   ],
   "type": "string",
   "default": "active",
   "description": "Which proposals to return."
  },
  "body_chars": {
   "type": "integer",
   "default": 400,
   "maximum": 4000,
   "minimum": 0,
   "description": "How much of each proposal body to include."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-dao-snapshot-reader-e5dd3fa8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from ident.halowerk.com](https://www.zero.xyz/host/ident.halowerk.com/llms.txt)