Skip to main content
The RPC API enables you to query status information for nodes and validators.

​
Quick Reference

MethodParametersDescription
statusnoneReturns general status of a given node and validator set
network_infononeReturns current state of node network connections
validatorsepoch_id OR [null]Returns active validators on the network

​
Node Status

Returns general status of a given node (sync status, nearcore node version, protocol version, etc.), and the current set of validators.
​
method
string
required
status
​
params
array
required
[]
{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "method": "status",
  "params": []
}

{
  "jsonrpc": "2.0",
  "result": {
    "chain_id": "testnet",
    "genesis_hash": "FWJ9kR6KFWoyMoNjpLXXGHeuiy7tEY6GmoFeCA5yuc6b",
    "latest_protocol_version": 73,
    "node_key": null,
    "node_public_key": "ed25519:DC7DbfZq4dkPqUKaKpWNimgtRBxnD9rja2KcZRs4e3DL",
    "protocol_version": 73,
    "rpc_addr": "0.0.0.0:3030",
    "sync_info": {
      "earliest_block_hash": "uz2gwgYxpx8dHsjgiPQefbwAhWk41CCvEmHU7ktYE2C",
      "earliest_block_height": 187251995,
      "earliest_block_time": "2025-02-10T13:54:22.616904144Z",
      "epoch_id": "94jeudySZcxGBSVgKXn3xPT3P5iFF6YcnxC43F15QtkQ",
      "epoch_start_height": 187443633,
      "latest_block_hash": "EfL8Rc1EH13UxgbJB4skt8xSF8vojNQPcAX1opf6RFab",
      "latest_block_height": 187456272,
      "latest_block_time": "2025-02-12T22:10:10.530341781Z",
      "latest_state_root": "3Vpebx4DuKAYmMjL96XMmLqWYUfuS2raZWoAbxFxeqBm",
      "syncing": false
    },
    "uptime_sec": 6020117,
    "validator_account_id": null,
    "validator_public_key": null,
    "validators": [
      {
        "account_id": "kiln.pool.f863973.m0",
        "is_slashed": false
      },
      {
        "account_id": "node2",
        "is_slashed": false
      }
    ],
    "version": {
      "build": "2.4.0-rc.1",
      "rustc_version": "1.82.0",
      "version": "2.4.0-rc.1"
    }
  },
  "id": "dontcare"
}

​
Network Info

Returns the current state of node network connections (active peers, transmitted data, etc.)
​
method
string
required
network_info
​
params
array
none
{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "method": "network_info",
  "params": []
}

​
Validation Status

Queries active validators on the network returning details and the state of validation on the blockchain.
​
method
string
required
validators
​
params
array | object
required
[null] for current validators, or {"epoch_id": "..."} for specific epoch
You can obtain the epoch_id from a block that belongs to a specific epoch. If you want to retrieve the current list of validators, pass null as the parameter. Additionally, you can query validators for past epochs by providing the epoch_id of the desired past epoch.

​
Query current validators

{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "method": "validators",
  "params": [null]
}

​
Query by epoch_id

{
  "jsonrpc": "2.0",
  "id": "dontcare",
  "method": "validators",
  "params": {
    "epoch_id": "94jeudySZcxGBSVgKXn3xPT3P5iFF6YcnxC43F15QtkQ"
  }
}

​
Error Handling

​
Common Error Types

Error CodeDescriptionSolution
UnknownEpochEpoch ID not foundUse a valid epoch ID from existing blocks
InvalidAccountInvalid account formatUse valid account ID format (e.g., account.near)
RequestTimeoutRequest timed outRetry the request or use a different RPC endpoint
InternalErrorServer-side errorRetry the request after a short delay
MethodNotFoundInvalid method nameCheck method spelling and API version

​
Best Practices

  • Cache validator data: Validator information changes infrequently, consider caching for several minutes
  • Use specific queries: Request only the data you need to minimize response size
  • Monitor network health: Use status endpoint to check node sync status before other operations

Build docs developers (and LLMs) love

Get started for freeTalk to us