{"openapi":"3.1.0","info":{"title":"Carbon API","version":"1.0.0","description":"Live on-chain data for Carbon (chain id carbon-1) — the Switcheo-built Cosmos-SDK Layer-1 for decentralised derivatives and spot trading, whose native token is SWTH — 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 SWTH, commission rate and jailed flag. The supply endpoint returns the total SWTH 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. SWTH uses an 8-decimal base denomination which is converted to whole SWTH with exact big-integer scaling, 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 DeFi ecosystem. Live keyless upstream. 5 endpoints.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/carbon-api","description":"oanor gateway"}],"tags":[{"name":"Carbon"},{"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":["Carbon"],"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":"Carbon","count":15,"symbol":"SWTH","proposals":[{"id":"425","title":"V2.81.0 Software Upgrade Proposal","status":"PROPOSAL_STATUS_PASSED","submit_time":"2026-05-18T11:22:51.220753085Z","voting_end_time":"2026-05-18T23:22:51.220753085Z"},{"id":"424","title":"V2.80.0 Software Upgrade Proposal","status":"PROPOSAL_STATUS_PASSED","submit_time":"2026-05-08T06:18:47.305998974Z","voting_end_time":"2026-05-09T06:18:47.305998974Z"},{"id":"423","title":"Cancel V2.79.0 Software Upgrade Proposal","status":"PROPOSAL_STATUS_PASSED","submit_time":"2026-05-01T08:59:53.381881406Z","voting_end_time":"2026-05-02T08:59:53.381881406Z"},{"id":"422","title":"V2.79.0 Software Upgrade Proposal","status":"PROPOSAL_STATUS_PASSED","submit_time":"2026-04-30T03:24:01.872841193Z","voting_end_time":"2026-05-01T03:24:01.872841193Z"},{"id":"421","title":"Recover Injective -> Demex IBC client","status":"PROPOSAL_STATUS_PASSED","submit_time":"2026-03-23T07:57:53.005544587Z","voting_end_time":"2026-03-24T07:57:53.005544587Z"},{"id":"420","title":"V2.78.0 Software Upgrade Proposal","status":"PROPOSAL_STATUS_PASSED","submit_time":"2026-03-18T02:57:31.671076502Z","voting_end_time":"2026-03-19T02:57:31.671076502Z"},{"id":"419","title":"V2.77.0 Software Upgrade Proposal","status":"PROPOSAL_STATUS_PASSED","submit_time":"2026-03-03T14:00:42.931953457Z","voting_end_time":"2026-03-04T02:00:42.931953457Z"},{"id":"418","title":"V2.76.0 Software Upgrade Proposal","status":"PROPOSAL_STATUS_PASSED","submit_time":"2026-03-02T05:06:40.988793730Z","voting_end_time":"2026-03-02T17:06:40.988793730Z"},{"id":"417","title":"V2.75.0 Software Upgrade Proposal","status":"PROPOSAL_STATUS_PASSED","submit_time":"2026-02-11T04:35:03.537939115Z","voting_end_time":"2026-02-12T04:35:03.537939115Z"},{"id":"416","title":"V2.74.0 Software Upgrade Proposal","status":"PROPOSAL_STATUS_PASSED","submit_time":"2026-01-27T04:42:27.738226772Z","voting_end_time":"2026-01-28T04:42:27.738226772Z"},{"id":"415","title":"V2.73.0 Software Upgrade Proposal","status":"PROPOSAL_STATUS_PASSED","submit_time":"2025-07-29T20:19:19.631515223Z","voting_end_time":"2025-07-30T20:19:19.631515223Z"},{"id":"414","title":"Recover StaFiHub -> Carbon IBC client","status":"PROPOSAL_STATUS_REJECTED","submit_time":"2025-07-29T00:55:38.053442865Z","voting_end_time":"2025-07-30T00:55:38.053442865Z"},{"id":"413","title":"V2.73.0 Software Upgrade Proposal","status":"PROPOSAL_STATUS_FAILED","submit_time":"2025-07-28T05:49:24.085152275Z","voting_end_time":"2025-07-29T05:49:24.085152275Z"},{"id":"412","title":"V2.72.0 Software Upgrade Proposal","status":"PROPOSAL_STATUS_PASSED","submit_time":"2025-07-02T09:32:16.199606228Z","voting_end_time":"2025-07-02T21:32:16.199606228Z"},{"id":"411","title":"V2.71.0 Software Upgrade Proposal","status":"PROPOSAL_STATUS_PASSED","submit_time":"2025-06-25T13:14:50.423185363Z","voting_end_time":"2025-06-26T01:14:50.423185363Z"}]},"meta":{"timestamp":"2026-06-15T20:40:27.079Z","request_id":"38e012ac-a3cc-4986-8e6e-05f289f0a8ae"},"status":"ok","message":"Carbon 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":["Carbon"],"summary":"Chain status","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"Carbon","source":"Carbon (Switcheo) LCD","symbol":"SWTH","chain_id":"carbon-1","bond_denom":"swth","inflation_pct":0,"latest_block_time":"2026-06-15T20:39:57.527089314Z","latest_block_height":94869259},"meta":{"timestamp":"2026-06-15T20:40:27.173Z","request_id":"b1651d57-8064-4b21-bbb8-3e9db8ad825b"},"status":"ok","message":"Carbon 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":["Carbon"],"summary":"SWTH supply & bonded ratio","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"Carbon","denom":"swth","bonded":477009583.959402,"symbol":"SWTH","decimals":8,"total_supply":1903707576.187886,"bonded_ratio_pct":25.06},"meta":{"timestamp":"2026-06-15T20:40:27.245Z","request_id":"c6c7a98b-77fc-4cfb-a199-451380de3a3a"},"status":"ok","message":"Carbon 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":["Carbon"],"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":"Carbon","count":5,"symbol":"SWTH","validators":[{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":207481317.863914,"moniker":"Switcheo Staking","commission_pct":5,"operator_address":"swthvaloper1hexzxh3apqpqzzchhgynks2xr8ar8qvd58d2u7"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":89398396.447156,"moniker":"Intsol Community Staking 🚀","commission_pct":5.5,"operator_address":"swthvaloper1yyepjpjsrve6vy6l77nk88dtts8la9r3thj7kj"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":84263896.661455,"moniker":"BlockHunters 🎯","commission_pct":5,"operator_address":"swthvaloper1fdqkq5gc5x8h6a0j9hamc30stlvea6zlsh4y7s"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":60467201.109123,"moniker":"Born2Stake ↗️","commission_pct":5,"operator_address":"swthvaloper1z2jz4uhz8zgt4lq9mq5slz3ukyp3grhlr9xv3k"},{"jailed":false,"status":"BOND_STATUS_BONDED","tokens":35398771.877752,"moniker":"Mikasa","commission_pct":5,"operator_address":"swthvaloper1945upvdn2p2sgq7muyhfmygn3fu740jwcfg7fv"}]},"meta":{"timestamp":"2026-06-15T20:40:27.324Z","request_id":"ff6ff44c-d804-44c4-ae97-0a8183423394"},"status":"ok","message":"Carbon 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":"Carbon API","chain":"Carbon","denom":"swth","source":"Carbon public LCD/REST nodes (Cosmos SDK)","symbol":"SWTH","chain_id":"carbon-1","decimals":8,"endpoints":["/v1/status","/v1/validators","/v1/supply","/v1/governance","/v1/meta"],"description":"Live on-chain data for Carbon — the Switcheo-built Cosmos-SDK Layer-1 for decentralised derivatives trading (SWTH).","documentation":"https://carbon-api.oanor.dev"},"meta":{"timestamp":"2026-06-15T20:40:27.401Z","request_id":"ae7754d4-73c3-4c28-83bf-694a55019bd4"},"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":280,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1290,"monthly_call_quota":14900,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3710,"monthly_call_quota":76000,"rps_limit":16,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":8970,"monthly_call_quota":300000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/carbon-api"}