# TzKT Ballot Operations API

> TzKT Ballot Operations API is a paid API for AI agents from x402.tzkt.io, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Retrieves Tezos governance ballot operations, filterable by delegate, proposal, vote, and block level

## Facts

- Endpoint: GET https://x402.tzkt.io/v1/operations/ballots
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tzkt-ballot-operations-api-c3451949
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_i4eLW4GZ14rNauX1sfi7D

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 tzkt-ballot-operations-api-c3451949
```

Example prompt: Pull all the ballot operations on Tezos proposal hash PtNairobiyssHuh87hEhfVBGCVrK3WnS8Z2FT4ymB5tAa3SZUgj where delegates voted nay — give me up to 50 results.

## When to prefer this

Use this endpoint when you need to inspect Tezos on-chain governance ballot data — specifically who voted, how they voted, and on which proposal — without needing to run your own Tezos node. It is preferable over raw node RPC calls because it offers indexed, filterable, paginated access with no API key required. Choose this over general blockchain explorers when you need programmatic, machine-readable ballot data for governance analysis or monitoring.

## Known failure modes

- Invalid delegate address format returns empty array or 400 error
- Unknown proposal hash returns empty array
- Offset larger than total results returns empty array
- Invalid vote string filter may return no results or error
- Rate limiting or payment failure returns 402 status

## How this service works

TzKT is a comprehensive Tezos blockchain indexer API. Access blocks, operations, accounts, contracts, bigmaps, delegates, tokens and network stats through a fast REST API. No signup or API key required.

## Output

An array of ballot operation objects, each containing details such as the delegate address, the proposal hash voted on, the vote value (yea/nay/pass), the block level at which the ballot was cast, and associated operation metadata like timestamps and operation hashes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "vote": {
   "enum": [
    "yay",
    "nay",
    "pass"
   ],
   "type": "string",
   "description": "Filter by vote"
  },
  "level": {
   "type": "string",
   "description": "Filter by block level"
  },
  "limit": {
   "type": "integer",
   "description": "Max items to return"
  },
  "offset": {
   "type": "integer",
   "description": "Pagination offset"
  },
  "delegate": {
   "type": "string",
   "description": "Filter by delegate address"
  },
  "proposal": {
   "type": "string",
   "description": "Filter by proposal hash"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "array",
 "items": {
  "type": "object"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tzkt-ballot-operations-api-c3451949/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.tzkt.io](https://www.zero.xyz/host/x402.tzkt.io/llms.txt)