# validators - NEAR Protocol This method provides detailed information about **current, upcoming, and previous validators** on the NEAR blockchain. ## Supported Networks * Mainnet ## Parameters * None ## Request Example **Base URL** ```bash https://go.getblock.io/ ``` **Example(cURL)** ```bash curl -X POST https://go.getblock.io/ \ -H "Content-Type: application/json" \ -d '{"jsonrpc": "2.0", "method": "validators", "params": [null], "id": "getblock.io"}' ``` ## Response Example ```json { "jsonrpc": "2.0", "result": { "current_fishermen": [], "current_proposals": [ { "account_id": "001mrcoin.pool.near", "public_key": "ed25519:47bmEkWhm3pxPaWenBCEhM7xbAeohuiYVNNRjnWoWhxw", "stake": "77069033005549257593709607276", "validator_stake_struct_version": "V1" } ], "current_validators": [ { "account_id": "croutondigital.pool.near", "is_slashed": false, "num_expected_blocks": 0, "num_expected_chunks": 0, "num_expected_chunks_per_shard": [], "num_expected_endorsements": 30863, "num_expected_endorsements_per_shard": [ 3517, 3480, 3377, 3428, 3413, 3405, 3469, 3389, 3385 ], "num_produced_blocks": 0, "num_produced_chunks": 0, "num_produced_chunks_per_shard": [], "num_produced_endorsements": 29610, "num_produced_endorsements_per_shard": [ 3435, 3423, 3055, 3374, 3312, 3305, 3033, 3328, 3345 ], "public_key": "ed25519:HFtbBTFQo46Jkd5Dvwu7nY5ZoAG7piVGpHneSqpCNQpH", "shards": [], "shards_endorsed": [ 1, 4, 5, 6, 7, 8, 9, 10, 11 ], "stake": "11003694780164446245528847844" } ], "epoch_height": 3703, "epoch_start_height": 169789917, "next_fishermen": [], "next_validators": [ { "account_id": "bitcoinsuisse.poolv1.near", "public_key": "ed25519:Cy2sboVqjDk6d3d2A2AJZBdFvokjk7sjZpYATLjcQSCj", "shards": [ 4 ], "stake": "1379544217119337898196119177738" }, ], "prev_epoch_kickout": [ { "account_id": "sparkpool.poolv1.near", "reason": { "NotEnoughChunkEndorsements": { "expected": 43172, "produced": 0 } } }, { "account_id": "stakeseeker.poolv1.near", "reason": { "NotEnoughChunkEndorsements": { "expected": 43172, "produced": 0 } } }, { "account_id": "validatrium.poolv1.near", "reason": { "NotEnoughChunkEndorsements": { "expected": 43172, "produced": 0 } } } ] }, "id": "getblock.io" } ``` ## Response Parameters Definition | **Field** | **Type** | **Description** | | --------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------ | | **current\_proposals** | array | Information about validator proposals for the next epoch. | | **current\_proposals.account\_id** | string | Identifier of the validator account proposing to join. | | **current\_proposals.public\_key** | string | Public key of the validator. | | **current\_proposals.stake** | string | Amount of tokens staked (in yoctoNEAR). | | **current\_proposals.validator\_stake\_struct\_version** | string | Version of the validator stake struct. | | **current\_validators** | array | Information about validators currently participating in the epoch. | | **current\_validators.account\_id** | string | Identifier of the current validator. | | **current\_validators.public\_key** | string | Public key of the validator. | | **current\_validators.is\_slashed** | boolean | Indicates if the validator has been slashed. | | **current\_validators.num\_expected\_chunks\_per\_shard** | array | Number of expected chunks per shard. | | **current\_validators.num\_produced\_chunks\_per\_shard** | array | Number of chunks produced per shard. | | **current\_validators.num\_produced\_endorsements** | integer | Total endorsements the validator produced. | | **current\_validators.num\_produced\_endorsements\_per\_shard** | array | Endorsements produced per shard. | | **current\_validators.shards\_endorsed** | array | List of shards endorsed by this validator. | | **current\_validators.num\_expected\_endorsements** | integer | Number of endorsements expected. | | **current\_validators.stake** | string | Total tokens staked by the validator. | | **current\_validators.shards** | array | Shard IDs the validator operates on. | | **current\_validators.num\_expected\_blocks** | integer | Expected blocks the validator should produce. | | **current\_validators.num\_expected\_chunks** | integer | Expected chunks the validator should produce. | | **current\_validators.num\_produced\_blocks** | integer | Blocks actually produced by the validator. | | **current\_validators.num\_produced\_chunks** | integer | Chunks actually produced by the validator. | | **next\_validators** | array | List of validators scheduled for the next epoch. | | **next\_validators.account\_id** | string | Identifier for the upcoming validator. | | **next\_validators.public\_key** | string | Public key of the validator. | | **next\_validators.stake** | string | Stake amount for the next validator. | | **next\_validators.shards** | array | Shard assignments for the next validator. | | **current\_fishermen** | array | Information about active fishermen (participants monitoring network behavior). | | **current\_fishermen.account\_id** | string | Account ID of the current fisherman. | | **current\_fishermen.public\_key** | string | Public key of the fisherman. | | **current\_fishermen.stake** | string | Amount of tokens staked by the fisherman. | | **next\_fishermen** | array | Information about fishermen in the next epoch. | | **next\_fishermen.account\_id** | string | Account ID of the next fisherman. | | **next\_fishermen.public\_key** | string | Public key of the fisherman. | | **next\_fishermen.stake** | string | Amount staked by the fisherman. | | **prev\_epoch\_kickout** | array | List of validators removed in the previous epoch and their reasons. | | **prev\_epoch\_kickout.account\_id** | string | Identifier of the validator kicked out. | | **prev\_epoch\_kickout.reason** | object | Reason for removal. | | **prev\_epoch\_kickout.reason.NotEnoughChunks.expected** | integer | Expected number of chunks. | | **prev\_epoch\_kickout.reason.NotEnoughChunks.produced** | integer | Produced number of chunks. | | **epoch\_start\_height** | integer | The block height at which the epoch started. | | **epoch\_height** | integer | The height (number) of the current epoch. | ## Use Cases * Monitor current validator activity and **block production performance**. * Track upcoming validators joining the next epoch. * Support staking dashboards and validator ranking systems. ## Code Example **Node(Axios)** ```js import axios from 'axios'; let data = JSON.stringify({ "jsonrpc": "2.0", "method": "validators", "params": [ null ], "id": "getblock.io" }); let config = { method: 'post', maxBodyLength: Infinity, url: 'https://go.getblock.io/', headers: { 'Content-Type': 'application/json' }, data : data }; axios.request(config) .then((response) => { console.log(JSON.stringify(response.data)); }) .catch((error) => { console.log(error); }); ``` **Python(Requests)** ```python import requests import json url = "https://go.getblock.io/" payload = json.dumps({ "jsonrpc": "2.0", "method": "validators", "params": [ None ], "id": "getblock.io" }) headers = { 'Content-Type': 'application/json' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text) ``` ## Error Handling | **HTTP Code** | **Error Message** | **Description** | | ----------------------------- | -------------------------------- | ----------------------------------------------------------- | | **500 Internal Server Error** | `Failed to fetch validator data` | Internal node error while retrieving validator information. | | **403 Forbidden** | `RBAC: access denied` | The Getblock access token is missing or incorrect | ## Integration with Web3 By integrating `/validators` with dApp, developers can: * Create staking analytics dashboards. * Display real-time validator metrics to delegators. * Maintain transparent governance by tracking validator proposals. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.getblock.io/api-reference/near-protocol-near/near_validators.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.