getVoteAccounts

The getVoteAccounts method returns information about all vote accounts in the cluster. Vote accounts are special accounts used by validators to cast votes during the consensus process, making them essential to understanding validator participation and network consensus.

In Solana's proof-of-stake consensus, validators operate vote accounts that track their voting history and collect staking rewards. Each validator has a vote account that records their votes on blocks, accumulates credits for correct votes, and manages staked SOL delegated to them. This method returns comprehensive information about all vote accounts including their activation state, stake amounts, commission rates, voting history, and current epoch credits.

This method is crucial for staking platforms helping users choose validators, monitoring tools tracking network health and validator performance, analytics platforms studying stake distribution, and governance tools tracking validator voting patterns. It provides a complete snapshot of the validator set and their current status in the network.


Parameters

parameter
type
description
config
object
Optional configuration object
config.commitment
string
Level of commitment: 'processed', 'confirmed', or 'finalized' (default: 'finalized')
config.votePubkey
string
Optional. Only return results for this vote account (base-58 encoded public key)
config.keepUnstakedDelinquents
boolean
Optional. Do not filter out delinquent validators with no stake (default: false)
config.delinquentSlotDistance
number
Optional. Specify the number of slots behind the tip that a validator must fall to be considered delinquent
Return Object
field
type
description
current
array
Array of current (active) vote account information objects
delinquent
array
Array of delinquent (inactive/behind) vote account information objects
current[].votePubkey
string
Vote account public key as base-58 encoded string
current[].nodePubkey
string
Validator identity public key
current[].activatedStake
number
Stake activated for this vote account in lamports
current[].epochVoteAccount
boolean
Whether the vote account is staked for this epoch
current[].commission
number
Commission percentage (0-100) charged by the validator
current[].lastVote
number
Most recent slot voted on by this validator
current[].epochCredits
array
Array of [epoch, credits, previousCredits] tuples for recent epochs
current[].rootSlot
number
Current root slot for this validator
Request Example
Request
Response Example
Response

Tip: Current validators are actively voting and up-to-date. Delinquent validators have fallen behind (lastVote is too old). Higher epochCredits indicate better performance. Commission is the percentage of rewards the validator keeps. Use activatedStake to find validators with significant backing. Filter by votePubkey to check specific validators.


Share on
Share on FacebookShare on XShare on LinkedIn
Did you find this page useful?