{"openapi":"3.1.0","info":{"title":"Cosmos Chain API","version":"1.0.0","description":"Read the live economic state of any Cosmos SDK chain from public LCD/REST endpoints — no key — across the Cosmos Hub, Osmosis, Celestia, Injective, Juno and dozens more via one chain parameter. The staking endpoint returns the network's bonded and unbonded tokens, the bonded ratio (how much of the supply is securing the chain) and its current inflation; the governance endpoint returns the latest on-chain proposals with their status and voting timeline; and the supply endpoint returns the total supply of the chain's staking token plus its community pool. Distinct from validator- and account-level APIs: this is the chain-economics and governance layer for Cosmos wallets, stakers, dashboards, validators and analytics. Live; short cache only.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/cosmoschain-api","description":"oanor gateway"}],"tags":[{"name":"Cosmos"},{"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/governance":{"get":{"operationId":"get_v1_governance","tags":["Cosmos"],"summary":"Latest governance proposals (optional status=voting)","description":"","parameters":[{"name":"chain","in":"query","required":false,"description":"Chain name","schema":{"type":"string"},"example":"cosmoshub"},{"name":"status","in":"query","required":false,"description":"Filter: voting (only active) or all","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"How many (1-50)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The chain's most recent governance proposals (newest first). Pass status=voting to get only proposals currently in the voting period.","chain":"cosmoshub","count":10,"filter":"all","source":"Cosmos LCD","proposals":[{"id":"1042","title":"✅ Gaia v27.4.0 - 💎$ATOM Airdrop ⭐","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2026-06-06T12:43:30.381715995Z","total_deposit":[{"denom":"uatom","amount":"500000000"}],"voting_end_time":"2026-06-13T12:43:30.381715995Z"},{"id":"1041","title":"Gaia v27.4.0 Upgrade","status":"PROPOSAL_STATUS_PASSED","submit_time":"2026-06-02T14:32:19.685688321Z","total_deposit":[{"denom":"uatom","amount":"500000000"}],"voting_end_time":"2026-06-09T14:39:57.339562365Z"},{"id":"1040","title":"💎ATOM Airdrop ✅ - Play & WIN Airdrops ⭐ 2026","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2026-05-30T15:40:19.979902551Z","total_deposit":[{"denom":"uatom","amount":"500000000"}],"voting_end_time":"2026-06-06T15:40:19.979902551Z"},{"id":"1039","title":"$ATOM Halving is Coming: Path to $50? 🚀","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2026-05-29T19:29:00.769390348Z","total_deposit":[{"denom":"uatom","amount":"500000000"}],"voting_end_time":"2026-06-05T19:29:00.769390348Z"},{"id":"1038","title":"💰 $FREE AIRDROP ✅  - 💎$ATOM Airdrop Available ⭐","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2026-05-23T13:32:59.915966168Z","total_deposit":[{"denom":"uatom","amount":"500000000"}],"voting_end_time":"2026-05-30T13:32:59.915966168Z"},{"id":"1037","title":"💳 New Cosmos Credit Card ⭐","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2026-05-15T20:31:42.058042531Z","total_deposit":[{"denom":"uatom","amount":"500000000"}],"voting_end_time":"2026-05-22T20:31:42.058042531Z"},{"id":"1036","title":"🚀Claim Reward: 💎$ATOM Airdrop ✅ Play & Win ⭐","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2026-05-12T16:59:27.481518069Z","total_deposit":[{"denom":"uatom","amount":"500000000"}],"voting_end_time":"2026-05-19T16:59:27.481518069Z"},{"id":"1035","title":"Gaia v27.3.0 Upgrade","status":"PROPOSAL_STATUS_PASSED","submit_time":"2026-05-12T13:57:29.223108183Z","total_deposit":[{"denom":"uatom","amount":"500000000"}],"voting_end_time":"2026-05-19T13:59:27.487520680Z"},{"id":"1034","title":"🚀 Claim the Exclusive $ATOM Airdrop Now! 💎","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2026-05-10T18:45:17.845749924Z","total_deposit":[{"denom":"uatom","amount":"500000000"}],"voting_end_time":"2026-05-17T18:45:17.845749924Z"},{"id":"1033","title":"💎$ATOM Airdrop ✅ New Airdrop ⭐","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2026-05-08T20:10:38.890035624Z","total_deposit":[{"denom":"uatom","amount":"500000000"}],"voting_end_time":"2026-05-15T20:10:38.890035624Z"}],"gov_version":"v1"},"meta":{"timestamp":"2026-06-14T08:03:55.249Z","request_id":"b6180a19-f6ec-4a61-ba02-a5985770a49c"},"status":"ok","message":"Governance 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/staking":{"get":{"operationId":"get_v1_staking","tags":["Cosmos"],"summary":"Bonded/unbonded tokens, bonded ratio, inflation","description":"","parameters":[{"name":"chain","in":"query","required":false,"description":"Chain name (cosmoshub, osmosis, celestia, injective...)","schema":{"type":"string"},"example":"cosmoshub"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Network staking state: bonded vs not-bonded tokens (in the chain's base denom), the bonded ratio, and current inflation. Some chains do not run the mint module, so inflation can be null.","chain":"cosmoshub","source":"Cosmos LCD","inflation":0.1,"bond_denom":"uatom","bonded_ratio":0.9527149386940329,"bonded_tokens":"320640054024365","inflation_pct":10,"max_validators":200,"unbonding_time":"1814400s","not_bonded_tokens":"15913978038881"},"meta":{"timestamp":"2026-06-14T08:03:55.441Z","request_id":"6059e2ff-f903-4ed7-973b-26761e45a70b"},"status":"ok","message":"Staking 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/supply":{"get":{"operationId":"get_v1_supply","tags":["Cosmos"],"summary":"Total supply of the staking denom + community pool","description":"","parameters":[{"name":"chain","in":"query","required":false,"description":"Chain name","schema":{"type":"string"},"example":"cosmoshub"},{"name":"denom","in":"query","required":false,"description":"Override denom (defaults to staking denom)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Total supply of the chain's staking/base denom and the amount in its community pool (raw integer amounts in the base denom).","chain":"cosmoshub","denom":"uatom","source":"Cosmos LCD","total_supply":"513975642561317","community_pool":"10442400074534.445770926332304818"},"meta":{"timestamp":"2026-06-14T08:03:55.615Z","request_id":"c2d88938-871a-4748-8d60-e1fee7a356ac"},"status":"ok","message":"Supply 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 & live sample","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"chain":"cosmoshub","bonded_ratio":0.9527149386940329},"source":"public Cosmos LCD/REST (cosmos.directory proxy), keyless","service":"cosmoschain-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/supply":"Total supply of the staking denom + community pool (chain, optional denom).","GET /v1/staking":"Bonded/unbonded tokens, bonded ratio, inflation (chain=cosmoshub).","GET /v1/governance":"Latest governance proposals, optional status=voting (chain, limit)."},"description":"Read the live economic state of any Cosmos SDK chain from public LCD/REST: staking (bonded/unbonded, bonded ratio, inflation), governance proposals, and token supply + community pool — across Cosmos Hub, Osmosis, Celestia, Injective, Juno and more via one chain parameter. The chain-economics and governance layer for Cosmos wallets, stakers and dashboards. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:03:55.688Z","request_id":"b02ba8f8-f44a-4ef9-831c-4ce56b62ccf2"},"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":6400,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":950,"monthly_call_quota":122000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3450,"monthly_call_quota":748000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":9800,"monthly_call_quota":4720000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/cosmoschain-api"}