{"openapi":"3.1.0","info":{"title":"Algorand Governance API","version":"1.0.0","description":"The Algorand Foundation governance program, live from its official public API — no key, nothing cached. Algorand governance is a quarterly, on-chain-committed vote: ALGO holders commit stake, keep their voting commitments and earn rewards from a per-period pool. Where the on-chain reader covers ALGO balances and the app reader covers smart contracts, this surfaces the governance layer they miss. List every governance period with its total committed ALGO, governor count, reward pool and key dates. Read a single period in full — its committed ALGO (direct and LP), its reward-pool breakdown between DeFi and non-DeFi participants, its sign-up address and the voting sessions held in the period with their topics and dates. And rank a period's governors by committed ALGO, each with their eligibility, xGov status and how many voting sessions they voted in. Omit the period to default to the active (or most recent) one. The governance-and-voting layer for Algorand wallets, governor dashboards and analytics. Live from governance.algorand.foundation.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/algorandgov-api","description":"oanor gateway"}],"tags":[{"name":"Periods"},{"name":"Governors"},{"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/period":{"get":{"operationId":"get_v1_period","tags":["Periods"],"summary":"One period in full: reward-pool breakdown and voting sessions","description":"","parameters":[{"name":"slug","in":"query","required":false,"description":"Period slug; omit for the active (or most recent) period","schema":{"type":"string"},"example":"governance-period-15"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"end":"2025-07-15 15:59:59+00","note":"A single Algorand governance period in full: its committed ALGO, reward-pool breakdown (DeFi vs non-DeFi), sign-up address and the voting sessions held in the period. Omit slug for the active (or most recent) period.","slug":"governance-period-15","start":"2025-06-30 16:00:00+00","title":"Governance Period 15","source":"Algorand Foundation governance","is_active":false,"committed_algo":77790352.87548,"governor_count":1394,"sign_up_address":"RW466IANOKLA36QARHMBX5VCY3PYDR3H2N5XHPDARG6UBOKCIK7WAMLSCA","voting_sessions":[{"slug":"period-15-voting-session-1","title":"Period 15, Voting Session 1","voting_end":"2025-07-15 15:58:00+00","topic_count":22,"voting_start":"2025-07-07 16:00:00+00","short_description":"xGov Council Election 2025"}],"registration_end":"2025-07-07 15:59:59+00","reward_pool_algo":0,"committed_lp_in_algo":8882475.907136,"committed_algo_direct":68907876.968344,"rewards_reserved_defi_algo":0,"rewards_reserved_non_defi_algo":0,"committed_for_extra_rewards_algo":0},"meta":{"timestamp":"2026-06-14T08:03:46.952Z","request_id":"b3b21fe2-b12f-4b14-a0b7-86ea92cd4096"},"status":"ok","message":"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":["Periods"],"summary":"Every governance period with committed ALGO, governors, reward pool, dates","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max periods (1-100)","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Every Algorand Foundation governance period (newest first), each with its total committed ALGO, governor count, reward pool and key dates. Use a slug with /v1/period or /v1/governors.","count":15,"source":"Algorand Foundation governance","periods":[{"end":"2025-07-15 15:59:59+00","slug":"governance-period-15","start":"2025-06-30 16:00:00+00","title":"Governance Period 15","is_active":false,"committed_algo":77790352.87548,"registration_end":"2025-07-07 15:59:59+00","committed_lp_in_algo":8882475.907136,"committed_algo_direct":68907876.968344},{"end":"2025-03-31 15:59:59+00","slug":"governance-period-14","start":"2024-12-31 16:00:00+00","title":"Governance Period #14","is_active":false,"committed_algo":1069915195.519322,"registration_end":"2025-01-14 16:00:00+00","committed_lp_in_algo":27730669.351697,"committed_algo_direct":1042184526.167625},{"end":"2024-12-31 15:59:59+00","slug":"governance-period-13","start":"2024-09-30 16:00:00+00","title":"Governance Period #13","is_active":false,"committed_algo":1524453009.475444,"registration_end":"2024-10-14 16:00:00+00","committed_lp_in_algo":41543197.022013,"committed_algo_direct":1482909812.453431},{"end":"2024-09-30 15:59:59+00","slug":"governance-period-12","start":"2024-06-30 16:00:00+00","title":"Governance Period 12","is_active":false,"committed_algo":1568299125.324741,"registration_end":"2024-07-15 16:00:00+00","committed_lp_in_algo":32716334.153949,"committed_algo_direct":1535582791.170792},{"end":"2024-06-30 15:59:59+00","slug":"governance-period-11","start":"2024-03-31 16:00:00+00","title":"Governance Period #11","is_active":false,"committed_algo":1624567535.699458,"registration_end":"2024-04-15 16:00:00+00","committed_lp_in_algo":48305781.424431,"committed_algo_direct":1576261754.275027},{"end":"2024-03-31 15:59:59+00","slug":"governance-period-10","start":"2023-12-31 16:00:00+00","title":"Governance Period #10","is_active":false,"committed_algo":1715089966.608106,"registration_end":"2024-01-15 16:00:00+00","committed_lp_in_algo":48428332.825197,"committed_algo_direct":1666661633.782909},{"end":"2023-12-31 15:59:59+00","slug":"governance-period-9","start":"2023-09-30 16:00:00+00","title":"Governance Period #9","is_active":false,"committed_algo":1911528647.101447,"registration_end":"2023-10-13 16:00:00+00","committed_lp_in_algo":31746523.959227,"committed_algo_direct":1879782123.14222},{"end":"2023-09-30 15:59:59+00","slug":"governance-period-8","start":"2023-06-30 16:00:00+00","title":"Governance Period #8","is_active":false,"committed_algo":2350003047.740206,"registration_end":"2023-07-13 16:00:00+00","committed_lp_in_algo":26135226.563681,"committed_algo_direct":2323867821.176525},{"end":"2023-06-30 15:59:59+00","slug":"governance-period-7","start":"2023-03-31 16:00:00+00","title":"Governance Period #7","is_active":false,"committed_algo":2549974452.970634,"registration_end":"2023-04-21 16:00:00+00","committed_lp_in_algo":29662817.9662,"committed_algo_direct":2520311635.004434},{"end":"2023-03-31 15:59:59+00","slug":"governance-period-6","start":"2022-12-31 16:00:00+00","title":"Governance Period #6","is_active":false,"committed_algo":3808896588.65447,"registration_end":"2023-01-15 16:00:00+00","committed_lp_in_algo":37294253.480728,"committed_algo_direct":3771602335.173742},{"end":"2022-12-31 15:59:59+00","slug":"governance-period-5","start":"2022-09-30 16:00:00+00","title":"Governance period #5","is_active":false,"committed_algo":3759282373.634327,"registration_end":"2022-10-21 16:00:00+00","committed_lp_in_algo":12635918.433092,"committed_algo_direct":3746646455.201235},{"end":"2022-09-30 15:59:59+00","slug":"governance-period-4","start":"2022-06-30 16:00:01+00","title":"Governance period #4","is_active":false,"committed_algo":3650119241.442628,"registration_end":"2022-07-14 16:00:00+00","committed_lp_in_algo":0,"committed_algo_direct":3650119241.442628},{"end":"2022-06-30 15:59:59+00","slug":"governance-period-3","start":"2022-03-31 16:00:00+00","title":"Governance period #3","is_active":false,"committed_algo":3543001182.470428,"registration_end":"2022-04-14 16:00:00+00","committed_lp_in_algo":0,"committed_algo_direct":3543001182.470428},{"end":"2022-03-31 15:59:59+00","slug":"governance-period-2","start":"2021-12-24 15:59:59+00","title":"Governance period #2","is_active":false,"committed_algo":2813429242.155947,"registration_end":"2022-01-07 15:59:59+00","committed_lp_in_algo":0,"committed_algo_direct":2813429242.155947},{"end":"2021-12-31 15:59:59+00","slug":"governance-period-1","start":"2021-09-30 16:00:00+00","title":"Governance period #1","is_active":false,"committed_algo":1708118111.845189,"registration_end":"2021-10-14 16:00:00+00","committed_lp_in_algo":0,"committed_algo_direct":1708118111.845189}]},"meta":{"timestamp":"2026-06-14T08:03:47.094Z","request_id":"d91c7cc8-0266-41df-b1b7-efc52a4261f1"},"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/governors":{"get":{"operationId":"get_v1_governors","tags":["Governors"],"summary":"A period's governors with committed ALGO, eligibility, xGov","description":"","parameters":[{"name":"period","in":"query","required":false,"description":"Period slug; omit for active/latest","schema":{"type":"string"},"example":"governance-period-15"},{"name":"limit","in":"query","required":false,"description":"Page size (1-100)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Governors registered in the period, with each one's committed ALGO, eligibility, xGov status and how many voting sessions they voted in. Paginate with limit & offset. Omit period for the active (or most recent) one.","count":20,"offset":0,"period":"governance-period-15","source":"Algorand Foundation governance","governors":[{"address":"PBW2OUVI3YHFPHVVGF4KNNY4FLG6ZIHCNAPITYFRSZ67HK7A5CHNLNSZPE","is_xgov":false,"is_eligible":false,"committed_algo":14434.62032,"not_eligible_reason":"incomplete-vote","registration_datetime":"2025-06-30 16:01:15.768907+00","committed_assets_in_algo":0,"voted_voting_session_count":0},{"address":"C6VLOB46CHDMTNGFC3F5WRNGELPVUNDSJCW24FU577WUFXWIXXCMSGR2BQ","is_xgov":false,"is_eligible":true,"committed_algo":206182.527058,"registration_datetime":"2025-06-30 16:01:21.559139+00","committed_assets_in_algo":0,"voted_voting_session_count":1},{"address":"KEXFAU2TWG4X3DDCFKRY6CQDWZOYCNWCEBM255GHKJBFOJJVJAZAHINLCE","is_xgov":false,"is_eligible":true,"committed_algo":310.166122,"registration_datetime":"2025-06-30 16:01:43.104058+00","committed_assets_in_algo":0,"voted_voting_session_count":1},{"address":"Z2PHFWPP334DRPLKHGDNU3T5GEDSMJXEBCPRLLQSVOLJHNMACLYYCFKTVU","is_xgov":false,"is_eligible":true,"committed_algo":94700,"registration_datetime":"2025-06-30 16:02:14.094617+00","committed_assets_in_algo":0,"voted_voting_session_count":1},{"address":"MSXB5CWRWB7V6C2S6DVGD6GYLNDR6ERKMU4BBOBAT45DZ7FHCWEK4CCTWU","is_xgov":false,"is_eligible":true,"committed_algo":49000,"registration_datetime":"2025-06-30 16:04:17.16301+00","committed_assets_in_algo":0,"voted_voting_session_count":1},{"address":"TR3ICSF2HYLH4FF4EX7SNMIMJTFHWYMF3TXYMDGZSG5NTJUNZGMXYSXEAE","is_xgov":false,"is_eligible":true,"committed_algo":258.020265,"registration_datetime":"2025-06-30 16:04:52.97258+00","committed_assets_in_algo":0,"voted_voting_session_count":1},{"address":"Y7SWDVYHQHWHZDCZPBRPD3AO3AZTKRVA26NRHV7ZFEB3H6BBVTT7G5ZDTI","is_xgov":false,"is_eligible":true,"committed_algo":0,"registration_datetime":"2025-06-30 16:10:28.702211+00","committed_assets_in_algo":18921.038431,"voted_voting_session_count":1},{"address":"EEQGOX6V2HW6SPCH6CW4YAQ3VU4JNSOWNTDNGPFLOWF4C3SJEQRDHVVCFQ","is_xgov":false,"is_eligible":true,"committed_algo":4311.145896,"registration_datetime":"2025-06-30 16:13:38.511912+00","committed_assets_in_algo":0,"voted_voting_session_count":1},{"address":"DUXPSTFRAWEADKSW67NJEMFZZIPK2GARJGMLLLFRZWQ67IKGNIXO4VSHEE","is_xgov":false,"is_eligible":true,"committed_algo":1,"registration_datetime":"2025-06-30 16:13:49.887821+00","committed_assets_in_algo":11560,"voted_voting_session_count":1},{"address":"YVBJRXX64BH3AD2F2MXHNA4I6CRADBG2IXUXJFE76ERJ57GKLSZZ6MOANY","is_xgov":false,"is_eligible":true,"committed_algo":137000,"registration_datetime":"2025-06-30 16:15:05.867463+00","committed_assets_in_algo":0,"voted_voting_session_count":1},{"address":"AINNHMD4WP6TW72VD7N4T3VCWQGDNJ53IBW375PVA74SDGX56DGYPEMJS4","is_xgov":false,"is_eligible":true,"committed_algo":300,"registration_datetime":"2025-06-30 16:16:33.579766+00","committed_assets_in_algo":4118.88148,"voted_voting_session_count":1},{"address":"LLG4GKERNYPGSMA5FAI6REHSLZQRV77WV3Y35XGFEWW6QDF2Q7NTNXMLDA","is_xgov":false,"is_eligible":true,"committed_algo":1001,"registration_datetime":"2025-06-30 16:19:27.077597+00","committed_assets_in_algo":0,"voted_voting_session_count":1},{"address":"HQGN5H6HII5TZTB27FIJBNNIBU3GF2E6CJCKIRXFTVBGDMEA7TTZVRYG4Q","is_xgov":false,"is_eligible":true,"committed_algo":1100,"registration_datetime":"2025-06-30 16:25:39.457004+00","committed_assets_in_algo":0,"voted_voting_session_count":1},{"address":"YXEY4DUH5AGIGEGTMBQGQ2ND37AZWLPX6RJM3M25VPMGTFODPDL7IQZMRY","is_xgov":false,"is_eligible":true,"committed_algo":750,"registration_datetime":"2025-06-30 16:28:34.061861+00","committed_assets_in_algo":0,"voted_voting_session_count":1},{"address":"VIXMHEXXX3YCZHLTLC4WTLFJEHCBTQ7RFNT4BFWDFUPHYHZXCMYCLQWOZI","is_xgov":false,"is_eligible":false,"committed_algo":500,"not_eligible_reason":"commitment-failed","registration_datetime":"2025-06-30 16:31:29.640237+00","committed_assets_in_algo":10320,"voted_voting_session_count":0},{"address":"SE7OVAZO5DY36ABMERMAHDIMCDULJKBRK62H4QBBRQLQBJXWDS74TLZ6AY","is_xgov":false,"is_eligible":true,"committed_algo":213427,"registration_datetime":"2025-06-30 16:32:31.276645+00","committed_assets_in_algo":0,"voted_voting_session_count":1},{"address":"HEMUFMPIITYCFCDQMOCVSO3ECUMFCM7KLOLARRZUMVBGKWRY7DQZR3MSEY","is_xgov":false,"is_eligible":true,"committed_algo":260000,"registration_datetime":"2025-06-30 16:32:33.069269+00","committed_assets_in_algo":0,"voted_voting_session_count":1},{"address":"DTGI4AMC7UKJDYU5CSMOPGMJFPFZ5LBTDUBCLRDT7JJX6EADAQWF36TJXQ","is_xgov":false,"is_eligible":true,"committed_algo":54000,"registration_datetime":"2025-06-30 16:33:01.301883+00","committed_assets_in_algo":0,"voted_voting_session_count":1},{"address":"TRGFI5WXAG7IVGRH5SAF767E6RWKPXUSOPYWRJJIIZIOFXDNWW6HKWHONU","is_xgov":false,"is_eligible":true,"committed_algo":190,"registration_datetime":"2025-06-30 16:34:38.276723+00","committed_assets_in_algo":286.449237,"voted_voting_session_count":1},{"address":"2MXAD27JAPNLUXHAH7WYDKXMUH5RNFUGPRTP2JGPMYHFQHCOZPX26R5LEU","is_xgov":false,"is_eligible":true,"committed_algo":53868.171493,"registration_datetime":"2025-06-30 16:36:16.21333+00","committed_assets_in_algo":0,"voted_voting_session_count":1}],"total_governors":2217},"meta":{"timestamp":"2026-06-14T08:03:47.222Z","request_id":"334c52fb-48dc-455d-88b0-6fd8bc559e9c"},"status":"ok","message":"Governors 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":{"latest_period":"governance-period-15","committed_algo":77790352.87548},"source":"official Algorand Foundation governance API (governance.algorand.foundation), keyless","service":"algorandgov-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/period":"One period in full: reward-pool breakdown and voting sessions (slug; omit for active/latest).","GET /v1/periods":"Every governance period with committed ALGO, governors, reward pool, dates (limit).","GET /v1/governors":"A period's governors ranked, with committed ALGO, eligibility, xGov (period, limit, offset)."},"description":"Read the Algorand Foundation governance program live from the official public API: list every governance period with its committed ALGO, governor count, reward pool and dates; read one period in full with its reward-pool breakdown and voting sessions; and rank a period's governors by committed ALGO with eligibility and xGov status. The governance-and-voting layer for Algorand wallets, governor dashboards and analytics. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:03:47.298Z","request_id":"3b663014-1a7e-4a05-bcb3-355c0f796bba"},"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":7100,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":920,"monthly_call_quota":136000,"rps_limit":9,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3280,"monthly_call_quota":815000,"rps_limit":22,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":9350,"monthly_call_quota":5050000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/algorandgov-api"}