{"openapi":"3.1.0","info":{"title":"Desmos API","version":"1.0.0","description":"Live on-chain data for Desmos (chain id desmos-mainnet) — the Cosmos-SDK Layer-1 purpose-built for decentralised social networking, whose native token is DSM — served directly from public LCD/REST nodes with multi-node failover. The status endpoint returns the latest block height and time, chain id, the staking bond denom and the current minting inflation rate. The validators endpoint lists the active bonded validator set ranked by stake, each with its moniker, operator address, self-plus-delegated DSM, commission rate and jailed flag. The supply endpoint returns the total DSM supply, the amount bonded in staking and the resulting bonded ratio. The governance endpoint returns the most recent on-chain proposals with their id, title, status and voting window. Token amounts are converted from base micro-DSM (6 decimals) into whole DSM, and every figure is read live from the chain — nothing bundled or modelled — behind a short server-side cache with keep-warm so the feed stays fast and fresh. Ideal for staking dashboards, validator and delegator tooling, explorers, governance trackers and portfolio or analytics apps across the Cosmos and decentralised-social ecosystem. Live keyless upstream. 5 endpoints.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/desmos-api","description":"oanor gateway"}],"tags":[{"name":"Desmos"},{"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":["Desmos"],"summary":"Recent governance proposals","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max proposals to return (1-50)","schema":{"type":"string"},"example":"15"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"Desmos","count":15,"symbol":"DSM","proposals":[{"id":"50","title":"Recover IBC client to Osmosis","status":"PROPOSAL_STATUS_PASSED","submit_time":"2026-01-04T18:04:14.436515792Z","voting_end_time":"2026-01-11T18:04:14.436515792Z"},{"id":"49","title":"Signal Proposal to Shut Down Desmos Chain","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2024-05-23T23:24:34.702812113Z","voting_end_time":"2024-05-30T23:24:34.702812113Z"},{"id":"48","title":"Desmos v7.1.0 upgrade","status":"PROPOSAL_STATUS_PASSED","submit_time":"2024-04-26T15:02:57.190911153Z","voting_end_time":"2024-05-03T15:42:28.070816145Z"},{"id":"46","title":"Community Spend Proposal","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2024-04-22T00:03:51.478395503Z","voting_end_time":"2024-04-29T00:03:51.478395503Z"},{"id":"45","title":"💎ATOM Airdrop ✅  - Cosmos Hub Proposal ⭐","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2024-04-15T14:49:18.042518838Z","voting_end_time":"2024-04-22T14:49:18.042518838Z"},{"id":"44","title":"💎ATOM Airdrop ✅ ","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2024-04-01T03:03:02.088054423Z","voting_end_time":"2024-04-08T03:03:02.088054423Z"},{"id":"43","title":"Parameter Change Proposal for Sub 3-Second Block Time","status":"PROPOSAL_STATUS_PASSED","submit_time":"2024-02-25T23:31:26.849230126Z","voting_end_time":"2024-03-05T14:41:28.949594343Z"},{"id":"42","title":"Desmos v7 upgrade","status":"PROPOSAL_STATUS_PASSED","submit_time":"2024-02-20T13:44:20.219830920Z","voting_end_time":"2024-02-28T08:38:07.624289459Z"},{"id":"41","title":"Signalling Proposal to Achieve Sub 3-Second Block Time for Enhanced User Experience","status":"PROPOSAL_STATUS_PASSED","submit_time":"2024-02-07T00:49:33.394281016Z","voting_end_time":"2024-02-16T20:59:03.237071554Z"},{"id":"40","title":"💎ATOM Airdrop ✅ 2024 New Version! ⭐","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2024-01-23T09:31:55.360001819Z","voting_end_time":"2024-01-30T09:31:55.360001819Z"},{"id":"39","title":"💎Atom Airdrop ✅ ","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2024-01-07T21:25:06.403448677Z","voting_end_time":"2024-01-14T21:25:06.403448677Z"},{"id":"38","title":"/cosmos.distribution.v1beta1.MsgUpdateParams","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2023-12-02T23:49:20.210854362Z","voting_end_time":"2023-12-09T23:49:20.210854362Z"},{"id":"37","title":"💎Celestia Airdrop ✅ Desmos Proposal","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2023-11-18T03:28:21.030193597Z","voting_end_time":"2023-11-25T03:28:21.030193597Z"},{"id":"36","title":"Desmos v6.2.0 upgrade","status":"PROPOSAL_STATUS_PASSED","submit_time":"2023-11-13T16:38:33.042652712Z","voting_end_time":"2023-11-20T16:47:31.411939438Z"},{"id":"35","title":"💎$Desmos Airdrop✅","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2023-11-03T02:50:52.591191873Z","voting_end_time":"2023-11-10T02:50:52.591191873Z"}]},"meta":{"timestamp":"2026-06-15T20:40:24.211Z","request_id":"3da1f82c-1e52-49be-a1fb-9feb3a83a101"},"status":"ok","message":"Desmos governance retrieved","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/status":{"get":{"operationId":"get_v1_status","tags":["Desmos"],"summary":"Chain status","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"Desmos","source":"Desmos LCD","symbol":"DSM","chain_id":"desmos-mainnet","bond_denom":"udsm","inflation_pct":3,"latest_block_time":"2026-06-15T20:40:20.401242640Z","latest_block_height":29367826},"meta":{"timestamp":"2026-06-15T20:40:24.475Z","request_id":"61769ff0-c8d4-4acf-8052-4aebce62b7a4"},"status":"ok","message":"Desmos status retrieved","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":["Desmos"],"summary":"DSM supply & bonded ratio","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"Desmos","denom":"udsm","bonded":74976502.600703,"symbol":"DSM","decimals":6,"total_supply":192522452.203756,"bonded_ratio_pct":38.94},"meta":{"timestamp":"2026-06-15T20:40:24.719Z","request_id":"72e2d801-843b-4bd6-a72c-d7588c4020ae"},"status":"ok","message":"Desmos supply retrieved","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/validators":{"get":{"operationId":"get_v1_validators","tags":["Desmos"],"summary":"Active validator set","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max validators to return (1-300)","schema":{"type":"string"},"example":"100"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"Desmos","count":20,"symbol":"DSM","validators":[{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":18816531.53392,"moniker":"Apollo","commission_pct":100,"operator_address":"desmosvaloper17lca9smrdlwkznr92hypzrgsjkelnxeaacgrwq"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":17182728.449672,"moniker":"Athena","commission_pct":100,"operator_address":"desmosvaloper10m2n5g7ekune734su9sepyn2898cgv5emec320"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":14026777.30363,"moniker":"Poseidon","commission_pct":100,"operator_address":"desmosvaloper16fc5kd5d4f5sjq5wz3v8gkyk4xd8f7hrrtz2vu"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":11037929.210162,"moniker":"Artemis","commission_pct":100,"operator_address":"desmosvaloper1l9zft6jwgn25tyjl4ry8jyyy67lng49cdpxmk9"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":2788913.385175,"moniker":"KysenPool","commission_pct":5,"operator_address":"desmosvaloper15frwdukqwlenk0sn69haacnce3kcnyjqywnvcn"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":2652565.830092,"moniker":"BlueStake 🚀 | 100% insurance","commission_pct":5,"operator_address":"desmosvaloper19c6nnp6afxj82ehxtlejyvg6zh58050jcgpdj6"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":2639278.555124,"moniker":"Hestia","commission_pct":100,"operator_address":"desmosvaloper1qphe4pmnwejf8mp2vxnrkmya9vg9k3yrt8x90z"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":967663.235544,"moniker":"Oldcat","commission_pct":5,"operator_address":"desmosvaloper1d6xe3ldswgaurszrp3emspvhspvu7hxm4ty8mv"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":722322.539413,"moniker":"node101","commission_pct":5,"operator_address":"desmosvaloper1y6j0ych2elrxsqmxg5z39svtdlnkcxql4wvclc"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":608260.268702,"moniker":"GStake","commission_pct":10,"operator_address":"desmosvaloper1gupgnsfgvs08watwtfdl4a5r9589cus3f36mhz"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":591352.795955,"moniker":"wombat","commission_pct":8,"operator_address":"desmosvaloper17yx9jullk7enj8rtsqz6zsaze0wnnxqmfwrxq4"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":551065.049651,"moniker":"OtterSync","commission_pct":5,"operator_address":"desmosvaloper1l4jcvzaluyjlutyd9fuuw55zvmh25wq9ycluky"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":509622.771965,"moniker":"medium","commission_pct":8,"operator_address":"desmosvaloper1qlh47ty9ah2d5e0xq6gsvqjvfulljl9602k7f9"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":492360.139484,"moniker":"Consensus One","commission_pct":5,"operator_address":"desmosvaloper18yazgsq8yvn2f8c734fmnu2ssfrzpw7l8tqckm"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":431097.50693,"moniker":"Kalia Network","commission_pct":5,"operator_address":"desmosvaloper168g8tlyghyz38ytl63ucvfgsfwc5r66kdwrvhw"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":376662.740743,"moniker":"OasisNodes.com - Desmos","commission_pct":5,"operator_address":"desmosvaloper10wlzyl5pfm6qfzg9mr73u9jwv9gx595z4kc9ae"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":289425.321997,"moniker":"GOAT 🐐 V 🚀","commission_pct":5,"operator_address":"desmosvaloper1vxjj7hncjzttersdhf94dq2pxc0ux4znpfegqf"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":206690.417431,"moniker":"StakeAngle","commission_pct":8,"operator_address":"desmosvaloper13utsw9fzz3nh7hyq4lv9kut25dcs0z6pdfydc3"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":72570.416766,"moniker":"bonded.zone ⚡","commission_pct":10,"operator_address":"desmosvaloper13has6wzwyfyuq6r9j48cwugl6ajqw44gv0fa6k"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":12685.128347,"moniker":"# 0xR4sc4L","commission_pct":100,"operator_address":"desmosvaloper13lcwraxdnelw39jwqr0p9l4m0jph976ahxlkhq"}]},"meta":{"timestamp":"2026-06-15T20:40:25.000Z","request_id":"be852ae1-b50f-4086-925b-51258da9cb4b"},"status":"ok","message":"Desmos validators retrieved","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":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"api":"Desmos API","chain":"Desmos","denom":"udsm","source":"Desmos public LCD/REST nodes (Cosmos SDK)","symbol":"DSM","chain_id":"desmos-mainnet","decimals":6,"endpoints":["/v1/status","/v1/validators","/v1/supply","/v1/governance","/v1/meta"],"description":"Live on-chain data for Desmos — the Cosmos-SDK Layer-1 for decentralised social networking (DSM).","documentation":"https://desmos-api.oanor.dev"},"meta":{"timestamp":"2026-06-15T20:40:25.088Z","request_id":"264eb0e3-ff0a-47df-a0c1-c2d3330d88d4"},"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":310,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1330,"monthly_call_quota":14600,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3780,"monthly_call_quota":79000,"rps_limit":16,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":9120,"monthly_call_quota":320000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/desmos-api"}