# SperaxOS Governance Voting History API

> SperaxOS Governance Voting History API is a paid API for AI agents from chat.sperax.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-03).

Retrieves the on-chain and Snapshot governance voting history for a given wallet address, optionally filtered by protocol or Snapshot space.

## Facts

- Endpoint: POST https://chat.sperax.io/api/x402/tools/governance/getVotingHistory?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-03
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/speraxos-governance-voting-history-api-44c291f4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aCSJwVHNA3R2XYyovVgo9

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 speraxos-governance-voting-history-api-44c291f4 -d '<json body>'
```

Example prompt: Show me the last 10 governance votes cast by wallet 0xAbc123...def on Snapshot, filtered to the Uniswap space.

## When to prefer this

Choose this endpoint when you need to audit or analyze the on-chain/Snapshot governance voting history of a specific wallet address, especially within the DeFi ecosystem. Prefer it over generic blockchain explorers when you want structured, pre-parsed vote records ready for agent consumption without needing to parse raw chain data yourself. Ideal for governance research, delegate vetting, or participation audits.

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unknown or misspelled Snapshot space ID returns empty results or error
- Limit value out of acceptable range may be clamped or rejected
- Payment failure via x402 protocol results in 402 Payment Required response
- Wallet with no governance activity returns an empty list

## How this service works

AI-powered DeFi intelligence APIs payable via the x402 HTTP payment protocol. No API key required — pay per request with USDC on Base. Identity-only (SIWX) endpoints are free for wallets with an agentcash identity.

## Output

Returns a list of governance vote records for the specified wallet, each containing details such as the proposal ID, the Snapshot space, the choice made, the voting power used, and timestamps. The number of records returned is bounded by the limit parameter (default 20).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "default": 20,
   "description": "Max votes to return (default 20)"
  },
  "wallet": {
   "type": "string",
   "description": "Wallet address (0x...)"
  },
  "protocol": {
   "type": "string",
   "description": "Optional Snapshot space ID to filter by"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/speraxos-governance-voting-history-api-44c291f4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chat.sperax.io](https://www.zero.xyz/host/chat.sperax.io/llms.txt)