{"openapi":"3.1.0","info":{"title":"Celestia API","version":"1.0.0","description":"Live on-chain data from the Celestia network (TIA), the first modular data-availability blockchain, a proof-of-stake chain secured by delegated staking: an address's liquid TIA balance, total delegated (staked) TIA and pending staking rewards; the active validator set ranked by voting power with each validator's staked TIA, commission and status; a block's height, time, proposer and transaction count; and the live network economy — tip height, total TIA supply, bonded TIA and staking ratio.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/celestia-api","description":"oanor gateway"}],"tags":[{"name":"Network"},{"name":"Account"},{"name":"Validators"},{"name":"Block"},{"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/network":{"get":{"operationId":"get_v1_network","tags":["Network"],"summary":"Live Celestia chain economy: supply, bonded, staking ratio","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"celestia","source":"Celestia","chain_id":"celestia","tip_time":"2026-06-10T14:01:28.104462034Z","bonded_tia":506936382.416317,"tip_height":11470462,"native_token":"TIA","total_supply_tia":1170342566.687279,"staking_ratio_pct":43.32},"meta":{"timestamp":"2026-06-10T14:01:35.313Z","request_id":"2cd9fd8d-c841-4b7a-9031-0c3259697fc5"},"status":"ok","message":"Network state 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/account":{"get":{"operationId":"get_v1_account","tags":["Account"],"summary":"An address liquid, staked and reward TIA","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Celestia address (celestia1...)","schema":{"type":"string"},"example":"celestia19jz67suexyclppfg2wheh97sht69khld242y5e"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Celestia","address":"celestia19jz67suexyclppfg2wheh97sht69khld242y5e","liquid_tia":0.049692,"staked_tia":873.000076,"delegation_count":1,"pending_rewards_tia":0.014398},"meta":{"timestamp":"2026-06-10T14:01:35.510Z","request_id":"65bd3ac3-ae99-4b0a-9132-12ab3d4b7988"},"status":"ok","message":"Account 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":["Validators"],"summary":"Active validator set ranked by voting power","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Number of validators (1-150)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":25,"source":"Celestia","validators":[{"rank":1,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Anchorage Digital","staked_tia":56306544.193393,"commission_rate":0.2,"operator_address":"celestiavaloper1llfydg9q5fnfuc0lfrwwqnvpywnw97lmvek8jf"},{"rank":2,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"P-OPS Team","staked_tia":23511024.450465,"commission_rate":0.2,"operator_address":"celestiavaloper1ac4mnwg79gyvd0x5trl2fgjv07lgfas02jf378"},{"rank":3,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"BinanceNode","staked_tia":21797072.197019,"commission_rate":0.2,"operator_address":"celestiavaloper1mpt4chntuewyktq64fgrszjp6ly7we5a3t4a8l"},{"rank":4,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Qubelabs","staked_tia":21761693.104808,"commission_rate":0.2,"operator_address":"celestiavaloper1j2jq259d3rrc24876gwxg0ksp0lhd8gy49k6st"},{"rank":5,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"P2P.org 💙","staked_tia":18485594.212397,"commission_rate":0.2,"operator_address":"celestiavaloper1r4kqtye4dzacmrwnh6f057p50pdjm8g59tlhhg"},{"rank":6,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"bitcoinsuisse.com","staked_tia":16731310.978023,"commission_rate":1,"operator_address":"celestiavaloper1emku8jrvf9dzu80n3sx7wx50chpgjhrws9x62u"},{"rank":7,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Hex Trust","staked_tia":16489995.648075,"commission_rate":0.2,"operator_address":"celestiavaloper1ftmw4wh8dq2ljw0xq3xgg00dl7l20se3lrml7q"},{"rank":8,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Bitwise Onchain Solutions","staked_tia":13246173.180123,"commission_rate":0.2,"operator_address":"celestiavaloper15urq2dtp9qce4fyc85m6upwm9xul3049gwdz0x"},{"rank":9,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Kraken","staked_tia":12525594.847648,"commission_rate":0.2,"operator_address":"celestiavaloper1pmn4cjwf26hkcpvyl322glhpdpcemcel8ca2vl"},{"rank":10,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Coinbase","staked_tia":10534701.307261,"commission_rate":0.2,"operator_address":"celestiavaloper1geuw5f6u3n5l4ne2d2nze3fehxf023f7s8h08t"},{"rank":11,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"itrocket","staked_tia":9867793.871372,"commission_rate":0.2,"operator_address":"celestiavaloper1gl0rg3g0pkcpr8umj2hvlhha06ecjd65yt96z5"},{"rank":12,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Cosmostation","staked_tia":9439148.631357,"commission_rate":0.2,"operator_address":"celestiavaloper1uqj5ul7jtpskk9ste9mfv6jvh0y3w34vtpz3gw"},{"rank":13,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Nodes.Guru","staked_tia":8704874.787993,"commission_rate":0.2,"operator_address":"celestiavaloper1hm2d8e6nd5ngtlte3hlded03vgj3rer94vmdml"},{"rank":14,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Kairos Research X Firstset","staked_tia":8530526.53726,"commission_rate":0.2,"operator_address":"celestiavaloper17vrdfe4mfwzd3mfkf3nvj5lx2m9vqtlz82hrma"},{"rank":15,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Kiln","staked_tia":8208330.717795,"commission_rate":0.2,"operator_address":"celestiavaloper1uxlf7mvr8nep3gm7udf2u9remms2jyjqa02qlj"},{"rank":16,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Keplr","staked_tia":8073962.275906,"commission_rate":0.2,"operator_address":"celestiavaloper1uwmf03ke52vld2sa9khs0nslpgzwsm5xs5e4pn"},{"rank":17,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Staking Facilities","staked_tia":8002221.446613,"commission_rate":0.2,"operator_address":"celestiavaloper1wu24jxpn9j0580ehjz344d58cf3t7lzrrgqmnr"},{"rank":18,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Validatus","staked_tia":7831130.755925,"commission_rate":0.2,"operator_address":"celestiavaloper19v94c3z7ckarwsum76kaagma0wqsqhh5nl5zqg"},{"rank":19,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":" kjnodes.com 🦄","staked_tia":7598869.429808,"commission_rate":0.2,"operator_address":"celestiavaloper17p8y0sm76zhrtjny98tknevafvlq9860ehykz3"},{"rank":20,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Binary Builders","staked_tia":7167843.452955,"commission_rate":0.2,"operator_address":"celestiavaloper15kpw453rgqrranltr8pcy9muryf3jjd7esw38j"},{"rank":21,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Figment","staked_tia":7028062.082427,"commission_rate":0.2,"operator_address":"celestiavaloper1xqc7w3pe38kg4tswjt7mnvks7gy4p38vtsuycj"},{"rank":22,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"polkachu.com","staked_tia":6717455.936991,"commission_rate":0.2,"operator_address":"celestiavaloper1jgqewpzn7dww5tlpnkypm72fm8tjznmw7ll7ls"},{"rank":23,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"T DATA","staked_tia":6049514.156577,"commission_rate":0.2,"operator_address":"celestiavaloper1fyw0qppar97easavw07n876ktv0a4vpptawt09"},{"rank":24,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"IYKYK","staked_tia":5912826.004053,"commission_rate":0.2,"operator_address":"celestiavaloper1amxp3ah9anq4pmpnsknls7sql3kras9hs8pu0g"},{"rank":25,"jailed":false,"status":"BOND_STATUS_BONDED","moniker":"Imperator.co","staked_tia":5583245.50795,"commission_rate":0.2,"operator_address":"celestiavaloper1r5xt7twqmh39ky72f4txxjrhlt2z0qwwmdal8c"}],"active_validator_count":96},"meta":{"timestamp":"2026-06-10T14:01:35.650Z","request_id":"8712bb18-46d6-4daa-84f2-594466faab77"},"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/block":{"get":{"operationId":"get_v1_block","tags":["Block"],"summary":"A block height, time, proposer and tx count","description":"","parameters":[{"name":"height","in":"query","required":false,"description":"Block height or latest","schema":{"type":"string"},"example":"latest"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"time":"2026-06-10T14:01:28.104462034Z","height":11470462,"source":"Celestia","chain_id":"celestia","tx_count":5,"block_hash":"9QnNJYRmsqoQCVPvl+jUERk+Rn/b+MJQwvaE8sJ//kM=","proposer_address":"OPvFKLiCGi4dkkKk4uJvHUUjx24="},"meta":{"timestamp":"2026-06-10T14:01:35.787Z","request_id":"1c27173c-94c0-41e8-96b9-9cf4b2ebeebc"},"status":"ok","message":"Block 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 and endpoint catalog","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Celestia Cosmos REST API (celestia-rest.publicnode.com, live)","service":"celestia-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/block":"A block's height, time, proposer and tx count (height=latest|N).","GET /v1/account":"An address's liquid, staked and reward TIA (address=celestia19jz67suexyclppfg2wheh97sht69khld242y5e).","GET /v1/network":"Live tip, total/bonded TIA supply and staking ratio.","GET /v1/validators":"The active validator set ranked by voting power (limit=25)."},"tip_height":11470462,"description":"Live on-chain data from the Celestia network (TIA), the first modular data-availability blockchain, a proof-of-stake chain secured by delegated staking, via a public Cosmos REST node. The account endpoint returns an address's liquid TIA balance, total delegated (staked) TIA and pending staking rewards; the validators endpoint returns the active validator set ranked by voting power with each validator's staked TIA, commission and status; the block endpoint returns a block's height, time, proposer and transaction count; the network endpoint returns the tip height, total TIA supply, bonded TIA and staking ratio. Live, no key, nothing stored. Distinct from the Cosmos Hub, Bitcoin, Dogecoin, VeChain, Solana and EVM on-chain APIs and from price feeds — this is Celestia's own TIA account state, delegated-staking economy, validator set and blocks.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T14:01:35.927Z","request_id":"329b025c-b40c-4756-813f-f1eae4aa3340"},"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":10000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":800,"monthly_call_quota":142000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2600,"monthly_call_quota":900000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":6100,"monthly_call_quota":4800000,"rps_limit":30,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/celestia-api"}