{"openapi":"3.1.0","info":{"title":"NEAR Protocol API","version":"1.0.0","description":"Live on-chain data from the NEAR Protocol (NEAR), a sharded proof-of-stake Layer 1 known for its human-readable named accounts and its access-key permission model, via a public NEAR RPC endpoint. On NEAR an account is a name like \"aurora\" or \"example.near\", not a hash, and each account authorises actions through access keys that are either full-access or function-call-scoped. Resolve an account's NEAR balance, the portion locked for staking, its storage usage and whether it holds a deployed contract. Read the account's access keys with each key's permission — full access, or a function-call key with its allowance, the contract it may call and the methods it is limited to. Get the current validator set ranked by stake, with each validator's blocks produced versus expected. Read the live chain state — the chain id, protocol version, latest block height, gas price, validator count and total stake. Live, no key, nothing stored. Distinct from the XRP Ledger, Stellar, TRON, Aptos, Algorand, Tezos, Cardano, Hedera, Kaspa, Cosmos, Sui, Solana and EVM on-chain APIs and from price feeds — this is NEAR's named-account state, access keys, staking validators and chain economics. Perfect for wallets, explorers and analytics apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/near-api","description":"oanor gateway"}],"tags":[{"name":"Account"},{"name":"Staking"},{"name":"Network"}],"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/account":{"get":{"operationId":"get_v1_account","tags":["Account"],"summary":"Account balance + contract flag","description":"","parameters":[{"name":"account","in":"query","required":true,"description":"NEAR named account","schema":{"type":"string"},"example":"aurora"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"NEAR","code_hash":"2axCgM1hmJWemwiGH8YuhXzvzodSjfP34X4TzcLRUM76","account_id":"aurora","is_contract":true,"locked_near":0,"balance_near":137816.804812,"block_height":202119376,"balance_yocto":"137816804812407026912072052518","storage_usage":13619243575},"meta":{"timestamp":"2026-06-10T14:02:26.370Z","request_id":"0b82bbf0-6b33-4d95-8fa1-9139e4ea4bde"},"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/keys":{"get":{"operationId":"get_v1_keys","tags":["Account"],"summary":"Account access keys + permissions","description":"","parameters":[{"name":"account","in":"query","required":true,"description":"NEAR named account","schema":{"type":"string"},"example":"aurora"},{"name":"limit","in":"query","required":false,"description":"Max 1-200","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"keys":[{"type":"FullAccess","nonce":195119959000001,"public_key":"ed25519:CAAuuVUijdewX2ktgCDvXfxCrtUmNCvs8CBFhaZEJWoh"}],"count":1,"source":"NEAR","key_count":1,"account_id":"aurora","full_access_keys":1,"function_call_keys":0},"meta":{"timestamp":"2026-06-10T14:02:28.547Z","request_id":"4d0483a4-7523-41e3-a1f3-d15706e56a6f"},"status":"ok","message":"Access keys 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":"Validator set ranked by stake","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max 1-200","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":25,"source":"NEAR","validators":[{"account_id":"bisontrails2.poolv1.near","stake_near":30373378.213582,"uptime_pct":100,"blocks_expected":920,"blocks_produced":920},{"account_id":"astro-stakers.poolv1.near","stake_near":28949888.903461,"uptime_pct":100,"blocks_expected":935,"blocks_produced":935},{"account_id":"figment.poolv1.near","stake_near":28708578.688383,"uptime_pct":100,"blocks_expected":876,"blocks_produced":876},{"account_id":"binancenode1.poolv1.near","stake_near":23810404.769558,"uptime_pct":100,"blocks_expected":732,"blocks_produced":732},{"account_id":"bitwise_1.poolv1.near","stake_near":22342878.769397,"uptime_pct":100,"blocks_expected":674,"blocks_produced":674},{"account_id":"zavodil.poolv1.near","stake_near":19627718.552601,"uptime_pct":100,"blocks_expected":582,"blocks_produced":582},{"account_id":"ledgerbyfigment.poolv1.near","stake_near":17348663.659008,"uptime_pct":100,"blocks_expected":566,"blocks_produced":566},{"account_id":"staked.poolv1.near","stake_near":14607154.562515,"uptime_pct":100,"blocks_expected":472,"blocks_produced":472},{"account_id":"kiln-1.poolv1.near","stake_near":12733066.097968,"uptime_pct":100,"blocks_expected":392,"blocks_produced":392},{"account_id":"liver.pool.near","stake_near":12147637.649785,"uptime_pct":100,"blocks_expected":357,"blocks_produced":357},{"account_id":"svrn-ai.poolv1.near","stake_near":11833064.248173,"uptime_pct":100,"blocks_expected":359,"blocks_produced":359},{"account_id":"p2p-org.poolv1.near","stake_near":11760265.125082,"uptime_pct":100,"blocks_expected":368,"blocks_produced":368},{"account_id":"svrn.pool.near","stake_near":11642270.317462,"uptime_pct":100,"blocks_expected":358,"blocks_produced":358},{"account_id":"stake1.poolv1.near","stake_near":10962144.081788,"uptime_pct":100,"blocks_expected":335,"blocks_produced":335},{"account_id":"svrn-luganodes.pool.near","stake_near":10941165.536229,"uptime_pct":100,"blocks_expected":342,"blocks_produced":342},{"account_id":"galaxydigital.poolv1.near","stake_near":10616945.725783,"uptime_pct":100,"blocks_expected":336,"blocks_produced":336},{"account_id":"nearvana.poolv1.near","stake_near":10251287.118524,"uptime_pct":100,"blocks_expected":320,"blocks_produced":320},{"account_id":"svrn_bitwise.poolv1.near","stake_near":10079138.322672,"uptime_pct":100,"blocks_expected":333,"blocks_produced":333},{"account_id":"epic.poolv1.near","stake_near":9778281.019032,"uptime_pct":100,"blocks_expected":316,"blocks_produced":316},{"account_id":"aca87218e28c41f5a693dee3dff12238.poolv1.near","stake_near":9328695.807463,"uptime_pct":100,"blocks_expected":269,"blocks_produced":269},{"account_id":"sofarsonear.poolv1.near","stake_near":7779884.541021,"uptime_pct":100,"blocks_expected":255,"blocks_produced":255},{"account_id":"flipside.pool.near","stake_near":7104579.324268,"uptime_pct":100,"blocks_expected":224,"blocks_produced":224},{"account_id":"metapool01.pool.near","stake_near":6597217.834034,"uptime_pct":99.41,"blocks_expected":170,"blocks_produced":169},{"account_id":"macrodatarefinement.poolv1.near","stake_near":6540873.704769,"uptime_pct":100,"blocks_expected":202,"blocks_produced":202},{"account_id":"silentnodes.pool.near","stake_near":6081057.203657,"uptime_pct":100,"blocks_expected":197,"blocks_produced":197}],"epoch_height":4451,"validator_count":421},"meta":{"timestamp":"2026-06-10T14:02:30.798Z","request_id":"1c628f17-f517-4bf9-89a9-48da19f5a55d"},"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/network":{"get":{"operationId":"get_v1_network","tags":["Network"],"summary":"Live chain state","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"NEAR","chain_id":"mainnet","epoch_height":4451,"gas_price_yocto":"100000000","validator_count":421,"protocol_version":84,"total_stake_near":560734095,"latest_block_time":"2026-06-10T14:02:31.933634156Z","latest_block_height":202119389},"meta":{"timestamp":"2026-06-10T14:02:37.153Z","request_id":"c70e2d65-f24b-430c-b69a-428bdb573624"},"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"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":8000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1400,"monthly_call_quota":152000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4000,"monthly_call_quota":905000,"rps_limit":15,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":8600,"monthly_call_quota":4650000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/near-api"}