List validators
Lists details for validators. By default, returns details for all validators. Filterable by validator node ids and minimum delegation capacity.
Authorizations
Api keys provide higher access to rate limits. To obtain an api key, sign up for an account at https://avacloud.io/.
Path Parameters
Either mainnet or testnet/fuji.
mainnet
, fuji
, testnet
Query Parameters
A page token, received from a previous list call. Provide this to retrieve the subsequent page.
The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 100.
A comma separated list of node ids to filter by.
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.
blockIndex
, delegationCapacity
, timeRemaining
, delegationFee
, uptimePerformance
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.
asc
, desc
Validation status of the node.
completed
, active
, pending
, removed
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
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.
The minimum validation time remaining, in seconds, used to filter the set of nodes being returned.
The maximum validation time remaining, in seconds, used to filter the set of nodes being returned.
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.
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.
The minimum node uptime performance percentage, which represents node health, used to filter the set of nodes being returned Default is 90.
The maximum node uptime performance percentage, which represents node health, used to filter the set of nodes being returned. Default is 100.
The subnet ID to filter by. If not provided, then all subnets will be returned.
Response
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.
The list of validator Details.
Was this page helpful?