{"openapi":"3.1.0","info":{"title":"BitSong Chain API","version":"1.0.0","description":"Real-time on-chain data for BitSong (chain-id bitsong-2b), a Cosmos-SDK Layer-1 built for the music industry — music NFTs, artist fan tokens and streaming — with BTSG as its native coin, secured by delegated proof-of-stake. 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 BTSG, commission rate and jailed flag — sorted by stake, plus the total bonded and not-bonded BTSG. The supply endpoint returns the total BTSG supply (in BTSG and base ubtsg), 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 BitSong 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 fan tokens or music NFTs use a dedicated indexer API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/bitsong-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":"BitSong","healthy":true,"chain_id":"bitsong-2b","native_symbol":"BTSG","node_app_version":"0.23.0-1-g7c77a88e","proposer_address":"37ZXyECXvlORn/+JuAD4YUfymO0=","latest_block_time":"2026-06-15T20:40:02.009529616Z","latest_block_height":28512920},"meta":{"timestamp":"2026-06-15T20:40:33.848Z","request_id":"5b7be0ba-e73b-48b7-b893-0c0960639c77"},"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 BTSG supply and bonded ratio","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"BitSong","denom":"ubtsg","decimals":6,"bonded_btsg":"56148654.314978","native_symbol":"BTSG","bonded_ratio_pct":26.83,"total_supply_btsg":"209221193.404237","total_supply_ubtsg":"209221193404237"},"meta":{"timestamp":"2026-06-15T20:40:33.940Z","request_id":"c8f648a3-47f8-46a0-8067-20b98c9cf2f6"},"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":"BitSong","validators":[{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Kintsugi Nodes (ITA)","tokens_btsg":"7599892.035999","tokens_ubtsg":"7599892035999","commission_rate":0.05,"operator_address":"bitsongvaloper1fkj2cn209yeexxyets98evrcmmds23hck0lyzq"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"KalpaTech","tokens_btsg":"7152443.436579","tokens_ubtsg":"7152443436579","commission_rate":0.1,"operator_address":"bitsongvaloper19ah9302mh80pvv5zeztdr6qcqk6z52frn6rjj5"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"BlueStake 🚀 | 100% insurance","tokens_btsg":"6645267.432611","tokens_ubtsg":"6645267432611","commission_rate":0.05,"operator_address":"bitsongvaloper1mceksy7l3xenuyx4dzl64erf3fh29a3r2ercnz"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"CommunityStaking","tokens_btsg":"2750599.101607","tokens_ubtsg":"2750599101607","commission_rate":0.05,"operator_address":"bitsongvaloper1zugs5wtmt98949msgwchawr5cal7h32s8na0r9"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Validatrium.com","tokens_btsg":"2462091.24517","tokens_ubtsg":"2462091245170","commission_rate":0.1,"operator_address":"bitsongvaloper10fg3yklae97g8ueh5ut29mlwz8fdr6z8zrak6x"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"polkachu.com","tokens_btsg":"2446603.341541","tokens_ubtsg":"2446603341541","commission_rate":0.05,"operator_address":"bitsongvaloper1a5vh93eahq526fnv7ymyf0xsgpulvlwneusqm0"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"CosmosDrops","tokens_btsg":"2394283.77616","tokens_ubtsg":"2394283776160","commission_rate":0.05,"operator_address":"bitsongvaloper1qyc9ccfx7clj0kswgjz6cdf5f4n6v4nyeudy8q"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"ChainTools","tokens_btsg":"2167475.059912","tokens_ubtsg":"2167475059912","commission_rate":0.05,"operator_address":"bitsongvaloper1x2slrjfmgxq7qx3xwmsjue73t5ynmwy7jgpdtr"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Bitveil","tokens_btsg":"1798130.364547","tokens_ubtsg":"1798130364547","commission_rate":0.12,"operator_address":"bitsongvaloper1rg53d06r0k0h7w7mvacmapzsjahkp5rd35a5ff"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Safe Block","tokens_btsg":"1742973.13841","tokens_ubtsg":"1742973138410","commission_rate":0.05,"operator_address":"bitsongvaloper1fgmzy5rtvvnxzy0vn54mz9k5xndzt2afepyye3"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"🐹 Quokka Stake","tokens_btsg":"1656083.481102","tokens_ubtsg":"1656083481102","commission_rate":0.05,"operator_address":"bitsongvaloper14rvn7anf22e00vj5x3al4w50ns78s7n42rc0ge"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Architect Nodes","tokens_btsg":"1653887.690937","tokens_ubtsg":"1653887690937","commission_rate":0.05,"operator_address":"bitsongvaloper1yvwl7h6eek0j35ekeyz38a0wyfd4anrrgvnlez"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"dimi","tokens_btsg":"1407605.315419","tokens_ubtsg":"1407605315419","commission_rate":0.1,"operator_address":"bitsongvaloper1dmmupr5qqy07sksct3au8tx9vuh224vg53fl6x"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Rundax","tokens_btsg":"1236417.445749","tokens_ubtsg":"1236417445749","commission_rate":0.1,"operator_address":"bitsongvaloper1wtf99e8l5k2yxxc0rj6xwxj7mfam9hfnjqznja"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Thamar","tokens_btsg":"1163935.162267","tokens_ubtsg":"1163935162267","commission_rate":0.1,"operator_address":"bitsongvaloper1d9mue6sxrxgcd8rz6cdmeamw4cey3c243ll3gj"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"AGFinance","tokens_btsg":"1123473.837595","tokens_ubtsg":"1123473837595","commission_rate":0.05,"operator_address":"bitsongvaloper1qf8ywssvfum5zj3jrp354875ay2flpsj7mmvt8"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Oldcat","tokens_btsg":"1120397.48825","tokens_ubtsg":"1120397488250","commission_rate":0.05,"operator_address":"bitsongvaloper1pqlxe507avzg2hq8ylcju037ywyh3myfsv9wln"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Noderunners","tokens_btsg":"1088622.335723","tokens_ubtsg":"1088622335723","commission_rate":0.07,"operator_address":"bitsongvaloper12xtuwyt599dv57y7v007qpp230ph3utkssnx7n"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"🔥STAVR🔥 REStake ON✅","tokens_btsg":"966070.743694","tokens_ubtsg":"966070743694","commission_rate":0.1,"operator_address":"bitsongvaloper1c5p4sqgz5jslpywsk5c0nasqqjfucv9lvjlnry"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"MathNodes","tokens_btsg":"961418.319051","tokens_ubtsg":"961418319051","commission_rate":0.08,"operator_address":"bitsongvaloper1gqmqvy2pnuca3gjldsna49t8vmf88lf9azp4gy"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"KJINC.io","tokens_btsg":"854677.663831","tokens_ubtsg":"854677663831","commission_rate":0.1,"operator_address":"bitsongvaloper10uv3t6yru5dryz2yy9em2pzmqezyhsp0gkkxd2"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"AlxVoy ⚡ ANODE.TEAM","tokens_btsg":"791104.275208","tokens_ubtsg":"791104275208","commission_rate":0.1,"operator_address":"bitsongvaloper138zp40g5pnjg4e7a24j5035q2f7nzwfec8ruee"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"PowerStaking","tokens_btsg":"733970.825317","tokens_ubtsg":"733970825317","commission_rate":0.08,"operator_address":"bitsongvaloper1wcvhw2ts80ywk3avd9ad8qmrwaeqwmkpg2shxz"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Stake.Works | Bitsong","tokens_btsg":"708222.27509","tokens_ubtsg":"708222275090","commission_rate":0.075,"operator_address":"bitsongvaloper1sqw7f6vcs9wg9h9j0t05e592sg6y8eldcdq3vd"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"cyberG","tokens_btsg":"696748.4737","tokens_ubtsg":"696748473700","commission_rate":0.1,"operator_address":"bitsongvaloper1mx3gct8chrssamkdfw8fkrdl93knllryalmxpm"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"TdrSys | Auto-Compound","tokens_btsg":"679070.145339","tokens_ubtsg":"679070145339","commission_rate":0.08,"operator_address":"bitsongvaloper1wqcqfm499f84cjnppqu03jrkqtwqsndpw9qxc5"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"bonded.zone ⚡","tokens_btsg":"615693.034349","tokens_ubtsg":"615693034349","commission_rate":0.1,"operator_address":"bitsongvaloper1pkepjd307346zadmlxpvs9wqrghkx735v0ehge"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"👋 79anvi 🍀","tokens_btsg":"579332.0761","tokens_ubtsg":"579332076100","commission_rate":0.1,"operator_address":"bitsongvaloper1wusnupm08xwe05zgvk6frqjuxak6q5ang5jppk"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Alex (Bambarello) Validator","tokens_btsg":"261629.823653","tokens_ubtsg":"261629823653","commission_rate":0.1,"operator_address":"bitsongvaloper1ul49tmtdq3rlurss39kjf3m8a0dtehwyte6jfp"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Bit Cat🐱","tokens_btsg":"226557.539005","tokens_ubtsg":"226557539005","commission_rate":0.1,"operator_address":"bitsongvaloper1zuc0kljzv5mutgk0ddufp4vgvpy04dhz07dlxp"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"do not stake","tokens_btsg":"188200.553299","tokens_ubtsg":"188200553299","commission_rate":0.05,"operator_address":"bitsongvaloper1xv3kjgzr8gxuy5ejyzurut4x4g7d09xc82vqv4"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Elon_Nodes ♪ The_Beat_Verifier","tokens_btsg":"141083.507632","tokens_ubtsg":"141083507632","commission_rate":0.2,"operator_address":"bitsongvaloper1ynj2u9x0pgq6gx38pllwrg7948l9yp9lr05zc4"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"stakr.nl","tokens_btsg":"50459.54607","tokens_ubtsg":"50459546070","commission_rate":0.1,"operator_address":"bitsongvaloper1zvn0sdu05s0qnz5c63e7jlrfg50pe5yejqlyqy"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"SUNREN 🐳 | BROXA ⚛️😸","tokens_btsg":"43116.208085","tokens_ubtsg":"43116208085","commission_rate":0.05,"operator_address":"bitsongvaloper1zy9xd2lz6df6gf55nq0ldase9sxtxlksdvfum2"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"GOAT V 🐐🚀","tokens_btsg":"40288.615977","tokens_ubtsg":"40288615977","commission_rate":0.05,"operator_address":"bitsongvaloper154327a0ud04jtdecac8uhecmnz3kqdueqtevmc"},{"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"MIPEnode","tokens_btsg":"829","tokens_ubtsg":"829000000","commission_rate":0.1,"operator_address":"bitsongvaloper18gqxvxeess8atkxcctgzykru4da4r6paa5p6ak"}],"native_symbol":"BTSG","bonded_tokens_btsg":"56148654.314978","bonded_validator_count":36,"not_bonded_tokens_btsg":"27958891.988349"},"meta":{"timestamp":"2026-06-15T20:40:34.039Z","request_id":"6997d185-3543-43cc-be6c-f169aede16ef"},"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":"BitSong","count":10,"proposals":[{"id":"46","title":"Upgrade v0.24.0 - Jimi","status":"PROPOSAL_STATUS_REJECTED","summary":"Upgrades latest versions of wasmvm, ibc-go, and cosmos-sdk. Full upgrade details can be found here: https://github.com/bitsongofficial/go-bitsong/pull/292","submit_time":"2025-10-11T08:14:28.058997063Z","voting_end_time":"2025-10-18T08:29:43.618547316Z"},{"id":"45","title":"Software Upgrade: v023 - Gauss","status":"PROPOSAL_STATUS_PASSED","summary":"Disables external community pool feature, transfers funds in protocolpool accounts back into distribution module","submit_time":"2025-06-23T05:04:30.226828440Z","voting_end_time":"2025-06-24T08:26:57.831099020Z"},{"id":"44","title":"v022 - Nina","status":"PROPOSAL_STATUS_PASSED","summary":"Upgrades to latest cosmos-sdk version, resolves crisis invariants for missing slash events in x/distribution.","submit_time":"2025-05-11T01:05:24.076906392Z","voting_end_time":"2025-05-18T01:05:24.076906392Z"},{"id":"43","title":"software upgrade: v021","status":"PROPOSAL_STATUS_PASSED","summary":"Upgrades to the latest version of go-bitsong. Full upgrade guide can be found here: https://github.com/bitsongofficial/networks/blob/master/bitsong-2b/upgrades/v0.21.0/guide.md","submit_time":"2025-02-05T17:39:04.618369482Z","voting_end_time":"2025-02-12T17:39:04.618369482Z"},{"id":"42","title":"Upgrade V020: patch v018","status":"PROPOSAL_STATUS_PASSED","summary":"Upgrades to v0.20.2, resolves a bug that was introduced after v0.18 upgrade. https://github.com/permissionlessweb/networks/blob/v019-prep/bitsong-2b/upgrades/v0.20.0/guide.md","submit_time":"2024-12-22T09:34:47.445448235Z","voting_end_time":"2024-12-29T09:43:00.994588187Z"},{"id":"41","title":"v0.18.0","status":"PROPOSAL_STATUS_PASSED","summary":"upgrade guide: https://github.com/permissionlessweb/networks/blob/master/testnet/upgrades/v0.18.0/guide.md","submit_time":"2024-11-22T04:12:45.351041826Z","voting_end_time":"2024-11-29T04:12:45.351041826Z"},{"id":"40","title":"Authorize Bitsong Account Deployment","status":"PROPOSAL_STATUS_PASSED","summary":"This proposal adds (bitsong13hmdq0slwmff7sej79kfa8mgnx4rl46nj2fvmlgu6u32tz6vfqesdfq4vm) to the list of addresses authorized to upload wasm code to Bitsong.","submit_time":"2024-09-24T13:00:58.419292664Z","voting_end_time":"2024-10-01T13:00:58.419292664Z"},{"id":"39","title":"Recognize SubDAO: Bitsong Account Deployment SubDAO","status":"PROPOSAL_STATUS_PASSED","summary":"This proposal will recognize the Bitsong Accounts Deployment SubDAO as an official subDAO of Bitsong. The first two members of the subDAO are: - bitsong1mxascwuvua9xemxe9k9qxgaexpdnzm098c06np one of the existing address with contract upload","submit_time":"2024-09-13T20:10:27.575885553Z","voting_end_time":"2024-09-20T20:10:27.575885553Z"},{"id":"38","title":"BitSong v0.16.0","status":"PROPOSAL_STATUS_PASSED","summary":"# BitSong v0.16.0 Upgrade Proposal This is the proposed upgrade for the BitSong Network to version `v0.16.0`. The scheduled block height for this upgrade to take place is `18,310,250`, which is estimated to occur on `Aug 20th, 2024 at 15:30","submit_time":"2024-08-09T11:05:57.678606964Z","voting_end_time":"2024-08-17T10:36:57.222498075Z"},{"id":"37","title":"Authorize DAO DAO Deployment","status":"PROPOSAL_STATUS_PASSED","summary":"[Proposal #36](https://daodao.zone/dao/bitsong/proposals/36) is live, requesting funding for a DAO DAO deployment on BitSong. In order to bring DAOs to BitSong sooner, this proposal parallelizes the second step of the deployment process, wh","submit_time":"2024-06-13T18:13:19.793056818Z","voting_end_time":"2024-06-20T18:22:32.532054110Z"}]},"meta":{"timestamp":"2026-06-15T20:40:34.138Z","request_id":"731de434-8f3d-4e92-a53a-b1bfe289373f"},"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":"BitSong","denom":"ubtsg","chain_id":"bitsong-2b","decimals":6,"ecosystem":"BitSong — a Cosmos-SDK Layer-1 for the music industry (music NFTs, fan tokens, streaming), native coin BTSG, secured by delegated proof-of-stake.","endpoints":["/v1/status","/v1/validators","/v1/supply","/v1/governance","/v1/meta"],"documentation":"https://bitsong-api.oanor.dev","native_symbol":"BTSG"},"meta":{"timestamp":"2026-06-15T20:40:34.229Z","request_id":"517837a7-1003-4f37-9b7c-fac9e1f3d031"},"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":250,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1230,"monthly_call_quota":21300,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3260,"monthly_call_quota":114000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":7290,"monthly_call_quota":512000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/bitsong-api"}