{"uid":"cap_i4eLW4GZ14rNauX1sfi7D","slug":"tzkt-ballot-operations-api-c3451949","name":"TzKT Ballot Operations API","description":"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.","url":"https://x402.tzkt.io/v1/operations/ballots","method":"GET","headers":{},"bodySchema":{"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"}}},"responseSchema":{"type":"array","items":{"type":"object"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Hf4RcmFG8KFPGBr0LHnkJ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves Tezos governance ballot operations, filterable by delegate, proposal, vote, and block level","exampleAgentPrompt":"Pull all the ballot operations on Tezos proposal hash PtNairobiyssHuh87hEhfVBGCVrK3WnS8Z2FT4ymB5tAa3SZUgj where delegates voted nay — give me up to 50 results.","exampleUseCases":[{"title":"Audit delegate voting record","prompt":"Show me every ballot cast by Tezos delegate tz1aRoaRhSpRYvFdyvgWLL6TGyRoGF51wDjM across all governance proposals — I want to see how they've voted historically."},{"title":"Track support for a protocol upgrade","prompt":"List all the yea votes submitted for Tezos proposal PtLimaPtLMwfNinJi9rCfDPWea8dFgTZ1MeJ9f1m1LRDd9a5be9d and tell me which delegates are backing it."},{"title":"Monitor governance activity at a block","prompt":"Get the ballot operations recorded at block level 4500000 on Tezos so I can see what governance activity happened at that point in the chain."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:42:49.413Z","isFirstParty":false}