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

Successful Response

Body
previousPrevious
nextNext
pages*Pages
results*Results
Request
const response = await fetch('/v1/eth/entities/{withdrawal_address}/withdrawals', {
    method: 'GET',
    headers: {},
});
const data = await response.json();
Response
{
  "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
Query parameters
Header parameters
Response

Successful Response

Body
previousPrevious
nextNext
pages*Pages
results*Results
Request
const response = await fetch('/v1/eth/validators/{validator_index_or_pubkey}/withdrawals', {
    method: 'GET',
    headers: {},
});
const data = await response.json();
Response
{
  "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
    }
  ]
}

Last updated