BLblockdaemon
Ethereum

Get Ethereum Withdrawable Amount

Changed on

Returns the total staked amount that can be withdrawn across a customer's 0x02 validators on the network with the given withdrawal address. Withdrawable amount per validator is calculated as 'withdrawable_amount = balance - minimum_deposit - pending_withdrawals'. Withdrawable amount does not include the balances of validators that can be exited and fully withdrawn.

get/v1/ethereum/{network}/withdrawable-amount/{withdrawal_address}

Request

  • Base URL
    https://svc.blockdaemon.com/boss
  • URL
    https://svc.blockdaemon.com/boss/v1/ethereum/{network}/withdrawable-amount/{withdrawal_address}
  • Auth
    API key in header X-API-KEY

Response

Ok

protocol'ethereum' required

Ethereum protocol

network'mainnet' | 'hoodi' required

Ethereum network

currencystring required
amountstring required

Amount of ETH (denominated in Gwei).

Example response

{
  "amount": "32000000000",
  "pending_withdrawals": [
    {
      "public_key": "0x00000000219ab540356cBB839Cbe05303d7705Fa",
      "amount": "32000000000",
      "withdrawal_credentials": "0x0092c20062cee70389f1cb4fa566a2be5e2319ff43965db26dbaa3ce90b9df99"
    }
  ],
  "withdrawable_validators": [
    {
      "public_key": "0x00000000219ab540356cBB839Cbe05303d7705Fa",
      "amount": "32000000000",
      "withdrawal_credentials": "0x0092c20062cee70389f1cb4fa566a2be5e2319ff43965db26dbaa3ce90b9df99"
    }
  ]
}

Changes

  • 2c09b3ef4f99Revision changes
    • breaking

      the response's property type changed from string to integer, and format from no format to int32 for status

    • breaking

      the response's property type changed from string to integer, and format from no format to int32 for status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status