Withdrawals

A series of endpoints that drill down on withdrawals related metrics for both entities (withdrawal address) and validators.

Entity Withdrawals

The withdrawals endpoint give you a breakdown of all withdrawals related to an entity's withdrawal address over time.

Get withdrawal metrics for Withdrawal Addresses

This endpoint returns withdrawals by address

GET/v1/eth/entities/{withdrawal_address}/withdrawals

Path parameters

withdrawal_address*Withdrawal Address

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/eth/entities/{withdrawal_address}/withdrawals', {
    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": [
    {
      "epoch": 796,
      "consensusSlot": 19056,
      "executionBlockNumber": 19056,
      "slotIndex": 0,
      "withdrawalIndex": 0,
      "validatorIndex": 0,
      "withdrawalAddress": "0x1123",
      "amountInGwei": 100000
    }
  ]
}

Validator Withdrawals

The withdrawals endpoint give you a breakdown of all withdrawals associated with a validator over time.

Get withdrawal metrics for individual validators

This endpoint returns withdrawals by validator index or pubkey

GET/v1/eth/validators/{validator_index_or_pubkey}/withdrawals

Path parameters

validator_index_or_pubkey*Validator Index Or Pubkey

integerstring

Query parameters

Header parameters

Response

200400

Successful Response

Body

application/json

previousPrevious

nextNext

pages*Pages

results*Results

Request

JavaScriptCurlPython

const response = await fetch('/v1/eth/validators/{validator_index_or_pubkey}/withdrawals', {
    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": [
    {
      "epoch": 796,
      "consensusSlot": 19056,
      "executionBlockNumber": 19056,
      "slotIndex": 0,
      "withdrawalIndex": 0,
      "validatorIndex": 0,
      "withdrawalAddress": "0x1123",
      "amountInGwei": 100000
    }
  ]
}