Chains API
The newest validator withdrawals on Ethereum
The newest beacon-chain withdrawals credited on Ethereum (validator, receiver, amount, block) and the total number processed so far.
/api/external/chain-analysis/beacon-withdrawals/{chain}What it returns
The newest limit beacon-chain withdrawals credited on Ethereum, newest first: the withdrawal index, the validator it came from, the address credited, the amount in wei (a decimal string) and the block and time that carried it. totalWithdrawals is every withdrawal processed as of the newest indexed withdrawal — that index plus one, a count rather than an estimate because the index counts up by one per withdrawal from 0. Up to sixteen withdrawals land per 12-second slot, most of them small automatic reward skims; a 32 ETH-sized amount is usually a validator exiting.
Chains
- Ethereum ETH
Request
Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.
curl -H "x-dex-data-key: $DEXDATA_API_KEY" \ "https://api.dexdata.io/api/external/chain-analysis/beacon-withdrawals/ETH"
| Parameter | Description |
|---|---|
limitquery · integer · optional | How many withdrawals to return: 1 to 50. Defaults to 10. The ceiling is one source page; a short page returns fewer than asked rather than an error. |
chainpath · string · required | ETH only. Validator withdrawals are an Ethereum consensus-layer event; every other chain returns 400. |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
totalWithdrawals | integer | Every withdrawal processed as of the newest indexed withdrawal: that index plus one. The index counts up by one per withdrawal, so this is a count rather than an estimate. |
withdrawals | object[] | Newest first, one per withdrawal index, with no gaps. |
withdrawals[].index | integer | The withdrawal index, counting up from 0 across the whole chain. |
withdrawals[].validatorIndex | integer | null | The validator the balance was withdrawn from, or null when not published. |
withdrawals[].receiver | string | null | The address credited (lower-case), or null when not published. |
withdrawals[].amountWei | string | null | The amount credited in wei, as a decimal string; null when not published. |
withdrawals[].blockNumber | integer | null | The block that carried the withdrawal. |
withdrawals[].timestamp | integer | null | Unix seconds of that block. |
Start building with DexData today
Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.
Get a free API key