Uptime

Get Validators Uptime

post

Returns validators uptime data for time range limited by from_state_version and at_state_version.

Body

all ofOptional

For at_ledger_state and from_ledger_state you can use one of state_version, epoch, epoch and round, or timestamp, but then ongoing epoch will be selected and used for querying data. i.e for request with { "from_state_version" = { "state_version" = 100 }, "at_state_version" = { "state_version" = 300} } gateway api will check in which epoch transactions with state version 100 and 300 were and then use that as inclusive boundary for request.

and

Responses

200

Validators Uptime

application/json

Responseall of

4XX

Client-originated request error

application/json

post

HTTPcURLJavaScriptPython

POST /statistics/validators/uptime HTTP/1.1
Host: xrd-gateway.nownodes.io
Content-Type: application/json
Accept: */*
Content-Length: 228

{
  "at_ledger_state": {
    "state_version": 1,
    "timestamp": "2025-05-13T21:01:57.917Z",
    "epoch": 1,
    "round": 1
  },
  "from_ledger_state": {
    "state_version": 1,
    "timestamp": "2025-05-13T21:01:57.917Z",
    "epoch": 1,
    "round": 1
  },
  "validator_addresses": [
    "text"
  ]
}

{
  "ledger_state": {
    "network": "<network-name>",
    "state_version": 1,
    "proposer_round_timestamp": "text",
    "epoch": 1,
    "round": 1
  },
  "validators": {
    "items": [
      {
        "address": "text",
        "proposals_made": 1,
        "proposals_missed": 1,
        "epochs_active_in": 1
      }
    ]
  }
}