Withdrawals

• This endpoint retrieves the complete withdrawal history for your validators, including: partial sweeps of rewards, full withdrawals after validator exits
• The data matches what you'd see in the Beacon Chain Explorer's withdrawals tab, but aggregated across all your validators.
• Only shows consensus layer rewards and withdrawals that have already been transferred or swept to your designated withdrawal address.
• You can query up to 50 validator accounts in a single request.

Parameters

• start
  string
  required
  Lower bound of withdrawal data expressed as epoch number (for epoch rollup only) or timestamps (as strings "YYYY-MM-DD"). This parameter is ignored when all_time rollup is requested.

• end
  string
  required
  Upper bound of withdrawal data expressed as epoch number (for epoch rollup only) or timestamps (as strings "YYYY-MM-DD"). This parameter is ignored when all_time rollup is requested.

• network
  string \\| null enum
  Defaults to mainnet

  • mainnet
  • hoodi

• withdrawal_addresses
  array of strings \\| null
  A set of withdrawal addresses (or withdrawal credentials) to include in the results.

• pubkeys
  array of strings \\| null
  A set of validator public keys to include in the results.

Response

200 List of validator withdrawals.

• data
  array of objects

• data
  object

  • index
    integer
    The unique index of the withdrawal on chain (from round robin process).
  • pubkey
    string
    The public key of the validator.
  • validator_index
    integer
    The index of the validator.
  • withdrawal_address
    string
    The withdrawal address of the validator.
  • amount_text
    string
    The withdrawal amount (as text).
  • currency
    string
  • amount_numeric
    integer
    The withdrawal amount (as an integer) - needs exp below.
  • exp
    integer
    The exponent used to calculate the final ETH amount.
  • full_withdrawal
    boolean
    Whether the validator exited or not.
  • slot
    integer
    The consensus layer slot at which the withdrawal occurred.
  • block_number
    integer
    The execution layer block at which the withdrawal occurred.
  • epoch
    integer
    The epoch in which the withdrawal sweep happened.
  • timestamp
    string
    The timestamp of the end of the epoch.

• meta
  object

  • protocol
    string
    The name of the protocol queried.
  • network
    string
    enum
    Name of the network on which rewards were earned.
    • mainnet
    • hoodi

Error Codes

• 400
  Parameter error
• 401
  Unauthorized
• 500
  System error

Example Request

curl --request POST \
     --url https://api.figment.io/ethereum/withdrawals \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: your-api-key-here' \
     --data '{
  "network": "mainnet"
}'

Example Response

{
  "data": [
    {
      "index": 7642977,
      "pubkey": "0x9999e34d7049e81fb48cefdfa0e671b920ea1a1a292c3596041da2698a9ed303b802806c5ffd49498413c4b97748239f",
      "validator_index": 626955,
      "withdrawal_address": "0xe187d594402c8f6b147f22d443406d1b1edebdc7",
      "amount_text": "32",
      "currency": "ETH",
      "amount_numeric": 32000000000000000000,
      "exp": 18,
      "full_withdrawal": true,
      "slot": 6694928,
      "block_number": 17512592,
      "epoch": 209216,
      "timestamp": "2023-06-19T08:25:36Z"
    }
  ],
  "meta": {
    "protocol": "ethereum",
    "network": "mainnet"
  }
}

Update

Updated 3 months ago