Performance

A series of endpoints that drill down on performance related metrics for validators.

Validator Performance

Get validator performance

This endpoint returns all the useful information you need on the historical performance of a single validator. Use this endpoint to retrieve top level metrics on block leader/proposal effectiveness, voting effectiveness, and overall effectiveness of a validator.

GET/v1/solana/validators/{validator_id}/performance

Path parameters

validator_id*Validator Id

Query parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/solana/validators/{validator_id}/performance', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "voteAccount": "voteAccount",
      "from_": "2024-12-14",
      "skippedSlots": 5,
      "voteLatency": 1.5,
      "uptime": 0.95,
      "effectiveness": 0.965,
      "proposedSlots": 90,
      "voteOnlySlots": 10,
      "totalVotes": 30000,
      "sumLatency": 45000,
      "voteDutiesCount": 31578,
      "totalVoteScore": 480000
    }
  ]
}

You can query this endpoint by using the vote_accountaddress of a validator as the validator_id. The granularity of results can either be daily or around 20 minute intervals (3,000 slots).

Earliest data available is from April 1, 2024.

Geolocation Vote Latency

Get daily vote latency across all geolocations

This endpoint returns the median vote latency across all hosting providers/data centers for the specified date.

GET/v1/solana/network/geolocation/latency

Query parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/solana/network/geolocation/latency?date=2025-01-21', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "day": "2024-01-01",
      "fromSlot": 250000000,
      "toSlot": 250200000,
      "country": "Germany",
      "city": "Frankfurt",
      "hostingProvider": "Hoster Roster",
      "medianVoteLatency": 1.202
    }
  ]
}

To use this endpoint, a day must be specified. The endpoint then returns all available median vote latency data across all data center/hosting provider locations for the specified date.

Earliest data available is from November 1, 2024.

Network Effectiveness

Get historical network level performance

This endpoint returns historical performance metrics for the network.

GET/v1/solana/network/effectiveness

Query parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/solana/network/effectiveness', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400

{
  "previous": "https://endpoint?limit=10&offset=10",
  "next": "https://endpoint?limit=10&offset=10",
  "pages": 10,
  "results": [
    {
      "fromDate": "2024-01-01",
      "toDate": "2024-01-01",
      "fromSlot": 250000000,
      "toSlot": 250200000,
      "voteSuccessRate": 0.999,
      "missedBlocksRate": 0.999,
      "votingLatency": 0.999,
      "effectiveness": 0.999
    }
  ]
}

This endpoint returns historical key performance metrics at the network level. You can choose the covered dates (fromDate,toDate) or ~20 minute slot intervals (fromSlot, toSlot) based on the granularityparameter. By default, it returns the latest daily data.

Earliest data available is from April 1, 2024.