API Reference

Withdrawals

post
https://api.figment.io/ethereum/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.
Body Params
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.

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.

string | null
enum
Defaults to mainnet
Allowed:
withdrawal_addresses
array of strings | null

A set of withdrawal addresses (or withdrawal credentials) to include in the results.

withdrawal_addresses
pubkeys
array of strings | null

A set of validator public keys to include in the results.

pubkeys
Responses

Updated 3 months ago

Language
LoadingLoading…
Response
Choose an example:
application/json

Updated 3 months ago