{"openapi":"3.1.0","info":{"title":"Nolus Chain API","version":"1.0.0","description":"Real-time on-chain data for Nolus (chain-id pirin-1), a Cosmos-SDK Layer-1 running a DeFi-lease / money-market protocol, secured by delegated proof-of-stake with NLS as its native coin. The status endpoint returns the chain id, latest block height and time, proposer and node application version so you can confirm the chain is live and producing blocks. The validators endpoint returns the full bonded validator set — each moniker, operator address, stake in NLS, commission rate and jailed flag — sorted by stake, plus the total bonded and not-bonded NLS. The supply endpoint returns the total NLS supply (in NLS and base unls), the bonded amount and the bonded ratio. The governance endpoint returns the most recent on-chain governance proposals with title, status and voting window. The meta endpoint documents the chain, denom and decimals. Reads a live Nolus Cosmos-SDK LCD node directly (with mirror fallback), so values are current to the latest block. Live, nothing stored. 5 endpoints. This serves chain-level staking, supply and governance data; for individual lease positions or token prices use a dedicated protocol/market API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/nolus-api","description":"oanor gateway"}],"tags":[{"name":"Chain"},{"name":"Staking"},{"name":"Governance"},{"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/status":{"get":{"operationId":"get_v1_status","tags":["Chain"],"summary":"Chain status: latest block, chain id, node version","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"Nolus","healthy":true,"chain_id":"pirin-1","native_symbol":"NLS","node_app_version":"0.8.2-patch","proposer_address":"uWETKnIvTpk/U2VWDcIbfE9cdss=","latest_block_time":"2026-06-15T20:38:48.207482324Z","latest_block_height":23873252},"meta":{"timestamp":"2026-06-15T20:40:38.547Z","request_id":"a1db096e-339b-40e8-bd8c-db22f8f035f0"},"status":"ok","message":"Chain status 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":["Staking"],"summary":"Total NLS supply and bonded ratio","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"Nolus","denom":"unls","decimals":6,"bonded_nls":"252131714.447001","native_symbol":"NLS","bonded_ratio_pct":27.41,"total_supply_nls":"919733552.841313","total_supply_unls":"919733552841313"},"meta":{"timestamp":"2026-06-15T20:40:38.626Z","request_id":"5a1f39e4-b736-40cf-8b00-ea8e765fcc94"},"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/validators":{"get":{"operationId":"get_v1_validators","tags":["Staking"],"summary":"Bonded validator set with stake and commission","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"Nolus","validators":[{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Crosnest","tokens_nls":"25511002.352073","tokens_unls":"25511002352073","commission_rate":0.05,"operator_address":"nolusvaloper1ldp9kthjxl6hun23ghlwg5szf297sz5a0pf3xe"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Inter Blockchain Services","tokens_nls":"21812745.745858","tokens_unls":"21812745745858","commission_rate":0.05,"operator_address":"nolusvaloper1767ksp39dlyddeprh5lsxazawpacqpywn4496s"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"polkachu.com","tokens_nls":"21275206.950646","tokens_unls":"21275206950646","commission_rate":0.01,"operator_address":"nolusvaloper1k3wysw06xty072y8pvra2vtwxxc6sjmf4w20sx"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"PRO Delegators","tokens_nls":"20343657.158564","tokens_unls":"20343657158564","commission_rate":0.05,"operator_address":"nolusvaloper17rskjptvphrktvqz3wrnqpeh6gqp825mujae8t"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Architect Nodes","tokens_nls":"17017924.436549","tokens_unls":"17017924436549","commission_rate":0.05,"operator_address":"nolusvaloper1hvhyunq7qvykzvrcnhjj4xnkcla58xuss4n5j4"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"P-OPS Team","tokens_nls":"16872771.479491","tokens_unls":"16872771479491","commission_rate":0.09,"operator_address":"nolusvaloper1dzyw04glsxpczw9yndeuy9hrjf5t9lyhw2sfhv"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Enigma","tokens_nls":"13097826.557969","tokens_unls":"13097826557969","commission_rate":0.05,"operator_address":"nolusvaloper15sj2ep93fe0re8q6mqg3u6pjmhk5jqs6cc5rst"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Stakecito","tokens_nls":"12509430.62752","tokens_unls":"12509430627520","commission_rate":0.05,"operator_address":"nolusvaloper1qe8uuf5x69c526h4nzxwv4ltftr73v7q04pre5"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"01node","tokens_nls":"11588459.745353","tokens_unls":"11588459745353","commission_rate":0.05,"operator_address":"nolusvaloper1vph2mzpcx8a366strk30cg60nznrwy762eteks"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Imperator.co","tokens_nls":"10534930.80724","tokens_unls":"10534930807240","commission_rate":0.05,"operator_address":"nolusvaloper19k3fmww60txaudx92yjg3hcg36hepkzgtqwunc"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"LiveRaveN","tokens_nls":"10079567.88127","tokens_unls":"10079567881270","commission_rate":0.05,"operator_address":"nolusvaloper1vytpvur69pn4f356kmkwwdeqpmr9ymejf4yt5d"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"The_Cybernetics","tokens_nls":"9662698.172146","tokens_unls":"9662698172146","commission_rate":0.05,"operator_address":"nolusvaloper106sz33gddhvve5r3hq4hvyzxakd7ntw9duc6c5"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"HoodRun","tokens_nls":"9467355.87111","tokens_unls":"9467355871110","commission_rate":0.05,"operator_address":"nolusvaloper1zh6d5hvw3khrll6rlrssvy58tmg4kw0va8eqcm"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"NacionCrypto - Parceros","tokens_nls":"9361202.321805","tokens_unls":"9361202321805","commission_rate":0.05,"operator_address":"nolusvaloper1skc8aut895jvg4hdxx7q89sus5x63edey0kvv7"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Coinage x DAIC","tokens_nls":"9032166.28175","tokens_unls":"9032166281750","commission_rate":0.05,"operator_address":"nolusvaloper18qdl4lcjg730yh6edad4jkxg8mw35yh25c4fl4"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"node101","tokens_nls":"8794360.264197","tokens_unls":"8794360264197","commission_rate":0.05,"operator_address":"nolusvaloper1lrzxwu4dmy8030waevcpft7rpxjjz26ctkankx"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"RED PLANET","tokens_nls":"7820863.652194","tokens_unls":"7820863652194","commission_rate":0.05,"operator_address":"nolusvaloper14r3s0vk987n59qdpxgrnwgyagcykkwzc7ah5xz"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Qubelabs","tokens_nls":"6042772.174933","tokens_unls":"6042772174933","commission_rate":0.05,"operator_address":"nolusvaloper1dmgk2jd4epnwtpzah52tp46765s6yy78lcsrqx"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"BlockPro","tokens_nls":"5490741.073528","tokens_unls":"5490741073528","commission_rate":0.02,"operator_address":"nolusvaloper1r8teln3y3gpytffss3xqlzqkys8dpwhez8x2r8"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Solva (CryptoCrew)","tokens_nls":"5325244.884801","tokens_unls":"5325244884801","commission_rate":0.05,"operator_address":"nolusvaloper1nryk8vpd75d2nvld2hej0nfal64qm3wpnt7cg3"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Crypto Lab Tech","tokens_nls":"370112.663798","tokens_unls":"370112663798","commission_rate":0.05,"operator_address":"nolusvaloper1fcwhweq2qtd5aj702v4pj0apfxt8nrgpklhhsk"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Snow Fall","tokens_nls":"64342.767889","tokens_unls":"64342767889","commission_rate":0.05,"operator_address":"nolusvaloper1uhwy40w2jg22m2yup4qepqa420x2tfz0jlk2hw"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Start-Staking.cc","tokens_nls":"42546.576097","tokens_unls":"42546576097","commission_rate":0.05,"operator_address":"nolusvaloper1538xp04gh8fll66vlw0afywy4dlhc2cma85m2a"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Moon Core","tokens_nls":"7336.352117","tokens_unls":"7336352117","commission_rate":0.03,"operator_address":"nolusvaloper12u4s0jmnc9zk8s4l680urgqtctd5rmnzt5j9ep"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"ITpro🚀","tokens_nls":"6447.648103","tokens_unls":"6447648103","commission_rate":0.05,"operator_address":"nolusvaloper1udramq7kkqpq36nkv9lxex5klurdmweffu3nmr"}],"native_symbol":"NLS","bonded_tokens_nls":"252131714.447001","not_bonded_tokens_nls":"39193131.781141","bonded_validator_count":25},"meta":{"timestamp":"2026-06-15T20:40:38.715Z","request_id":"23f074fc-8afe-4d28-b4a9-5f5188036f7d"},"status":"ok","message":"Validators 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/governance":{"get":{"operationId":"get_v1_governance","tags":["Governance"],"summary":"Recent on-chain governance proposals","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"Nolus","count":10,"proposals":[{"id":"333","title":"Close Inactive Market (Osmosis allSOL)","status":"PROPOSAL_STATUS_PASSED","summary":"## Summary This proposal concerns the closure of the Osmosis allSOL market on the Nolus Pirin (mainnet), which has remained inactive and is no longer serving user demand within the Nolus money market. The closure process is structured to en","submit_time":"2026-05-20T10:02:46.279571965Z","voting_end_time":"2026-05-23T10:02:46.279571965Z"},{"id":"332","title":"Close Inactive Market (Osmosis AKT)","status":"PROPOSAL_STATUS_PASSED","summary":"## Summary This proposal concerns the closure of the Osmosis AKT market on the Nolus Pirin (mainnet), which has remained inactive and is no longer serving user demand within the Nolus money market. The closure process is structured to ensur","submit_time":"2026-05-20T09:57:11.607237339Z","voting_end_time":"2026-05-23T09:57:11.607237339Z"},{"id":"331","title":"Delist Neutron-based Gas Denoms","status":"PROPOSAL_STATUS_PASSED","summary":"## Summary Currently, users on the Nolus mainnet have the flexibility to pay gas fees using various assets, including the native token NLS, as well as USDC, ATOM, OSMO, and NTRN. ### Goal This proposal seeks to delist NTRN and USDC deposite","submit_time":"2026-04-14T13:46:27.597036189Z","voting_end_time":"2026-04-17T13:46:27.597036189Z"},{"id":"330","title":"Close Inactive Market (Neutron Noble USDC)","status":"PROPOSAL_STATUS_PASSED","summary":"## Summary This proposal proposes the closure of the Neutron Noble USDC long market due to zero active positions on mainnet and Neutron’s transition to maintenance mode. The closure process is structured to ensure the safe return of user fu","submit_time":"2026-03-30T09:26:44.887322628Z","voting_end_time":"2026-04-02T09:26:44.887322628Z"},{"id":"329","title":"Smart Contract Migration (v0.8.24)","status":"PROPOSAL_STATUS_PASSED","summary":"## Summary As the Nolus network adopts a semi-permissioned blockchain model, contract migrations require governance approval. The Nolus money market architecture is strategically divided into two main components: the platform core and the p","submit_time":"2026-03-24T10:00:49.421174523Z","voting_end_time":"2026-03-27T10:00:49.421174523Z"},{"id":"328","title":"Pin Contract Codes (v0.8.24)","status":"PROPOSAL_STATUS_PASSED","summary":"## Summary Proposal #27 introduced a change to extend the store code permissions, allowing an additional wallet address managed by the Nolus team to store code on-chain without requiring a separate governance proposal. This streamlines the ","submit_time":"2026-03-23T09:20:33.973911466Z","voting_end_time":"2026-03-24T09:20:33.973911466Z"},{"id":"327","title":"Signaling Proposal: Closing Deprecated dATOM and Osmosis axlUSDC Margin Positions","status":"PROPOSAL_STATUS_PASSED","summary":"## Summary This proposal suggests the orderly closure of all remaining margin positions in two deprecated Nolus markets: **dATOM** (from the Neutron Astroport Noble USDC market) and **Osmosis axlUSDC market**. These markets have long been r","submit_time":"2026-03-16T09:11:14.580148754Z","voting_end_time":"2026-03-19T09:11:14.580148754Z"},{"id":"326","title":"Reduce Active Validator Set","status":"PROPOSAL_STATUS_PASSED","summary":"## Summary The Nolus network currently supports a maximum of 40 active validators, with 33 actively participating in network consensus. To enhance network efficiency and optimize block times, we propose reducing the maximum size of the acti","submit_time":"2026-03-09T08:56:12.564580103Z","voting_end_time":"2026-03-12T08:56:12.564580103Z"},{"id":"325","title":"Update Oracle Swap Trees (Long Markets and allBTC Short)","status":"PROPOSAL_STATUS_PASSED","summary":"## Summary This proposal seeks to optimize the Oracle swap trees for the Osmosis USDC long and Osmosis allBTC short protocols, improving the efficiency of swap routes for assets used in margin trading on the Nolus protocol. The key updates ","submit_time":"2026-02-06T07:59:35.889940222Z","voting_end_time":"2026-02-07T07:59:35.889940222Z"},{"id":"324","title":"Update Oracle Swap Tree (Osmosis axlUSDC)","status":"PROPOSAL_STATUS_PASSED","summary":"## Summary This proposal seeks to optimize the Oracle swap tree for the Osmosis axlUSDC protocol, improving the efficiency of swap routes for assets used in margin trading on the Nolus protocol. The key updates are as follows: * **Adjust WB","submit_time":"2025-12-18T09:14:17.418735710Z","voting_end_time":"2025-12-19T09:14:17.418735710Z"}]},"meta":{"timestamp":"2026-06-15T20:40:38.777Z","request_id":"e4084cd2-ce60-40fd-965f-539e93f19ef2"},"status":"ok","message":"Governance 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":"Chain metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"type":"Cosmos-SDK Layer-1 (Tendermint/CometBFT)","chain":"Nolus","denom":"unls","chain_id":"pirin-1","decimals":6,"ecosystem":"Nolus — a Cosmos-SDK Layer-1 DeFi-lease/money-market protocol chain, native coin NLS, secured by delegated proof-of-stake.","endpoints":["/v1/status","/v1/validators","/v1/supply","/v1/governance","/v1/meta"],"documentation":"https://nolus-api.oanor.dev","native_symbol":"NLS"},"meta":{"timestamp":"2026-06-15T20:40:38.869Z","request_id":"3894fd0f-a9fd-44f4-9e6e-2f04c0427d55"},"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":270,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1290,"monthly_call_quota":23500,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3460,"monthly_call_quota":121000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7640,"monthly_call_quota":545000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/nolus-api"}