{"openapi":"3.1.0","info":{"title":"NEAR Validators & Staking API","version":"1.0.0","description":"Read NEAR's validator set and network economics live from a public NEAR RPC endpoint — no key. NEAR is sharded proof-of-stake: validators stake NEAR, produce blocks and chunks across shards, and earn rewards. The NEAR on-chain reader resolves a single account's state and the view reader runs contract view methods, but neither surfaces the validator set, the next-epoch staking proposals, or the live network economics. This opens that. List the current epoch's validators ranked by stake — each with its account id, stake in NEAR, the blocks and chunks it produced versus expected (its uptime) and slash status; read the next-epoch staking proposals (the validators entering, leaving or re-staking for the upcoming epoch); and read the live network economics — the gas price (in yoctoNEAR), the epoch length in blocks, the protocol version and the block/chunk producer kickout thresholds. The validator / staking / network layer for NEAR explorers, staking dashboards, delegators and analytics. Distinct from the NEAR on-chain account reader and the NEAR view-function reader. Live from RPC; short cache only.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/nearvalidators-api","description":"oanor gateway"}],"tags":[{"name":"Validators"},{"name":"Proposals"},{"name":"Network"},{"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/validators":{"get":{"operationId":"get_v1_validators","tags":["Validators"],"summary":"Current validators ranked by stake","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Page size (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The current epoch's NEAR validators ranked by stake — each with its account id, stake in NEAR, the blocks and chunks it produced vs expected (its uptime), and slash status. NEAR is sharded proof-of-stake; this is its active validator set. Paginate with limit.","count":25,"source":"NEAR RPC","validators":[{"account_id":"bisontrails2.poolv1.near","is_slashed":false,"stake_near":30390321.398128968,"blocks_expected":1697,"blocks_produced":1697,"chunks_expected":12250,"chunks_produced":12172,"block_uptime_pct":100},{"account_id":"figment.poolv1.near","is_slashed":false,"stake_near":28806190.371839214,"blocks_expected":1634,"blocks_produced":1634,"chunks_expected":8982,"chunks_produced":8934,"block_uptime_pct":100},{"account_id":"astro-stakers.poolv1.near","is_slashed":false,"stake_near":28720357.401510064,"blocks_expected":1586,"blocks_produced":1586,"chunks_expected":11423,"chunks_produced":11389,"block_uptime_pct":100},{"account_id":"binancenode1.poolv1.near","is_slashed":false,"stake_near":23823688.426994886,"blocks_expected":1447,"blocks_produced":1447,"chunks_expected":7426,"chunks_produced":7422,"block_uptime_pct":100},{"account_id":"bitwise_1.poolv1.near","is_slashed":false,"stake_near":22355256.785134,"blocks_expected":1199,"blocks_produced":1199,"chunks_expected":15827,"chunks_produced":15823,"block_uptime_pct":100},{"account_id":"zavodil.poolv1.near","is_slashed":false,"stake_near":20579739.461075235,"blocks_expected":1159,"blocks_produced":1159,"chunks_expected":9859,"chunks_produced":9848,"block_uptime_pct":100},{"account_id":"sumerian.poolv1.near","is_slashed":false,"stake_near":18463685.31400904,"blocks_expected":970,"blocks_produced":970,"chunks_expected":7428,"chunks_produced":7419,"block_uptime_pct":100},{"account_id":"ledgerbyfigment.poolv1.near","is_slashed":false,"stake_near":17385002.175168473,"blocks_expected":952,"blocks_produced":952,"chunks_expected":10577,"chunks_produced":10572,"block_uptime_pct":100},{"account_id":"staked.poolv1.near","is_slashed":false,"stake_near":14473704.378501419,"blocks_expected":812,"blocks_produced":812,"chunks_expected":9091,"chunks_produced":9078,"block_uptime_pct":100},{"account_id":"liver.pool.near","is_slashed":false,"stake_near":14292799.30434771,"blocks_expected":809,"blocks_produced":809,"chunks_expected":4453,"chunks_produced":4444,"block_uptime_pct":100},{"account_id":"kiln-1.poolv1.near","is_slashed":false,"stake_near":12886952.636151616,"blocks_expected":720,"blocks_produced":720,"chunks_expected":3933,"chunks_produced":3929,"block_uptime_pct":100},{"account_id":"epic.poolv1.near","is_slashed":false,"stake_near":12843004.511649767,"blocks_expected":713,"blocks_produced":713,"chunks_expected":7868,"chunks_produced":7868,"block_uptime_pct":100},{"account_id":"svrn-ai.poolv1.near","is_slashed":false,"stake_near":11839665.832403596,"blocks_expected":652,"blocks_produced":652,"chunks_expected":7099,"chunks_produced":7063,"block_uptime_pct":100},{"account_id":"p2p-org.poolv1.near","is_slashed":false,"stake_near":11753930.943381373,"blocks_expected":642,"blocks_produced":641,"chunks_expected":7034,"chunks_produced":7013,"block_uptime_pct":99.84},{"account_id":"svrn.pool.near","is_slashed":false,"stake_near":11648765.459118837,"blocks_expected":622,"blocks_produced":622,"chunks_expected":4753,"chunks_produced":4753,"block_uptime_pct":100},{"account_id":"stake1.poolv1.near","is_slashed":false,"stake_near":10981492.116288979,"blocks_expected":565,"blocks_produced":565,"chunks_expected":6790,"chunks_produced":6790,"block_uptime_pct":100},{"account_id":"svrn-luganodes.pool.near","is_slashed":false,"stake_near":10947269.536721908,"blocks_expected":592,"blocks_produced":592,"chunks_expected":6306,"chunks_produced":6299,"block_uptime_pct":100},{"account_id":"galaxydigital.poolv1.near","is_slashed":false,"stake_near":10622868.845801461,"blocks_expected":617,"blocks_produced":617,"chunks_expected":8066,"chunks_produced":8065,"block_uptime_pct":100},{"account_id":"nearvana.poolv1.near","is_slashed":false,"stake_near":10266642.128902309,"blocks_expected":578,"blocks_produced":578,"chunks_expected":7867,"chunks_produced":7865,"block_uptime_pct":100},{"account_id":"svrn_bitwise.poolv1.near","is_slashed":false,"stake_near":10084761.404251544,"blocks_expected":585,"blocks_produced":585,"chunks_expected":3951,"chunks_produced":3949,"block_uptime_pct":100},{"account_id":"aca87218e28c41f5a693dee3dff12238.poolv1.near","is_slashed":false,"stake_near":9333900.22173724,"blocks_expected":510,"blocks_produced":510,"chunks_expected":3698,"chunks_produced":3694,"block_uptime_pct":100},{"account_id":"sofarsonear.poolv1.near","is_slashed":false,"stake_near":7783941.501201954,"blocks_expected":404,"blocks_produced":404,"chunks_expected":3852,"chunks_produced":3848,"block_uptime_pct":100},{"account_id":"metapool01.pool.near","is_slashed":false,"stake_near":7168904.80009075,"blocks_expected":375,"blocks_produced":375,"chunks_expected":3589,"chunks_produced":3587,"block_uptime_pct":100},{"account_id":"flipside.pool.near","is_slashed":false,"stake_near":7108542.922011389,"blocks_expected":382,"blocks_produced":382,"chunks_expected":4919,"chunks_produced":4916,"block_uptime_pct":100},{"account_id":"macrodatarefinement.poolv1.near","is_slashed":false,"stake_near":6544522.813234773,"blocks_expected":361,"blocks_produced":361,"chunks_expected":4098,"chunks_produced":4096,"block_uptime_pct":100}],"epoch_height":4464,"total_validators":390},"meta":{"timestamp":"2026-06-14T17:03:49.750Z","request_id":"c4411fca-6130-4fbe-8196-dee75e671428"},"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/proposals":{"get":{"operationId":"get_v1_proposals","tags":["Proposals"],"summary":"Next-epoch staking proposals","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Page size (1-100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The next-epoch NEAR staking proposals ranked by stake — the validators that have proposed their stake for the upcoming epoch (those entering, leaving or re-staking). Compare with /v1/validators to see set changes. Paginate with limit.","count":25,"source":"NEAR RPC","proposals":[{"account_id":"bisontrails2.poolv1.near","stake_near":30390910.26413971},{"account_id":"figment.poolv1.near","stake_near":28807376.17941196},{"account_id":"astro-stakers.poolv1.near","stake_near":28723346.36702873},{"account_id":"binancenode1.poolv1.near","stake_near":23824670.086951647},{"account_id":"bitwise_1.poolv1.near","stake_near":22356177.93806855},{"account_id":"zavodil.poolv1.near","stake_near":20582497.663090996},{"account_id":"sumerian.poolv1.near","stake_near":18463363.113977835},{"account_id":"ledgerbyfigment.poolv1.near","stake_near":17391174.671891764},{"account_id":"staked.poolv1.near","stake_near":14478752.8979345},{"account_id":"liver.pool.near","stake_near":14293388.242269354},{"account_id":"kiln-1.poolv1.near","stake_near":12880991.640865836},{"account_id":"epic.poolv1.near","stake_near":12843533.710500022},{"account_id":"svrn-ai.poolv1.near","stake_near":11840153.688387334},{"account_id":"p2p-org.poolv1.near","stake_near":11754415.25061403},{"account_id":"svrn.pool.near","stake_near":11649245.449020285},{"account_id":"stake1.poolv1.near","stake_near":10981944.611119006},{"account_id":"svrn-luganodes.pool.near","stake_near":10947720.621383786},{"account_id":"galaxydigital.poolv1.near","stake_near":10623306.563383454},{"account_id":"nearvana.poolv1.near","stake_near":10267000.86536053},{"account_id":"svrn_bitwise.poolv1.near","stake_near":10085176.94906711},{"account_id":"aca87218e28c41f5a693dee3dff12238.poolv1.near","stake_near":9334284.827077016},{"account_id":"sofarsonear.poolv1.near","stake_near":7784148.484238478},{"account_id":"metapool01.pool.near","stake_near":7169200.196427162},{"account_id":"flipside.pool.near","stake_near":7108835.83140371},{"account_id":"macrodatarefinement.poolv1.near","stake_near":6544792.481763646}],"epoch_height":4464,"total_proposals":445},"meta":{"timestamp":"2026-06-14T17:03:49.856Z","request_id":"f88baac8-56ab-4b07-b060-124b4785ed2f"},"status":"ok","message":"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/network":{"get":{"operationId":"get_v1_network","tags":["Network"],"summary":"Live gas price, epoch length, kickout thresholds","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"NEAR's live network economics and protocol parameters — the current gas price (in yoctoNEAR), the epoch length in blocks, the protocol version and the block/chunk producer kickout thresholds (the uptime % below which a validator is removed). Combine with /v1/validators to judge validator health.","source":"NEAR RPC","chain_id":"mainnet","gas_limit":1000000000000000,"epoch_length":43200,"gas_price_yocto":"100000000","protocol_version":84,"max_gas_price_yocto":"10000000000000000000000","block_producer_kickout_threshold":80,"chunk_producer_kickout_threshold":80},"meta":{"timestamp":"2026-06-14T17:03:52.006Z","request_id":"41910221-7ed6-436f-a280-871fcf4b5caf"},"status":"ok","message":"Network 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","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":{"epoch":4464,"validators":390},"source":"public NEAR RPC (rpc.mainnet.near.org), keyless","service":"nearvalidators-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/network":"Live gas price, epoch length and protocol kickout thresholds.","GET /v1/proposals":"Next-epoch staking proposals ranked by stake (limit).","GET /v1/validators":"Current validators ranked by stake, with uptime (limit)."},"description":"Read NEAR's validator set and network economics live from a public NEAR RPC: list the current epoch's validators ranked by stake with uptime, read the next-epoch staking proposals, and read the live network economics (gas price, epoch length, kickout thresholds). The validator / staking / network layer for NEAR explorers, staking dashboards and delegators. Live, short cache only.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T17:03:52.079Z","request_id":"65f3eb72-6c6e-41ab-b04e-004d283cf54c"},"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":8200,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":830,"monthly_call_quota":150000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2900,"monthly_call_quota":820000,"rps_limit":25,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":8300,"monthly_call_quota":5150000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/nearvalidators-api"}