Get single validator details

List validator details for a single validator. Filterable by validation status.

GET /v1/networks/{network}/validators/{nodeId}

Try it

JavaScript

JavaScript

import { Avalanche } from "@avalanche-sdk/chainkit";

const avalanche = new Avalanche({
  network: "mainnet",
});

async function run() {
  const result = await avalanche.data.primaryNetwork.getValidatorDetails({
    pageSize: 10,
    nodeId: "NodeID-111111111111111111116DBWJs",
    validationStatus: "completed",
    sortOrder: "asc",
  });

  for await (const page of result) {
    console.log(page);
  }
}

run();

200

{
  "validators": [
    {
      "txHash": "<string>",
      "nodeId": "<string>",
      "subnetId": "<string>",
      "amountStaked": "<string>",
      "startTimestamp": 123,
      "endTimestamp": 123,
      "delegatorCount": 123,
      "rewards": {
        "validationRewardAmount": "<string>",
        "delegationRewardAmount": "<string>",
        "rewardAddresses": [
          "<string>"
        ],
        "rewardTxHash": "<string>"
      },
      "validationStatus": "completed",
      "delegationFee": "<string>",
      "blsCredentials": {
        "publicKey": "<string>",
        "proofOfPossession": "<string>"
      },
      "amountDelegated": "<string>"
    }
  ],
  "nextPageToken": "<string>"
}

Authorizations

x-glacier-api-key · string · header · required

Api keys provide higher access to rate limits. To obtain an api key, sign up for an account at https://avacloud.io/.

Path Parameters

network · enum<string> · required

Either mainnet or testnet/fuji.

Available options: mainnet, fuji, testnet

nodeId · string · required

A primary network (P or X chain) nodeId.

Query Parameters

pageToken · string

A page token, received from a previous list call. Provide this to retrieve the subsequent page.

pageSize · integer · default: 10

The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 100.

Required range: 1 <= x <= 100

validationStatus · enum<string>

Validation status of the node.

Available options: completed, active, pending, removed

sortOrder · enum<string>

The order by which to sort results. Use "asc" for ascending order, "desc" for descending order. Sorted by timestamp or the sortBy query parameter, if provided.

Available options: asc, desc

Response

200

application/json

Successful response

validators · object[] · required

The list of validator Details.

Option 1

Show child attributes

validators. txHash · string · required

validators. nodeId · string · required

validators. subnetId · string · required

validators. amountStaked · string · required

validators. startTimestamp · number · required

validators. endTimestamp · number · required

validators. delegatorCount · number · required

validators. rewards · object · required

Show child attributes

validators.rewards. validationRewardAmount · string · required

validators.rewards. delegationRewardAmount · string · required

validators.rewards. rewardAddresses · string[]

validators.rewards. rewardTxHash · string

validators. validationStatus · enum<string> · required

Available options: completed

validators. delegationFee · string

The percentage of total estimated delegator rewards allocated to validator nodes for supporting delegations.

validators. blsCredentials · object

Present for AddPermissionlessValidatorTx

Show child attributes

validators.blsCredentials. publicKey · string · required

validators.blsCredentials. proofOfPossession · string · required

validators. amountDelegated · string

nextPageToken · string

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted or empty, there are no subsequent pages.