List

Get Validators List

post

/state/validators/list

Header parameters

api-keystringrequired

Body

at_ledger_statenullable object

Optional. This allows for a request to be made against a historic state. If a constraint is specified, the Gateway will resolve the request against the ledger state at that time. If not specified, requests will be made with respect to the top of the committed ledger.

cursornullable string

This cursor allows forward pagination, by providing the cursor from the previous request.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://xrd-gateway.nownodes.io/state/validators/list' \
  --header 'api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{"at_ledger_state":null}'

200

4XX

200

{
  "ledger_state": {
    "network": "mainnet",
    "state_version": 1,
    "proposer_round_timestamp": "text",
    "epoch": 1,
    "round": 1
  },
  "validators": {
    "total_count": 1,
    "next_cursor": "text",
    "items": [
      {
        "address": "text",
        "stake_vault": {
          "balance": "text",
          "last_changed_at_state_version": 1,
          "address": "text"
        },
        "pending_xrd_withdraw_vault": {
          "balance": "text",
          "last_changed_at_state_version": 1,
          "address": "text"
        },
        "locked_owner_stake_unit_vault": {
          "balance": "text",
          "last_changed_at_state_version": 1,
          "address": "text"
        },
        "pending_owner_stake_unit_unlock_vault": {
          "balance": "text",
          "last_changed_at_state_version": 1,
          "address": "text"
        },
        "state": {},
        "active_in_epoch": {
          "stake": "text",
          "stake_percentage": 1,
          "key": {
            "key_type": "EcdsaSecp256k1"
          }
        },
        "metadata": {
          "total_count": 1,
          "next_cursor": "text",
          "items": [
            {
              "key": "text",
              "value": {
                "raw_hex": "text",
                "programmatic_json": {
                  "kind": "Bool",
                  "type_name": "text",
                  "field_name": "text"
                },
                "typed": {
                  "type": "String"
                }
              },
              "is_locked": true,
              "last_updated_at_state_version": 1
            }
          ]
        },
        "effective_fee_factor": {
          "current": {
            "fee_factor": "text"
          },
          "pending": {
            "fee_factor": "text",
            "effective_at_epoch": 1
          }
        }
      }
    ]
  }
}

Validators List