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

page*Page

total*Total

data*Data

nextNext

Request

JavaScriptCurlPython

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

Response

200400

{
  "page": {
    "from": 0,
    "to": 0,
    "granularity": "3k",
    "size": 0
  },
  "total": 0,
  "data": [],
  "next": "text"
}

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=2024-12-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.