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.

defines upper boundary (inclusive) for queried data. i.e { "at_state_version" = {"epoch" = 10} }, will return data till 10 epoch.

defines lower boundary (inclusive) for queried data. i.e { "from_state_version" = {"epoch" = 10} }, will return data from epoch 10 till current max ledger tip.

Responses

application/json

all ofOptional

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-04-23T18:37:31.305Z",
    "epoch": 1,
    "round": 1
  },
  "from_ledger_state": {
    "state_version": 1,
    "timestamp": "2025-04-23T18:37:31.305Z",
    "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
      }
    ]
  }
}