platform.getCurrentValidators

List the current validators of the given Subnet.

A transaction is said to change an address's balance if either is true:

• A UTXO that the transaction consumes was at least partially owned by the address.

• A UTXO that the transaction produces is at least partially owned by the address.

Parameters:

• subnetID - string - (optional) The subnet whose current validators are returned. If omitted, returns the current validators of the Primary Network

• nodeIDs - string - (optional) A list of the nodeIDs of pending validators to request. If omitted, all pending validators are returned. If a specified nodeID is not in the set of pending validators, it will not be included in the response

Returned Value:

• subnetID is the Subnet whose current validators are returned. If omitted, returns the current validators of the Primary Network.

• nodeIDs is a list of the NodeIDs of current validators to request. If omitted, all current validators are returned. If a specified NodeID is not in the set of current validators, it will not be included in the response.

• validators:

  • txID is the validator transaction.

  • startTime is the Unix time when the validator starts validating the Subnet.

  • endTime is the Unix time when the validator stops validating the Subnet.

  • stakeAmount is the amount of tokens this validator staked. Omitted if subnetID is not a PoS Subnet.

  • nodeID is the validator’s node ID.

  • weight is the validator’s weight when sampling validators. Omitted if subnetID is a PoS Subnet.

  • validationRewardOwner is an OutputOwners output which includes locktime, threshold and array of addresses. Specifies the owner of the potential reward earned from staking. Omitted if subnetID is not a PoS Subnet.

  • delegationRewardOwner is an OutputOwners output which includes locktime, threshold and array of addresses. Specifies the owner of the potential reward earned from delegations. Omitted if subnetID is not a PoS Subnet.

  • potentialReward is the potential reward earned from staking. Omitted if subnetID is not a PoS Subnet.

  • delegationFeeRate is the percent fee this validator charges when others delegate stake to them. Omitted if subnetID is not a PoS Subnet.

  • uptime is the % of time the queried node has reported the peer as online and validating the Subnet.

  • connected is if the node is connected and tracks the Subnet.

  • signer is the node's BLS public key and proof of possession. Omitted if the validator doesn't have a BLS public key.

  • delegatorCount is the number of delegators on this validator. Omitted if subnetID is not a PoS Subnet.

  • delegatorWeight is total weight of delegators on this validator. Omitted if subnetID is not a PoS Subnet.

  • delegators is the list of delegators to this validator. Omitted if subnetID is not a PoS Subnet. Omitted unless nodeIDs specifies a single NodeID.

    • txID is the delegator transaction.

    • startTime is the Unix time when the delegator started.

    • endTime is the Unix time when the delegator stops.

    • stakeAmount is the amount of nAVAX this delegator staked.

    • nodeID is the validating node’s node ID.

    • rewardOwner is an OutputOwners output which includes locktime, threshold and array of addresses.

    • potentialReward is the potential reward earned from staking

Example Response:

{
  "jsonrpc": "2.0",
  "result": {
    "validators": [
      {
        "txID": "2NNkpYTGfTFLSGXJcHtVv6drwVU2cczhmjK2uhvwDyxwsjzZMm",
        "startTime": "1600368632",
        "endTime": "1602960455",
        "stakeAmount": "2000000000000",
        "nodeID": "NodeID-5mb46qkSBj81k9g9e4VFjGGSbaaSLFRzD",
        "validationRewardOwner": {
          "locktime": "0",
          "threshold": "1",
          "addresses": ["P-avax18jma8ppw3nhx5r4ap8clazz0dps7rv5ukulre5"]
        },
        "delegationRewardOwner": {
          "locktime": "0",
          "threshold": "1",
          "addresses": ["P-avax18jma8ppw3nhx5r4ap8clazz0dps7rv5ukulre5"]
        },
        "potentialReward": "117431493426",
        "delegationFee": "10.0000",
        "uptime": "0.0000",
        "connected": false,
        "delegatorCount": "1",
        "delegatorWeight": "25000000000",
        "delegators": [
          {
            "txID": "Bbai8nzGVcyn2VmeYcbS74zfjJLjDacGNVuzuvAQkHn1uWfoV",
            "startTime": "1600368523",
            "endTime": "1602960342",
            "stakeAmount": "25000000000",
            "nodeID": "NodeID-5mb46qkSBj81k9g9e4VFjGGSbaaSLFRzD",
            "rewardOwner": {
              "locktime": "0",
              "threshold": "1",
              "addresses": ["P-avax18jma8ppw3nhx5r4ap8clazz0dps7rv5ukulre5"]
            },
            "potentialReward": "11743144774"
          }
        ]
      }
    ]
  },
  "id": 1
}

mainnet

curl https://mainnet.avalanche.validationcloud.io/v1/<YOUR_API_KEY_HERE>/ext/bc/P \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
    "jsonrpc": "2.0",
    "method": "platform.getCurrentValidators",
    "params": {
      "nodeIDs": ["NodeID-5mb46qkSBj81k9g9e4VFjGGSbaaSLFRzD"]
    },
    "id": 1
}'

testnet

curl https://fuji.avalanche.validationcloud.io/v1/<YOUR_API_KEY_HERE>/ext/bc/P \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
    "jsonrpc": "2.0",
    "method": "platform.getCurrentValidators",
    "params": {
      "nodeIDs": ["NodeID-5mb46qkSBj81k9g9e4VFjGGSbaaSLFRzD"]
    },
    "id": 1
}'