NEAR Protocol RPC: Validators By Epoch (1.0.0)

Retrieve information about validators for a specific epoch

Download OpenAPI description
validators_by_epoch.json
validators_by_epoch.yaml
Languages
Servers
Mainnet
https://rpc.mainnet.fastnear.com/
Testnet
https://rpc.testnet.fastnear.com/

Get validators by epoch

Request

Retrieves the list of validators and their details for a specific epoch

Bodyapplication/jsonrequired
jsonrpcstringrequired
Value"2.0"
idstringrequired
Example: "fastnear"
methodstringrequired
Value"validators"
paramsobjectrequired
params.​epoch_idstringrequired

Base58-encoded epoch identifier hash

curl -i -X POST \
  https://rpc.mainnet.fastnear.com/ \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": "fastnear",
    "method": "validators",
    "params": {
      "epoch_id": "GZP8ApSTYZGrn8WnKTuYvJixMvK2MtQBB7eCGZZHQaS6"
    }
  }'

Responses

Successful response

Bodyapplication/json
jsonrpcstringrequired
Value"2.0"
idstring or numberrequired
One of:
string
resultobject

Information about this epoch validators and next epoch validators

errorobject
Response
application/json
{
  "jsonrpc": "2.0",
  "id": "string",
  "result": {
    "current_fishermen": [ … ],
    "current_proposals": [ … ],
    "current_validators": [ … ],
    "epoch_height": 0,
    "epoch_start_height": 0,
    "next_fishermen": [ … ],
    "next_validators": [ … ],
    "prev_epoch_kickout": [ … ]
  },
  "error": {
    "code": 0,
    "message": "string",
    "data": {}
  }
}