List validators

Lists details for validators. By default, returns details for all validators. Filterable by validator node ids and minimum delegation capacity.

Authorizations

x-glacier-api-key

string

headerrequired

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,

devnet

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

nodeIds

string

A comma separated list of node ids to filter by.

sortBy

enum<string>

Which property to sort by, in conjunction with sortOrder.

Note: Delegation fee is only available for mainnet validators. Set subnetId to 11111111111111111111111111111111LpoYY to use this option.

Available options:

blockIndex,

delegationCapacity,

timeRemaining,

delegationFee,

uptimePerformance

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

validationStatus

enum<string>

Validation status of the node.

Available options:

completed,

active,

pending,

removed

minDelegationCapacity

string

The minimum delegation capacity, in nAVAX, used to filter the set of nodes being returned. Accepts values between 0 and 720,000,000,000,000,000

maxDelegationCapacity

string

The maximum delegation capacity, in nAVAX, used to filter the set of nodes being returned. Accepts values between 0 and 720,000,000,000,000,000.

minTimeRemaining

number

The minimum validation time remaining, in seconds, used to filter the set of nodes being returned.

Required range: 0 < x < 2147483647

maxTimeRemaining

number

The maximum validation time remaining, in seconds, used to filter the set of nodes being returned.

Required range: 0 < x < 2147483647

minFeePercentage

number

The minimum fee percentage, used to filter the set of nodes being returned. If this field is populated no subnet validations will be returned, as their fee percentage is null, since subnet delegations are not supported. Default is 2.0, as per the Avalanche spec.

Required range: 2 < x < 100

maxFeePercentage

number

The maximum fee percentage, used to filter the set of nodes being returned. If this field is populated no subnet validations will be returned, as their fee percentage is null, since subnet delegations are not supported. Default is 100.0.

Required range: 2 < x < 100

minUptimePerformance

number

The minimum node uptime performance percentage, which represents node health, used to filter the set of nodes being returned Default is 90.

Required range: 0 < x < 100

maxUptimePerformance

number

The maximum node uptime performance percentage, which represents node health, used to filter the set of nodes being returned. Default is 100.

Required range: 0 < x < 100

subnetId

any

The subnet ID to filter by. If not provided, then all subnets will be returned.

Response

200 - application/json

validators

object[]

required

The list of validator Details.

• Option 1
• Option 2
• Option 3
• Option 4

Show child attributes

validators.txHash

string

required

validators.nodeId

string

required

validators.subnetId

string

required

validators.amountStaked

string

required

validators.delegationFee

string

validators.startTimestamp

number

required

validators.endTimestamp

number

required

validators.blsCredentials

object

Present for AddPermissionlessValidatorTx

Show child attributes

validators.blsCredentials.publicKey

string

required

validators.blsCredentials.proofOfPossession

string

required

validators.delegatorCount

number

required

validators.amountDelegated

string

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

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.