{"openapi":"3.1.0","info":{"title":"Polkadot & Kusama Governance (OpenGov) API","version":"1.0.0","description":"Polkadot and Kusama OpenGov, live from the public Polkassembly API — no key, nothing cached. OpenGov is a fully on-chain governance system: anyone can submit a referendum on a governance track, it accrues aye / nay / abstain votes weighted by conviction-locked DOT or KSM, and treasury referenda spend on-chain funds to beneficiaries. There is no other Polkadot reader in the marketplace; this opens the governance layer. List the most recent referenda for a network with their governance track, status and proposer. Read a single referendum in full — its aye / nay / support tally converted from Planck to DOT/KSM, its status, track, requested treasury amount and proposer. And surface the referenda that are currently open for voting (Deciding / Confirming / Submitted / Preparing) so wallets and delegates can act. Works for both Polkadot and Kusama through the network parameter. The OpenGov layer for Polkadot/Kusama wallets, governance dashboards, delegates and analytics. Live from api.polkassembly.io.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/polkadotgov-api","description":"oanor gateway"}],"tags":[{"name":"Referenda"},{"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/active":{"get":{"operationId":"get_v1_active","tags":["Referenda"],"summary":"OpenGov referenda currently open for voting","description":"","parameters":[{"name":"network","in":"query","required":false,"description":"polkadot or kusama","schema":{"type":"string"},"example":"polkadot"},{"name":"limit","in":"query","required":false,"description":"Max results (1-50)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"OpenGov referenda that are currently live and can still be voted on (status Deciding / Confirming / Submitted / Preparing). Use an id with /v1/referendum for the full tally. Pass network=kusama for Kusama.","count":6,"token":"DOT","source":"Polkassembly","network":"polkadot","referenda":[{"id":1903,"title":"Vibly Short-Term Repayable Bridge Funding Request","track":31,"status":"Deciding","proposer":"12gj7WyRWVAbmUXk1nLoGaK1Um47tcmxdd138DSuYZgngetP","created_at":"2026-06-13T05:03:12.000Z"},{"id":1899,"title":"Closeout of Bounty 22 (Polkadot Assurance Legion / DotPAL) and Bounty 36 (DeFi Infrastructure & Tooling)","track":11,"status":"Deciding","proposer":"138bU3vLAuBkJJ9ujdpjMpZpkT5AKakVnXmQBVZNMCgfjtxp","created_at":"2026-05-29T10:40:24.000Z"},{"id":1898,"title":".ID username authority registration for the dotID identity registrar","track":14,"status":"Deciding","proposer":"16g6ZBYbEP3kRMgVBki7zdvdGpymXDyHWzj3D3rDaEATXzc8","created_at":"2026-05-25T13:09:24.000Z"},{"id":1897,"title":"plaza.fun — Native Asset Activation Layer for Polkadot Hub: Retroactive Development Funding","track":33,"status":"Deciding","proposer":"1J1et4TjqPZRrX4zKFA8ZrikiU4ijyWMdEHW1VNvnng5CJp","created_at":"2026-05-25T07:44:00.000Z"},{"id":1896,"title":"Spanish Education Plan by Polkadot Mexico: Building the Next Generation of Mexico Developers","track":32,"status":"Deciding","proposer":"15XF37GkxgRJakURR4jycdrJnqWQctT5yUPzqLn81TZmwBDF","created_at":"2026-05-23T13:00:36.000Z"},{"id":1891,"title":"IBP Bounty Top-Up","track":11,"status":"Deciding","proposer":"1eGtATyy4ayn77dsrhdW8N3Vs1yjqjzJcintksNmScqy31j","created_at":"2026-05-19T13:20:12.000Z"}]},"meta":{"timestamp":"2026-06-14T08:03:46.075Z","request_id":"95168072-bb98-4965-9624-6199b621b146"},"status":"ok","message":"Active referenda 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/referenda":{"get":{"operationId":"get_v1_referenda","tags":["Referenda"],"summary":"Recent OpenGov referenda with track, status, proposer","description":"","parameters":[{"name":"network","in":"query","required":false,"description":"polkadot or kusama (default polkadot)","schema":{"type":"string"},"example":"polkadot"},{"name":"limit","in":"query","required":false,"description":"Page size (1-50)","schema":{"type":"string"},"example":"20"},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Most recent Polkadot/Kusama OpenGov referenda (newest first). Each has its on-chain id, governance track, status and proposer. Use an id with /v1/referendum for the full tally. Pass network=kusama for Kusama.","page":1,"count":20,"token":"DOT","source":"Polkassembly","network":"polkadot","referenda":[{"id":1903,"title":"Vibly Short-Term Repayable Bridge Funding Request","track":31,"status":"Deciding","proposer":"12gj7WyRWVAbmUXk1nLoGaK1Um47tcmxdd138DSuYZgngetP","created_at":"2026-06-13T05:03:12.000Z"},{"id":1899,"title":"Closeout of Bounty 22 (Polkadot Assurance Legion / DotPAL) and Bounty 36 (DeFi Infrastructure & Tooling)","track":11,"status":"Deciding","proposer":"138bU3vLAuBkJJ9ujdpjMpZpkT5AKakVnXmQBVZNMCgfjtxp","created_at":"2026-05-29T10:40:24.000Z"},{"id":1898,"title":".ID username authority registration for the dotID identity registrar","track":14,"status":"Deciding","proposer":"16g6ZBYbEP3kRMgVBki7zdvdGpymXDyHWzj3D3rDaEATXzc8","created_at":"2026-05-25T13:09:24.000Z"},{"id":1897,"title":"plaza.fun — Native Asset Activation Layer for Polkadot Hub: Retroactive Development Funding","track":33,"status":"Deciding","proposer":"1J1et4TjqPZRrX4zKFA8ZrikiU4ijyWMdEHW1VNvnng5CJp","created_at":"2026-05-25T07:44:00.000Z"},{"id":1896,"title":"Spanish Education Plan by Polkadot Mexico: Building the Next Generation of Mexico Developers","track":32,"status":"Deciding","proposer":"15XF37GkxgRJakURR4jycdrJnqWQctT5yUPzqLn81TZmwBDF","created_at":"2026-05-23T13:00:36.000Z"},{"id":1891,"title":"IBP Bounty Top-Up","track":11,"status":"Deciding","proposer":"1eGtATyy4ayn77dsrhdW8N3Vs1yjqjzJcintksNmScqy31j","created_at":"2026-05-19T13:20:12.000Z"},{"id":1902,"title":"Runtime Upgrade 2.3.0","track":1,"status":"Executed","proposer":"13TRAXTALwNp5vApqwiE74fg8G8ypMyaF9TxRfs4RwrCwxUE","created_at":"2026-06-05T21:52:00.000Z"},{"id":1901,"track":1,"status":"TimedOut","proposer":"15xzqrjr6J2neLbxErNGAD1mjyfVQ2TaC1DSDZ8RwzJQY9ns","created_at":"2026-06-05T21:40:48.000Z"},{"id":1900,"title":"PCF 2.0: Strategic Website and Tooling Renewal - Small Spender","track":32,"status":"Executed","proposer":"16MVQPFt325pJ74bYpCGUWjyANFDZFZP3efYyV6XReAd1Sq1","created_at":"2026-05-30T18:50:48.000Z"},{"id":1895,"title":"Funding for Public RPC Providers (Polkadot)","track":34,"status":"Executed","proposer":"13uwV8CBHjv25W3GACLPzzvTu2v9USc2yCQdhrqPhyM3vx6w","created_at":"2026-05-19T17:26:48.000Z"},{"id":1894,"title":"Please Ignore - Incorrect Proposal","track":1,"status":"TimedOut","proposer":"13uwV8CBHjv25W3GACLPzzvTu2v9USc2yCQdhrqPhyM3vx6w","created_at":"2026-05-19T17:15:48.000Z"},{"id":1893,"title":"Please Ignore - Incorrect Proposal","status":"TimedOut","proposer":"13uwV8CBHjv25W3GACLPzzvTu2v9USc2yCQdhrqPhyM3vx6w","created_at":"2026-05-19T17:12:24.000Z"},{"id":1892,"title":"Orbinum Network — Identity Verification via CertiK KYC ","track":31,"status":"Rejected","proposer":"15Lyf1inrKiNU3vVgfeupnkDt2bSCJMHR5cxzsQW9SJz6dww","created_at":"2026-05-19T14:36:12.000Z"},{"id":1890,"title":"Staking: set min validator bond to 10K DOT","track":1,"status":"Executed","proposer":"13TRAXTALwNp5vApqwiE74fg8G8ypMyaF9TxRfs4RwrCwxUE","created_at":"2026-05-18T12:57:36.000Z"},{"id":1889,"title":"[Big Tipper] Acuity Index Event Indexer for Polkadot Dapps (1000 DOT)","track":31,"status":"Rejected","proposer":"16LmE2fwVe3RvbsxoVVhTwo7LjBnXduU2VUaViHwRADLxLfv","created_at":"2026-05-16T07:09:24.000Z"},{"id":1888,"title":"Close 7,138 Spam Bounties on Asset Hub Polkadot","track":11,"status":"Executed","proposer":"16kZMraPPw9n4794nAe41tAMyY2ExY3hFEM3W6WAGZQXiV4L","created_at":"2026-05-05T19:27:24.000Z"},{"id":1887,"title":"Upgrade People Chain to v2.2.2","track":1,"status":"Executed","proposer":"13TRAXTALwNp5vApqwiE74fg8G8ypMyaF9TxRfs4RwrCwxUE","created_at":"2026-04-23T14:51:24.000Z"},{"id":1886,"title":"Onboarding Bulletin System Parachain (ParaId 1010)","track":1,"status":"Executed","proposer":"1556APd4jcMDRod9SUxfTwGLasqFy3y3QFMGokkBwTdk2tev","created_at":"2026-04-21T20:24:00.000Z"},{"id":1885,"title":"Paseo Testnet Operations H1 2026 - USDC Funding via Multi-Asset Bounty","track":33,"status":"Executed","proposer":"14z2CnmqMX2kcWGp5VT68sovjKXZipjkNUPtaMMnz6cjXW3q","created_at":"2026-04-17T20:35:24.000Z"},{"id":1884,"title":"Please Ignore","track":32,"status":"TimedOut","proposer":"14z2CnmqMX2kcWGp5VT68sovjKXZipjkNUPtaMMnz6cjXW3q","created_at":"2026-04-17T20:30:12.000Z"}],"total_referenda":1904},"meta":{"timestamp":"2026-06-14T08:03:46.169Z","request_id":"a49c6951-063e-4038-854e-7a81124f562a"},"status":"ok","message":"Referenda 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/referendum":{"get":{"operationId":"get_v1_referendum","tags":["Referenda"],"summary":"One referendum in full: aye/nay/support tally, status, track, requested","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Referendum id (omit for the latest)","schema":{"type":"string"},"example":"1000"},{"name":"network","in":"query","required":false,"description":"polkadot or kusama","schema":{"type":"string"},"example":"polkadot"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":1000,"note":"A single OpenGov referendum in full: its aye/nay/support tally (conviction-weighted, converted to the network token), status, governance track, requested treasury amount and proposer. Omit id for the latest referendum.","tally":{"ayes_token":41402170.4086,"nays_token":5000.1,"support_token":10276376.0004},"title":"A Wish for Continuity: Celebrating Polkadot's Core Values","token":"DOT","track":"WishForChange","source":"Polkassembly","status":"TimedOut","network":"polkadot","proposer":"15oQVDJKd4zLzUvkTnan34v1VPRguduo1uEfs9GnvKjD6Yng","created_at":"2024-07-16T13:15:42.000000Z","beneficiary_count":0},"meta":{"timestamp":"2026-06-14T08:03:46.239Z","request_id":"c68712c6-8d08-4ba6-8c70-07a8982233c1"},"status":"ok","message":"Referendum 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":1903,"network":"polkadot","total_referenda":1904},"source":"public Polkassembly API (api.polkassembly.io), keyless","service":"polkadotgov-api","networks":["polkadot","kusama"],"endpoints":{"GET /v1/meta":"This document.","GET /v1/active":"OpenGov referenda currently open for voting (network, limit).","GET /v1/referenda":"Recent OpenGov referenda: track, status, proposer (network, page, limit).","GET /v1/referendum":"One referendum in full: aye/nay/support tally, status, track, requested (network, id; omit id for latest)."},"description":"Read Polkadot and Kusama OpenGov live from the public Polkassembly API: list the most recent referenda with their track, status and proposer; read a single referendum in full with its aye/nay/support tally (converted to DOT/KSM), status, track and requested amount; and browse treasury bounties. Works for both networks via the network parameter. The OpenGov layer for Polkadot/Kusama wallets, governance dashboards and delegates. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:03:46.306Z","request_id":"302470bb-6e48-46fb-b07d-a71a885a4592"},"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":7300,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":960,"monthly_call_quota":139000,"rps_limit":9,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3550,"monthly_call_quota":825000,"rps_limit":22,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":9650,"monthly_call_quota":5150000,"rps_limit":55,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/polkadotgov-api"}