Slashings

Querying into all slashed validators and individual slashed validator indices

The Slashings endpoints allows one to see every slashed validator in the Ethereum Beacon Chain whether individually or collectively. Pertinent metrics include their total penalties from being slashed, which epoch they were slashed, and when they will be withdrawable.

Slashings as a whole

Get Slashing Penalties All

GET/v0/eth/slashings

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

page*Page

total*Total

data*Data

nextNext

Request

JavaScriptCurl

const response = await fetch('/v0/eth/slashings', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "page": {
    "granularity": "hour",
    "filterType": "hour"
  },
  "data": [
    {
      "validatorIndex": 516858,
      "validatorPubkey": "0xafa647044b05fd7d7f3cfd806170fc9774bf37cbcfd4f083528522bb2a011e57f3af00f8bb8435a9d3316816e4cdb022",
      "slashingEpoch": 203644,
      "withdrawableEpoch": 211836,
      "balanceBeforeSlashing": 32001900366,
      "balanceBeforeWithdrawal": 30980804667,
      "slashingPenalties": 1021095699
    }
  ],
  "next": "text"
}

This endpoint gives a paginated list of all slashed validators, their index, pubkey, slashing epoch, withdrawable epoch, balance before slashing, balance before withdrawal, and the penalties incurred from getting slashed.

If a slashed validator is not yet withdrawable, their balances before withdrawal and corresponding penalties will update every refresh until they become withdrawable.

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

Parameter	Context
from	Start day (integer) or datetime (e.g. from=“2022-12-01”)
size	The number of results included per page

Slashings by validator

Get Slashing Penalties

GET/v0/eth/slashings/{validator_index_or_pubkey}

Path parameters

validator_index_or_pubkey*Validator Index Or Pubkey

integerstring

Header parameters

Response

200400

Successful Response

Body

application/json

validatorIndex*Validatorindex

validatorPubkey*Validatorpubkey

slashingEpoch*Slashingepoch

withdrawableEpoch*Withdrawableepoch

balanceBeforeSlashing*Balancebeforeslashing

balanceBeforeWithdrawal*Balancebeforewithdrawal

slashingPenalties*Slashingpenalties

Request

JavaScriptCurl

const response = await fetch('/v0/eth/slashings/{validator_index_or_pubkey}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "validatorIndex": 516858,
  "validatorPubkey": "0xafa647044b05fd7d7f3cfd806170fc9774bf37cbcfd4f083528522bb2a011e57f3af00f8bb8435a9d3316816e4cdb022",
  "slashingEpoch": 203644,
  "withdrawableEpoch": 211836,
  "balanceBeforeSlashing": 32001900366,
  "balanceBeforeWithdrawal": 30980804667,
  "slashingPenalties": 1021095699
}

This endpoint returns information about a single slashed validator, queried either by the validator's index or their pubkey.

Slashings overview

Get Slashing Overview

GET/v0/eth/slashings/overview

Header parameters

Response

200400

Successful Response

Body

application/json

timeWindow*TimeWindow

An enumeration.

1d7d30dall

validatorsSlashed*Validatorsslashed

discreteSlashingEvents*Discreteslashingevents

largestSlashingIncident*Largestslashingincident

currentSlashingPenaltyGwei*Currentslashingpenaltygwei

slashingSlotsRatio*Slashingslotsratio

solosRatio*Solosratio

prosRatio*Prosratio

slashingPenaltiesAllRewardsRatio*Slashingpenaltiesallrewardsratio

slashingPenaltiesStakeRatio*Slashingpenaltiesstakeratio

Request

JavaScriptCurl

const response = await fetch('/v0/eth/slashings/overview', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "timeWindow": "all",
    "validatorsSlashed": 278,
    "discreteSlashingEvents": 97,
    "largestSlashingIncident": 2,
    "currentSlashingPenaltyGwei": 1064833914,
    "slashingSlotsRatio": 0.00003,
    "solosSlotsRatio": 0.57554,
    "prosSlotsRatio": 0.42446,
    "slashingPenaltiesAllRewardsRatio": 0.00011,
    "slashingPenaltiesStakeRatio": 0.00001
  }
]

This endpoint returns overview statistics around slashing, including the number of validators slashed, slashing events, and slashing incidents between professional and solo validators.

Slashings leaderboard

Get Slashing Leaderboard

GET/v0/eth/slashings/leaderboard

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

page*PageP2P

total*Total

data*Data

nextNext

Request

JavaScriptCurl

const response = await fetch('/v0/eth/slashings/leaderboard', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "page": {},
  "data": [
    {
      "id": "text",
      "idType": "depositAddress",
      "medianSlashedMonth": "text",
      "slasherPedigree": "text",
      "slashingRole": "slashed"
    }
  ],
  "next": "text"
}

Depending on the slashing role specified, this endpoint returns a list of entities either (1) according to how many times their validators have been slashed or (2) how many times their validators have proposed a block that included slashing report (i.e. letting the network know a slashing incident has occurred). These entities are arranged in descending order.

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

Parameter	Context
from	Start ranking (i.e. position in the leaderboard)
size	The number of results included per page
slashingRole	Input slashed to query to the slashed entities and slasher to query the slashing incident reporters

Cohort analysis of slashings

Get Slashing Cohort Analysis

GET/v0/eth/slashings/cohortAnalysis

Header parameters

Response

200400

Successful Response

Body

application/json

cohort*Cohort

lastSixMonths*Lastsixmonths

pastYear*Pastyear

pastTwoYears*Pasttwoyears

allTime*Alltime

Request

JavaScriptCurl

const response = await fetch('/v0/eth/slashings/cohortAnalysis', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "cohort": "text"
  }
]

This endpoint returns the frequency of slashing incidents for validators, grouped by different operator cohort sizes, from solo to professional operators with more than 5,000 validator keys. The cohorts are mapped against different time periods ranging from 6 months to all time.

Time series of slashing incidents

Get Slashing Time Series

GET/v0/eth/slashings/timeseries

Header parameters

Response

200400

Successful Response

Body

application/json

month*Month

validatorsSlashed*Validatorsslashed

Request

JavaScriptCurl

const response = await fetch('/v0/eth/slashings/timeseries', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

[
  {
    "month": "2024-04-29"
  }
]

This endpoint returns the number of discrete slashing events per month. "Discrete slashing events" are defined as a day wherein at least 1 validator was slashed.