{"openapi":"3.1.0","info":{"title":"Tezos Governance API","version":"1.0.0","description":"Tezos's famous self-amending on-chain governance, live from the public TzKT indexer — no key, nothing cached. Tezos upgrades itself through an on-chain vote: bakers propose protocol amendments, then move them through a five-period cycle — proposal, exploration, cooldown, promotion and adoption — each with its own quorum and supermajority thresholds. Where the on-chain reader covers accounts and the bakers reader covers staking, this surfaces the governance layer they miss. Read the current voting period in full: its kind, status, period and epoch index, the yay / nay / pass ballot tally with each side's voting power and share, the ballots quorum and supermajority thresholds, and the number of participating bakers. List every protocol-amendment proposal ever made on-chain with its initiator, upvotes, voting power, status and Tezos Agora discussion link (the human aliases like \"Athens A\" included). And browse the history of voting periods, newest first. The protocol-governance layer for Tezos wallets, governance dashboards, bakers and analytics. Live from api.tzkt.io.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/tezosgov-api","description":"oanor gateway"}],"tags":[{"name":"Voting"},{"name":"Proposals"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/current":{"get":{"operationId":"get_v1_current","tags":["Voting"],"summary":"The current voting period: kind, status, ballot tally, quorum, supermajority","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"kind":"promotion","note":"The current Tezos voting period. kind is one of proposal / exploration / cooldown / promotion / adoption. In ballot periods, yay/nay/pass voting power and the quorum & supermajority thresholds decide whether the amendment passes.","epoch":90,"index":175,"source":"TzKT","status":"active","nay_pct":0,"yay_pct":27.97,"end_time":"2026-06-15T21:17:25Z","pass_pct":33.18,"last_level":13656288,"start_time":"2026-06-01T13:34:49Z","first_level":13454689,"nay_ballots":0,"yay_ballots":61,"pass_ballots":19,"total_bakers":218,"supermajority_pct":80,"ballots_quorum_pct":49.18,"nay_voting_power_xtz":0,"yay_voting_power_xtz":183636528.51415,"pass_voting_power_xtz":217850754.265983,"total_voting_power_xtz":656635662.773932},"meta":{"timestamp":"2026-06-14T08:03:46.467Z","request_id":"bf39fc87-d405-4bd8-8a1a-02f7b9f083a2"},"status":"ok","message":"Current period retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/periods":{"get":{"operationId":"get_v1_periods","tags":["Voting"],"summary":"Recent voting periods, newest first","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max periods (1-100)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Recent Tezos voting periods (newest first). Tezos amendments move through proposal → exploration → cooldown → promotion → adoption; each period's kind, status and ballot tally are shown.","count":20,"source":"TzKT","periods":[{"kind":"promotion","epoch":90,"index":175,"status":"active","nay_pct":0,"yay_pct":27.97,"end_time":"2026-06-15T21:17:25Z","pass_pct":33.18,"last_level":13656288,"start_time":"2026-06-01T13:34:49Z","first_level":13454689,"nay_ballots":0,"yay_ballots":61,"pass_ballots":19,"total_bakers":218,"supermajority_pct":80,"ballots_quorum_pct":49.18,"nay_voting_power_xtz":0,"yay_voting_power_xtz":183636528.51415,"pass_voting_power_xtz":217850754.265983,"total_voting_power_xtz":656635662.773932},{"kind":"testing","epoch":90,"index":174,"status":"success","end_time":"2026-06-01T13:34:43Z","last_level":13454688,"start_time":"2026-05-18T10:13:52Z","first_level":13253089,"total_bakers":227,"total_voting_power_xtz":654590912.127942},{"kind":"exploration","epoch":90,"index":173,"status":"success","nay_pct":0,"yay_pct":26.6,"end_time":"2026-05-18T10:13:46Z","pass_pct":25.76,"last_level":13253088,"start_time":"2026-05-04T05:45:19Z","first_level":13051489,"nay_ballots":0,"yay_ballots":59,"pass_ballots":15,"total_bakers":231,"supermajority_pct":80,"ballots_quorum_pct":49.94,"nay_voting_power_xtz":0,"yay_voting_power_xtz":173646353.078757,"pass_voting_power_xtz":168134642.420994,"total_voting_power_xtz":652822150.860348},{"kind":"proposal","epoch":90,"index":172,"status":"success","end_time":"2026-05-04T05:45:13Z","last_level":13051488,"start_time":"2026-04-20T02:14:55Z","first_level":12849889,"total_bakers":232,"upvotes_quorum_pct":5,"total_voting_power_xtz":649330833.198396},{"kind":"proposal","epoch":89,"index":171,"status":"no_proposals","end_time":"2026-04-20T02:14:49Z","last_level":12849888,"start_time":"2026-04-05T15:07:22Z","first_level":12648289,"total_bakers":242,"upvotes_quorum_pct":5,"total_voting_power_xtz":658570563.047328},{"kind":"proposal","epoch":88,"index":170,"status":"no_proposals","end_time":"2026-04-05T15:07:16Z","last_level":12648288,"start_time":"2026-03-22T12:15:28Z","first_level":12446689,"total_bakers":246,"upvotes_quorum_pct":5,"total_voting_power_xtz":659059260.959162},{"kind":"proposal","epoch":87,"index":169,"status":"no_proposals","end_time":"2026-03-22T12:15:22Z","last_level":12446688,"start_time":"2026-03-08T08:29:58Z","first_level":12245089,"total_bakers":246,"upvotes_quorum_pct":5,"total_voting_power_xtz":655652803.085647},{"kind":"proposal","epoch":86,"index":168,"status":"no_proposals","end_time":"2026-03-08T08:29:52Z","last_level":12245088,"start_time":"2026-02-22T03:57:25Z","first_level":12043489,"total_bakers":245,"upvotes_quorum_pct":5,"total_voting_power_xtz":646915774.411953},{"kind":"proposal","epoch":85,"index":167,"status":"no_proposals","end_time":"2026-02-22T03:57:19Z","last_level":12043488,"start_time":"2026-02-07T21:11:07Z","first_level":11841889,"total_bakers":250,"upvotes_quorum_pct":5,"total_voting_power_xtz":647179459.704819},{"kind":"proposal","epoch":84,"index":166,"status":"no_proposals","end_time":"2026-02-07T21:11:01Z","last_level":11841888,"start_time":"2026-01-24T16:06:58Z","first_level":11640289,"total_bakers":260,"upvotes_quorum_pct":5,"total_voting_power_xtz":632764621.82783},{"kind":"adoption","epoch":83,"index":165,"status":"success","end_time":"2026-01-24T16:06:52Z","last_level":11640288,"start_time":"2026-01-10T15:05:48Z","first_level":11489089,"total_bakers":258,"total_voting_power_xtz":632594955.901983},{"kind":"promotion","epoch":83,"index":164,"status":"success","nay_pct":0,"yay_pct":33.12,"end_time":"2026-01-10T15:05:40Z","pass_pct":25.05,"last_level":11489088,"start_time":"2025-12-27T12:40:48Z","first_level":11337889,"nay_ballots":0,"yay_ballots":75,"pass_ballots":19,"total_bakers":261,"supermajority_pct":80,"ballots_quorum_pct":50.15,"nay_voting_power_xtz":0,"yay_voting_power_xtz":209527432.002442,"pass_voting_power_xtz":158449117.769246,"total_voting_power_xtz":632593381.647964},{"kind":"testing","epoch":83,"index":163,"status":"success","end_time":"2025-12-27T12:40:40Z","last_level":11337888,"start_time":"2025-12-13T10:53:48Z","first_level":11186689,"total_bakers":266,"total_voting_power_xtz":638411990.450885},{"kind":"exploration","epoch":83,"index":162,"status":"success","nay_pct":0,"yay_pct":32.05,"end_time":"2025-12-13T10:53:40Z","pass_pct":24.78,"last_level":11186688,"start_time":"2025-11-29T09:29:44Z","first_level":11035489,"nay_ballots":0,"yay_ballots":65,"pass_ballots":21,"total_bakers":262,"supermajority_pct":80,"ballots_quorum_pct":50.59,"nay_voting_power_xtz":0,"yay_voting_power_xtz":205816569.77534,"pass_voting_power_xtz":159086060.253078,"total_voting_power_xtz":642094444.666312},{"kind":"proposal","epoch":83,"index":161,"status":"success","end_time":"2025-11-29T09:29:36Z","last_level":11035488,"start_time":"2025-11-15T07:06:32Z","first_level":10884289,"total_bakers":263,"upvotes_quorum_pct":5,"total_voting_power_xtz":634270271.350029},{"kind":"proposal","epoch":82,"index":160,"status":"no_proposals","end_time":"2025-11-15T07:06:24Z","last_level":10884288,"start_time":"2025-11-01T04:55:48Z","first_level":10733089,"total_bakers":256,"upvotes_quorum_pct":5,"total_voting_power_xtz":653132399.958484},{"kind":"proposal","epoch":81,"index":159,"status":"no_proposals","end_time":"2025-11-01T04:55:40Z","last_level":10733088,"start_time":"2025-10-18T01:08:56Z","first_level":10581889,"total_bakers":254,"upvotes_quorum_pct":5,"total_voting_power_xtz":654718500.903209},{"kind":"proposal","epoch":80,"index":158,"status":"no_proposals","end_time":"2025-10-18T01:08:48Z","last_level":10581888,"start_time":"2025-10-03T21:56:56Z","first_level":10430689,"total_bakers":250,"upvotes_quorum_pct":5,"total_voting_power_xtz":688988703.675762},{"kind":"proposal","epoch":79,"index":157,"status":"no_quorum","end_time":"2025-10-03T21:56:48Z","last_level":10430688,"start_time":"2025-09-19T14:59:28Z","first_level":10279489,"total_bakers":267,"upvotes_quorum_pct":5,"total_voting_power_xtz":688537005.580193},{"kind":"adoption","epoch":78,"index":156,"status":"success","end_time":"2025-09-19T14:59:16Z","last_level":10279488,"start_time":"2025-09-05T12:19:32Z","first_level":10128289,"total_bakers":260,"total_voting_power_xtz":690425036.03966}]},"meta":{"timestamp":"2026-06-14T08:03:46.577Z","request_id":"856621d5-5ca1-4950-8834-657f774fae1e"},"status":"ok","message":"Periods retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/proposals":{"get":{"operationId":"get_v1_proposals","tags":["Proposals"],"summary":"Protocol-amendment proposals with initiator, upvotes, status, Agora link","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max proposals (1-100)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Tezos protocol-amendment proposals: each upgrade ever proposed on-chain, with its initiator, upvotes, voting power, status (accepted / rejected / …) and Agora discussion link. alias is the human name (e.g. 'Athens A').","count":20,"source":"TzKT","proposals":[{"hash":"Pt24m4xiPbLDhVgVfABUjirbmda3yohdN82Sp9FeuAXJ4eV9otd","agora":"https://www.tezosagora.org/proposal/Pt24m4xiPbLDhVgVfABUjirbmda3yohdN82Sp9FeuAXJ4eV9otd","alias":"Athens A","epoch":10,"status":"accepted","upvotes":102,"initiator":"tz1fNdh4YftsUasbB1BWBpqDmr4sFZaPNZVL","last_period":13,"first_period":10,"voting_power_xtz":181810000},{"hash":"Psd1ynUBhMZAeajwcZJAeq5NrxorM6UCU4GJqxZ7Bx2e9vUWB6z","agora":"https://www.tezosagora.org/proposal/2","alias":"Athens B","epoch":10,"status":"skipped","upvotes":68,"initiator":"tz1fNdh4YftsUasbB1BWBpqDmr4sFZaPNZVL","last_period":10,"first_period":10,"voting_power_xtz":76740000},{"hash":"PtdRxBHvc91c2ea2evV6wkoqnzW7TadTg9aqS9jAn2GbcPGtumD","agora":"https://www.tezosagora.org/proposal/3","alias":"Brest A","epoch":11,"status":"skipped","upvotes":6,"initiator":"tz1LWub69XbTxdatJnBkm7caDQoybSgW4T3s","last_period":15,"first_period":14,"voting_power_xtz":2000000},{"hash":"PsBABY5nk4JhdEv1N1pZbt6m6ccB9BfNqa23iKZcHBh23jmRS9f","agora":"https://www.tezosagora.org/proposal/4","alias":"Babylon","epoch":12,"status":"skipped","upvotes":71,"initiator":"tz1eEnQhbwf6trb8Q8mPb2RaPkNk2rN7BKi8","last_period":16,"first_period":16,"voting_power_xtz":76176000},{"hash":"PsBABY5HQTSkA4297zNHfsZNKtxULfL18y95qb3m53QJiXGmrbU","agora":"https://www.tezosagora.org/proposal/5","alias":"Babylon 2.0","epoch":12,"status":"accepted","upvotes":150,"initiator":"tz1eEnQhbwf6trb8Q8mPb2RaPkNk2rN7BKi8","last_period":19,"first_period":16,"voting_power_xtz":265160000},{"hash":"PtCarthavAMoXqbjBPVgDCRd5LgT7qqKWUPXnYii3xCaHRBMfHH","agora":"https://www.tezosagora.org/proposal/6","alias":"Carthage","epoch":14,"status":"skipped","upvotes":24,"initiator":"tz1go7f6mEQfT2xX2LuHAqgnRGN6c2zHPf5c","last_period":21,"first_period":21,"voting_power_xtz":20208000},{"hash":"PsCARTHAGazKbHtnKfLzQg3kms52kSRpgnDY982a9oYsSXRLQEb","agora":"https://www.tezosagora.org/proposal/PsCARTHAGazKbHtnKfLzQg3kms52kSRpgnDY982a9oYsSXRLQEb","alias":"Carthage 2.0","epoch":15,"status":"accepted","upvotes":65,"initiator":"tz1WBfwbT66FC6BTLexc2BoyCCBM9LG7pnVW","last_period":25,"first_period":22,"voting_power_xtz":130704000},{"hash":"PsDELPH1Kxsxt8f9eWbxQeRxkjfbxoqM52jvs5Y5fBxWWh4ifpo","agora":"https://www.tezosagora.org/proposal/PsDELPH1Kxsxt8f9eWbxQeRxkjfbxoqM52jvs5Y5fBxWWh4ifpo","alias":"Delphi","epoch":23,"status":"accepted","upvotes":66,"initiator":"tz1go7f6mEQfT2xX2LuHAqgnRGN6c2zHPf5c","last_period":36,"first_period":33,"voting_power_xtz":77480000},{"hash":"PtEdoTezd3RHSC31mpxxo1npxFjoWWcFgQtxapi51Z8TLu6v6Uq","agora":"https://www.tezosagora.org/proposal/9","alias":"Edo","epoch":24,"status":"accepted","upvotes":80,"initiator":"tz1go7f6mEQfT2xX2LuHAqgnRGN6c2zHPf5c","last_period":40,"first_period":37,"voting_power_xtz":86704000},{"hash":"PsFLorBArSaXjuy9oP76Qv1v2FRYnUs7TFtteK5GkRBC24JvbdE","agora":"https://www.tezosagora.org/proposal/10","alias":"Florence (BA)","epoch":26,"status":"skipped","upvotes":38,"initiator":"tz1NMNQYrYrfNpmUqQrMhJypf6ovnaDZhJHM","last_period":42,"first_period":42,"voting_power_xtz":42208000},{"hash":"PsFLorenaUUuikDWvMDr6fGBRG8kt3e3D3fHoXK1j1BFRxeSH4i","agora":"https://www.tezosagora.org/proposal/PsFLorenaUUuikDWvMDr6fGBRG8kt3e3D3fHoXK1j1BFRxeSH4i","alias":"Florence","epoch":26,"status":"accepted","upvotes":66,"initiator":"tz1S5WxdZR5f9NzsPXhr7L9L1vrEb5spZFur","last_period":46,"first_period":42,"voting_power_xtz":108200000},{"hash":"PtGRANADsDU8R9daYKAgWnQYAJ64omN1o3KMGVCykShA97vQbvV","agora":"https://www.tezosagora.org/proposal/PtGRANADsDU8R9daYKAgWnQYAJ64omN1o3KMGVCykShA97vQbvV","alias":"Granada","epoch":28,"status":"accepted","upvotes":93,"initiator":"tz1S5WxdZR5f9NzsPXhr7L9L1vrEb5spZFur","last_period":52,"first_period":48,"voting_power_xtz":125640000},{"hash":"PtEdoTezd3RHSC31mpxxo1npxFjoWWcFgQtxapi51Z8TLu6v6Uq","agora":"https://www.tezosagora.org/proposal/9","alias":"Edo","epoch":28,"status":"skipped","upvotes":3,"initiator":"tz1S1Aew75hMrPUymqenKfHo8FspppXKpW7h","last_period":48,"first_period":48,"voting_power_xtz":1200000},{"hash":"PtGxSEBUHxTHiSxiSxAxTESTxoFxTHExEMERGENCYxMSG3SEkQs","epoch":28,"status":"skipped","upvotes":1,"initiator":"tz1R664EP6wjcM1RSUVJ7nrJisTpBW9QyJzP","last_period":48,"first_period":48,"voting_power_xtz":152000},{"hash":"PtGxSEBUHxBAKERxBRoADCASTxSYSTEMxTEZoSxderpxx6bsL3U","epoch":28,"status":"skipped","upvotes":1,"initiator":"tz1R664EP6wjcM1RSUVJ7nrJisTpBW9QyJzP","last_period":48,"first_period":48,"voting_power_xtz":152000},{"hash":"PtGxSEBUHxTHiSxGRANADAXPRoposaLXisXNoTXGoooDx6Y1FUP","epoch":28,"status":"skipped","upvotes":1,"initiator":"tz1R664EP6wjcM1RSUVJ7nrJisTpBW9QyJzP","last_period":48,"first_period":48,"voting_power_xtz":152000},{"hash":"PtGxSEBUHXthereXisXaXbakerXoverde1agatedx13376siwry","epoch":28,"status":"skipped","upvotes":1,"initiator":"tz1R664EP6wjcM1RSUVJ7nrJisTpBW9QyJzP","last_period":48,"first_period":48,"voting_power_xtz":152000},{"hash":"PtGxSEBUHXxPLEASExSENDxHELPxHoDLGANGHoDLGANGx7BNY3A","epoch":28,"status":"skipped","upvotes":1,"initiator":"tz1R664EP6wjcM1RSUVJ7nrJisTpBW9QyJzP","last_period":48,"first_period":48,"voting_power_xtz":152000},{"hash":"PtGXSEBUHXFARMxDEXxNFTxRPCxSEBxSEBxSEBxSEBxSE3GRJJC","epoch":28,"status":"skipped","upvotes":2,"initiator":"tz1R664EP6wjcM1RSUVJ7nrJisTpBW9QyJzP","last_period":48,"first_period":48,"voting_power_xtz":160000},{"hash":"PtGTHEXCHANCELLoRX1SXoNXBR1NKXoFXBA1LoUTTZBTC7AwbQm","epoch":28,"status":"skipped","upvotes":1,"initiator":"tz1R664EP6wjcM1RSUVJ7nrJisTpBW9QyJzP","last_period":48,"first_period":48,"voting_power_xtz":152000}]},"meta":{"timestamp":"2026-06-14T08:03:46.670Z","request_id":"abcb980a-ce38-43fd-927f-d6e4186c8114"},"status":"ok","message":"Proposals retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"kind":"promotion","period":175,"status":"active"},"source":"public TzKT API (api.tzkt.io /voting), keyless","service":"tezosgov-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/current":"The current voting period in full: kind, status, ballot tally, quorum, supermajority.","GET /v1/periods":"Recent voting periods, newest first (limit).","GET /v1/proposals":"Protocol-amendment proposals with initiator, upvotes, status, Agora link (limit)."},"description":"Read Tezos's self-amending on-chain governance live from the public TzKT indexer: the current voting period in full (kind, status, ballot tally, quorum & supermajority), the protocol-amendment proposals with initiators, upvotes and Agora links, and the history of voting periods. The protocol-governance layer for Tezos wallets, governance dashboards and bakers. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:03:46.753Z","request_id":"9dc4d6ed-5a01-442e-a3ef-635630ca22a4"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":7600,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":880,"monthly_call_quota":128000,"rps_limit":9,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3380,"monthly_call_quota":802000,"rps_limit":22,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":9050,"monthly_call_quota":4750000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/tezosgov-api"}