Validators

Querying into individual validator IDs

The following endpoints return all kinds of useful information (e.g. rewards, performance) about a validator or a specific set of validators in the requested time-frame.

Single validator effectiveness

This endpoint returns all the useful information you need on the historical performance of a single validator. This includes voting effectiveness, proposer effectiveness, missed blocks (i.e. skip rate), etc. For a glossary of the variables returned, see validators.

Here's how to interpret the inputs required to operate it👇

Parameter	Context
from	Starting UTC date (e.g. from=“2024-04-22”), or a slot multiple of 3,000 (approximately 20 minutes)
granularity	The size of time increments you are looking to query. Can be dayor 3k(3,000 slots or approximately 20 minutes).
size	The number of results included per page

Single validator rewards

This endpoint returns all the useful information you need on the historical rewards of a single validator (e.g. voting rewards, block proposals, MEV). For a glossary of the variables returned, see validators.

Here's how to interpret the inputs required to operate it👇

Parameter	Context
from	Starting UTC date (e.g. from=“2024-04-22”), or a slot multiple of 3,000 (approximately 20 minutes)
granularity	The size of time increments you are looking to query. Can be dayor 3k(3,000 slots or approximately 20 minutes).
size	The number of results included per page

Single validator voting latency

This endpoint returns information related to a single validator's voting latency (i.e. voting timeliness). For a glossary of the variables returned, see validators.

Here's how to interpret the inputs required to operate it 👇

Parameter	Context
from	Starting slot to get the vote latency from
size	The number of results included per page. This is based on slots. For example, to return the voting latency in the last 200 slots, you will need to input size = 200.

Single validator summary

This endpoint returns high level information about a validator over the time period such as its entity name, network penetration, annual percentage yield (APY), and effectiveness.

Here's how to interpret the inputs required to operate it 👇

Parameter	Context
window	Window of the aggregation, with 1d, 7d, 30d and all being the supported values

On the 1d time period, the APY takes into account the rewards received for the last 3 days to smooth out the noise given Solana's staking rewards schedule, which is every epoch (~2 days).

Multiple validator summaries

Similar to the Single validator summary but returns the summary stats for all validators.

Here's how to interpret the inputs required to operate it 👇

Parameter	Context
window	Window of the aggregation, with 1d, 7d, 30d and all being the supported values
from	From a specific validator's ranking based on their order in terms of network_penetration
size	The number of results included per page

On the 1d time period, the APY takes into account the rewards received for the last 3 days to smooth out the noise given Solana's staking rewards schedule, which is every epoch (~2 days).

Validator metadata

This endpoints returns information about a validator such as their name, location, client, etc.